Bagikan melalui

Membuat himpunan data menggunakan paket GeoJson (Pratinjau)

  • Artikel

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.

Azure Maps Creator memungkinkan pengguna mengimpor data peta dalam ruangan mereka dalam format GeoJSON dengan Facility Ontology 2.0, yang kemudian dapat digunakan untuk membuat himpunan data.

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 mengganti {Your-Azure-Maps-Subscription-key} dengan kunci langganan Azure Maps Anda.

Membuat himpunan data menggunakan paket GeoJSON

Untuk informasi selengkapnya tentang paket GeoJSON, lihat bagian Persyaratan paket zip Geojson.

Mengunggah paket GeoJSON

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

Buat himpunan data

Himpunan data adalah kumpulan fitur peta, seperti bangunan, tingkat, dan ruangan. Untuk membuat himpunan data dari GeoJSON Anda, gunakan Api Buat Himpunan Data baru. API Buat Himpunan Data mengambil yang udid Anda dapatkan di bagian sebelumnya dan mengembalikan datasetId himpunan data baru.

Penting

Ini berbeda dari versi sebelumnya dari Dataset Create API karena tidak memerlukan conversionId dari paket gambar yang dikonversi.

Untuk Membuat himpunan data:

  1. Masukkan URL berikut ke layanan himpunan data. Permintaan akan terlihat seperti URL berikut (ganti {udid} dengan yang udid diperoleh di bagian Unggah paket GeoJSON):
https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&udid={udid}&subscription-key={Your-Azure-Maps-Subscription-key}
  1. Salin nilai Operation-Location kunci di header respons. Kunci Operation-Location juga dikenal sebagai status URL dan diperlukan untuk memeriksa status proses pembuatan himpunan data dan untuk mendapatkan datasetId, yang diperlukan untuk membuat tileset.

Memeriksa status pembuatan himpunan data

Untuk memeriksa status proses pembuatan himpunan data dan mengambil datasetId:

  1. Masukkan URL status yang Anda salin di Membuat 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}

  2. Di Header respons HTTP, salin nilai pengidentifikasi unik yang terkandung dalam Resource-Location kunci.

    https://us.atlas.microsoft.com/datasets/**c9c15957-646c-13f2-611a-1ea7adc75174**?api-version=2023-03-01-preview

Menambahkan data ke himpunan data yang sudah ada

Data dapat ditambahkan ke himpunan data yang ada dengan memberikan datasetId parameter ke Api Buat Himpunan Data bersama dengan pengidentifikasi unik data yang ingin Anda tambahkan. Pengidentifikasi unik dapat berupa udid atau conversionId. Ini membuat himpunan data baru yang terdiri dari data (fasilitas) dari himpunan data yang ada dan data baru yang diimpor. Setelah himpunan data baru berhasil dibuat, himpunan data lama dapat dihapus.

Satu hal yang perlu dipertimbangkan saat menambahkan ke himpunan data yang ada adalah cara ID fitur dibuat. Jika himpunan data dibuat dari paket gambar yang dikonversi, ID fitur dihasilkan secara otomatis. Saat himpunan data dibuat dari paket GeoJSON, ID fitur harus disediakan dalam file GeoJSON. Saat menambahkan ke himpunan data yang ada, himpunan data asli mendorong cara ID fitur dibuat. Jika himpunan data asli dibuat menggunakan udid, himpunan data menggunakan ID dari GeoJSON, dan akan terus melakukannya dengan semua paket GeoJSON ditambahkan ke himpunan data tersebut di masa mendatang. Jika himpunan data dibuat menggunakan conversionId, ID akan dihasilkan secara internal, dan akan terus dihasilkan secara internal dengan semua paket GeoJSON ditambahkan ke himpunan data tersebut di masa mendatang.

Menambahkan ke himpunan data yang dibuat dari sumber GeoJSON

Jika himpunan data asli Anda dibuat dari sumber GoeJSON dan Anda ingin menambahkan fasilitas lain yang dibuat dari paket gambar, Anda dapat menambahkannya ke himpunan data yang ada dengan merujuk , conversionIdseperti yang ditunjukkan oleh permintaan HTTP POST ini:

https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&conversionId={conversionId}&outputOntology=facility-2.0&datasetId={datasetId}
pengidentifikasi Deskripsi
conversionId ID ditampilkan saat mengonversi paket gambar Anda.
datasetId ID himpunan data dikembalikan saat membuat himpunan data asli dari paket GeoJSON.

Persyaratan paket zip Geojson

Paket zip GeoJSON terdiri dari satu atau beberapa file GeoJSON yang mematuhi RFC 7946 , satu untuk setiap kelas fitur, semuanya di direktori akar (subdirektori tidak didukung), dikompresi dengan kompresi Zip standar dan diberi nama menggunakan .ZIP ekstensi.

Setiap file kelas fitur harus sesuai dengan definisinya dalam Ontologi Fasilitas 2.0 dan setiap fitur harus memiliki pengidentifikasi unik global.

ID fitur hanya dapat berisi karakter alfa-numerik (a-z, A-Z, 0-9), tanda hubung (-), titik (.) dan garis bawah (_).

Tip

Jika Anda ingin yakin bahwa Anda memiliki pengidentifikasi unik global (GUID), pertimbangkan untuk membuatnya dengan menjalankan alat pembuatan GUID seperti program baris perintah Guidgen.exe (Tersedia dengan Visual Studio). Guidgen.exe tidak pernah menghasilkan angka yang sama dua kali, tidak peduli berapa kali dijalankan atau berapa banyak komputer berbeda yang dijalankannya.

Validasi ontologi fasilitas 2.0 dalam Himpunan Data

Facility Ontology 2.0 mendefinisikan bagaimana Azure Maps Creator secara internal menyimpan data fasilitas, dibagi menjadi kelas fitur, dalam himpunan data Pembuat. Saat mengimpor paket GeoJSON, kapan saja fitur ditambahkan atau dimodifikasi, serangkaian validasi berjalan. Ini termasuk pemeriksaan integritas referensial dan validasi geometri dan atribut. Validasi ini dijelaskan secara lebih rinci dalam daftar berikut.

  • Jumlah maksimum fitur yang dapat diimpor ke dalam himpunan data pada satu waktu adalah 150.000.
  • Area fasilitasnya bisa antara 4 dan 4.000 Sq Km.
  • Elemen tingkat atas adalah fasilitas, yang mendefinisikan setiap bangunan di file facility.geojson.
  • Setiap fasilitas memiliki satu atau beberapa tingkat, yang didefinisikan dalam level file.goejson.
    • Setiap tingkat harus berada di dalam fasilitas.
  • Setiap tingkat berisi unit, struktur, vertikalPenetrasi , dan bukaan. Semua item yang ditentukan dalam tingkat harus sepenuhnya terkandung dalam geometri Tingkat.
    • unitdapat terdiri dari array item seperti lorong, kantor, dan halaman, yang didefinisikan oleh elemen area, garis, atau titik. Unit didefinisikan dalam file unit.goejson.
      • Semua unit elemen harus sepenuhnya terkandung dalam tingkat mereka dan bersinggungan dengan anak-anak mereka.
    • structure mendefinisikan area fisik yang tidak tumpang tindih yang tidak dapat dinavigasi, seperti dinding. Struktur didefinisikan dalam struktur file.goejson.
    • verticalPenetration mewakili metode menavigasi secara vertikal antar level, seperti tangga dan lift dan didefinisikan dalam file verticalPenetration.geojson.
      • verticalPenetrations tidak dapat bersinggungan dengan vertikalPenetrasi lain pada tingkat yang sama.
    • openings tentukan batas yang dapat dilalui antara dua unit, atau unit dan verticalPenetration dan didefinisikan dalam file opening.geojson.
      • Bukaan tidak dapat bersinggungan dengan bukaan lain pada tingkat yang sama.
      • Setiap opening harus dikaitkan dengan setidaknya satu verticalPenetration atau unit.