# Pelacakan GPS aset statis dengan tag BLE

Setiap objek dapat diintegrasikan ke dalam Internet of Things. Platform ini memungkinkan pelacakan tidak hanya objek bergerak, tetapi juga objek statis, seperti alat berat, peralatan pertanian, kargo, barang, atau peralatan keamanan. Memasang perangkat GPS pada masing-masing objek ini bisa sangat mahal. Sebagai gantinya, lebih hemat biaya untuk memasang satu perangkat pada kendaraan atau lokasi dan melacak semua yang lainnya dengan tag BLE yang lebih murah.

Dalam tutorial ini, kita akan membahas cara mengatur pelacakan untuk objek statis, perangkat GPS dan tag apa yang akan membantu mengumpulkan data yang diperlukan, serta cara mengaturnya dengan menggunakan trailer truk sebagai contoh. Kami juga akan membahas cara memperoleh informasi tentang perjalanan dan penggunaan untuk pekerjaan servis berikutnya, serta panggilan API apa yang akan memberikan informasi tentang tag tersebut. Selain itu, kami akan membagikan contoh penggunaan lain berdasarkan situasi nyata.

## Apa yang Anda perlukan untuk melacak objek statis

Berbagai perangkat dapat membaca data dari beacon BLE: Galileosky, Quecklink, Ruptela, Teltonika, TopFlyTech\*.\* Kami akan menjelaskan 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 objek statis, Anda memerlukan hal-hal berikut:

1. Perangkat GPS yang dapat membaca tag BLE dan didukung oleh platform.
2. Tag BLE yang kompatibel dengan perangkat GPS.\
   Perlu dicatat bahwa banyak tag BLE dapat mengirimkan informasi tentang suhu dan kelembapan, serta daya baterainya. Ini meningkatkan kemampuan tag tersebut untuk melacak informasi, tetapi untuk tujuan kita, kita akan fokus secara khusus pada objek statis.
3. API platform yang memberikan informasi tentang perangkat GPS mana yang sedang berada dekat dengan tag tertentu. Untuk membuat solusi kustom bagi pengguna Anda menggunakan API, Anda memerlukan pengembang. Klien biasanya menyewa pengembang mereka sendiri atau mengontrak tim pihak ketiga.

Sekarang mari kita periksa prosedur untuk menerapkan studi kasus dunia nyata - melacak trailer truk untuk informasi perjalanan dan penggunaan serta pekerjaan servis 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 praktis.
2. Di tab System, atur Data Protocol ke Codec 8 Extended. Ini memungkinkan perangkat bekerja dengan tag BLE.\
   ![How to configure your device](/files/315795e424c2d53029026d9e480a8611c5e037ea)
3. Aktifkan Bluetooth di pengaturan Bluetooth dan pilih "Enable (hidden)" atau "Enable (visible)". Jika tidak, Bluetooth akan dinonaktifkan.\
   ![How to configure your device](/files/14dabe9d90e72c2f2190512375c71de54b6901d7)
4. Di pengaturan Bluetooth 4.0, nonaktifkan Non-Stop Scan dan atur Update Frequency serta Scan Duration menjadi 30 detik. Pengaturan ini mengoptimalkan pemindaian BLE dengan perangkat.
5. Di Bluetooth 4.0 settings Advanced Mode Settings, muat preset EYE Sensor sesuai dengan pengaturan paket di aplikasi EYE.
6. Konfigurasikan alamat MAC sensor.

Perangkat sekarang siap mengirim data dari tag di sekitarnya ke platform.

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

Di sisi platform, ada objek entri data beacon 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": {
    "voltage": 3.075,
    "temperature": 24.0
  }
}
```

Anda dapat membaca informasi darinya:

* `tracker_id` - int. ID pelacak (juga disebut "object\_id").
* `hardware_id` - string. ID beacon.
* `rssi` - int. RSSI adalah singkatan dari received signal strength indicator dan merepresentasikan kekuatan sinyal yang diterima pada suatu perangkat. Berdasarkan ini, Anda dapat memahami seberapa jauh beacon berada dari pelacak.
* `get_time` - [tanggal/waktu](https://www.navixy.com/docs/navixy-api/user-api/backend-api#data-types). Saat data ini diterima.
* `latitude` - float. Lintang.
* `longitude` - float. Bujur.
* `ext_data` - object. Data tambahan beacon.

### Panggilan API untuk mendapatkan informasi tentang tag BLE

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

1. Panggilan pertama mengambil [data historis dari perangkat](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/beacon/index#read). Anda dapat mengatur parameter "from" dan "to" untuk memperoleh data selama periode tertentu tentang beacon BLE yang terhubung. Karena kita memerlukan informasi dari sudut pandang tag BLE, yaitu trailer, mari kita minta informasi 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 menunjukkan perangkat mana saja yang berada di sekitar beacon BLE 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": {
        "voltage": 3.075,
        "temperature": 24.0
      }
    },{//other objects per period
    },
    {
      "tracker_id": 10181654,
      "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
      "rssi": -101,
      "get_time": "2023-04-17 17:40:22", //a last point per period
      "latitude": 55.348890,
      "longitude": 6.59403,
      "ext_data": {
        "voltage": 3.075,
        "temperature": 24.0
  }
  ],
  "success": true
}
```

