Persyaratan paket menggambar

Artikel
11/08/2023

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.

Anda dapat mengonversi paket gambar yang diunggah menjadi data peta dengan menggunakan layanan Konversi Azure Maps. Artikel ini menjelaskan persyaratan paket gambar untuk API Konversi. Untuk melihat paket sampel, Anda dapat mengunduh contoh paket Gambar.

Prasyarat

Paket gambar mencakup gambar yang disimpan dalam format DWG, yang merupakan format file asli untuk perangkat lunak AutoCAD® Autodesk.

Anda dapat memilih perangkat lunak CAD apa pun untuk menghasilkan gambar dalam paket gambar.

Layanan Konversi mengonversi paket gambar menjadi data peta. Layanan Konversi berfungsi dengan format file DWG AutoCAD AC1032.

Glosarium istilah

Untuk referensi yang mudah, berikut adalah beberapa istilah dan definisi yang penting saat Anda membaca artikel ini.

Term	Definisi
Lapisan	Lapisan AutoCAD DWG dari file gambar.
Entity	Entitas AutoCAD DWG dari file gambar.
Xref	File dalam format file DWG AutoCAD, dilampirkan ke gambar utama sebagai referensi eksternal.
Tingkat	Area bangunan di ketinggian yang ditetapkan. Misalnya, lantai sebuah bangunan.
Fitur	Contoh objek yang dihasilkan dari layanan Konversi yang menggabungkan geometri dengan informasi metadata.
Kelas fitur	Cetak biru umum untuk fitur. Misalnya, unit adalah kelas fitur, dan kantor adalah fitur.

Struktur paket gambar

Paket gambar adalah arsip .zip yang berisi file berikut:

File DWG dalam format file AutoCAD DWG.
File manifest.json yang menjelaskan file DWG dalam paket gambar.

Paket gambar harus di-zip ke dalam satu file arsip, dengan ekstensi .zip. File DWG dapat diatur dengan cara apa pun di dalam paket, tetapi file manifes harus hidup di direktori akar dari paket zip. Bagian berikutnya merinci persyaratan untuk file DWG, file manifes, dan konten file-file ini. Untuk melihat paket sampel, Anda dapat mengunduh paket gambar sampel.

Proses konversi file DWG

Layanan Konversi melakukan hal berikut pada setiap file DWG:

Mengekstrak kelas fitur:
- Tingkat
- Unit-unit
- Zona
- Pembuka
- Dinding
- Penetrasi vertikal
Memproduksi fitur Fasilitas.
Menghasilkan serangkaian fitur Kategori default minimal yang dirujuk oleh fitur lain:
- kamar
- Struktur
- dinding
- membuka.pintu
- zona
- fasilitas

Persyaratan file DWG

Diperlukan satu file DWG untuk setiap tingkat fasilitas. Semua data dari satu tingkat harus terkandung dalam satu file DWG. Setiap referensi eksternal (xrefs) harus terikat ke gambar induk. Misalnya, fasilitas dengan tiga tingkat memiliki tiga file DWG dalam paket gambar.

Setiap file DWG harus mematuhi persyaratan berikut:

File DWG harus menentukan Exterior and lapisan Unit. Itu bisa menentukan dengan opsional lapisan-lapisan berikut: Dinding, Pintu, UnitLabel, Zona, dan ZoneLabel.
File DWG tidak dapat berisi fitur dari beberapa level.
File DWG tidak dapat berisi fitur dari beberapa fasilitas.
DWG harus mereferensikan sistem pengukuran dan satuan pengukuran yang sama dengan file DWG lainnya dalam paket gambar.

Persyaratan lapisan DWG

Setiap lapisan DWG harus mematuhi aturan berikut:

Lapisan DWG harus berisi fitur dari satu kelas. Misalnya, unit dan dinding tidak bisa berada di lapisan yang sama.
Satu kelas fitur dapat diwakili oleh beberapa lapisan.
Poligon berpotongan sendiri diizinkan, tetapi secara otomatis diperbaiki. Saat diperbaiki, layanan Konversi menimbulkan peringatan. Disarankan untuk memeriksa hasil yang diperbaiki secara manual, karena mereka mungkin tidak cocok dengan hasil yang diharapkan.
Setiap lapisan memiliki daftar tipe entitas yang didukung. Setiap jenis entitas lain dalam lapisan akan diabaikan. Misalnya, entitas teks tidak didukung pada lapisan dinding.

Tabel berikut menguraikan jenis entitas yang didukung dan fitur peta yang dikonversi untuk setiap lapisan. Jika lapisan berisi jenis entitas yang tidak didukung, maka layanan Konversi mengabaikan entitas tersebut.

