Skip To Content

URL パラメーターによるマップの変更

Map Viewerで作成されたマップには、ベースマップ、データ レイヤー、範囲、凡例、およびナビゲーション ツール (ズーム、画面移動、地名検索、ブックマークなど) が含まれます。多くのマップには、ベースマップ ギャラリーなどの対話的要素、計測ツール、ポップアップ、および時系列データの再生ボタンもあります。

また、Map Viewerでマップを作成する代わりに、直接 URL パラメーターを使用してマップを作成または変更することもできます。

たとえば、英国内の陸上の風力発電地帯を示すマップを URL パラメーターを使って作成する例を次に示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=http%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=http%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

URL の構成内容

URL は常に Portal for ArcGIS のホーム ページで始まり、その後に /webmap/viewer.html? が続き、下記のうちの 1 つ以上のクエリ パラメーターが含まれます。 複数のパラメーターを含めるには、アンパサンド (&) を使ってパラメーターを区切ります。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4
注意:

URL パラメーター内のリソースが HTTP として指定されている場合は、マップの URL も HTTP にする必要があります。セキュリティの強化を図るために、可能な限り、URL に HTTPS を使用するようにしてください。

クエリ パラメーターのエンコード

すべてのクエリ パラメーターがエンコードされる必要があります。URL エンコーディングによって、有効な文字がポータル Web サイトに送信されることが保証されます。エンコーディングでは、無効な文字が、% とそれらの文字の 16 進数表記に置き換えられます。

次に、エンコードされていない URL パラメーターの例を示します。

basemapUrl=https://myportal.domain.com:7443/arcgis/rest/services/Ocean_Basemap/MapServer

次に、エンコードされた当該パラメーターを示します。

basemapUrl=http%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2FOcean_Basemap%2FMapServer

パラメーター内のパラメーターもエンコードする必要があります。次に例を示します。

urls=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttp%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

Web には、エンコードされた URL を生成するための無料のサイトおよびツールが多数存在します。読みやすさに配慮して、このトピックで以降に示す例はエンコードされていません。

保存したマップを開く

Map Viewerで作成して保存したマップを開くには、webmap= とそのマップの一意の ID を使用します。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710

ベースマップの定義

ベースマップを定義するには、basemapUrl= をレイヤーに設定します。ベースマップが定義されない場合、デフォルト ベースマップは World Topographic ベースマップになります。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

参照レイヤーを含める

ベースマップに参照レイヤーを含めるには、basemapReferenceUrl= をレイヤーに設定します。basemapReferenceUrl= パラメーターの他に、basemapUrl パラメーターを使用する必要があります。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=http://services.myportal.domain.com:7443/arcgis/rest/services/Reference/World_Boundaries_and_Places/MapServer

操作レイヤーの定義

ベースマップの上に重ねる操作レイヤーを定義するには、webmap=layers=url=、または urls= を使用します。レイヤーが Web サイト内のアイテムの場合は、layers= を使用します。これにより、すべてのレイヤー構成を取得できます。レイヤーが Web サイト内にない場合は、url= または urls= を使用します。

layers= パラメーターには、単一のアイテム ID または複数のアイテム ID を指定できます。複数のレイヤーの場合、カンマ区切りの ID リスト (&layers=<itemID>,<itemID>,<itemID>) を使用します。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

url= パラメーターは単一のレイヤー URL を受け入れます。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
     url=https://services.myportal.domain.com:7443/arcgis/rest/services/Demographics/USA_Population_Density/MapServer

urls= を使用して複数のレイヤーを含めます。各レイヤーをカンマで区切ります。マップ範囲は、リスト内の最後のレイヤーまたは読み込みに最も時間がかかったサービスに基づきます。特定の範囲にズームするには、extent= パラメーターを含めます。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

ArcGIS 10.5 以降では、フィーチャ サービスで ?layers 操作を使用できます。

たとえば、次のように指定します。

http://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://sampleserver6.arcgisonline.com/arcgis/rest/services/RedlandsEmergencyVehicles/FeatureServer?layers=show:1,2

マップの中央配置

