Kommunikation mit einem WMS-Service in einem Webbrowser

In diesem Thema erfahren Sie, wie Sie verschiedene URL-Parameter verwenden können, um mit einem WMS-Service in einem Webbrowser zu kommunizieren.

WMS-Anforderung und Antwort

Die Online-Ressource jeder Operation, die von einem konformen WMS-Server unterstützt wird, ist eine HTTP Uniform Resource Locator (URL), deshalb kann ein WMS-Service als REST-Service (Representational State Transfer) betrachtet werden. Im Gegensatz zu einem Standard-Web-Service ist kein SOAP-Client für das Verwenden eines WMS-Service notwendig, und ein Webbrowser ist der einfachste Client. Sie können die Servicelevel-Metadaten eines WMS-Service, ein Kartenbild oder Attributwerte eines Features abrufen, indem Sie eine URL-Anforderung an den Server senden und die entsprechenden Antworten im Browser entweder als XML-Dokument oder als Bild anzeigen.

Unten finden Sie einige Beispielanforderungen und Antworten für jede von einem ArcGIS Server-WMS-Service unterstützte Operation.

WMS GetCapabilities-Anforderung

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

XML-Antwort

XML-Antwort für WMS GetCapabilities

WMS GetMap-Anforderung

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

Antwortkarte

Antwortkarte für WMS GetMap

WMS GetFeatureInfo-Anforderung

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-Antwort

XML-Antwort für WMS GetFeatureInfo

WMS GetStyles-Anforderung

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

XML-Antwort

XML-Antwort für WMS GetStyles

WMS GetLegendGraphic-Anforderung

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

Antwort-Legendengrafik

Antwortgrafik für WMS GetLegendGraphic

WMS GetMap-Anforderung mit TIME-Parameter

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

Antwortkarte

Antwortkarte für WMS GetMap-Anforderung mit TIME-Parameter
HinweisHinweis:

In vielen Fällen ist ein Webbrowser vielleicht kein bevorzugter WMS-Client, aber er ist immer ein gutes Werkzeug, um die Kommunikation zwischen einem WMS-Server und einem Client zu verfolgen und zu debuggen.

WMS-Anforderungsparameter

Die OGC WMS-Spezifikationen definieren eine vollständige Liste von Anforderungsparametern, die in jeder WMS-Operation verwendet werden können. Verschiedene Versionen der OGC WMS-Implementierungsspezifikation sind unten in den Links angegeben:

Version 1.3.0

Version 1.1.1

Version 1.1.0

Version 1.0.0

In den Tabellen unten sind alle Anforderungsparameter, die auf die WMS-Implementierung in ArcGIS Server anwendbar sind, aufgeführt; dies ist nur eine Teilmenge von denen, die in der Spezifikation definiert sind.

Parameter eines WMS GetCapabilities-Anforderungs-URL

Erforderlich/optional

Standardwert

Beschreibung

VERSION/WMTVER

Optional

1.3.0 (9.3 und höher)

1.1.1 (9.2)

Version anfordern. Verwenden Sie WMTVER nur in WMS 1.0.0; verwenden Sie andernfalls VERSION.

SERVICE

Erforderlich

nicht zutreffend

Service-Typ. Muss auf WMS festgelegt werden. Der Parameter ist in WMS 1.0.0 nicht verfügbar.

REQUEST

Erforderlich

nicht zutreffend

Anforderungsname. Muss auf GetCapabilities festgelegt werden. Muss für WMS 1.0.0 auf capabilities eingestellt werden.

FORMAT

Optional

text/xml (9.3 und höher)

Ausgabeformat für Service-Metadaten. Nur in WMS 1.3.0 verfügbar. (Beispiel: application/vnd.ogc.wms_xml oder text/plain oder text/html).

Parameter eines WMS GetMap-Anforderungs-URL

Erforderlich/optional

Standardwert

Beschreibung

VERSION/WMTVER

Erforderlich

nicht zutreffend

