Tilføj et eksternt feature-servicelag til et kort

Denne artikel viser dig, hvordan du forbinder Fabric Maps til en ekstern feature-tjeneste og renderer dens vektordata som et kortlag. Du kan opdage tilgængelige feature-lag eller samlinger, konfigurere en kildeforespørgsel, vælge felterne der skal hentes, og vise de returnerede punkter, linjer eller polygoner uden først at kopiere dataene ind i Fabric.

Fabric Maps understøtter følgende eksterne feature-serviceprotokoller:

  • Webfunktionstjeneste (WFS)
  • OGC API - Funktioner
  • Esri Feature Service

For konceptuel information og protokolspecifikke overvejelser, se Eksterne feature-tjenester i Fabric Maps.

Vigtig

Denne funktion er i prøveversion.

Bemærkning

Eksterne feature-serviceforbindelser er skrivebeskyttede. Fabric Maps redigerer, indlæser eller skriver ikke funktioner tilbage til fjerntjenesten.

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

  • Et Fabric-arbejdsområde med kapacitet aktiveret af Fabric.
  • Tilladelse til at oprette eller redigere et kort i arbejdsområdet.
  • Et tilgængeligt WFS, OGC API - Funktioner eller Esri Feature Service-endpoint.
  • Endpoint-URL'en og de legitimationsoplysninger, der kræves af den fjernservice.
  • En tjeneste, der offentliggør mindst ét understøttet punkt, linje eller polygonlag eller samling.
  • Et WFS- eller Esri Feature Service-lag, der understøtter GeoJSON-output, hvis du bruger en af protokollerne.

Endepunktet skal bruge HTTPS og være tilgængeligt via det offentlige internet. Private endepunkter, lokale datagateways, virtuelle netværksdatagateways og andre administrerede private netværksmuligheder understøttes ikke.

Tilføj et eksternt feature-servicelag

For at tilføje et eksternt feature-servicelag, oprette eller genbruge en forbindelse, tilføje den til kortet som en ekstern kilde og konfigurere feature-forespørgslen.

Trin 1: Opret en ekstern feature service-forbindelse

Opret en genanvendelig forbindelse fra Administrer forbindelser og gateways.

Enhver Fabric-bruger kan oprette en cloud-forbindelse. Du skal have tilladelse til at oprette eller redigere kortet, hvor du tilføjer den eksterne kilde.

Tip

Opret én forbindelse for hvert service-endpoint og genbrug den på tværs af kort. Genanvend forbindelser for at holde endpoint- og credential-styringen ensartet.

  1. I Fabric-topbaren vælger du Indstillinger (tandhjulsikon). Hvis Indstillinger ikke er synlig, vælg Flere muligheder (...), og vælg derefter Indstillinger.

    Et screenshot af brugerindstillingsmenuen i Microsoft Fabric Maps med Indstillinger valgt i dropdown-menuen.

  2. Vælg Administrer forbindelser og gateways.

  3. Vælg Ny, og vælg derefter Cloud-forbindelse.

    Et screenshot af Microsoft Fabric Maps-grænsefladen, der viser siden Administrer forbindelser og Gateways. Knappen Ny, øverst til venstre, er fremhævet.

  4. For forbindelsestype, vælg Geospatial Web Services.

    Skærmbillede af dialogen Ny forbindelse i Microsoft Fabric Maps. Sky-muligheden vælges blandt forbindelsestyper, og dropdown-menuen for forbindelsestype udvides, hvor Geospatial Web Services fremhæves som en mulighed.

  5. Indtast den højeste service-endpoint URL. URL'en skal bruge HTTPS. Fabric Maps bruger ikke forespørgselsparametre, der er inkluderet i forbindelses-URL'en.

  6. Vælg serviceprotokollen:

    • WFS
    • OGC API - Funktioner
    • Esri Feature Service

  7. Vælg en autentificeringsmetode og indtast de nødvendige legitimationsoplysninger.

  8. Vælg det passende privatlivsniveau.

  9. Vælg Opret.

Forbindelsen bliver tilgængelig i Fabric Maps og i Administrer forbindelser og gateways.

Understøttede autentificeringsmetoder afhænger af den valgte protokol:

Godkendelsesmetode WFS OGC API - Funktioner Esri Feature Service
Anonym Understøttet Understøttet Understøttet
basisgodkendelse Understøttet Understøttet Ikke understøttet
API-nøgle Understøttet Understøttet Understøttet
OAuth 2.0 / Microsoft Entra ID Ikke understøttet Ikke understøttet Ikke understøttet

For Esri Feature Service API-nøgleautentificering indtast token API-nøgleparameterens navn.