特定の位置をマップの中心にするには、地理座標 (x,y) または投影座標 (x,y,WKID) を使用して、center= を設定します。区切り文字としてカンマやセミコロンを使用できます。数値の小数点としてコロンを使用している場合は、セミコロンを使用します。

次に、地理座標の例を示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45

次に、投影座標の例を示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=500000,5500000,102100

スケール レベルの定義

Map Viewerのスケール レベルを定義するには、center パラメーターと level= パラメーターを使用します。level パラメーターは、REST サービス エンドポイントに示されているキャッシュ スケールのレベル ID を受け入れます。キャッシュ スケール レベルは、マップ サービスの REST エンドポイント上の情報を使用して特定できます。解像度は縮尺と反比例の関係にあります。

webmap または find パラメーターを使用するとき、縮尺は自動的に設定されます。level は無視されます。webmap パラメーターを使用する場合、マップの全範囲に自動的にズームします。find パラメーターを使用する場合、見つかった位置の最適な範囲に自動的にズームします。

次に、地理座標の例を示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

次に、投影座標の例を示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=500000,5500000,102100&level=4

範囲の定義

マップの範囲を定義するには、extent= を使用して、マップの範囲を定義します。extent パラメーターには、MinX,MinY,MaxX,MaxY 形式の地理座標 (GCS) または MinX,MinY,MaxX,MaxY,WKID 形式の投影座標 (PCS) を指定できます。区切り文字としてカンマやセミコロンを使用できます。数値の小数点としてコロンを使用している場合は、セミコロンを使用します。

次に、地理座標の例を示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-117.20,34.055,-117.19,34.06

次に、投影座標の例を示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

レイヤーの表示設定

マップのレイヤーの表示を設定するには、layers=show: を使用します。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://otherportal.domain.com:7443/arcgis/rest/services/BloomfieldHillsMichigan/Parcels/MapServer?layers=show:1,2

マップを開く位置またはフィーチャの検索

マップを開くのに使用される位置またはフィーチャを検索するには、find= を使用します。マップでは、最も近い一致結果に自動的にズームし、吹出しマーカーが追加されます。find パラメーターに指定できる値は、1 行の住所、住所の一部 (たとえば、都市名のみや国名のみ)、場所名、および緯度と経度の座標です。

1 行の住所を使用する例を次に示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?find=380 new york st,redlands,ca

ポイントの追加

ポイントをマップに追加するには、marker=<x>,<y> を使用します。ポイントが、新しいマップ メモ レイヤーの指定した X,Y 位置に追加されます。次のオプション プロパティも含めることができます。

  • <wkid> - マップに追加される X,Y 座標の空間参照。WKID を含めない場合、GCS 座標が使用されます。
  • <encoded title>- ポイントのポップアップのタイトル。タイトルを含めない場合、ポップアップは空になります。
  • <encoded icon URL>- ポイントのシンボル。シンボルを含めない場合、青のマーカー シンボルが使用されます。
  • <encoded label>- ポイント シンボルの横に表示されるラベル。

検討事項

  • <x>,<y> が必要です。
  • titleicon、および label パラメーターは、必ずエンコードしなければなりません。
  • プロパティは marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label> の順序で追加する必要があります 。
  • 区切り文字としてカンマやセミコロンを使用できます。数値の小数点としてコロンを使用している場合は、セミコロンを使用します。
  • 空の値を使用します。スペースは使用しません。たとえば、ラベルを指定し、それ以外のオプション プロパティをどれも指定しない場合は、6 番目のパラメーターとしてラベルを追加し、その他のパラメーターの値を空にします (x;y;;;;label)。
  • (ポイントを中央に配置することに加えて) マップを拡大する場合は、level= パラメーターを含めます。
  • マップ メモ レイヤーは、マップまたはアイテムとして編集および保存できます。
  • 組織アカウントは、ポイントを使用してルート案内を提供したり、解析を実行したりできます。

区切り文字としてセミコロンを使用する例を次に示します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

詳細ウィンドウの非表示

Map Viewer[詳細] ウィンドウを非表示にするには、mapOnly=true を使用します。

たとえば、次のように指定します。

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=b487d81007294fb5a0be9e10a411f2d0&mapOnly=true