Externe feature-diensten in Fabric Maps

Fabric Maps kunnen verbinding maken met externe featureservices en hun vectorgegevens als maplagen weergeven. Een externe feature-service levert geografische features, zoals punten, lijnen en polygonen, samen met attributen die deze features beschrijven.

Important

Deze functie is beschikbaar als preview-versie.

Door verbinding te maken met een externe feature-service kun je op afstand gehoste ruimtelijke data visualiseren zonder deze eerst naar een lakehouse of eventhouse te hoeven kopiëren. Fabric Maps zoekt de service op, haalt de geselecteerde kenmerken en attributen op en rendert de resultaten als een vectordatalaag.

Fabric Maps ondersteunt de volgende externe feature service-protocollen:

  • Web Feature Service (WFS)
  • OGC API - Features
  • Esri Feature Service

Je krijgt toegang tot deze protocollen via het verbindingstype Geospatial Web Services , samen met WMS en WMTS. Maak de cloudverbinding aan in Verbindingen en gateways beheren, en voeg vervolgens de verbinding toe aan een kaart vanuit het tabblad Externe bronnen in de Verkenner van de kaart.

Opmerking

Integratie van externe feature-diensten is alleen-lezen. Fabric Maps bewerkt, importeert of schrijft geen gegevens terug naar de externe dienst.

Wat is een externe feature-dienst?

Een externe feature-service is een webgebaseerde geospatiale API die individuele geografische kenmerken publiceert. Elke functie bevat:

  • Geometrie, die de locatie en vorm van het kenmerk definieert als een punt, lijn of veelhoek.
  • Attributen, die informatie over de functie geven, zoals een naam, categorie, status, meting of datum.

Een feature-dienst kan bijvoorbeeld voertuiglocaties publiceren als punten, wegen als lijnen, of administratieve grenzen als polygonen. Fabric Maps gebruikt de geometrie om elk kenmerk te tekenen en maakt geselecteerde attributen beschikbaar voor styling, filtering, labels, legendes en tooltips.

De dienst en zijn gegevens blijven buiten het kaartitem. De kaart slaat een referentie op naar de verbinding en de configuratie die nodig is om de gegevens op te halen en weer te geven.

Ondersteunde feature-serviceprotocollen

De volgende tabel vat samen hoe Fabric Maps werkt met elk ondersteund protocol.

Protocol Beschrijving Servicegedrag gebruikt door Fabric Maps
WFS Een Open Geospatial Consortium (OGC) standaard voor het terugvinden van geografische kenmerken. Fabric Maps ondersteunt WFS-versies 1.0.0, 1.1.0 en 2.0.0. Fabric Maps leest de servicemogelijkheden, gebruikt de nieuwste ondersteunde versie die door de dienst wordt geadverteerd, ontdekt beschikbare featuretypes en haalt GeoJSON-antwoorden op.
OGC API - Features Een REST-georiënteerde OGC-standaard voor het benaderen van geografische kenmerken georganiseerd in collecties. Fabric Maps ontdekt collecties en gebruikt de conformiteitsinformatie van de dienst om beschikbare querymogelijkheden te bepalen.
Esri Feature Service Een ArcGIS REST-service die doorzoekbare featurelagen publiceert. Fabric Maps leest service- en laagmetadata en haalt lagen op die GeoJSON-output ondersteunen.

Hoe externe feature-diensten werken in Fabric Maps

Wanneer je een externe feature-service aan een kaart toevoegt, Fabric Maps:

  1. Gebruikt een bestaande verbinding of maakt een verbinding met het externe eindpunt.
  2. Ontdekt de featurelagen of collecties die door de dienst zijn gepubliceerd.
  3. Leet beschikbare metadata, waaronder geometrietypen, velden, recordlimieten en ondersteunde querymogelijkheden.
  4. Hiermee kun je een server-side query configureren en de velden selecteren die opgehaald moeten worden.
  5. Vraagt om de matchingfuncties, inclusief extra resultaatpagina's wanneer ondersteund en vereist.
  6. Rendert de teruggegeven features als een vectordatalaag.

De standaardvisualisatie is gebaseerd op de geometrie die door de service wordt teruggegeven:

Geometry Standaardvisualisatie
Point Bellenlaag
Lijn Lijnlaag
Polygon Polygoonlaag

Nadat de laag is toegevoegd, kun je ondersteunende vectorlaagopties configureren zoals styling, labels, legendes, tooltips, zichtbaarheid en kaartlaagfilters. Voor meer informatie, zie Een kaart aanpassen en datafiltering in Fabric Maps.

Voor een WFS- of OGC API - Features-response met gemengde geometrie maakt Fabric Maps één datalaag. Het gerapporteerde geometrietype van de laag is Onbekend omdat er geen enkel type het beschrijft. Puntkenmerken gebruiken een Bubbellaag, lijnkenmerken gebruiken een Lijnlaag, en polygonkenmerken gebruiken een Polygonlaag zonder extrusie. Als je data-driven styling inschakelt, toont Fabric Maps de legendes voor de geometrietypen in het datalaagpaneel. Clustering is niet beschikbaar voor gemengde geometrie-lagen.

Lagen van externe featureservices ondersteunen datagestuurde styling op basis van categorieën en waardebereiken.

Detectie van lagen en verzamelingen

Fabric Maps geeft in aanmerking komende featurelagen of collecties weer onder de verbinding in het gedeelte Externe bronnen van de Explorer. De beschikbare hiërarchie hangt af van het protocol en de metadata die door de dienst worden blootgesteld.

Het verversen van de verbinding haalt de nieuwste servicemetadata op, inclusief nieuw toegevoegde velden, lagen of collecties. Deze wijzigingen verschijnen mogelijk niet automatisch. Om een nieuw toegevoegd veld te gebruiken, verver je de verbinding en voeg je vervolgens de bronlaag opnieuw toe en selecteer je het veld.

De metadata die door de dienst wordt teruggegeven, kunnen onder meer zijn:

  • Weergavenamen en identificaties
  • Geometrietypen
  • Attribuutvelden en datatypen
  • Ruimtelijke omvang
  • Maximale recordaantallen
  • Ondersteunde filter-, sorteer-, paging- en temporele mogelijkheden

De beschikbare configuratieopties kunnen variëren tussen services omdat Fabric Maps de mogelijkheden gebruikt die door elk eindpunt worden aangekondigd.

Bronzoekopdrachten

Voordat je een featurelaag aan een map toevoegt, kun je een bronquery instellen die het aantal records en velden dat van de externe service wordt opgehaald beperkt. Het verwerken van een query op de server kan de hoeveelheid data die naar Fabric Maps wordt overgedragen verminderen en de laag richten op de functies die relevant zijn voor jouw situatie.

De velden en operatoren die beschikbaar zijn in een bronquery zijn afhankelijk van het geselecteerde protocol en de door de service geadverteerde mogelijkheden. Bronqueries ondersteunen outputveldselectie en kunnen temporele filtering ondersteunen. Fabric Maps interpreteert datum/tijdwaarden als UTC in RFC 3339-formaat.

Fabric Maps valideert de query tegen de geselecteerde service. Als een veld, waarde of operator niet wordt ondersteund, toont de configuratie-ervaring een foutmelding die je kunt gebruiken om de query te herzien.

Je kunt niet terug naar de source-query UI om de query te bewerken nadat je de laag hebt toegevoegd. Om verschillende bron-queryvoorwaarden te gebruiken, voeg je de bronlaag opnieuw toe en configureer je een nieuwe query.

Fabric Maps leidt automatisch een begrenzingsbox af uit het kaartvenster wanneer het functies aanvraagt. Het begrenzingsvak is niet zichtbaar of instelbaar in de gebruikersinterface voor source-query. Gebruikers kunnen geen coördinaten invoeren of een gebied selecteren als ruimtelijke queryconditie.

Bronquery's en kaartlaagfilters

Bronqueries en map-layer filters beperken data op verschillende stadia:

Gedrag Bronzoekopdracht Kaartlaagfilter
Waar het wordt geëvalueerd Via de externe functieservice Door de Fabric Maps-laagervaring
Wat het bestuurt De records en velden die van de dienst zijn opgehaald Welke teruggevonden kenmerken worden op de kaart weergegeven
Beschikbare voorwaarden Het hangt af van het protocol en de servicemogelijkheden Het hangt af van het veldtype en de filterondersteuning van Fabric Maps
Hoe veranderingen worden toegepast Configureer de query bij het toevoegen van de feature-laag Pas het filter toe vanuit de laagfilterervaring

