Web ブラウザでの WMS サービスとの通信

このトピックでは、URL パラメータを使って Web ブラウザで WMS サービスと通信する方法を示します。

WMS リクエストとレスポンス

WMS 準拠のサーバによってサポートされる各オペレーションのオンライン リソースは HTTP URL(Uniform Resource Locator)なので、WMS サービスは REST(Representational State Transfer)サービスと見なすことができます。標準の Web サービスとは異なり、WMS サービスを使用するために SOAP クライアントは必要なく、Web ブラウザが最も単純なクライアントとなります。WMS サービスのサービス レベル メタデータ、マップ イメージ、またはフィーチャの属性値を取得するには、サーバに URL リクエストを送信し、返されたレスポンスをブラウザで XML ドキュメントまたはイメージとして表示します。

ArcGIS Server WMS サービスによってサポートされる各オペレーションのリクエストとレスポンスのサンプルを、以下に示します。

WMS GetCapabilities リクエスト

http://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer?service=WMS&request=GetCapabilities&version=1.3.0

XML レスポンス

WMS GetCapabilities XML レスポンス

WMS GetMap リクエスト

http://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer?VERSION=1.3.0&REQUEST=GetMap&CRS=CRS:84&BBOX=-178.217598,18.924782,-66.969271,71.406235&WIDTH=765&HEIGHT=360&LAYERS=0,1,2&STYLES=,,Symbolizer&EXCEPTIONS=application/vnd.ogc.se_xml&FORMAT=image/png&BGCOLOR=0xFFFFFF&TRANSPARENT=TRUE

レスポンス マップ

WMS GetMap レスポンス マップ

WMS GetFeatureInfo リクエスト

http://sampleserver1.arcgisonline.com/arcgis/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer?REQUEST=GetFeatureInfo&SERVICE=WMS&VERSION=1.1.1&LAYERS=0&STYLES=default&FORMAT=image/png&BGCOLOR=0xFFFFFF&TRANSPARENT=TRUE&SRS=EPSG:4326&BBOX=-125.192865,11.2289864971264,-66.105824,62.5056715028736&WIDTH=1044&HEIGHT=906&QUERY_LAYERS=0&X=103&Y=462

XML レスポンス

WMS GetFeatureInfo XML レスポンス

WMS GetStyles リクエスト

http://myserver/arcgis/services/OGC/SanFrancisco/MapServer/WMSServer?Service=WMS&Request=GetStyles&Version=1.3.0&Layers=pizzastores,highways,blockgroups

XML レスポンス

WMS GetStyles XML レスポンス

WMS GetLegendGraphic リクエスト

http://myserver/arcgis/services/OGC/SanFrancisco/MapServer/WMSServer?Service=WMS&Request=GetLegendGraphic&Version=1.1.1&Layer=blockgroups&Style=population_dist&Format=image/png&Width=128&Height=64&transparent=false&bgcolor=0xffff00&SLD=http://zeon/resources/cr/CR53077/sld.xml

レスポンスの凡例のグラフィック

WMS GetLegendGraphic レスポンス グラフィック

TIME パラメータを使った WMS GetMap リクエスト

http://myserver/arcgis/services/OGC/Fire/MapServer/WMSServer?VERSION=1.3.0&REQUEST=GetMap&CRS=CRS:84&BBOX=-111.232092,43.910823,-109.455485,45.339498&WIDTH=626&HEIGHT=504&LAYERS=fire&STYLES=&EXCEPTIONS=application/vnd.ogc.se_xml&FORMAT=image/png&BGCOLOR=0xFFFFFF&TRANSPARENT=TRUE&TIME=1988-08-01T00:00:00/1988-08-11T00:00:00

レスポンス マップ

TIME パラメータ レスポンス マップを使った WMS GetMap リクエスト
メモメモ:

多くの場合、Web ブラウザは WMS クライアントとして推奨されませんが、WMS サーバとクライアント間のやり取りを追跡し、デバッグするツールとしては常に推奨されます。

WMS リクエスト パラメータ

