Daftar lokasi¶

Halaman ini memberi tahu Anda cara membuat, mengubah, dan menghapus daftar lokasi.

Daftar berisi satu lokasi atau lebih, misalnya kebun atau petak lahan. Aplikasi menganalisis setiap lokasi dalam daftar. Untuk membaca hasilnya, lihat 03-analysis-and-results.md.

Di halaman ini, kontrol atau label aplikasi ditulis dengan huruf tebal. Pesan aplikasi ditulis di dalam "tanda petik ganda".

Halaman daftar¶

Halaman daftar memiliki judul Daftar lokasi. Halaman ini menunjukkan tabel dengan satu baris untuk setiap daftar.

Tabel memiliki kolom berikut:

Nama: nama daftar. Pilih nama untuk membuka daftar.
Lokasi: jumlah lokasi dalam daftar.
Komoditas: komoditas yang Anda berikan untuk daftar. Jika Anda tidak memberikan komoditas, sel menunjukkan "—".
Analisis: analisis yang dilakukan aplikasi untuk daftar.
Terakhir diproses: tanggal analisis terakhir.
Dibuat: tanggal Anda membuat daftar.
Tindakan: menu untuk daftar (⋯).

Untuk mengurutkan tabel, tekan judul kolom. Tekan judul yang sama lagi untuk mengubah arah urutan.

Untuk menemukan daftar, ketik sebagian nama atau komoditasnya di kotak pencarian (Cari daftar berdasarkan nama atau komoditas…). Jika tidak ada daftar yang sesuai dengan teks Anda, tabel menunjukkan "Tidak ada daftar yang cocok dengan "…"". Jika Anda tidak memiliki daftar, halaman menunjukkan "Tidak ada daftar".

Label di tabel¶

Tidak lengkap: analisis tidak selesai untuk semua lokasi dalam daftar. Letakkan penunjuk pada label untuk melihat jumlah lokasi yang telah dianalisis aplikasi.
Data yang lebih baru tersedia: set data yang digunakan daftar telah berubah setelah analisis terakhir. Lihat "Memperbarui daftar" di bawah.
Memperbarui: pembaruan daftar sedang berlangsung. Tabel menunjukkan hasil analisis sebelumnya sampai pembaruan selesai.

Unggahan yang belum selesai¶

Jika unggahan belum selesai, spanduk muncul di bagian atas halaman daftar. Tekan Lanjutkan untuk kembali ke unggahan. Jika unggahan menunggu tinjauan Anda, tekan Tinjau.

Membuat daftar baru¶

Untuk memulai, tekan + Daftar baru di halaman daftar. Halaman Buat daftar baru muncul.

Halaman tersebut menanyakan Bagaimana Anda ingin menambahkan lokasi?. Pilih salah satu dari dua metode berikut:

Unggah sekumpulan lokasi: unggah file yang berisi satu lokasi atau lebih. Ini adalah metode bawaan.
Tambahkan satu lokasi secara manual: ketik koordinat satu lokasi.

CATATAN: Ganti metode hanya sebelum Anda mulai. Saat Anda mengganti metode, aplikasi menghapus nilai yang Anda ketik untuk metode yang lain.

CATATAN: Jika aplikasi menunjukkan "Unggahan dinonaktifkan", konfigurasi server menghentikan semua unggahan. Instalasi Docker baru mengizinkan Anda mengunggah file. Instalasi yang Anda tingkatkan versinya tetap menggunakan file konfigurasi lamanya. Lihat 01-install-and-start.md.

Jenis file yang diterima¶

Aplikasi menerima jenis file berikut:

Jenis file	Ekstensi nama file
CSV	.csv
Buku kerja Excel	.xlsx
GeoJSON	.geojson atau .json
KML	.kml
Shapefile dalam zip	.zip

Aplikasi tidak menerima jenis file lain. Misalnya, aplikasi tidak menerima file KMZ (.kmz) atau file Excel lama (.xls). Jika Anda mengunggah jenis file yang berbeda, aplikasi menunjukkan "Jenis berkas tidak didukung". Untuk menggunakan file KMZ, ekstrak file KML dari file KMZ. Kemudian unggah file KML tersebut.

File CSV dan Excel¶