Trin 2: Forstå forbindelsesadgang

Fabric gemmer legitimationsoplysninger i cloud-forbindelsen. Viewers behøver ikke forbindelsen, der deles med dem separat, for at gengive de eksterne data i et kort.

Hvis legitimationsoplysningerne udløber, eller Fabric Maps ikke kan nå tjenesten, viser kortet en fejl, der indikerer, at tjenesten ikke kunne nås. Opdater legitimationsoplysningerne i Administrer forbindelser og gateways, og prøv så igen.

Trin 3: Tilføj forbindelsen til et kort

  1. Åbn et eksisterende kort eller lav et kort.

  2. I Stifinder vælger du fanen Eksterne kilder .

  3. Vælg Tilføj kilder.

    Et screenshot af Microsoft Fabric Maps-grænsefladen, der viser fanen Eksterne kilder valgt i Explorer-panelet. Knappen Tilføj kilde er synlig, hvilket giver brugerne mulighed for at tilføje en ny ekstern datakilde. Det bredere miljø viser en kortforhåndsvisning til højre og en navigationsbjælke øverst med muligheder for Hjem, Nyt flisesæt, Flise-aktivitet og Kortindstillinger.

  4. Vælg forbindelsen til den eksterne funktionsservice fra Forbindelseslisten .

  5. Vælg Tilføj.

    Et screenshot af dialogboksen med titlen Vælg datakilde, centreret på Microsoft Fabric Maps-grænsefladen. Dialogen beder brugeren om at vælge en forbindelse fra en dropdown og har Tilføj og Annuller-knapper, hvor Tilføj er markeret. Over dialogen står en besked, der siger, at du kan oprette op til 100 forbindelser og råder til at administrere eller slette ubrugte.

Forbindelsen vises under Eksterne kilder. Udvid den for at opdage feature-lagene eller samlingerne, som tjenesten udgiver.

Den viste hierarki varierer efter protokol:

  • WFS-forbindelser oplister kvalificerede funktionstyper fra servicefunktionerne.
  • OGC API - Funktionernes forbindelser viser berettigede samlinger.
  • Esri Feature Service-forbindelser lister berettigede feature-lag.

Bemærkning

Fabric Maps lister kun de lag eller samlinger, som tjenesten offentliggør med understøttet geometri, felter, forespørgselsmuligheder og svarformater. Hvis et forventet element ikke vises, bekræft med tjenesteejeren, at elementet kan forespørges og er tilgængeligt i et understøttet format, og opdater derefter forbindelsen. For mere information, se Verificér servicemetadata.

Trin 4: Vælg et feature-lag eller en samling

  1. Udvid forbindelsen til den eksterne feature-service.

  2. Find det funktionslag eller den samling, der skal tilføjes.

  3. Åbn dens kontekstmenu, og vælg derefter Vis på kortet.

    Et screenshot, der viser Explorer-panelet i Microsoft Fabric Maps med fanen Eksterne kilder valgt. En liste over lag vises med menuen Flere muligheder, der viser muligheden Vis på kortet markeret..

  4. I Forhåndsvisnings-dataskærmen vælger du Hent alle data, hvis du vil have alle kolonner og rækker fra datakilden.

    Et screenshot af dialogboksen med titlen forhåndsvisningsdata, centreret på Microsoft Fabric Maps-grænsefladen. Dialogen beder brugeren vælge enten at trække alle data for filterdata, og trække alle data valgt.

    Eller vælg Filter data, hvis du vil afgøre, hvilke kolonner og rækker der vises fra datakilden. For mere information, se Filtrering af data.

    Et screenshot af dialogboksen med titlen preview-data, centreret om Microsoft Fabric Maps-grænsefladen. Dialogen beder brugeren om enten at hente alle data for filterdata, med filterdata valgt.

  5. For et punkt-only lag vælg Aktiver klyngedannelse , hvis ønsket, og vælg derefter Tilføje.

    Skærmbillede af et Service Requests-punktlag fra en ekstern feature-tjeneste vist i Fabric Maps.

Bemærkning

Screenshots bruger en Esri Feature Service-forbindelse som eksempel. Fabric Maps understøtter også WFS- og OGC API-funktioner-forbindelser gennem samme generelle arbejdsgang.

Filtrering af data

