Widget "Karte"

Mit dem Widget "Karte" können Sie geographische 2D- und 3D-Informationen anzeigen lassen. Sie können Werkzeuge in der Karte aktivieren, zum Beispiel Zoomen, Eigene Position, Suchen und Messen.

Beispiele

Verwenden Sie dieses Widget, um zum Beispiel die folgenden Anforderungen an das App-Design zu unterstützen:

• Sie müssen den Vergleich einer Karte in 2D und 3D anzeigen. Sie können zwei Karten-Widgets hinzufügen und einen Trigger und eine Aktion erstellen, um beim Interagieren mit einer der beiden Karten die Ansichten synchronisieren.
• Sie möchten auf ein Feature in der Karte klicken und den Datensatz in einem Feature-Info-Widget anzeigen.
• Es besteht die Anforderung, ein Listen-Widget nach dem Klicken auf ein Feature in der Karte entsprechend zu filtern.

Verwendungshinweise

Sie können eine einzelne Karte anzeigen oder die Option zum Wechseln zwischen zwei Karten einfügen. Sie können mehrere Karten in einer App einfügen, indem Sie weitere Karten-Widgets hinzufügen.

Das Widget "Karte" benötigt eine Datenquelle mit Webkarten und Webszenen. Wenn Sie Werkzeuge einfügen, werden sie auf der Karte automatisch basierend auf der Größe des Widgets sowohl im Design-Modus als auch in der fertigen App positioniert.

Tipp:

Wenn Sie eine Webkarte oder -szene mit mehreren Layern haben und festlegen möchten, welche Layer standardmäßig in verschiedenen Karten-Widgets angezeigt werden, können Sie die gleiche Webkarte oder -szene mehrmals auf der Registerkarte Daten hinzufügen, verschiedene Sublayer in jeder Kopie der Karte oder Szene ausblenden und jede Kopie mit einem anderen Karten-Widget verbinden.

Weitere Informationen zum Konfigurieren der Layer-Sichtbarkeit über eine Karte und deren Nutzung in unterschiedlichen Karten-Widgets

Einstellungen

Das Widget "Karte" verfügt über folgende Einstellungen:

• Karte auswählen: Fügen Sie eine Datenquelle für Webkarten und Webszenen hinzu.
• Startansicht: Legen Sie die erste Position der Karte fest, wenn sie im Widget geladen wird.
  • Standard: Die Positionierung der Karte wird aus der Webkarte oder Webszene übernommen.
  • Benutzerdefiniert: Sie können die Startansicht ändern, indem Sie eine benutzerdefinierte Position für die Karte erstellen.
