SFCSpatial Format Converter
QGIS · Plugin 26.01

Panduan resmi untuk QGIS

Official QGIS guide

Spatial Format Converter

Ekstensi interoperabilitas geospasial untuk QGIS yang mengotomatisasi konversi SHP, CAD, dan KML/KMZ melalui validasi geometri poligon, transformasi referensi koordinat, serta pemetaan atribut terpilih secara konsisten.

A geospatial interoperability extension for QGIS that automates SHP, CAD, and KML/KMZ conversion through polygon-geometry validation, coordinate-reference transformation, and consistent mapping of selected attributes.

Mulai instalasiStart installation Halaman aktivasiActivation page

Antarmuka plugin versi 26.01

Plugin interface version 26.01

Tampilan panduan berikut mengikuti susunan plugin terbaru: identitas dan status di bagian atas, sumber dan atribut di kiri, CRS dan output di kanan, serta Activity Log di bagian bawah.

This guide mirrors the current plugin layout: identity and status at the top, source and attributes on the left, CRS and output on the right, and the Activity Log at the bottom.

Sumber dan atributFile, format, layer batas, serta field semantik terpilih.
CRS dan outputTransformasi koordinat, format, folder, dan nama hasil.
Status dan logAktivasi, layanan, pesan proses, dan diagnosis error.
Source and attributesFile, format, boundary layer, and selected semantic fields.
CRS and outputCoordinate transformation, format, folder, and output name.
Status and logActivation, service, processing messages, and error diagnostics.

Deskripsi SFC untuk QGIS

Spatial Format Converter (SFC) merupakan ekstensi interoperabilitas geospasial untuk QGIS yang mengorkestrasi konversi SHP, DWG/DXF/DGN, dan KML/KMZ dengan validasi geometri poligon, harmonisasi sistem referensi koordinat, serta pemetaan atribut semantik yang terkendali. Hasilnya adalah dataset lintas format yang konsisten, terstruktur, dan siap digunakan dalam analisis spasial.

Geometri poligon

Output spasial dibentuk dan divalidasi sebagai poligon sesuai sumber serta parameter yang dipilih.

Atribut bermakna

Hanya field atau layer semantik yang dipilih pengguna yang dipertahankan dalam hasil.

Konversi CAD

Setiap field terpilih menjadi satu layer DXF. Garis bidang dan nilai atribut ditempatkan pada layer tersebut sebagai MTEXT yang tersusun vertikal.

Antarmuka ringkas

Pilihan field dan layer disajikan dalam satu area seleksi dengan Select All dan Unselect All.

Persyaratan sistem

KomponenPersyaratanKeterangan
Sistem operasiWindows 10/11 64-bitGunakan akun yang memiliki hak tulis pada profil QGIS dan folder output.
AplikasiQGIS Desktop 3.22–3.99QGIS versi LTR atau Stable yang masih didukung disarankan.
ProcessingAktifPlugin Processing dan provider algoritma bawaan harus dapat dimuat.
GDAL/OGRMengikuti paket QGISKetersediaan driver tertentu, terutama CAD, bergantung pada build QGIS.
InternetDiperlukan saat aktivasiKoneksi stabil diperlukan untuk membuka layanan aktivasi dan panduan daring.
Catatan CAD.

Dukungan pembacaan DWG/DGN dapat berbeda antarbuild QGIS. Jika format tidak terbaca, simpan ulang sumber sebagai DXF yang kompatibel tanpa mengubah sistem koordinat atau topologi batas.

Cara instalasi plugin

Metode utama — Install from ZIP

  1. Simpan paket plugin. Unduh file ZIP SFC ke folder lokal. Jangan diekstrak untuk metode ini.
  2. Buka Plugin Manager. Pada QGIS pilih Plugins → Manage and Install Plugins….
  3. Pilih Install from ZIP. Klik tombol telusur, pilih paket ZIP SFC, lalu tekan Install Plugin.
  4. Konfirmasi keamanan. Jika QGIS menampilkan peringatan instalasi pihak ketiga, lanjutkan hanya jika paket berasal dari Ruang Spasial.
  5. Aktifkan plugin. Buka tab Installed, cari Spatial Format Converter, lalu pastikan kotaknya dicentang.
  6. Mulai ulang QGIS. Restart direkomendasikan setelah pemasangan pertama atau penggantian versi.

Cara aktivasi

