> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/id/faq-and-troubleshooting/access-iot-data/gps-tracking-of-stationary-assets-with-ble-tags.md).

# Pelacakan GPS aset diam dengan tag BLE

Lacak aset diam menggunakan tag BLE yang dipasang pada perangkat GPS. Siapkan konfigurasi perangkat dan integrasi API untuk memantau trailer dan peralatan.

Pelacak apa pun dapat diintegrasikan ke dalam Internet of Things. Platform Navixy memungkinkan pelacakan bukan hanya Pelacak yang dapat dipindahkan, tetapi juga yang tetap, seperti alat berat, peralatan pertanian, kargo, barang, atau peralatan Keamanan. Menginstal perangkat GPS pada masing-masing Pelacak ini bisa sangat mahal. Sebagai gantinya, lebih hemat biaya untuk memasang satu perangkat pada kendaraan atau lokasi dan melacak semua Pelacak lainnya dengan Tagar BLE yang lebih murah.

Dalam tutorial ini, kami akan membahas cara mengatur pelacakan untuk pelacak yang tetap, perangkat GPS dan tagar apa yang akan membantu mengumpulkan data yang diperlukan, serta cara mengonfigurasikannya dengan menggunakan trailer truk sebagai contoh. Kami juga akan membahas cara memperoleh informasi tentang Perjalanan dan penggunaan untuk Layanan pekerjaan selanjutnya dan panggilan API apa yang akan menyediakan informasi tentang Tagar. Selain itu, kami akan membagikan kasus penggunaan lain berdasarkan situasi nyata.

## Yang Anda perlukan untuk melacak pelacak yang tetap

