Location Pin

Location Pin digunakan untuk mencatat titik lokasi, misalnya lokasi kunjungan atau lokasi kejadian. Titik diambil dari GPS perangkat atau dipilih di peta. Nilainya berisi koordinat, akurasi, waktu pengambilan, dan alamat bila diaktifkan.

Mapping ke Engine

Keterangan isi nilai:

• lat dan lng: koordinat dengan 6 angka desimal.
• accuracy_m: akurasi GPS dalam meter. Bernilai null bila titik dipilih atau digeser manual.
• source: gps bila dari GPS, manual bila dari peta atau pin digeser.
• captured_at: waktu pengambilan dengan zona waktu lokal, misalnya +07:00.
• address: alamat hasil pencarian. Hanya ada bila Show the address aktif. Bernilai null bila alamat gagal dimuat.

Properties

• Name: Label komponen yang ditampilkan ke pengguna. Mendukung dua bahasa (EN & ID).
• Key: Mengikat komponen ke process variable yang menyimpan nilainya saat form disubmit. Digenerate otomatis dan dapat disesuaikan.
• How to capture: Cara mengambil titik.
  • Use my current location: titik dari GPS dan pin tidak bisa digeser.
  • GPS, then adjust on map: titik awal dari GPS, lalu pin boleh digeser. Ini pilihan default.
  • Pick on map: pengguna mengetuk peta untuk menaruh pin.
• Maximum GPS accuracy (metres): Batas akurasi GPS, 10 sampai 500 meter dengan kelipatan 10. Default 50. Hasil GPS yang kurang akurat ditolak. Tidak tampil untuk Pick on map.
• Show the address: Bila aktif, alamat dicari dari koordinat dan ikut disimpan. Koordinat dikirim ke layanan pencarian alamat.
• Hide If: Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah.
• Validation:
  • Required: Titik lokasi wajib diambil sebelum form disubmit.

Perilaku saat diisi

• GPS hanya bisa dipakai lewat HTTPS (atau localhost). Selain itu muncul "GPS needs HTTPS or localhost. Open this form in a secure browser context."
• Klik Use my current location untuk mengambil titik GPS. Selama mencari, tombol bertuliskan "Finding your location…".
• Bila izin lokasi ditolak, muncul "Location access is blocked. Allow location in the browser settings and try again."
• Bila akurasi melebihi batas, titik ditolak dengan pesan seperti "Accuracy is ± 120 m, above the 50 m limit. Move to an open area and try again." Ini berlaku juga saat field tidak wajib.
• Setelah titik terambil, tampil koordinat, "Accuracy ± 18 m", dan alamat bila diaktifkan. Pada GPS, then adjust on map, pin yang digeser menampilkan "Accuracy set by hand".
• Pada Pick on map, peta menampilkan "Tap the map to drop a pin" selama belum ada titik.
• Bila wajib dan kosong, muncul "Capture the visit location". Pada Pick on map, pesannya "Drop a pin on the map".
• Peta memakai tile OpenStreetMap dan alamat dicari lewat Nominatim (OpenStreetMap). Keduanya dapat diganti lewat konfigurasi aplikasi.