• Werkzeuge: Fügen Sie Werkzeuge für die Interaktion der Benutzer mit der Karte ein.
  • Zoomen: Vergrößern und verkleinern Sie die Anzeige der Karte.
  • Standardausdehnung: Vergrößern und verkleinern Sie die Karte auf die ursprüngliche Kartenposition (Ausdehnung).
  • Navigation: Nehmen Sie Werkzeuge zum Schwenken und Drehen der Karte auf. Diese Werkzeuge werden angezeigt, wenn im Widget "Karte" eine 3D-Webszene angezeigt wird.
  • Eigene Position: Zeigen Sie die aktuelle Position des Benutzers an.
  • Kompass: Geben Sie an, wo Norden in Relation zur aktuellen Ansicht einer 2D- oder 3D-Karte ist.
  • Suchen: Suchen Sie Positionen basierend auf einem Geokodierungsservice Ihrer Organisation oder Ihres Portals. Wenn Sie Pop-ups aktivieren, werden Pop-ups für Suchergebnisse angezeigt.
  • Layer: Zeigen Sie eine Liste mit Layern und Symbolen in der Karte an, und ermöglichen Sie Benutzern das Aktivieren bzw. Deaktivieren der Layer und Symbole.
  • Grundkarte: Zeigen Sie eine Galerie mit Grundkarten an.
  • Messen: Fügen Sie Werkzeuge zum Messen von Flächen und Entfernungen ein. Das Werkzeug "Messen" verwendet das Fangen. Der Zeiger wird an Features auf der Karte gefangen. Beim Messen kann der Benutzer die STRG-Taste gedrückt halten, um das Fangen vorübergehend zu deaktivieren.
  • Vollbild: Nutzen Sie den gesamten Bildschirm für die Anzeige der Karte.
  • Maßstabsleiste: Fügen Sie eine Maßstabsleiste auf der Karte ein, die Einheiten in metrischen oder nichtmetrischen Werten anzeigt und dynamisch auf verschiedene Koordinatensysteme reagiert.
  • Auswählen: Wählen Sie Features auf der Karte mit verschiedenen Auswahlwerkzeugen und Auswahlmodi aus. Benutzer haben Zugang zu folgenden Auswahlwerkzeugen und können Features auswählen, die entweder vollständig in gezeichneten Polygonen enthalten sind oder teilweise oder vollständig darin liegen.
    • Rechteck: Klicken und ziehen Sie, um ein Rechteck um die Features zu zeichnen.
    • Lasso: Klicken Sie auf die Karte, um die Stützpunkte eines Polygons zu erstellen, oder zeichnen Sie mit dem Zeiger eine Freihandform. Doppelklicken Sie, um das Polygon zu schließen und enthaltene Features auszuwählen.
    • Kreis: Klicken Sie und ziehen Sie einen Kreis um Features.
    • Linie: Klicken Sie auf die Karte, um die Stützpunkte einer Linie zu erstellen. Doppelklicken Sie, um die Linie zu beenden und überschneidende Features auszuwählen.
    • Punkt: Klicken Sie auf die Karte, um einen Punkt zu platzieren und überschneidende Features auszuwählen.

    Die Benutzer können mehrere Features auf die folgenden vier Arten auswählen:

    • Erstellen einer Feature-Auswahl bei jedem Zeichnen mit dem Auswahlwerkzeug. Dies ist die Standardeinstellung.
    • Hinzufügen zur aktuellen Auswahl (UMSCHALT beim Zeichnen drücken).
    • Entfernen von Features aus der aktuellen Auswahl (unter Windows STRG beim Zeichnen drücken; beim Mac die Befehlstaste beim Zeichnen drücken)
    • Auswählen von Features aus der aktuellen Auswahl (unter Windows STRG+UMSCHALT beim Zeichnen drücken; beim Mac Befehlstaste+Umschalttaste drücken)

    Wenn der Benutzer eine Auswahl getroffen hat, wird das Symbol für das Auswahlwerkzeug zu einem Fortschrittssymbol. Wenn der Benutzer eine große Anzahl von Features auswählt, kann der Auswahlprozess sehr lange dauern. Die Benutzer können auf die Fortschrittsschaltfläche klicken, um den Auswahlprozess zu beenden.

  • Ausdehnungsnavigation: Durchlaufen der Ausdehnungen, die der Benutzer zur Laufzeit besucht hat.
  • Übersichtskarte: Fügen Sie eine einblendbare Nebenkarte hinzu. Die Übersichtskarte ist eine kleinere Version der Hauptkarte mit einem Locator-Rechteck, das die Ausdehnung der Hauptkarte darstellt. Wenn Sie auf das Locator-Rechteck klicken und es ziehen, wird die Hauptkarte auf die neue Position gezoomt. Dieses Werkzeug wird bei kleinen Bildschirmlayouts nicht angezeigt.
• Werkzeuglayout: Wählen Sie ein Layout für die Kartenwerkzeuge für große und mittelgroße Bildschirme aus.

  Hinweis:

  Damit das Widget "Karte" problemlos auch auf mittelgroßen und kleinen Bildschirmen verwendet werden kann, werden je nach der Höhe des Widgets automatisch bestimmte Werkzeuge ausgeblendet. Wenn zum Beispiel die Höhe eines Karten-Widgets unter 465 Pixel liegt, werden auf kleinen und mittelgroßen Bildschirmen die Werkzeuge "Suchen" und "Messen" selbst dann ausgeblendet, wenn sie in den Einstellungen des Widgets aktiviert sind. Mit abnehmender Höhe des Widgets werden immer mehr Werkzeuge ausgeblendet. Die Werkzeuge "Vollbild", "Suche", "Zoom", "Maßstabsleiste" und "Kompass" werden zuletzt ausgeblendet.

