Criador de mapas internosCreator for indoor maps

Este artigo apresenta conceitos e ferramentas que se aplicam ao Criador do Azure Mapas.This article introduces concepts and tools that apply to Azure Maps Creator. Recomendamos que você leia este artigo antes de começar a usar a API e o SDK do Criador do Azure Mapas.We recommend that you read this article before you begin to use the Azure Maps Creator API and SDK.

Você pode usar o Criador para desenvolver aplicativos com recursos de mapa baseados em dados de mapas internos.You can use Creator to develop applications with map features based on indoor map data. Este artigo descreve o processo de carregar, converter, criar e usar seus dados de mapa.This article describes the process of uploading, converting, creating, and using your map data. Todo o fluxo de trabalho é ilustrado no diagrama a seguir.The entire workflow is illustrated in the diagram below.

Fluxo de trabalho de dados de mapa do Criador

Criar o Criador do Azure MapasCreate Azure Maps Creator

Para usar seus serviços, o Criador do Azure Mapas precisará ser criado em uma conta do Azure Mapas.To use Creator services, Azure Maps Creator must be created in an Azure Maps account. Para obter informações sobre como criá-lo no Azure Mapas, confira Gerenciar o Criador do Azure Mapas.For information on how to create Azure Maps Creator in Azure Maps, see Manage Azure Maps Creator.

Carregar um pacote do DrawingUpload a Drawing package

O Criador coleta dados de mapas internos pela conversão de um pacote do Drawing carregado.Creator collects indoor map data by converting an uploaded Drawing package. O pacote do Drawing representa um recurso construído ou modelado.The Drawing package represents a constructed or remodeled facility. Para obter informações sobre os requisitos de pacotes do Drawing, confira os Requisitos do pacote do Drawing.For information on Drawing package requirements, see Drawing package requirements.

Use a API de carregamento de dados do Azure Mapas para carregar um pacote do Drawing.Use the Azure Maps Data Upload API to upload a Drawing package. Após o upload bem-sucedido, a API de carregamento de dados retornará um identificador de dados do usuário (udid).Upon a successful upload, the Data Upload API will return a user data identifier (udid). O udid será usado na próxima etapa para converter o pacote carregado em dados de mapa interno.The udid will be used in the next step to convert the uploaded package into indoor map data.

Converter um pacote do DrawingConvert a Drawing package

O serviço de Conversão do Azure Mapas converte um pacote do Drawing carregado em dados de mapa interno.The Azure Maps Conversion service converts an uploaded Drawing package into indoor map data. O serviço de Conversão também valida o pacote.The Conversion service also validates the package. Os problemas de validação são classificados em dois tipos: erros e avisos.Validation issues are classified into two types: errors and warnings. Se forem detectados erros, o processo de conversão apresentará falha.If any errors are detected, the conversion process fails. Caso sejam detectados avisos, a conversão será bem-sucedida.Should warnings be detected, the conversion will succeed. No entanto, é recomendável que você analise e resolva todos os avisos.However, it's recommended that you review and resolve all warnings. Um aviso indica que parte da conversão foi ignorada ou corrigida automaticamente.A warning means that part of the conversion was ignored or automatically fixed. Não resolver os avisos pode resultar em erros em processos futuros.Failing to resolve the warnings could result in errors in latter processes. Para obter mais informações, confira Avisos e erros do pacote do Drawing.For more information, see Drawing package warnings and errors.

Quando ocorre um erro, o serviço de Conversão fornece um link para o Visualizador de Erros de Desenho no Azure Mapas aplicativo Web autônomo.When an error occurs, the Conversion service provides a link to the Azure Maps Drawing Error Visualizer stand-alone web application. Você pode usar o Visualizador de Erros de Desenho para inspecionar erros e avisos do pacote do Drawing ocorridos durante o processo de conversão.You can use the Drawing Error Visualizer to inspect Drawing package warnings and errors that occurred during the conversion process. Depois de corrigir os erros, você poderá tentar carregar e converter o pacote.Once you have fixed the errors, you can then attempt to upload and convert the package.

Criar dados de mapa internoCreate indoor map data