File CSV atau Excel berisi satu lokasi di setiap baris. Baris pertama harus berisi judul kolom. Untuk buku kerja Excel, aplikasi hanya membaca lembar kerja pertama.

Setiap baris harus memiliki lintang dan bujur dalam derajat desimal. Lintang harus antara -90 dan 90. Bujur harus antara -180 dan 180.

Aplikasi menemukan kolom dari judulnya. Aplikasi mengenali judul berikut. Aplikasi mengabaikan huruf besar, huruf kecil, spasi, tanda hubung, dan garis bawah:

Lintang: latitude, lat, y, ycoord, ylat.
Bujur: longitude, lon, lng, long, x, xcoord, xlon.
Nama lokasi: name, id, plotid, locationid, locationname, plot.

Kolom nama bersifat opsional. File CSV atau Excel dengan kolom lintang dan bujur berisi titik. Karena itu, Anda harus memberikan ukuran untuk setiap titik. Lihat "Ukuran untuk lokasi titik" di bawah.

Aplikasi juga dapat membaca poligon dari kolom dengan judul geometry, geom, wkt, thegeom atau shape. Kolom ini harus berisi bentuk sebagai teks WKT, misalnya POLYGON((...)).

File GeoJSON, KML, dan shapefile¶

Jenis file ini berisi bentuk setiap lokasi di dalam file. Halaman menunjukkan "Geometri akan dibaca langsung dari berkas." Anda tidak mengatur kolom koordinat untuk file ini.

Shapefile dalam zip adalah satu file .zip yang berisi bagian-bagian shapefile (.shp, .shx, .dbf dan, jika Anda memilikinya, .prj). File .zip harus berisi file .shp. File .zip tidak boleh berisi lebih dari 256 file.

Titik dan poligon¶

Lokasi dapat berupa poligon atau titik.

Poligon menunjukkan batas lokasi. Aplikasi menganalisis area di dalam batas tersebut.
Titik adalah satu posisi GPS. Untuk menganalisis area di sekitar titik, aplikasi harus mengetahui ukuran area tersebut. Kemudian aplikasi membuat lingkaran di sekitar titik.

File dapat berisi titik dan poligon bersama-sama. Ukuran hanya berpengaruh pada titik.

Mengunggah file¶

Tekan Pilih berkas.
Pilih file di komputer Anda.
Pastikan bahwa halaman menunjukkan nama yang benar setelah Berkas terpilih.
Opsional: ketik nama di Nama daftar. Jika Anda tidak mengetik nama, aplikasi menggunakan nama file.
Opsional: ketik komoditas di Komoditas, misalnya "kakao".
Periksa bagian Periksa pemetaan bidang. Lihat "Mencocokkan kolom" di bawah.
Jika file berisi titik, berikan ukuran. Lihat "Ukuran untuk lokasi titik" di bawah.
Tekan Unggah dan analisis.

CATATAN: Tombol Unggah dan analisis tidak tersedia sampai halaman memiliki semua data yang diperlukan. Baca pesan di halaman untuk mengetahui apa yang diperlukan.

Mencocokkan kolom¶

Setelah Anda memilih file, aplikasi mencocokkan kolom di file Anda dengan data yang diperlukannya. Jika aplikasi yakin dengan semua kecocokan, aplikasi menunjukkan "Kami mencocokkan kolom pada berkas Anda dengan bidang yang kami perlukan. Periksa sebelum dianalisis."

Untuk melihat atau mengubah kecocokan, tekan Ubah pemetaan bidang. Tabel memiliki kolom berikut:

Kami memerlukan: data yang diperlukan aplikasi, misalnya Lintang (utara–selatan) dan Bujur (timur–barat).
Kolom pada berkas Anda: kolom yang berisi data ini. Jika kecocokan tidak benar, pilih kolom yang berbeda.
Contoh nilai: nilai dari file Anda.
Cara pencocokan: misalnya Dicocokkan berdasarkan nama, Dicocokkan dengan alias yang dikenal atau Anda yang memilih ini.

Jika aplikasi tidak yakin dengan suatu kecocokan, label periksa yang ini muncul di sebelahnya. Periksa kecocokan tersebut sebelum Anda melanjutkan.

Jika beberapa contoh lintang atau bujur berada di luar rentang, aplikasi menunjukkan pesan peringatan. Misalnya: "Sebagian contoh lintang di luar −90 sampai 90. Periksa pemetaan ini." Ini biasanya berarti bahwa kolom lintang dan bujur berada di posisi yang salah. Pilih kolom yang benar.

