Bagikan melalui

Menggambar kesalahan konversi dan peringatan

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

Layanan Konversi Azure Maps memungkinkan Anda mengonversi paket gambar yang diunggah menjadi data peta. Paket Menggambar harus mematuhi persyaratan paket Menggambar. Jika satu atau beberapa persyaratan tidak terpenuhi, maka layanan Konversi mengembalikan kesalahan atau peringatan. Artikel ini mencantumkan kesalahan konversi dan kode peringatan, dengan rekomendasi tentang cara mengatasinya. Artikel ini juga menyediakan beberapa contoh gambar yang dapat menyebabkan layanan Konversi mengembalikan kode-kode ini.

Layanan Konversi berhasil jika ada peringatan konversi. Namun, disarankan agar Anda meninjau dan menyelesaikan semua peringatan. Peringatan berarti bagian dari konversi diabaikan atau diperbaiki secara otomatis. Gagal menyelesaikan peringatan dapat mengakibatkan kesalahan dalam proses terakhir.

Peringatan Umum

geometryWarning

Deskripsi untuk geometryWarning

geometryWarning terjadi ketika gambar berisi entitas yang tidak valid. Entitas yang tidak valid adalah entitas yang tidak sesuai dengan batasan geometris. Contoh entitas yang tidak valid adalah poligon yang berpotensi sendiri atau PolyLine terbuka dalam lapisan yang hanya mendukung geometri tertutup.

Layanan Konversi tidak dapat membuat fitur peta dari entitas yang tidak valid dan sebagai gantinya diabaikan.

Contoh untuk geometryWarning

  • Dua gambar berikut menunjukkan contoh poligon yang bersinggungan sendiri.

    Contoh poligon yang berpotongan sendiri, contoh satu.

    Contoh poligon yang berpotongan sendiri, contoh dua.

  • Gambar berikut menunjukkan PolyLine terbuka. Asumsikan bahwa lapisan hanya mendukung geometri tertutup.

    Contoh PolyLine terbuka

Cara memperbaiki geometryWarning

Periksa geometryWarning untuk setiap entitas untuk memeriksa bahwa itu mengikuti batasan geometris.

unexpectedGeometryInLayer

Deskripsi untuk unexpectedGeometryInLayer

Peringatan unexpectedGeometryInLayer terjadi ketika gambar mengandung geometri yang tidak kompatibel dengan jenis geometri yang diharapkan untuk lapisan tertentu. Saat layanan Konversi mengembalikan peringatan UnexpectedGeometryInLayer , layanan tersebut mengabaikan geometri tersebut.

Contoh untuk unexpectedGeometryInLayer

Gambar berikut menunjukkan PolyLine terbuka. Asumsikan bahwa lapisan hanya mendukung geometri tertutup.

Contoh PolyLine terbuka

Cara memperbaiki unexpectedGeometryInLayer

Periksa setiap peringatan unexpectedGeometryInLayer dan pindahkan geometri yang tidak kompatibel ke lapisan yang kompatibel. Jika tidak kompatibel dengan lapisan lain, itu harus dihapus.

unsupportedFeatureRepresentation

Deskripsi untuk unsupportedFeatureRepresentation

Peringatan unsupportedFeatureRepresentation terjadi ketika gambar berisi jenis entitas yang tidak didukung.

Contoh untuk unsupportedFeatureRepresentation

Gambar berikut menunjukkan jenis entitas yang tidak didukung sebagai objek teks multibaris pada lapisan label.

Contoh objek teks multibaris pada lapisan label

Cara memperbaiki unsupportedFeatureRepresentation

Pastikan file DWG Anda hanya berisi jenis entitas yang didukung. Jenis yang didukung tercantum di bawah bagian Persyaratan file gambar di artikel persyaratan paket gambar.

automaticRepairPerformed

Deskripsi untuk automaticRepairPerformed

Peringatan automaticRepairPerformed terjadi ketika layanan Konversi secara otomatis memperbaiki geometri yang tidak valid.