O Criador do Azure Mapas fornece três serviços:Azure Maps Creator provides three services:

  • Serviço de conjunto de dados.Dataset service. Use o serviço de conjunto de dados para criar um conjunto de dados de um pacote do Drawing convertido.Use the Dataset service to create a dataset from a converted Drawing package data.
  • Serviço de conjunto de peças.Tileset service. Use o serviço de conjunto de peças para criar uma representação de um conjunto de dados baseada em vetor.Use the Tileset service to create a vector-based representation of a dataset. Os aplicativos podem usar um conjunto de peças para apresentar uma exibição do conjunto de dados baseada em peças visuais.Applications can use a tileset to present a visual tile-based view of the dataset.
  • Serviço de estado do recurso. Use o serviço de Estado do recurso para dar suporte ao estilo de mapa dinâmico.Feature State service.Use the Feature State service to support dynamic map styling. O estilo de mapa dinâmico permite que os aplicativos reflitam eventos em tempo real em espaços fornecidos pelo sistema de IoT.Dynamic map styling allows applications to reflect real-time events on spaces provided by IoT system.

Conjunto de dadosDatasets

Um conjunto de dados é uma coleção de recursos de mapa interno.A dataset is a collection of indoor map features. Os recursos de mapa interno representam instalações definidas em um pacote do Drawing convertido.The indoor map features represent facilities defined in a converted Drawing package. Depois de criar um conjunto de dados com o Serviço de conjunto de dados, você pode criar vários conjunto de peças ou conjuntos de estados do recurso.After creating a dataset with the Dataset service, you can create any number of tilesets or feature statesets.

O Serviço de conjunto de dados permite aos desenvolvedores adicionar ou remover instalações de um conjunto de dados a qualquer momento.The Dataset service allows developers, at any time, to add or remove facilities to an existing dataset. Para obter mais informações sobre como atualizar um conjunto de dados usando a API, confira as opções de acréscimo no Serviço de conjunto de dados.For more information on how to update an existing dataset using the API, see the append options in Dataset service. Para obter um exemplo de como atualizar um conjunto de dados, confira Manutenção de Dados.For an example of how to update a dataset, see Data Maintenance.

Conjuntos de peçasTilesets

Um conjunto de peças é uma coleção de dados de vetor que representa um conjunto de blocos de grade uniformes.A tileset is a collection of vector data that represents a set of uniform grid tiles. Os desenvolvedores podem usar o Serviço de conjunto de peças para criar conjuntos de peças oriundos de um conjunto de dados.Developers can use the Tileset service to create tilesets from a dataset.

Para refletir as diferentes fases de conteúdo, você poderá criar vários conjuntos de peças usando o mesmo conjunto de dados.To reflect different content stages, you can create multiple tilesets from the same dataset. Por exemplo, você poderia criar um conjunto de peças com mobília e equipamento e outro sem mobília e equipamento.For example, you could make one tileset with furniture and equipment, and another tileset without furniture and equipment. Você pode optar por gerar um conjunto de peças com as atualizações de dados mais recentes e outra sem as atualizações de dados mais recentes.You might choose to generate one tileset with the most recent data updates, and one without the most recent data updates.

Além dos dados de vetor, o conjunto de peças fornece metadados para da renderização do mapa.In addition to the vector data, the tileset provides metadata for map rendering optimization. Por exemplo, os metadados do conjunto de peças contêm níveis de zoom mínimo e máximo para o conjunto de peças.For example, tileset metadata contains a min and max zoom level for the tileset. Os metadados também oferecem uma caixa delimitadora que define a extensão geográfica do conjunto de peças.The metadata also provides a bounding box defining the geographic extent of the tileset. A caixa delimitadora permite que um aplicativo defina o ponto central correto programaticamente.The bounding box allows an application to programmatically set the correct center point. Para obter mais informações sobre metadados de conjunto de peças, confira API de lista do conjunto de peças.For more information about tileset metadata, see Tileset List API.

Depois que um conjunto de peças é criado, ele pode ser recuperado pelo serviço Render V2.Once a tileset has been created, it can be retrieved by the Render V2 service.

Se um conjunto de peças de peças ficar desatualizado e não for mais útil, você poderá excluí-lo.If a tileset becomes outdated and is no longer useful, you can delete the tileset. Para obter mais informações sobre como excluir os conjuntos de peças, confira Manutenção de dados.For more information on how to delete tilesets, see Data Maintenance.

Observação

Um conjunto de peças é independente em relação ao conjunto de dados que o criou.A tileset is independent of the dataset from which it was created. Se você criar os conjuntos de peças com um conjunto de dados e, em seguida, atualizar esse conjunto de dados, os conjuntos de peças não serão atualizados.If you create tilesets from a dataset, and then subsequently update that dataset, the tilesets will not be updated. Para refletir as alterações em um conjunto de dados, você precisará criar novos conjuntos de peças.To reflect changes in a dataset, you must create new tilesets. Da mesma forma, se você excluir um conjunto de peças, o conjunto de dados não será afetado.Similarly, if you delete a tileset, the dataset will not be affected.