2\. Panggilan kedua mengambil informasi tentang [beacon yang saat ini terhubung](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/beacon/index#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", "trackers": [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": {
        "voltage": 3.075,
        "temperature": 24.0
    }
  ],
  "success": true
}

```

## Cara memperoleh informasi tentang waktu penggunaan dan detail perjalanan

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

1. panggilan API [track/list](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/track/index#list) untuk mendapatkan informasi perjalanan selama periode tersebut. Ini akan memberikan 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, Main Street, City of Tonawanda, New York, United States, 14150",
    "length": 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 pengemudi untuk mengangkut kargo, apakah kecepatan yang disepakati terlampaui, dan detail lainnya. Selain itu, panjang perjalanan dapat digunakan di masa mendatang untuk menghitung jumlah kilometer hingga perawatan trailer berikutnya. 2. Jika Anda menginginkan catatan pelacakan terperinci dari trailer tempat beacon dipasang untuk menampilkannya dalam laporan, misalnya, Anda dapat menggunakan [track/read](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/track/index#read) permintaan. Ini akan memberi kita 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, United States, 14031",
        "satellites": 10,
        "mileage": 0,
        "heading": 173,
        "speed": 42,
        "get_time": "2023-04-17 17:05:42",
        "alt": 0,
        "lat": 43.0318683,
        "lng": -78.5985733
        },
        {//other point objects per this trip
        }
    ]
}
```

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

## Contoh lain penggunaan tag BLE dan API Navixy

Berikut beberapa contoh lain tentang cara menggunakan tag BLE dengan algoritma singkat untuk mendapatkan hasil yang Anda perlukan:

### Kursi anak

Kursi anak wajib bagi penumpang yang bepergian dengan anak-anak. Jika Anda atau pengguna menjalankan layanan transportasi penumpang, mengetahui apakah kursi anak tersedia di kendaraan dapat membantu Anda dengan cepat menentukan pengemudi mana yang sesuai untuk penumpang tertentu dan menghindari pemborosan waktu serta bahan bakar. Anda juga dapat mengetahui pengemudi 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 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 pengemudi yang memiliki kursi anak terpasang. Untuk melakukannya, gunakan panggilan API beacon/last\_values untuk mengumpulkan informasi tentang pengemudi mana yang dapat ditugaskan pada pesanan tertentu.

Anda juga dapat menggunakan parameter RSSI untuk menentukan apakah kursi 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, kemungkinan kursi berada di bagasi. 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 Anda secara efisien mencocokkan penumpang dengan kendaraan dan pengemudi yang sesuai.

### Mesin pertanian

Misalkan klien Anda memiliki mesin pertanian yang dapat dihubungkan ke berbagai peralatan. Bagaimana Anda dapat melacak traktor mana yang menggunakan seeder dan mana yang memiliki bajak? Informasi ini akan membantu Anda memahami frekuensi dan tingkat penggunaan alat, serta menentukan lokasi terkini mereka. Dengan cara ini, pekerja dapat menghabiskan lebih banyak waktu bekerja di lapangan daripada mencari peralatan. Untuk mencapainya, pasang perangkat pada traktor dan combine harvester, serta di area penyimpanan alat. Letakkan satu beacon BLE pada setiap alat di tempat aman yang sulit dilepas, sehingga tidak hilang selama bekerja. Selanjutnya, untuk menentukan berapa lama alat telah digunakan, lakukan kueri pada `beacon/read` panggilan API. Informasi dari respons akan bermanfaat, sama seperti pada trailer dalam contoh rinci kami. Untuk menentukan lokasi alat tertentu, lakukan kueri `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 yang 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 kekhawatiran lain – bagaimana Anda dapat memastikan bahwa peralatan dilacak secara sering, dan bahwa pelacak GPS tidak kehabisan daya? Untuk memantau penggunaan dan lokasi peralatan, beacon BLE juga dapat sangat membantu.

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

### Pelacakan dalam ruangan

Anda dapat melacak item secara efektif di dalam ruangan menggunakan platform dan tag BLE. Anda hanya perlu 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 karyawan berada di area mana atau berapa banyak pramuniaga yang berada di dekat meja informasi. Memiliki informasi ini membantu meningkatkan efisiensi dan memastikan staf berada di tempat yang semestinya.
* **Melacak barang atau mesin di berbagai area gudang**: Mengetahui lokasi barang atau peralatan menghemat waktu, karena Anda tidak perlu mencarinya di seluruh gudang. Ini menyederhanakan proses pengambilan, sehingga operasi Anda menjadi lebih efisien.

### Melacak barang dengan beacon BLE

Memanfaatkan beacon 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 rute barang, tetapi juga membantu menghitung biaya transportasi dengan lebih akurat.

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


---

# Agent Instructions: 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:

```
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>
```

The question should be specific, self-contained, and written in natural language.
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.