Layanan Web Navixy

Biarkan sistem pihak ketiga meminta data GPS historis dari Navixy melalui SOAP, dengan permintaan hingga 100 perangkat dan data satu hari per panggilan.

Navixy Web Service menyediakan endpoint SOAP kepada sistem pihak ketiga yang digunakannya untuk meminta data pelacakan. Ini adalah opsi yang dipilih ketika sistem penerima lebih suka menarik data sesuai jadwalnya sendiri, atau ketika sistem tersebut tidak dapat menerima koneksi masuk.

Navixy Web Service bekerja berbeda dari setiap protokol lain di Penerusan data blok. Yang lain mengirim setiap pesan ke tujuan saat pesan itu tiba. Navixy Web Service tidak mengirim apa pun: Navixy menyediakan sebuah endpoint, dan sistem penerima meminta data yang diinginkannya.

Hal ini memiliki dua konsekuensi. Navixy tidak pernah terhubung ke sistem penerima, sehingga Alamat dan Port kolom-kolom tersebut tidak digunakan. Dan karena sistem penerima membaca data tersimpan, bukan aliran langsung, kueri dapat mencakup periode lampau, yang tidak didukung oleh protokol lain.

Karena datanya berupa XML melalui SOAP dan tidak melibatkan format khusus Navixy, protokol ini cocok untuk mitra apa pun yang dapat menggunakan WSDL.

Di Navixy, pilih Layanan Web Navixy di Protokol menu tarik-turun.

Apa yang dikembalikan endpoint

Endpoint mengembalikan satu catatan per posisi tersimpan, dengan bidang-bidang berikut:

Bidang	Isi
deviceId	ID perangkat sebagaimana diberikan dalam permintaan
dateGps	Saat perangkat merekam posisi, dalam UTC
latitude dan longitude	Posisi dalam derajat
ketinggian	Ketinggian dalam meter
speedGps	Kecepatan dalam kilometer per jam
haluan	Arah kompas, seperti N, SE, atau B
pengapian	Apakah pengapian menyala
numSat	Jumlah satelit yang digunakan perangkat
odometer	Pembacaan odometer yang dilaporkan oleh perangkat, dalam kilometer
unitPlate	Nomor registrasi kendaraan yang ditautkan ke perangkat
eventId	Kode peristiwa, mengikuti pengidentifikasi peristiwa Navixy Generic Protocol

Dua bidang bergantung pada data di luar perangkat. unitPlate kosong ketika perangkat tidak ditautkan ke kendaraan, dan Navixy memendekkan nomor registrasi dengan menghapus spasi dan tanda hubung serta mempertahankan enam karakter pertama. Perangkat yang tidak diizinkan untuk terhubung tidak mengembalikan catatan sama sekali, melainkan kesalahan.

Batas permintaan

Setiap permintaan harus tetap dalam batas ini, atau endpoint akan mengembalikan fault:

• Maksimal 100 ID perangkat per permintaan.

• Maksimal satu hari antara tanggal mulai dan tanggal akhir. Rentang yang sedikit lebih panjang masih ditoleransi, tetapi permintaan yang mencakup beberapa hari gagal dengan Interval terlalu panjang.

Untuk mengumpulkan periode yang lebih panjang, kirim satu permintaan per hari.

Sebelum Anda mulai

Tidak seperti protokol lainnya, Anda tidak memerlukan apa pun dari pihak ketiga. Anda memilih login dan kata sandi, dan sistem penerima menggunakannya untuk autentikasi.

Pilih login yang belum digunakan oleh retranslator lain di akun Anda, karena Navixy mengidentifikasi retranslator melalui pasangan login dan kata sandi.

Siapkan endpoint

1

Buka blok Penerusan data

Buka Perangkat dan pengaturan, pilih perangkat, lalu temukan blok Penerusan data blok.

2

Buka daftar protokol

Klik Protokol, lalu klik + untuk menambahkan konfigurasi.

3

Masukkan pengaturan Navixy Web Service

Isi kolom sebagai berikut:

• Nama: label yang mengidentifikasi retranslator ini

