Eksterne funksjonstjenester i Fabric Maps

Fabric Maps kan koble seg til eksterne feature-tjenester og gjengi deres vektordata som kartlag. En ekstern funksjonstjeneste tilbyr geografiske egenskaper, som punkter, linjer og polygoner, sammen med attributter som beskriver disse funksjonene.

Ved å koble til en ekstern feature-tjeneste kan du visualisere eksternt hostet romlig data uten først å måtte kopiere det inn i et lakehouse eller eventhouse. Fabric Maps spør tjenesten, henter ut valgte funksjoner og attributter, og gjengir resultatene som et vektordatalag.

Fabric Maps støtter følgende eksterne funksjonstjenesteprotokoller:

• Webfunksjonstjeneste (WFS)
• OGC API - Funksjoner
• Esri funksjonstjeneste

Du får tilgang til disse protokollene via tilkoblingstypen Geospatial Web Services , sammen med WMS og WMTS. Lag skyforbindelsen i Administrer tilkoblinger og gatewayer, og legg deretter tilkoblingen til et kart fra fanen Eksterne kilder i kartets Utforsker.

Hva er en ekstern funksjonstjeneste?

En ekstern funksjonstjeneste er et nettbasert geospatielt API som publiserer individuelle geografiske funksjoner. Hver funksjon inneholder:

• Geometri, som definerer funksjonens plassering og form som et punkt, en linje eller en polygon.
• Attributter, som gir informasjon om funksjonen, som navn, kategori, status, måling eller dato.

For eksempel kan en funksjonstjeneste publisere kjøretøyposisjoner som punkter, veier som linjer, eller administrative grenser som polygoner. Fabric Maps bruker geometrien til å tegne hver egenskap og gjør utvalgte attributter tilgjengelige for styling, filtrering, etiketter, legender og verktøytips.

Tjenesten og dens data forblir utenfor kartelementet. Kartet lagrer en referanse til forbindelsen og konfigurasjonen som trengs for å hente og vise dataene.

Støttede funksjonstjenesteprotokoller

Tabellen nedenfor oppsummerer hvordan Fabric Maps fungerer med hver støttet protokoll.

Hvordan eksterne funksjonstjenester fungerer i Fabric Maps

Når du legger til en ekstern funksjonstjeneste på et kart, gjør Fabric Maps:

1. Bruker en eksisterende tilkobling eller oppretter en forbindelse til det eksterne endepunktet.
2. Oppdager funksjonslagene eller samlingene som er publisert av tjenesten.
3. Leser tilgjengelig metadata, inkludert geometrityper, felt, postgrenser og støttede spørringsmuligheter.
4. Lar deg konfigurere en server-side spørring og velge feltene som skal hentes.
5. Ber om matchingsfunksjonene, inkludert ekstra resultatsider når det støttes og kreves.
6. Gjengir de returnerte funksjonene som et vektordatalag.

Standardvisualiseringen er basert på geometrien som returneres av tjenesten:

Etter at laget er lagt til, kan du konfigurere støttede vektorlagsalternativer som styling, etiketter, forklaringer, verktøytips, synlighet og kartlagsfiltre. For mer informasjon, se Tilpass et kart og Datafiltrering i Fabric Maps.

For et WFS- eller OGC-API - Features mixed-geometry response, oppretter Fabric Maps ett datalag. Lagets rapporterte geometritype er ukjent fordi ingen enkelt type beskriver det. Punktfunksjoner bruker et boblelag, linjefunksjoner bruker et linjelag, og polygonfunksjoner bruker et polygonlag uten ekstrudering. Hvis du aktiverer datadrevet styling, viser Fabric Maps legendene for geometritypene i datalagspanelet. Klynging er ikke tilgjengelig for lag med blandet geometri.

Eksterne funksjonstjenestelag støtter kategori- og verdiområdebasert datadrevet styling.

Lag- og samlingsoppdagelse

Fabric Maps lister kvalifiserte funksjonslag eller samlinger under lenken i delen Eksterne kilder i Explorer. Den tilgjengelige hierarkiet avhenger av protokollen og metadataene som tjenesten eksponerer.

Oppdatering av tilkoblingen henter de nyeste tjenestemetadataene, inkludert nylig lagde felt, lag eller samlinger. Disse endringene kan ikke nødvendigvis vises automatisk. For å bruke et nylig lagt felt, oppdater tilkoblingen, og legg deretter kildelaget til igjen og velg feltet.

Metadataene som returneres av tjenesten kan inkludere:

