Service d’orientation de cartes d'intérieur (préversion)

Article
04/21/2023

Le service d’orientation Azure Maps Creator vous permet de naviguer d’un endroit à l’autre, n’importe où dans votre carte d’intérieur. Le service utilise des escaliers et des ascenseurs pour naviguer entre les étages et fournit des conseils pour vous aider à contourner les obstacles physiques. Cet article explique comment générer un chemin d’accès d’un point de départ à un point de destination dans un exemple de carte d’intérieur.

Prérequis

Compréhension des concepts de Creator.
Un jeu de données et un tileset Azure Maps Creator. Si vous n’avez jamais utilisé Azure Maps Creator pour créer une carte d'intérieur, vous trouverez peut-être le tutoriel Utiliser Creator pour créer des cartes d'intérieur utile.

Important

Cet article utilise l’URL géographique us.atlas.microsoft.com. Si votre service Creator n’a pas été créé aux États-Unis, vous devez utiliser une autre URL géographique. Pour plus d’informations, consultez Accès aux services Creator.
Dans les exemples d’URL de cet article, vous devez :
- Remplacez {Your-Azure-Maps-Subscription-key} par votre clé d’abonnement Azure Maps.
- Remplacer {datasetId par votre datasetId. Pour plus d’informations, consultez la section Vérifier l’état de création du jeu de données obtenu dans le tutoriel Utiliser Creator pour créer des cartes d'intérieur.

Créer un ensemble d’itinéraires

Un ensemble d’itinéraires est une collection de données de cartes d’intérieur utilisées par le service d’orientation.

Un jeu de routes est créé à partir d’un jeu de données. Le jeu de routes est indépendant du jeu de données, ce qui signifie que si le jeu de données est supprimé, le jeu de routes continue d’exister.

Une fois que vous avez créé un ensemble d’itinéraires, vous pouvez utiliser l’API d’orientation pour obtenir un chemin d’accès du point de départ au point de destination au sein de l’installation.

Pour créer un ensemble d’itinéraires :

Exécutez la requête HTTP POST suivante :

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

Copiez la valeur de la clé Emplacement à partir de l’en-tête de réponse.

La clé Operation-Location est l’URL d’état utilisé pour vérifier l’état de la création du jeu de routes, comme indiqué dans la section suivante.

Vérifier l’état de création de l’ensemble d’itinéraires et récupérer le routesetId

Pour vérifier l’état du processus de création de l’ensemble d’itinéraires et récupérer le routesetId :

Exécutez la requête HTTP GET suivante :
```
https://us.atlas.microsoft.com/routesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key} 
```
Notes

Obtenez le operationId à partir de la clé Opéeration-Emplacement dans l’en-tête de réponse lors de la création d’un nouvel ensemble d’itinéraires.
Copiez la valeur de la clé Ressource-Emplacement à partir de l’en-tête des réponses. Il s’agit de l’URL de l’emplacement de la ressource, qui contient l’élément routesetId:

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

Notez la valeur de routesetId. Il est requis dans toutes les demandes d’orientation et lorsque vous obtenez l’ID de l’installation.

Obtenir l’ID de l’installation

facilityId, une propriété de l’ensemble d’itinéraires, est un paramètre obligatoire lors de la recherche d’un chemin d’accès d’orientation. Obtenez le facilityId en interrogeant le jeu d’itinéraires.

Exécutez la requête HTTP GET suivante :

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

facilityId est une propriété de l’objet facilityDetails, que vous pouvez trouver dans le corps de la réponse de la demande d’ensemble d’itinéraires, qui se trouve être FCL43 dans l’exemple suivant :

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

Obtenir un chemin d’accès d’orientation

Utilisez l’API d’orientation pour générer un chemin d’accès à partir du jeu de routes que vous avez créé dans la section précédente. L’API d’orientation nécessite une requête qui contient les points de début et de fin dans une carte d’intérieur, ainsi que les nombres ordinaux au niveau de l’étage. Pour plus d’informations sur l’orientation de Creator, consultez orientation dans l’article de concepts.

Pour créer une requête d’orientation :

Exécutez la requête HTTP GET suivante (remplacez {routesetId} par le routesetId obtenu dans la section Vérifier l’état de création de l’ensemble d’itinéraires et {facilityId} par le facilityId obtenu dans la section Obtenir l’ID de l’installation) :
```
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}
```
Conseil

Le paramètre AvoidFeatures peut être utilisé pour spécifier quelque chose que le service d’orientation doit éviter lors de la détermination du chemin, comme les ascenseurs ou les escaliers.
Les détails du chemin et des sections sont affichés dans le corps de la réponse.

Le résumé affiche le temps de trajet estimé en secondes pour le trajet total. En outre, le temps estimé pour chaque section du parcours est affiché au début de chaque section.

Le service d’orientation calcule le chemin par le biais de points intermédiaires spécifiques. Chaque point est affiché, ainsi que ses détails de latitude et de longitude.

Partager via