Lapisan	Jenis entitas	Fitur yang Dikonversi
Exterior	POLYGON, POLYLINE (tertutup), LINGKARAN, atau ELIPS (tertutup)	Tingkat
Satuan	POLYGON, POLYLINE (tertutup), LINGKARAN, atau ELIPS (tertutup)	Unit dan penetrasi Vertikal
Dinding	POLYGON, POLYLINE (tertutup), LINGKARAN, atau ELIPS (tertutup), Struktur
Pintu	POLIGON, POLILINE, GARIS, CIRCULARARC, LINGKARAN	Pembuka
Zone	POLYGON, POLYLINE (tertutup), LINGKARAN, atau ELIPS (tertutup)	Zona
UnitLabel	Teks (satu baris)	Tidak berlaku. Lapisan ini hanya dapat menambahkan properti ke fitur unit dari layer Units. Untuk informasi selengkapnya, lihat lapisan UnitLabel.
ZoneLabel	Teks (satu baris)	Tidak berlaku. Lapisan ini hanya dapat menambahkan properti ke fitur zona dari ZonesLayer. Untuk informasi selengkapnya, lihat lapisan ZoneLabel.

Bagian berikut menjelaskan persyaratan untuk setiap lapisan.

Lapisan eksterior

File DWG untuk setiap tingkat harus berisi lapisan untuk menentukan perimeter tingkat tersebut. Lapisan ini disebut sebagai lapisan eksterior. Misalnya, jika fasilitas berisi dua tingkat, maka perlu memiliki dua file DWG, dengan lapisan eksterior untuk setiap file.

Tidak peduli berapa banyak gambar entitas di lapisan eksterior, himpunan data fasilitas yang dihasilkan hanya berisi fitur satu tingkat untuk setiap file DWG. Selain itu:

Eksterior harus digambar sebagai POLYGON, POLYLINE (tertutup), CIRCLE, atau ELIPS (tertutup).
Eksterior mungkin tumpang tindih, tetapi dilarutkan menjadi satu geometri.
Fitur tingkat yang dihasilkan harus minimal 4 meter persegi.
Fitur tingkat yang dihasilkan tidak boleh lebih besar 400.000 meter persegi.

Jika lapisan berisi beberapa PolyLines yang tumpang tindih, lapisan tersebut dilarutkan ke dalam satu fitur Level. Sebaliknya, jika lapisan berisi beberapa PolyLines yang tidak tumpang tindih, fitur Level yang dihasilkan memiliki representasi multipoligon.

Anda dapat melihat contoh lapisan Eksterior sebagai lapisan kerangka dalam paket gambar sampel.

Lapisan unit

File DWG untuk setiap tingkat mendefinisikan layer yang berisi unit. Unit-unitnya adalah ruang yang dapat dinavigasi di gedung seperti kantor, lorong, tangga, dan lift. Jika properti VerticalPenetrationCategory ditentukan, unit yang dapat dinavigasi yang mencakup beberapa tingkat, seperti lift dan tangga dikonversi ke fitur Penetrasi Vertikal. Fitur penetrasi vertikal yang saling tumpang tindih ditetapkan satu setid.

Lapisan Unit harus mematuhi persyaratan berikut:

Unit harus digambar sebagai POLYGON, POLYLINE (tertutup), CIRCLE, atau ELIPS (tertutup).
Unit harus masuk di dalam batas perimeter eksterior fasilitas.
Unit tidak boleh tumpang tindih sebagian.
Unit tidak boleh mengandung geometri yang berpotongan sendiri.

Beri nama unit dengan membuat objek teks di lapisan UnitLabel, lalu letakkan objek di dalam batas unit. Untuk informasi selengkapnya, lihat lapisan UnitLabel.

Anda dapat melihat contoh lapisan Unit dalam paket gambar sampel.

Lapisan dinding

File DWG untuk setiap tingkat dapat berisi lapisan yang menentukan tingkat fisik dinding, kolom, dan struktur bangunan lainnya.

Dinding harus digambar sebagai POLYGON, POLYLINE (tertutup), CIRCLE, atau ELIPS (tertutup).
Lapisan dinding atau lapisan hanya boleh mengandung geometri yang diartikan sebagai struktur bangunan.

Anda dapat melihat contoh lapisan Dinding dalam paket gambar sampel.

Lapisan pintu

Anda dapat menyertakan lapisan DWG yang berisi pintu. Setiap pintu harus tumpang tindih terhadap tepi unit dari lapisan Unit.

Pembuka pintu dalam himpunan data Azure Maps direpresentasikan sebagai segmen satu baris yang tumpang tindih dengan beberapa batas unit. Gambar berikut menunjukkan bagaimana Azure Maps mengonversi geometri lapisan pintu menjadi fitur pembukaan dalam himpunan data.

Empat grafik berikut menunjukkan langkah-langkah untuk menghasilkan pembuka

Lapisan zona