• Optionen
  • Farben für die Feature-Auswahl: Ändern Sie die Hervorhebungsfarbe und Transparenz für Features, die in der Karte ausgewählt sind. Sie können Füllung und Umriss der Hervorhebung anpassen.
  • Zoomen mit dem Mausrad aktivieren: Aktiviert das Zoomen mit dem Mausrad und auf Touchscreens das Schwenken der Karte mit einem Finger.
  • Pop-up aktivieren: Aktivieren Sie Pop-ups auf der Karte. Wenn Ihre App auch ein Feature-Info-Widget enthält, können Sie diese Einstellung deaktivieren. Wenn eine Datenquelle über zugehörige Daten verfügt und Sie zugehörige Datensätze in Pop-ups in Map Viewer konfigurieren, können Sie zugehörige Datensätze in Pop-ups in Experience Builder anzeigen.
    • Pop-up bei Auswahl eines Features anzeigen: Das Widget kann Pop-ups auf der Karte anzeigen, wenn der Benutzer Karten-Features in einem anderen Widget auswählt, z. B. "Tabelle" oder "Liste".
    • Pop-up verankern: Pop-ups standardmäßig verankern. Sie können konfigurieren, dass Pop-ups an einem von sechs Ankerpunkten innerhalb des Rahmens des Widgets "Karte" angezeigt werden. Zur Laufzeit können die Benutzer weiterhin auf Verankern und Abdocken des Pop-ups klicken, um die Stelle, an der Pop-ups angezeigt werden, zu ändern.
  • Szenen-Qualitätsmodus (für Webszenen): Steuern Sie die Qualität der Webszene, indem Sie die visuellen Effekte und die Effizienz beim Laden ausbalancieren.
    • Niedrig: Steigern Sie Performance, Stabilität und Geschwindigkeit durch verringertes Datenaufkommen.
    • Mittel: Performance und Qualität werden gleichwertig optimiert.
    • Hoch: Verbessern Sie die Qualität von Visualisierungsoptionen (beispielsweise Wasserspiegelungen).
• Clientseitige Abfragen aktivieren: Aktivieren Sie diese Umschaltflächen, wenn Widgets in der App clientseitige Abfragen für das Arbeiten mit Daten aus Ihren Webkarten verwenden sollen. Wenn Sie dieselbe Webkarte mit mehreren Karten-Widgets verbinden, müssen Sie die clientseitigen Abfragen für eine Webkarte nur einmal aktivieren.

  Hinweis:

  Webszenen unterstützen keine clientseitigen Abfragen.

  Die Vorteile clientseitiger Abfragen sind eine geringere Belastung des Servers und eine verbesserte Performance der App. Durch clientseitige Abfragen wird die Anzahl der Netzwerkanforderungen an einen Server erheblich reduziert. Außerdem sind clientseitige Abfragen schneller als serverseitige Abfragen. Datenbezogene Tasks wie die Auswahl eines Features zum Aktualisieren eines Diagramms werden schneller ausgeführt.

  Der Nachteil clientseitiger Abfragen besteht darin, dass das Laden der Karten-Features länger dauert, wenn Sie die Kartenausdehnung ändern.

  Hinweis:

  Eine häufige Experience Builder-App-Konfiguration, die mit einer hohen Server-Belastung verbunden sein kann, ist ein Listen-Widget, das auf der Grundlage der aktuellen Kartenausdehnung aktualisiert wird.

  Um eine Überlastung der Server zu vermeiden, wird empfohlen, clientseitige Abfragen zu aktivieren, wenn Sie ein Karten-Widget mit dem Trigger Änderungen der Ausdehnung und der Meldungsaktion Datensätze filtern konfigurieren. Dies ist besonders wichtig, wenn zu erwarten ist, dass viele Benutzer gleichzeitig auf eine App zugreifen.

  Hinweis:

  Bekannte Einschränkungen von clientseitigen Abfragen finden Sie in der ArcGIS Maps SDK for JavaScript-Dokumentation.

Optionen für Interaktionen