Contoh untuk automaticRepairPerformed

  • Gambar berikut menunjukkan bagaimana layanan Konversi memperbaiki poligon yang berpotongan sendiri menjadi geometri yang valid.

    Contoh poligon yang berpotongan sendiri yang diperbaiki

  • Gambar berikut menunjukkan layanan Konversi snapping puncak pertama dan terakhir dari PolyLine terbuka untuk membuat PolyLine tertutup, di mana vertex pertama dan terakhir kurang dari 1 mm terpisah.

    Contoh PolyLine yang dilekatkan

  • Gambar berikut menunjukkan caranya, dalam lapisan yang hanya mendukung PolyLines tertutup, layanan Konversi memperbaiki beberapa PolyLines terbuka. Untuk menghindari pembuangan PolyLines yang terbuka, layanan menggabungkannya menjadi satu PolyLine tertutup.

    Contoh Polyline terbuka yang digabungkan menjadi satu PolyLine tertutup

Cara memperbaiki automaticRepairPerformed

Untuk memperbaiki peringatan automaticRepairPerformed, ambil tindakan berikut:

  1. Periksa setiap peringatan geometri dan peringatan teks tertentu.
  2. Tentukan apakah perbaikan otomatis sudah benar.
  3. Jika perbaikannya benar, lanjutkan. Jika tidak, buka file desain dan atasi peringatan secara manual.

Tip

Untuk menekan peringatan di masa depan, lakukan perubahan pada gambar asli sehingga gambar asli cocok dengan gambar yang diperbaiki.

Peringatan manifes

redundantAttribution

Deskripsi untuk redundantAttribution

Peringatan redundantAttribution terjadi ketika manifes mengandung sifat objek yang berlebihan atau bertentangan.

