Verwenden von URL-Parametern zum Erstellen und Ändern von Karten

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 Untiefen vor der Küste von Maryland anzeigt, beispielsweise folgendermaßen mit URL-Parametern erstellen.

https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer&url=https://services5.arcgis.com/9cBkZtsx7PSOoaCF/arcgis/rest/services/Maryland_Shoals/FeatureServer/0

Schauen 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=4

Schauen 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_Basemap/MapServer

Im folgenden Beispiel ist derselbe Parameter verschlüsselt:

basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%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. Beispielsweise verfügt Albion Research Ltd. über die Seite "URLEncode und URLDecode". 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 8505192e747d440098523e9e64419710 in Map Viewer geöffnet:

https://www.arcgis.com/apps/mapviewer/index.html?webmap=8505192e747d440098523e9e64419710

Schauen 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.844375

Definieren 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 "World Physical Map" als Grundkarte verwendet wird:

https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

Schauen Sie sich dieses Beispiel in Map Viewer an.

In diesem Beispiel wird Map Viewer geöffnet, wobei "World Physical Map" als Grundkarte verwendet wird und in der Karte ein operationaler Layer mit der ID d35a5w4bo77593y0358s0x7312jpp04 vorhanden ist:

https://www.arcgis.com/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=d35a5w4bo77593y0358s0x7312jpp04

Einbeziehen 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 geöffnet, wobei der Bild-Layer "World Imagery Map" vorhanden ist und der Layer "World Boundary and Places" als Grundkarte 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/MapServer

In 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/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/Reference/World_Boundaries_and_Places/MapServer

Schauen Sie sich dieses Beispiel in Map Viewer an.

Definieren 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?layers=a79a3e4dc55343b08543b1b6133bfb90,9e2f2b544c954fda9cd13b7f3e6eebce

Schauen 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,2

Schauen 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/FeatureServer

Schauen 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://gis.ngdc.noaa.gov/arcgis/rest/services/web_mercator/trackline_combined_dynamic/MapServer,https://nowcoast.noaa.gov/arcgis/rest/services/nowcoast/wwa_meteoceanhydro_longduration_hazards_time/MapServer?layers=show:0,1,2,4,5&extent=-135-70,17,50

Schauen Sie sich dieses Beispiel in Map Viewer an.

Definieren 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.

Beispiel für geographische Koordinaten:

https://www.arcgis.com/apps/mapviewer/index.html?center=20,45&level=4

Schauen Sie sich dieses Beispiel in Map Viewer an.

Beispiel für projizierte Koordinaten:

https://www.arcgis.com/apps/mapviewer/index.html?center=500000,5500000,102100&level=4

Schauen Sie sich dieses Beispiel in Map Viewer an.

Definieren 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.

Beispiel für geographische Koordinaten:

https://www.arcgis.com/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06

Schauen Sie sich dieses Beispiel in Map Viewer an.

Beispiel für projizierte Koordinaten:

https://www.arcgis.com/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Schauen Sie sich dieses Beispiel in Map Viewer an.

Festlegen 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 sind die Sublayer 1 und 2 im Layer "USA" sichtbar, andere dagegen nicht:

https://www.arcgis.com/apps/mapviewer/index.html?url=https://sampleserver6.arcgisonline.com/arcgis/rest/services/USA/MapServer?layers=show:0,2

Schauen Sie sich dieses Beispiel in Map Viewer an.

Suchen 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,ca

Schauen 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

Schauen Sie sich dieses Beispiel in Map Viewer an.

Ü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.
  • Denken Sie daran, die Parameter title, icon und label zu 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

Schauen Sie sich dieses Beispiel in Map Viewer Classic an.