Wayfinding-tjänsten för inomhuskartor (förhandsversion)

  • Artikel

Med Azure Kartor Creator-tjänsten för wayfinding kan du navigera från plats till plats var som helst i din inomhuskarta. Tjänsten använder trappor och hissar för att navigera mellan våningar och ger vägledning som hjälper dig att navigera runt fysiska hinder. I den här artikeln beskrivs hur du genererar en sökväg från en startpunkt till en målpunkt på en inomhuskarta för exempel.

Förutsättningar

Viktigt!

  • Den här artikeln använder den us.atlas.microsoft.com geografiska URL:en. Om din Creator-tjänst inte skapades i USA måste du använda en annan geografisk URL. Mer information finns i Åtkomst till Creator-tjänster.
  • I URL-exemplen i den här artikeln måste du:
    • Ersätt {Your-Azure-Maps-Subscription-key} med din Azure Kartor-prenumerationsnyckel.
    • Ersätt {datasetId} med .datasetId Mer information finns i avsnittet Kontrollera status för att skapa datamängd i självstudiekursen Använd skapare för att skapa inomhuskartor .

Skapa en routningsuppsättning

En routningsuppsättning är en samling inomhuskartdata som används av wayfinding-tjänsten.

En routningsuppsättning skapas från en datauppsättning. Routningsuppsättningen är oberoende av datauppsättningen, vilket innebär att om datamängden tas bort fortsätter routningsuppsättningen att finnas.

När du har skapat en routningsuppsättning kan du sedan använda wayfinding-API:et för att hämta en sökväg från startpunkten till målpunkten i anläggningen.

Så här skapar du en routningsuppsättning:

  1. Kör följande HTTP POST-begäran:

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

  2. Kopiera värdet för nyckeln Operation-Location från svarshuvudet.

Nyckeln Operation-Location är status-URL:en som används för att kontrollera statusen för skapandet av routningsuppsättningen, vilket visas i nästa avsnitt.

Kontrollera statusen för att skapa routningsuppsättningen och hämta routesetId

Så här kontrollerar du statusen för processen för att skapa routningsuppsättningen och hämtar routesetId:

  1. Kör följande HTTP GET-begäran:

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

    Kommentar

    operationId Hämta från nyckeln Operation-Location i svarshuvudet när du skapar en ny routningsuppsättning.

  2. Kopiera värdet för resursplatsnyckeln från svarshuvudet. Det är resursplats-URL:en och innehåller routesetId:

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

Anteckna routesetId. Det krävs i all wayfinding-begäranden och när du hämtar anläggnings-ID:t.

Hämta anläggnings-ID:t

Egenskapen facilityId, en egenskap för routningsuppsättningen, är en obligatorisk parameter när du söker efter en sökväg för wayfinding. facilityId Hämta genom att fråga routningsuppsättningen.

  1. Kör följande HTTP GET-begäran:

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

  2. facilityId är en egenskap för facilityDetails objektet som du kan hitta i svarstexten för routeset-begäran, som finns FCL43 i följande exempel:

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

Hämta en vägfinieringssökväg

Använd wayfinding-API:et för att generera en sökväg från routningsuppsättningen som du skapade i föregående avsnitt. Wayfinding-API:et kräver en fråga som innehåller start- och slutpunkter på en inomhuskarta, tillsammans med ordningstal på golvnivå. Mer information om creator wayfinding finns i wayfinding i begreppsartikeln.

Så här skapar du en wayfinding-fråga:

  1. Kör följande HTTP GET-begäran (ersätt {routesetId} med routesetId som hämtas i avsnittet Kontrollera status för att skapa routningsuppsättningen och {facilityId} med facilityId som hämtats i avsnittet Hämta anläggnings-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}

    Dricks

    Parametern AvoidFeatures kan användas för att ange något för wayfinding-tjänsten att undvika när du bestämmer sökvägen, till exempel hissar eller trappor.

  2. Information om sökvägen och benen visas i svarets brödtext.

Sammanfattningen visar den uppskattade restiden i sekunder för den totala resan. Dessutom visas den uppskattade tiden för varje del av resan i början av varje etapp.

Wayfinding-tjänsten beräknar sökvägen genom specifika mellanliggande punkter. Varje punkt visas tillsammans med dess latitud- och longitudinformation.