202310715130-Dwifebbryanti-EAS/LOKASI_TROUBLESHOOTING.md

🐛 Debug & Troubleshooting Sistem Lokasi Absensi

❓ Masalah Umum & Solusi

1. Lokasi Selalu "Tidak Valid" / "Tidak Diterima"

Kemungkinan Penyebab:

• ❌ Lokasi GPS belum akurat
• ❌ Berada terlalu jauh dari radius 250m
• ❌ Izin akses lokasi belum diberikan

Solusi:

1. Buka Settings → Apps → Aplikasi → Permissions
2. Pastikan "Location" atau "GPS" → "Always allow" / "Allow only while using the app"
3. Tunggu 5-10 detik hingga GPS lock (akurat)
4. Lihat UI card menunjukkan "✓ Valid" sebelum ambil foto
5. Pastikan jarak < 250 meter dari kampus

2. Koordinat GPS Tidak Muncul / "Lokasi tidak tersedia"

Penyebab:

• ❌ GPS belum aktif di perangkat
• ❌ Aplikasi tidak punya izin
• ❌ Signal GPS lemah (indoor/basement)

Solusi:

1. Aktifkan Location di Settings → Location
2. Ubah ke "High accuracy" mode (bukan "Battery saver")
3. Buka aplikasi di area terbuka (outdoor)
4. Tunggu 10-15 detik untuk cold start GPS
5. Coba di lokasi berbeda dengan signal lebih baik

3. Jarak Kampus Terlalu Besar (> 250m)

Pengecekan:

• 📍 Lokasi Anda sekarang: [Lat, Lon dari GPS]
• 📍 Lokasi Kampus: -6.2447, 106.9956
• 📏 Jarak Maksimal: 250 meter

Solusi:

1. Pindah lebih dekat ke zona kampus (dalam 250m dari koordinat yang ditentukan)
2. Jika sudah di dalam kampus tapi masih merah, tunggu 30 detik untuk GPS refine
3. Coba di lokasi yang berbeda di area kampus

4. Tombol "Kirim Absensi" Tidak Bisa Ditekan

Sebab kemungkinan:

• ❌ Lokasi belum valid (card masih merah)
• ❌ Foto belum diambil
• ❌ GPS koordinat masih blank

Solusi:

Pastikan SEMUA kondisi terpenuhi:
☑️ Status Lokasi = "✓ Valid" (card hijau)
☑️ Jarak < 250 meter (ditampilkan di card)
☑️ Foto sudah diambil (ada preview atau indikasi)
☑️ Ada koneksi internet untuk kirim ke server

5. Foto Tidak Bisa Diambil

Penyebab:

• ❌ Izin kamera belum diberikan
• ❌ Kamera sedang digunakan aplikasi lain

Solusi:

1. Buka Settings → Apps → Aplikasi → Permissions
2. Pastikan "Camera" sudah "Allow"
3. Tutup aplikasi lain yang pakai kamera
4. Restart aplikasi
5. Tap "📷 Ambil Foto" lagi

🔍 Cara Cek Koordinat GPS Akurat

Via Google Maps:

1. Buka Google Maps
2. Zoom ke lokasi Anda
3. Long press untuk lihat koordinat
4. Bandingkan dengan yang ditampilkan di aplikasi

Target Lokasi: -6.2447, 106.9956
Tolerance: ±0.0050° (≈ 500 meter)

Via Aplikasi Lain:

• Gunakan app "GPS Status" dari Play Store
• Pastikan satellite count > 8 untuk akurasi baik

📊 Testing Checklist

Sebelum submit absensi, pastikan:

LOCAL CHECKING:
☑️ Aplikasi terbuka tanpa error
☑️ Login berhasil (masuk halaman Absensi)
☑️ GPS mulai scanning (lihat "Koordinat: ..." berubah)

LOCATION VALIDATION:
☑️ Koordinat tampil di layar (Lat/Lon ada angkanya)
☑️ Jarak ditampilkan (contoh: "12.5 meter")
☑️ Card berwarna HIJAU (✓ Valid)
☑️ Status menunjukkan "Status Lokasi: ✓ Valid"

PHOTO TAKING:
☑️ Tombol "📷 Ambil Foto" bisa diklik
☑️ Kamera terbuka (preview camera terlihat)
☑️ Bisa ambil foto
☑️ Preview foto muncul di aplikasi

FINAL SUBMISSION:
☑️ Tombol "📤 Kirim Absensi" AKTIF (tidak abu-abu)
☑️ Tap tombol
☑️ Tunggu Toast notification (sukses/gagal)
☑️ Cek Riwayat → lihat record terbaru

🛠️ DEBUG LOGS

Untuk melihat log aplikasi (development):

Via Android Studio:

1. Buka Android Studio
2. Tools → Logcat (atau Alt+6)
3. Filter: "DatabaseHelper" atau "MainActivity"
4. Lihat error/warning messages

Error Messages Umum:

"Lokasi tidak tersedia"
→ GPS belum mendapat fix, tunggu lagi

"Gagal mengambil lokasi"
→ Permission ditolak atau GPS error

"Absensi ditolak: Lokasi tidak sesuai"
→ Jarak > 250m, pindah lebih dekat

"Gagal kirim ke server"
→ Tidak ada internet atau server down

🌍 Koordinat Reference Points

Area UBH Bekasi:

Lokasi	Lat	Lon	Jarak ke Campus
Gerbang Depan	-6.2445	106.9954	~20m
Tengah Kampus	-6.2447	106.9956	~0m (Reference)
Lapangan Olah Raga	-6.2450	106.9960	~40m
Kantin	-6.2440	106.9950	~80m
Maksimal Zona	-6.2397	106.9906	~250m (Limit)

Tips Akurasi:

• Buka area di outdoor (bukan dalam gedung)
• Tunggu 10-15 detik minimal setelah buka aplikasi
• Lihat Satellite Count > 8 untuk akurasi bagus
• Hindari area dengan banyak bangunan tinggi

📞 Jika Masalah Masih Ada

1. Cek Permission di Settings:

   • Settings → Apps → [Nama App] → Permissions
   • Location: ON
   • Camera: ON
   • Internet/Phone: ON

2. Clear Cache Aplikasi:

   • Settings → Apps → [Nama App] → Storage → Clear Cache
   • Jangan Clear Data (akan hapus user list)

3. Uninstall & Reinstall:

   • Long press aplikasi → Uninstall
   • Install ulang dari Android Studio
   • Login dengan akun yang sama

4. Hubungi Developer:

   • Lampirkan screenshot error message
   • Lampirkan koordinat GPS yang tampil
   • Lampirkan lokasi fisik saat testing

---

Last Updated: 2026-01-14
Android Version: Min API 24 (Android 7.0)
Target API: 35 (Android 15)