Aggiungi un livello esterno di servizio feature a una mappa

Questo articolo ti mostra come collegare Fabric Maps a un servizio di feature esterno e renderizzare i suoi dati vettoriali come un livello mappato. Puoi scoprire i livelli di feature o le collezioni disponibili, configurare una query sorgente, selezionare i campi da recuperare e visualizzare i punti, le righe o i poligoni restituiti senza prima copiare i dati in Fabric.

Fabric Maps supporta i seguenti protocolli di servizio esterno di funzionalità:

  • Servizio di Funzionalità Web (WFS)
  • API OGC - Caratteristiche
  • Feature Service di Esri

Per informazioni concettuali e considerazioni specifiche per protocollo, vedi Servizi di funzionalità esterne in Fabric Maps.

Importante

Questa funzionalità si trova in Anteprima.

Annotazioni

Le connessioni ai feature service esterni sono di sola lettura. Fabric Maps non modifica, non acquisisce né riscrive gli elementi sul servizio remoto.

Prerequisiti

Prima di iniziare, assicurati di avere:

  • Uno spazio di lavoro Fabric con capacità abilitata per Fabric.
  • Permesso di creare o modificare una mappa nello spazio di lavoro.
  • Un endpoint raggiungibile WFS, OGC API - Features o Esri Feature Service.
  • L'URL e le credenziali dell'endpoint richieste dal servizio remoto.
  • Un servizio che pubblica almeno un livello o collezione di punti, righe o poligoni supportato.
  • Un livello WFS o Esri Feature Service che supporta l'output in formato GeoJSON, se si usa uno dei due protocolli.

L'endpoint deve utilizzare HTTPS ed essere raggiungibile tramite internet pubblico. Gli endpoint privati, i gateway dati locali, i gateway dati di rete virtuale e altre opzioni di rete privata gestita non sono supportati.

Aggiungi un livello esterno di servizio feature

Per aggiungere un livello di servizio feature esterno, crea o riutilizza una connessione, aggiungila alla mappa come sorgente esterna e configura la query delle funzionalità.

Passo 1: Crea una connessione esterna a un feature service

Crea una connessione riutilizzabile da Gestisci connessioni e i gateway.

Qualsiasi utente Fabric può creare una connessione cloud. Hai bisogno del permesso per creare o modificare la mappa dove aggiungi la fonte esterna.

Suggerimento

