Externe Feature-Dienste in Fabric Maps

Fabric Maps können sich mit externen Feature-Diensten verbinden und deren Vektordaten als Kartenebenen darstellen. Ein externer Merkmalsdienst stellt geografische Merkmale bereit, wie Punkte, Linien und Polygone, zusammen mit Attributen, die diese Merkmale beschreiben.

Indem Sie sich mit einem externen Feature-Service verbinden, können Sie remote gehostete räumliche Daten visualisieren, ohne sie vorher in ein Seehaus oder Eventhouse zu kopieren. Fabric Maps fragt den Service ab, ruft die ausgewählten Features und Attribute ab und stellt die Ergebnisse als Vektordatenschicht dar.

Fabric Maps unterstützt die folgenden externen Feature-Service-Protokolle:

• Web-Feature-Dienst (WFS)
• OGC API – Funktionen
• Esri Feature Service

Sie greifen auf diese Protokolle über den Verbindungstyp Geospatial Web Services sowie über WMS und WMTS zu. Erstelle die Cloud-Verbindung in 'Verbindungen und Gateways verwalten' und füge die Verbindung dann über den Reiter 'Externe Quellen ' im Explorer der Karte zu einer Karte hinzu.

Was ist ein externer Feature-Service?

Ein externer Feature-Service ist eine webbasierte geospatiale API, die einzelne geografische Merkmale veröffentlicht. Jede Funktion enthält:

• Geometrie, die die Lage und Form des Merkmals als Punkt, Linie oder Polygon definiert.
• Attribute, die Informationen über das Merkmal liefern, wie Name, Kategorie, Status, Maß oder Datum.

Zum Beispiel könnte ein Feature-Dienst Fahrzeugstandorte als Punkte, Straßen als Linien oder Verwaltungsgrenzen als Polygone veröffentlichen. Fabric Maps nutzt die Geometrie, um jedes Merkmal zu zeichnen, und stellt ausgewählte Attribute für Styling, Filterung, Beschriftungen, Legenden und Tooltips zur Verfügung.

Der Dienst und seine Daten bleiben außerhalb des Kartenelements. Die Karte speichert eine Referenz auf die Verbindung und die Konfiguration, die zum Abrufen und Anzeigen der Daten erforderlich ist.

Unterstützte Feature-Service-Protokolle

Die folgende Tabelle fasst zusammen, wie Fabric Maps mit jedem unterstützten Protokoll funktioniert.

Wie externe Feature-Dienste in Fabric Maps funktionieren

Wenn Sie einen externen Feature-Service zu einer Karte hinzufügen, Fabric Maps:

1. Verwendet eine bestehende Verbindung oder stellt eine Verbindung zum entfernten Endpunkt her.
2. Ermittelt die vom Dienst veröffentlichten Feature-Layer oder Sammlungen.
3. Liest verfügbare Metadaten, einschließlich Geometrietypen, Felder, Datensatzgrenzen und unterstützter Abfragefunktionen.
4. Ermöglicht es, eine serverseitige Abfrage zu konfigurieren und die zu abrufenden Felder auszuwählen.
5. Fordert die Abgleichsfunktionen an, einschließlich zusätzlicher Ergebnisseiten, wenn sie unterstützt und erforderlich sind.
6. Rendert die zurückgegebenen Features als Vektordatenschicht.

Die Standardvisualisierung basiert auf der vom Service zurückgegebenen Geometrie:

Nachdem die Ebene hinzugefügt wurde, können Sie unterstützte Vektorebenenoptionen wie Styling, Beschriftungen, Legenden, Tooltips, Sichtbarkeit und Kartenschichtfilter konfigurieren. Weitere Informationen finden Sie unter Karte anpassen und Datenfilterung in Fabric Maps.