Aktivasi terkait dengan Device ID yang ditampilkan oleh plugin pada perangkat QGIS yang digunakan.

  1. Buka pengelola aktivasi. Pilih menu SFC → Manage Activation atau tombol aktivasi pada dialog plugin.
  2. Periksa Device ID. Pastikan identitas perangkat tampil lengkap, kemudian salin tanpa menambahkan spasi.
  3. Ajukan permintaan. Buka halaman aktivasi Ruang Spasial dan lengkapi data yang diminta menggunakan Device ID yang sama.
  4. Terapkan respons aktivasi. Masukkan data aktivasi yang diterima pada kolom yang tersedia, kemudian tekan Activate/Save.
  5. Verifikasi status. Tutup dan buka kembali dialog SFC. Pastikan status berubah menjadi Active.
Privasi perangkat.

Device ID digunakan untuk mengikat lisensi ke perangkat. Jangan mengubah file lisensi secara manual atau membagikannya ke perangkat lain.

Cara menggunakan SFC

  1. Buka plugin. Pilih ikon SFC pada toolbar atau menu Plugins → Spatial Format Converter.
  2. Pilih sumber. Gunakan layer aktif atau telusuri file SHP, DWG/DXF/DGN, KML, atau KMZ.
  3. Periksa CRS. Tetapkan CRS sumber jika belum dikenali dan tentukan CRS output sesuai kebutuhan proyek.
  4. Pilih layer/field. Daftar akan dibaca otomatis. Centang hanya atribut atau kategori layer yang perlu dibawa.
  5. Tentukan format hasil. Pilih SHP, KML/KMZ, atau CAD, kemudian tentukan folder dan nama output.
  6. Jalankan. Tekan Convert/Run dan periksa panel log untuk jumlah fitur, peringatan geometri, serta lokasi hasil.
  7. Validasi. Buka hasil di QGIS, periksa tipe geometri poligon, CRS, nilai atribut, dan kesesuaian posisi.
Select All / Unselect All.

Select All mencentang seluruh pilihan yang tersedia. Unselect All harus menghapus seluruh centang dan membiarkan daftar kosong sampai pengguna memilih kembali.

Panduan berdasarkan format

CAD → SHP/KML Polygon

Pilih sumber CAD, tentukan layer pembentuk batas, kemudian pilih layer teks atau kategori yang memang memiliki makna atribut. Pastikan garis batas tertutup, tidak memiliki gap, overshoot, undershoot, atau duplikasi. Hasil akhir harus diperiksa sebagai geometri poligon.

SHP/KML → DXF

Setiap field yang dicentang dibuat sebagai satu layer DXF dengan nama yang mengikuti nama field. Pada masing-masing layer, garis bidang disertakan bersama nilai atribut sebagai entitas MTEXT. Jika beberapa field dipilih, posisi teks disusun ke bawah secara berurutan agar tidak bertumpuk.

SHP ↔ KML/KMZ

Pastikan input bertipe poligon dan CRS sumber dikenali. KML/KMZ umumnya menggunakan WGS 84; periksa kembali transformasi koordinat dan isi atribut setelah ekspor.

CAD yang tidak dapat dibaca

Periksa dukungan driver pada QGIS yang digunakan. Bila perlu, ekspor DWG/DGN menjadi DXF kompatibel, lalu jalankan kembali konversi dengan geometri dan satuan koordinat yang sama.

Aturan nama field dan layer

SFC_namaSFC_kodebatas_blokzona_utama

Nama yang dimulai angka

Nama field yang diawali angka disesuaikan menjadi nama valid dengan awalan SFC. Contoh umum: 12zona menjadi SFC12zona. Penyesuaian ini mencegah nama field ditolak oleh driver output.

Batas nama Shapefile

Nama field DBF pada Shapefile memiliki batas praktis 10 karakter. Nama panjang dapat dipendekkan agar valid dan unik. Gunakan nama ringkas jika konsistensi lintas aplikasi merupakan prioritas.

Layer DXF berdasarkan field

Output DXF tidak memerlukan CAD Category Field atau Default CAD Layer. Setiap field yang dicentang menghasilkan layer tersendiri; nama layer mengikuti nama field dan karakter yang tidak valid dinormalisasi agar kompatibel dengan AutoCAD. Jika tidak ada field yang dipilih, garis bidang menggunakan nama Main Boundary Layer.

Field teknis

Field internal seperti ID sementara, panjang, luas otomatis, style, dan metadata provider tidak perlu dipilih kecuali memang menjadi bagian dari kebutuhan data.

Error umum dan solusinya

Plugin tidak muncul setelah instalasi
Plugin not found / plugin is not listed