File DWG untuk setiap tingkat dapat berisi lapisan Zona yang menentukan tingkat fisik zona. Zona adalah ruang yang tidak dapat dinavigasi yang dapat diberi nama dan dirender. Zona dapat mencakup beberapa tingkat dan dikelompokkan bersama menggunakan properti zoneSetId.

Zona harus digambar sebagai POLYGON, POLYLINE (tertutup), atau ELIPS (tertutup).
Zona bisa tumpang tindih.
Zona dapat jatuh di dalam atau di luar perimeter eksterior fasilitas.

Berikan nama zona dengan membuat objek teks di lapisan ZoneLabel lalu tempatkan objek teks di dalam batas zona. Untuk informasi selengkapnya, lihat lapisan ZoneLabel.

Anda dapat melihat contoh lapisan Zona dalam paket gambar sampel.

Lapisan UnitLabel

File DWG untuk setiap tingkat dapat berisi layer UnitLabel. Lapisan UnitLabel menambahkan properti nama ke unit yang diekstrak dari layer Unit. Unit dengan properti nama dapat memiliki detail lebih lanjut yang ditentukan dalam file manifes.

Label unit harus entitas teks satu baris.
Label unit harus sepenuhnya berada di dalam batas unitnya.
Unit tidak boleh berisi beberapa entitas teks di lapisan UnitLabel.

Anda dapat melihat contoh lapisan UnitLabel dalam paket gambar sampel.

Lapisan ZoneLabel

File DWG untuk setiap tingkat dapat berisi lapisan UnitLabel. Lapisan ini menambahkan properti nama ke zona yang diekstrak dari lapisan Zona. Unit dengan properti nama dapat memiliki detail lebih lanjut yang ditentukan dalam file manifes.

Label unit harus berupa entitas teks satu baris.
Label unit harus berada di dalam batas unit mereka.
Unit tidak boleh berisi beberapa entitas teks di lapisan UnitLabel.

Anda dapat melihat contoh lapisan ZoneLabel dalam paket gambar sampel.

Persyaratan file manifes

Folder zip harus berisi file manifes di tingkat akar direktori, dan file harus diberi nama manifest.json. Ini menjelaskan file DWG untuk memungkinkan layanan Konversi mengurai kontennya. Hanya file yang diidentifikasi oleh manifes yang diserap. File yang ada di folder zip, tetapi tidak tercantum dengan benar dalam manifes, diabaikan.

Meskipun ada persyaratan ketika Anda menggunakan objek manifes, tidak semua objek diperlukan. Tabel berikut menunjukkan objek yang diperlukan dan opsional untuk versi 1.1 dari layanan Konversi.

Catatan

Kecuali ditentukan lain, semua properti dengan jenis properti string memungkinkan untuk seribu karakter.

Objek	Wajib	Deskripsi
`version`	benar	Versi skema manifes. Saat ini, hanya versi 1.1 yang didukung.
`directoryInfo`	benar	Menguraikan informasi geografis dan kontak fasilitas. Ini juga dapat digunakan untuk menguraikan informasi geografis dan kontak penghuni.
`buildingLevels`	benar	Menentukan tingkat bangunan dan file yang berisi desain tingkat.
`georeference`	benar	Berisi informasi geografis numerik untuk gambar fasilitas.
`dwgLayers`	benar	Mencantumkan nama lapisan, dan setiap lapisan mencantumkan nama fiturnya sendiri.
`unitProperties`	salah	Dapat digunakan untuk menyisipkan lebih banyak metadata untuk fitur unit.
`zoneProperties`	salah	Dapat digunakan untuk menyisipkan lebih banyak metadata untuk fitur unit.

Bagian berikutnya merinci persyaratan untuk setiap lapisan.

`directoryInfo`

Properti	Tipe	Wajib	Deskripsi
`name`	string	benar	Nama bangunan.
`streetAddress`	string	salah	Alamat bangunan.
`unit`	string	salah	Unit dalam bangunan.
`locality`	string	salah	Nama kota, kota, daerah, lingkungan, atau wilayah.
`adminDivisions`	String array JSON	salah	Array yang berisi sebutan alamat. Misalnya: (Negara, Negara Bagian) Gunakan kode negara ISO 3166 dan kode negara bagian/wilayah ISO 3166-2.
`postalCode`	string	salah	Kode pengurutan surat.
`hoursOfOperation`	string	salah	Mematuhi format Jam Buka OSM.
`phone`	string	salah	Nomor telepon yang terkait dengan gedung.
`website`	string	salah	Situs web yang terkait dengan bangunan.
`nonPublic`	bool	salah	Bendera menentukan apakah bangunan terbuka untuk umum.
`anchorLatitude`	numeric	salah	Lintang jangkar fasilitas (pushpin).
`anchorLongitude`	numeric	salah	Garis bujur jangkar fasilitas (pushpin).
`anchorHeightAboveSeaLevel`	numeric	salah	Ketinggian lantai dasar fasilitas di atas permukaan laut, dalam meter.
`defaultLevelVerticalExtent` numerik	salah	Tinggi default (ketebalan) tingkat fasilitas ini untuk digunakan ketika tingkat `verticalExtent` tidak terdefinisi.

