Indoor maps wayfinding service (preview)

Artikel
09/25/2024

Notitie

Buitengebruikstelling van Azure Maps Creator

De indoor kaartservice van Azure Maps Creator is nu afgeschaft en wordt buiten gebruik gesteld op 30-9-25. Zie einde levensduuraankondiging van Azure Maps Creator voor meer informatie.

Met de wayfinding-service van Azure Maps Creator kunt u overal in uw indoorkaart navigeren. De service maakt gebruik van trappen en liften om tussen de verdiepingen te navigeren en biedt hulp bij het navigeren door fysieke obstakels. In dit artikel wordt beschreven hoe u een pad genereert van een beginpunt naar een bestemmingspunt in een voorbeeld van een indoorkaart.

Vereisten

Inzicht in de concepten van Creator.
Een Azure Maps Creator-gegevensset en -tegelset.

Belangrijk

In dit artikel wordt de us.atlas.microsoft.com geografische URL gebruikt. Als uw Creator-service niet is gemaakt in de Verenigde Staten, moet u een andere geografische URL gebruiken. Zie Access to Creator-services voor meer informatie.
In de URL-voorbeelden in dit artikel moet u het volgende doen:
- Vervang door {Your-Azure-Maps-Subscription-key} uw Azure Maps-abonnementssleutel.
- Vervang {datasetId} door uw datasetId.

Een routeset maken

Een routeset is een verzameling indoorkaartgegevens die door de wayfinding-service worden gebruikt.

Er wordt een routeset gemaakt op basis van een gegevensset. De routeset is onafhankelijk van de gegevensset, wat betekent dat als de gegevensset wordt verwijderd, de routeset blijft bestaan.

Zodra u een routeset hebt gemaakt, kunt u de wayfinding-API gebruiken om een pad op te halen van het beginpunt naar het doelpunt binnen de faciliteit.

Een routeset maken:

Voer de volgende HTTP POST-aanvraag uit:

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

Kopieer de waarde van de sleutel Operation-Location uit de antwoordheader.

De sleutel Operation-Location is de status-URL die wordt gebruikt om de status van het maken van de routeset te controleren, zoals wordt weergegeven in de volgende sectie.

Controleer de status van het maken van de routeset en haal de routesetId op

De status van het proces voor het maken van de routeset controleren en de routesetId ophalen:

Voer de volgende HTTP GET-aanvraag uit:
```
https://us.atlas.microsoft.com/routesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key} 
```
Notitie

Haal de operationId opdracht op uit de sleutel Operation-Location in de antwoordheader bij het maken van een nieuwe routeset.
Kopieer de waarde van de sleutel Resource-Location uit de antwoordheader. Dit is de LOCATIE-URL van de resource en bevat het routesetIdvolgende:

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

Noteer de waarde van routesetId. Het is vereist in alle wayfinding aanvragen en wanneer u de faciliteit-id krijgt.

De faciliteit-id ophalen

De facilityIdeigenschap , een eigenschap van de routeset, is een vereiste parameter bij het zoeken naar een wayfinding-pad. Haal het facilityId op door een query uit te voeren op de routeset.

Voer de volgende HTTP GET-aanvraag uit:

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

De facilityId eigenschap is een eigenschap van het facilityDetails object, die u kunt vinden in de hoofdtekst van de routeset-aanvraag, in FCL43 het volgende voorbeeld:

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

Een wegwijspad ophalen

Gebruik de wayfinding-API om een pad te genereren op basis van de routeset die u in de vorige sectie hebt gemaakt. Voor de wayfinding-API is een query vereist die begin- en eindpunten bevat in een indoorkaart, samen met rangnummernummers op basisniveau. Zie wayfinding in het artikel concepten voor meer informatie over wayfinding van Creator.

Een wayfinding-query maken:

Voer de volgende HTTP GET-aanvraag uit (vervang {routesetId} door de routesetId die is verkregen in de sectie De status van het maken van de routeset en de {facilityId} controleren met de facilityId die is verkregen in de sectie De faciliteit-id ophalen):
```
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}
```
Tip

De AvoidFeatures parameter kan worden gebruikt om iets op te geven voor de wayfinding-service om te vermijden bij het bepalen van het pad, zoals liften of trappen.
De details van het pad en de benen worden weergegeven in de hoofdtekst van het antwoord.

In de samenvatting wordt de geschatte reistijd weergegeven in seconden voor het totale traject. Bovendien wordt de geschatte tijd voor elke sectie van het traject weergegeven aan het begin van elk been.

De wayfinding-service berekent het pad via specifieke tussenliggende punten. Elk punt wordt weergegeven, samen met de breedte- en lengtegraaddetails.

Delen via