• Visningsnavn og identifikatorer
• Geometrityper
• Attributtfelt og datatyper
• Romlige utstrekninger
• Maksimale antall rekorder
• Støttet filtrering, sortering, paging og temporale funksjoner

De tilgjengelige konfigurasjonsalternativene kan variere mellom tjenester fordi Fabric Maps bruker funksjonene som annonseres av hver endepunkt.

Kildespørringer

Før du legger til et funksjonslag på et kart, kan du konfigurere en kildespørring som begrenser postene og feltene hentet fra den eksterne tjenesten. Å behandle en spørring på serveren kan redusere mengden data som overføres til Fabric Maps og fokusere laget på funksjonene som er relevante for ditt scenario.

Feltene og operatorene som er tilgjengelige i en kildespørring avhenger av den valgte protokollen og hvilke muligheter tjenesten annonserer. Kildeforespørsler støtter valg av utgangsfelt og kan støtte tidsfiltrering. Fabric Maps tolker dato-/tidsverdier som UTC i RFC 3339-format.

Fabric Maps validerer spørringen mot den valgte tjenesten. Hvis et felt, en verdi eller en operator ikke støttes, viser konfigurasjonsopplevelsen en feil som du kan bruke til å revidere spørringen.

Du kan ikke gå tilbake til kilde-spørringsgrensesnittet for å redigere spørringen etter at du har lagt til laget. For å bruke forskjellige kilde-spørringsbetingelser, legg til kildelaget igjen og konfigurer en ny spørring.

Fabric Maps utleder automatisk en avgrensningsboks fra kartvisningen når den ber om funksjoner. Avgrensningsboksen er verken synlig eller konfigurerbar i kildespørringsgrensesnittet. Brukere kan ikke legge inn koordinater eller velge et område som en romlig spørringsbetingelse.

Kildespørringer og kartlagsfiltre

Kildespørringer og kartlagsfiltre begrenser data på ulike stadier:

Bruk en kildespørring for å redusere dataene som etterspørres fra den eksterne tjenesten. Bruk et kartlagsfilter når kartbyggere eller brukere trenger å interaktivt forbedre de returnerte dataene. For mer informasjon om kartlagsfiltre, se Datafiltrering i Fabric Maps.

Eksterne funksjonstjenestelag støtter kategoriske, numeriske rekkevidde-, boolske og dato/tid-kartlagsfiltre. Flere filtre bruker AND logikk. Låste filtre, redigerings- og visningsmodus-oppførsel, samt filterpersistens fungerer på samme måte på tvers av WFS, OGC API - Features og Esri Feature Service-lagene.

Paginering og resultatgrenser

Feature-tjenester kan begrense hvor mange poster de returnerer i ett enkelt svar. Fabric Maps bruker automatisk sidekonfigurasjonen som tjenesten annonserer for å hente påfølgende resultater. Paging er transparent, og byggere kan ikke konfigurere sidestørrelse eller paging-oppførsel.

Fabric Maps gjengir opptil 100 000 funksjoner per lag. Hvis en kildespørring returnerer flere funksjoner, gjengir Fabric Maps de første 100 000 og viser en advarsel i laginnstillingspanelet. Raffiner kildespørringen for å redusere resultatsettet.

Hvis en sideforespørsel mislykkes, prøver Fabric den på opptil tre ganger. Hvis forespørselen fortsatt feiler, viser Fabric Maps meldingen En forespørsel feilet; noen funksjoner mangler. Oppdater for å prøve på nytt.

Lagret konfigurasjon

Når du lagrer et kart, bevarer Fabric Maps den eksterne lagkonfigurasjonen, inkludert:

• Tilkoblingsreferanse
• Valgt funksjonslag eller samling
• Kildespørring
• Utvalgte utdatafelt
• Lag-styling og legende
• Synlighet
• Lagorden

Når du åpner kartet på nytt, bruker Fabric Maps den lagrede konfigurasjonen for å hente og gjengi laget.

Dupliserte lag refererer til samme datakilde, tilkobling, kildespørring og valgte utdatafelt. Kartlagsfiltre og visuelle innstillinger er uavhengige for hver duplikat. Du kan ikke redigere kildespørrings- eller utdatafeltene etter at du har lagt til laget i denne utgivelsen.

Oppdater eksterne funksjonstjenester

Fabric Maps tilbyr to oppdateringshandlinger i redigeringsmodus:

