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
 |
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
 |
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
 |
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
 |
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
 |
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
 |
Hinweis: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:
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. |