Serviço de wayfinding de mapas interiores (pré-visualização)

Artigo
09/25/2024

Nota

Aposentadoria do Azure Maps Creator

O serviço de mapa interno do Azure Maps Creator foi preterido e será desativado em 30/09/25. Para obter mais informações, consulte Anúncio de fim da vida útil do Azure Maps Creator.

O serviço de wayfinding do Azure Maps Creator permite-lhe navegar de um local para outro em qualquer lugar dentro do seu mapa interior. O serviço utiliza escadas e elevadores para navegar entre os andares e fornece orientação para ajudá-lo a navegar em torno de obstruções físicas. Este artigo descreve como gerar um caminho de um ponto de partida para um ponto de destino em um mapa interno de exemplo.

Pré-requisitos

Compreensão dos conceitos do Criador.
Um conjunto de dados e um conjunto de mosaicos do Azure Maps Creator.

Importante

Este artigo usa o us.atlas.microsoft.com URL geográfico. Se o serviço Creator não tiver sido criado nos Estados Unidos, você deverá usar um URL geográfico diferente. Para obter mais informações, consulte Acesso aos serviços do Criador.
Nos exemplos de URL neste artigo, você precisará:
- Substitua {Your-Azure-Maps-Subscription-key} pela sua chave de subscrição do Azure Maps.
- Substitua {datasetId} pelo seu datasetIdarquivo .

Criar um conjunto de rotas

Um conjunto de rotas é uma coleção de dados de mapa interno que é usada pelo serviço de localização de caminhos.

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 wayfinding para obter um caminho do ponto inicial ao 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 da resposta.

A chave Operation-Location é a URL de status usada 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 o routesetId

Para verificar o status do processo de criação do conjunto de rotas e recuperar o 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}

Nota

Obtenha a operationId 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 das respostas. É o URL do local 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 o routesetId. É necessário em todos os sentidosencontrar solicitações e quando você obtém o ID do recurso.

Obter o ID da instalação

O facilityId, uma propriedade do conjunto de rotas, é um parâmetro obrigatório ao procurar um caminho de localização de caminhos. 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 facilityDetails objeto, que você pode encontrar no corpo de resposta da solicitação do conjunto de rotas, que está 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"
}

Obtenha um caminho para encontrar caminhos

Use a API wayfinding para gerar um caminho a partir do conjunto de rotas criado na seção anterior. A API wayfinding requer uma consulta que contenha pontos iniciais e finais em um mapa interno, juntamente com números ordinais no nível do piso. Para obter mais informações sobre o Creator wayfinding, consulte wayfinding no artigo de conceitos.

Para criar uma consulta wayfinding:

Execute a seguinte solicitação HTTP GET (substitua {routesetId} pelo routesetId obtido na seção Check the routeset creation status e {facilityId} pelo facilityId obtido na seção Get the facility ID):
```
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}
```
Gorjeta

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

O resumo apresenta o tempo de viagem estimado, em segundos, para a viagem total. Além disso, o tempo estimado para cada seção da viagem é exibido no início de cada trecho.

O serviço de wayfinding calcula o caminho através de pontos intervenientes específicos. Cada ponto é exibido, juntamente com seus detalhes de latitude e longitude.

Partilhar via