Version anfordern. Verwenden Sie WMTVER nur in WMS 1.0.0; verwenden Sie andernfalls VERSION.

REQUEST

Erforderlich

nicht zutreffend

Anforderungsname. Muss auf GetMap festgelegt werden. Muss für WMS 1.0.0 auf map eingestellt werden.

LAYERS

Erforderlich

nicht zutreffend

Durch Kommas getrennte Liste von einem oder mehreren Karten-Layern (z. B. 0,1,2 oder layer1,layer2).

STYLES

Erforderlich

nicht zutreffend

Durch Kommas getrennte Liste von einem oder mehreren Styles, ein Style pro angefordertem Layer (z. B. 0,1,2 oder style1,style2).

CRS/SRS

Erforderlich

nicht zutreffend

Koordinatenbezugssystem. CRS wird nur in WMS 1.3.0 verwendet, andernfalls verwenden Sie SRS (z. B. EPSG:4326 oder EPSG:4269).

BBOX

Erforderlich

nicht zutreffend

Eckpunkte des Rahmens (links unten und rechts oben) in CRS/SRS-Einheiten (z. B. -180,-90,180,90).

WIDTH

Erforderlich

nicht zutreffend

Breite des Kartenbilds in Pixeln (z. B. 1024).

HEIGHT

Erforderlich

nicht zutreffend

Höhe des Kartenbilds in Pixeln (z. B. 768).

FORMAT

Erforderlich

nicht zutreffend

Ausgabeformat der Karte (z. B. image/png oder image/jpeg oder image/svg+xml).

TRANSPARENT

Optional

Falsch

Bestimmt, ob Hintergrund transparent ist oder nicht (z. B. True oder False).

BGCOLOR

Optional

0xFFFFFF

Hexadezimale RGB-Farbe für den Kartenhintergrund (z. B. 0xFFFFFF oder FFFFFF).

SLD

Optional

""

URL der Styled Layer Descriptor-XML-Datei.

SLD_BODY

Optional

""

XML-Text der Styled Layer Descriptor-Datei.

TIME

Optional

""

Zeitwert des angeforderten Layers.

EXCEPTIONS

Optional

text/xml (WMS 1.3.0)

application/vnd.ogc.se_xml (WMS 1.1.1 und WMS 1.1.0)

application/vnd.ogc.inimage (WMS 1.0.0)

Das Format, in dem Ausnahmen gemeldet werden sollten (z. B. text/xml oder text/html).

Parameter eines WMS GetFeatureInfo-Anforderungs-URL

Erforderlich/optional

Standardwert

Beschreibung

VERSION/WMTVER

Erforderlich

nicht zutreffend

Version anfordern. Verwenden Sie WMTVER nur in WMS 1.0.0; verwenden Sie andernfalls VERSION.

REQUEST

Erforderlich

nicht zutreffend

Anforderungsname. Muss auf GetFeatureInfo festgelegt werden. Muss für WMS 1.0.0 auf feature_info eingestellt werden.

Kartenanforderungsteil

Erforderlich

nicht zutreffend

Teilkopie der GetMap-Anforderungsparameter, die die Karte generiert haben, für die Informationen gewünscht wurden.

QUERY_LAYERS

Erforderlich

nicht zutreffend

Durch Kommas getrennte Liste von einem oder mehreren Karten-Layern, die abgefragt werden sollen (z. B. 0,1,2 oder layer1,layer2).

INFO_FORMAT

Erforderlich (WMS 1.3.0)

Optional (WMS 1.1.1, 1.1.0, 1.0.0)

nicht zutreffend (WMS 1.3.0)

text/xml (WMS 1.1.1, 1.1.0, 1.0.0)

Rückgabeformat der Feature-Informationen (z. B. text/xml, text/html).

I/X

Erforderlich

nicht zutreffend

X-Koordinate in Pixeln von Feature im Kartenkoordinatensystem (z. B. 100). Verwenden Sie I für WMS 1.3.0; andernfalls X.

J/Y

Erforderlich

nicht zutreffend

