Kreator untuk peta dalam ruangan

Nota

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 Penghentian Layanan Azure Maps Kreator.

Artikel ini memperkenalkan konsep dan alat yang berlaku untuk Azure Maps Creator. Sebaiknya baca artikel ini sebelum mulai menggunakan Azure Maps Creator API dan SDK.

Anda dapat menggunakan Creator untuk mengembangkan aplikasi dengan fitur peta yang didasarkan pada data peta dalam ruangan. Artikel ini menjelaskan proses mengupload, mengonversi, membuat, dan menggunakan data peta Anda. Biasanya, alur kerja diselesaikan oleh dua persona berbeda dengan bidang keahlian dan tanggung jawab yang berbeda:

• Pembuat peta: bertanggung jawab untuk mengkurasi dan menyiapkan data peta.
• Pengguna data peta pembuat: menggunakan data peta pelanggan dalam aplikasi.

Diagram berikut mengilustrasikan seluruh alur kerja.

Membuat Pembuat Azure Maps

Untuk menggunakan layanan Creator, sumber daya Azure Maps Creator harus dibuat dan dikaitkan ke akun Azure Maps dengan tingkat harga Gen 2. Untuk informasi tentang cara membuat sumber daya Azure Maps Creator di Azure, lihat Mengelola Azure Maps Creator.

Petunjuk / Saran

Untuk informasi harga, lihat bagian Kreator di harga Azure Maps.

Autentikasi kreator

Creator mewarisi pengaturan Azure Maps Access Control (IAM). Semua panggilan API untuk akses data harus dikirim dengan aturan autentikasi dan otorisasi.

Data penggunaan Creator digabungkan dalam bagan penggunaan dan log aktivitas Azure Maps Anda. Untuk informasi selengkapnya, lihat Mengelola autentikasi di Azure Maps.

Penting

Kami merekomendasikan menggunakan:

• ID Microsoft Entra di semua solusi yang dibuat dengan akun Azure Maps menggunakan layanan Creator. Untuk informasi selengkapnya tentang ID Microsoft Entra, lihat autentikasi Microsoft Entra.

• Pengaturan kontrol akses berbasis peran. Dengan menggunakan pengaturan ini, pembuat peta dapat bertindak sebagai peran Kontributor Data Azure Maps, dan pengguna data peta Pembuat dapat bertindak sebagai peran Pembaca Data Azure Maps. Untuk informasi selengkapnya, lihat Otorisasi dengan kontrol akses berbasis peran.

Jenis item data kreator

Layanan kreator membuat, menyimpan, dan menggunakan berbagai jenis data yang ditentukan dan dibahas di bagian berikut. Item data kreator dapat terdiri dari jenis berikut:

• Data yang dikonversi
• Kumpulan Data
• Kumpulan ubin
• gaya
• Konfigurasi peta
• Set rute

Mengunggah paket gambar

Kreator mengumpulkan data peta dalam ruangan dengan mengonversi paket gambar yang diupload. Paket gambar mewakili fasilitas yang dibangun atau direnovasi. Untuk informasi tentang persyaratan paket gambar, lihat Persyaratan paket gambar.

Ikuti langkah-langkah yang diuraikan dalam artikel Cara membuat registri data untuk mengunggah paket gambar ke akun penyimpanan Azure Anda, lalu daftarkan di akun Azure Maps Anda.

Penting

Pastikan untuk mencatat nilai pengidentifikasi unik (udid), Anda akan membutuhkannya. Diperlukan udid untuk mengubah paket yang diunggah menjadi data peta dalam ruangan.

Mengonversi paket gambar

Layanan Konversi mengonversi paket gambar yang diupload menjadi data peta dalam ruangan. Layanan Konversi juga memvalidasi paket. Masalah validasi diklasifikasikan menjadi dua jenis:

• Kesalahan: Jika ada kesalahan yang terdeteksi, proses konversi gagal. Saat terjadi kesalahan, layanan Konversi menyediakan tautan ke aplikasi web mandiri Azure Maps Drawing Error Visualizer . Anda dapat menggunakan Visualizer Kesalahan Menggambar untuk memeriksa peringatan paket Gambar dan kesalahan yang terjadi selama proses konversi. Setelah memperbaiki kesalahan, Anda dapat mencoba mengunggah dan mengonversi paket.
• Peringatan: Jika ada peringatan yang terdeteksi, konversi akan berhasil. Namun, sebaiknya tinjau dan selesaikan semua peringatan. Peringatan berarti bahwa bagian dari konversi diabaikan atau diperbaiki secara otomatis. Gagal menyelesaikan peringatan dapat mengakibatkan kesalahan dalam proses selanjutnya. Untuk informasi selengkapnya, lihat Menggambar peringatan dan kesalahan paket.

