Indoor maps wayfinding service (preview)

  • Artikel

Met de azure Kaarten Creator-wayfinding-service kunt u overal binnen uw indoorkaart navigeren vanaf de plaats waar u zich bevindt. 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 Kaarten Creator-gegevensset en -tegelset. Als u Azure Kaarten Creator nog nooit hebt gebruikt om een indoorkaart te maken, is de zelfstudie Over indoorkaarten misschien handig.

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 Kaarten-abonnementssleutel.
    • Vervang {datasetId} door uw datasetId. Zie de sectie De status van de gegevensset controleren van de zelfstudie Creator gebruiken voor het maken van indoorkaarten voor meer informatie.

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:

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

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

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

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

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

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

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

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