Brug kildeforespørgslen til at begrænse de funktioner, der hentes fra den eksterne tjeneste. De tilgængelige felter og betingelser afhænger af den valgte protokol og de kapabiliteter, der annonceres af endepunktet.

  1. Gennemgå den valgte service, funktionslag eller samling, geometritype og tilgængelige felter.
  2. Tilføj en eller flere forespørgselsbetingelser.
  3. Vælg et felt, en operator og en værdi for hver betingelse.
  4. Kombiner betingelser ved at bruge de tilgængelige muligheder for den valgte service.
  5. Konfigurer et tidsområde eller en tidsmæssig tilstand, når tjenesten annoncerer. Fabric Maps fortolker dato-/tidsværdier som UTC i RFC 3339-format.
  6. Vælg outputfelterne, der skal hentes.
  7. Gennemgå forespørgslen, og vælg derefter Add.

Fabric Maps anmoder om de matchende funktioner fra den eksterne tjeneste. Hvis forespørgslen indeholder en ikke-understøttet operator, en ugyldig værdi eller et inkompatibelt felt, revideres den baseret på beskeden, der vises i konfigurationsoplevelsen.

Fabric Maps udleder automatisk en afgrænsningsboks fra den aktuelle kortvisning, når den anmoder om funktioner. Begrænseringsboksen er ikke synlig eller konfigurerbar i forespørgselsbrugerfladen. Du kan ikke indtaste koordinater eller vælge et område som en rumlig forespørgselsbetingelse.

Bemærkning

Begrænseringsbokse, der krydser antimeridianen, understøttes ikke.

Hvis tjenesten ikke kan returnere funktioner i EPSG:4326, viser Fabric Maps en fejl, efter du har valgt Tilføje.

Vigtig

Når man bruger et filter, kører en kildeforespørgsel på den fjernservice og styrer, hvilke poster og felter Fabric Maps henter. Du kan ikke redigere et lags kildeforespørgsel efter du har tilføjet laget. For at bruge forskellige kilde-forespørgselsbetingelser tilføjes kildelaget igen og konfigureres et nyt filter.

Et kortlagsfilter styrer, hvilke hentede funktioner der vises. De operatorer, der er tilgængelige i kildeforespørgsler og kortlagsfiltre, kan variere.

Trin 6: Gennemgå laget

Når forespørgslen er færdig, tilføjer Fabric Maps et vektordatalag og vælger en standardvisualisering baseret på geometrien.

Geometri Standardvisualisering
Punkt Boblelag
Linje Linjelag
Polygon Polygonlag

Bekræft, at:

  • Kortet viser de forventede placeringer og former af formationer.
  • Lagattributter matcher fjernserviceresponsen.
  • Antallet af funktioner matcher kildeforespørgslen og servicebegrænsningerne.
  • Tooltips og felter inkluderer kun de valgte outputfelter.

Fabric Maps henter automatisk flere resultatsider baseret på den fjernservices pagingkonfiguration. Paging er gennemsigtig, og builders kan ikke konfigurere sidestørrelse, resultatantal eller pageing-adfærd.

Et lag kan gengive op til 100.000 funktioner. Hvis forespørgslen returnerer flere funktioner, gengiver Fabric Maps de første 100.000 og viser en advarsel i Layer settings-panelet. Forfin kildeforespørgslen for at reducere resultatmængden.

Hvis en sideanmodning mislykkes, prøver Fabric den op til tre gange. Hvis anmodningen stadig fejler, viser Fabric Maps En anmodning mislykkedes; nogle funktioner mangler. Opdater for at prøve igen.

Konfigurer laget

Efter at have tilføjet laget, brug de standard vektorlagsoplevelser til at:

  • Omdøb, dupliker, omarranger, skjul eller slet laget.
  • Ændr visualiseringen, som dens geometri understøtter.
  • Konfigurer farver, opacitet, størrelse, streg, etiketter og tooltips.
  • Anvend datadrevet styling og vis en forklaring.
  • Tilføj kortlagsfiltre for interaktivt at forfine de hentede funktioner.
  • Brug Zoom for at tilpasse og fokusere kortet på lagets udstrækning.

Du kan finde flere oplysninger under:

Eksterne feature-servicelag understøtter kategori- og værdiområdestyling. De understøtter også kategoriske, numeriske intervaller, booleske og dato/tids-filtre. De standard laghandlinger og kortlagsfilteradfærd er de samme for WFS, OGC API - Features, og Esri Feature Service.

Dupliker et eksternt feature-servicelag

Når du duplikerer et eksternt feature service-lag, refererer begge lag til de samme felter for datakilde, forbindelse, kildeforespørgsel og output. Kortlagsfiltre og visuelle indstillinger er uafhængige, så du kan filtrere og style hvert lag forskelligt. Du kan ikke redigere kildeforespørgslen eller outputfelterne efter du har tilføjet laget i denne udgivelse.

Opdater eksterne funktionstjenester