Membuat data peta dalam ruangan

Azure Maps Creator menyediakan layanan berikut yang mendukung pembuatan peta:

• Layanan himpunan data.
• Layanan ubin. Gunakan layanan Tileset untuk membuat representasi berbasis vektor dari himpunan data. Aplikasi dapat menggunakan kumpulan ubin untuk menyajikan tampilan himpunan data berbasis petak petak visual.
• Layanan penataan gaya khusus. Gunakan layanan gaya atau editor gaya visual untuk menyesuaikan elemen visual peta dalam ruangan.
• Layanan pencari jalan. Gunakan API pencarian jalan untuk menghasilkan jalur antara dua titik dalam fasilitas. Gunakan API routeset untuk membuat data yang dibutuhkan layanan wayfinding untuk menghasilkan jalur.

Kumpulan Data

Himpunan data adalah kumpulan fitur peta dalam ruangan. Fitur peta dalam ruangan mewakili fasilitas yang ditentukan dalam paket gambar yang dikonversi. Setelah membuat himpunan data dengan layanan Himpunan Data, Anda dapat membuat sejumlah kumpulan petak petak.

Kapan saja, pengembang dapat menggunakan layanan Himpunan Data untuk menambahkan atau menghapus fasilitas ke himpunan data yang ada. Untuk informasi selengkapnya tentang cara memperbarui himpunan data yang ada menggunakan API, lihat opsi penambahan di layanan Himpunan Data. Untuk contoh cara memperbarui himpunan data, lihat Pemeliharaan data.

Ubin

Kumpulan ubin adalah kumpulan data vektor yang mewakili sekumpulan petak peta kisi seragam. Pengembang dapat menggunakan layanan Tileset untuk membuat kumpulan ubin dari himpunan data.

Untuk mencerminkan tahapan konten yang berbeda, Anda dapat membuat beberapa set ubin dari himpunan data yang sama. Misalnya, Anda dapat membuat satu ubin dengan furnitur dan peralatan, dan satu lagi ubin tanpa furnitur dan peralatan. Anda dapat memilih untuk membuat satu kumpulan ubin dengan pembaruan data terbaru, dan kumpulan ubin lain tanpa pembaruan data terbaru.

Selain data vektor, kumpulan ubin menyediakan metadata untuk pengoptimalan rendering peta. Misalnya, metadata kumpulan ubin berisi tingkat zoom minimum dan maksimum untuk kumpulan ubin. Metadata juga menyediakan kotak pembatas yang menentukan luasan geografis kumpulan ubin. Aplikasi dapat menggunakan kotak pembatas untuk mengatur titik tengah yang benar secara terprogram. Untuk informasi selengkapnya tentang metadata kumpulan ubin, lihat Daftar Kumpulan Petak Intas.

Setelah kumpulan ubin dibuat, set tersebut diambil menggunakan layanan Render.

Jika kumpulan ubin menjadi usang dan tidak lagi berguna, Anda dapat menghapus kumpulan petak peta. Untuk informasi tentang cara menghapus kumpulan ubin, lihat Pemeliharaan data.

Nota

Kumpulan ubin tidak bergantung pada himpunan data dari mana ia dibuat. Jika Anda membuat kumpulan ubin dari himpunan data, lalu kemudian memperbarui himpunan data tersebut, kumpulan petak peta tidak diperbarui.

Untuk mencerminkan perubahan dalam himpunan data, Anda harus membuat kumpulan ubin baru. Demikian pula, jika Anda menghapus kumpulan peta, himpunan data tidak terpengaruh.

Gaya kustom (pratinjau)

Gaya mendefinisikan tampilan visual peta. Ini mendefinisikan data apa yang akan digambar, urutan untuk menggambarnya, dan cara menata data saat menggambarnya. Gaya Azure Maps Creator mendukung standar MapLibre untuk lapisan gaya dan sprite.