`buildingLevels`

Objek buildingLevels berisi array tingkat bangunan JSON.

Properti	Tipe	Wajib	Deskripsi
`levelName`	string	benar	Nama tingkat deskriptif. Misalnya: Lantai 1, Lobi, Halaman Pakrir, atau Basement.
`ordinal`	Integer	benar	Menentukan urutan tingkat vertikal. Setiap fasilitas harus memiliki tingkat dengan 0 ordinal.
`heightAboveFacilityAnchor`	numeric	salah	Tinggi di atas jangkar dalam meter.
`verticalExtent`	numeric	salah	Tinggi dari lantai ke langit-langit (ketebalan) level dalam meter.
`filename`	string	benar	Jalur sistem file dari gambar CAD untuk tingkat bangunan. Sistem file tersebut haruslah relatif terhadap akar file zip bangunan.

`georeference`

Properti	Tipe	Wajib	Deskripsi
`lat`	numeric	benar	Representasi desimal lintang derajat di fasilitas asal gambar. Koordinat asal harus berada di WGS84 Web Mercator (`EPSG:3857`).
`lon`	numeric	benar	Representasi desimal lintang derajat di fasilitas asal gambar. Koordinat asal harus berada di WGS84 Web Mercator (`EPSG:3857`).
`angle`	numeric	benar	Sudut searah jarum jam, dalam derajat, antara arah utara dan sumbu vertikal gambar (Y).

`dwgLayers`

Properti	Tipe	Wajib	Deskripsi
`exterior`	array string	benar	Nama lapisan yang mendefinisikan profil bangunan eksterior.
`unit`	array string	salah	Nama lapisan yang mendefinisikan unit.
`wall`	array string	salah	Nama lapisan yang mendefinisikan dinding.
`door`	array string	salah	Nama lapisan yang mendefinisikan dinding.
`unitLabel`	array string	salah	Nama lapisan yang mendefinisikan nama unit.
`zone`	array string	salah	Nama lapisan yang mendefinisikan dinding.
`zoneLabel`	array string	salah	Nama lapisan yang mendefinisikan nama zona.

`unitProperties`

Objek unitProperties berisi array JSON properti unit.

Properti	Tipe	Wajib	Deskripsi
`unitName`	string	benar	Nama unit yang akan diasosiasikan dengan catatan `unitProperty` ini. Rekaman ini hanya valid ketika pencocokan label `unitName` ditemukan di lapisan `unitLabel`.
`categoryName`	string	salah	Purpose of the unit. Daftar nilai yang dapat digunakan oleh gaya penyajian yang disediakan didokumentasikan dalam categories.json.
`occupants`	array objek directoryInfo	salah	Daftar penghuni unit.
`nameAlt`	string	salah	Nama alternatif unit.
`nameSubtitle`	string	salah	Subtitel dari unit.
`addressRoomNumber`	string	salah	Nomor kamar, unit, apartemen, atau suite unit.
`verticalPenetrationCategory`	string	salah	Ketika properti ini ditentukan, fitur yang dihasilkan adalah penetrasi vertikal (VRT) daripada unit. Anda dapat menggunakan penetrasi vertikal untuk pergi ke fitur penetrasi vertikal lainnya di tingkat di atas atau di bawahnya. Penetrasi vertikal adalah nama Kategori. Jika properti ini didefinisikan, properti `categoryName` ditimpa dengan `verticalPenetrationCategory`.
`verticalPenetrationDirection`	string	salah	Jika `verticalPenetrationCategory` ditentukan, secara opsional tentukan arah perjalanan yang valid. Nilai yang diizinkan adalah `lowToHigh`, `highToLow`, `both` dan `closed`. Nilai defaultnya adalah `both`. Nilai ini peka huruf besar/kecil.
`nonPublic`	bool	salah	Menunjukkan apakah unit terbuka untuk umum.
`isRoutable`	bool	salah	Ketika properti ini diatur ke `false`, Anda tidak dapat menuju atau melalui unit. Nilai defaultnya adalah `true`.
`isOpenArea`	bool	salah	Memungkinkan agen navigasi untuk memasuki unit tanpa perlu pembukaan yang melekat pada unit. Secara default, nilai ini diatur ke unit `true` tanpa pembuka, dan `false` untuk unit dengan pembuka. Mengatur `isOpenArea` ke `false` secara manual pada unit tanpa bukaan menghasilkan peringatan, karena unit yang dihasilkan tidak dapat dijangkau oleh agen navigasi.

