Configurar o QGIS para acessar um recurso do GeoCatalog

Este guia explica como configurar o software GIS de desktop de código aberto QGIS para acessar conjuntos de dados geoespaciais do GeoCatalog do Computador Planetário Pro da Microsoft usando a autenticação do Microsoft Entra ID.

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

Todos os ativos do GeoCatalog podem ser baixados para sua área de trabalho. Ativos nos formatos COG (Cloud Optimized GeoTIFF) ou COPC (Cloud Optimized Point Cloud) 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 registro, os usuários inserem a ID do aplicativo (cliente) e a ID do diretório (locatário) no QGIS para configurar a conexão STAC.

Pré-requisitos

Registros do Aplicativo Microsoft Entra

  • Acesso a um locatário do Microsoft Entra ID
  • Assinatura do Azure em que sua identidade tem uma destas funções: Desenvolvedor de Aplicativos, Administrador de Aplicativos na Nuvem ou Administrador de Aplicativos.

Conexão QGIS STAC

Registrar o aplicativo Microsoft Entra para QGIS

Dica

Consulte Microsoft Entra ID para registrar um aplicativo para obter informações gerais sobre o registro de aplicativos.

Registre o QGIS como um aplicativo na ID do Microsoft Entra e conceda-lhe permissões delegadas para que ele possa agir em nome do usuário conectado.

No portal do Azure, acesse Microsoft Entra ID > Registros de aplicativo > Novo registro:

Captura de tela da página Registros de aplicativo com o botão Novo registro realçado.

Registrar o aplicativo

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

Configure as permissões da API

Configurar permissões de API delegada:

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

    Captura de tela da folha permissões de 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 tela da caixa de diálogo de seleção de permissão com a API do Azure Orbital Spatio realçada.

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

    Captura de tela da caixa de diálogo Solicitar permissões da API com o escopo delegado user_impersonation selecionado.

Revisando as IDs de aplicativo e diretório

Retorne à 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 a ID do aplicativo (cliente) e os valores de ID do diretório (locatário).

Configurar o QGIS para acesso ao GeoCatalog

Um catálogo STAC no QGIS é uma fonte de dados que pode ser acessada. Ele expõe metadados STAC hierárquicos (catálogo → coleção → item → ativo) em vez de um único arquivo estático. Quando você expande nódulos, o QGIS emite requisições de API ao vivo para o ponto de extremidade STAC do GeoCatalog, garantindo que você veja sempre os conjuntos de dados e itens mais recentes em seu GeoCatalog.

Criar a conexão STAC

Crie a conexão STAC dentro do QGIS seguindo estas etapas:

  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 tela do menu de contexto do painel do Navegador QGIS com Nova Conexão STAC selecionada.

Configurar a autenticação de conexão STAC

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

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

  1. Na Autenticação, selecione Computador Planetário da Microsoft. Captura de tela da lista de perfis de autenticação com o Computador Planetário da Microsoft selecionado.

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

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

Captura de tela das configurações de autenticação STAC concluídas com IDs de cliente e locatário preenchidas.

Depois que essas configurações forem concluídas, o GeoCatalog será configurado para acesso por meio da conexão QGIS STAC.

Usando a conexão QGIS STAC

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

Depois de expandir, o QGIS redirecionará você 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 tela do painel navegador QGIS exibindo a árvore de coleções do Planetry Computer Pro.

Dica

Se o 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 esse item, selecione o item e arraste-o para o modo de exibição do mapa. Se os dados forem um COG (Cloud Optimized GeoTIFF) ou COPC (Cloud Optimized Point Cloud), eles serão importados e projetados automaticamente no mapa.

Captura de tela da exibição de mapa exibindo um item STAC adicionado ao QGIS.

Pesquisa e filtragem do 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 do diálogo Adicionar Camada do Catálogo STAC aberta no aplicativo QGIS.

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

  3. Escolha o índice no qual você deseja filtrar. Você pode filtrar a extensão espacial, temporal ou de coleção. Captura de tela 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 baixar os ativos diretamente no computador local. Se você passar o mouse sobre o item, a extensão espacial é exibida no 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