Pastikan ZIP memiliki satu folder induk plugin dan metadata.txt berada langsung di dalam folder tersebut. Periksa tab Installed, aktifkan plugin, lalu restart QGIS.

Plugin rusak atau gagal dimuat
Couldn't load plugin / ModuleNotFoundError

Buka Plugins → Manage and Install Plugins → Installed untuk melihat detail. Hapus versi lama, pasang ulang paket yang sesuai dengan versi QGIS, lalu lihat View → Panels → Log Messages pada tab Python.

metadata.txt tidak valid
This plugin is broken: Missing metadata file

Jangan memasang ZIP dokumentasi atau folder proyek. Gunakan ZIP plugin yang di dalamnya terdapat folder plugin beserta metadata.txt dan __init__.py.

Status aktivasi tetap tidak aktif
Activation status is not active

Periksa internet, tanggal dan waktu Windows, hak tulis profil QGIS, dan kesesuaian Device ID. Jalankan QGIS sebagai pengguna yang sama dengan saat permintaan aktivasi dibuat.

Daftar layer atau field kosong
No compatible layers or fields were found

Pastikan sumber telah dipilih dan dapat dibuka QGIS. Muat ulang sumber, tetapkan CRS bila diperlukan, dan periksa apakah layer memiliki geometri atau field yang kompatibel.

Unselect All tidak menghapus centang

Pastikan versi plugin terbaru terpasang. Hapus versi lama dari profil, restart QGIS, pasang ulang ZIP terbaru, lalu tekan Unselect All setelah daftar selesai dimuat.

Poligon tidak terbentuk
No polygon could be created

Perbaiki gap, garis tidak tersambung, overshoot, undershoot, self-intersection, serta duplikasi. Gunakan snapping dan pemeriksa validitas geometri sebelum konversi.

CRS salah atau hasil bergeser
Source CRS is unknown / coordinate transformation failed

Jangan sekadar menetapkan CRS output pada data yang salah definisi. Tetapkan CRS sumber yang benar, kemudian lakukan reproyeksi. Untuk KML/KMZ, validasi hasil terhadap WGS 84.

DWG/DGN tidak dapat dibuka
Unsupported data source / driver not available

Dukungan bergantung pada build GDAL/OGR QGIS. Gunakan DXF kompatibel atau konversi sumber melalui aplikasi CAD, lalu ulangi proses.

Atribut tidak terlihat pada DXF
DXF hanya menampilkan garis bidang

Gunakan plugin versi 26.01 terbaru dan centang field sebelum konversi. Setiap field dibuat sebagai layer tersendiri dan nilainya ditulis sebagai MTEXT bertingkat. Di AutoCAD, aktifkan layer yang sesuai dan jalankan Zoom Extents bila teks belum terlihat.

Error boundary saat ekspor DXF
'QgsGeometry' object has no attribute 'boundary'

Pasang plugin versi 26.01 terbaru. Versi ini mengambil batas poligon melalui API geometri QGIS yang kompatibel.

Pesan aktivasi berhasil tetapi dialog menyatakan gagal
Activation failed — Aktivasi berhasil

Pasang plugin versi 26.01 terbaru, kemudian terapkan kembali data aktivasi pada Device ID yang sama.

Output gagal ditulis
Permission denied / failed to create output

Gunakan folder lokal dengan hak tulis, nama file sederhana, dan path pendek. Tutup aplikasi lain yang mengunci file. Shapefile juga memerlukan beberapa file pendamping dengan nama dasar yang sama.

Processing algorithm tidak tersedia
Algorithm not found / Processing provider is disabled

Aktifkan plugin Processing serta provider bawaan pada pengaturan Processing. Restart QGIS setelah mengubah konfigurasi provider.

Syarat dan ketentuan penggunaan

  • Plugin digunakan hanya pada perangkat dan pengguna yang memiliki hak lisensi yang sah.
  • Pengguna bertanggung jawab memeriksa legalitas, akurasi, CRS, topologi, atribut, dan kelengkapan data sumber maupun output.
  • Selalu buat salinan cadangan. Jangan menjadikan hasil konversi sebagai satu-satunya arsip data.
  • Kinerja dan kompatibilitas dipengaruhi versi QGIS, provider, driver GDAL/OGR, struktur sumber, ukuran data, serta sumber daya perangkat.
  • Dilarang membongkar, mengubah mekanisme aktivasi, mendistribusikan ulang, atau menggunakan plugin di luar ketentuan lisensi.
  • SFC membantu proses konversi; keputusan teknis dan penggunaan hasil tetap menjadi tanggung jawab pengguna.