Conjuntos de estados do recursoFeature statesets

Os conjuntos de estados do recurso são coleções de propriedades dinâmicas (estados) atribuídas a recursos de conjunto de dados, como salas ou equipamentos.Feature statesets are collections of dynamic properties (states) assigned to dataset features such as rooms or equipment. Um exemplo de um estado pode ser temperatura ou ocupação.An example of a state could be temperature or occupancy. Cada estado é um par chave/valor que contém o nome da propriedade, o valor e o carimbo de data/hora da última atualização.Each state is a key/value pair containing the name of the property, the value, and the timestamp of the last update.

O serviço de Estado do Recurso permite que você crie e gerencie um conjunto de estados de recurso para um conjunto de dados.The Feature State service lets you create and manage a feature stateset for a dataset. O conjunto de estados do recurso é definido por um ou mais estados.The stateset is defined by one or more states. Cada recurso, como uma sala, pode ter um estado anexado a ele.Each feature, such as a room, can have one state attached to it.

O valor de cada estado em um conjunto de estados pode ser atualizado ou recuperado por dispositivos IoT ou outros aplicativos.The value of each state in a stateset can be updated or retrieved by IoT devices or other applications. Por exemplo, usando a API de Atualização de Estado de Recurso, os dispositivos que medem a ocupação de um espaço podem, de forma sistemática, postar a alteração do estado de uma sala.For example, using the Feature State Update API, devices measuring space occupancy can systematically post the state change of a room.

Um aplicativo pode usar um conjunto de estados do recurso para renderizar dinamicamente recursos em uma instalação de acordo com seu estado atual e o respectivo estilo do mapa.An application can use a feature stateset to dynamically render features in a facility according to their current state and respective map style. Para obter mais informações sobre como usar os conjuntos de estados do recurso para definir o estilo dos recursos em um mapa de renderização, confira o Módulo de SDK da Web interno.For more information on using feature statesets to style features in a rendering map, see Indoor Web SDK Module.

Observação

Assim como nos conjuntos de peças, a alteração de um conjunto de dados não afetará o estado do recurso existente, e a exclusão de um conjunto de estados do recurso não terá nenhum efeito sobre o conjunto de recursos ao qual ele está anexado.Like tilesets, changing a dataset does not affect the existing feature stateset and deleting a feature stateset will have no effect on the dataset to which it is attached.

Usando mapas internosUsing indoor maps

Serviço Render V2Render V2 service

O serviço Render V2 – API de obtenção de peça de mapa do Azure Mapas foi estendido para dar suporte a conjuntos de peças do Criador.The Azure Maps Render V2 service-Get Map Tile API has been extended to support Creator tilesets.

O serviço Render V2 – API de obtenção de estado de mapa permite que os aplicativos solicitem conjuntos de peças.Render V2 service-Get Map State Tile API allows applications to request tilesets. Os conjuntos de peças poderão ser integrados a um controle de mapa ou SDK.The tilesets can then be integrated into a map control or SDK. Para obter um exemplo de um controle de mapa que use o serviço Render V2, confira o Módulo de mapas internos.For an example of a map control that uses the Render V2 service, see Indoor Maps Module.

API do Web Feature ServiceWeb Feature Service API

Os conjuntos de dados podem ser consultados por meio da API do WFS (Web Feature Service).Datasets can be queried using the Web Feature Service (WFS) API. O WFS segue os recursos de API do Open Geospatial Consortium.WFS follows the Open Geospatial Consortium API Features. A API do WFS permite consultar recursos dentro do próprio conjunto de dados.The WFS API lets you query features within the dataset itself. Por exemplo, você pode usar o WFS para localizar todas as salas de reunião de tamanho médio de um determinado local e piso.For example, you can use WFS to find all mid-size meeting rooms of a given facility and floor level.

Módulo de mapas internosIndoor Maps module