OGC WMS 仕様は、各 WMS オペレーションで使用できるリクエスト パラメータを完全に定義しています。さまざまなバージョンの OGC WMS 実装仕様については、次のリンクをご参照ください。

バージョン 1.3.0

バージョン 1.1.1

バージョン 1.1.0

バージョン 1.0.0

以下の表に、ArcGIS Server での WMS 実装に適用されるリクエスト パラメータをすべて示します。これは仕様で定義されているリクエスト パラメータのほんの一部にすぎません。

WMS GetCapabilities リクエストの URL のパラメータ

必須/オプション

デフォルト値

説明

VERSION/WMTVER

オプション

1.3.0(9.3 以降)

1.1.1 (9.2)

リクエスト バージョン。WMTVER は WMS 1.0.0 でのみ使用します。WMS 1.0.0 以外では、VERSION を使用します。

SERVICE

必須

なし

サービス タイプ。WMS に設定する必要があります。WMS 1.0.0 ではパラメータは使用できません。

REQUEST

必須

なし

リクエスト名。GetCapabilities に設定する必要があります。WMS 1.0.0 の場合、capabilities に設定する必要があります。

FORMAT

オプション

text/xml(9.3 以降)

サービス メタデータの出力形式。これは WMS 1.3.0 だけで使用可能です(たとえば、application/vnd.ogc.wms_xmltext/plaintext/html)。

WMS GetMap リクエストの URL のパラメータ

必須/オプション

デフォルト値

説明

VERSION/WMTVER

必須

なし

リクエスト バージョン。WMTVER は WMS 1.0.0 でのみ使用します。WMS 1.0.0 以外では、VERSION を使用します。

REQUEST

必須

なし

リクエスト名。GetMap に設定する必要があります。WMS 1.0.0 の場合、map に設定する必要があります。

LAYERS

必須

なし