`zoneProperties`

Objek zoneProperties berisi array JSON properti unit.

Properti	Tipe	Wajib	Deskripsi
namaZona	string	benar	Nama zona yang akan diasosiasikan dengan rekaman `zoneProperty`. Rekaman ini valid ketika pencocokan label `zoneName` ditemukan di lapisan `zoneLabel` zona.
categoryName	string	salah	Tujuan zona tersebut. Daftar nilai yang dapat digunakan oleh gaya penyajian yang disediakan didokumentasikan dalam categories.json.
zoneNameAlt	string	salah	Nama alternatif unit.
zoneNameSubtitle	string	salah	Subtitel dari zona.
zoneSetId	string	salah	Atur ID untuk membuat hubungan di antara beberapa zona sehingga mereka dapat dikueri atau dipilih sebagai grup. Misalnya, zona yang mencakup beberapa tingkat.

Contoh manifes paket gambar

Berikut ini adalah file manifes untuk paket gambar sampel. Buka paket Gambar sampel untuk Pembuat Azure Maps di GitHub untuk mengunduh seluruh paket.

Berkas manifes

{
    "version": "1.1", 
    "directoryInfo": { 
        "name": "Contoso Building", 
        "streetAddress": "Contoso Way", 
        "unit": "1", 
        "locality": "Contoso eastside", 
        "postalCode": "98052", 
        "adminDivisions": [ 
            "Contoso city", 
            "Contoso state", 
            "Contoso country" 
        ], 
        "hoursOfOperation": "Mo-Fr 08:00-17:00 open", 
        "phone": "1 (425) 555-1234", 
        "website": "www.contoso.com", 
        "nonPublic": false, 
        "anchorLatitude": 47.636152, 
        "anchorLongitude": -122.132600, 
        "anchorHeightAboveSeaLevel": 1000, 
        "defaultLevelVerticalExtent": 3  
    }, 
    "buildingLevels": { 
        "levels": [ 
            { 
                "levelName": "Basement", 
                "ordinal": -1, 
                "filename": "./Basement.dwg" 
            }, { 
                "levelName": "Ground", 
                "ordinal": 0, 
                "verticalExtent": 5, 
                "filename": "./Ground.dwg" 
            }, { 
                "levelName": "Level 2", 
                "ordinal": 1, 
                "heightAboveFacilityAnchor": 3.5, 
                "filename": "./Level_2.dwg" 
            } 
        ] 
    }, 
    "georeference": { 
        "lat": 47.636152, 
        "lon": -122.132600, 
        "angle": 0 
    }, 
    "dwgLayers": { 
        "exterior": [ 
            "OUTLINE", "WINDOWS" 
        ], 
        "unit": [ 
            "UNITS" 
        ], 
        "wall": [ 
            "WALLS" 
        ], 
        "door": [ 
            "DOORS" 
        ], 
        "unitLabel": [ 
            "UNITLABELS" 
        ], 
        "zone": [ 
            "ZONES" 
        ], 
        "zoneLabel": [ 
            "ZONELABELS" 
        ] 
    }, 
    "unitProperties": [ 
        { 
            "unitName": "B01", 
            "categoryName": "room.office", 
            "occupants": [ 
                { 
                    "name": "Joe's Office", 
                    "phone": "1 (425) 555-1234" 
                } 
            ], 
            "nameAlt": "Basement01", 
            "nameSubtitle": "01", 
            "addressRoomNumber": "B01", 
            "nonPublic": true, 
            "isRoutable": true, 
            "isOpenArea": true 
        }, 
        { 
            "unitName": "B02" 
        }, 
        { 
            "unitName": "B05", 
            "categoryName": "room.office" 
        }, 
        { 
            "unitName": "STRB01", 
            "verticalPenetrationCategory": "verticalPenetration.stairs", 
            "verticalPenetrationDirection": "both" 
        }, 
        { 
            "unitName": "ELVB01", 
            "verticalPenetrationCategory": "verticalPenetration.elevator", 
            "verticalPenetrationDirection": "high_to_low" 
        } 
    ], 
    "zoneProperties": 
    [ 
        { 
            "zoneName": "WifiB01", 
            "categoryName": "Zone", 
            "zoneNameAlt": "MyZone", 
            "zoneNameSubtitle": "Wifi", 
            "zoneSetId": "1234" 
        }, 
        { 
            "zoneName": "Wifi101",
            "categoryName": "Zone",
            "zoneNameAlt": "MyZone",
            "zoneNameSubtitle": "Wifi",
            "zoneSetId": "1234"
        }
    ]
}

Untuk panduan tentang cara menyiapkan paket gambar Anda, lihat Panduan Paket Menggambar.

Perubahan dan Revisi

