Configurar o QGIS para aceder a um recurso GeoCatalog

Este guia explica como configurar o software SIG desktop QGIS de código aberto para aceder a conjuntos de dados geoespaciais a partir do Microsoft Planetary Computer Pro GeoCatalog utilizando a autenticação Microsoft Entra ID.

O QGIS permite a interação direta com coleções STAC no Microsoft Planetary Computer Pro. Com o QGIS, você pode visualizar, analisar e estilizar dados instantaneamente e integrá-los com camadas locais do Azure.

Todos os ativos do GeoCatalog podem ser baixados para sua área de trabalho. Os ativos no formato Cloud Optimized GeoTIFF (COG) ou Cloud Optimized Point Cloud (COPC) são transmitidos diretamente.

A configuração consiste em duas partes:

Registrar o aplicativo Microsoft Entra é uma tarefa única para seu locatário. Após o registo, os utilizadores inserem o ID da Aplicação (cliente) e o ID do Diretório (inquilino) no QGIS para configurar a ligação STAC.

Pré-requisitos

Registos da aplicação Microsoft Entra

  • Acesso a um locatário do Microsoft Entra ID
  • Subscrição do Azure em que a sua identidade tem uma destas funções: Programador de Aplicações, Administrador de Aplicações na Nuvem ou Administrador de Aplicações.

Ligação QGIS STAC

Registar a aplicação Microsoft Entra para QGIS

Sugestão

Consulte Registrar um aplicativo no Microsoft Entra ID para obter informações básicas sobre o registro do aplicativo.

Registe o QGIS como uma aplicação no Microsoft Entra ID e conceda-lhe permissões delegadas para que possa agir em nome do utilizador com sessão iniciada.

No portal do Azure, vá para Registros do > aplicativo Microsoft Entra ID > Novo registro:

Captura de ecrã da página Registos da aplicação com o botão Novo registo realçado.

Registar a candidatura

  1. Insira um nome descritivo para o aplicativo.
  2. Para tipos de conta suportados, selecione a opção de locatário que sua organização usa (somente locatário único ou multilocatário).
  3. Em Redirecionar URI, escolha Cliente público/nativo (móvel ou desktop) e defina o URI como http://localhost:7070.
  4. Selecione Registar.
    Captura de ecrã do formulário de registo de nova app com os campos de nome, tipo de conta e URI de redirecionamento preenchidos.

Configurar permissões de API

Configure permissões de API delegadas:

  1. No registro do aplicativo, selecione Permissões> de APIAdicionar uma permissão.

    Captura de tela da folha de permissões da API listando as permissões delegadas atuais.

  2. Selecione APIs que minha organização usa, pesquise Azure Orbital Spatioe escolha o serviço para abrir a caixa de diálogo de permissão.

    Captura de ecrã da caixa de diálogo de seleção de permissões com a API do Azure Orbital Spatio realçada.

  3. Em Solicitar permissões de API, selecione Permissões delegadas, marque user_impersonation e selecione Adicionar permissões para conceder o escopo.

    Captura de ecrã da caixa de diálogo para solicitação de permissões da API, com o âmbito delegado

Revisão das IDs de aplicativo e diretório

Retorne para Visão geral e registre a ID do aplicativo (cliente) e a ID do diretório (locatário). Você precisa inseri-los no QGIS mais tarde para configurar a conexão STAC.

Captura de tela da página Visão geral exibindo os valores ID do aplicativo (cliente) e ID do diretório (locatário).

Configurar o QGIS para acesso ao GeoCatalog

Um catálogo STAC no QGIS é uma fonte de dados navegável. Ele expõe metadados STAC hierárquicos (catálogo → coleção → item → ativo) em vez de um único arquivo estático. Quando o utilizador expande os nós, o QGIS executa solicitações de API em tempo real para o endpoint STAC do GeoCatalog, garantindo assim que veja sempre as coleções e itens mais recentes no seu GeoCatalog.

Criar a conexão STAC

Crie a ligação STAC dentro do QGIS seguindo estes passos:

  1. No painel Navegador , expanda STAC para exibir o menu de conexão.
  2. Clique com o botão direito do mouse em STAC e selecione Nova conexão STAC para abrir a caixa de diálogo de configuração. Captura de ecrã do menu de contexto do painel Navegador QGIS com Nova Ligação STAC selecionada.

Configurar autenticação de conexão STAC

  1. No campo "Nome", nomeie essa conexão.
  2. Insira o URL do seu GeoCatalog e adicione o caminho da API STAC anexando /stac ao URL.
  3. Selecione o botão de adição (+) para configurar a autenticação. Captura de ecrã da caixa de diálogo de ligação STAC a mostrar o campo URL e o botão de autenticação.

Configuração de autenticação de conexão STAC

  1. Em Autenticação, selecione Microsoft Planetary Computer. Captura de ecrã da lista de perfis de autenticação com o Microsoft Planetary Computer selecionado.

  2. Selecione Planetary Computer Pro na lista suspensa "Tipo de servidor". Captura de ecrã da lista de tipos de servidor de autenticação com Planetary Computer Pro selecionado.

  3. Insira as seguintes informações nas caixas de texto:

Captura de ecrã das definições de autenticação STAC concluídas com IDs de cliente e inquilino preenchidas.

Quando estas definições estiverem concluídas, o seu GeoCatalog é configurado para acesso através da ligação QGIS STAC.

Utilizar a ligação QGIS STAC

Para navegar pelas coleções, selecione seu GeoCatalog no navegador da camada de dados e expanda-o.

Depois de expandir, o QGIS irá redirecioná-lo para um navegador da Web para se autenticar com o Microsoft Entra. Conclua o processo de autenticação para que sua organização continue.

Captura de ecrã do painel QGIS Browser a apresentar a árvore de coleções Planetary Computer Pro.

Sugestão

Se o seu GeoCatalog tiver zero Coleções STAC, você verá um Host requires authentication erro. Para resolver esse erro, crie uma coleção STAC.

Continue a expandir as coleções até localizar um item STAC. Para visualizar este item, selecione-o e arraste-o para a vista de mapa. Se os dados forem um Cloud Optimized GeoTIFF (COG) ou Cloud Optimized Point Cloud (COPC), eles são automaticamente importados e projetados no mapa.

Captura de ecrã da vista de mapa a apresentar um item STAC adicionado ao QGIS.

Pesquisa e filtragem STAC

Se você quiser pesquisar dados ou executar um filtro STAC em seu catálogo, a API STAC será exposta por meio do gerenciador de camadas.

  1. No menu Camada , selecione Adicionar camada>Adicionar camada do catálogo STAC. Captura de tela da caixa de diálogo Adicionar camada do catálogo STAC aberta no QGIS.

  2. Selecione sua conexão STAC com o GeoCatalog e, em seguida, selecione Conectar. Captura de tela do Gerenciador de Fonte de Dados mostrando a conexão STAC configurada antes da consulta.

  3. Escolha o índice no qual deseja filtrar. Você pode filtrar por extensão espacial, temporal ou de coleta. Captura de ecrã da caixa de diálogo de consulta STAC com um filtro de extensão espacial aplicado.

  4. Selecione o item para adicioná-lo à extensão do mapa ou baixe os ativos diretamente para sua máquina local. Se você passar o mouse sobre o item, a extensão espacial será visualizada na tela do mapa em vermelho. Captura de tela da seleção de ativos COG pronta para adicionar como uma camada no QGIS.

Conteúdo relacionado

  • Last updated on