Für eine WFS- oder OGC-API mit einer Antwort mit gemischten Geometrien erstellt Fabric Maps eine Datenebene. Der angegebene Geometrietyp der Schicht ist Unbekannt , da kein einzelner Typ ihn beschreibt. Punktmerkmale verwenden eine Blasenschicht, Linienmerkmale eine Linienschicht und Polygonmerkmale eine Polygonschicht ohne Extrusion. Wenn du datengetriebenes Design aktivierst, zeigt Fabric Maps die Legenden für die Geometrietypen im Datenschichtfenster an. Clustering ist für gemischte Geometrie-Schichten nicht verfügbar.

Externe Feature-Service-Schichten unterstützen datengetriebenes Styling mit Kategorien und Wertbereichen.

Schicht- und Sammlungsentdeckung

Fabric Maps listet berechtigte Merkmalschichten oder Sammlungen unter dem Link im Bereich Externe Quellen des Explorers auf. Die verfügbare Hierarchie hängt vom Protokoll und den vom Dienst bereitgestellten Metadaten ab.

Das Aktualisieren der Verbindung ruft die neuesten Service-Metadaten ab, einschließlich neu hinzugefügter Felder, Ebenen oder Sammlungen. Diese Änderungen erscheinen möglicherweise nicht automatisch. Um ein neu hinzugefügtes Feld zu verwenden, aktualisieren Sie die Verbindung und fügen Sie dann die Quellschicht erneut hinzu und wählen Sie das Feld aus.

Die vom Dienst zurückgegebenen Metadaten können Folgendes umfassen:

• Anzeigenamen und Kennungen
• Geometrietypen
• Attributfelder und Datentypen
• Räumliche Ausdehnungen
• Maximale Anzahl von Datensätzen
• Unterstützte Filter-, Sortier-, Paging- und temporale Funktionen

Die verfügbaren Konfigurationsoptionen können je nach Dienst variieren, da Fabric Maps die von jedem Endpunkt angekündigten Funktionen nutzt.

Quellanfragen

Bevor man eine Feature-Ebene zu einer Karte hinzufügt, kann man eine Quellanfrage konfigurieren, die die vom entfernten Dienst abgerufenen Datensätze und Felder begrenzt. Die Verarbeitung einer Abfrage auf dem Server kann die Menge an auf Fabric Maps übertragenen Daten reduzieren und die Ebene auf die für dein Szenario relevanten Features fokussieren.

Die in einer Quellanfrage verfügbaren Felder und Operatoren hängen vom ausgewählten Protokoll und den vom Dienst beworbenen Funktionen ab. Quellanfragen unterstützen die Auswahl des Ausgangsfeldes und können zeitliche Filterung unterstützen. Fabric Maps interpretiert Datums-/Uhrzeitwerte als UTC im RFC-3339-Format.

Fabric Maps validiert die Abfrage gegen den ausgewählten Service. Wenn ein Feld, Wert oder Operator nicht unterstützt wird, zeigt die Konfigurationserfahrung einen Fehler an, den du zur Überarbeitung der Abfrage verwenden kannst.

Du kannst nach dem Hinzufügen der Schicht nicht zur Quell-Abfrage-UI zurückkehren, um die Abfrage zu bearbeiten. Um verschiedene Quell-Abfragebedingungen zu verwenden, fügen Sie die Quellschicht erneut hinzu und konfigurieren Sie eine neue Abfrage.

Fabric Maps leitet automatisch eine Begrenzungsbox aus dem Map-Viewport ab, wenn es Features anfordert. Der Begrenzungsrahmen ist in der Benutzeroberfläche der Quellabfrage weder sichtbar noch konfigurierbar. Benutzer können keine Koordinaten eingeben oder einen Bereich als räumliche Abfragebedingung auswählen.

Quellanfragen und Map-Layer-Filter

Quellanfragen und Map-Layer-Filter begrenzen Daten in verschiedenen Phasen:

Verwenden Sie eine Quellanfrage, um die vom entfernten Dienst angeforderten Daten zu reduzieren. Verwenden Sie einen Kartenschichtfilter, wenn Kartenbauer oder Betrachter die zurückgegebenen Daten interaktiv verfeinern müssen. Weitere Informationen zu Map-Layer-Filtern finden Sie unter Datenfilterung in Fabric Maps.