Jika bidang yang diperlukan tidak memiliki kolom, aplikasi menunjukkan "Petakan bidang wajib sebelum melanjutkan:" dan nama-nama bidang tersebut. Pilih kolom untuk setiap bidang.

Saat semua bidang yang diperlukan memiliki kolom, aplikasi menunjukkan "Semua bidang wajib sudah dipetakan".

Jika aplikasi tidak dapat membaca kolom, aplikasi menunjukkan "Kami tidak dapat memuat pemetaan bidang untuk berkas ini." Tekan Coba lagi. Anda juga dapat menekan Unggah dan analisis tanpa memeriksa kolom.

Ukuran untuk lokasi titik¶

Jika file berisi kolom lintang dan bujur, aplikasi menunjukkan Seberapa besar setiap lokasi?. Anda harus memberikan ukuran sebelum Anda dapat mengunggah.

Untuk file GeoJSON, KML, atau shapefile, ukuran bersifat opsional. Tekan Tampilkan opsi ukuran untuk memberikan ukuran. Jika file berisi titik dan Anda tidak memberikan ukuran, aplikasi tidak membuat lingkaran. Setiap lokasi tetap berupa titik.

PERHATIAN: Pastikan bahwa Anda memilih Luas atau Jari-jari dengan benar. Jika Anda memilih yang salah, lingkaran memiliki ukuran yang salah dan hasilnya tidak benar.

Di Bagaimana ukuran setiap lokasi ditentukan?, pilih salah satu dari dua nilai berikut:
Sama untuk semua baris: satu nilai untuk semua titik.
Dari kolom di dalam berkas: setiap baris memiliki nilainya sendiri di sebuah kolom.
Di Apakah ini luas atau jari-jari?, pilih Luas atau Jari-jari.
Jika Anda memilih Sama untuk semua baris, ketik nilai di Nilai.
Jika Anda memilih Dari kolom di dalam berkas, pilih kolom di Kolom.
Opsional: untuk menganalisis cincin di sekitar setiap lokasi, pilih Tambahkan cincin penyangga di sekitar setiap lokasi.
Jika Anda memilih cincin penyangga, ketik lebar cincin di Penyangga.

Satuannya adalah:

Ukuran	Satuan	Batas
Luas	hektare (ha)	Lebih dari nol.
Jari-jari	kilometer (km)	Paling sedikit 0.001 km (1 m). Tidak lebih dari 500 km.
Penyangga	meter (m)	Bilangan bulat, paling sedikit 1 m. Tidak lebih dari 500,000 m.

Aplikasi memberi tahu Anda hasil dari ukuran tersebut. Misalnya: "lingkaran 1.00 ha → jari-jari ≈ 56.4 m". Aplikasi tidak menebak satuan atau jenis ukuran dari nama kolom.

CATATAN: Cincin penyangga tidak mencakup lokasi itu sendiri. Aplikasi hanya menganalisis cincin di sekitar lokasi. Cincin penyangga berpengaruh pada poligon dan pada titik.

Proyeksi peta¶

Aplikasi harus mendapat koordinat dalam lintang dan bujur WGS 84. Jika koordinat terlihat seperti peta yang diproyeksikan, aplikasi menunjukkan Proyeksi peta yang mana?. Kemudian lakukan langkah-langkah berikut:

Di Proyeksi apa yang digunakan berkas ini?, pilih proyeksi file Anda. Aplikasi dapat menunjukkan sebuah proyeksi dengan teks disarankan (sesuai koordinat Anda).
Tekan Unggah dan analisis lagi.

Aplikasi menggunakan pilihan Anda hanya untuk unggahan ini. Anda dapat memilih salah satu dari proyeksi berikut: EPSG:4326, OGC:CRS84, EPSG:3857 dan EPSG:24818.

Analisis dan tinjauan¶

Setelah Anda mengunggah file, aplikasi menganalisis setiap lokasi. Halaman menunjukkan "Menganalisis unggahan…" dan jumlah lokasi yang telah dianalisis aplikasi.

Selama analisis berlangsung, Anda dapat melakukan salah satu dari tindakan berikut:

Tekan Batal untuk menghentikan unggahan. Aplikasi tidak menyimpan daftar.
Tekan Hentikan & simpan untuk menghentikan analisis. Aplikasi hanya menyimpan lokasi yang telah dianalisisnya. Jika aplikasi tidak menganalisis semua lokasi, daftar memiliki label Tidak lengkap.

Saat analisis selesai, halaman Tinjau catatan yang dianalisis muncul. Halaman ini menunjukkan jumlah Lokasi, Berhasil dianalisis dan Kesalahan. Tabel menunjukkan setiap lokasi dengan Status-nya. Untuk lokasi dengan status Kesalahan, kolom Penjelasan memberi tahu Anda penyebabnya.

Periksa tabel.
Untuk menyimpan daftar, tekan Simpan daftar.
Untuk tidak menyimpan daftar, tekan Buang.

Saat aplikasi menyimpan daftar, halaman Daftar dibuat muncul. Tekan Lihat daftar untuk membuka daftar, atau tekan ← Kembali ke daftar.

Menambahkan satu lokasi secara manual¶

Pilih Tambahkan satu lokasi secara manual.
Ketik nama di Nama. Aplikasi menggunakan nama ini untuk daftar dan untuk lokasi.
Di Bagaimana Anda akan menentukan lokasi?, pilih Titik GPS tunggal atau Batas poligon (3 titik atau lebih).
Ketik koordinat. Lihat langkah-langkah di bawah.
Tekan Buat lokasi.

Untuk titik, lakukan langkah-langkah berikut:

Ketik Lintang dan Bujur dalam derajat desimal (WGS 84).
Di Apakah ini luas atau jari-jari?, pilih Luas atau Jari-jari.
Ketik nilai ukuran.

Untuk poligon, lakukan langkah-langkah berikut:

Ketik lintang dan bujur setiap titik batas. Halaman dimulai dengan tiga titik.
Untuk menambahkan satu titik lagi, tekan Tambahkan titik.
Untuk menghapus titik, tekan Hapus titik untuk titik tersebut. Poligon harus tetap memiliki paling sedikit tiga titik.

Anda tidak mengetik titik pertama lagi di akhir. Aplikasi menutup batas secara otomatis.

Kemudian aplikasi menganalisis lokasi dengan cara yang sama seperti file yang diunggah.

Pesan kesalahan¶

Jika unggahan gagal, halaman menunjukkan judul kesalahan, penyebab, dan tindakan. Untuk melihat data teknis, tekan Detail teknis.

Judul kesalahan	Penyebab	Tindakan
"Jenis berkas tidak didukung"	Aplikasi tidak menerima jenis file ini.	Unggah file CSV, .xlsx, GeoJSON, KML, atau shapefile .zip.
"Berkas terlalu besar"	File lebih besar dari 10 MiB (10,485,760 byte), atau file .zip berisi lebih dari 256 file.	Bagi file menjadi file-file yang lebih kecil. Unggah setiap file sebagai daftar.
"Lembar kerja terlalu lebar"	Satu baris file Excel memiliki lebih dari 512 kolom.	Hapus kolom yang tidak Anda perlukan.
"Terlalu banyak lokasi"	File memiliki lebih dari 5,000 lokasi.	Bagi file menjadi file-file yang lebih kecil. Unggah setiap file sebagai daftar.
"Tidak ada lokasi ditemukan"	File tidak memiliki baris data.	Pastikan bahwa file memiliki baris.
"Arsip tidak dapat dibuka"	File .zip rusak, atau tidak memiliki file .shp.	Ekspor file lagi. Unggah file lagi.
"Kami tidak menemukan kolom lokasi"	Aplikasi tidak dapat menemukan kolom koordinat.	Atur kecocokan kolom. Unggah lagi.
"Kolom itu tidak ada di berkas Anda"	Kecocokan kolom menggunakan kolom yang tidak ada di file.	Periksa kecocokan kolom.
"Tidak ada lokasi valid"	Tidak ada lokasi di file yang memiliki koordinat valid.	Periksa koordinat.
"KML/KMZ tidak dapat dibaca"	File KML bukan file KML yang valid.	Ekspor file lagi. Unggah file lagi.
"Lokasi memerlukan ukuran"	File hanya memiliki titik dan tidak memiliki ukuran.	Berikan ukuran untuk titik.
"Pilih satuan"	Ukuran tidak memiliki satuan.	Pilih Luas atau Jari-jari.
"Kolom tidak ditemukan"	Kolom ukuran tidak ada di file.	Pastikan bahwa judul kolom benar.
"Nilai ukuran tidak dapat digunakan"	Beberapa nilai ukuran kosong, nol, atau terlalu besar.	Periksa nilai ukuran di baris-baris tersebut.
"Proyeksi peta yang mana?"	Koordinat bukan lintang dan bujur WGS 84.	Pilih proyeksi file.
"Proyeksi tidak dikenali"	Aplikasi tidak dapat menggunakan proyeksi untuk file ini.	Pilih proyeksi yang berbeda.
"Unggahan kedaluwarsa"	Anda tidak menyimpan unggahan tepat waktu.	Unggah file lagi.
"Unggahan terputus"	Unggahan berhenti sebelum selesai.	Unggah file lagi.
"Tidak dapat terhubung ke server"	Aplikasi tidak dapat terhubung ke server.	Pastikan bahwa kontainer berjalan. Kemudian coba lagi.