Y-Koordinate in Pixeln von Feature im Kartenkoordinatensystem (z. B. 100). Verwenden Sie J für WMS 1.3.0; andernfalls Y.

TIME

Optional

""

Zeitwert des angeforderten Layers.

EXCEPTIONS

Optional

text/xml (WMS 1.3.0)

application/vnd.ogc.se_xml (WMS 1.1.1 und WMS 1.1.0)

application/vnd.ogc.inimage (WMS 1.0.0)

Das Format, in dem Ausnahmen gemeldet werden sollten (z. B. text/xml oder text/html).

Parameter einer WMS GetStyles-Anforderung

Erforderlich/optional

Standardwert

Beschreibung

VERSION

Erforderlich

1.3.0 (9.3 und höher)

1.1.1 (9.2)

Version wie für OGC-Schnittstellen erforderlich.

REQUEST

Erforderlich

nicht zutreffend

Anforderungsname. Muss auf GetStyles festgelegt werden.

LAYERS

Erforderlich

nicht zutreffend

Durch Kommas getrennte Liste benannter Layer zum Abrufen von Style-Beschreibungen.

SLDVER

Optional

1.0.0 (10.0)

Die für das SLD-Dokument angeforderte SLD-Version. Nur Version 1.0.0 wird unterstützt.

Parameter einer WMS GetLegendGraphic-Anforderung

Erforderlich/optional

Standardwert

Beschreibung

VERSION

Erforderlich

1.3.0 (9.3 und höher)

1.1.1 (9.2)

Version wie für OGC-Schnittstellen erforderlich.

REQUEST

Erforderlich

nicht zutreffend

Anforderungsname. Muss auf GetLegendGraphic festgelegt werden.

LAYER

Erforderlich

nicht zutreffend

Layer, für den die Legendengrafik erzeugt werden soll.

STYLE

Optional

Standard

Style des Layers, für den die Legendengrafik erzeugt werden soll. Falls nicht vorhanden, wird der Standard-Style ausgewählt. Der Style kann jeder für einen Layer verfügbare gültige Style sein, einschließlich intern definierte Nicht-SLD-Styles.

RULE

Optional

""

Style-Regel, für die die Legendengrafik erzeugt werden soll (falls zutreffend). Wenn ein Style mehrere Regeln hat, aber keine bestimmte Regel ausgewählt ist, erzeugt der Karten-Service eine Grafik, die für alle Regeln für den Style repräsentativ ist.

SLD

Optional

""

Gibt einen Verweis auf ein SLD-Dokument an. Funktioniert auf die gleiche Weise wie der Parameter "SLD =" der WMS GetMap-Operation.

SLD_BODY

Optional

""

Erlaubt, dass ein SLD-Dokument direkt in einer HTTP-GET-Anforderung enthalten sein kann. Funktioniert auf die gleiche Weise wie der Parameter "SLD_BODY" der WMS GetMap-Operation.

FORMAT

Optional

image/png (png24)

Der MIME-Typ des Dateiformats, in dem die Legendengrafik zurückgegeben werden soll. Zulässige Werte sind die Gleichen wie für den Parameter "FORMAT=" der WMS GetMap-Anforderung.

WIDTH

Optional

Hängt vom jeweiligen Legendenbild ab.

Gibt einen Hinweis für die Breite der zurückgegebenen Grafik in Pixeln.

HEIGHT

Optional

Hängt vom jeweiligen Legendenbild ab.

Gibt einen Hinweis für die Höhe der zurückgegebenen Grafik in Pixeln.

EXCEPTIONS

Optional

text/xml (WMS 1.3.0)

application/vnd.ogc.se_xml (WMS 1.1.1 und WMS 1.1.0)

application/vnd.ogc.inimage (WMS 1.0.0)

Der MIME-Typ des Formats, in dem Ausnahmen zurückgegeben werden soll. Zulässige Werte sind die Gleichen wie für den Parameter "EXCEPTIONS=" der WMS GetMap-Anforderung.


7/10/2012