Dokumentasi » Galerigis Pro

Dokumentasi Galerigis Pro

Panduan instalasi, impor data, styling peta, basemap offline, dan modul lanjutan.

Bulk Import dengan Geocoding

Selain impor data koordinat biasa, Galerigis Pro juga mendukung Bulk Import Alamat. Fitur ini memungkinkan Anda mengubah daftar nama jalan atau alamat (Excel) menjadi titik lokasi di peta secara otomatis.

Fitur ini menggunakan layanan Mapbox Geocoding API, sehingga Anda memerlukan Access Token gratis dari Mapbox.

1. Persiapan: Daftar Akun Mapbox (Gratis)

Untuk menggunakan fitur pencarian alamat ini, Anda harus memiliki token Mapbox.
Mapbox memberikan kuota gratis yang sangat besar (sekitar 100.000 request/bulan), cukup untuk pemakaian rutin.

Langkah-langkah Mendaftar:

  1. Buka situs mapbox.com dan klik Sign Up.
  2. Isi form pendaftaran (Username, Email, Password). Tidak perlu kartu kredit untuk paket gratis (Pay-as-you-go).
  3. Verifikasi email Anda.
  4. Setelah login, masuk ke halaman Account atau Tokens.
  5. Anda akan melihat Default Public Token (diawali dengan pk.eyJ...).
  6. Salin token tersebut.

Memasukkan Token ke Galerigis Pro:

  1. Buka Galerigis Pro.
  2. Masuk ke menu Settings (Ikon bergerigi di pojok kanan atas).
  3. Paste token Anda di kolom Mapbox Access Token.
  4. Klik Save.

2. Cara Bulk Import Alamat

  1. Siapkan file Excel (.xlsx) Anda.
  2. Pastikan ada satu kolom yang berisi alamat lengkap. Contoh:
    • Kolom A: Nama Toko
    • Kolom B: Alamat (Isi: "Jl. Raya Bogor KM 30, Cimanggis, Depok")
  3. Buka menu Data > Bulk Geocoding.
  4. Upload file Excel Anda.
  5. Pilih kolom yang berisi Alamat sebagai referensi pencarian.
  6. Klik Start Process.
  7. Aplikasi akan menghubungi Mapbox untuk mencari koordinat setiap baris.
  8. Setelah selesai, hasilnya akan muncul sebagai layer titik baru di peta.

⚠️ Catatan:
Keakuratan titik tergantung pada kelengkapan alamat yang Anda tulis. Pastikan menyertakan nama jalan, kota, dan provinsi untuk hasil terbaik.

📋 3. Format Data Ideal

Agar proses geocoding berjalan mulus dan akurat, perhatikan tips format data berikut:

  • Bersihkan Simbol: Hapus karakter aneh (misal: #, ?, *) dari kolom alamat.
  • Hindari Singkatan Ambigu: Tulis "Jalan" alih-alih "Jl." jika memungkinkan, meskipun sistem cukup pintar menanganinya.
  • Sertakan Kota Administrasi: Jangan hanya menulis nama jalan.
    • ❌ Salah: Jalan Merdeka 45 (Bisa di Bandung, Jakarta, atau Surabaya).
    • ✅ Benar: Jalan Merdeka 45, Bandung.

🚧 4. Kuota & Batasan (Mapbox Free Tier)

Meskipun Mapbox menyediakan layanan gratis, tetap ada batasannya:

  • Limit: Sekitar 100.000 permintaan per bulan untuk akun gratis.
  • Jika Anda mengimpor 5.000 baris data, itu akan menghitung 5.000 permintaan dari kuota Anda.
  • Jika kuota habis, peta mungkin tidak akan memuat atau geocoding akan gagal. Anda bisa mengecek sisa kuota di dashboard akun Mapbox Anda.

🎯 5. Tips Akurasi (Landmark vs Alamat)

Jika alamat spesifik (Nomor Rumah/Jalan Kecil) sulit ditemukan oleh sistem geocoding, cobalah strategi berikut:

  • Gunakan Nama Landmark terdekat.
  • Contoh: Daripada Jalan Sempit No. 3, coba ganti menjadi Sebelah SMPN 1 Cibinong, Bogor. Mesin pencari lokasi biasanya lebih cepat mengenali titik poin populer (POI) daripada nomor rumah.