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

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

Dalam tutorial ini, kita akan membahas cara mengatur pelacakan untuk objek diam, perangkat GPS dan tag mana yang akan membantu mengumpulkan data yang diperlukan, dan cara menyiapkannya dengan menggunakan trailer truk sebagai contoh. Kita juga akan membahas cara memperoleh informasi tentang perjalanan dan penggunaan untuk layanan pekerjaan selanjutnya, serta panggilan API mana yang akan memberikan informasi tentang tag. Selain itu, kami akan berbagi kasus penggunaan lain berdasarkan situasi nyata.

## Yang Anda perlukan untuk melacak objek diam

Berbagai perangkat dapat membaca data dari beacon BLE: Galileosky, Quecklink, Ruptela, Teltonika, TopFlyTech\*.\* Kami akan menjelaskannya dengan contoh [Teltonika FMB920](https://navixy.com/en/devices/teltonika-telematics/teltonika-fmb920/) model dan beacon BLE [Eye Sensor](https://teltonika-gps.com/products/accessories/sensors-beacons/eye).\
Untuk memulai pelacakan objek diam, Anda akan memerlukan hal berikut:

1. Sebuah 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. Hal ini meningkatkan kemampuan tag ini untuk melacak informasi, tetapi untuk tujuan kita, kita akan berfokus secara khusus pada objek diam.
3. Platform API yang menyediakan informasi tentang perangkat GPS mana yang berada di dekat Tag tertentu. Untuk membuat solusi kustom bagi pengguna Anda menggunakan API, Anda 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 informasi perjalanan dan penggunaan serta Layanan pekerjaan selanjutnya.

## Cara mengonfigurasi perangkat Anda

Ikuti langkah-langkah berikut untuk mengonfigurasi perangkat Anda agar mengirim data suar 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 lebih nyaman.
2. Di tab System, atur Data Protocol menjadi Codec 8 Extended. Ini memungkinkan perangkat bekerja dengan Tagar 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 (tersembunyi)** 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. Di pengaturan Bluetooth 4.0, nonaktifkan Non-Stop Scan dan atur frekuensi pembaruan serta durasi pemindaian menjadi 30 detik. Pengaturan ini mengoptimalkan pemindaian BLE dengan perangkat.
5. Di pengaturan Bluetooth 4.0 Mode Lanjutan, muat preset EYE Sensor sesuai dengan pengaturan paket di aplikasi EYE.
6. Konfigurasikan alamat MAC sensor.

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

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

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

Anda dapat membaca informasi darinya:

* `tracker_id` - int. ID pelacak (alias "object\_id").
* `id perangkat keras` - string. ID dari beacon.
* `rssi` - int. RSSI adalah singkatan dari received signal strength indicator dan merepresentasikan daya sinyal yang diterima pada perangkat. Berdasarkan nilainya, Anda dapat memahami seberapa jauh beacon dari perangkat.
* `get_time` - [tanggal/waktu](/docs/navixy-api/user-api/getting-started.md#data-types). Saat data ini diterima.
* `lintang` - bilangan pecahan. Lintang.
* `garis bujur` - float. Garis bujur.
* `ext_data` - objek. Data suar 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#post-beacon-data-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 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 yang berada di sekitar suar 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
      }
    },{//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": {
        "voltage": 3.075,
        "temperature": 24.0
  }
  ],
  "success": true
}
```

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

```

## Cara memperoleh informasi tentang waktu penggunaan dan detail perjalanan

Kami sudah 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 perlu menggunakan salah satu dari dua panggilan API:

1. Panggilan API [track/list](/docs/navixy-api/user-api/resources/tracking/track.md#post-track-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, Jalan Main, Kota Tonawanda, New York, Amerika Serikat, 14150",
    "panjang": 18,91,
    "titik": 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 menentukan jumlah pembayaran kepada Supir untuk mengangkut kargo, apakah kecepatan yang tercantum dalam kontrak terlampaui, serta detail lainnya. Selain itu, panjang perjalanan dapat digunakan di masa mendatang untuk menghitung jumlah kilometer hingga Pemeliharaan trailer berikutnya. 2. Jika Anda menginginkan riwayat jejak terperinci dari trailer tempat beacon dipasang untuk ditampilkan dalam laporan, misalnya, Anda dapat menggunakan [track/read](/docs/navixy-api/user-api/resources/tracking/track.md#post-track-read) permintaan. Ini akan memberikan 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, Kota Clarence, County Erie, New York, Amerika Serikat, 14031",
        "satellites": 10,
        "Jarak tempuh": 0,
        "heading": 173,
        "speed": 42,
        "get_time": "2023-04-17 17:05:42",
        "alt": 0,
        "lat": 43,0318683,
        "lng": -78,5985733
        },
        {//objek titik lain 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 tentang cara menggunakan tagar BLE dengan algoritme 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 sebuah kendaraan dapat membantu Anda dengan cepat menentukan Supir yang sesuai untuk penumpang tertentu dan menghindari pemborosan waktu serta 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 lebih dari satu kursi anak.

Untuk mengatasi hal ini, Anda perlu memasang beacon BLE pada setiap kursi anak. Selanjutnya, misalnya 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 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 kemungkinan berada di bagasi. Dengan demikian, Anda dapat memprioritaskan pencarian kendaraan: pertama yang memiliki kursi anak di kabin penumpang, lalu yang memiliki kursi anak di bagasi. Pendekatan ini memastikan bahwa Anda secara efisien mencocokkan penumpang dengan kendaraan dan Supir yang sesuai.

### Mesin pertanian

Misalkan klien Anda memiliki mesin pertanian yang dapat dipasangi 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 saat ini. Dengan begitu, 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. Tempatkan satu beacon BLE pada setiap alat di lokasi aman yang sulit dilepas, sehingga alat tidak hilang selama pekerjaan berlangsung. Selanjutnya, untuk menentukan berapa lama alat telah digunakan, kueri `beacon/read` panggilan API. Informasi dari respons akan bermanfaat, sama seperti pada trailer dalam contoh terperinci kami. Untuk menentukan lokasi alat tertentu, kueri `beacon/last_values` dengan pencarian beacon untuk mengidentifikasi di mana dan pada perangkat mana alat tersebut terpasang. Pendekatan ini memastikan pelacakan dan pemanfaatan peralatan pertanian Anda secara efisien, yang pada akhirnya meningkatkan produktivitas.

### Gunakan di lokasi konstruksi

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

Solusi untuk lokasi konstruksi dapat serupa dengan solusi untuk 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 penempatan. Dengan mengawasi alat dan mesin Anda secara saksama, Anda dapat mengoptimalkan produktivitas di lokasi konstruksi.

### Pelacakan dalam ruangan

Anda dapat melacak item di dalam ruangan secara efektif menggunakan platform dan Tagar BLE. Anda hanya perlu memasang perangkat GPS di berbagai bagian gudang atau bangunan dan menandai objek yang ingin Anda lacak. Berikut beberapa contoh:

* **Pelacakan 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.
* **Pelacakan barang atau mesin di berbagai area gudang**: Mengetahui lokasi barang atau peralatan menghemat waktu, karena Anda tidak perlu mencarinya di seluruh gudang. Hal ini menyederhanakan proses pengambilan, sehingga operasi Anda lebih efisien.

### Pelacakan barang dengan suar BLE

Menggunakan suar BLE untuk pelacakan dapat sangat bermanfaat bagi perusahaan transportasi karena memungkinkan mereka menentukan truk mana yang membawa 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, hal ini menghasilkan layanan yang lebih baik bagi klien dan proses bisnis yang lebih ramping.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.