Tutorial: Menggunakan Azure Peta Creator untuk membuat peta dalam ruangan
Tutorial ini menjelaskan cara membuat peta dalam ruangan untuk digunakan di Microsoft Azure Maps. Tutorial ini menunjukkan cara:
- Unggah paket gambar Anda untuk peta dalam ruangan.
- Konversikan paket gambar Anda menjadi data peta.
- Membuat himpunan data dari data peta Anda.
- Membuat tileset dari data dalam himpunan data Anda.
- Dapatkan ID konfigurasi peta default dari tileset Anda.
Anda juga dapat membuat himpunan data dari paket GeoJSON. Untuk informasi selengkapnya, lihat Membuat himpunan data menggunakan paket GeoJSON (pratinjau).
Prasyarat
- Akun Azure Peta
- Kunci langganan
- Sumber daya Pembuat
- Akun penyimpanan Azure
- Paket gambar sampel diunduh
Tutorial ini menggunakan aplikasi Postman, tetapi Anda dapat menggunakan lingkungan pengembangan API berbeda.
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, ganti
{Your-Azure-Maps-Subscription-key}
dengan kunci langganan Azure Peta Anda.
Mengunggah paket gambar
Ikuti langkah-langkah yang diuraikan dalam artikel Cara membuat registri data untuk mengunggah paket GeoJSON ke akun penyimpanan Azure Anda lalu daftarkan di akun Azure Peta Anda.
Penting
Pastikan untuk membuat catatan nilai pengidentifikasi unik (udid
), Anda akan membutuhkannya. Ini udid
adalah cara Anda mereferensikan paket GeoJSON yang Anda unggah ke akun penyimpanan Azure Anda dari kode sumber dan permintaan HTTP Anda.
Mengonversi paket gambar
Sekarang setelah paket gambar diunggah, Anda menggunakan udid
nilai untuk paket yang diunggah untuk mengonversi paket menjadi data peta. API Konversi menggunakan transaksi jangka panjang yang menerapkan pola yang ditentukan dalam artikel Operasi Jangka Panjang Creator.
Untuk mengonversi paket gambar:
Di aplikasi Postman, pilih Baru.
Di jendela Buat Baru, pilih Permintaan HTTP.
Untuk Nama permintaan, masukkan nama untuk permintaan, seperti POST Convert Drawing Package.
Pilih metode HTTP POST.
Masukkan URL berikut ke layanan Konversi. Ganti
{Your-Azure-Maps-Subscription-key}
dengan kunci langganan Azure Peta Anda. Gantiudid
denganudid
nilai paket yang diunggah.https://us.atlas.microsoft.com/conversions?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2023-03-01-preview&udid={udid}&inputType=DWG&dwgPackageVersion=2.0
Pilih Kirim.
Dalam jendela tanggapan, pilih tab Header.
Salin nilai kunci Operation-Location. Ini berisi URL status yang Anda gunakan untuk memeriksa status konversi.
Periksa status konversi paket gambar
Setelah operasi konversi selesai, operasi mengembalikan conversionId
nilai. Anda dapat mengakses conversionId
nilai dengan memeriksa status proses konversi paket gambar. Anda kemudian dapat menggunakan conversionId
nilai untuk mengakses data yang dikonversi.
Untuk memeriksa status proses konversi dan mengambil conversionId
nilai:
Di aplikasi Postman, pilih Baru.
Di jendela Buat Baru, pilih Permintaan HTTP.
Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Status Konversi GET.
Pilih metode HTTP GET.
Masukkan URL status yang Anda salin di bagian Konversi paket gambar. Permintaan harus terlihat seperti URL berikut:
https://us.atlas.microsoft.com/conversions/operations/{operationId}?api-version=2.0&subscription-key={Your-Azure-Maps-Subscription-key}
Pilih Kirim.
Dalam jendela tanggapan, pilih tab Header.
Salin nilai kunci Resource-Location , yang merupakan URL lokasi sumber daya. URL lokasi sumber daya berisi pengidentifikasi
conversionId
unik , yang digunakan API lain untuk mengakses data peta yang dikonversi.
Paket gambar sampel harus dikonversi tanpa kesalahan atau peringatan. Tetapi jika Anda menerima kesalahan atau peringatan dari paket gambar Anda sendiri, respons JSON menyertakan tautan ke Visualizer Kesalahan Menggambar. Anda dapat menggunakan Visualizer Kesalahan Menggambar untuk memeriksa detail kesalahan dan peringatan. Untuk mendapatkan rekomendasi untuk mengatasi kesalahan konversi dan peringatan, lihat Menggambar kesalahan dan peringatan konversi.
Fragmen JSON berikut menampilkan peringatan konversi sampel:
{
"operationId": "{operationId}",
"created": "2021-05-19T18:24:28.7922905+00:00",
"status": "Succeeded",
"warning": {
"code": "dwgConversionProblem",
"details": [
{
"code": "warning",
"details": [
{
"code": "manifestWarning",
"message": "Ignoring unexpected JSON property: unitProperties[0].nonWheelchairAccessible with value False"
}
]
}
]
},
"properties": {
"diagnosticPackageLocation": "https://atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=1.0"
}
}
Buat himpunan data
Himpunan data adalah kumpulan fitur peta, seperti bangunan, tingkat, dan ruangan. Untuk membuat himpunan data, gunakan Dataset Create API. Api Buat Himpunan Data mengambil conversionId
nilai untuk paket gambar yang dikonversi dan mengembalikan nilai untuk himpunan data yang datasetId
dibuat.
Untuk Membuat himpunan data:
Di aplikasi Postman, pilih Baru.
Di jendela Buat Baru, pilih Permintaan HTTP.
Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Buat Himpunan Data POST.
Pilih metode HTTP POST.
Masukkan URL berikut ke layanan Himpunan Data. Ganti
{conversionId}
denganconversionId
nilai yang Anda peroleh di Periksa status konversi paket gambar.https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&conversionId={conversionId}&subscription-key={Your-Azure-Maps-Subscription-key}
Pilih Kirim.
Dalam jendela tanggapan, pilih tab Header.
Salin nilai kunci Operation-Location. Ini berisi URL status yang Anda gunakan untuk memeriksa status himpunan data.
Memeriksa status pembuatan himpunan data
Untuk memeriksa status proses pembuatan himpunan data dan mengambil nilai:datasetId
Di aplikasi Postman, pilih Baru.
Di jendela Buat Baru, pilih Permintaan HTTP.
Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Status Himpunan Data GET.
Pilih metode HTTP GET.
Masukkan URL status yang Anda salin di bagian Buat himpunan data. Permintaan harus terlihat seperti URL berikut:
https://us.atlas.microsoft.com/datasets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}
Pilih Kirim.
Di jendela respons, pilih tab Header . Nilai kunci Resource-Location adalah URL lokasi sumber daya. URL lokasi sumber daya berisi pengidentifikasi unik (
datasetId
) himpunan data.Simpan nilai
datasetId
, karena Anda akan menggunakannya di tutorial berikutnya.
Membuat himpunan ubin
Himpunan ubin adalah sekumpulan ubin vektor yang dirender di peta. Himpunan ubin dibuat dari himpunan data yang ada. Namun, set petak peta independen dari himpunan data asalnya. Jika himpunan data dihapus, tileset akan terus ada.
Untuk membuat tileset:
Di aplikasi Postman, pilih Baru.
Di jendela Buat Baru, pilih Permintaan HTTP.
Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Buat Set Ubin POST.
Pilih metode HTTP POST.
Masukkan URL berikut ke layanan Tileset. Ganti
{datasetId}
dengandatasetId
nilai yang Anda peroleh di bagian Periksa status pembuatan himpunan data.https://us.atlas.microsoft.com/tilesets?api-version=2023-03-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Primary-Subscription-key}
Pilih Kirim.
Dalam jendela tanggapan, pilih tab Header.
Salin nilai kunci Operation-Location. Ini berisi URL status, yang Anda gunakan untuk memeriksa status tileset.
Periksa status pembuatan tileset
Untuk memeriksa status proses pembuatan tileset dan mengambil tilesetId
nilai:
Di aplikasi Postman, pilih Baru.
Di jendela Buat Baru, pilih Permintaan HTTP.
Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Status Tileset GET.
Pilih metode HTTP GET.
Masukkan URL status yang Anda salin di bagian Buat tileset . Permintaan harus terlihat seperti URL berikut:
https://us.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}
Pilih Kirim.
Di jendela respons, pilih tab Header . Nilai kunci Resource-Location adalah URL lokasi sumber daya. URL lokasi sumber daya berisi pengidentifikasi unik (
tilesetId
) himpunan data.
Mendapatkan konfigurasi peta (pratinjau)
Setelah membuat tileset, Anda bisa mendapatkan mapConfigurationId
nilai dengan menggunakan tileset mendapatkan permintaan HTTP:
Di aplikasi Postman, pilih Baru.
Di jendela Buat Baru, pilih Permintaan HTTP.
Untuk Nama permintaan, masukkan nama untuk permintaan, seperti GET mapConfigurationId dari Tileset.
Pilih metode HTTP GET.
Masukkan URL berikut ke layanan Tileset. Teruskan ID tileset yang Anda peroleh di langkah sebelumnya.
https://us.atlas.microsoft.com/tilesets/{tilesetId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}
Pilih Kirim.
Tileset JSON muncul di isi respons. Gulir ke bawah untuk melihat nilainya
mapConfigurationId
:"defaultMapConfigurationId": "5906cd57-2dba-389b-3313-ce6b549d4396"
Untuk informasi selengkapnya, lihat Konfigurasi peta di artikel tentang konsep peta dalam ruangan.