Saat Anda mengonversi paket gambar setelah mengunggahnya ke akun Azure Maps Anda, gaya default diterapkan ke elemen peta Anda. Layanan penataan gaya kustom memungkinkan Anda menyesuaikan tampilan visual peta Anda. Anda dapat melakukannya dengan mengedit gaya JSON secara manual dan mengimpornya ke akun Azure Maps Anda menggunakan permintaan Gaya - Buat HTTP, namun pendekatan yang disarankan adalah menggunakan editor gaya visual. Untuk informasi selengkapnya, lihat Membuat gaya kustom untuk peta dalam ruangan.

Contoh lapisan dalam file style.json:

{
	"id": "indoor_unit_gym_label",
	"type": "symbol",
	"filter": ["all", ["has","floor0"], ["any", ["==", "categoryName", "room.gym"]]],
	"layout": {
		"visibility": "none",
		"icon-image": "gym",
		"icon-size": {"stops": [[17.5, 0.7], [21, 1.1]]},
		"symbol-avoid-edges": true,
		"symbol-placement": "point",
		"text-anchor": "top",
		"text-field": "{name}",
		"text-font": ["SegoeFrutigerHelveticaMYingHei-Medium"],
		"text-keep-upright": true,
		"text-letter-spacing": 0.1,
		"text-offset": [0, 1.05],
		"text-size": {"stops": [[18, 5], [18.5, 6.5], [19, 8], [19.5, 9.5], [20, 11]]}
	},
	"metadata": {"microsoft.maps:layerGroup": "labels_indoor"},
	"minzoom": 17.5,
	"paint": {
		"text-color": "rgba(0, 0, 0, 1)",
		"text-halo-blur": 0.5,
		"text-halo-color": "rgba(255, 255, 255, 1)",
		"text-halo-width": 1,
		"text-opacity": ["step", ["zoom"], 0, 18, 1]
	},
	"source-layer": "Indoor unit"
},

Properti Lapisan	Deskripsi
Id	Nama lapisan
tipe	Jenis rendering untuk lapisan ini. Beberapa jenis yang lebih umum meliputi: fill: Poligon yang diisi dengan batas stroked opsional. Garis: Garis yang digoreskan. Simbol: Ikon atau label teks. isi-ekstrusi: Poligon yang diekstrusi (3D).
penyaring	Hanya fitur yang cocok dengan kriteria filter yang ditampilkan.
tata letak	Properti tata letak untuk lapisan.
minzoom	Angka antara 0 dan 24 yang mewakili tingkat zoom minimum untuk lapisan. Pada tingkat zoom kurang dari minzoom, lapisan disembunyikan.
cat	Properti cat default untuk lapisan ini.
sumber-lapisan	Sumber menyediakan data, dari sumber petak vektor, yang ditampilkan di peta. Diperlukan untuk sumber ubin vektor; dilarang untuk semua jenis sumber lainnya, termasuk sumber GeoJSON.

Konfigurasi peta

Konfigurasi peta adalah susunan konfigurasi. Setiap konfigurasi terdiri dari peta dasar dan satu atau lebih lapisan, setiap lapisan terdiri dari tupleset ubingaya + .

Konfigurasi peta digunakan saat Anda membuat Instans Manajer Dalam Ruangan objek Peta saat mengembangkan aplikasi di Azure Maps. Ini direferensikan menggunakan atau mapConfigurationIdalias. Konfigurasi peta tidak dapat diubah. Saat membuat perubahan pada konfigurasi peta yang ada, konfigurasi peta baru dibuat, menghasilkan mapConfigurationId. Setiap kali Anda membuat konfigurasi peta menggunakan alias yang sudah digunakan oleh konfigurasi peta yang ada, konfigurasi peta tersebut menunjuk ke konfigurasi peta baru.

JSON berikut adalah contoh konfigurasi peta default. Lihat tabel berikut untuk deskripsi setiap elemen file:

{
    "version": 1.0,
    "description": "This is the default Azure Maps map configuration for facility ontology tilesets.",
    "defaultConfiguration": "indoor_light",
    "configurations": [
        {
            "name": "indoor_light",
            "displayName": "Indoor light",
            "description": "A base style for Azure Maps.",
            "thumbnail": "indoor_2022-01-01.png",
            "baseMap": "microsoft_light",
            "layers": [
                {
                    "tilesetId": "fa37d225-924e-3f32-8441-6128d9e5519a",
                    "styleId": "microsoft-maps:indoor_2022-01-01"
                }
            ]
        },
        {
            "name": "indoor_dark",
            "displayName": "Indoor dark",
            "description": "A base style for Azure Maps.",
            "thumbnail": "indoor_dark_2022-01-01.png",
            "baseMap": "microsoft_dark",
            "layers": [
                {
                    "tilesetId": "fa37d225-924e-3f32-8441-6128d9e5519a",
                    "styleId": "microsoft-maps:indoor_dark_2022-01-01"
                }
            ]
        }
    ]
}

Properti Objek Gaya	Deskripsi
Nama	Nama gayanya.
nama tampilan	Nama tampilan gaya.
deskripsi	Deskripsi gaya yang ditentukan pengguna.
gambar mini	Gunakan untuk menentukan thumbnail yang digunakan dalam pemilih gaya untuk gaya ini. Untuk informasi selengkapnya, lihat kontrol pemilih gaya.
Peta dasar	Gunakan untuk Mengatur gaya peta dasar.
Lapisan	Array lapisan terdiri dari satu atau lebih tileset + tuple Gaya, masing-masing merupakan lapisan peta. Ini memungkinkan beberapa bangunan di peta, setiap bangunan diwakili dalam ubinnya sendiri.

Informasi tambahan

• Untuk informasi selengkapnya cara mengubah gaya menggunakan editor gaya, lihat Membuat gaya kustom untuk peta dalam ruangan.
• Untuk informasi selengkapnya tentang gaya REST API, lihat gaya di referensi REST API Maps Creator.
• Untuk informasi selengkapnya tentang REST API konfigurasi peta, lihat Pembuat - konfigurasi peta REST API.

Pencarian jalan (pratinjau)

Layanan Wayfinding memungkinkan Anda memberi pelanggan jalur terpendek antara dua titik dalam fasilitas. Setelah mengimpor data peta dalam ruangan dan membuat himpunan data, Anda dapat menggunakannya untuk membuat kumpulan rute. Kumpulan rute menyediakan data yang diperlukan untuk menghasilkan jalur antara dua titik. Layanan pencari jalan memperhitungkan hal-hal seperti lebar bukaan minimum dan secara opsional dapat mengecualikan lift atau tangga saat menavigasi antar tingkat sebagai hasilnya.

Pencarian jalan pembuat didukung oleh Havok.

Jalur pencarian jalan

Ketika jalur pencarian jalan berhasil dibuat, jalur tersebut menemukan jalur terpendek antara dua titik dalam fasilitas yang ditentukan. Setiap lantai dalam perjalanan direpresentasikan sebagai kaki terpisah, seperti halnya tangga atau lift yang digunakan untuk bergerak antar lantai.

Misalnya, bagian pertama jalur mungkin dari asal ke lift di lantai itu. Langkah selanjutnya adalah lift, dan kemudian kaki terakhir adalah jalur dari lift ke tempat tujuan. Perkiraan waktu perjalanan juga dihitung dan dikembalikan dalam JSON respons HTTP.

Struktur

Agar wayfinding berfungsi, data fasilitas harus berisi struktur. Layanan pencari jalan menghitung jalur terpendek antara dua titik yang dipilih dalam fasilitas. Layanan ini menciptakan jalur dengan menavigasi di sekitar struktur, seperti dinding dan struktur kedap air lainnya.

Penetrasi vertikal

Jika asal dan tujuan yang dipilih berada di lantai yang berbeda, layanan wayfinding menentukan objek verticalPenetration seperti tangga atau lift, yang tersedia sebagai jalur yang mungkin untuk menavigasi secara vertikal antar level. Secara default, opsi yang menghasilkan jalur terpendek digunakan.

Layanan Wayfinding mencakup tangga atau lift di jalur berdasarkan nilai properti penetrasi direction vertikal. Untuk informasi selengkapnya tentang properti direction, lihat verticalPenetration di artikel Ontologi Fasilitas. Lihat avoidFeatures properti dan minWidth dalam dokumentasi API wayfinding untuk mempelajari faktor lain yang dapat memengaruhi pemilihan jalur antar tingkat lantai.

Untuk informasi selengkapnya, lihat artikel Cara layanan pencarian jalan peta dalam ruangan .

