Servicio de orientación de Indoor Maps (versión preliminar)

  • Artículo

El servicio de orientación de Azure Maps Creator le permite navegar desde un lugar a otro en cualquier lugar con su plano interior. El servicio utiliza escaleras y ascensores para navegar entre plantas y proporciona orientación para ayudarle a sortear obstáculos físicos. En este artículo se describe cómo generar una ruta de acceso desde un punto de partida a un punto de destino en un plano interior de ejemplo.

Requisitos previos

Importante

  • En este artículo, se usa la dirección URL geográfica us.atlas.microsoft.com. Si el servicio Creator no se creó en la Estados Unidos, debe usar una dirección URL geográfica diferente. Para más información, consulte Acceso a los servicios de Creator.
  • En los ejemplos de direcciones URL de este artículo deberá:

Creación de un conjunto de rutas

Un conjunto de rutas es una colección de datos de un plano interior utilizados por el servicio de orientación.

Un conjunto de rutas se crea a partir de un conjunto de datos. El conjunto de rutas es independiente del conjunto de datos, lo que significa que si se elimina el conjunto de datos, el conjunto de rutas continúa existiendo.

Una vez que haya creado un conjunto de rutas, puede usar la API del servicio de orientación para obtener una ruta de acceso desde el punto de partida hasta el punto de destino dentro de las instalaciones.

Para crear un conjunto de rutas:

  1. Ejecute la siguiente solicitud 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 el valor de la clave Operation-Location del encabezado de respuesta.

La clave Operation-Location es la URL de estado utilizada para verificar el estado de la creación del conjunto de rutas, como se muestra en la siguiente sección.

Compruebe el estado de creación del conjunto de rutas y recupere routesetId.

Para comprobar el estado del proceso de creación del conjunto de mosaicos y recuperar routesetId:

  1. Ejecute la siguiente solicitud HTTP GET:

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

    Nota

    Obtenga el valor de operationId de la clave Operation-Location del encabezado de respuesta al crear un nuevo conjunto de rutas.

  2. Copie el valor de la clave Resource-Location del encabezado de respuestas. Es la URL de ubicación del recurso y contiene routesetId:

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

Anote el routesetId. Se requiere en todas las solicitudes de orientación y cuando obtienes la identificación de la instalación.

Obtención del identificador de las instalaciones

facilityId, la propiedad del conjunto de rutas, es un parámetro necesario al buscar una ruta de acceso de orientación. Para obtener facilityId, consulte el conjunto de rutas.

  1. Ejecute la siguiente solicitud HTTP GET:

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

  2. facilityId es una propiedad del objeto facilityDetails, que puede encontrar en el cuerpo de respuesta de la solicitud del conjunto de rutas, que es FCL43 en el ejemplo siguiente:

{
    "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"
}

Obtención de una ruta de orientación

Usa la API de orientación para generar una ruta a partir del conjunto de rutas que creaste en la sección anterior. La API del servicio de orientación requiere una consulta que contenga puntos iniciales y finales en un plano interior, junto con números ordinales del nivel de planta. Para obtener más información sobre el servicio de orientación de Creator, consulte orientación en el artículo sobre conceptos.

Para crear una consulta de orientación:

  1. Ejecute la siguiente solicitud HTTP GET (reemplace {routesetId} por el valor routesetId obtenido en la sección Comprobación del estado de creación del conjunto de rutas y {facilityId} por el valor de facilityId obtenido en la sección Obtención del identificador de las instalaciones):

    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}

    Sugerencia

    El parámetro AvoidFeatures se puede usar para especificar que el servicio de orientación evite algo al determinar la ruta (por ejemplo, ascensores o escaleras).

  2. Los detalles de la ruta y los tramos se muestran en el cuerpo de la respuesta.

El resumen muestra el tiempo de desplazamiento estimado en segundos para el recorrido total. Además, el tiempo estimado para cada sección del recorrido se muestra al principio de cada tramo.

El servicio de orientación calculará la ruta a través de puntos intermedios específicos. Se mostrará cada punto junto con su información de latitud y longitud.