CATATAN: Batas 10 MiB, 512 kolom, dan 5,000 lokasi adalah nilai bawaan. Konfigurasi server dapat mengubahnya.

CATATAN: Kesalahan pada satu lokasi tidak menghentikan unggahan. Tabel tinjauan menunjukkan lokasi yang memiliki kesalahan.

Untuk masalah lain dan tindakan perbaikannya, lihat 07-troubleshooting.md.

Mengganti nama daftar¶

Di halaman daftar, tekan ⋯ di baris daftar.
Pilih Ganti nama.
Ketik nama baru.
Tekan Enter untuk menyimpan nama, atau tekan Esc untuk membatalkan.

Nama dapat memiliki paling banyak 200 karakter. Nama kosong tidak mengubah daftar. Jika aplikasi tidak dapat menyimpan nama, aplikasi menunjukkan "Gagal mengganti nama".

Menghapus daftar¶

PERINGATAN: Pastikan bahwa Anda memilih daftar yang benar. Anda tidak dapat memulihkan daftar setelah Anda menghapusnya.

Di halaman daftar, tekan ⋯ di baris daftar.
Pilih Hapus.
Di pesan konfirmasi, tekan OK.

Jika aplikasi tidak dapat menghapus daftar, aplikasi menunjukkan "Gagal menghapus" dan tetap menyimpan daftar.

Memperbarui daftar¶

Anda tidak dapat menambahkan lokasi ke daftar atau menghapus lokasi dari daftar. Untuk menggunakan kelompok lokasi yang berbeda, buat daftar baru.

Anda dapat menganalisis daftar lagi dengan set data saat ini. Gunakan tindakan ini saat daftar memiliki label Data yang lebih baru tersedia.

PERINGATAN: Baca biaya sebelum Anda menekan Jalankan ulang. Jika dialog menunjukkan "Dibaca dari WRI daring, ditagihkan ke akun AWS Anda", analisis menimbulkan tagihan ke akun AWS Anda. Anda harus memilih Saya memahami bahwa proses ini ditagihkan ke akun AWS saya. sebelum Anda menekan Jalankan ulang.

Di halaman daftar, tekan ⋯ di baris daftar.
Pilih Jalankan ulang dengan data terkini.
Baca set data yang berubah setelah analisis terakhir.
Di Bagaimana proses baru harus diterapkan?, pilih salah satu dari dua nilai berikut:
Perbarui daftar ini: aplikasi mengganti hasil daftar. Nama, catatan, dan tanggal daftar tetap sama.
Buat salinan baru: aplikasi membuat daftar baru dengan lokasi yang sama. Daftar awal tidak berubah.
Tekan Jalankan ulang.

Jika pembaruan gagal, aplikasi tetap menyimpan hasil sebelumnya. Anda juga dapat memulai tindakan ini dari halaman daftar. Untuk data lebih lanjut tentang biaya, lihat 03-analysis-and-results.md.

Menu ⋯ juga memiliki Ekspor. Ekspor mengunduh hasil daftar sebagai file CSV. Anda dapat menekan Ekspor hanya saat analisis daftar selesai. Untuk ekspor, lihat 05-exports.md.