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

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:

  1. Di aplikasi Postman, pilih Baru.

  2. Di jendela Buat Baru, pilih Permintaan HTTP.

  3. Untuk Nama permintaan, masukkan nama untuk permintaan, seperti POST Convert Drawing Package.

  4. Pilih metode HTTP POST.

  5. Masukkan URL berikut ke layanan Konversi. Ganti {Your-Azure-Maps-Subscription-key} dengan kunci langganan Azure Peta Anda. Ganti udid dengan udid 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
    
  6. Pilih Kirim.

  7. Dalam jendela tanggapan, pilih tab Header.

  8. Salin nilai kunci Operation-Location. Ini berisi URL status yang Anda gunakan untuk memeriksa status konversi.

    Screenshot of Postman that shows the URL value of the operation location key in the response header.

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:

  1. Di aplikasi Postman, pilih Baru.

  2. Di jendela Buat Baru, pilih Permintaan HTTP.

  3. Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Status Konversi GET.

  4. Pilih metode HTTP GET.

  5. 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}
    
  6. Pilih Kirim.

  7. Dalam jendela tanggapan, pilih tab Header.

  8. Salin nilai kunci Resource-Location , yang merupakan URL lokasi sumber daya. URL lokasi sumber daya berisi pengidentifikasi conversionIdunik , yang digunakan API lain untuk mengakses data peta yang dikonversi.

    Screenshot of Postman that highlights the conversion ID value that appears in the Resource-Location key in the response header.

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:

  1. Di aplikasi Postman, pilih Baru.

  2. Di jendela Buat Baru, pilih Permintaan HTTP.

  3. Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Buat Himpunan Data POST.

  4. Pilih metode HTTP POST.

  5. Masukkan URL berikut ke layanan Himpunan Data. Ganti {conversionId} dengan conversionId 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}
    
  6. Pilih Kirim.

  7. Dalam jendela tanggapan, pilih tab Header.

  8. Salin nilai kunci Operation-Location. Ini berisi URL status yang Anda gunakan untuk memeriksa status himpunan data.

    Screenshot of Postman that shows the value of the Operation-Location key for a dataset in the response header.

Memeriksa status pembuatan himpunan data

Untuk memeriksa status proses pembuatan himpunan data dan mengambil nilai:datasetId

  1. Di aplikasi Postman, pilih Baru.

  2. Di jendela Buat Baru, pilih Permintaan HTTP.

  3. Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Status Himpunan Data GET.

  4. Pilih metode HTTP GET.

  5. 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}
    
  6. Pilih Kirim.

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

  8. Simpan nilai datasetId, karena Anda akan menggunakannya di tutorial berikutnya.

    Screenshot of Postman that shows the dataset ID value of the Resource-Location key in the response header.

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:

  1. Di aplikasi Postman, pilih Baru.

  2. Di jendela Buat Baru, pilih Permintaan HTTP.

  3. Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Buat Set Ubin POST.

  4. Pilih metode HTTP POST.

  5. Masukkan URL berikut ke layanan Tileset. Ganti {datasetId} dengan datasetId 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}
    
  6. Pilih Kirim.

  7. Dalam jendela tanggapan, pilih tab Header.

  8. Salin nilai kunci Operation-Location. Ini berisi URL status, yang Anda gunakan untuk memeriksa status tileset.

    Screenshot of Postman that shows the status URL, which is the value of the Operation-Location key in the response header.

Periksa status pembuatan tileset

Untuk memeriksa status proses pembuatan tileset dan mengambil tilesetId nilai:

  1. Di aplikasi Postman, pilih Baru.

  2. Di jendela Buat Baru, pilih Permintaan HTTP.

  3. Untuk Nama permintaan, masukkan nama untuk permintaan, seperti Status Tileset GET.

  4. Pilih metode HTTP GET.

  5. 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}
    
  6. Pilih Kirim.

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

    Screenshot of Postman that shows the tileset ID, which is part of the value of the resource location URL in the response header.

Mendapatkan konfigurasi peta (pratinjau)

Setelah membuat tileset, Anda bisa mendapatkan mapConfigurationId nilai dengan menggunakan tileset mendapatkan permintaan HTTP:

  1. Di aplikasi Postman, pilih Baru.

  2. Di jendela Buat Baru, pilih Permintaan HTTP.

  3. Untuk Nama permintaan, masukkan nama untuk permintaan, seperti GET mapConfigurationId dari Tileset.

  4. Pilih metode HTTP GET.

  5. 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}
    
  6. Pilih Kirim.

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

Langkah berikutnya