Menambahkan dukungan untuk kelas fitur yang ditentukan pengguna.
Persyaratan lapisan DWG yang disederhanakan.

Prasyarat

Paket gambar mencakup gambar yang disimpan dalam format DWG, yang merupakan format file asli untuk perangkat lunak AutoCAD® Autodesk.

Anda dapat memilih perangkat lunak CAD apa pun untuk menghasilkan gambar dalam paket gambar.

Layanan Konversi mengonversi paket gambar menjadi data peta. Layanan Konversi berfungsi dengan format file AutoCAD DWG AC1032.

Glosarium istilah

Untuk referensi yang mudah, berikut adalah beberapa istilah dan definisi yang penting saat Anda membaca artikel ini.

Term	Definisi
Lapisan	Lapisan AutoCAD DWG dari file gambar.
Entity	Entitas AutoCAD DWG dari file gambar.
Xref	File dalam format file DWG AutoCAD, dilampirkan ke gambar utama sebagai referensi eksternal.
Tingkat	Area fasilitas pada ketinggian yang ditetapkan. Misalnya, lantai fasilitas.
Fitur	Contoh objek yang dihasilkan dari layanan Konversi yang menggabungkan geometri dengan informasi metadata.
Kelas fitur	Cetak biru umum untuk fitur.

Struktur paket gambar

Paket gambar adalah arsip ZIP yang berisi file berikut:

File DWG dalam format file AutoCAD DWG.
File manifest.json yang menjelaskan file DWG dalam paket gambar.

Paket gambar harus dikompresi ke dalam satu file arsip, dengan ekstensi .zip. File DWG dapat diatur dengan cara apa pun di dalam paket gambar, tetapi file manifes harus berada di direktori akar. Bagian berikutnya menjelaskan proses konversi dan persyaratan untuk file DWG dan manifes, dan konten file-file ini. Untuk melihat paket sampel, Anda dapat mengunduh paket gambar sampel v2.

Proses konversi file DWG

Layanan Konversi Azure Maps mengonversi file DWG dari fasilitas untuk memetakan data yang mewakili fasilitas dan fitur fasilitas.

Layanan Konversi Azure Maps membuat:

Fitur Fasilitas: Fitur tingkat atas fasilitas yang dikaitkan dengan semua tingkat fasilitas.
Fitur tingkat: Fitur Satu Tingkat dibuat untuk setiap lantai fasilitas. Semua fitur pada tingkat dikaitkan dengan tingkat.
Fitur yang ditentukan pengguna: Lapisan DWG dipetakan ke kelas fitur yang ditentukan pengguna dan menjadi instans kelas fitur.

Persyaratan file DWG

Setiap file DWG harus mematuhi persyaratan ini:

File DWG tidak dapat berisi fitur dari beberapa fasilitas.
File DWG tidak dapat berisi fitur dari beberapa level. Misalnya, fasilitas dengan tiga tingkat memiliki tiga file DWG dalam paket gambar.
Semua data dari satu tingkat harus terkandung dalam satu file DWG. Setiap referensi eksternal (xrefs) harus terikat ke gambar induk.
File DWG harus menentukan lapisan yang mewakili batas tingkat tersebut.
DWG harus mereferensikan sistem pengukuran dan satuan pengukuran yang sama dengan file DWG lainnya dalam paket gambar.
File DWG harus diselaraskan ketika ditumpuk di atas tingkat lain dari fasilitas yang sama.

Persyaratan lapisan DWG

Kelas fitur

Satu atau beberapa lapisan DWG dapat dipetakan ke kelas fitur yang ditentukan pengguna. Satu instans fitur dibuat dari entitas pada lapisan yang dipetakan. Misalnya, kursi lapisan DWG, meja, dan sofa dipetakan ke kelas fitur yang disebut furnitur. Fitur furnitur dibuat untuk setiap entitas dari lapisan yang ditentukan. Selain itu:

Semua lapisan harus dipisahkan untuk mewakili berbagai jenis fitur fasilitas.
Semua entitas harus berada di dalam batas perimeter tingkat.
Jenis entitas AutoCAD yang didukung: TEXT, MTEXT, POINT, ARC, CIRCLE, LINE, POLYLINE, ELLIPSE.

Properti kelas fitur

Entitas teks yang termasuk dalam batas bentuk tertutup dapat dikaitkan dengan fitur tersebut sebagai properti. Misalnya, kelas fitur ruangan mungkin memiliki teks yang menjelaskan nama ruangan dan paket gambar sampel jenis ruangan lainnya v2. Selain itu:

Hanya entitas TEXT dan MTEXT yang terkait dengan fitur sebagai properti. Semua jenis entitas lainnya diabaikan.
Titik pembenaran TEXT dan MTEXT harus berada dalam batas bentuk tertutup.
Jika lebih dari satu properti TEXT berada dalam batas bentuk tertutup dan keduanya dipetakan ke satu properti, properti dipilih secara acak.

