Condividi tramite

Configurare QGIS per accedere a una risorsa GeoCatalog

Questa guida illustra come configurare il software GIS desktop QGIS open source per accedere ai set di dati geospaziali da Microsoft Planetary Computer Pro GeoCatalog usando l'autenticazione microsoft Entra ID.

QGIS consente l'interazione diretta con le raccolte STAC in Microsoft Planetary Computer Pro. Con QGIS è possibile visualizzare, analizzare e definire lo stile dei dati in tempo reale e integrarli con i livelli locali di Azure.

Tutti gli asset GeoCatalog possono essere scaricati sul desktop. Gli asset nel formato Cloud Optimized GeoTIFF (COG) o Cloud Optimized Point Cloud (COPC) vengono trasmessi direttamente in streaming.

La configurazione è costituita da due parti:

La registrazione dell'applicazione Microsoft Entra è un'attività monouso per il tenant. Dopo la registrazione, gli utenti immettono l'ID applicazione (client) e l'ID directory (tenant) in QGIS per configurare la connessione STAC.

Prerequisiti

Registrazioni dell'app Microsoft Entra

  • Accesso a un tenant di Microsoft Entra ID
  • Sottoscrizione di Azure in cui l'identità ha uno di questi ruoli: Sviluppatore di applicazioni, Amministratore applicazioni cloud o Amministratore applicazioni.

Connessione STAC QGIS

  • Scaricare e installare QGIS 4.0+
  • Lettore GeoCatalog o Amministratore GeoCatalog con controllo degli accessi in base al ruolo.
  • Distribuzione di un GeoCatalog di Computer Planetario Pro di Microsoft contenente almeno una raccolta.

Registrare l'applicazione Microsoft Entra per QGIS

Suggerimento

Per informazioni generali sulla registrazione dell'app, vedere Registrare un'applicazione in Microsoft Entra ID .

Registrare QGIS come applicazione in Microsoft Entra ID e concedere le autorizzazioni delegate in modo che possa agire per conto dell'utente connesso.

Nel portale di Azure passare a Microsoft Entra ID > Registrazioni app > Nuova registrazione:

Screenshot della pagina Registrazioni app con il pulsante Nuova registrazione evidenziato.

Registrare l'applicazione

  1. Immettere un nome descrittivo per l'applicazione.
  2. Per i tipi di account supportati, selezionare l'opzione tenant usata dall'organizzazione (solo tenant singolo o multi-tenant).
  3. In URI di reindirizzamento scegliere Client pubblico/nativo (mobile e desktop) e impostare l'URI su http://localhost:7070.
  4. Seleziona Registra.
    Screenshot del modulo di registrazione della nuova app con i campi nome, tipo di account e URI di reindirizzamento compilati.

Configurare le autorizzazioni dell'API

Configurare le autorizzazioni dell'API delegate:

  1. Nella registrazione dell'app selezionare Autorizzazioni> APIAggiungi un'autorizzazione.

    Screenshot del pannello Autorizzazioni API che elenca le autorizzazioni delegate correnti.

  2. Selezionare API usate dall'organizzazione, cercare Azure Orbital Spatioe selezionare il servizio per aprire la finestra di dialogo delle autorizzazioni.

    Screenshot della finestra di dialogo di selezione delle autorizzazioni con l'API Spatio di Azure Orbital evidenziata.

  3. In Richiedi autorizzazioni API selezionare Autorizzazioni delegate, controllare user_impersonation e quindi selezionare Aggiungi autorizzazioni per concedere l'ambito.

    Schermata della finestra di dialogo Richiedi permessi API con l'ambito di delega user_impersonation selezionato.

Revisione dell’ID applicazione e dell’ID directory

Torna a Panoramica e registra l'ID applicazione (client) e l'ID directory (tenant). È necessario immetterli in QGIS in un secondo momento per configurare la connessione STAC.

Screenshot della pagina di panoramica con i valori ID applicazione (client) e ID directory (tenant) visualizzati.

Configurare QGIS per l'accesso GeoCatalog