FAQ singkat

Apakah ZIP plugin harus diekstrak?

Tidak untuk metode Install from ZIP. Ekstraksi hanya diperlukan jika memilih instalasi manual ke folder profil.

Apakah semua versi DWG dapat dibaca?

Tidak selalu. Kemampuan baca CAD bergantung pada driver yang tersedia dalam build QGIS. DXF kompatibel dapat digunakan sebagai alternatif.

Mengapa nama field berubah?

Driver output menerapkan batas karakter dan aturan penamaan. Nama yang dimulai angka diberi awalan SFC; nama Shapefile yang panjang dapat dipendekkan.

Di mana melihat rincian error?

Buka View → Panels → Log Messages, kemudian periksa tab Python, Plugins, Processing, dan General.

SFC for QGIS

Spatial Format Converter (SFC) is a geospatial interoperability extension for QGIS that orchestrates conversion among SHP, DWG/DXF/DGN, and KML/KMZ with polygon-geometry validation, coordinate-reference harmonization, and controlled mapping of semantic attributes. The result is a consistent, structured cross-format dataset ready for spatial analysis.

Polygon geometry

Spatial output is created and validated as polygon geometry according to the source and selected parameters.

Meaningful attributes

Only user-selected semantic fields or layers are retained in the output.

CAD conversion

Each selected field becomes a separate DXF layer. Polygon boundaries and attribute values are placed on that layer as vertically stacked MTEXT entities.

Focused interface

Fields and layers share one selection area with Select All and Unselect All controls.

System requirements

ComponentRequirementNotes
Operating systemWindows 10/11 64-bitThe user must be able to write to the QGIS profile and output folder.
ApplicationQGIS Desktop 3.22–3.99A supported LTR or Stable release is recommended.
ProcessingEnabledThe Processing plugin and required providers must load successfully.
GDAL/OGRBundled with QGISAvailability of specific CAD drivers depends on the QGIS build.
InternetRequired for activationA stable connection is required for the activation service and online guide.
CAD support.

DWG/DGN support can vary by QGIS build. If a source is unavailable, save it as a compatible DXF without changing its coordinate system or boundary topology.

Plugin installation

Primary method — Install from ZIP

  1. Save the plugin package. Download the SFC ZIP to a local folder. Do not extract it for this method.
  2. Open Plugin Manager. In QGIS choose Plugins → Manage and Install Plugins….
  3. Select Install from ZIP. Browse to the SFC package and press Install Plugin.
  4. Review the warning. Continue only when the package came from Ruang Spasial.
  5. Enable the plugin. Open Installed, locate Spatial Format Converter, and select its checkbox.
  6. Restart QGIS. A restart is recommended after a first installation or version replacement.

Activation

Activation is associated with the Device ID shown by the plugin on the QGIS workstation.

  1. Open activation management. Choose SFC → Manage Activation or the activation button in the plugin dialog.
  2. Verify the Device ID. Copy the complete identifier without adding spaces.
  3. Submit a request. Open the Ruang Spasial activation page and submit the requested information using the same Device ID.
  4. Apply the activation response. Enter the received activation data in the provided field and press Activate/Save.
  5. Verify the status. Reopen SFC and confirm that its status is Active.
Device privacy.

The Device ID binds the license to a workstation. Do not manually edit or share the license file.

Using SFC

  1. Open the plugin. Use the SFC toolbar icon or Plugins → Spatial Format Converter.
  2. Select a source. Use an active layer or browse to SHP, DWG/DXF/DGN, KML, or KMZ.
  3. Check the CRS. Assign a missing source CRS and select the required output CRS.
  4. Select layers or fields. SFC reads available choices automatically. Select only meaningful attributes or categories.
  5. Choose an output format. Select SHP, KML/KMZ, or CAD, then specify the output folder and name.
  6. Run the conversion. Review the log for feature counts, geometry warnings, and output paths.
  7. Validate the result. Check polygon geometry, CRS, attributes, and spatial alignment in QGIS.
Select All / Unselect All.

Select All checks every available item. Unselect All clears every item and leaves the list empty until the user makes another selection.

Format workflows

CAD → SHP/KML Polygon

Select the CAD source, boundary-forming layers, and only meaningful text or category layers. Boundaries must be closed and free of gaps, overshoots, undershoots, and duplicates. Validate the output as polygon geometry.

SHP/KML → DXF

Each checked field creates one DXF layer named after that field. Every layer contains the polygon boundary and its corresponding attribute value as MTEXT. Multiple labels are positioned vertically to prevent overlap.

