Compartilhar via

Trabalhar com conjuntos de dados usando o plug-in QGIS

Observação

Desativação do Criador do Azure Mapas

O serviço de mapa do interior do Criador do Azure Mapas foi preterido e será desativado em 30/09/25. Para obter mais informações, confira Comunicado de fim de vida útil do Criador do Azure Mapas.

O QGIS é um aplicativo GIS (sistema de informações geográficas) de software livre que dá suporte à exibição, edição e análise de dados geoespaciais.

O plug-in QGIS do Azure Mapas é usado para exibir e editar conjuntos de dados no QGIS. Ele permite que você navegue pelos pisos usando um seletor de piso personalizado e execute operações CRUD para vários recursos simultaneamente. Todas as funcionalidades do QGIS, como copiar recursos, girar, redimensionar, inverter, podem ser usadas na edição avançada. O plug-in também dá suporte ao tratamento de erros para edição de dados. Os logs criados pelo plug-in são úteis para entender as APIs e os erros de depuração.

Pré-requisitos

Introdução

Esta seção fornece informações sobre como instalar o QGIS e o plug-in QGIS do Azure Mapas e, em seguida, como abrir e exibir um conjunto de dados.

Instalar o QGIS

Se você ainda não tiver o QGIS instalado, consulte Baixar QGIS. Você pode usar a versão mais recente, no entanto, é recomendável usar a versão mais estável, que pode ser encontrada na mesma página, selecionando "Procurando a versão mais estável?".

Captura de tela mostrando a página de download do QGIS com Procurando a versão mais estável contornado em vermelho.

Instalar o plug-in QGIS do Azure Mapas

Para instalar o plug-in QGIS do Azure Mapas:

  1. Selecione Gerenciar e Instalar Plug-ins no menu Plug-ins para abrir o Gerenciador de Plug-ins.

  2. Na caixa de diálogo que é aberta, selecione o plug-in Azure Mapas e, em seguida, o Instalar plugin:

Uma captura de tela mostrando instalar plugin no QGIS.

Para obter instruções detalhadas sobre como instalar um plug-in no QGIS, consulte Instalando novos plug-ins na documentação do QGIS.

Depois que o plug-in estiver instalado, o símbolo do AzureMaps será exibido na barra de ferramentas de plug-ins.

Uma captura de tela mostrando o símbolo do plug-in QGIS do Azure Mapas na barra de ferramentas do QGIS.

Trabalhando com conjuntos de dados no plug-in QGIS

Seu conjunto de dados do Azure Mapas contém os dados que descrevem o mapa interno. Um conjunto de dados consiste em camadas que definem um edifício. Cada camada contém entradas chamadas recursos. Cada recurso é uma linha no conjunto de dados. Um recurso geralmente tem uma geometria associada a ele. Cada geometria consiste em um conjunto de propriedades que a descrevem.

Um featureClass é uma coleção de recursos semelhantes. Um edifício tem instalações e classes de recursos de nível, contendo recursos como salas e móveis. Por exemplo, um edifício tem uma instalação featureClass, que contém recursos de instalação. Ele também tem níveis featureClass que definem os níveis do edifício, cada nível é um recurso com seu próprio conjunto de propriedades que descrevem esse nível. Outro featureClass poderia ser móveis, com cada móvel individual descrito como uma característica do featureClass com seu próprio conjunto único de propriedades.

Abrir conjunto de dados

As etapas a seguir descrevem como abrir o conjunto de dados no QGIS usando o plug-in QGIS do Azure Mapas.

  1. Selecione o símbolo do Azure Mapas na barra de ferramentas do QGIS para abrir a caixa de diálogo plug-in do Azure Mapas.

    Captura de tela mostrando a barra de ferramentas no QGIS com o botão do Azure Mapas destacado.

  2. Selecione sua localização, Estados Unidos ou Europa, na lista suspensa Geografia.

  3. Insira sua chave de assinatura.

  4. Para obter uma lista de todas as IDs do conjunto de dados associadas à sua conta do Azure Mapas, selecione o botão Listar Conjuntos de Dados.

  5. Selecione o datasetId desejado na lista suspensa DatasetId .

  6. (Opcional) Altere o local onde os logs são salvos se você não quiser que eles sejam salvos no local padrão.

    Uma captura de tela mostrando a caixa de diálogo plug-in do Azure Mapas.

  7. Selecione o botão Obter Recursos para carregar seus dados de mapa interno no QGIS. Uma vez carregado, seu mapa aparece na tela Mapa.

    Uma captura de tela mostrando o produto QGIS com o mapa do interior.

Exibir conjunto de dados

Depois que o conjunto de dados for carregado, você poderá exibir as diferentes classes de recursos que ele contém no painel Camadas. A ordenação das camadas determina como os recursos são mostrados no mapa; as camadas em uma ordem mais alta na lista são exibidas na parte superior.

Algumas camadas têm uma lista suspensa contendo várias camadas dentro dela, seguidas pela geometria da camada, como mostra a imagem a seguir:

Uma captura de tela mostrando um conjunto de dados com a seção camadas do QGIS.

Isso acontece quando a definição de camada mostra que a camada pode conter recursos de geometrias diferentes. Como o QGIS dá suporte a apenas uma geometria por camada, o plugin divide essas camadas por suas geometrias possíveis.

Observação

A geometria geometryCollection não tem suporte do QGIS.

Você pode navegar para um piso diferente usando a lista suspensa Nível na barra de ferramentas de plug-ins, localizada ao lado do símbolo do plug-in Azure Mapas, conforme mostrado na imagem a seguir:

Uma captura de tela mostrando o menu suspenso de seleção de nível conforme aparece na barra de ferramentas do plug-in.

Editar o conjunto de dados

Você pode adicionar, editar e excluir os recursos do conjunto de dados usando o QGIS.

Dica

Você usará a barra de ferramentas de digitalização ao editar os recursos do conjunto de dados no QGIS. Para obter mais informações, consulte Digitalizando uma camada existente.

Adicionar recursos

As adições de conjunto de dados envolvem a adição de recursos a uma camada.

  1. No painel Camadas, selecione a camada à qual você deseja adicionar o novo recurso.

  2. Alterne o modo de edição para on na barra de ferramentas de digitalização. Para exibir a barra de ferramentas de digitalização, navegue até Exibir > Barra de Ferramentas > Digitalizando Barra de Ferramentas.

    Uma captura de tela mostrando o modo de edição na barra de ferramentas de digitalização.

  3. Selecione qualquer opção de adicionar recurso na barra de ferramentas de digitalização e faça as alterações desejadas.

  4. Selecione o botão Salvar na barra de ferramentas de digitalização para salvar as alterações

    Uma captura de tela mostrando o botão salvar alterações na barra de ferramentas de digitalização.

Editar recursos

As edições de conjunto de dados envolvem a edição de geometrias e propriedades de recursos.

Editar uma geometria de recurso

  1. No painel Camadas, selecione a camada que contém o recurso que você deseja editar.

  2. Alterne o modo de edição para on na barra de ferramentas de digitalização.

  3. Selecione a ferramenta Vértice na barra de ferramentas de digitalização.

    Uma captura de tela mostrando o botão ferramenta Vértice na barra de ferramentas de digitalização.

  4. Quando terminar as alterações, selecione o botão Salvar na barra de ferramentas de digitalização.

Editar uma propriedade de recurso

Para editar uma propriedade de recurso usando a tabela de atributos

  1. Abra a tabela de atributos da camada que contém o recurso que você deseja editar.

    Captura de tela mostrando a tabela de atributo.

    Observação

    A tabela de atributos mostra cada recurso, com suas propriedades, em um formato tabular. Clique com o botão direito do mouse para acessar qualquer camada no painel Camadas e selecione Abrir Tabela de Atributos.

  2. Ativar/desativar o modo de edição.

  3. Edite a propriedade desejada.

  4. Clique no botão salvar para salvar a política.

Excluir conjuntos de recursos

  1. Selecione o recurso que deseja excluir.

  2. Selecione a opção excluir recurso na barra de ferramentas de digitalização.

    Uma captura de tela mostrando a opção excluir recurso na barra de ferramentas de digitalização.

  3. Selecione o botão salvar na barra de ferramentas de digitalização para salvar as alterações.

Edição avançada

Para saber mais sobre os recursos de edição antecipada oferecidos no QGIS, como mover, dimensionar, copiar e girar recursos, consulte Digitalização avançada na Documentação do QGIS.

Logs

Informações de logs do plug-in QGIS do Azure Mapas relacionadas às solicitações feitas ao Azure Mapas. Você pode definir o local do arquivo de log na caixa de diálogo do plug-in Azure Mapas. Por padrão, os arquivos de log são armazenados na pasta que contém o plug-in baixado.

Uma captura de tela da caixa de diálogo do plug-in QGIS do Azure Mapas com a seção de logs destacada.

Você pode exibir seus arquivos de log de duas maneiras:

  1. QGIS. Você pode exibir os Logs no QGIS ativando o Painel de Mensagens de Logs:

    Uma captura de tela do painel de mensagens de logs.

Os logs contêm:

  • Informações sobre solicitações de servidor e resposta.
  • Erros recebidos do servidor ou do QGIS.
  • Estatísticas sobre o número de recursos carregados

Logs de erros para edições

Os logs de erros para edições também são armazenados em uma pasta separada chamada "AzureMaps_ErrorLogs". Eles contêm informações mais detalhadas sobre a solicitação feita, incluindo cabeçalhos e corpo, e a resposta recebida do servidor.

Logs de Python

Todos os erros recebidos da estrutura QGIS são exibidos na guia Logs de Python .

Informações adicionais

Se tiver dúvidas relacionadas ao Azure Mapas, confira o Microsoft Q&A. Certifique-se de marcar suas perguntas com "Azure Mapas".