Layanan wayfinding peta dalam ruangan (pratinjau)

Artikel
09/25/2024

Catatan

Penghentian Pembuat Azure Maps

Layanan peta dalam ruangan Azure Maps Creator sekarang tidak digunakan lagi dan akan dihentikan pada 30/9/25. Untuk informasi selengkapnya, lihat Pengumuman Akhir Masa Pakai Pembuat Azure Maps.

Layanan wayfinding Azure Maps 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

Memahami konsep Pembuat.
Himpunan data dan tileset Azure Maps Creator.

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 Maps Anda.
- Ganti {datasetId} dengan .datasetId

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:

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}

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:

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.

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.

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}

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:

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

Bagikan melalui