Externe Feature-Service-Schichten unterstützen kategorische, numerische Bereichs-, Boolean- und Datum/Uhrzeit-Kartenschichtfilter. Mehrere Filter verwenden AND Logik. Gesperrte Filter, Bearbeitungs- und Ansichtsmodus-Verhalten sowie Filterpersistenz funktionieren gleich auf den Ebenen WFS, OGC API - Features und Esri Feature Service.

Paginierung und Ergebnisgrenzen

Feature-Dienste können begrenzen, wie viele Datensätze sie in einer einzigen Antwort zurückgeben. Fabric Maps verwendet automatisch die vom Dienst bereitgestellte Pagingkonfiguration, um nachfolgende Ergebnisse abzurufen. Paging ist transparent, und Builder können keine Seitengröße oder Paging-Verhalten konfigurieren.

Fabric Maps rendert bis zu 100.000 Merkmale pro Schicht. Wenn eine Quellanfrage mehr Features zurückliefert, rendert Fabric Maps die ersten 100.000 und zeigt eine Warnung im Layer Settings an. Verfeinere die Quellanfrage, um die Ergebnismenge zu reduzieren.

Wenn eine Seitenanfrage fehlschlägt, versucht Fabric sie bis zu dreimal. Wenn die Anfrage weiterhin fehlschlägt, zeigt Fabric Maps die Nachricht an: Eine Anfrage fehlgeschlagen; einige Funktionen fehlen. Aktualisieren, um es erneut zu versuchen.

Gespeicherte Konfiguration

Wenn du eine Karte speicherst, bewahrt Fabric Maps die externe Ebenenkonfiguration, einschließlich:

• Verbindungsreferenz
• Ausgewählte Merkmalschicht oder -sammlung
• Quellanfrage
• Ausgewählte Ausgabefelder
• Schichtgestaltung und Legende
• Sichtbarkeit
• Reihenfolge der Schichten

Wenn du die Karte wieder öffnest, verwendet Fabric Maps die gespeicherte Konfiguration, um die Ebene abzurufen und zu rendern.

Duplizierte Schichten beziehen sich auf dieselben Datenquellen, Verbindung, Quellanfrage und ausgewählte Ausgabefelder. Map-Layer-Filter und visuelle Einstellungen sind für jedes Duplikat unabhängig. Du kannst die Quellanfrage oder die Ausgabefelder nach dem Hinzufügen der Ebene in dieser Version nicht mehr bearbeiten.

Externe Feature-Dienste aktualisieren

Fabric Maps bietet im Bearbeitungsmodus zwei Aktualisierungsaktionen an:

• Aktualisieren Sie eine Verbindung in externen Quellen , um die neuesten Service-Metadaten abzurufen, einschließlich neu hinzugefügter Felder, Ebenen oder Sammlungen. Um ein neu hinzugefügtes Feld zu verwenden, füge die Quellebene erneut hinzu und wähle das Feld aus.
• Aktualisieren Sie das Kartenelement, um die gespeicherten Ebenen nach aktuellen Daten abzufragen. Diese Aktion ändert nicht die Abfrage der gespeicherten Quelle.

Betrachter können in dieser Version keine externen Feature-Service-Daten aktualisieren. Gespeicherte Ausgabefelder, Styling, Legenden, Sichtbarkeit und Schichtreihenfolge bleiben nach einer Aktualisierung erhalten.

Authentifizierung und Zugriff

Externe Feature-Services können zusätzlich zu den Berechtigungen, die zum Öffnen oder Bearbeiten einer Fabric-Karte erforderlich sind, Anmeldeinformationen erfordern.

Für die API-Schlüsselauthentifizierung für den Esri Feature Service verwenden Sie token als Namen des API-Schlüsselparameters.

Fabric speichert Zugangsdaten in der Cloud-Verbindung. Betrachter benötigen die separat geteilte Verbindung nicht, um die externen Daten darzustellen. Wenn Fabric Maps keine gültigen Verbindungsdaten abrufen oder den Dienst erreichen kann, zeigt es einen Fehler an, der anzeigt, dass der Dienst nicht erreichbar war.

