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

  • Artigo

O serviço de wayfinding do Azure Maps Creator permite que você navegue de um lugar para outro em qualquer lugar dentro do seu mapa interno. 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

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 . Para obter mais informações, consulte a seção Verificar o status de criação do conjunto de dados do tutorial Usar o criador para criar mapas internos.

Criar um conjunto de rotas

Um conjunto de rotas é uma coleção de dados de mapas internos 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:

  1. 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}

  2. 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:

  1. 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.

  2. 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 consultando o facilityId conjunto de rotas.

  1. 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}

  2. O facilityId é uma propriedade do objeto, que você pode encontrar no corpo de resposta da solicitação do facilityDetails 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 de 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:

  1. Execute a seguinte solicitação HTTP GET (substitua {routesetId} pelo routesetId obtido na seção Check the routeset creation status e o {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.

  2. 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.