Berbagai perangkat mampu membaca data dari suar BLE: Galileosky, Quecklink, Ruptela, Teltonika, TopFlyTech\*.\* Kami akan menjelaskannya dengan contoh [Teltonika FMB920](https://www.navixy.com/devices/teltonika/teltonika-fmb920/) model dan beacon BLE [Eye Sensor](https://teltonika-gps.com/products/accessories/sensors-beacons/eye).\
Untuk mulai melacak pelacak yang tetap, Anda memerlukan hal berikut:

1. Perangkat GPS yang dapat membaca Tagar BLE dan didukung oleh platform.
2. Tagar BLE yang kompatibel dengan perangkat GPS.\
   Perlu dicatat bahwa banyak Tagar BLE dapat mengirimkan informasi tentang suhu dan kelembapan, serta daya baterainya. Hal ini meningkatkan kemampuan Tagar ini untuk melacak informasi, tetapi untuk tujuan kita, kita akan fokus secara khusus pada pelacak yang tetap.
3. API platform yang menyediakan informasi tentang perangkat GPS mana yang berada di dekat tag tertentu. Untuk membuat solusi khusus bagi pengguna Anda menggunakan API, Anda akan memerlukan pengembang. Klien biasanya merekrut pengembang mereka sendiri atau mengontrak tim pihak ketiga.

Sekarang mari kita periksa prosedur untuk menerapkan studi kasus dunia nyata: melacak trailer truk untuk mendapatkan informasi perjalanan dan penggunaan serta Layanan pekerjaan berikutnya.

## Cara mengonfigurasi perangkat Anda

Ikuti langkah-langkah berikut untuk mengonfigurasi perangkat Anda agar mengirim data beacon BLE ke platform:

1. Unduh [Teltonika Configurator](https://wiki.teltonika-gps.com/view/Teltonika_Configurator_versions). Aplikasi ini menyederhanakan banyak pengaturan sekaligus. Anda dapat menyimpan preset dan menggunakannya di FOTA Web untuk mengonfigurasi perangkat lain, sehingga prosesnya menjadi lebih nyaman.
2. Di tab Sistem, atur Protokol Data ke Codec 8 Extended. Ini memungkinkan perangkat bekerja dengan tag BLE.\
   ![How to configure your device](https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-8433b20ef4cd49373258c953fbbde9fea2227af5%2Fimage-20230619-101210.png?alt=media)
3. Aktifkan Bluetooth di pengaturan Bluetooth dan pilih salah satu **Aktifkan (disembunyikan)** atau **Aktifkan (terlihat)**. Jika tidak, Bluetooth akan dinonaktifkan.\
   ![How to configure your device](https://3546701789-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-9f6aed56b6c024c490422e276f2bcd3fb3add0d5%2Fbrowser_ivSpIqPwoh.png?alt=media)
4. Dalam pengaturan Bluetooth 4.0, nonaktifkan Pindai tanpa henti dan atur Frekuensi pembaruan serta Durasi pemindaian menjadi 30 detik. Pengaturan ini mengoptimalkan pemindaian BLE dengan perangkat.
5. Dalam pengaturan Bluetooth 4.0 Pengaturan mode lanjutan, muat prasetel EYE Sensor sesuai dengan pengaturan paket di aplikasi EYE.
6. Konfigurasikan alamat MAC sensor.

Perangkat kini siap mengirim data dari Tagar di sekitar ke platform.

## Cara mendapatkan informasi tentang suar BLE di dekat perangkat GPS

Di sisi platform, ada objek entri data suar BLE:

```json
{
  "tracker_id": 10181654,
  "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
  "rssi": -101,
  "get_time": "2023-04-17 17:14:42",
  "latitude": 50.3487321,
  "longitude": 7.58238,
  "ext_data": {
    "tegangan": 3.075,
    "suhu": 24,0
  }
}
```

Anda dapat membaca informasi darinya:

* `tracker_id` - int. ID pelacak (juga dikenal sebagai "object\_id").
* `hardware_id` - string. ID dari beacon.
* `rssi` - int. RSSI adalah singkatan dari received signal strength indicator dan merepresentasikan kekuatan sinyal yang diterima pada perangkat. Berdasarkan nilai ini, Anda dapat memahami seberapa jauh beacon berada dari perangkat.
* `get_time` - [Tanggal/waktu](/docs/navixy-api/user-api/getting-started.md#data-types). Saat data ini diterima.
* `latitude` - float. Lintang.
* `longitude` - pecahan. Bujur.
* `ext_data` - objek. Data beacon tambahan.

### Panggilan API untuk mendapatkan informasi tentang Tagar BLE

Ada dua panggilan API yang memungkinkan Anda mendapatkan semua informasi yang diperlukan tentang suar BLE:

1. Panggilan pertama mengambil [data historis dari perangkat](/docs/navixy-api/user-api/resources/tracking/beacon.md#read). Anda dapat menetapkan parameter "from" dan "to" untuk memperoleh data selama periode tertentu tentang suar BLE yang terhubung. Karena kita memerlukan informasi dari sudut pandang Tagar BLE, yaitu trailer, mari minta informasi tersebut menggunakan parameter "beacons".\
   Contoh permintaan:

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.navixy.com/v2/beacon/data/read' \
    -H 'Content-Type: application/json' \
    -d '{"hash":"59be129c1855e34ea9eb272b1e26ef1d","from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00","beacons": ["7cf9501df3d6924e423cabcde4c924ff"]}'
```

{% endcode %}

Ini akan menampilkan perangkat mana yang berada di sekitar BLE beacon ini selama periode tersebut.

Balasan:

```json
{
  "list": [
    {
      "tracker_id": 10181654,
      "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
      "rssi": -101,
      "get_time": "2023-04-17 17:05:42",
      "latitude": 50.3487321,
      "longitude": 7.58238,
      "ext_data": {
        "tegangan": 3.075,
        "suhu": 24,0
      }
    },{//objek lain per periode
    },
    {
      "tracker_id": 10181654,
      "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
      "rssi": -101,
      "get_time": "2023-04-17 17:40:22", //titik terakhir per periode
      "latitude": 55.348890,
      "longitude": 6.59403,
      "ext_data": {
        "tegangan": 3.075,
        "suhu": 24,0
  }
  ],
  "success": true
}
```

2\. Panggilan kedua mengambil informasi tentang [beacon yang saat ini terhubung](/docs/navixy-api/user-api/resources/tracking/beacon.md#last-values) ke perangkat tertentu. Misalnya, jika Anda ingin mengetahui trailer mana yang saat ini berada di dekat perangkat, gunakan permintaan berikut:

Contoh permintaan:

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.navixy.com/v2/beacon/data/last_values' \
    -H 'Content-Type: application/json' \
    -d '{"hash":"59be129c1855e34ea9eb272b1e26ef1d", "devices": [10181654], "skip_older_than_seconds": 1200}
```

{% endcode %}

Ini akan memberikan informasi bahwa ada trailer "7cf..." di sebelah perangkat.

Respons:

```json
{
  "list": [
    {
      "tracker_id": 10181654,
      "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
      "rssi": -101,
      "get_time": "2023-04-17 17:40:22",
      "latitude": 55.348890,
      "longitude": 6.59403,
      "ext_data": {
        "tegangan": 3.075,
        "suhu": 24,0
    }
  ],
  "success": true
}

```

## Cara mendapatkan informasi tentang waktu penggunaan dan detail perjalanan

Kami sudah mengumpulkan data historis menggunakan panggilan API pertama yang disajikan, yang menunjukkan di perangkat mana trailer ditampilkan pada waktu tertentu. Untuk mendapatkan informasi tentang perjalanan dan waktu penggunaan trailer ini, kita perlu menggunakan salah satu dari dua panggilan API:

1. panggilan API [track/list](/docs/navixy-api/user-api/resources/tracking/track.md#list) untuk mendapatkan informasi perjalanan untuk periode tersebut. Ini akan menyediakan informasi umum tentang perjalanan, seperti di mana dan kapan perjalanan dimulai dan berakhir, kecepatan maksimum, jarak tempuh, dan lainnya.\
   Permintaan:

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.navixy.com/v2/track/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "59be129c1855e34ea9eb272b1e26ef1d", "tracker_id": 10181654, "from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00", "split": true, "limit": 3000, "filter": true, "include_gsm_lbs": true}'
```

{% endcode %}

Respons:

```json
{
    "id": 11672,
    "start_date": "2023-04-17 17:05:42",
    "start_address": "10470, County Road, Town of Clarence, Erie County, New York, United States, 14031",
    "max_speed": 62,
    "end_date": "2023-04-17 17:40:22",
    "end_address": "Fast Teddy's, 221, Jalan Utama, Kota Tonawanda, New York, Amerika Serikat, 14150",
    "panjang": 18,91,
    "points": 59,
    "avg_speed": 49,
    "event_count": 3,
    "norm_fuel_consumed": 6,32,
    "type": "regular",
    "gsm_lbs": false
}
```

Dari data ini, kita dapat melihat bahwa perjalanan berlangsung hampir 35 menit (end\_date - start\_date), dengan kecepatan rata-rata 49 km/jam dan kecepatan maksimum 62 km/jam. Panjang perjalanan adalah 18,91 km. Informasi ini memungkinkan kita untuk menentukan berapa yang harus dibayarkan kepada Supir untuk mengangkut muatan, apakah kecepatan kontrak terlampaui, dan detail lainnya. Selain itu, panjang perjalanan dapat digunakan di masa mendatang untuk menghitung jumlah kilometer hingga Pemeliharaan trailer berikutnya. 2. Jika Anda ingin riwayat lintasan terperinci trailer tempat beacon dipasang untuk menampilkannya dalam laporan, misalnya, Anda dapat menggunakan [lacak/baca](/docs/navixy-api/user-api/resources/tracking/track.md#read) permintaan. Ini akan memberi kami data tentang semua titik yang diterima oleh platform selama perjalanan.\
Permintaan:

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.navixy.com/v2/track/read' \\
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": 10181654, "from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00", "filter": true}'
```

{% endcode %}

Respons:

```json
{
    "success": true,
    "limit_exceeded": true,
    "list": [
        {
        "address": "10470, County Road, Town of Clarence, Erie County, New York, Amerika Serikat, 14031",
        "satelit": 10,
        "jarak tempuh": 0,
        "judul": 173,
        "speed": 42,
        "get_time": "2023-04-17 17:05:42",
        "alt": 0,
        "lat": 43.0318683,
        "lng": -78.5985733
        },
        {//objek titik lainnya untuk perjalanan ini
        }
    ]
}
```

Anda dapat menggunakan titik-titik ini bersama API peta pilihan Anda untuk menampilkannya di peta.

## Contoh lain penggunaan tagar BLE dan API Navixy

Berikut beberapa contoh lain cara menggunakan tagar BLE dengan algoritma singkat untuk mendapatkan hasil yang Anda butuhkan:

### Kursi anak

Kursi anak wajib bagi penumpang yang bepergian dengan anak-anak. Jika Anda atau pengguna mengoperasikan layanan transportasi penumpang, mengetahui apakah kursi anak tersedia di kendaraan dapat membantu Anda dengan cepat menentukan Supir mana yang cocok untuk penumpang tertentu dan menghindari pemborosan waktu dan Bahan bakar. Anda juga dapat mengetahui Supir mana yang saat ini memiliki kursi anak terpasang di kendaraannya. Selain itu, penting untuk mempertimbangkan penumpang dengan dua anak atau lebih dan mengidentifikasi mobil yang dilengkapi dengan lebih dari satu kursi anak.

Untuk mengatasi hal ini, Anda perlu memasang beacon BLE pada setiap kursi anak. Selanjutnya, misalkan aplikasi pemesanan transportasi Anda perlu meminta informasi dari semua Supir yang memiliki kursi anak terpasang. Untuk melakukannya, gunakan panggilan API beacon/last\_values untuk mengumpulkan informasi tentang Supir mana yang dapat ditugaskan ke pesanan tertentu.

Anda juga dapat menggunakan parameter RSSI untuk menentukan apakah kursi anak berada di dalam kendaraan atau di bagasi. Untuk melakukannya, Anda perlu melakukan beberapa pengujian. Misalnya, jika nilai RSSI lebih rendah di kabin penumpang daripada di bagasi, kursi anak kemungkinan berada di bagasi. Sebagai hasilnya, Anda dapat memprioritaskan pencarian kendaraan Anda: pertama, yang memiliki kursi anak di kabin penumpang, lalu yang memiliki kursi anak di bagasi. Pendekatan ini memastikan bahwa Anda mencocokkan penumpang dengan kendaraan dan supir yang sesuai secara efisien.

### Mesin pertanian

Bayangkan klien Anda memiliki mesin pertanian yang dapat dihubungkan ke berbagai peralatan. Bagaimana Anda dapat melacak traktor mana yang menggunakan penanam benih dan mana yang memiliki bajak? Informasi ini akan membantu Anda memahami frekuensi dan tingkat penggunaan alat, serta menentukan lokasi saat ini. Dengan cara ini, pekerja dapat menghabiskan lebih banyak waktu bekerja di lapangan daripada mencari peralatan. Untuk mencapainya, pasang perangkat pada traktor dan mesin panen, serta di area penyimpanan alat. Tempatkan satu beacon BLE pada setiap alat di tempat yang aman dan sulit dilepas, sehingga alat tidak hilang selama bekerja. Selanjutnya, untuk menentukan berapa lama alat telah digunakan, kirim kueri ke `beacon/read` Panggilan API. Informasi dari respons akan berguna, seperti pada trailer dalam contoh mendetail kami. Untuk menentukan lokasi alat tertentu, kirim kueri ke `beacon/last_values` dengan pencarian beacon untuk mengidentifikasi di mana dan pada perangkat mana alat tersebut dipasang. Pendekatan ini memastikan pelacakan dan pemanfaatan peralatan pertanian Anda secara efisien, yang pada akhirnya meningkatkan produktivitas.

### Penggunaan di lokasi konstruksi

Lokasi konstruksi sering memiliki banyak alat dan peralatan mahal. Meskipun memasang beacon untuk tujuan pelacakan bermanfaat, ada masalah lain yang muncul. Bagaimana Anda dapat memastikan bahwa peralatan dilacak secara berkala, dan perangkat GPS tidak kehabisan daya? Untuk memantau penggunaan dan lokasi peralatan, beacon BLE juga dapat sangat berguna.

Solusi untuk lokasi konstruksi dapat serupa dengan mesin pertanian: pasang perangkat pada mesin serta di lokasi penyimpanan. Pendekatan ini memungkinkan Anda melacak peralatan berharga secara efektif, memastikan bahwa peralatan tersebut digunakan secara efisien, dan meminimalkan risiko kehilangan atau salah tempat. Dengan mengawasi alat dan mesin Anda secara saksama, Anda dapat mengoptimalkan produktivitas di lokasi konstruksi.

### Pelacakan dalam ruangan

Anda dapat melacak barang di dalam ruangan secara efektif menggunakan platform dan Tagar BLE. Yang perlu Anda lakukan hanyalah memasang perangkat GPS di berbagai bagian gudang atau bangunan dan memberi Tag pada objek yang ingin Anda lacak. Berikut beberapa contohnya:

* **Melacak karyawan di berbagai area gudang atau toko**: Ini memungkinkan Anda mengetahui area tempat seorang karyawan berada atau berapa banyak asisten penjualan yang berada di dekat meja informasi. Memiliki informasi ini membantu meningkatkan efisiensi dan memastikan bahwa anggota Staf berada di tempat yang seharusnya.
* **Melacak barang atau mesin di berbagai area gudang**: Mengetahui lokasi barang atau peralatan menghemat waktu, karena Anda tidak perlu mencarinya di seluruh gudang. Hal ini memperlancar proses pengambilan, sehingga operasi Anda lebih efisien.

### Melacak barang dengan suar BLE

Menggunakan suar BLE untuk pelacakan dapat sangat menguntungkan perusahaan transportasi dengan memungkinkan mereka menentukan truk mana yang mengangkut palet barang tertentu pada saat tertentu. Metode ini tidak hanya memungkinkan pelacakan jalur barang, tetapi juga membantu menghitung biaya transportasi dengan lebih akurat.

Dengan mengadopsi pendekatan inovatif ini, perusahaan transportasi dapat meningkatkan operasional mereka, membuatnya lebih efisien dan presisi. Pada akhirnya, ini menghasilkan layanan yang lebih baik bagi klien dan proses bisnis yang lebih lancar.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/expert-center/id/faq-and-troubleshooting/access-iot-data/gps-tracking-of-stationary-assets-with-ble-tags.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.