Externe Feature-Services und Bilddaten-Services

Externe Feature-Dienste geben Vektorgeometrien und -attribute zurück. WMS- und WMTS-Dienste liefern gerenderte Rasterbilder oder Kacheln zurück. Wählen Sie den Quelltyp, der zu den Daten und Interaktionen passt, die Ihre Karte verlangt.

Informationen zu externen Bildern finden Sie unter Erstellen von Schichten mit WMS- und WMTS-Bildquellen in Fabric Maps.

Protokollspezifische Überlegungen

WFS

• Entdecken Sie verfügbare Schichten aus den Service-Funktionen.
• Verwenden Sie WFS Version 1.0.0, 1.1.0 oder 2.0.0.
• Wenn der Dienst mehrere unterstützte Versionen bewirbt, verwendet Fabric Maps die neueste Version.
• Der WFS-Dienst muss GeoJSON-Antworten unterstützen.
• Unterstützt gemischte Geometrie-Antworten in einer Schicht.

OGC API – Funktionen

• Organisieren Sie verfügbare Daten in Sammlungen.
• Fortgeschrittene Attribut- und zeitliche Operationen hängen von den vom Dienst beworbenen Konformitätsklassen ab.
• Unterstützt gemischte Geometrie-Antworten in einer Schicht.
• Fabric Maps verwendet nur Fähigkeiten, die vom ausgewählten Endpunkt unterstützt werden.

Esri Feature Service

• Die ausgewählte Schicht muss GeoJSON-Ausgabe unterstützen.
• Ich unterstütze keine gemischten Geometrie-Antworten.
• Fabric Maps akzeptiert Geometrie mit M- oder Z-Koordinatenwerten und ignoriert die zusätzlichen Dimensionen.

Einschränkungen und Überlegungen

• Die Integration externer Feature-Services erfolgt schreibgeschützt. Eingabe, Feature Editing und Writeback werden nicht unterstützt.
• Abfragefunktionen hängen von den vom entfernten Dienst beworbenen Fähigkeiten ab.
• Fabric Maps fordert Funktionen in EPSG:4326 an, mit Koordinaten in Längen- und Breitengradreihenfolge. Dienste, die Daten in einem anderen Koordinatenreferenzsystem veröffentlichen, werden unterstützt, wenn der Dienst die Daten auf EPSG:4326 reprojizieren kann. Wenn der Dienst die Daten nicht reprojizieren kann, beispielsweise wenn dem Koordinatensystem des Layers ein EPSG-Autoritätscode fehlt, kann der Layer nicht geladen werden.
• Begrenzungsboxen, die den Antimeridian kreuzen, werden nicht unterstützt.
• Merkmale, deren Geometrie eine Geometriesammlung ist, werden nicht gerendert. Andere unterstützte Funktionen in derselben Ebene werden normal dargestellt.
• Clustering ist für gemischte Geometrie-Schichten nicht verfügbar.
• WFS- und Esri-Feature-Service-Schichten müssen GeoJSON-Ausgaben unterstützen.
• GML-Antwortformate werden in dieser Version nicht unterstützt.
• Fabric Maps ignoriert die M- und Z-Dimensionen in der Esri Feature Service-Geometrie.
• Eine Ebene kann bis zu 100.000 Features rendern.
• Ein Kartenelement kann bis zu 100 externe Verbindungen über WMS, WMTS, WFS, OGC API - Features und Esri Feature Service referenzieren.
• Es werden nur Dienste unterstützt, die über das öffentliche Internet erreichbar sind. Private Endpunkte, lokale Datengateways, virtuelle Netzwerk-Datengateways und andere verwaltete private Netzwerkoptionen werden nicht unterstützt.
• Verfügbarkeit und Anfrage-Antwortzeit hängen vom entfernten Dienst und der Netzwerkverbindung ab.

Nächste Schritte

Für Styling-Optionen siehe Karte anpassen.