Serviço de localização de mapas do interior (versão prévia)

Artigo
07/18/2024

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 serviço de localização do Criador de Mapas do Azure permite que você navegue de um lugar para outro em qualquer lugar dentro do mapa do interior. O serviço utiliza escadas e elevadores para navegar entre os andares e fornece diretrizes para ajudar a navegar por obstruções físicas. Este artigo descreve como gerar um caminho de um ponto de partida para um ponto de destino em um mapa do interior de exemplo.

Pré-requisitos

Noções básicas sobre os Conceitos do criador.
Um conjunto de dados e conjunto de peças do Criador de Mapas do Azure.

Importante

Este artigo usa a URL geográfica us.atlas.microsoft.com. Se seu serviço Criador não tiver sido criado no Estados Unidos, use uma URL geográfica diferente. Para saber mais, confira Acesso aos serviços de Criador.
Nos exemplos de URL neste artigo, você precisará:
- Substitua {Your-Azure-Maps-Subscription-key} pela sua chave de assinatura primária do Azure Mapas.
- Substituir {datasetId} por seu datasetId.

Criar um conjunto de rotas

Um conjunto de rotas é uma coleção de dados de mapa do interior que é usado pelo serviço de localização.

Um conjunto de rotas é criado a partir de um conjunto de dados. O conjunto de rotas é independente do conjunto de dados, o que significa que, se o conjunto de dados for excluído, o conjunto de rotas continuará a existir.

Depois de criar um conjunto de rotas, você pode usar a API de localização para obter um caminho do ponto de partida para o ponto de destino dentro da instalação.

Para criar um conjunto de rotas:

Execute a seguinte solicitação HTTP POST:

https://us.atlas.microsoft.com/routesets?api-version=2023-03-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Subscription-key}

Copie o valor da chave Operation-Location do cabeçalho de resposta.

A chave Operation-Location é a URL de status utilizada para verificar o status da criação do conjunto de rotas, conforme demonstrado na próxima seção.

Verifique o status de criação do conjunto de rotas e recupere a routesetId

Para verificar o status do processo da criação do conjunto de rotas e recuperar a routesetId:

Execute a seguinte solicitação HTTP GET:
```
https://us.atlas.microsoft.com/routesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key} 
```
Observação

Obtenha o operationId da chave Operation-Location no cabeçalho de resposta ao criar um novo conjunto de rotas.
Copie o valor da chave Resource-Location do cabeçalho de respostas. É o URL de localização do recurso e contém o routesetId:

https://us.atlas.microsoft.com/routesets/**675ce646-f405-03be-302e-0d22bcfe17e8**?api-version=2023-03-01-preview

Anote routesetId. É obrigatório em todas as solicitações de wayfinding e quando você Obtém a ID da instalação.

Obter a ID da instalação

O facilityId, uma propriedade do conjunto de rotas, é um parâmetro necessário ao pesquisar um caminho de localização. Obtenha o facilityId consultando o conjunto de rotas.

Execute a seguinte solicitação HTTP GET:

https://us.atlas.microsoft.com/routesets/{routesetId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

O facilityId é uma propriedade do objeto facilityDetails, que você pode encontrar no corpo da resposta da solicitação do conjunto de rotas, que é FCL43 no exemplo a seguir:

{
    "routeSetId": "675ce646-f405-03be-302e-0d22bcfe17e8",
    "dataSetId": "eec3825c-620f-13e1-b469-85d2767c8a41",
    "created": "10/10/2022 6:58:32 PM +00:00",
    "facilityDetails": [
        {
            "facilityId": "FCL43",
            "levelOrdinals": [
                0,
                1
            ]
        }
    ],
    "creationMode": "Wall",
    "ontology": "facility-2.0"
}

Obter um caminho de localização

Use a API de wayfinding para gerar um caminho a partir do conjunto de rotas que você criou na seção anterior. A API de localização necessita de uma consulta que contenha pontos de início e de término em um mapa do interior com números ordinais de nível do chão. Para obter mais informações sobre a localização do Criador, consulte Localização no artigo conceitos.

Para criar uma consulta de localização:

Execute a seguinte solicitação HTTP GET (substitua {routesetId} pela routesetId obtida na seção Verificar o status de criação do conjunto de rotas e {facilityId} pela facilityId obtida na seção Obter a ID da instalação):
```
https://us.atlas.microsoft.com/wayfinding/path?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}&routesetid={routeset-ID}&facilityid={facility-ID}&fromPoint={lat,lon}&fromLevel={from-level}&toPoint={lat,lon}&toLevel={to-level}&minWidth={minimun-width}
```
Dica

O parâmetro AvoidFeatures pode ser usado para especificar algo para o serviço de localização evitar ao determinar o caminho, como elevadores ou escadas.
Os detalhes do caminho e dos segmentos são exibidos no Corpo da resposta.

O resumo exibe o tempo estimado de viagem em segundos para o percurso total. Além disso, o tempo estimado para cada seção do percurso é exibido no início de cada segmento.

O serviço de localização calcula o caminho por meio de pontos de intervenção específicos. Cada ponto é exibido, junto aos seus detalhes de latitude e longitude.

Compartilhar via