Das Widget "Karte" unterstützt das Festlegen eines Triggers auf der Registerkarte Aktion in den Einstellungen des Widgets. Sie können zwei Karten-Widgets synchronisieren, indem Sie einmal den Trigger Änderungen der Ausdehnung beiden Karten hinzufügen, für beide Karten die jeweils andere Karte als Ziel auswählen und dann die Aktion Schwenken auf oder Zoomen auf auswählen. Bei Webkarten erstreckt sich die Synchronisierung der Aktion Zoomen auf auch auf das Verhalten beim Drehen. Bei Webszenen wird das Verhalten beim Drehen und beim Neigen berücksichtigt.

Hinweis:

Wenn ein Karten-Widget mit den beiden Aktionen Zoomen auf und Schwenken auf konfiguriert ist, dann hat die Aktion Zoomen auf Vorrang vor der Aktion Schwenken auf. Das heißt, wenn der Benutzer die Karte gleichzeitig schwenkt und zoomt, wird die Aktion Schwenken auf ignoriert.

Sie können Trigger und Meldungsaktionen festlegen, damit eine Karte mit anderen Widgets interagieren kann. Zum Beispiel können Sie einen Aktions-Trigger für die Anzeige nur der Features in einem Listen-Widget, die auf der Karte sichtbar sind, hinzufügen. Das Karten-Widget unterstützt auch Datenaktionen, die in Popup-Fenstern angezeigt werden und es den Benutzern ermöglichen, Daten zu exportieren, Datensätze in einer Tabelle anzuzeigen und vieles mehr. Trigger, Meldungsaktionen und Datenaktionen werden auf der Registerkarte Aktion der Widget-Einstellungen definiert und verwaltet. Weitere Informationen zu den unterstützten Aktionen des Karten-Widgets finden Sie unter Hinzufügen von Aktionen zu Widgets.

URL-Parameter