SHP ↔ KML/KMZ

Confirm polygon input and a known source CRS. KML/KMZ generally uses WGS 84; review coordinate transformation and attributes after export.

Unreadable CAD sources

Review driver support in the current QGIS build. If needed, export DWG/DGN to a compatible DXF while preserving geometry and coordinate units.

Field and layer naming

SFC_nameSFC_codeboundarymain_zone

Names beginning with a number

A field beginning with a number is normalized with the SFC prefix. For example, 12zone becomes SFC12zone.

Shapefile field-name limit

DBF field names have a practical ten-character limit. Long names may be shortened to stay valid and unique.

Field-based DXF layers

DXF output does not require CAD Category Field or Default CAD Layer. Every checked field creates a separate layer named after that field, with invalid CAD characters normalized. If no field is selected, the polygon boundary uses Main Boundary Layer.

Technical fields

Temporary IDs, calculated length/area, provider styles, and internal metadata should be excluded unless required by the dataset specification.

Common errors and solutions

The plugin is not listed
Plugin not found / plugin is not listed

Confirm that the ZIP contains one plugin directory with metadata.txt directly inside it. Enable the plugin under Installed and restart QGIS.

The plugin cannot load
Couldn't load plugin / ModuleNotFoundError

Remove the old version, install a package compatible with the current QGIS release, and inspect View → Panels → Log Messages, especially the Python tab.

The metadata file is missing
This plugin is broken: Missing metadata file

Install the actual plugin ZIP rather than a documentation or project archive. The plugin folder must contain metadata.txt and __init__.py.

Activation remains inactive
Activation status is not active

Check the connection, Windows date/time, profile write permission, and Device ID. Use the same QGIS user account used for the activation request.

The layer or field list is empty
No compatible layers or fields were found

Confirm that QGIS can open the source, reload it, assign a source CRS when required, and verify that compatible geometry or attributes are present.

Unselect All does not clear the list

Remove the old plugin copy from the active profile, restart QGIS, install the latest ZIP, and press Unselect All only after the list has finished loading.

No polygon is created
No polygon could be created

Repair gaps, disconnected boundaries, overshoots, undershoots, self-intersections, and duplicate lines. Use snapping and geometry validation before conversion.

The output is shifted
Source CRS is unknown / coordinate transformation failed

Assign the correct source CRS before reprojection. For KML/KMZ, validate the result against WGS 84.

DWG/DGN cannot be opened
Unsupported data source / driver not available

CAD support depends on the QGIS GDAL/OGR build. Use a compatible DXF or convert the source with CAD software.

Attributes are not visible in DXF
DXF displays polygon boundaries only

Use the latest plugin version 26.01 and check the required fields before conversion. Each field creates a separate layer and its value is written as stacked MTEXT. In AutoCAD, enable the relevant layer and use Zoom Extents if necessary.

Boundary error during DXF export
'QgsGeometry' object has no attribute 'boundary'

Install the latest plugin version 26.01. This version uses the compatible QGIS geometry API.

Activation success is shown as failure
Activation failed — Aktivasi berhasil

Install the latest plugin version 26.01, then apply the activation data again on the same Device ID.

The output cannot be written
Permission denied / failed to create output

Use a writable local folder, short paths, and simple file names. Close applications that lock the output.

A Processing algorithm is unavailable
Algorithm not found / Processing provider is disabled

Enable Processing and its required built-in providers, then restart QGIS.

Terms of use

  • Use the plugin only on devices and user accounts covered by a valid license.
  • The user is responsible for checking source and output legality, accuracy, CRS, topology, attributes, and completeness.
  • Maintain independent backups. Never treat converted output as the only archive.
  • Performance and compatibility depend on QGIS, Processing providers, GDAL/OGR drivers, source structure, data volume, and workstation resources.
  • Do not bypass activation, reverse-engineer, modify licensing controls, or redistribute the plugin outside its license terms.
  • SFC assists conversion; technical decisions and use of the output remain the user's responsibility.

FAQ

Should I extract the plugin ZIP?

No when using Install from ZIP. Extraction is only required for manual profile-folder installation.

Can every DWG version be opened?

Not always. CAD support depends on drivers available in the QGIS build. A compatible DXF can be used instead.

Why did a field name change?

Output drivers enforce name limits and syntax. Numeric-leading names receive the SFC prefix, and long Shapefile names may be shortened.

Where can I find detailed errors?

Open View → Panels → Log Messages and inspect the Python, Plugins, Processing, and General tabs.