Crea una connessione per ogni endpoint di servizio e riutilizzala tra mappe. Riutilizza le connessioni per mantenere una gestione coerente degli endpoint e delle credenziali.

  1. Nella barra superiore Fabric, seleziona Impostazioni (icona dell'ingranaggio). Se Impostazioni non è visibile, seleziona Altre opzioni (...), poi seleziona Impostazioni.

    Screenshot del menu Impostazioni utente in Mappe di Microsoft Fabric con impostazioni selezionate nell'elenco a discesa.

  2. Selezionare Gestisci connessioni e gateway.

  3. Selezionare Nuovo e quindi scegliere Connessione cloud.

    Screenshot dell'interfaccia mappe di Microsoft Fabric che mostra la pagina Gestisci connessioni e gateway. Il pulsante Nuovo in alto a sinistra è evidenziato.

  4. In Tipo di connessione selezionare Servizi Web geospaziali.

    Schermata della finestra di dialogo Nuova connessione in Microsoft Fabric Maps. L'opzione Cloud è selezionata tra i tipi di connessione e l'elenco a discesa Tipo di connessione è aperto, con Servizi Web geospaziali evidenziato come opzione.

  5. Inserisci l'URL dell'endpoint di servizio di livello più alto. L'URL deve utilizzare HTTPS. Fabric Maps non utilizza i parametri di query inclusi nell'URL di connessione.

  6. Seleziona il protocollo di servizio:

    • WFS
    • API OGC - Caratteristiche
    • Feature Service di Esri
  7. Seleziona un metodo di autenticazione e inserisci le credenziali richieste.

  8. Seleziona il livello di privacy appropriato.

  9. Fare clic su Crea.

La connessione diventa disponibile in Fabric Maps e in Gestisci connessioni e gateway.

I metodi di autenticazione supportati dipendono dal protocollo selezionato:

Metodo di autenticazione WFS API OGC - Caratteristiche Feature Service di Esri
Anonimo Supportato Supportato Supportato
Basic authentication Supportato Supportato Non supportato
API key Supportato Supportato Supportato
OAuth 2.0 / Microsoft Entra ID Non supportato Non supportato Non supportato

Per l'autenticazione della chiave API di Esri Feature Service, inserisci token come nome del parametro della chiave API.

Passo 2: Comprendere l'accesso alla connessione

Fabric memorizza le credenziali nella connessione cloud. I visualizzatori non hanno bisogno che la connessione venga condivisa separatamente con loro per visualizzare i dati esterni in una mappa.

Se le credenziali scadono o Fabric Maps non riesce a raggiungere il servizio, la mappa mostra un errore che indica che il servizio non è stato raggiungibile. Aggiorna le credenziali in Gestisci connessioni e gateway, e poi riprova.

Passo 3: Aggiungi la connessione a una mappa

  1. Apri una mappa esistente o creala una mappa.

  2. Nell'Esplora, seleziona la scheda Sorgenti Esterne .

  3. Selezionare Aggiungi origini.

    Uno screenshot dell'interfaccia di Microsoft Fabric Maps che mostra la scheda Sorgenti Esterne selezionata nel pannello Esplora. Il pulsante Aggiungi sorgente è visibile, permettendo agli utenti di aggiungere una nuova fonte dati esterna. L'ambiente più ampio mostra un'anteprima della mappa a destra e una barra di navigazione in alto con opzioni per Home, Nuovo tileset, attività Tileset e impostazioni Mappa.

  4. Seleziona la connessione di servizio esterno dalla lista Connessioni .

  5. Seleziona Aggiungi.

    Uno screenshot della finestra di dialogo intitolata Scegli sorgente dati, centrata sull'interfaccia di Microsoft Fabric Maps. La finestra di dialogo invita l'utente a selezionare una connessione tramite un menu a tendina e fornisce i pulsanti Aggiungi e Annulla, con Aggiungi evidenziata. Sopra la finestra di dialogo, un messaggio indica che puoi creare fino a 100 connessioni e consiglia di gestire o eliminare quelle inutilizzate.

La connessione appare sotto Fonti esterne. Espandilo per scoprire i layer di funzionalità o le collezioni pubblicate dal servizio.

La gerarchia visualizzata varia a seconda del protocollo:

  • Le connessioni WFS elencano i tipi di funzionalità idonee dalle capacità del servizio.
  • API OGC - Presenta connessioni, elenca le collezioni idonee.
  • Le connessioni Esri Feature Service elencano i layer di funzionalità idonei.

Annotazioni

Fabric Maps elenca solo i livelli o le collezioni che il servizio pubblica con geometria, campi, capacità di query e formati di risposta supportati. Se un elemento atteso non appare, conferma con il proprietario del servizio che l'oggetto è consultabile e disponibile in un formato supportato, poi aggiorna la connessione. Per ulteriori informazioni, vedi Verifica i metadati del servizio.

Passo 4: Seleziona un layer o una collezione di funzionalità

  1. Espandi la connessione esterna dei servizi di funzionalità.

  2. Trova il layer di feature o la collezione da aggiungere.

  3. Apri il suo menu contestuale e poi seleziona Mostra sulla mappa.

    Uno screenshot che mostra il pannello Esplora in Microsoft Fabric Maps con la scheda Sorgenti Esterne selezionata. Viene mostrato un elenco dei livelli con il menu Altre opzioni che mostra l'opzione Mostra sulla mappa evidenziata..

  4. Nella schermata Anteprima dati, seleziona Recupera tutti i dati se desideri tutte le colonne e tutte le righe dell'origine dati.

    Una schermata della finestra di dialogo intitolata

    Oppure seleziona Filtra dati se vuoi determinare quali colonne e righe appaiono dalla fonte dati. Per ulteriori informazioni, vedi Filtraggio dei dati.

    Uno screenshot della finestra di dialogo intitolata dati di anteprima, centrata sull'interfaccia di Microsoft Fabric Maps. La finestra di dialogo invita l'utente a selezionare o extrarre tutti i dati per i dati del filtro, con i dati del filtro selezionati.

  5. Per un livello solo a punti, seleziona Abilita clustering se desiderato, e poi seleziona Aggiungi.

    Schermata di un layer di punti Service Requests da un feature service esterno visualizzato in Fabric Maps.

Annotazioni

Gli screenshot usano come esempio una connessione Esri Feature Service. Fabric Maps supporta anche WFS e OGC API - Presenta connessioni attraverso lo stesso flusso di lavoro generale.

Filtro dei dati

Usa la query di origine per limitare le feature ottenute dal servizio remoto. I campi e le condizioni disponibili dipendono dal protocollo selezionato e dalle capacità pubblicizzate dall'endpoint.

  1. Esamina il servizio selezionato, il livello o la collezione di caratteristiche, il tipo di geometria e i campi disponibili.
  2. Aggiungi una o più condizioni di query.
  3. Seleziona un campo, un operatore e un valore per ogni condizione.
  4. Combina le condizioni utilizzando le opzioni disponibili per il servizio selezionato.
  5. Configura un intervallo di tempo o una condizione temporale, se supportata dal servizio. Fabric Maps interpreta i valori data/ora come UTC nel formato RFC 3339.
  6. Seleziona i campi di output da recuperare.
  7. Rivedi la query, poi seleziona Aggiungi.

Fabric Maps richiede le caratteristiche corrispondenti al servizio remoto. Se la query contiene un operatore non supportato, un valore invalido o un campo incompatibile, rivedela in base al messaggio mostrato nell'esperienza di configurazione.

Fabric Maps ricava automaticamente un riquadro di delimitazione dalla vista corrente della mappa quando richiede gli elementi. Il riquadro di delimitazione non è visibile né configurabile nell'interfaccia utente della query. Non puoi inserire coordinate o selezionare un'area come condizione di query spaziale.

Annotazioni

I riquadri di delimitazione che attraversano l'antimeridiano non sono supportati.

Se il servizio non può restituire funzionalità in EPSG:4326, Fabric Maps mostra un errore dopo che selezioni Aggiungi.

Importante

Quando si utilizza un filtro, una query di origine viene eseguita sul servizio remoto e determina quali record e campi vengono recuperati da Fabric Maps. Non puoi modificare la query di origine di un livello dopo aver aggiunto il livello. Per utilizzare condizioni diverse per la query di origine, aggiungi di nuovo il livello di origine e configura un nuovo filtro.

Un filtro a livello mappa controlla che vengono visualizzate le caratteristiche recuperate. Gli operatori disponibili nelle query di sorgente e nei filtri a livello mappa possono differire.

Passo 6: Rivedi il livello

Dopo la finalizzazione, Fabric Maps aggiunge un livello di dati vettoriale e seleziona una visualizzazione predefinita basata sulla geometria.

Geometry Visualizzazione predefinita
Point Livello della bolla
Grafico a linee Livello linea
Polygon Livello poligono

Confermare che:

  • La mappa mostra le posizioni previste e le forme degli elementi.
  • Gli attributi dei layer corrispondono alla risposta del servizio remoto.
  • Il numero di caratteristiche corrisponde ai limiti della query di origine e del servizio di origine.
  • I tooltip e i campi includono solo i campi di output selezionati.

Fabric Maps recupera automaticamente altre pagine di risultati in base alla configurazione di paginazione del servizio remoto. Il paging è trasparente e i builder non possono configurare la dimensione della pagina, il conteggio dei risultati o il comportamento di paging.

Un livello può renderizzare fino a 100.000 funzionalità. Se la query restituisce più funzionalità, Fabric Maps visualizza le prime 100.000 e mostra un avviso nel pannello delle impostazioni dei livelli. Affina la query sorgente per ridurre il set di risultati.

Se una richiesta di pagina fallisce, Fabric la riprova fino a tre volte. Se la richiesta fallisce ancora, Fabric Maps mostra Una richiesta fallita; alcune funzionalità mancano. Aggiorna per riprovare.

Configurare il livello

Dopo aver aggiunto il livello, usa le esperienze standard a livello vettoriale per:

  • Rinomina, duplica, riordina, nascondi o elimina il livello.
  • Cambia la visualizzazione supportata dalla sua geometria.
  • Configura colori, opacità, dimensioni, tratto, etichette e tooltip.
  • Applica uno stile basato sui dati e mostra una legenda.
  • Aggiungi filtri a livello mappa per affinare interattivamente le caratteristiche recuperate.
  • Usa Zoom per adattare la mappa all'estensione del livello.

Per ulteriori informazioni consulta:

I layer dei feature service esterni supportano stili basati su categorie e intervalli di valori. Supportano anche filtri categorico, numerici, booleani e data/ora. Le azioni standard dei layer e il comportamento del filtro map-layer sono gli stessi per WFS, OGC API - Features e Esri Feature Service.

Duplicata un livello di servizio di funzionalità esterno

Quando duplichi un layer di feature service esterno, entrambi i layer fanno riferimento alla stessa origine dati, connessione, query di origine e campi di output. I filtri map-layer e le impostazioni visive sono indipendenti, quindi puoi filtrare e stilizzare ogni livello in modo diverso. Non puoi modificare i campi della query di origine o di output dopo aver aggiunto il livello in questa versione.

Aggiorna i servizi di funzionalità esterne

Gli editor possono aggiornare una singola connessione o l'intera mappa:

  • Nelle fonti esterne, apri il menu contestuale della connessione e seleziona Aggiorna per recuperare gli ultimi metadati del servizio, inclusi campi, livelli o raccolte appena aggiunti. Per usare un campo appena aggiunto, aggiungi di nuovo il livello sorgente e seleziona il campo.
  • Seleziona Aggiorna per l'elemento della mappa per interrogare i livelli salvati per i dati attuali. Questa azione non cambia la query del codice sorgente salvato.

I campi di output salvati, lo stile, le legende, la visibilità e l'ordine dei layer persistono dopo entrambe le azioni di aggiornamento. I cambiamenti nella configurazione della mappa persistono solo dopo aver salvato la mappa. Gli utenti non possono aggiornare i dati esterni dei servizi di funzionalità in questa versione.

Salva e verifica la mappa

  1. Salvare la mappa.
  2. Chiudi e riapri.
  3. Verifica che le seguenti impostazioni siano mantenute:
    • Connessione e layer o collezione di funzionalità selezionati
    • Campi di interrogazione sorgente e output
    • Stile e leggenda
    • Visibilità e ordine degli strati
  4. Apri la mappa in modalità visualizzazione.
  5. Verifica che il livello e la legenda siano visualizzati senza controlli disponibili solo in modalità modifica. Gli visualizzatori possono modificare temporaneamente i filtri del livello mappa sbloccati; i filtri bloccati non possono essere rimossi.

Comportamento delle query in base al protocollo

WFS

Fabric Maps supporta le versioni WFS 1.0.0, 1.1.0 e 2.0.0. Quando il servizio pubblicizza più versioni supportate, Fabric Maps utilizza l'ultima versione. Scopre i tipi di funzionalità dalle capacità del WFS e recupera le risposte GeoJSON.

WFS supporta risposte a geometria mista in un unico livello. Il tipo di geometria riportato dal layer è sconosciuto e il clustering non è disponibile.

API OGC - Caratteristiche

Fabric Maps scopre le collezioni e legge i metadati di conformità dell'endpoint. Le opzioni di query per attributi, spaziali e temporali appaiono solo quando il servizio pubblicizza la capacità corrispondente. API OGC - Le funzionalità possono restituire geometrie miste in un unico livello.

Feature Service di Esri

Fabric Maps legge i metadati del servizio e del livello e recupera l'output GeoJSON. A seconda delle capacità del livello, le query possono utilizzare condizioni di campo, campi di output selezionati e parametri temporali. Le risposte a geometria mista non sono supportate.

Fabric Maps accetta la geometria Esri Feature Service con valori di coordinate M o Z e ignora le dimensioni aggiuntive.

Troubleshooting

Issue Azione suggerita
La connessione non può essere creata Verifica che l'endpoint utilizzi HTTPS, sia raggiungibile tramite internet pubblico e utilizzi il protocollo selezionato. Fabric Maps non utilizza i parametri di query inclusi nell'URL di connessione. Conferma che il metodo di autenticazione e le credenziali siano validi. Per un URL HTTP, Fabric Maps mostra Aggiunta di connessione fallita e il formato URL fornito è invalido. Verifica che l'URL sia un indirizzo HTTPS valido e riprova.
L'endpoint non è riconosciuto come il protocollo selezionato Inserisci l'endpoint di servizio di livello più alto invece di un URL a livello di livello. Fabric Maps mostra l'aggiunta di connessione fallita e La connessione non ha risposto come fornitore valido di protocolli attesi quando l'endpoint non fornisce i metadati attesi del protocollo.
La connessione si apre, ma non appaiono né strati né collezioni Conferma che l'endpoint pubblichi un layer o una collezione di funzionalità supportata e interrogabile. Aggiorna la connessione per recuperare i metadati aggiornati del servizio.
Non è disponibile un'opzione di query prevista Fabric Maps mostra solo campi, operatori e valori pubblicizzati come consultabili nei metadati del servizio. Conferma con il proprietario del servizio che l'opzione prevista sia pubblicata e supportata.
La query non restituisce alcuna funzionalità Rimuovi le condizioni di query una alla volta per identificare quella che esclude le caratteristiche. Dopo ogni modifica, aggiorna l'anteprima.
Alcune funzionalità non vengono visualizzate e il livello mostra un badge di limite di risultato Fabric Maps visualizza fino a 100.000 feature per livello. Aggiornare non recupera funzionalità oltre questo limite. Aggiungi di nuovo il livello sorgente con una query più restrittiva.
Una richiesta è fallita; alcune funzionalità mancano. Aggiorna per riprovare. appare Una o più richieste sono fallite e Fabric Maps ha saltato parte del risultato. Questo problema è solitamente temporaneo. Aggiorna la mappa. Se il problema persiste, rimuovi e aggiungi di nuovo il livello.
Alcune funzionalità mancano, ma non appaiono notifiche di fallimento delle richieste o badge di limite di risultato Controlla se la fonte contiene raccolte di geometria. Fabric Maps non renderizza le collezioni di geometrie, ma altre funzionalità supportate nel livello vengono renderizzate normalmente.
Le funzionalità appaiono in una posizione inaspettata oppure il livello non si carica Verifica che il servizio possa restituire caratteristiche in EPSG:4326 e che il sistema di coordinate del livello includa un codice di autorità EPSG valido.
Un livello salvato non viene renderizzato per un altro utente Verifica che il servizio remoto sia raggiungibile e che la connessione cloud contenga credenziali valide. Gli spettatori non hanno bisogno di accesso separato alla connessione.
Il servizio non è raggiungibile Verifica che l'endpoint pubblico sia disponibile. Se le credenziali sono scadute, aggiornale in Gestisci connessioni e gateway, e poi riprova.

Verifica i metadati del servizio

Se un layer o una collezione attesa non appare sotto la connessione, chiedi al proprietario del servizio di verificare i metadati del servizio. Puoi ispezionare i metadati pubblici in un browser o in un client API. Per un servizio autenticato, usa un client che possa inviare le credenziali richieste.

I controlli dei metadati dipendono dal protocollo:

  • WFS: Richiedi il GetCapabilities documento e conferma che sia indicato il tipo di caratteristica. Usalo DescribeFeatureType per verificare la sua geometria e i campi. Controlla i formati di output pubblicizzati o esegui una piccola GetFeature richiesta che restituisca GeoJSON.
  • API OGC - Funzionalità: Apri la landing page del servizio e /collections, e conferma che la collezione sia elencata e includa un link agli elementi. Controlla /conformance, e richiedi una piccola risposta GeoJSON da /collections/{collection-id}/items.
  • Esri Feature Service: Apri l'endpoint FeatureServer con ?f=pjson e verifica che elenchi il layer. Apri FeatureServer/{layer-id}?f=pjson, e verifica che il layer supporti geometrie e campi, che includa Query tra le sue funzionalità e che riporti GeoJSON in supportedQueryFormats.

Annotazioni

Usa queste richieste di metadati solo per risolvere i problemi del servizio. Nel modulo di connessione Fabric, inserisci l'endpoint di servizio di livello più alto. Fabric Maps non utilizza i parametri di query inclusi nell'URL di connessione.

Limitazioni e considerazioni

  • I servizi di funzionalità esterne sono di sola lettura. Non supportano la modifica delle feature, l'ingestion o il writeback.
  • Le opzioni di query dipendono dalle capacità pubblicizzate dal servizio remoto.
  • Fabric Maps richiede caratteristiche in EPSG:4326, con coordinate in ordine di longitudine e latitudine. I servizi che pubblicano dati in un altro sistema di riferimento di coordinate sono supportati se il servizio riesce a riproiettare i dati in EPSG:4326. Se il servizio non riesce a riproiettare i dati, ad esempio quando il sistema di coordinate del livello manca di un codice di autorità EPSG, il livello non si carica.
  • I riquadri di delimitazione che attraversano l'antimeridiano non sono supportati.
  • Le funzionalità la cui geometria è una collezione di geometrie non vengono renderizzate. Altre funzionalità supportate nello stesso livello vengono renderizzate normalmente.
  • Il clustering non è disponibile per i livelli a geometria mista.
  • I livelli WFS ed Esri Feature Service devono supportare l'output GeoJSON.
  • I formati di risposta GML non sono supportati in questa versione.
  • Fabric Maps ignora le dimensioni M e Z nella geometria di Esri Feature Service.
  • Un livello può renderizzare fino a 100.000 funzionalità.
  • Un elemento mappato può fare riferimento a fino a 100 connessioni esterne tra WMS, WMTS, WFS, OGC API - Features e Esri Feature Service.
  • Sono supportati solo i servizi raggiungibili tramite internet pubblico. Gli endpoint privati e i gateway non sono supportati.
  • L'elaborazione remota dei servizi, la disponibilità e la latenza di rete possono influenzare i tempi di query e di rendering.

Passaggi successivi

Per stilizzazione e filtraggio, vedi Personalizza una mappa e Filtra i dati in un livello mappa.