> 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/user/id/guide/devices-and-settings/connectivity/data-forwarding/startrack.md).

# Startrack

Teruskan posisi kendaraan dari Navixy ke layanan SOAP Startrack, yang digunakan oleh operator armada di Guatemala, El Salvador, dan Honduras.

Startrack menerima posisi kendaraan dari Navixy dan menyediakannya untuk alat pemantauan dan pengelolaannya sendiri. Operator armada di Amerika Tengah menggunakannya, terutama di Guatemala, El Salvador, dan Honduras, untuk pengelolaan Armada, operasi industri dan konstruksi, serta transportasi dengan pengendalian suhu.

Di Navixy, pilih **Startrack** di **Protokol** menu tarik-turun.

## Apa yang dikirim Navixy

Navixy mengirim satu permintaan SOAP untuk setiap posisi ke `receiveWithConfirmation` metode. Permintaan ini memuat bidang-bidang berikut:

| Bidang                    | Isi                                                                          |
| ------------------------- | ---------------------------------------------------------------------------- |
| `vehicleId`               | ID Eksternal perangkat, atau ID perangkat Navixy saat ID Eksternal kosong    |
| `dateAndTime`             | Saat perangkat merekam posisi, dalam ISO 8601                                |
| `y`                       | Lintang dalam derajat                                                        |
| `x`                       | Bujur dalam derajat                                                          |
| `km/jam`                  | Kecepatan dalam kilometer per jam                                            |
| `heading`                 | Arah perjalanan dalam derajat                                                |
| `ignitionIsOn`            | Apakah pengapian menyala                                                     |
| `locationIsValid`         | Apakah posisi merupakan fix GPS yang valid                                   |
| `trackingServiceProvider` | Selalu `navixy-retranslator`, yang mengidentifikasi Navixy sebagai sumbernya |

Perhatikan bahwa `x` adalah bujur dan `y` adalah lintang.

Startrack mengonfirmasi posisi yang diterima dengan `<ok>true</ok>` dalam respons.

### Saat Navixy mengirim

Navixy mengirim setiap Pesan yang memiliki koordinat valid. Pesan tanpa posisi dilewati.

## Sebelum Anda mulai

Kumpulkan alamat endpoint dan port dari Startrack. Layanan ini umumnya dijangkau di `https://cempro.gps.gt/gpsDataService?wsdl` pada port `443`.

Anda juga memerlukan pengidentifikasi kendaraan yang digunakan Startrack untuk setiap perangkat, yang dimasukkan ke bidang ID Eksternal.

Protokol ini tidak menggunakan login atau kata sandi.

## Setelan penerusan

{% stepper %}
{% step %}

### Buka blok Penerusan data

Buka **Perangkat dan pengaturan**, pilih perangkat, lalu temukan blok **Penerusan data** blok.
{% endstep %}

{% step %}

### Buka daftar protokol

Klik **Protokol**, lalu klik **+** untuk menambahkan konfigurasi.
{% endstep %}

{% step %}

### Masukkan pengaturan Startrack

Isi kolom sebagai berikut:

* **Nama**: label yang mengidentifikasi retranslator ini
* **Protokol**: **Startrack**
* **Alamat**: `https://cempro.gps.gt/gpsDataService?wsdl`
* **Port**: `443`

Biarkan **Nama pengguna** dan **Kata sandi** kosong.
{% endstep %}

{% step %}

### Aktifkan dan simpan

Nyalakan **Diaktifkan**, lalu klik **Simpan**. Retranslator yang tidak diaktifkan tidak mengirim apa pun.
{% endstep %}

{% step %}

### Tautkan retranslator ke perangkat

Di blok perangkat **Penerusan data** aktifkan sakelar untuk retranslator yang Anda buat, lalu klik **Simpan**.
{% endstep %}

{% step %}

### Atur External ID

Klik ikon tautan di sisi kanan baris retranslator, lalu masukkan pengidentifikasi kendaraan yang digunakan Startrack. Navixy menerima nilai apa pun di sini, jadi nilai yang tidak cocok dengan catatan Startrack disimpan lalu diabaikan oleh Startrack.

Ulangi langkah ini dan langkah sebelumnya untuk setiap perangkat yang meneruskan ke Startrack.
{% endstep %}
{% endstepper %}

## Kelola penerusan

Untuk mengubah atau menghentikan penerusan ke Startrack:

* Klik ikon tautkan di sebelah kanan baris retranslator untuk mengubah External ID suatu perangkat.
* Matikan sakelar untuk menghentikan penerusan bagi satu perangkat, dan pertahankan konfigurasi untuk perangkat lainnya.
* Klik **Protokol**, pilih barisnya, lalu edit untuk mengubah nama, alamat, atau port. Perubahan diterapkan ke setiap perangkat yang ditautkan ke retranslator ini.
* Hapus konfigurasi dari **Protokol** daftar untuk menghentikan penerusan bagi semua perangkat. Konfirmasi di dialog.

## Pemecahan masalah

Saat data tidak muncul di Startrack, periksa hal berikut secara berurutan:

1. Retranslator diaktifkan, dan sakelarnya dinyalakan untuk perangkat.
2. Alamat dan port sudah benar.
3. ID Eksternal cocok dengan pengidentifikasi kendaraan yang terdaftar di sisi Startrack.
4. Perangkat melaporkan koordinat yang valid.
5. Startrack mengonfirmasi bahwa data diterima.

### Uji endpoint secara langsung

Untuk memeriksa bahwa endpoint Startrack menerima data, kirim permintaan SOAP dengan `curl` menggunakan berkas XML yang telah disiapkan. Respons yang berhasil terlihat seperti ini:

{% code overflow="wrap" %}

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns2:receiveWithConfirmationResponse xmlns:ns2="https://cempro.gps.gt">
      <return>
        <ok>true</ok>
        <result>isOk:true statuses:[ADDED_TO_RECORD_Q] Pesan:[ditambahkan ke antrean perekam]</result>
      </return>
    </ns2:receiveWithConfirmationResponse>
  </soap:Body>
</soap:Envelope>
```

{% endcode %}

Blok `<ok>true</ok>` elemen dan `ADDED_TO_RECORD_Q` status bersama-sama menegaskan bahwa Startrack telah menempatkan posisi ke antrean untuk diproses.


---

# 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/user/id/guide/devices-and-settings/connectivity/data-forwarding/startrack.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.