Redaktører kan opdatere en individuel forbindelse eller hele kortet:

  • I Eksterne kilder åbner du forbindelseskontekstmenuen og vælger Opdater for at hente de nyeste servicemetadata, inklusive nyligt tilføjede felter, lag eller samlinger. For at bruge et nytilføjet felt skal du tilføje kildelaget igen og vælge feltet.
  • Vælg Opdater for kortelementet for at forespørge de gemte lag for aktuelle data. Denne handling ændrer ikke forespørgslen om den gemte kildekode.

Gemte outputfelter, styling, forklaringer, synlighed og lagrækkefølge består efter begge opdateringshandlinger. Ændringer i kortkonfigurationen forbliver kun efter du har gemt kortet. Seere kan ikke opdatere eksterne funktionsservicedata i denne udgivelse.

Gem og verificér kortet

  1. Gem kortet.
  2. Luk og åbn den igen.
  3. Verdsig, at følgende indstillinger består:
    • Forbindelse og udvalgt feature-lag eller samling
    • Kildeforespørgsels- og outputfelter
    • Design og legende
    • Lagsynlighed og orden
  4. Åbn kortet i visningstilstand.
  5. Bekræft, at laget og legenden gengives uden kun redigeringskontroller. Brugere kan midlertidigt ændre ulåste kortlagsfiltre; låste filtre kan ikke fjernes.

Protokolspecifik forespørgselsadfærd

WFS

Fabric Maps understøtter WFS-versionerne 1.0.0, 1.1.0 og 2.0.0. Når tjenesten annoncerer flere understøttede versioner, bruger Fabric Maps den nyeste version. Den opdager funktionstyper fra WFS-funktionerne og henter GeoJSON-svar.

WFS understøtter mixed-geometry responser i ét lag. Lagets rapporterede geometritype er ukendt, og klyngedannelse er ikke tilgængelig.

OGC API - Funktioner

Fabric Maps opdager samlinger og læser endpointets overensstemmelsesmetadata. Attribut-, rum- og tidsforespørgselsmuligheder vises kun, når tjenesten annoncerer den tilsvarende kapacitet. OGC API - Features kan returnere blandede geometrier i ét lag.

Esri Feature Service

Fabric Maps læser service- og lagmetadata og henter GeoJSON-output. Afhængigt af lagets kapaciteter kan forespørgsler bruge feltbetingelser, udvalgte outputfelter og tidsparametre. Mixed-geometry responser understøttes ikke.

Fabric Maps accepterer Esri Feature Service-geometri med M- eller Z-koordinatværdier og ignorerer de ekstra dimensioner.

Fejlfinding

Spørgsmål Foreslået handling
Forbindelsen kan ikke skabes Verificér, at endepunktet bruger HTTPS, er tilgængeligt via det offentlige internet og bruger den valgte protokol. Fabric Maps bruger ikke forespørgselsparametre, der er inkluderet i forbindelses-URL'en. Bekræft, at autentificeringsmetoden og legitimationsoplysningerne er gyldige. For en HTTP-URL viser Fabric Maps Connection adding failed og Det angivne URL-format er ugyldigt. Bekræft at URL'en er en gyldig HTTPS-adresse og prøv igen.
Endpointet genkendes ikke som den valgte protokol Indtast det højeste service-endpoint i stedet for en lag-niveau URL. Fabric Maps viser Forbindelsestilføjelse mislykkedes, og Forbindelsen svarede ikke som en gyldig forventet protokoludbyder, når endepunktet ikke leverer den forventede protokolmetadata.
Forbindelsen åbner, men der vises ingen lag eller samlinger Bekræft, at endpointet offentliggør et understøttet, forespørgeligt feature-lag eller en samling. Opdater forbindelsen for at hente opdaterede servicemetadata.
En forventet forespørgselsmulighed er ikke tilgængelig Fabric Maps viser kun felter, operatorer og værdier, der annonceres som forespørgelige i servicemetadata. Bekræft med serviceindehaveren, at den forventede mulighed er offentliggjort og understøttet.
Forespørgslen returnerer ingen funktioner Fjern forespørgselsbetingelserne én ad gangen for at identificere den betingelse, der udelukker funktionerne. Efter hver ændring, opdater du forhåndsvisningen.
Nogle funktioner vises ikke, og laget viser et resultatgrænse-badge Fabric Maps gengiver op til 100.000 features pr. lag. Opdatering henter ikke funktioner ud over denne grænse. Tilføj kildelaget igen med en mere restriktiv forespørgsel.
En anmodning mislykkedes; nogle funktioner mangler. Opdater for at prøve igen. Dukker op En eller flere forespørgsler mislykkedes, og Fabric Maps sprang en del af resultatet over. Dette problem er som regel midlertidigt. Opdater kortet. Hvis problemet fortsætter, fjern og tilføj laget igen.
Nogle funktioner mangler, men der vises ingen anmodningsfejl-notifikation eller resultatbegrænsningsbadge Tjek om kilden indeholder geometrisamlinger. Fabric Maps gengiver ikke geometrisamlinger, men andre understøttede funktioner i laget gengives normalt.
Funktioner dukker op et uventet sted, eller laget indlæses ikke Verificér, at tjenesten kan returnere funktioner i EPSG:4326, og at lagets koordinatsystem indeholder en gyldig EPSG-autoritetskode.
Et gemt lag gengives ikke for en anden bruger Kontroller at fjerntjenesten er tilgængelig, og at cloud-forbindelsen indeholder gyldige legitimationsoplysninger. Seerne behøver ikke separat adgang til forbindelsen.
Tjenesten kan ikke kontaktes Verificér, at det offentlige endepunkt er tilgængeligt. Hvis oplysningerne er udløbet, opdater du dem i Administrer forbindelser og gateways, og prøv så igen.