Contoh untuk redundantAttribution

  • Contoh JSON berikut berisi dua objek atau lebih unitProperties dengan name.

    "unitProperties": [
    {
        "unitName": "L1-100",
        "categoryName": "room.office"
    },
    {
        "unitName": "L1-101",
        "categoryName": "room.office"
    },
    {
        "unitName": "L1-101",
        "categoryName": "room.office"
    }
]

  • Dalam cuplikan JSON berikut, dua objek atau lebih zoneProperties memiliki yang sama name.

     "zoneProperties": [
    {
        "zoneName": "Assembly Area 1",
        "categoryName": "zone.assembly"
    },
    {
        "zoneName": "Assembly Area 2",
        "categoryName": "zone.assembly"
    },
    {
        "zoneName": "Assembly Area 2",
        "categoryName": "zone.assembly"
    }

Cara memperbaiki redundantAttribution

Untuk memperbaiki peringatan *redundantAttribution, hapus properti objek yang berlebihan atau bertentangan.

manifestWarning

Deskripsi untuk manifestWarning

ManifestWarning terjadi ketika manifes berisi objek unitProperties atau zoneProperties yang tidak digunakan selama konversi.

Contoh untuk manifestWarning

  • Manifes berisi objek unitProperties dengan unitName yang tidak memiliki label yang cocok dalam lapisan unitLabel.

  • Manifes berisi objek zoneProperties dengan zoneName yang tidak memiliki label yang cocok dalam lapisan zoneLabel.

Cara memperbaiki manifestWarning

Untuk memperbaiki manifesWarning, hapus objek unitProperties atau zonePropertiesyang tidak digunakan dari manifes, atau tambahkan label unit/zona ke gambar sehingga objek properti digunakan selama konversi.

Peringatan dinding

wallOutsideLevel

Deskripsi untuk wallOutsideLevel

Peringatan wallOutsideLevel terjadi ketika gambar berisi geometri Dinding di luar batas tingkat garis luar.

Contoh untuk wallOutsideLevel

  • Gambar berikut menunjukkan dinding interior, berwarna merah, di luar batas tingkat kuning.

    Contoh dinding interior di luar tingkat batas

  • Gambar berikut menunjukkan dinding eksterior, berwarna merah, di luar tingkat batas kuning.

    Contoh dinding eksterior di luar tingkat batas

Cara memperbaiki wallOutsideLevel

Untuk memperbaiki peringatan wallOutsideLevel, perluas geometri tingkat untuk menyertakan semua dinding. Atau, ubah batas dinding agar pas di dalam tingkat batas.

Peringatan unit

unitOutsideLevel

Deskripsi untuk unitOutsideLevel

Peringatan unitOutsideLevel terjadi ketika gambar berisi geometri unit di luar batas tingkat garis luar.

Contoh untuk unitOutsideLevel

Dalam gambar berikut, geometri unit, berwarna merah, melebihi batas tingkat kuning.

Contoh unit yang melebihi tingkat batas

Cara memperbaiki unitOutsideLevel

Untuk memperbaiki peringatan unitOutsideLevel, perluas tingkat batas untuk menyertakan semua unit. Atau, modifikasi geometri unit agar pas di dalam tingkat batas.

partiallyOverlappingUnit

Deskripsi untuk partiallyOverlappingUnit

Peringatan partiallyOverlappingUnit terjadi ketika gambar berisi geometri unit yang sebagian tumpang tindih pada geometri unit lain. Layanan Konversi membuang unit yang tumpang tindih.

Contoh skenario partiallyOverlappingUnit

Pada gambar berikut, unit yang tumpang tindih disorot dengan warna merah. UNIT110 dan HALLWAY dibuang.

Contoh unit yang tumpang tindih

Cara memperbaiki partiallyOverlappingUnit

Untuk memperbaiki peringatan partiallyOverlappingUnit, gambar ulang setiap bagian unit yang tumpang tindih sehingga tidak tumpang tindih dengan unit lain.

Peringatan pintu

doorOutsideLevel

Deskripsi untuk doorOutsideLevel

Peringatan doorOutsideLevel terjadi ketika gambar berisi geometri pintu di luar batas tingkat geometri.

Contoh untuk doorOutsideLevel

Dalam gambar berikut, geometri pintu, disorot dengan warna merah, tumpang tindih dengan tingkat batas kuning.

Contoh pintu yang tumpang tindih dengan tingkat batas

Cara memperbaiki doorOutsideLevel

Untuk memperbaiki peringatan doorOutsideLevel, gambar ulang geometri pintu Anda sehingga berada di dalam tingkat batas.

Peringatan zona

zoneWarning

Deskripsi untuk zoneWarning

ZoneWarning terjadi ketika zona tidak berisi label. Layanan Konversi membuang zona yang bukan label.l

Contoh untuk zoneWarning

Gambar berikut menunjukkan zona yang tidak berisi label.

Contoh zona tidak berisi label

Cara memperbaiki zoneWarning

Untuk memperbaiki zoneWarning, periksa bahwa setiap zona memiliki label tunggal.

Peringatan Label

labelWarning

Deskripsi untuk labelWarning

LabelWarning terjadi ketika gambar berisi fitur label ambigu atau kontradiktif.

LabelWarning terjadi karena satu atau beberapa alasan berikut:

  • Label unit tidak ada di unit mana pun.
  • Label zona tidak berada di zona mana pun.
  • Label zona berada di dalam dua atau beberapa zona.

Contoh untuk labelWarning

Gambar berikut menunjukkan label yang berada di dalam dua zona.

Contoh label di dalam dua zona

Cara memperbaiki labelWarning

Untuk memperbaiki labelWarning, pastikan bahwa:

  • Semua label unit berada di dalam unit.
  • Semua label zona berada di dalam zona.
  • Semua label zona berada dalam satu dan hanya satu zona.

Kesalahan Paket Menggambar

invalidArchiveFormat

Deskripsi untuk invalidArchiveFormat

Kesalahan invalidArchiveFormat terjadi saat paket menggambar berada dalam format arsip yang tidak valid seperti GZIP atau 7-Zip. Hanya format arsip ZIP yang didukung.

Kesalahan invalidArchiveFormat juga terjadi jika arsip ZIP kosong.

Cara memperbaiki InvalidArchiveFormat

Untuk memperbaiki kesalahan invalidArchiveFormat, periksa bahwa:

  • Nama file arsip Anda diakhiri .zip.
  • Arsip ZIP Anda berisi data.
  • Anda dapat membuka arsip ZIP Anda.

invalidUserData

Deskripsi untuk invalidUserData

Kesalahan InvalidUserData terjadi ketika layanan Konversi tidak dapat membaca objek data pengguna dari penyimpanan.

Contoh skenario untuk invalidUserData

Anda mencoba mengunggah paket gambar dengan parameter yang salah udid .

Cara memperbaiki invalidUserData

Untuk memperbaiki kesalahan invalidUserData, periksa bahwa:

  • Anda telah memberikan udid yang benar untuk paket yang diunggah.
  • Azure Maps Creator telah diaktifkan untuk akun Azure Maps yang Anda gunakan untuk mengunggah paket gambar.
  • Permintaan API ke layanan Konversi berisi kunci langganan ke akun Azure Maps yang Anda gunakan untuk mengunggah paket gambar.

dwgError

Deskripsi untuk dwgError

DwgError ketika paket menggambar berisi masalah dengan satu atau beberapa file DWG dalam arsip ZIP yang diunggah.

DwgError terjadi ketika paket gambar berisi file DWG yang tidak dapat dibuka karena tidak valid atau rusak.

  • File DWG bukan gambar format file DWG AutoCAD yang valid.
  • File DWG rusak.
  • File DWG tercantum dalam filemanifest.json, tetapi hilang dari arsip ZIP.

Cara memperbaiki dwgError

Untuk memperbaiki dwgError, periksa file manifest.json Anda dan konfirmasikan bahwa:

  • Semua file DWG dalam arsip ZIP Anda adalah gambar format DWG AutoCAD yang valid, buka satu per satu di AutoCAD. Hapus atau perbaiki semua gambar yang tidak valid.
  • Daftar file DWG di manifest.json cocok dengan file DWG di arsip ZIP.

Kesalahan manifes

invalidJsonFormat

Deskripsi untuk invalidJsonFormat

Kesalahan invalidJsonFormat terjadi ketika file manifest.json tidak dapat dibaca.

_manifest.json_file tidak dapat dibaca karena pemformatan JSON atau galat sintaksis. Untuk mempelajari selengkapnya tentang bagaimana format dan sintaks JSON, lihat Format Pertukaran Data JavaScript Object Notation (JSON).

Cara memperbaiki invalidJsonFormat

Untuk memperbaiki kesalahan invalidJsonFormat, gunakan linter JSON untuk mendeteksi dan mengatasi kesalahan JSON.

missingRequiredField

Deskripsi untuk missingRequiredField

Kesalahan missingRequiredField terjadi ketika file manifest.json data yang diperlukan hilang.

Cara memperbaiki missingRequiredField

Untuk memperbaiki kesalahan missingRequiredField, verifikasi bahwa manifes berisi semua properti yang diperlukan. Untuk daftar lengkap objek manifes yang diperlukan, lihat bagian manifes di persyaratan paket Gambar.

missingManifest

Deskripsi untuk missingManifest

Kesalahan missingManifest terjadi ketika file manifest.json hilang dari arsip ZIP.

Kesalahan missingManifest terjadi karena satu atau beberapa alasan berikut:

  • File manifest.json salah eja.
  • manifest.json hilang.
  • manifest.json tidak ada di dalam direktori root arsip ZIP.

Cara memperbaiki missingManifest

Untuk memperbaiki kesalahan missingManifest, konfirmasikan bahwa arsip memiliki file bernama manifest.json di tingkat root arsip ZIP.

Konflik

Deskripsi untuk konflik

Kesalahan konflik terjadi ketika file manifest.json memuat informasi yang berkonflik.

Contoh skenario untuk konflik

Layanan Konversi mengembalikan kesalahan konflik ketika lebih dari satu tingkat didefinisikan dengan tingkat ordinal yang sama. Cuplikan JSON berikut menunjukkan dua tingkat yang ditentukan dengan ordinal yang sama.

"buildingLevels":
{
    "levels": [
        {
            "levelName": "Ground",
            "ordinal": 0,
            "filename": "./Level_0.dwg"
        },
        {
            "levelName": "Parking",
            "ordinal": 0,
            "filename": "./Level_P.dwg"
        }
    ]
}

Cara memperbaiki konflik

Untuk memperbaiki kesalahan konflik, periksa manifest.json Anda dan hapus informasi yang berkonflik.

invalidGeoreference

Deskripsi untuk invalidGeoreference

Kesalahan invalidGeoreference terjadi ketika file manifest.json berisi georeferensi yang tidak valid.

Kesalahan invalidGeoreference terjadi karena satu atau beberapa alasan berikut:

  • Pengguna melakukan georeferensi nilai lintang atau bujur yang berada di luar rentang.
  • Pengguna melakukan georeferensi nilai rotasi yang berada di luar rentang.

Contoh skenario untuk invalidGeoreference

Dalam cuplikan JSON berikut, garis lintang berada di atas batas atas.

"georeference"
{
    "lat": 88.0,
    "lon": -122.132600,
    "angle": 0
},

Cara memperbaiki invalidGeoreference

Untuk memperbaiki kesalahan invalidGeoreference, verifikasi bahwa nilai georeferensi berada dalam rentang.

Penting

Di GeoJSON, urutan koordinatnya adalah garis bujur dan garis lintang. Jika Anda tidak menggunakan urutan yang benar, Anda mungkin secara tidak sengaja merujuk nilai garis lintang atau garis bujur yang berada di luar rentang.

Kesalahan dinding

wallErrors

Deskripsi untuk wallError

WallError terjadi ketika gambar berisi kesalahan saat mencoba membuat fitur dinding.

Contoh skenario untuk wallError

Gambar berikut menampilkan fitur dinding yang tidak tumpang tindih dengan unit apa pun.

Contoh fitur Dinding yang tidak tumpang tindih dengan unit apa pun

Cara memperbaiki wallError

Untuk memperbaiki kesalahan wallError, gambar ulang dinding yang tumpang tindih setidaknya satu unit. Atau, buat unit baru yang tumpang tindih dengan dinding.

Kesalahan Penetrasi Vertikal

vertikalPenetrationError

Deskripsi untuk vertikalPenetrationError

VertikalPenetrationError terjadi ketika gambar berisi fitur penetrasi vertikal yang ambigu.

VertikalPenetrationError terjadi karena satu atau beberapa alasan berikut:

  • Gambar berisi area penetrasi vertikal tanpa area penetrasi vertikal yang tumpang tindih pada tingkat apa pun di atas atau di bawahnya.
  • Paket gambar berisi tingkat dengan dua atau beberapa fitur penetrasi vertikal di atasnya yang keduanya tumpang tindih dengan fitur penetrasi vertikal tunggal pada tingkat lain tepat di atas atau di bawahnya.

Contoh skenario untuk verticalPenetrationError

Gambar berikut menunjukkan area penetrasi vertikal tanpa area penetrasi vertikal yang tumpang tindih pada tingkat di atas atau di bawahnya.

Contoh penetrasi vertikal 1

Gambar berikut menunjukkan area penetrasi vertikal yang tumpang tindih lebih dari satu area penetrasi vertikal pada tingkat yang berdekatan.

Contoh penetrasi vertikal 2

Cara memperbaiki verticalPenetrationError

Untuk memperbaiki kesalahan verticalPenetrationError, baca tentang cara menggunakan fitur penetrasi vertikal di artikel Persyaratan paket menggambar.

Langkah berikutnya

Cara menggunakan penampil visual kesalahan Menggambar Azure Maps

Panduan paket menggambar

Kreator untuk pemetaan dalam ruangan