1 つまたは複数のマップ レイヤのカンマ区切りリスト(たとえば、0,1,2layer1,layer2

STYLES

必須

なし

1 つまたは複数のスタイルのカンマ区切りリスト。リクエストされたレイヤごとに 1 つのレイヤ(たとえば、0,1,2layer1,layer2

CRS/SRS

必須

なし

座標系。CRS は WMS 1.3.0 だけで使用されます。それ以外の場合には SRS を使用します(たとえば、EPSG:4326EPSG:4269)。

BBOX

必須

なし

CRS/SRS の単位のバウンディング ボックスの角(左下と右上)(たとえば、-180、-90、180、90

WIDTH

必須

なし

マップ ピクチャのピクセル単位の幅(1024 など)

HEIGHT

必須

なし

マップ ピクチャのピクセル単位の高さ(768 など)

FORMAT

必須

なし

マップの出力形式(たとえば、image/pngimage/jpegimage/svg+xml

TRANSPARENT

オプション

False

背景が透明かどうかを決定します(たとえば、TrueFalse)。

BGCOLOR

オプション

0xFFFFFF

マップの背景の 16 進数の RGB カラー(たとえば、0xFFFFFFFFFFFF

SLD

オプション

""

Styled Layer Descriptor XML ファイルの URL

SLD_BODY

オプション

""

Styled Layer Descriptor ファイルの XML 本文

TIME

オプション

""

要求されたレイヤの時間値。

EXCEPTIONS

オプション

text/xml(WMS 1.3.0)

application/vnd.ogc.se_xml(WMS 1.1.1 および WMS 1.1.0)

application/vnd.ogc.inimage(WMS 1.0.0)

例外通知のフォーマット(たとえば、text/xmltext/html)。

WMS GetFeatureInfo リクエストの URL のパラメータ

必須/オプション

デフォルト値

説明

VERSION/WMTVER

必須

なし

リクエスト バージョン。WMTVER は WMS 1.0.0 でのみ使用します。WMS 1.0.0 以外では、VERSION を使用します。

REQUEST

必須

なし

リクエスト名。GetFeatureInfo に設定する必要があります。WMS 1.0.0 の場合、feature_info に設定する必要があります。

マップ リクエストの一部

必須

なし

情報を必要としているマップを生成した、GetMap リクエスト パラメータの部分的なコピー

QUERY_LAYERS

必須

なし

検索対象の 1 つまたは複数のマップ レイヤのカンマ区切りリスト(たとえば、0,1,2layer1,layer2

INFO_FORMAT

必須(WMS 1.3.0)

オプション(WMS 1.1.1、1.1.0、1.0.0)

なし(WMS 1.3.0)

text/xml(WMS 1.1.1、1.1.0、1.0.0)

フィーチャ情報のリターン形式(たとえば、text/xmltext/html)。

I/X

必須

なし

マップ座標系におけるフィーチャのピクセル単位の X 座標(100 など)。WMS 1.3.0 には I を使用します。それ以外の場合には X を使用します。

J/Y

必須

なし

マップ座標系におけるフィーチャのピクセル単位の Y 座標(100 など)。WMS 1.3.0 には J を使用します。それ以外の場合には Y を使用します。

TIME

オプション

""

要求されたレイヤの時間値。

EXCEPTIONS

オプション

text/xml(WMS 1.3.0)

application/vnd.ogc.se_xml(WMS 1.1.1 および WMS 1.1.0)

application/vnd.ogc.inimage(WMS 1.0.0)

例外通知のフォーマット(たとえば、text/xmltext/html)。

WMS GetStyles リクエストのパラメータ

必須/オプション

デフォルト値

説明

VERSION

必須

1.3.0(9.3 以降)

1.1.1 (9.2)

OGC インタフェースに必要なバージョン

REQUEST

必須

なし

リクエスト名。GetStyles に設定する必要があります。

LAYERS

必須

なし

スタイルの説明を取得する、名前を付けたレイヤのカンマ区切りリスト

SLDVER

オプション

1.0.0 (10.0)

SLD ドキュメントのためにリクエストされた SLD バージョン。バージョン 1.0.0 のみがサポートされています。

WMS GetLegendGraphic リクエストのパラメータ

必須/オプション

デフォルト値

説明

VERSION

必須

1.3.0(9.3 以降)

1.1.1 (9.2)

OGC インタフェースに必要なバージョン

REQUEST

必須

なし

リクエスト名。GetLegendGraphic に設定する必要があります。

LAYER

必須

なし

凡例のグラフィックを作成するレイヤ

STYLE

オプション

デフォルト

凡例のグラフィックを作成するレイヤのスタイル。存在しない場合、デフォルトのスタイルが選択されます。スタイルには、レイヤに使用できる有効な任意のスタイルを使用できます(非 SLD 内部定義スタイルを含む)。

RULE

オプション

""

該当する場合、凡例のグラフィックを作成するスタイルのルール。スタイルに複数のルールがあり、特定のルールが選択されていない場合、マップ サービスはスタイルのすべてのルールを表現するグラフィックを作成することになります。

SLD

オプション

""

SLD ドキュメントへの参照を指定します。これは WMS GetMap オペレーションの SLD= パラメータと同様に動作します。

SLD_BODY

オプション

""

SLD ドキュメントが HTTP GET リクエストに直接含まれるようにします。これは WMS GetMap オペレーションの SLD_BODY パラメータと同様に動作します。

FORMAT

オプション

image/png(png24)

凡例グラフィックを返す際のファイル形式の MIME タイプ。使用可能な値は WMS GetMap リクエストの FORMAT= パラメータのものと同じです。

WIDTH

オプション

特定の凡例イメージに依存

返されるグラフィックの幅(ピクセル単位)についての情報を示します。

HEIGHT

オプション

特定の凡例イメージに依存

返されるグラフィックの高さ(ピクセル単位)についての情報を示します。

EXCEPTIONS

オプション

text/xml(WMS 1.3.0)

application/vnd.ogc.se_xml(WMS 1.1.1 および WMS 1.1.0)

application/vnd.ogc.inimage(WMS 1.0.0)

例外を返す際の形式の MIME タイプ。使用可能な値は WMS GetMap リクエストの EXCEPTIONS= パラメータのものと同じです。


3/6/2012