Tingkat fasilitas

File DWG untuk setiap tingkat harus berisi lapisan untuk menentukan perimeter tingkat tersebut. Misalnya, jika fasilitas berisi dua tingkat, maka perlu memiliki dua file DWG, masing-masing dengan lapisan yang menentukan perimeter tingkat tersebut.

Tidak peduli berapa banyak gambar entitas di lapisan perimeter tingkat, himpunan data fasilitas yang dihasilkan hanya berisi fitur satu tingkat untuk setiap file DWG. Selain itu:

Perimeter tingkat harus digambar sebagai POLYGON, POLYLINE (tertutup), CIRCLE, atau ELIPS (tertutup).
Perimeter tingkat dapat tumpang tindih tetapi dilarutkan ke dalam satu geometri.
Fitur tingkat yang dihasilkan harus setidaknya 4 meter persegi.
Fitur tingkat yang dihasilkan tidak boleh lebih besar dari 400.000 meter persegi.

Jika lapisan berisi beberapa POLYLINES yang tumpang tindih, lapisan tersebut digabungkan ke dalam satu fitur Level. Sebaliknya, jika lapisan berisi beberapa POLYLINES yang tidak tumpang tindih, fitur Level yang dihasilkan memiliki representasi multi-poligonal.

Anda dapat melihat contoh lapisan perimeter Tingkat sebagai GROS$ lapisan dalam paket gambar sampel v2.

Persyaratan file manifes

Paket gambar harus berisi file manifes di tingkat akar dan file harus diberi nama manifest.json. Ini menjelaskan file DWG yang memungkinkan layanan Konversi untuk mengurai kontennya. Hanya file yang diidentifikasi oleh manifes yang digunakan. File yang ada dalam paket gambar, tetapi tidak tercantum dengan benar dalam manifes, diabaikan.

Jalur file dalam objek buildingLevels dari file manifes harus relatif terhadap akar paket gambar. Nama file DWG harus sama persis dengan nama tingkat fasilitas. Misalnya, file DWG untuk tingkat "Basement" Basement.dwg. File DWG untuk tingkat 2 dinamai sebagai level_2.dwg. Nama file tidak boleh berisi spasi, Anda dapat menggunakan garis bawah untuk mengganti spasi apa pun.

Meskipun ada persyaratan ketika Anda menggunakan objek manifes, tidak semua objek diperlukan. Tabel berikut menunjukkan objek yang diperlukan dan opsional untuk layanan Konversi pratinjau 2023-03-01.

Catatan

Kecuali ditentukan lain, semua properti string dibatasi hingga seribu karakter.

File JSON manifes

Properti	Tipe	Wajib	Deskripsi
`version`	string	BENAR	Versi skema manifes. Saat ini versi "2.0"
`buildingLevels`	Objek BuildingLevels	BENAR	Menentukan tingkat fasilitas dan file yang berisi desain tingkat.
`featureClasses`	Array objek featureClass	BENAR	Daftar objek kelas fitur yang menentukan bagaimana lapisan dibaca dari file gambar DWG.
`georeference`	Objek georeferensi	SALAH	Berisi informasi geografis numerik untuk gambar fasilitas.
`facilityName`	string	SALAH	Nama fasilitas.

Bagian berikutnya merinci persyaratan untuk setiap lapisan.

buildingLevels

Properti	Tipe	Wajib	Deskripsi
`dwgLayers`	Array string	BENAR	Nama lapisan yang menentukan profil eksterior fasilitas.
`levels`	Array objek tingkat	BENAR	Tingkat mengacu pada lantai unik di fasilitas yang ditentukan dalam file DWG, tinggi setiap tingkat dan urutan vertikal tempat mereka muncul.

tingkat

Properti	Tipe	Wajib	Deskripsi
`levelName`	string	BENAR	Nama tingkat. Misalnya: Lantai 1, Lobi, Halaman Pakrir, atau Basement.
`ordinal`	Integer	BENAR	Menentukan urutan tingkat vertikal. Semua `ordinal` nilai harus unik dalam fasilitas.
`filename`	string	BENAR	Jalur dan nama file DWG yang mewakili tingkat di fasilitas. Jalur harus relatif terhadap akar paket gambar.
`verticalExtent`	number	SALAH	Tinggi vertikal lantai ke langit-langit (ketebalan) tingkat dalam meter.

featureClass

