# Navixy Web Service

{% hint style="info" %}
**Kategori Protokol:** Protokol konsolidasi data
{% endhint %}

#### Daftar isi

1. [Apa itu Navixy Web Service?](#what-is-ws)
2. [Informasi teknis tentang Navixy Web Service](#tech-info-ws)
3. [Konfigurasi Navixy Web Service](#ws-config)
4. [Penyiapan](#setting-up)
5. [Pengelolaan](#managing)
6. [Pemecahan masalah](#troubleshooting)

### Apa itu Navixy Web Service?

**Navixy Web Service** protokol penerusan data mengirimkan data armada dari sistem Navixy ke sistem pihak ketiga mana pun. Protokol ini fleksibel, memungkinkan pihak ketiga menyimpan data armada di basis data mereka untuk digunakan untuk tujuan apa pun atau menampilkan data di sumber daya web.

Karena protokol penerusan data ini tidak bergantung pada platform, ini akan menjadi opsi ideal bagi mitra mana pun yang bekerja dengan file XML.

### Informasi teknis umum Navixy Web Service

Protokol Navixy Web Service menggunakan SOAP untuk memungkinkan penarikan data XML dari perangkat pelacak sebagai bagian dari lapisan aplikasi OSI. Data ditarik sesuai permintaan.

Bidang data yang dikirim:

* `dateGPS`: Tanggal dan waktu dalam UTC
* `ignition`: Status ignition boolean
* `latitude`
* `longitude`
* `speedGPS`: km/jam
* `unitPlate`: Plat nomor
* `altitude`: Meter
* `course`: Arah kendaraan, misalnya: **N,S,E,O,NO,NE,SO,SE**
* `deviceId`: IMEI
* `numSat`: Jumlah satelit GNSS yang digunakan perangkat
* `odometer`: Jarak tempuh dalam km
* `eventId`: kode peristiwa sesuai dengan [ID peristiwa Navixy Generic Protocol](https://www.navixy.com/docs/iot-logic-api/technologies/navixy-generic-protocol/navixy-generic-protocol-10/predefined-event-identifiers)

### Konfigurasi Navixy Web Service

#### Penyiapan

Untuk menyiapkan penerusan data dalam protokol Navixy Web Service:

1. Buka **Perangkat dan pengaturan** dari bilah sisi kiri.
2. Pilih perangkat yang diperlukan dari **Objek** daftar.
3. Temukan **Penerusan data** blok, perluas, lalu klik <img src="/files/9a1e643a868d5204e9ed2387f1aa7abe402f5872" alt="" data-size="line">.
4. Di jendela yang terbuka, klik "+" untuk menambahkan retranslasi baru.
5. Di dialog **Protokol retranslasi baru** masukkan informasi yang diperlukan. Untuk protokol Navixy Web Service, isi bidang berikut:

<table><thead><tr><th width="187.8182373046875">Parameter</th><th>Penjelasan</th></tr></thead><tbody><tr><td>Nama</td><td>Label deskriptif untuk mengidentifikasi konfigurasi protokol retranslasi ini. Masukkan nama agar retranslator ini mudah dikenali.</td></tr><tr><td>Protokol dan Login</td><td>Protokol komunikasi yang digunakan untuk retranslasi. Pilih <strong>Navixy Web Service</strong> dari menu tarik-turun.</td></tr><tr><td>Alamat</td><td>URL atau alamat IP server tujuan.<br><strong>Catatan</strong>: Tidak digunakan oleh Navixy Web Service, masukkan format alamat yang valid apa pun.</td></tr><tr><td><strong>Port</strong></td><td>Port jaringan untuk menyambungkan ke server tujuan.<br><strong>Catatan</strong>: Tidak digunakan oleh Navixy Web Service, masukkan nomor port apa pun.</td></tr><tr><td>Login</td><td>Pengidentifikasi unik untuk koneksi retranslator ini. Masukkan login apa pun yang belum digunakan oleh retranslator lain di sistem Anda.</td></tr><tr><td>Kata sandi</td><td>Kode sandi autentikasi untuk koneksi retranslator ini. Masukkan kata sandi unik untuk mengamankan konfigurasi retranslator ini.</td></tr></tbody></table>

6. Aktifkan **Enabled** saklar untuk mengaktifkan retranslasi data. Retranslator tidak akan mengirimkan data apa pun saat dinonaktifkan.
7. The **Pengelolaan retranslasi** layar harus terlihat serupa seperti berikut, dengan login dan kata sandi Navixy Web Service. Pastikan statusnya **Aktif** jika Anda ingin retranslasi ini mengirim data.\
   ![](/files/f3d50db8ae5116b493efe4741c725d6a5d0b8c9b)
8. Selanjutnya, retranslator perlu dihubungkan ke perangkat. Untuk melakukannya, aktifkan toggle dengan nama retranslator yang diperlukan di **Penerusan data** blok. External ID tidak diperlukan untuk protokol Navixy Web Service.\
   ![](/files/699cd330a25e7ed4f64ce105925872f609b9a52f)

{% hint style="success" %}
Anda berhasil membuat dan mengaktifkan protokol retranslasi baru untuk perangkat ini. Sekarang retranslator tersedia untuk semua perangkat di akun, Anda dapat mengaktifkannya dengan mengubah toggle di pengaturan perangkat lain.
{% endhint %}

#### Akses eksternal:

Parameter yang diperlukan:

* **Login dan kata sandi**: Ini harus cocok dengan kredensial yang Anda atur dalam konfigurasi retranslator
* **deviceIDs**: Maks. 100
* **startDate** dan **endDate**: Misalnya, 9 September 2022 00:00 UTC hingga 23:59:59
  * UTC: 2022-09-01T00:00:00Z hingga 2022-09-01T11:59:59Z

Deskripsi protokol dalam WSDL dapat ditemukan di bawah ini, terkait lokasi server:

EU <https://soap.navixy.com/LocationDataService?wsdl>

US <https://soap.us.navixy.com/LocationDataService?wsdl>

Permintaan SOAP harus dibuat dengan memanfaatkan salah satu halaman WSDL di atas. Permintaan XML-nya adalah sebagai berikut, diganti dengan informasi yang sesuai:

{% code overflow="wrap" %}

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org">

   <soapenv:Header>
   <tem:authentication>
     <login>username</login>
     <password>password</password>
   </tem:authentication>
   </soapenv:Header>
   <soapenv:Body>
   <tem:dataRequest>
      <!--1 hingga 100 pengulangan:-->
      <deviceIds>IMEI of device</deviceIds>
      <startDate>2022-08-30T00:00:00Z</startDate>
      <endDate>2022-08-31T00:00:00Z</endDate>
   </tem:dataRequest>
   </soapenv:Body>
</soapenv:Envelope>
```

{% endcode %}

Contoh respons dapat terlihat seperti ini:

```xml
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns:getLocationDataResponse xmlns:ns="http://tempuri.org">
            <result>
                <dateGps>2019-10-15T08:48:50.000Z</dateGps>
                <ignition>false</ignition>
                <latitude>75.9270866</latitude>
                <longitude>-85.5207616</longitude>
                <speedGps>0.0</speedGps>
                <unitPlate>JRT1550</unitPlate>
                <altitude>284.0</altitude>
                <course>N</course>
                <deviceId>866258048802349</deviceId>
                <numSat>15</numSat>
                <odometer>59845</odometer>
                <eventId>401</eventId>
            </result>
        </ns:getLocationDataResponse>
    </S:Body>
</S:Envelope>
```

#### Pengelolaan

Untuk mengedit atau menghentikan penerusan data, ikuti langkah-langkah berikut:

1. Pada bagian mana pun **Penerusan data** blok, klik <img src="/files/dc61ee46701a800fc32dd397e1806057df2775dc" alt="" data-size="line"> untuk membuka daftar protokol yang tersedia.
2. Klik <img src="/files/6d89a0d2ccde23083b8fdbeb01b158e2752f6472" alt="" data-size="line"> untuk mengubah pengaturan retranslator seperti nama, informasi login, atau status aktif.
3. Klik <img src="/files/09235a9127602e6b5fa76459c7cf33f1e8ff2ef4" alt="" data-size="line"> dan konfirmasikan untuk menghapus retranslator

Semua perubahan disimpan secara otomatis.

{% hint style="info" %}
Untuk mengaktifkan/menonaktifkan retranslator untuk perangkat tertentu, alihkan toggle dengan nama retranslator yang diperlukan di **Penerusan data** .
{% endhint %}

#### Pemecahan masalah

Untuk memverifikasi dan menguji permintaan SOAP Anda ke platform, disarankan menggunakan SoapUI yang dapat ditemukan di sini: <https://www.soapui.org/downloads/soapui/>

1. Instal Soap UI
2. Dari menu file, pilih “New SOAP Project”
3. Tempelkan path yang benar ke bidang WSDL sesuai dengan server dan pilih **Create sample requests for all operations?**
4. US: <https://soap.us.navixy.com/LocationDataService?wsdl>
5. EU: <https://soap.navixy.com/LocationDataService?wsdl>


---

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