Beltéri térképek wayfinding szolgáltatás (előzetes verzió)

  • Cikk

Az Azure Térképek Creator wayfinding szolgáltatással bárhonnan navigálhat a beltéri térképen. A szolgáltatás lépcsőket és lifteket használ a padlók közötti navigáláshoz, és útmutatást nyújt a fizikai akadályok közötti navigáláshoz. Ez a cikk bemutatja, hogyan hozhat létre elérési utat a kiindulási ponttól a célpontig egy beltéri mintatérképen.

Előfeltételek

  • A Létrehozó fogalmainak megértése.
  • Azure Térképek Creator-adatkészlet és csempék. Ha még soha nem használta az Azure Térképek Creatort beltéri térkép létrehozására, hasznosnak találhatja a Használati létrehozót a beltéri térképek létrehozásához.

Fontos

  • Ez a cikk a us.atlas.microsoft.com földrajzi URL-címet használja. Ha a Létrehozó szolgáltatás nem a Egyesült Államok lett létrehozva, más földrajzi URL-címet kell használnia. További információ: Access to Creator services.
  • A cikkben szereplő URL-példákban a következőkre lesz szüksége:
    • Cserélje le {Your-Azure-Maps-Subscription-key} az Azure Térképek előfizetési kulcsára.
    • Cserélje le {datasetIda } elemet a datasetIdsaját helyére. További információ: Az adathalmaz létrehozása állapotának ellenőrzése a Beltéri térképek létrehozása a létrehozó használatával című oktatóanyagban.

Útvonalkészlet létrehozása

Az útvonalkészlet a wayfinding szolgáltatás által használt beltéri térképadatok gyűjteménye.

Egy útvonalkészlet egy adatkészletből jön létre. Az útvonalkészlet független az adathalmaztól, ami azt jelenti, hogy ha az adathalmazt törlik, az útvonalkészlet továbbra is létezik.

Miután létrehozott egy útvonalkészletet, a wayfinding API használatával lekérheti a kiindulási ponttól a létesítményen belüli célpontig vezető útvonalat.

Útvonalkészlet létrehozása:

  1. Hajtsa végre a következő HTTP POST-kérést:

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

  2. Másolja ki az Operation-Location kulcs értékét a válaszfejlécből.

A műveleti hely kulcs az útvonalkészlet létrehozásának állapotának ellenőrzéséhez használt állapot URL-cím, ahogyan azt a következő szakaszban is bemutatjuk.

Ellenőrizze az útvonalkészlet létrehozásának állapotát, és kérje le az routesetId azonosítót

Az útvonalkészlet-létrehozási folyamat állapotának ellenőrzéséhez és a routesetId lekéréséhez:

  1. Hajtsa végre a következő HTTP GET-kérést:

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

    Megjegyzés:

    Új útvonalkészlet létrehozásakor szerezze be az operationId Operation-Location billentyűt a válaszfejlécben.

  2. Másolja ki az erőforrás-hely kulcs értékét a válaszok fejlécéből. Ez az erőforrás helyének URL-címe, és a routesetIdkövetkezőket tartalmazza:

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

Jegyezze fel a routesetId. A kérések minden esetben kötelezőek, és amikor lekéri a létesítmény azonosítóját.

A létesítmény azonosítójának lekérése

Az facilityIdútvonalkészlet tulajdonsága egy útválasztási útvonal keresésekor kötelező paraméter. Kérje le az facilityId útvonalkészlet lekérdezésével.

  1. Hajtsa végre a következő HTTP GET-kérést:

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

  2. Az facilityId objektum tulajdonsága facilityDetails , amelyet az útvonalkészlet-kérelem választörzsében talál, amely az alábbi példában található FCL43 :

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

Útdefiniálási útvonal lekérése

A wayfinding API használatával hozzon létre egy útvonalat az előző szakaszban létrehozott útvonalkészletből. A wayfinding API-hoz egy olyan lekérdezésre van szükség, amely egy beltéri térkép kezdő- és végpontjaival, valamint a padlószintű sorszámokkal együtt tartalmazza a végpontokat. A létrehozói útfinanszírozással kapcsolatos további információkért tekintse meg a wayfindinget a fogalmakról szóló cikkben.

Útkereső lekérdezés létrehozása:

  1. Hajtsa végre a következő HTTP GET-kérést (cserélje le a(z) {routesetId} elemet az útvonalkészlet létrehozási állapotának ellenőrzése szakaszban beszerzett routesetId azonosítóra, a {facilityId} pedig a létesítményazonosító lekérése szakaszban beszerzett facilityId azonosítóra):

    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}

    Tipp.

    A AvoidFeatures paraméter használatával megadhat valamit a wayfinding szolgáltatás számára, amely elkerülhető az útvonal meghatározásakor, például liftek vagy lépcsők.

  2. Az elérési út és a lábak részletei megjelennek a válasz törzsében.

Az összegzés a teljes utazás becsült utazási idejét jeleníti meg másodpercekben. Ezenkívül az egyes szakaszok becsült ideje az egyes szakaszok elején jelenik meg.

A wayfinding szolgáltatás kiszámítja az elérési utat adott beavatkozó pontokon keresztül. Minden pont megjelenik a szélességi és hosszúsági adatokkal együtt.