URL 起動パラメータ
管理者は、パラメータを含む URL を作成して、Spectrum Spatial™ Analyst のインターフェイスを特定の方法で表示できます。
URL に追加したパラメータは、選択したマップ プロジェクトの設定に優先します。正しく入力されていないパラメータは無視され、デフォルト マップ プロジェクトの設定が代わりに使用されます。マップ プロジェクト名、位置住所データ セット、および言語を指定できます。その他のパラメータ:
- 特定のマップ フィーチャをコール アウト付きで表示する
- 特定の場所の位置をマーカーを使って強調表示する
- ある場所に最も近いフィーチャの結果を表示する
- 表示に切り替えるマップ オーバーレイを定義する
- アクティブなベース マップを指定する
- 同心リングを描画する
パラメータ
次の表は、Spectrum Spatial™ Analyst を起動するときに URL 内に指定できるパラメータを示しています。
パラメータ | 説明 | 例 |
---|---|---|
mapcfg | 使用するマップ プロジェクトの名前。 | mapcfg=mytestmap |
言語 |
サポートされている言語には次のものがあります。
Spectrum Spatial™ Analyst を上記のいずれかの言語で起動するには、URL の末尾に「lang」パラメータを追加します。 |
lang=cy |
x | マップの中央ポイントの X 位置。この位置がマップの中央になります。 | x=530000 |
y | マップの中央ポイントの Y 位置。この位置がマップの中央になります。 | y=183000 |
経度 | マップの中央ポイントの経度位置。lon=1.131415 がマップの中央になります。 注: URL の中で、X/Y と経度/緯度の両方が指定されている場合、経度/緯度が優先されます。経度/緯度の値は、投影法 (EPSG:4326) に対応している必要があります。 |
経度=1.131415 |
緯度 | マップの中央ポイントの緯度位置。緯度=1.131415 がマップの中央になります。 | 緯度=1.131415 |
リングを表示 | 円または同心円を注釈として Spectrum Spatial™ Analyst に追加するかどうかを指定します。1 つまたは複数のカンマ区切り値を含めることができます。単独の値を指定すると、円が追加されます。複数の値を指定すると、同心円が追加されます。単位は showRingsUnit パラメータで指定されます。showRingsUnit が省力された場合は、デフォルトでメートルが使用されます。入力できるのは 2 から 5 までです。 注: 同心円は、XY 位置に描画されます。半径には整数、または小数点以下が 2 または 3 桁までの小数が指定できます。 |
リングを表示=2.2,4,6,8 |
リング単位を表示 | 単位は showRings パラメータで指定します。サポートされている単位は、km、m、マイル、フィートです。単位はメートルです。 |
リング単位を表示=km |
addAsLayer |
指定された X、Y (または lat lon) 位置がポイント ベクタ レイヤとして Spectrum Spatial™ Analyst に追加されるかどうかを決定します。省略された場合のデフォルトは false です。レイヤはマップの凡例に表示されます。 |
addAsLayer=true |
レイヤ名 |
addAsLayer パラメータで追加されるレイヤの名前を定義します。デフォルトの名前は pointLayer です。 |
layerName= vectorLayer |
custTemplate | addAsLayer で作成されたレイヤのコールアウトでカスタム テンプレートを定義します。 showInfo パラメータを true に設定してカスタム テンプレートを使用すると、ユーザは任意の位置で Spectrum Spatial™ Analyst を起動して管理者がテンプレートに追加した任意の情報を表示できます。例えば、サーバー側でリクエストを発行してその時点での保険対象の合計リスク値を計算したり、Spectrum Spatial™ Analyst にロードされたマップ レイヤに関連する情報や関連しない情報を表示したりするテンプレートを作成することができます。カスタム テンプレートは、Spectrum の以下のフォルダに保存されます。
詳細については、付録 D を参照してください。 |
custTemplate=MyTemplate |
再ロード | true に設定すると、Spectrum Spatial™ Analyst は URL を初めて参照した場合と同じようにブラウザのページを完全に更新します。false に設定すると (reload を指定しない場合のデフォルト値)、URL パラメータ (X、Y、Zoom など) がブラウザ ビューの現在のマップに適用されます。 | 再ロード=true |
ズーム | Spectrum Spatial™ Analyst の起動時に使用するマップのズーム。 | ズーム=10 |
情報を表示 | true を渡して、マップ コール アウトを表示するかどうかを指定します。マップ コール アウトは XY 位置に表示され、表示されているマップ レイヤに対してその時点でクエリが実行され、コール アウトの属性データが取得されます。 |
情報を表示=true |
近傍検索を表示 | XY を検索の中央として使用して、近傍検索結果セットを表示するかどうかを指定します。検索テーブルの名前をパラメータとして渡し、オプションで、XY で指定した位置の名前を渡します (名前はマップ エリアに表示されます。例では、オフィスの近隣にある小学校を表示します)。リポジトリ パスは、テーブルまたはテーブル名でサポートされています。 注: 近傍検索を表示に対する有効な値が URL 内に存在する場合、ズームは有効なパラメータではありません。
注: 複数のテーブルに、リポジトリ パスが異なる同じ名前を与えることができます。デフォルトでは、近傍検索の設定で最初に現れたリポジトリ パスが検索によって選択されます。 |
近傍検索=小学校 住所名=私達の会社 |
クエリテーブル | クエリを実行する名前付きテーブルの名前。 | クエリテーブル=/QA-Maps/NamedTables/ListedBuildings |
クエリフィールド | そのテーブルで、クエリ条件に使用する列の名前。 |
クエリフィールド=LB_NO |
クエリ値 | クエリ条件に使用する値のカンマ区切りリスト 注: クエリ値に " '$ #%^&*() などの特殊文字が含まれている場合は、クエリ値として渡す前にエンコードを行う必要があります。 |
クエリ値=1325,1326 |
オーバーレイ | Spectrum Spatial™ Analyst の起動時に表示に切り替えるマップ オーバーレイのカンマ区切りのリスト。オーバーレイが mapcfg で指定されたマップ構成に含まれている必要があります。リストに含まれていないマップ構成のオーバーレイは、非表示に切り替えられます。Spectrum Spatial™ Analyst の起動後、ユーザは凡例コントロールを使用して、表示/非表示を変更できます。 | オーバーレイ=Development Map, Conservation Map |
ベースマップ | Spectrum Spatial™ Analyst の起動時にアクティブなベース マップの名前。ベース マップは、mapcfg で指定されたマップ構成に含まれている必要があります。 | ベースマップ=ハイブリッド |
競合するパラメータを指定したときの動作
URL を定義する場合は、次のことに注意してください。
- URL で渡されたパラメータは、マップ構成内で定義されている設定より優先されます。
- いずれかのパラメータが不足している場合は、デフォルト マップ構成の設定が適用されます。
- 情報を表示および近傍検索パラメータは相互に排他的です。現在、情報を表示と近傍検索の両方のパラメータを指定した場合はエラーが発生するようになっています。
- 近傍検索 で、近傍検索を表示する場合、最も近いフィーチャが最大 10 件表示され、検索の XY 位置に位置マーカーも表示されます。
- オーバーレイおよびベースで、マップ オーバーレイまたはベース マップがマップ構成内に存在していない場合は、デフォルト マップ構成の設定が適用されます。