In den folgenden Unterabschnitten werden kartenbezogene URL-Parameter beschrieben. Sie können die Einstellungen unter "URL-Status verwalten" verwenden, damit diese Parameter in der URL angezeigt werden, wenn der Benutzer mit dem Widget "Karte" interagiert. Die Parameter des Widgets "Karte" folgen auf Hash-Zeichen (#). Wenn Sie mehrere Parameter angeben möchten, müssen Sie sie durch kaufmännische Und-Zeichen (&) voneinander trennen.

Hinweis:

Die Parameter center, scale und rotation des Widgets "Karte" funktionieren nur bei Webkarten, nicht bei Webszenen.

Definieren der Webkarte oder Webszene beim ersten Laden des Widgets "Karte"

Wenn das Widget "Karte" mehrere Webkarten oder Webszenen enthält, können Sie festlegen, welche Karte oder Szene beim Laden der App aktiv ist. Verwenden Sie dazu active_datasource_id gefolgt von der Datenquellen-ID des gewünschten Elements. Nachfolgend finden Sie einige Beispiele:

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=active_datasource_id:<dataSourceId>

https://experience.arcgis.com/experience/<AppId>#map_1=active_datasource_id:dataSource_4

Zentrieren einer Karte

Um eine Karte an einer bestimmten Position zu zentrieren, verwenden Sie center gefolgt von den gewünschten Koordinaten und der Well-known ID (WKID) des gewünschten Koordinatensystems. Nachfolgend finden Sie einige Beispiele:

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=center:<x,y,wkid>

https://experience.arcgis.com/experience/<AppId>#map_1=center:-10373125.398783844%2C4598516.55871741%2C102100

Definieren des Kartenmaßstabs

Um den Kartenmaßstab zu definieren, verwenden Sie den Parameter scale gefolgt von einem Maßstabswert. Nachfolgend finden Sie einige Beispiele:

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=scale:<scaleValue>

https://experience.arcgis.com/experience/<AppId>#map_1=scale:19257701.0800833

Definieren der Kartenrotation

Verwenden Sie zum Definieren der Kartenrotation den Parameter "rotation" gefolgt von einer Gradangabe. Nachfolgend finden Sie einige Beispiele:

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=rotation:<rotationValue>

https://experience.arcgis.com/experience/<AppId>#map_1=rotation:45

Definieren des Betrachtungspunktes der Karte

Ein Betrachtungspunkt stellt die (Kamera-)Position dar, aus der die Karte oder Szene betrachtet wird. Verwenden Sie zum Definieren des Betrachtungspunktes viewpoint. Wenn das Widget "Karte" mehrere Webkarten oder Webszenen enthält, bezieht sich der Parameter "viewpoint" auf alle Elemente.

Ein Betrachtungspunkt und dessen Eigenschaften werden in der Regel im JSON-Format angegeben, wie im folgenden Beispiel:

 {
  "rotation": 0,
  "scale": 19966005.903731048,
  "targetGeometry": {
    "spatialReference": {
      "latestWkid": 3857,
      "wkid": 102100
    },
    "x": -9870655.016044471,
    "y": 4724533.527708739
  }
}

Um einen bestimmten Betrachtungspunkt über die URL anzugeben, müssen Sie alle Eigenschaften, die normalerweise im JSON-Format angegeben sind, in der URL codieren. Beispiel:

https://experience.arcgis.com/experience/<AppId>#map_1=viewpoint:%7B"rotation"%3A0%2C"scale"%3A24387741.012671936%2C"targetGeometry"%3A%7B"spatialReference"%3A%7B"latestWkid"%3A3857%2C"wkid"%3A102100%7D%2C"x"%3A-10078461.002935613%2C"y"%3A4523117.553838721%7D%7D

Hinweis:

Die Parameter center, scale und rotation haben Vorrang vor dem Parameter "viewpoint", weswegen er überschrieben wird, wenn mehrere webkartenbezogene Parameter verwendet werden.

Hinweis:

Änderungen der Kartenausdehnung, die durch Meldungsaktionen ausgelöst werden, haben Vorrang vor Ausdehnungsänderungen, die durch URL-Parameter veranlasst werden. Beispiel:‎‎ Wenn Sie das Widget "Karte" mit den oben aufgeführten URL-Parametern auf eine vordefinierte Ausdehnung öffnen möchten, das Widget "Karte" jedoch auch als Ziel für den Trigger Änderungen der Datensatzauswahl sowie die Meldungsaktion Schwenken auf oder Zoomen auf konfiguriert ist, wird die in den URL-Parametern festgelegte Ausdehnung durch die mit den Meldungsaktionen verknüpfte Ausdehnung überschrieben.

Definieren der Sichtbarkeit für Karten-Layer

Um die Layer-Sichtbarkeit für Karten-Layer zu definieren, verwenden Sie layer_visibility.

Die Layer-Sichtbarkeit wird in der Regel im JSON-Format angegeben, wie im folgenden Beispiel:

 {
  "widget_1-dataSource_1": {
    "widget_1-dataSource_1-187938b7328-layer-2": false
  },
  "widget_1-dataSource_4": {
    "widget_1-dataSource_4-18a690b433a-layer-4": false
  }
}

Um Layer in der Karte über die URL als sichtbar oder ausgeblendet festzulegen, müssen Sie alle Informationen, die in der URL auf den Parameter layer_visibility folgen, codieren. Beispiel:

https://experience.arcgis.com/experience/<AppId>#map_1=layer_visibility:%7B%22widget_1-dataSource_1%22%3A%7B%22widget_1-dataSource_1-187938b7328-layer-2%22%3Afalse%7D%2C%22widget_1-dataSource_4%22%3A%7B%22widget_1-dataSource_4-18a690b433a-layer-4%22%3Afalse%7D%7D

Auf ein selektiertes Feature zoomen

Der Parameter data_s wird bei der Auswahl eines Features in der URL der App angezeigt. Aktuell können Sie den Parameter zoom_to_selection=true verwenden, um nach ObjectID auf ein einzelnes ausgewähltes Feature auf der Karte zu zoomen. Nachfolgend finden Sie einige Beispiele:

https://experience.arcgis.com/experience/<AppId>/#data_s=id:<data source ID>:<OBJECTID>&zoom_to_selection=true

https://experience.arcgis.com/experience/<AppId>/#data_s=id%3AdataSource_1-csv_905%3A77&zoom_to_selection=true