> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jitra.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Menambahkan Object dengan Jitra Tracker App

> Gunakan ponsel Android sebagai sumber lokasi: buat Object, aktifkan Jitra Tracker, izinkan lokasi, lalu mulai tracking.

Gunakan **Jitra Tracker** untuk mengirim lokasi ponsel Android ke sebuah Object di Jitra. Panduan ini mencakup pembuatan Object, aktivasi aplikasi pada ponsel, dan pemeriksaan lokasi pertama.

**Jitra Web dan Jitra Mobile** digunakan untuk mengelola serta memantau Object. **Jitra Tracker** adalah aplikasi berbeda yang mengirim lokasi ponsel. Pada form pembuatan Object, sumber ini bernama **Jitra Tracker App**.

Jika menggunakan GPS fisik, ikuti [Menambahkan Object dengan GPS Device](https://docs.jitra.app/id/getting-started/adding-your-first-object.md).

## Sebelum memulai

Siapkan:

* Akun Jitra dengan pengaturan Organization yang sudah selesai, izin membuat Object, dan slot Object yang tersedia.
* Ponsel **Android** dengan Jitra Tracker terpasang, layanan lokasi aktif, dan koneksi internet.
* Akses ke ponsel yang akan digunakan untuk memberikan izin lokasi dan menyelesaikan aktivasi.

Jitra Tracker saat ini tersedia untuk Android. Pengguna ponsel tidak perlu masuk menggunakan akun Organization; aplikasi dihubungkan melalui aktivasi.

Jika belum memiliki aplikasi Jitra Tracker, [hubungi dukungan Jitra](https://docs.jitra.app/id/troubleshooting/contacting-jitra-support.md) untuk mendapatkan panduan pemasangannya. Aplikasi **Jitra Mobile** untuk monitoring bukan pengganti Jitra Tracker.

## 1. Buat Object dan buka aktivasi

Pilih platform yang Anda gunakan untuk mengelola Object. Langkah di ponsel Android setelah ini sama untuk kedua pilihan.

> [tab] Web
>
> 1. Buka **Settings → Objects → New**.
> 2. Pada **Tracking Method**, pilih **Jitra Tracker App**.
> 3. Isi **Object Name** dengan nama yang mudah dikenali, hingga 100 karakter.
>
> ![Form Jitra Tracker App di Jitra Web hanya memerlukan nama Object](https://mintcdn.com/jitra/SCVxTf2iaOVFHisN/images/knowledge-base/getting-started/register-object-web-tracker.jpg?fit=max\&auto=format\&n=SCVxTf2iaOVFHisN\&q=85\&s=749b41f61b3d9b836bd93a85a19c60d2)
>
> 4. Klik **Save**. Jitra membuat Object lalu membuka **Tracker activation**.
>
> Halaman ini menampilkan nama Object, status **Waiting**, QR, **Activation code**, **Deep link**, dan **Expires at**. Gunakan aktivasi dari halaman Anda sendiri untuk menghubungkan ponsel.
>
> ![Halaman Tracker activation pada Jitra Web](https://mintcdn.com/jitra/SCVxTf2iaOVFHisN/images/knowledge-base/getting-started/tracker-web-activation.jpg?fit=max\&auto=format\&n=SCVxTf2iaOVFHisN\&q=85\&s=cd376186854b170d442a9dd069e934a3)

> [tab] Mobile
>
> 1. Buka menu Jitra Mobile, lalu **Settings → Objects** dan ketuk **+**.
> 2. Pilih **Jitra Tracker App**.
> 3. Isi **Object Name** dengan nama yang mudah dikenali, hingga 100 karakter.
>
> ![Form Jitra Tracker App pada Jitra Mobile](https://mintcdn.com/jitra/SCVxTf2iaOVFHisN/images/knowledge-base/getting-started/tracker-mobile-form.jpg?fit=max\&auto=format\&n=SCVxTf2iaOVFHisN\&q=85\&s=45779aeaaa60d85237e759edb551245c)
>
> 4. Ketuk **Save** di bagian bawah. Jitra membuat Object lalu membuka **Tracker Activation**.
>
> Halaman ini menampilkan nama Object, status **Waiting**, QR, **Activation code**, **Deep link**, dan **Expires**. Gunakan **Copy code** atau **Copy link** untuk menyalin informasi yang diperlukan.
>
> ![Halaman Tracker Activation pada Jitra Mobile](https://mintcdn.com/jitra/SCVxTf2iaOVFHisN/images/knowledge-base/getting-started/tracker-mobile-activation.jpg?fit=max\&auto=format\&n=SCVxTf2iaOVFHisN\&q=85\&s=61074f0c2f80137bf411456e0d381bce)

> [!NOTE]
>
> Metode ini tidak memerlukan GPS Device Model, Device ID, server address, atau port. Kode dan QR pada screenshot hanya contoh dan sudah tidak berlaku.

## 2. Aktifkan Jitra Tracker pada ponsel

Buka **Jitra Tracker** pada ponsel Android yang akan mengirim lokasi. Pilih salah satu cara berikut:

| Cara | Langkah |
| - | - |
| Kode manual | Masukkan **Activation code** dari Jitra, lalu ketuk **Continue**. |
| QR | Pilih **Scan QR code**, izinkan kamera saat diminta, lalu pindai QR yang ditampilkan pada layar lain. |
| Tautan aktivasi | Buka **Deep link** pada ponsel yang sudah memasang Jitra Tracker. Jika tautan tidak membuka aplikasi, gunakan kode manual. |

Jika Jitra Mobile dan Jitra Tracker digunakan pada ponsel yang sama, cara paling praktis adalah menyalin kode lalu memasukkannya ke Jitra Tracker. Anda tidak perlu memindai QR pada layar ponsel itu sendiri.

Periksa **nama Object** dan **Organization** pada layar konfirmasi, lalu ketuk **Confirm activation** hanya jika keduanya benar. Setelah berhasil, aplikasi melanjutkan ke pengaturan tracking untuk Object tersebut.

> [!WARNING]
>
> Bagikan kode, QR, atau tautan aktivasi hanya kepada pengguna ponsel yang memang akan menjadi sumber lokasi Object. Aktivasi terikat ke satu instalasi aplikasi dan tidak dapat digunakan ulang setelah berhasil dipakai.

## 3. Izinkan lokasi dan mulai tracking

Aktivasi menghubungkan aplikasi ke Object; **aktivasi belum berarti lokasi sudah dikirim**.

1. Pada Jitra Tracker, selesaikan izin lokasi yang diminta. Jika tampil **Permission Problem**, pilih **Allow location access**.
2. Pastikan akses lokasi perangkat dan lokasi latar belakang tersedia. Jika dialog izin tidak muncul, buka pengaturan Android untuk Jitra Tracker dan periksa izin lokasinya.
3. Saat aplikasi siap, ketuk **Start Tracking**.
4. Periksa status tracking serta **Last sent**. Pesan **No locations sent yet.** berarti belum ada lokasi yang berhasil dikirim.

Agar tracking berlanjut di latar belakang, pertahankan izin yang diperlukan dan ikuti petunjuk pengaturan baterai pada perangkat. Perilaku latar belakang juga bergantung pada Android dan kondisi ponsel.

Gunakan **Stop Tracking** ketika ingin menghentikan pengambilan lokasi baru. Lokasi yang sebelumnya sudah mengantre masih dapat disinkronkan saat koneksi tersedia.

## 4. Periksa lokasi di Jitra

Buka **Tracking** melalui Jitra Web atau Jitra Mobile, pilih Object yang baru dibuat, lalu periksa lokasi dan waktu update terakhir.

Jika aktivasi berhasil tetapi lokasi belum muncul, periksa Jitra Tracker pada ponsel: tracking sudah dimulai, layanan serta izin lokasi aktif, koneksi tersedia, dan pengiriman lokasi berhasil. Status **Waiting** pada halaman aktivasi dan status lokasi Object bukan kondisi yang sama.

## Jika belum berhasil

| Kondisi | Yang perlu dilakukan |
| - | - |
| Kode salah, kedaluwarsa, atau dicabut | Periksa kode serta waktu kedaluwarsa. Pada halaman aktivasi, gunakan **Regenerate code** atau **New activation** sesuai status, lalu gunakan kode terbaru. Kode sebelumnya tidak berlaku lagi. |
| QR tidak dapat dipindai | Periksa izin kamera atau gunakan kode manual. |
| Aplikasi menampilkan **Permission Problem** | Lengkapi izin lokasi di Jitra Tracker dan pengaturan Android. |
| Tracking aktif tetapi ponsel offline | Periksa koneksi. Lokasi yang mengantre akan dicoba dikirim saat koneksi kembali tersedia; periksa status sinkronisasi. |
| Ponsel diganti, aplikasi dipasang ulang, atau Object sudah terhubung | Hubungi pengguna yang mengelola Object untuk memeriksa koneksi lama dan menyiapkan aktivasi ulang. Satu Object hanya menggunakan satu instalasi Tracker aktif. |

Jika masalah berlanjut, buka **Diagnostics** di Jitra Tracker dan [hubungi dukungan Jitra](https://docs.jitra.app/id/troubleshooting/contacting-jitra-support.md). Jangan menyertakan kode aktivasi yang masih aktif dalam materi yang dibagikan secara publik.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.