• Protokol: Layanan Web Navixy

• Alamat: alamat valid apa pun. Protokol ini tidak menggunakannya, tetapi kolom ini wajib diisi.

• Port: nomor port apa pun. Protokol ini juga tidak menggunakannya.

• Nama pengguna: login pilihan Anda, yang belum digunakan oleh retranslator lain

• Kata sandi: kata sandi pilihan Anda

Berikan login dan kata sandi kepada pihak yang akan meminta data dari endpoint.

4

Aktifkan dan simpan

Nyalakan Diaktifkan, lalu klik Simpan.

5

Tautkan retranslator ke perangkat Anda

Di setiap perangkat Penerusan data aktifkan sakelar untuk retranslator yang Anda buat, lalu klik Simpan. Hanya perangkat yang ditautkan yang mengembalikan data. External ID tidak digunakan oleh protokol ini.

Kueri endpoint

Alamat WSDL bergantung pada platform yang menjadi host akun Anda:

Platform	WSDL
EU	https://soap.navixy.com/LocationDataService?wsdl
US	https://soap.us.navixy.com/LocationDataService?wsdl

Kirim permintaan dalam format ini, dengan login dan kata sandi di header SOAP serta ID perangkat dan rentang tanggal di badan. ID perangkat adalah nilai IMEI perangkat:

<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 to 100 repetitions:-->
         <deviceIds>866258048802349</deviceIds>
         <startDate>2022-08-30T00:00:00Z</startDate>
         <endDate>2022-08-31T00:00:00Z</endDate>
      </tem:dataRequest>
   </soapenv:Body>
</soapenv:Envelope>

Respons berisi satu hasil elemen per posisi yang tersimpan:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns:getLocationDataResponse xmlns:ns="http://tempuri.org">
            <hasil>
                <tanggalGps>2019-10-15T08:48:50.000Z</tanggalGps>
                <Pengapian>false</Pengapian>
                <lintang>75.9270866</lintang>
                <bujur>-85.5207616</bujur>
                <kecepatanGps>0.0</kecepatanGps>
                <pelatUnit>JRT1550</pelatUnit>
                <ketinggian>284.0</ketinggian>
                <arah>N</arah>
                <idPerangkat>866258048802349</idPerangkat>
                <numSat>15</numSat>
                <odometer>59845</odometer>
                <eventId>401</eventId>
            </result>
        </ns:getLocationDataResponse>
    </S:Body>
</S:Envelope>

Kelola endpoint

Untuk mengubah atau mencabut akses:

• Nonaktifkan toggle pada Penerusan data blokir untuk mengecualikan perangkat tersebut dari hasil kueri, dan biarkan yang lain tetap tersedia.

• Klik Protokol, pilih barisnya, lalu sunting untuk mengubah login atau kata sandi. Kueri yang menggunakan kredensial lama akan langsung berhenti berfungsi, jadi beri tahu pihak yang melakukan kueri sebelum Anda mengubahnya.

• Hapus konfigurasi dari Protokol daftar untuk mencabut akses sepenuhnya. Konfirmasikan di dialog.

Pemecahan masalah

Saat kueri tidak mengembalikan data, periksa hal berikut secara berurutan:

1. Retranslator diaktifkan, dan toggle-nya dinyalakan untuk perangkat yang Anda kueri.

2. Login dan kata sandi di header SOAP cocok dengan konfigurasi retranslator.

3. ID perangkat dalam permintaan adalah nilai IMEI perangkat di akun Anda.

4. Rentang tanggal mencakup periode ketika perangkat tersebut mengirimkan laporan.

5. Rentang tanggal tidak melebihi satu hari, dan permintaan mencantumkan tidak lebih dari 100 ID perangkat.

Untuk menguji permintaan sebelum menulis kode integrasi, gunakan SoapUI:

1. Instal SoapUI.

2. Dari Berkas menu, pilih New SOAP Project.

3. Tempelkan alamat WSDL untuk platform Anda ke dalam WSDL bidang.

4. Pilih Buat permintaan contoh untuk semua operasi, lalu isi kredensial dan ID perangkat.