Eine Karte, die mit Map Viewer oder Map Viewer Classic erstellt wurde, enthält eine Grundkarte, Daten-Layer, eine Ausdehnung, eine Legende und Navigationswerkzeuge wie Zoomen, Schwenken, Ortssuche und Lesezeichen. Viele Karten enthalten außerdem interaktive Elemente wie eine Grundkarten-Galerie, Messwerkzeuge, Pop-ups und Schaltflächen für die Wiedergabe von Daten im Zeitverlauf.
Zusätzlich zum Erstellen von Karten mit Map Viewer oder Map Viewer Classic ist das direkte Erstellen oder Ändern von Karten mit URL-Parametern möglich.
Sie können eine Karte, die Biome und Ökoregionen anzeigt, beispielsweise folgendermaßen mit URL-Parametern erstellen.
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer&url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/Resolve_Ecoregions/FeatureServerSchauen Sie sich dieses Beispiel in Map Viewer an.
Eine Map Viewer-URL können Sie beispielsweise in folgenden Situationen verwenden:
- Wenn Sie nur wenige Referenz-Layer oder operationale Layer einbinden und auf den Inhalt der Karte keine bestimmten Styles anwenden müssen, verwenden Sie eine URL zum Öffnen von Map Viewer. Wenn Benutzer auf Ihrer Website beispielsweise nach einer Adresse suchen oder einzelne Layer zu Ihrer Site anzeigen können, können Sie in der Website einen Link einbinden, über den Map Viewer mit der angegebenen Grundkarte und dem entsprechenden Layer geöffnet wird.
- Sie müssen einen Link zu einer gespeicherten Webkarte über eine Website oder E-Mail erstellen. Sie können eine URL verwenden, über die die entsprechende Webkarte geöffnet wird.
Erforderliche Informationen der URL
Die URL beginnt in Map Viewer immer mit https://www.arcgis.com/apps/mapviewer/index.html? und in Map Viewer Classic mit https://www.arcgis.com/home/webmap/viewer.html? und enthält mindestens einen der unten angegebenen Abfrageparameter. Wenn Sie mehr als einen Parameter einfügen möchten, verwenden Sie zu deren Trennung das kaufmännische Und-Zeichen (&). Beispiele zur Verwendung von mehreren Parametern finden Sie auf dieser Seite.
Beispiel:
https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=8Schauen Sie sich dieses Beispiel in Map Viewer an.
Hinweis:
Wird eine der Ressourcen im URL-Parameter als HTTP bereitgestellt, müssen Sie HTTP in der URL durch HTTPS ersetzen und dürfen den Zugriff auf alle Ressourcen nur über HTTPS zuzulassen.
Codieren der Abfrageparameter
Alle Abfrageparameter müssen codiert sein. Durch die URL-Codierung wird sichergestellt, dass gültige Zeichen an ArcGIS Online gesendet werden. Die Codierung ersetzt ungültige Zeichen durch % gefolgt vom jeweils zugehörigen hexadezimalen Äquivalent.
Es folgt ein Beispiel für einen nicht codierten URL-Parameter:basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Ocean/World_Ocean_Base/MapServer
Im folgenden Beispiel ist derselbe Parameter verschlüsselt:basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean%2FWorld_Ocean_Base%2FMapServer
Parameter innerhalb von Parametern müssen ebenfalls codiert sein, z. B.:urls=https%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttps%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6
Im Internet stehen viele kostenlose Sites und Werkzeuge zum Erstellen von codierten URLs zur Verfügung, z. B. https://www.urlencoder.io/ Zur besseren Lesbarkeit sind die restlichen Beispiele in diesem Thema nicht codiert. Klicken Sie unterhalb des Beispiels auf den Link Dieses Beispiel anzeigen in Map Viewer, um die codierte URL in einem Webbrowser anzuzeigen.
Öffnen einer gespeicherten Karte
Zum Öffnen einer in Map Viewer oder Map Viewer Classic erstellten, gespeicherten Karte verwenden Sie webmap= und die eindeutige ID der Karte.
In diesem Beispiel wird eine Webkarte mit der ID 75a3ce8990674a5ebd5b9ab66bdab8938505192e747d440098523e9e64419710 in Map Viewer geöffnet:
https://www.arcgis.com/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893Schauen Sie sich dieses Beispiel in Map Viewer an.
In diesem Beispiel wird eine Webkarte mit der ID 29990ur6423j1180p53f9t30019491 in Map Viewer geöffnet, wobei die Ausdehnung auf –117.996342,33.841078,–117.993692,33.844375 festgelegt ist:
https://www.arcgis.com/apps/mapviewer/index.html?webmap=29990ur6423j1180p53f9t30019491&extent=-117.996342,33.841078,-117.993692,33.844375Definieren einer Grundkarte
Um die Grundkarte zu definieren, geben Sie für basemapUrl= den Layer an. Wenn keine Grundkarte definiert ist, wird als Standardgrundkarte die World Topographic-Grundkarte verwendet.
In diesem Beispiel wird Map Viewer geöffnet, wobei "OpenStreetMap" als Grundkarte verwendet wird:
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebceSchauen Sie sich dieses Beispiel in Map Viewer an.
In diesem Beispiel wird Map ViewerMap Viewer geöffnet, wobei "World Physical Map" als Grundkarte verwendet wird und in der Karte ein operationaler Layer mit der ID 9e2f2b544c954fda9cd13b7f3e6eebce vorhanden ist:
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=9e2f2b544c954fda9cd13b7f3e6eebceEinbeziehen eines Referenz-Layers
Um einen Referenz-Layer in die Grundkarte einzubeziehen, geben Sie für basemapReferenceUrl= den Layer an. Der Parameter basemapReferenceUrl= muss zusätzlich zu dem Parameter basemapUrl verwendet werden.
In diesem Beispiel wird Map Viewer mit dem Grundkarten-Layer "World Imagery Map" geöffnet, wobei "World Boundaries and Places" als Referenz-Layer verwendet wird:
https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServerIn diesem Beispiel wird Map Viewer geöffnet, wobei der Bild-Layer "World Imagery Map" vorhanden ist und der Layer "World Boundary and Places" als Grundkarte verwendet wird:
https://myportal.domain.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServerDefinieren des operationalen Layers
Um die operationalen Layer zu definieren, die die Grundkarte überlagern, verwenden Sie webmap=, layers=, layerIds=, url= oder urls=. Wenn der Layer ein Element der Website ist, verwenden Sie layers=, um alle Layer-Konfigurationen abzurufen. Um einzelne Sublayer aus einem Feature-Layer mit mehreren Sublayern hinzuzufügen, verwenden Sie layerIds=. Wenn der Layer nicht auf der Website vorhanden ist, verwenden Sie url= oder urls=.
Der Parameter layers= akzeptiert eine einzelne Element-ID oder mehrere Element-IDs. Verwenden Sie für mehrere Layer eine kommagetrennte Liste mit IDs (&layers=<itemID>,<itemID>,<itemID>).
Beispiel:
https://www.arcgis.com/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3Schauen Sie sich dieses Beispiel in Map Viewer an.
Der Parameter layerIds= akzeptiert eine einzelne Layer-ID oder mehrere Layer-IDs. Wenn ein Feature-Layer mehrere Sublayer enthält, verwenden Sie den Parameter layerIds= zum Hinzufügen einzelner Sublayer. Verwenden Sie für mehrere Sublayer eine kommagetrennte Liste mit IDs (&layerIds=0,1,2).
Beispiel:
https://www.arcgis.com/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2Schauen Sie sich dieses Beispiel in Map Viewer an.
Der Parameter url= akzeptiert eine einzelne Layer-URL.
Beispiel:
https://www.arcgis.com/apps/mapviewer/index.html?url=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/USGS_Seismic_Data_v1/FeatureServerSchauen Sie sich dieses Beispiel in Map Viewer an.
Verwenden Sie urls=, um mehr als einen Layer einzufügen. Trennen Sie die Layer durch ein Komma. Die Kartenausdehnung basiert auf dem letzten Layer in der Liste oder dem Service, der am langsamsten geladen wird. Um auf eine bestimmte Ausdehnung zu zoomen, fügen Sie den Parameter extent= ein.
Beispiel:
https://www.arcgis.com/apps/mapviewer/index.html?urls=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4&extent=-108,40,-85,31Definieren der Maßstabsebene und Zentrieren der Karte
In Map Viewer Classic wird der Maßstab für eine Karte automatisch festgelegt, wenn Sie den Parameter webmap oder find verwenden. Bei Verwendung des Parameters webmap wird automatisch auf die volle Ausdehnung der Karte gezoomt, sofern nicht andere URL-Parameter wie level und center oder extent verwendet werden, um den Maßstab der Webkarte zu überschreiben. Bei Verwendung des Parameters find wird automatisch auf die optimale Ausdehnung der gefundenen Position gezoomt.
Um eine bestimmte Maßstabsebene zu definieren, verwenden Sie die Parameter center und level. Der Parameter level akzeptiert die Ebenen-ID des Cache-Maßstabs, wie im REST-Service-Endpunkt der gekachelten Grundkarte aufgeführt. Die Auflösung verhält sich umgekehrt proportional zum Maßstab. Der Parameter level wird nur für gekachelte Grundkarten unterstützt und nicht für Grundkarten, die aus dynamischen Kartenservices und anderen nicht gekachelten Daten erstellt werden.
Um die Karte an einer bestimmten Position zu zentrieren, legen Sie center anhand geographischer Koordinaten (X,Y) oder projizierter Koordinaten (X,Y,WKID) fest. Als Trennzeichen können Sie Kommas oder Semikolons verwenden. Falls Sie Dezimalstellen durch Kommas abtrennen, verwenden Sie bitte Semikolons.
Hinweis:
Die Parameter level und center müssen zusammen verwendet werden. Der Parameter level wird ignoriert, wenn er einzeln verwendet wird.
Nachfolgend finden Sie ein Beispiel für geographische Koordinaten:
https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=4Schauen Sie sich dieses Beispiel in Map Viewer an.
Nachfolgend finden Sie ein Beispiel für projizierte Koordinaten:
https://www.arcgis.com/apps/mapviewer/index.html?center=500000,5500000,102100&level=4Definieren der Ausdehnung
Definieren Sie die Ausdehnung der Karte mit extent. Der Parameter extent akzeptiert geographische Koordinaten (GCS) in der Form "MinX,MinY,MaxX,MaxY" oder projizierte Koordinaten (PCS) in der Form "MinX,MinY,MaxX,MaxY,WKID". Als Trennzeichen können Sie Kommas oder Semikolons verwenden. Falls Sie Dezimalstellen durch Kommas abtrennen, verwenden Sie bitte Semikolons.
Nachfolgend finden Sie ein Beispiel für geographische Koordinaten:
https://www.arcgis.com/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06Schauen Sie sich dieses Beispiel in Map Viewer an.
Nachfolgend finden Sie ein Beispiel für projizierte Koordinaten:
https://www.arcgis.com/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113Festlegen der Layer-Sichtbarkeit
Verwenden Sie layers=show:, um die Sichtbarkeit von Sublayern für einen Layer festzulegen, der in der Karte geöffnet wird.
In diesem Beispiel ist der Sublayer 3 sichtbar, andere dagegen nicht:
Hinweis:
Die Nummerierung der Sublayer startet, wie im REST-Endpunkt dargestellt, bei Null (0).https://www.arcgis.com/apps/mapviewer/index.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=PennsylvaniaSuchen einer Position oder eines Features zum Öffnen der Karte
Damit eine Position oder ein Feature beim Öffnen der Karte sofort gefunden wird, verwenden Sie find. Die Karte wird automatisch auf die Position der nächsten Übereinstimmung gezoomt, und der Karte wird eine Bannerbeschriftung hinzugefügt. Der Parameter find akzeptiert einzeilige Adressen, Teiladressen (wie nur Stadt oder nur Land), Ortsnamen, Breiten- und Längengradkoordinaten sowie Features in durchsuchbaren Layern (wie 1916352001 für eine Parcel Identification Number [PIN]).
Im folgenden Beispiel wird eine einzeilige Adresse verwendet:
https://www.arcgis.com/apps/mapviewer/index.html?find=380 new york st,redlands,caSchauen Sie sich dieses Beispiel in Map Viewer an.
Tipp:
Um eine Position oder ein Feature in einem durchsuchbaren Layer zu suchen, können Sie den Parameter webmap= in die eindeutige ID der Karte einbeziehen.
Hinzufügen eines Punktes
Mit marker=<x>,<y> können Sie der Karte einen Punkt hinzufügen. Sie können auch die folgenden optionalen Eigenschaften festlegen:
- <wkid>: Raumbezug der hinzugefügten XY-Koordinaten, der der Karte hinzugefügt werden soll. Sollten Sie kein WKID angeben, werden GCS-Koordinaten verwendet.
- <encoded title>: Titel des Pop-ups für den Punkt. Wenn Sie keinen Titel angeben, bleibt das Pop-up leer.
- <encoded icon URL>: Punktsymbol. Wenn Sie kein Symbol angeben, wird ein blaues Markersymbol verwendet.
- <encoded label>: Beschriftung des Punktsymbols.
Beispiel
Im folgenden Beispiel werden Semikolons als Trennzeichen verwendet:
https://www.arcgis.com/apps/mapviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra MarathonÜberlegungen
Beachten Sie Folgendes beim Hinzufügen eines Punktes zu einer Karte:
- In Map Viewer Classic wird der Punkt einem neuen Kartennotizen-Layer an der angegebenen XY-Koordinatenposition hinzugefügt.
- Zum Hinzufügen eines Punktes sind die <x>,<y>-Koordinaten erforderlich.
- Sie müssen die Parameter title, icon und label codieren.
- Fügen Sie die Eigenschaften in folgender Reihenfolge hinzu: marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>.
- Als Trennzeichen können Sie Kommas oder Semikolons verwenden. Falls Sie Dezimalstellen durch Kommas abtrennen, verwenden Sie bitte Semikolons.
- Verwenden Sie leere Werte. Verwenden Sie keine Leerzeichen. Um zum Beispiel eine Beschriftung anzugeben, jedoch keine der anderen optionalen Eigenschaften, fügen Sie die Beschriftung als sechsten Parameter hinzu, und lassen Sie die anderen leer (x;y;;;;label).
- Wenn sich die Karte (neben der Zentrierung auf den Punkt) vergrößern lassen soll, geben Sie den Parameter level an.
- Den Layer "Kartennotizen" können Sie als Karte oder Element bearbeiten und speichern.
- Organisationskonten können den Punkt verwenden, um Wegbeschreibungen abzurufen und Analysen durchzuführen.
Ausblenden des Detailbereichs
Hinweis:
Diese Funktionalität wird derzeit nur in Map Viewer Classic unterstützt. Sie wird in einer zukünftigen Version von Map Viewer verfügbar sein.
Den Bereich Details in Map Viewer Classic können Sie mit mapOnly=true ausblenden.
In diesem Beispiel wird eine gespeicherte Webkarte mit der ID 8505192e747d440098523e9e64419710 in Map Viewer Classic geöffnet, wobei der Bereich "Details" jedoch ausgeblendet ist:
https://www.arcgis.com/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710&mapOnly=true