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. Klik ikon 📍 (pin merah) di toolbar peta.
  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 langsung dimuat ke Editor untuk Anda periksa. Pada tahap ini titik belum tersimpan: periksa dulu, perbaiki yang meleset (lihat bagian 3), lalu Simpan atau Export secara manual.

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

🔧 3. Memperbaiki Titik yang Meleset

Semua layanan geocoding sesekali salah menebak, terutama kalau alamatnya kurang spesifik. Titik bisa meleset beberapa ratus meter, atau bahkan nyasar ke wilayah negara lain yang punya nama jalan serupa. Karena itu hasil bulk import sengaja tidak langsung disimpan, melainkan dimuat ke Editor supaya Anda periksa dulu.

Menemukan titik yang nyasar

Perkecil tampilan peta (zoom out) sampai seluruh dunia terlihat. Titik yang keluar dari wilayah Indonesia akan langsung kelihatan karena menyendiri jauh dari kelompoknya.

Tiga cara memperbaiki

Pilih dulu titik yang salah di Editor, lalu gunakan cara yang paling sesuai:

Kondisi Cara memperbaiki
Nyasar jauh (misalnya sampai ke luar negeri) Ketik atau tempel koordinat yang benar di kolom Lat dan Lon. Marker langsung berpindah ke lokasi baru.
Meleset sedikit (masih di kota yang benar) Geser langsung markernya di peta. Koordinatnya ikut diperbarui otomatis.
Data memang tidak terpakai Klik tombol Hapus untuk membuang titik tersebut.

Setelah semua titik benar, baru Simpan atau Export hasilnya.

💡 Kalau yang meleset banyak, jangan perbaiki satu per satu.
Lebih cepat lengkapi dulu kolom alamat di file Excel Anda (tambahkan kecamatan, kabupaten/kota, provinsi, dan kata "Indonesia"), lalu jalankan ulang prosesnya. Panduan formatnya ada di bagian 4 di bawah.

📋 4. 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.

🚧 5. 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.

🎯 6. 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.