Layanan wayfinding peta dalam ruangan (pratinjau)

  • Artikel

Layanan wayfinding Azure Peta Creator memungkinkan Anda menavigasi dari tempat ke tempat di mana saja dalam peta dalam ruangan Anda. Layanan ini menggunakan tangga dan lift untuk menavigasi antar lantai dan memberikan panduan untuk membantu Anda menavigasi di sekitar penghalang fisik. Artikel ini menjelaskan cara membuat jalur dari titik awal ke titik tujuan dalam sampel peta dalam ruangan.

Prasyarat

Penting

  • Artikel ini menggunakan URL geografis us.atlas.microsoft.com. Jika layanan Pembuat tidak dibuat di Amerika Serikat, Anda harus menggunakan URL geografis yang berbeda. Untuk informasi selengkapnya, lihat Akses ke layanan Pembuat.
  • Dalam contoh URL dalam artikel ini, Anda harus:
    • Ganti {Your-Azure-Maps-Subscription-key} dengan kunci langganan Azure Peta Anda.
    • Ganti {datasetId} dengan .datasetId Untuk informasi selengkapnya, lihat bagian Periksa status pembuatan himpunan data dari tutorial Gunakan Pembuat untuk membuat peta dalam ruangan.

Membuat set rute

Set rute adalah kumpulan data peta dalam ruangan yang digunakan oleh layanan wayfinding.

Set rute dibuat dari himpunan data. Set rute independen dari himpunan data, yang berarti jika himpunan data dihapus, set rute terus ada.

Setelah membuat set rute, Anda kemudian dapat menggunakan API wayfinding untuk mendapatkan jalur dari titik awal ke titik tujuan dalam fasilitas.

Untuk membuat set rute:

  1. Jalankan permintaan HTTP POST berikut:

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

  2. Salin nilai kunci Operation-Location dari header respons.

Kunci Lokasi Operasi adalah URL status yang digunakan untuk memeriksa status pembuatan set rute seperti yang ditunjukkan di bagian berikutnya.

Periksa status pembuatan set rute dan ambil routesetId

Untuk memeriksa status proses pembuatan set rute dan mengambil routesetId:

  1. Jalankan permintaan HTTP GET berikut:

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

    Catatan

    operationId Dapatkan dari kunci Lokasi Operasi di header respons saat membuat set rute baru.

  2. Salin nilai kunci Resource-Location dari header respons. Ini adalah URL lokasi sumber daya dan berisi routesetId:

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

Buat catatan dari routesetId. Ini diperlukan dalam semua cara menentukan permintaan dan ketika Anda Mendapatkan ID fasilitas.

Dapatkan ID fasilitas

facilityIdproperti , dari set rute, adalah parameter yang diperlukan saat mencari jalur penghalusan jalan. Dapatkan dengan mengkueri facilityId set rute.

  1. Jalankan permintaan HTTP GET berikut:

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

  2. facilityId adalah properti objekfacilityDetails, yang dapat Anda temukan di isi respons permintaan set rute, yang ada FCL43 dalam contoh berikut:

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

Mendapatkan jalur wayfinding

Gunakan API wayfinding untuk menghasilkan jalur dari set rute yang Anda buat di bagian sebelumnya. API wayfinding memerlukan kueri yang berisi titik awal dan akhir di peta dalam ruangan, bersama dengan nomor ordinal tingkat lantai. Untuk informasi selengkapnya tentang pembuatan cara Pembuat, lihat cara menentukan dalam artikel konsep.

Untuk membuat kueri wayfinding:

  1. Jalankan permintaan HTTP GET berikut (ganti {routesetId} dengan routesetId yang diperoleh di bagian Periksa status pembuatan set rute dan {facilityId} dengan facilityId yang diperoleh di bagian Dapatkan ID fasilitas):

    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

    Parameter AvoidFeatures dapat digunakan untuk menentukan sesuatu untuk layanan wayfinding yang harus dihindari saat menentukan jalur, seperti lift atau tangga.

  2. Detail jalur dan kaki ditampilkan di Isi respons.

Ringkasan menampilkan perkiraan waktu perjalanan dalam detik untuk total perjalanan. Selain itu, perkiraan waktu untuk setiap bagian perjalanan ditampilkan di awal setiap kaki.

Layanan wayfinding menghitung jalur melalui titik intervensi tertentu. Setiap titik ditampilkan, bersama dengan detail garis lintang dan bujurnya.