• Oppdater en tilkobling i eksterne kilder for å hente den nyeste tjenestemetadataen, inkludert nylig lagde felt, lag eller samlinger. For å bruke et nylig lagt felt, legg til kildelaget igjen og velg feltet.
• Oppdater kartelementet for å spørre de lagrede lagene etter nåværende data. Denne handlingen endrer ikke spørringen om lagret kilde.

Seerne kan ikke oppdatere eksterne funksjonstjenestedata i denne utgivelsen. Lagrede utdatafelt, styling, legender, synlighet og lagrekkefølge vedvarer etter oppfriskning.

Autentisering og tilgang

Eksterne funksjonstjenester kan kreve legitimasjon i tillegg til tillatelser som trengs for å åpne eller redigere et Fabric-kart.

For autentisering av Esri Feature Service API-nøkkel, bruk token som API-nøkkelparameternavn.

Fabric lagrer legitimasjonen i skytilkoblingen. Viewers trenger ikke tilkoblingen som deles separat for å gjengi eksterne data. Hvis Fabric Maps ikke kan hente gyldige tilkoblingsopplysninger eller nå tjenesten, vises en feilmelding som indikerer at tjenesten ikke kunne nås.

Eksterne funksjonstjenester og bildetjenester

Eksterne funksjonstjenester returnerer vektorgeometrier og attributter. WMS- og WMTS-tjenester returnerer gjengitte rasterbilder eller fliser. Velg kildetypen som matcher dataene og interaksjonene kartet ditt krever.

For informasjon om eksterne bilder, se Lag lag ved bruk av WMS- og WMTS-bildekilder i Fabric Maps.

Protokollspesifikke hensyn

WFS

• Oppdag tilgjengelige lag fra tjenestemulighetene.
• Bruk WFS versjon 1.0.0, 1.1.0 eller 2.0.0.
• Når tjenesten annonserer flere støttede versjoner, bruker Fabric Maps den nyeste versjonen.
• WFS-tjenesten må støtte GeoJSON-svar.
• Støtt blandede geometri-responser i ett lag.

OGC API - Funksjoner

• Organiser tilgjengelige data i samlinger.
• Avanserte attributt- og temporale operasjoner avhenger av konformitetsklassene som er annonsert av tjenesten.
• Støtt blandede geometri-responser i ett lag.
• Fabric Maps bruker kun funksjoner som støttes av det valgte endepunktet.

Esri funksjonstjeneste

• Det valgte laget må støtte GeoJSON-utdata.
• Støtter ikke blandede geometri-svar.
• Fabric Maps aksepterer geometri med M- eller Z-koordinatverdier og ignorerer de ekstra dimensjonene.

Begrensninger og hensyn

• Integrasjon av eksterne funksjonstjenester er skrivebeskyttet. Innlesing, funksjonsredigering og writeback støttes ikke.
• Spørringsfunksjonene avhenger av hvilke muligheter som er annonsert av den eksterne tjenesten.
• Fabric Maps forespør funksjoner i EPSG:4326, med koordinater i lengde- og breddegradsrekkefølge. Tjenester som publiserer data i et annet koordinatreferansesystem støttes hvis tjenesten kan reprojisere dataene til EPSG:4326. Hvis tjenesten ikke kan reprojisere dataene, for eksempel når lagets koordinatsystem mangler en EPSG-autoritetskode, lastes laget ikke inn.
• Avgrensningsbokser som krysser antimeridianen støttes ikke.
• Funksjoner hvis geometri er en geometrisamling blir ikke gjengitt. Andre støttede funksjoner i samme lag gjengir normalt.
• Klynging er ikke tilgjengelig for lag med blandet geometri.
• WFS- og Esri Feature Service-lagene må støtte GeoJSON-utdata.
• GML-responsformater støttes ikke i denne utgivelsen.
• Fabric Maps ignorerer M- og Z-dimensjoner i Esri Feature Service-geometri.
• Et lag kan gjengi opptil 100 000 funksjoner.
• Et kartobjekt kan referere til opptil 100 eksterne tilkoblinger på tvers av WMS, WMTS, WFS, OGC API - Funksjoner og Esri Feature Service.
• Kun tjenester som er tilgjengelige via offentlig internett støttes. Private endepunkter, lokale datagatewayer, virtuelle nettverksdatagatewayer og andre administrerte private nettverksalternativer støttes ikke.
• Tilgjengelighet og svartid på forespørsler avhenger av den eksterne tjenesten og nettverkstilkoblingen.

Neste trinn

For stylingalternativer, se Tilpass kart.