O SDK da Web do Azure Mapas inclui o Módulo de mapas internos.The Azure Maps Web SDK includes the Indoor Maps module. Esse módulo oferece funcionalidades estendidas para a biblioteca de Controle de Mapa do Azure Mapas.This module offers extended functionalities to the Azure Maps Map Control library. O Módulo de mapas internos renderiza mapas internos criados no Criador.The Indoor Maps module renders indoor maps created in Creator. Ele integra widgets como seletor de piso, o que permite que os usuários visualizem vários pisos.It integrates widgets such as floor picker, which helps users visualize the different floors.

O Módulo de mapas internos permite que você crie aplicativos Web que integram dados de mapas internos a outros serviços do Azure Mapas.The Indoor Maps module allows you to create web applications that integrate indoor map data with other Azure Maps services. As configurações de aplicativo mais comuns podem incluir a adição de conhecimento de outros mapas, como estradas, imagens, clima e trânsito, aos mapas internos.The most common application setups could include adding knowledge to indoor maps from other maps such as road, imagery, weather, and transit.

O Módulo de mapas internos também dá suporte ao estilo de mapa dinâmico.The Indoor Maps module also supports dynamic map styling. Para obter instruções passo a passo sobre como implementar estilos dinâmicos de conjunto de estados de recurso em um aplicativo, confira Como usar o Módulo de mapa internoFor a step-by-step walk-through on how to implement feature stateset dynamic styling in an application, see How to Use the Indoor Map Module

Integração com o Azure MapasAzure Maps integration

Ao começar a desenvolver soluções para mapas internos, você poderá descobrir maneiras de integrar os recursos do Azure Mapas.As you begin to develop solutions for indoor maps, you can discover ways to integrate existing Azure Maps capabilities. Por exemplo, o acompanhamento de ativos ou cenários de segurança podem ser implementados pela API de Cerca Geográfica do Azure Mapas com mapas internos do Criador.For example, asset tracking or safety scenarios could be implemented by using the Azure Maps Geofence API with Creator indoor maps. A API de Cerca Geográfica poderia ser usada para determinar, por exemplo, se um trabalhador entrou ou saiu de áreas internas específicas.The Geofence API could be used to determine, for example, whether a worker enters or leaves specific indoor areas. Encontre mais informações sobre como conectar o Azure Mapas à telemetria de IoT aqui.For more information on how to connect Azure Maps with IoT telemetry is available here.

Manutenção de dadosData Maintenance

A API de lista, atualização e exclusão do Criador do Azure Mapas permite listar, atualizar e excluir seus conjuntos de dados, de peças e de estados do recurso.Azure Maps Creator List, Update, and Delete API allows you to list, update, and delete your datasets, tilesets, and feature statesets.

Observação

Sempre que você analisar uma lista de itens e decidir excluí-los, deverá considerar o impacto dessa exclusão em todas as APIs ou aplicativos dependentes.Whenever you review a list of items and decide to delete them, you must consider the impact of that deletion on all dependent API or applications. Por exemplo, se você excluir um conjunto de peças que está sendo usado por um aplicativo por meio do Render v2 – API de obtenção de peça de mapa, a exclusão desse conjunto de peças resultará em uma falha de aplicativo na sua renderização.For example, if you should delete a tileset that is currently being used by an application by means of the Render V2 - Get Map Tile API, deleting that tileset would result in an application failure to render that tileset.

Exemplo: atualizando um conjunto de dadosExample: Updating a dataset

O exemplo a seguir mostra como atualizar um conjunto de dados, criar um conjunto de peças e excluir um conjunto de peças antigo.The following example shows you how to update a dataset, create a new tileset, and delete an old tileset.

  1. Siga as etapas nas seções Carregando um pacote do Drawing e Converter um pacote do Drawing para carregar e converter o novo pacote do Drawing.Follow steps in the Upload a Drawing package and Convert a Drawing package sections to upload and convert the new Drawing package.

  2. Use a API de criação de conjunto de dados para acrescentar os dados convertidos ao conjunto de dados.Use the Dataset Create API to append the converted data to the existing dataset.

  3. Use a API de criação de conjunto de peças para gerar um conjunto de peças com o conjunto de dados atualizado.Use the Tileset Create API to generate a new tileset out of the updated dataset. Salve o identificador do novo conjunto de peças para a etapa 4.Save the new tilesetId for step 4.

  4. Atualize o identificador do conjunto de peças em seu aplicativo para habilitar a visualização do conjunto de dados do campus atualizado.Update the tileset identifier in your application to enable the visualization of the updated campus dataset. Se o conjunto de peças anterior não for mais usado, você poderá excluí-lo.If the old tileset is no longer in use, you can delete it.

Próximas etapasNext steps