Verificér servicemetadata

Hvis et forventet lag eller en samling ikke vises under forbindelsen, så bed service-ejeren om at verificere servicemetadata. Du kan inspicere offentlige metadata i en browser eller API-klient. For en autentificeret tjeneste skal du bruge en klient, der kan sende de nødvendige legitimationsoplysninger.

Metadata-tjekkene afhænger af protokollen:

  • WFS: Anmod om dokumentet GetCapabilities og bekræft, at det angiver funktionstypen. Brug DescribeFeatureType den til at verificere dens geometri og felter. Tjek de annoncerede outputformater eller kør en lille GetFeature forespørgsel, der returnerer GeoJSON.
  • OGC API - Funktioner: Åbn servicens landingsside og /collections, og bekræft, at samlingen er listet og indeholder et link. Tjek /conformance, og anmod om et lille GeoJSON-svar fra /collections/{collection-id}/items.
  • Esri Feature Service: Åbn endpointet FeatureServer med ?f=pjson og bekræft, at det viser laget. Åbn FeatureServer/{layer-id}?f=pjson, og verificér at laget har understøttet geometri og felter, inkluderer Query sine kapaciteter og viser GeoJSON i supportedQueryFormats.

Bemærkning

Brug kun disse metadata-anmodninger til fejlfinding af tjenesten. I Fabric-forbindelsesformularen indtastes det højeste service-endpoint. Fabric Maps bruger ikke forespørgselsparametre, der er inkluderet i forbindelses-URL'en.

Begrænsninger og overvejelser

  • Eksterne feature-tjenester er skrivebeskyttede. De understøtter ikke redigering, indtastning eller writeback.
  • Forespørgselsmuligheder afhænger af de muligheder, som fjerntjenesten reklamerer med.
  • Fabric Maps anmoder om funktioner i EPSG:4326, med koordinater i længdegrad og breddegrad. Tjenester, der offentliggør data i et andet koordinatreferencesystem, understøttes, hvis tjenesten kan reprojicere dataene til EPSG:4326. Hvis tjenesten ikke kan reprojicere dataene, for eksempel når lagets koordinatsystem mangler en EPSG-autoritetskode, indlæses laget ikke.
  • Begrænseringsbokse, der krydser antimeridianen, understøttes ikke.
  • Funktioner, hvis geometri er en geometrisamling, bliver ikke gengivet. Andre understøttede funktioner i samme lag gengives normalt.
  • Clustering er ikke tilgængeligt for blandede geometri-lag.
  • WFS- og Esri Feature Service-lagene skal understøtte GeoJSON-output.
  • GML-svarformater understøttes ikke i denne udgivelse.
  • Fabric Maps ignorerer M- og Z-dimensioner i Esri Feature Service-geometri.
  • Et lag kan gengive op til 100.000 funktioner.
  • Et kortelement kan referere til op til 100 eksterne forbindelser på tværs af WMS, WMTS, WFS, OGC API - Funktioner og Esri Feature Service.
  • Kun tjenester, der kan nås via det offentlige internet, understøttes. Private endpoints og gateways understøttes ikke.
  • Fjernservicebehandling, tilgængelighed og netværkslatens kan påvirke forespørgsels- og renderingstider.

Næste trin

Eksterne feature-tjenester i Fabric Maps

For styling og filtrering, se Tilpas et kort og Filter data i et kortlag.

  • Sidst opdateret den