Gebruik een bronquery om het aantal data dat van de externe service wordt opgevraagd te verminderen. Gebruik een map-layer filter wanneer mapbuilders of kijkers de teruggegeven data interactief moeten verfijnen. Voor meer informatie over map-layer filters, zie Data filtering in Fabric Maps.

Externe feature-servicelagen ondersteunen categorische, numerieke bereik-, Booleaanse en datum/tijd-kaartlaagfilters. Meerdere filters gebruiken AND logica. Vergrendelde filters, bewerkings- en weergavemodusgedrag en filterpersistentie werken hetzelfde over de lagen WFS, OGC API - Features en Esri Feature Service.

Paginatiek- en resultaatlimieten

Feature-diensten kunnen beperken hoeveel records ze in één enkele reactie teruggeven. Fabric Maps gebruikt automatisch de door de service aangekondigde pagingconfiguratie om volgende resultaten op te halen. Paging is transparant en builders kunnen geen paginagrootte of paginggedrag configureren.

Fabric Maps rendert tot 100.000 features per laag. Als een bronquery meer functies oplevert, rendert Fabric Maps de eerste 100.000 en toont een waarschuwing in het Laaginstellingenpaneel. Verfijn de bronquery om de resultatenset te verkleinen.

Als een paginaverzoek mislukt, probeert Fabric het tot drie keer opnieuw. Als het verzoek nog steeds faalt, toont Fabric Maps het bericht Een verzoek mislukt; sommige functies ontbreken. Ververs om het opnieuw te proberen.

Opgeslagen configuratie

Wanneer je een map opslaat, behoudt Fabric Maps de externe laagconfiguratie, waaronder:

  • Verbindingsverwijzing
  • Geselecteerde laag of verzameling
  • Bronzoekopdracht
  • Geselecteerde uitvoervelden
  • Opmaak van laag en legende
  • Zichtbaarheid
  • Laagvolgorde

Wanneer je de map opnieuw opent, gebruikt Fabric Maps de opgeslagen configuratie om de laag op te halen en te renderen.

Gedupliceerde lagen verwijzen naar dezelfde gegevensbron, verbinding, bronquery en geselecteerde uitvoervelden. Kaartlaagfilters en visuele instellingen zijn onafhankelijk voor elke duplicaat. Je kunt de bronquery- of outputvelden niet bewerken nadat je de laag in deze release hebt toegevoegd.

Ververs externe feature-diensten

Fabric Maps biedt twee verversingsacties in de bewerkingsmodus:

  • Ververs een verbinding in Externe bronnen om de nieuwste servicemetadata op te halen, inclusief nieuw toegevoegde velden, lagen of collecties. Om een nieuw toegevoegd veld te gebruiken, voeg je de bronlaag opnieuw toe en selecteer je het veld.
  • Ververs het kaartitem om de opgeslagen lagen te bevragen voor actuele gegevens. Deze actie verandert de opgeslagen bron-query niet.

Kijkers kunnen in deze release geen externe feature-servicegegevens verversen. Opgeslagen uitvoervelden, styling, legendes, zichtbaarheid en laagvolgorde blijven na een verversing aanwezig.

Verificatie en toegang

Externe feature-diensten kunnen naast de benodigde machtigingen ook aanmeldingsgegevens vereisen om een Fabric-kaart te openen of te bewerken.

Verificatiemethode WFS OGC API - Features Esri Feature Service
Anoniem Supported Supported Supported
Basic authentication Supported Supported Niet ondersteund
API-sleutel Supported Supported Supported
OAuth 2.0 / Microsoft Entra ID Niet ondersteund Niet ondersteund Niet ondersteund

Voor Esri Feature Service API-sleutelauthenticatie gebruik token je als naam van de API-sleutelparameter.

Fabric slaat inloggegevens op in de cloudverbinding. Kijkers hebben de verbinding die ze apart delen niet nodig om de externe data weer te geven. Als Fabric Maps geen geldige verbindingsgegevens kan ophalen of de service kan bereiken, geeft het een foutmelding aan dat de service niet bereikbaar is.

