Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.
Nella barra superiore Fabric, seleziona Impostazioni (icona dell'ingranaggio). Se Impostazioni non è visibile, seleziona Altre opzioni (...), poi seleziona Impostazioni.
Selezionare Gestisci connessioni e gateway.
Selezionare Nuovo e quindi scegliere Connessione cloud.
In Tipo di connessione selezionare Servizi Web geospaziali.
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.
Seleziona il protocollo di servizio:
- WFS
- API OGC - Caratteristiche
- Feature Service di Esri
Seleziona un metodo di autenticazione e inserisci le credenziali richieste.
Seleziona il livello di privacy appropriato.
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
Apri una mappa esistente o creala una mappa.
Nell'Esplora, seleziona la scheda Sorgenti Esterne .
Selezionare Aggiungi origini.
Seleziona la connessione di servizio esterno dalla lista Connessioni .
Seleziona Aggiungi.
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à
Espandi la connessione esterna dei servizi di funzionalità.
Trova il layer di feature o la collezione da aggiungere.
Apri il suo menu contestuale e poi seleziona Mostra sulla mappa.
Nella schermata Anteprima dati, seleziona Recupera tutti i dati se desideri tutte le colonne e tutte le righe dell'origine dati.
Oppure seleziona Filtra dati se vuoi determinare quali colonne e righe appaiono dalla fonte dati. Per ulteriori informazioni, vedi Filtraggio dei dati.
Per un livello solo a punti, seleziona Abilita clustering se desiderato, e poi seleziona Aggiungi.
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.
- Esamina il servizio selezionato, il livello o la collezione di caratteristiche, il tipo di geometria e i campi disponibili.
- Aggiungi una o più condizioni di query.
- Seleziona un campo, un operatore e un valore per ogni condizione.
- Combina le condizioni utilizzando le opzioni disponibili per il servizio selezionato.
- 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.
- Seleziona i campi di output da recuperare.
- 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
- Salvare la mappa.
- Chiudi e riapri.
- 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
- Apri la mappa in modalità visualizzazione.
- 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
GetCapabilitiesdocumento e conferma che sia indicato il tipo di caratteristica. UsaloDescribeFeatureTypeper verificare la sua geometria e i campi. Controlla i formati di output pubblicizzati o esegui una piccolaGetFeaturerichiesta 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
FeatureServercon?f=pjsone verifica che elenchi il layer. ApriFeatureServer/{layer-id}?f=pjson, e verifica che il layer supporti geometrie e campi, che includaQuerytra le sue funzionalità e che riporti GeoJSON insupportedQueryFormats.
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.