Un catalogo STAC in QGIS è un'origine dati esplorabile. Espone metadati STAC gerarchici (raccolta → raccolta → elemento → asset) anziché un singolo file statico. Quando si espandono i nodi, QGIS invia richieste API live all'endpoint STAC GeoCatalog, in modo da visualizzare sempre le raccolte e gli elementi più recenti nel GeoCatalog.

Creare la connessione STAC

Creare la connessione STAC all'interno di QGIS seguendo questa procedura:

  1. Nel pannello Browser espandere STAC per visualizzare il menu di connessione.
  2. Fare clic con il pulsante destro del mouse su STAC e scegliere Nuova connessione STAC per aprire la finestra di dialogo di configurazione. Screenshot del menu di scelta rapida del pannello del browser QGIS con Nuova Connessione STAC selezionata.

Configurare l'autenticazione della connessione STAC

  1. Nel campo "Nome" denominare la connessione.
  2. Immettere l'URL di GeoCatalog e aggiungere il percorso dell'API STAC aggiungendo /stac all'URL.
  3. Selezionare il pulsante più (+) per configurare l'autenticazione. Screenshot della finestra di dialogo di connessione STAC che mostra il campo URL e il pulsante di autenticazione.

Configurazione dell'autenticazione della connessione STAC

  1. In Autenticazione selezionare Microsoft Planetary Computer. Screenshot dell'elenco dei profili di autenticazione con Microsoft Planetary Computer selezionato.

  2. Selezionare Planetary Computer Pro nell'elenco a discesa "Tipo di server". Screenshot dell'elenco dei tipi di server di autenticazione con Planetary Computer Pro selezionato.

  3. Immettere le informazioni seguenti nelle caselle di testo:

Screenshot delle impostazioni di autenticazione STAC complete con gli ID client e tenant specificati.

Al termine di queste impostazioni, geoCatalog viene configurato per l'accesso tramite la connessione STAC QGIS.

Uso della connessione STAC QGIS

Per esplorare le raccolte, selezionare il tuo GeoCatalog nel navigatore dei livelli dati, poi espanderlo.

Una volta espansa, QGIS reindirizzerà l'utente a un Web browser per l'autenticazione con Microsoft Entra. Completare il processo di autenticazione dell'organizzazione per continuare.

Screenshot del pannello QGIS Browser che mostra l'albero delle raccolte Planetary Computer Pro.

Suggerimento

Se geoCatalog ha zero raccolte STAC, viene visualizzato un Host requires authentication errore. Per risolvere questo errore, creare una raccolta STAC.

Continuare ad espandere le raccolte fino a individuare un elemento STAC. Per visualizzare questo elemento, selezionare l'elemento e trascinarlo nella visualizzazione mappa. Se i dati sono un Cloud Optimized GeoTIFF (COG) o Cloud Optimized Point Cloud (COPC), vengono importati e proiettati automaticamente nella mappa.

Screenshot della visualizzazione mappa che mostra un elemento STAC aggiunto a QGIS.

Ricerca e filtro STAC

Se si desidera cercare dati o eseguire un filtro STAC nel catalogo, l'API STAC viene esposta tramite gestione livelli.

  1. Nel menu Layer, selezionare Aggiungi Livello>Aggiungi Livello dal catalogo STAC. Screenshot della finestra di dialogo Aggiungi layer dal catalogo STAC aperta in QGIS.

  2. Selezionare la connessione STAC a GeoCatalog e quindi selezionare Connetti. Screenshot della Gestione delle origini dati che mostra la connessione STAC configurata prima dell'interrogazione.

  3. Scegliere l'indice in base al quale filtrare. È possibile filtrare in base all'extent spaziale, temporale o di raccolta. Screenshot della finestra di dialogo di query STAC con un filtro di estensione spaziale applicato.

  4. Seleziona l'elemento per aggiungerlo all'estensione della mappa o scaricare le risorse direttamente sul computer locale. Se si passa il puntatore del mouse sull'elemento, l'estensione spaziale viene visualizzata in rosso sulla tela della mappa. Screenshot della selezione di asset COG pronte per essere aggiunte come livello in QGIS.

Contenuti correlati

  • Last updated on