Azimutree

Panduan Aplikasi Lengkap 📚🌳

Perhatian: Aplikasi Azimutree hanya dikembangkan untuk perangkat Android.

Panduan berikut adalah versi lengkap dari panduan in-app — memuat langkah-langkah operasi, ikon, warna legenda, dan tips lapangan agar pengguna dapat menjalankan pengukuran secara konsisten.

1. Tampilan Dashboard 🏠

Antarmuka utama menampilkan tombol besar untuk akses cepat dan tombol kecil untuk pengaturan.

  • 🔲 Menu Tombol Besar: Kelola Data Klaster, Peta Lokasi Klaster Plot, Panduan Aplikasi — akses utama untuk operasi lapangan.
  • ⚙️ Menu Tombol Kecil: Settings, About Aplikasi, Keluar.
  • 📂 Sidebar: dapat dibuka dari pojok kiri atas; memuat tautan navigasi dan pengaturan.
  • 🌗 Tombol Ganti Tema: di pojok kanan atas untuk toggle Terang / Gelap.

2. Kelola Data Klaster Plot ✍️

Fitur utama untuk membuat, mengedit, mengimpor, dan mengekspor data klaster, plot, dan pohon.

2.1 Akses Menu & FAB ➕

  • FAB menyediakan pilihan: Input Manual, Impor Data (Excel), Ekspor Data, Unduh Template.

2.2 Input Manual Klaster 🧾

  1. Masukkan Kode Klaster (unik).
  2. Masukkan Nama Pengukur.
  3. Pilih Tanggal Pengukuran.
  4. Tekan Simpan untuk menyimpan klaster.

2.3 Input Manual Plot 📍

  1. Pilih klaster yang diinginkan (dropdown).
  2. Pilih nomor plot (maks. 4 plot per klaster). Jika semua plot terisi, opsi tidak tersedia.
  3. Masukkan Latitude dan Longitude.
  4. Masukkan Altitude (opsional).

2.4 Input Manual Pohon 🌱

Posisi pohon bisa direkam dengan dua metode; pilih salah satu:

  • 🧭 Azimut & Jarak — data relatif terhadap plot pusat (sentroid).
  • 📌 Koordinat Bebas — masukkan Latitude & Longitude langsung.
  1. Pilih Klaster dan Plot.
  2. Pilih metode posisi (Azimut+Jarak atau Koordinat Bebas).
  3. Masukkan Altitude (opsional).
  4. Masukkan Kode Pohon (angka) dan Nama Pohon.
  5. Masukkan Nama Ilmiah dan Keterangan (opsional).
  6. Masukkan URL Foto (direkomendasikan Google Drive publik langsung ke file gambar).

2.5 Edit & Hapus Data ✏️🗑️

  • Geser item ke kiri → Edit (ubah data).
  • Geser item ke kanan → Hapus (data terhapus permanen; tidak dapat dikembalikan).
  • Tip: Gunakan fitur Mode Debug di Settings untuk generate data uji sebelum melakukan operasi massal.

2.6 Impor Data Menggunakan Excel 📥

  1. Tekan Unduh Template untuk format Excel resmi.
  2. Isi file sesuai format — format harus persis sama.
  3. Kembali ke aplikasi → pilih Impor Data.
  4. Isi dialog impor: Kode Klaster, Nama Pengukur, Tanggal Pengukuran, lalu pilih file Excel.
  5. Berikan izin akses penyimpanan jika diminta, lalu tekan Impor.

Catatan: jika ada kesalahan format atau data duplikat, impor akan gagal dan menampilkan pesan error.

2.7 Ekspor Data 📤

Ekspor menghasilkan file Excel yang dapat dibagikan dan diimpor kembali oleh pengguna Azimutree lain.

3. Peta Lokasi Klaster Plot 🗺️

Peta menggunakan Mapbox dan menampilkan marker, garis relasi, serta panel informasi.

3.1 Marker dan Warna 🟢🔴🔵🟣🟠

  • 🔵 Biru — Marker Plot (posisi plot).
  • 🟣 Ungu — Sentroid otomatis (jika Plot 1 belum ada).
  • 🟠 Oranye — Marker Pohon (lokasi pohon).
  • 🟢 Hijau — Pohon yang sudah diinspeksi/ditandai.
  • 🔴 Merah — Marker hasil pencarian lokasi.

3.2 Garis Relasi 📏

  • 🟥 Garis Merah: relasi antara pohon dan plot (menunjukkan arah/azimut & jarak).
  • 🟦 Garis Biru: relasi plot→plot atau plot→sentroid.

3.3 Bottom Sheet Peta & Kontrol 🔎

  • 🔍 Pencarian lokasi (nama kota/ tempat).
  • 🛰️ Ganti tipe peta: Satelit / Medan.
  • 📍 Lokasi pengguna: hidupkan untuk navigasi lapangan.
  • 🧭 Arahan utara: tombol reorient ke utara.

3.4 Interaksi Marker & Info

  • Ketuk marker → tampilkan informasi di pojok kiri atas dan bottom sheet.
  • Fitur Center Camera memusatkan peta ke marker tertentu.

3.5 Map Tools (Sidebar Kanan) 🧰

  • • Klik Marker — aktifkan/ nonaktifkan interaksi sentuhan marker.
  • • Tampilkan Legenda — tunjukkan/ sembunyikan legenda peta.
  • • Tampilkan Info Marker — tunjukkan/ sembunyikan info marker overlay.
  • • Workflow Inspeksi — menampilkan tombol Tandai pada marker; ketika ditandai, warna marker menjadi hijau.
  • • Tampilkan Garis Relasi — hidupkan/ matikan garis relasi antar marker.

3.6 Navigasi Lapangan 🚶‍♂️🧭

Jika Lokasi Pengguna dan Workflow Inspeksi aktif, aplikasi menampilkan jarak & arah dari posisi pengguna ke marker terpilih — membantu peneliti menemukan pohon/plot di lapangan.

4. Settings ⚙️

  • 🌗 Ganti Tema — Terang / Gelap.
  • 🐞 Mode Debug — fitur pengujian: Generate data acak dan Hapus seluruh data (hanya untuk pengujian).
  • 🔐 Keamanan — Pastikan tidak menyimpan token atau kredensial pada file yang di-commit (gunakan `.env`).

5. Impor / Ekspor & Template 📄

  • 📥 Unduh Template untuk format Excel standar dan isi data sesuai kolom yang disediakan.
  • ⚠️ Validasi: Pastikan format dan tipe data benar agar proses impor tidak gagal.
  • 📤 Ekspor menghasilkan file Excel yang dapat dibagikan dan diimpor oleh pengguna lain.

6. Tips Lapangan & Best Practices ✅

  • 🔋 Pastikan baterai perangkat cukup dan GPS akurat sebelum mulai pengukuran.
  • ✍️ Catat kode klaster dan tanggal pengukuran secara konsisten.
  • 🖼️ Gunakan URL gambar publik (mis. Google Drive dengan sharing publik langsung ke file image).
  • 📂 Backup data secara berkala dengan fitur ekspor.
  • 🧪 Uji impor pada file contoh sebelum melakukan impor massal di lapangan.

7. Masalah Umum & Solusi 🔧

  • 📶 Masalah jaringan — periksa koneksi internet/perangkat dan coba kembali.
  • ❌ Impor gagal — periksa format template, pastikan tidak ada kolom kosong atau duplikat kunci.
  • 🗃️ Data tidak muncul — restart aplikasi atau periksa izin penyimpanan dan akses file.