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.
Fabric Maps può collegarsi a servizi di feature esterni e visualizzare i loro dati vettoriali come layer map. Un servizio di funzionalità esterne fornisce caratteristiche geografiche, come punti, linee e poligoni, insieme ad attributi che descrivono tali caratteristiche.
Importante
Questa funzionalità si trova in Anteprima.
Collegandoti a un servizio di funzionalità esterno, puoi visualizzare dati spaziali ospitati da remoto senza prima copiarli in una casa di lago o in una casa evento. Fabric Maps interroga il servizio, recupera le caratteristiche e gli attributi selezionati e visualizza i risultati come un livello dati vettoriale.
Fabric Maps supporta i seguenti protocolli di servizio esterno di funzionalità:
- Servizio di Funzionalità Web (WFS)
- API OGC - Caratteristiche
- Feature Service di Esri
Si accedono a questi protocolli tramite il tipo di connessione Geospatial Web Services , insieme a WMS e WMTS. Crea la connessione cloud in Gestisci connessioni e gateway, poi aggiungi la connessione a una mappa dalla scheda Sorgenti Esterne nell'esploratore della mappa.
Annotazioni
L'integrazione con servizi di funzionalità esterne è di sola lettura. Fabric Maps non modifica, non acquisisce né riscrive i dati nel servizio remoto.
Cos'è un servizio di funzionalità esterne?
Un servizio di funzionalità esterne è un'API geospaziale basata sul web che pubblica singole caratteristiche geografiche. Ogni caratteristica contiene:
- Geometria, che definisce la posizione e la forma della caratteristica come un punto, una linea o un poligono.
- Attributi che forniscono informazioni sulla caratteristica, come nome, categoria, stato, misurazione o data.
Ad esempio, un servizio di feature potrebbe pubblicare le posizioni dei veicoli come punti, le strade come linee o i confini amministrativi come poligoni. Fabric Maps utilizza la geometria per disegnare ogni caratteristica e rende disponibili attributi selezionati per stile, filtraggio, etichette, legende e tooltip.
Il servizio e i suoi dati rimangono fuori dall'elemento della mappa. La mappa memorizza un riferimento alla connessione e alla configurazione necessaria per recuperare e visualizzare i dati.
Protocolli di servizio di funzionalità supportati
La tabella seguente riassume come Fabric Maps funziona con ciascun protocollo supportato.
| Protocol | Descrizione | Comportamento del servizio utilizzato da Fabric Maps |
|---|---|---|
| WFS | Uno standard dell'Open Geospatial Consortium (OGC) per il recupero di caratteristiche geografiche. Fabric Maps supporta le versioni WFS 1.0.0, 1.1.0 e 2.0.0. | Fabric Maps legge le capacità del servizio, utilizza l'ultima versione supportata pubblicizzata dal servizio, scopre i tipi di funzionalità disponibili e recupera le risposte GeoJSON. |
| API OGC - Caratteristiche | Uno standard OGC orientato al REST per l'accesso a caratteristiche geografiche organizzate in collezioni. | Fabric Maps scopre le collezioni e utilizza le informazioni di conformità del servizio per determinare le capacità di query disponibili. |
| Feature Service di Esri | Un servizio REST di ArcGIS che pubblica layer di funzionalità interrogabili. | Fabric Maps legge i metadati di servizio e layer e recupera i livelli che supportano l'output GeoJSON. |
Come funzionano i servizi di feature esterni in Fabric Maps
Quando aggiungi un servizio di funzionalità esterno a una mappa, Fabric Maps:
- Utilizza una connessione esistente o crea una connessione con l'endpoint remoto.
- Individua i feature layer o le raccolte pubblicati dal servizio.
- Legge i metadati disponibili, inclusi tipi di geometria, campi, limiti di record e capacità di query supportate.
- Ti permette di configurare una query lato server e selezionare i campi da recuperare.
- Richiede le funzionalità corrispondenti, incluse eventuali pagine di risultati aggiuntive quando supportate e richieste.
- Renderizza le caratteristiche restituite come un livello dati vettoriale.
La visualizzazione predefinita si basa sulla geometria restituita dal servizio:
| Geometry | Visualizzazione predefinita |
|---|---|
| Point | Livello della bolla |
| Grafico a linee | Livello linea |
| Polygon | Livello poligono |
Dopo l'aggiunta del livello, puoi configurare opzioni vettoriali supportate come stile, etichette, legende, tooltip, visibilità e filtri map-layer. Per ulteriori informazioni, consulta Personalizza una mappa e filtraggio dati in Fabric Maps.
Per una risposta con geometrie miste di WFS o OGC API - Features, Fabric Maps crea un unico livello di dati. Il tipo di geometria riportato dal livello è Sconosciuto perché nessun singolo tipo lo descrive. Gli elementi puntuali usano un livello bubble, gli elementi lineari usano un livello lineare e gli elementi poligonali usano un livello poligonale senza estrusione. Se abiliti lo stile basato sui dati, Fabric Maps mostra le legende dei tipi di geometria nel pannello del livello dati. Il clustering non è disponibile per i livelli a geometria mista.
I layer del servizio feature esterno supportano uno stile basato sui dati per categorie e intervalli di valori.
Scoperta di strati e collezioni
Fabric Maps elenca i feature layer o le collezioni idonei sotto la connessione nella sezione Sorgenti Esterne dell'Esploratore. La gerarchia disponibile dipende dal protocollo e dai metadati esposti dal servizio.
Aggiornando la connessione si recuperano i metadati più recenti del servizio, inclusi campi, livelli o raccolte aggiunti. Questi cambiamenti potrebbero non apparire automaticamente. Per usare un campo appena aggiunto, aggiorna la connessione, poi aggiungi di nuovo il livello sorgente e seleziona il campo.
I metadati restituiti dal servizio possono includere:
- Nomi visualizzati e identificatori
- Tipi di geometria
- Campi attributi e tipi di dati
- Estensioni spaziali
- Numero massimo di record
- Supportava filtraggio, ordinamento, paginazione e capacità temporali
Le opzioni di configurazione disponibili possono variare tra i servizi perché Fabric Maps utilizza le funzionalità pubblicizzate da ogni endpoint.
Query di origine
Prima di aggiungere un feature layer a una mappa, puoi configurare una query di sorgente che limiti i record e i campi recuperati dal servizio remoto. Elaborare una query sul server può ridurre la quantità di dati trasferiti a Fabric Maps e concentrare il livello sulle funzionalità rilevanti per il tuo scenario.
I campi e gli operatori disponibili in una query sorgente dipendono dal protocollo selezionato e dalle capacità pubblicizzate dal servizio. Le query sorgente supportano la selezione del campo di output e possono supportare il filtraggio temporale. Fabric Maps interpreta i valori data/ora come UTC nel formato RFC 3339.
Fabric Maps valida la query rispetto al servizio selezionato. Se un campo, un valore o un operatore non è supportato, l'esperienza di configurazione mostra un errore che puoi usare per rivedere la query.
Non puoi tornare all'interfaccia utente della query di origine per modificare la query dopo aver aggiunto il livello. Per utilizzare condizioni diverse della query di origine, aggiungi di nuovo il layer di origine e configura una nuova query.
Fabric Maps ricava automaticamente un riquadro di delimitazione dall'area visibile della mappa quando richiede gli elementi. Il riquadro di delimitazione non è visibile né configurabile nell'interfaccia utente della query di origine. Gli utenti non possono inserire coordinate o selezionare un'area come condizione di query spaziale.
Query di origine e filtri dei livelli della mappa
Le query sorgente e i filtri a livello mappa limitano i dati in diverse fasi:
| Behavior | Query di origine | Filtro a livello cartografico |
|---|---|---|
| Dove viene valutato | Dal servizio di funzionalità remote | In base all'esperienza del livello Fabric Maps |
| Che cosa controlla | I record e i campi recuperati dal servizio | Quali caratteristiche recuperate sono visualizzate sulla mappa |
| Condizioni disponibili | Dipende dal protocollo e dalle capacità del servizio | Dipende dal tipo di campo e dal supporto al filtraggio di Fabric Maps |
| Come vengono applicati i cambiamenti | Configura l'interrogazione quando aggiungi il feature layer | Applica il filtro dall'esperienza di filtraggio dei livelli |
Usa una query di origine per ridurre i dati richiesti dal servizio remoto. Usa un filtro per il livello cartografico quando i costruttori di mappe o gli osservatori devono affinare interattivamente i dati restituiti. Per maggiori informazioni sui filtri a livello mappato, vedi Filtraggio dei dati in Fabric Maps.
I livelli di servizio di funzionalità esterni supportano filtri categorico, di intervallo numerico, booleani e di livello cartografico data/ora. Più filtri utilizzano la logica AND. I filtri bloccati, il comportamento in modalità modifica e visualizzazione e la persistenza dei filtri funzionano allo stesso modo tra i livelli WFS, OGC API - Features e Esri Feature Service.
Paginazione e limiti di risultato
I servizi di funzionalità possono limitare il numero di record restituiti in una singola risposta. Fabric Maps utilizza automaticamente la configurazione di paginazione fornita dal servizio per recuperare i risultati successivi. La paginazione è trasparente e i builder non possono configurare la dimensione della pagina o il comportamento di pagina.
Fabric Maps visualizza fino a 100.000 feature per livello. Se una query sorgente 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 il messaggio Una richiesta fallita; alcune funzionalità mancano. Aggiorna per riprovare.
Configurazione salvata
Quando salvi una mappa, Fabric Maps preserva la configurazione del livello esterno, incluso:
- Informazioni di riferimento sulla connessione
- Layer o collezione di funzionalità selezionate
- Query di origine
- Campi di output selezionati
- Stile a strati e leggenda
- Visibilità
- Ordine dei livelli
Quando riapri la mappa, Fabric Maps usa la configurazione salvata per recuperare e renderizzare il livello.
I livelli duplicati fanno riferimento alla stessa origine dati, connessione, query di origine e campi di output selezionati. I filtri a livello mappa e le impostazioni visive sono indipendenti per ogni duplicato. 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
Fabric Maps offre due azioni di aggiornamento in modalità modifica:
- Aggiorna una connessione nelle Fonti Esterne 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.
- Aggiorna l'elemento della mappa per interrogare i livelli salvati per i dati attuali. Questa azione non cambia la query del codice sorgente salvato.
Gli utenti non possono aggiornare i dati esterni dei servizi di funzionalità in questa versione. I campi di output salvati, lo stile, le legende, la visibilità e l'ordine dei layer persistono dopo un aggiornamento.
Autenticazione e accesso
I servizi di funzionalità esterni possono richiedere credenziali oltre ai permessi necessari per aprire o modificare una mappa Fabric.
| 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, utilizzare token come nome del parametro chiave API.
Fabric memorizza le credenziali nella connessione cloud. I visualizzatori non hanno bisogno che la connessione condivisa con loro sia separatamente per visualizzare i dati esterni. Se Fabric Maps non riesce a recuperare credenziali di connessione valide o a raggiungere il servizio, mostra un errore che indica che il servizio non è stato raggiungibile.
Servizi feature esterni e servizi di immagini
I servizi di caratteristiche esterne restituiscono geometrie e attributi vettoriali. I servizi WMS e WMTS restituiscono immagini raster o tile renderizzate. Scegli il tipo di sorgente che corrisponde ai dati e alle interazioni richieste dalla tua mappa.
| Servizi di funzionalità esterne | Servizi di immagini WMS e WMTS |
|---|---|
| Restituisci caratteristiche e attributi vettoriali individuali | Restituire immagini renderizzate o tasselli di immagine |
| Query di funzionalità e attributi di supporto | Renderizza le immagini per un'area richiesta |
| Supporta lo stile vettoriale, le etichette, gli tooltip e le interazioni basate sui dati | Supporta la visibilità, l'ordine e l'opacità delle immagini |
| Rappresenta punti, linee e poligoni | Rappresentare immagini raster |
Per informazioni sulle immagini esterne, vedi Creare livelli usando sorgenti di immagini WMS e WMTS in Fabric Maps.
Considerazioni specifiche per protocollo
WFS
- Scopri i livelli disponibili nelle funzionalità del servizio.
- Usa WFS versione 1.0.0, 1.1.0 o 2.0.0.
- Quando il servizio pubblicizza più versioni supportate, Fabric Maps utilizza l'ultima versione.
- Il servizio WFS deve supportare le risposte GeoJSON.
- Supporta risposte a geometria mista in un unico livello.
API OGC - Caratteristiche
- Organizza i dati disponibili in raccolte.
- Le operazioni avanzate di attributo e temporali dipendono dalle classi di conformità pubblicizzate dal servizio.
- Supporta risposte a geometria mista in un unico livello.
- Fabric Maps utilizza solo le funzionalità supportate dall'endpoint selezionato.
Feature Service di Esri
- Il livello selezionato deve supportare l'output GeoJSON.
- Non supportare risposte a geometria mista.
- Fabric Maps accetta geometrie con valori di coordinate M o Z e ignora le dimensioni aggiuntive.
Limitazioni e considerazioni
- L'integrazione con servizi di funzionalità esterne è di sola lettura. L'acquisizione, la modifica delle funzionalità e la riscrittura non sono supportate.
- Le funzionalità di query dipendono dalle funzionalità 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, i gateway dati locali, i gateway dati di rete virtuale e altre opzioni di rete privata gestita non sono supportati.
- La disponibilità e i tempi di risposta alle query dipendono dal servizio remoto e dalla connessione di rete.
Passaggi successivi
Per le opzioni di stile, vedi Personalizza una mappa.