Externe feature-diensten en beeldservices

Externe feature-diensten geven vectorgeometrieën en attributen terug. WMS- en WMTS-diensten geven weergegeven rasterafbeeldingen of tegels terug. Kies het brontype dat past bij de data en interacties die je kaart vereist.

Externe feature-diensten WMS- en WMTS-beelddiensten
Geef individuele vectorkenmerken en attributen terug Geef gerenderde afbeeldingen of afbeeldingstegels terug
Ondersteuning voor object- en attribuutquery's Afbeeldingen voor een aangevraagd gebied weergeven
Ondersteuning van vectorstyling, labels, tooltips en datagedreven interacties Ondersteun beeldzichtbaarheid, orde en ondoorzichtigheid
Geef punten, lijnen en veelhoeken weer Rasterafbeeldingen weergeven

Voor informatie over externe beelden, zie Lagen maken met WMS- en WMTS-beeldbronnen in Fabric Maps.

Protocolspecifieke overwegingen

WFS

  • Ontdek beschikbare lagen vanuit de servicemogelijkheden.
  • Gebruik WFS versie 1.0.0, 1.1.0 of 2.0.0.
  • Wanneer de dienst meerdere ondersteunde versies adverteert, gebruikt Fabric Maps de nieuwste versie.
  • De WFS-dienst moet GeoJSON-antwoorden ondersteunen.
  • Ondersteun resultaten met gemengde geometrie in één laag.

OGC API - Features

  • Organiseer beschikbare data in collecties.
  • Geavanceerde attribuut- en temporele operaties zijn afhankelijk van de conformiteitsklassen die door de dienst worden geadverteerd.
  • Ondersteun resultaten met gemengde geometrieën in één laag.
  • Fabric Maps gebruikt alleen mogelijkheden die door het geselecteerde eindpunt worden ondersteund.

Esri Feature Service

  • De geselecteerde laag moet GeoJSON-uitvoer ondersteunen.
  • Ondersteun geen antwoorden met gemengde geometrie.
  • Fabric Maps accepteert geometrie met M- of Z-coördinatenwaarden en negeert de extra dimensies.

Beperkingen en overwegingen

  • Integratie van externe feature-diensten is alleen-lezen. Invoeren, feature editing en writeback worden niet ondersteund.
  • Queryfuncties zijn afhankelijk van de mogelijkheden die door de externe dienst worden geadverteerd.
  • Fabric Maps vraagt functies aan in EPSG:4326, met coördinaten in lengte- en breedtegradenvolgorde. Diensten die data publiceren in een ander coördinatenreferentiesysteem worden ondersteund als de service de data kan herprojecteren naar EPSG:4326. Als de service de data niet kan herprojecteren, bijvoorbeeld wanneer het coördinatensysteem van de laag een EPSG-autoriteitscode mist, laadt de laag niet.
  • Begrenzingskaders die de antimeridiaan kruisen, worden niet ondersteund.
  • Objecten waarvan de geometrie een geometrieverzameling is, worden niet weergegeven. Andere ondersteunde functies in dezelfde laag worden normaal weergegeven.
  • Clustering is niet beschikbaar voor gemengde geometrie-lagen.
  • WFS- en Esri Feature Service-lagen moeten GeoJSON-uitvoer ondersteunen.
  • GML-responsformaten worden niet ondersteund in deze release.
  • Fabric Maps negeert M- en Z-dimensies in de geometrie van Esri Feature Service.
  • Een laag kan tot 100.000 features renderen.
  • Een kaartitem kan tot 100 externe verbindingen verwijzen via WMS, WMTS, WFS, OGC API - Features, en Esri Feature Service.
  • Alleen diensten die via het openbare internet bereikbaar zijn, worden ondersteund. Privé-endpoints, on-premises datagateways, virtuele netwerkdatagateways en andere beheerde privénetwerkopties worden niet ondersteund.
  • Beschikbaarheid en responstijd van de aanvraag hangen af van de externe dienst en de netwerkverbinding.

Volgende stappen 

Voor stylingopties, zie Map aanpassen.