Menggunakan peta dalam ruangan

Render - Dapatkan API Petak Peta

API Azure Maps [Render - Get Map Tile] telah diperluas untuk mendukung kumpulan ubin Creator.

Aplikasi dapat menggunakan API Render - Get Map Tile untuk meminta kumpulan ubin. Tileset kemudian dapat diintegrasikan ke dalam kontrol peta atau SDK. Untuk contoh kontrol peta yang menggunakan layanan Render, lihat Modul Peta Dalam Ruangan.

API layanan Fitur Web

Anda dapat menggunakan layanan Fitur Web (WFS) untuk mengkueri himpunan data. WFS mengikuti Fitur API Konsorsium Geospasial Terbuka. Anda dapat menggunakan API WFS untuk mengkueri fitur dalam himpunan data itu sendiri. Misalnya, Anda dapat menggunakan WFS untuk menemukan semua ruang rapat menengah dari fasilitas dan tingkat lantai tertentu.

Alias API

Layanan kreator seperti Konversi, Himpunan Data, dan Kumpulan Ubin menampilkan ID untuk setiap resource yang dibuat dari API. Alias API memungkinkan Anda menetapkan alias untuk mereferensikan pengidentifikasi sumber daya.

Modul Peta Dalam Ruangan

Azure Maps Web SDK menyertakan modul Peta Dalam Ruangan. Modul ini menawarkan fungsionalitas yang diperluas ke pustaka Kontrol Peta Azure Maps. Modul Peta Dalam Ruangan merender peta dalam ruangan yang dibuat di Creator. Ini mengintegrasikan widget seperti pemilih lantai yang membantu pengguna memvisualisasikan lantai yang berbeda.

Anda dapat menggunakan modul Peta Dalam Ruangan untuk membuat aplikasi web yang mengintegrasikan data peta dalam ruangan dengan layanan Azure Maps lainnya. Penyiapan aplikasi yang paling umum termasuk menambahkan pengetahuan dari peta lain - seperti jalan, citra, cuaca, dan transit - ke peta dalam ruangan.

Modul Peta Dalam Ruangan juga mendukung gaya peta dinamis untuk informasi selengkapnya, lihat Menyempurnakan peta dalam ruangan Anda dengan gaya fitur peta waktu nyata.

Integrasi Azure Maps

Saat Anda mulai mengembangkan solusi untuk peta dalam ruangan, Anda dapat menemukan cara untuk mengintegrasikan kemampuan Azure Maps yang ada. Misalnya, Anda dapat menerapkan pelacakan aset atau skenario keamanan dengan menggunakan layanan Pembatasan Wilayah dengan peta dalam ruangan Kreator. Misalnya, Anda dapat menggunakan Geofence API untuk menentukan apakah pekerja memasuki atau meninggalkan area dalam ruangan tertentu.

Pemeliharaan data

Anda dapat menggunakan API Daftar, Perbarui, dan Hapus Pembuat Azure Maps untuk mencantumkan, memperbarui, dan menghapus himpunan data dan set ubin Anda.

Nota

Saat Anda meninjau daftar item untuk menentukan apakah akan menghapusnya, pertimbangkan dampak penghapusan tersebut pada semua API atau aplikasi dependen. Misalnya, jika Anda menghapus kumpulan ubin yang digunakan oleh aplikasi melalui API [Render - Get Map Tile], aplikasi gagal merender kumpulan ubin tersebut.

Contoh: Memperbarui himpunan data

Contoh berikut menunjukkan cara memperbarui himpunan data, membuat kumpulan ubin baru, dan menghapus kumpulan petak benda lama:

1. Ikuti langkah-langkah di bagian Mengunggah paket gambar dan Mengonversi paket gambar untuk mengunggah dan mengonversi paket gambar baru.
2. Gunakan Pembuatan Himpunan Data untuk menambahkan data yang dikonversi ke himpunan data yang ada.
3. Gunakan Tileset Create untuk menghasilkan kumpulan ubin baru dari himpunan data yang diperbarui.
4. Simpan tilesetId baru untuk langkah berikutnya.
5. Untuk mengaktifkan visualisasi himpunan data kampus yang diperbarui, perbarui pengidentifikasi kumpulan ubin di aplikasi Anda. Jika kumpulan ubin lama tidak lagi digunakan, Anda dapat menghapusnya.