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

Eine Karte, die in einem ArcGIS Enterprise-Portal 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.

myportal.domain.com/arcgis/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/FeatureServer

Sie können eine Karte, die Windparks an Land in Großbritannien anzeigt, folgendermaßen mit URL-Parametern in Map Viewer Classic erstellen.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=https%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

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, um einen der Map Viewer zu öffnen. 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 Classic immer mit der URL der ArcGIS Enterprise-Portal-Startseite, plus /webmap/viewer.html? plus und enthält mindestens einen der unten angegebenen Abfrageparameter. In Map Viewer beginnt die URL immer mit dem vollständig qualifizierten ArcGIS Enterprise-Namen und dem Web Adapter- oder Load Balancer-Kontext sowie apps/mapviewer/index.html? und mindestens einem der unten aufgeführten 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.

Im ersten Beispiel unten wird Map Viewer geöffnet, im zweiten Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=8

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=8
Hinweis:

Wird eine der Ressourcen im URL-Parameter als HTTP bereitgestellt, muss die URL für die Karte ebenfalls HTTP sein. Um die Sicherheit zu erhöhen, verwenden Sie möglichst eine HTTPS-URL.

Codieren der Abfrageparameter

Alle Abfrageparameter müssen codiert sein. Durch die URL-Codierung wird sichergestellt, dass gültige Zeichen an das Portal 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://myportal.domain.com:7443/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%2Fmyportal.domain.com:7443%2Farcgis%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. Zur besseren Lesbarkeit sind die restlichen Beispiele in diesem Thema nicht codiert.

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

Im ersten Beispiel wird eine Webkarte mit der ID 75a3ce8990674a5ebd5b9ab66bdab893 in Map Viewer Classic geöffnet: Die zweite URL öffnet die gleiche Karte in Map Viewer.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893

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://myportal.domain.com/arcgis/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.

Mit der ersten Beispiel-URL wird Map Viewer geöffnet, und "World Physical Map" wird als Grundkarte verwendet. Mit der ersten Beispiel-URL wird die Karte in Map Viewer Classic geöffnet.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

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://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce

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 Classic mit dem Grundkarten-Layer "World Imagery Map" geöffnet, wobei "World Boundaries and Places" als Referenz-Layer verwendet wird:

https://myportal.domain.com/arcgis/home/webmap/viewer.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

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

Das erste Beispiel wird in Map Viewer geöffnet. Das zweite Beispiel wird in Map Viewer Classic angezeigt:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3

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

Das erste Beispiel wird in Map Viewer geöffnet. Das zweite Beispiel wird in Map Viewer Classic angezeigt:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2
https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2

Der Parameter url= akzeptiert eine einzelne Layer-URL.

Beispiel:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
     url=https://services.myportal.domain.com:7443/arcgis/rest/services/Demographics/USA_Population_Density/MapServer

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.

Die erste URL öffnet die Karte in Map Viewer. Die zweite URL öffnet sie in Map Viewer Classic:

https://myportal.domain.com/arcgis/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,31

https://myportal.domain.com/arcgis/home/webmap/viewer.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

Ab ArcGIS 10.5 kann der Vorgang ?layers für einen Feature-Service verwendet werden.

Beispiel:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://sampleserver6.arcgisonline.com/arcgis/rest/services/RedlandsEmergencyVehicles/FeatureServer?layers=show:1,2

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.

Nachfolgend finden Sie ein Beispiel für geographische Koordinaten in Map Viewer:

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

Nachfolgend finden Sie ein Beispiel für geographische Koordinaten in Map Viewer Classic:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

Nachfolgend finden Sie ein Beispiel für projizierte Koordinaten in Map Viewer:

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

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.

Nachfolgend finden Sie ein Beispiel für geographische Koordinaten in Map Viewer:

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

Nachfolgend finden Sie ein Beispiel für projizierte Koordinaten in Map Viewer:

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

Nachfolgend finden Sie ein Beispiel für projizierte Koordinaten in Map Viewer Classic:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

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 ist der Sublayer 3 sichtbar, andere dagegen nicht:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=Pennsylvania

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 sowie Breiten- und Längengradkoordinaten.

Im folgenden Beispiel wird eine einzeilige Adresse in Map Viewer verwendet:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?find=380 new york st,redlands,ca
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://myportal.domain.com/arcgis/home/webmap/viewer.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

Ü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 (früher als Map Viewer bezeichnet) unterstützt. Sie wird in einer zukünftigen Version des neuen 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 b487d81007294fb5a0be9e10a411f2d0 in Map Viewer Classic geöffnet, wobei der Bereich "Details" jedoch ausgeblendet ist:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=b487d81007294fb5a0be9e10a411f2d0&mapOnly=true