Properti	Tipe	Wajib	Deskripsi
`dwgLayers`	Array string	BENAR	Nama setiap lapisan yang menentukan kelas fitur. Setiap entitas pada lapisan yang ditentukan dikonversi ke instans kelas fitur. Nama `dwgLayer` tempat fitur dikonversi dari akhirnya sebagai properti fitur tersebut.
`featureClassName`	String	BENAR	Nama kelas fitur. Contoh umumnya termasuk ruangan, ruang kerja, atau dinding.
`featureClassProperties`	Array objek featureClassProperty	SALAH	Menentukan lapisan teks dalam file DWG yang terkait dengan fitur sebagai properti. Misalnya, label yang berada di dalam batas spasi, seperti nomor ruangan.

featureClassProperty

Properti	Tipe	Wajib	Deskripsi
`dwgLayers`	Array string	BENAR	Nama setiap lapisan yang menentukan properti kelas fitur. Setiap entitas pada lapisan yang ditentukan dikonversi ke properti. Hanya entitas DWG TEXT dan MTEXT yang dikonversi ke properti. Semua entitas lain diabaikan.
`featureClassPropertyName`	String	BENAR	Nama properti kelas fitur, misalnya, spaceName atau spaceUseType.

georeferensi

Properti	Tipe	Wajib	Deskripsi
`lat`	number	BENAR	Representasi desimal lintang derajat di fasilitas asal gambar. Koordinat asal harus berada di WGS84 Web Mercator (EPSG:3857).
`lon`	number	BENAR	Representasi desimal lintang derajat di fasilitas asal gambar. Koordinat asal harus berada di WGS84 Web Mercator (EPSG:3857).
`angle`	number	BENAR	Sudut searah jarum jam, dalam derajat, antara arah utara dan sumbu vertikal gambar (Y).

Contoh manifes paket gambar

JSON dalam contoh ini menunjukkan file manifes untuk paket gambar sampel. Buka paket gambar sampel v2 untuk Azure Maps Creator di GitHub untuk mengunduh seluruh paket.

Berkas manifes

{
  "version": "2.0",
  "buildingLevels": {
    "dwgLayers": [
      "GROS$"
    ],
    "levels": [
      {
        "filename": "Ground.dwg",
        "levelName": "level 1",
        "ordinal": 0
      },
      {
        "filename": "Level_2.dwg",
        "levelName": "level 2",
        "ordinal": 1
      }
    ]
  },
  "georeference": {
    "lat": 47.63529901,
    "lon": -122.13355885,
    "angle": 0
  },
  "featureClasses": [
    {
      "featureClassName": "room",
      "dwgLayers": [
        "RM$"
      ],
      "featureClassProperties": [
        {
          "featureClassPropertyName": "name",
          "dwgLayers": [
            "A-IDEN-NUMR-EXST"
          ]
        },
        {
          "featureClassPropertyName": "roomType",
          "dwgLayers": [
            "A-IDEN-NAME-EXST"
          ]
        }
      ]
    },
    {
      "featureClassName": "wall",
      "dwgLayers": [
        "A-WALL-EXST",
        "A-WALL-CORE-EXST",
        "A-GLAZ-SILL-EXST",
        "A-GLAZ-SHEL-SILL-EXST",
        "A-GLAZ-SHEL-EXST",
        "A-GLAZ-EXST"
      ]
    },
    {
      "featureClassName": "workspace",
      "dwgLayers": [
        "A-BOMA"
      ]
    },
    {
      "featureClassName": "workspaceFurniture",
      "dwgLayers": [
        "A-FURN-SYTM-EXST"
      ]
    },
    {
      "featureClassName": "buildingFurniture",
      "dwgLayers": [
        "A-FURN-FREE-EXST"
      ]
    }
  ],
  "facilityName": "Contoso Building"
}

Langkah berikutnya

Untuk panduan tentang cara menyiapkan paket gambar Anda, lihat panduan paket gambar.

Panduan paket menggambar

Bagikan melalui

Persyaratan paket menggambar

Prasyarat

Glosarium istilah

Struktur paket gambar

Proses konversi file DWG

Persyaratan file DWG

Persyaratan lapisan DWG

Lapisan eksterior

Lapisan unit

Lapisan dinding

Lapisan pintu

Lapisan zona

Lapisan UnitLabel

Lapisan ZoneLabel

Persyaratan file manifes

directoryInfo

buildingLevels

georeference

dwgLayers

unitProperties

zoneProperties

Contoh manifes paket gambar

Berkas manifes

Perubahan dan Revisi

Prasyarat

Glosarium istilah

Struktur paket gambar

Proses konversi file DWG

Persyaratan file DWG

Persyaratan lapisan DWG

Kelas fitur

Properti kelas fitur

Tingkat fasilitas

Persyaratan file manifes

File JSON manifes

buildingLevels

tingkat

featureClass

featureClassProperty

georeferensi

Contoh manifes paket gambar

Berkas manifes

Langkah berikutnya

Saran dan Komentar

Sumber Daya Tambahan:

`directoryInfo`

`buildingLevels`

`georeference`

`dwgLayers`

`unitProperties`

`zoneProperties`