Layanan Web Navixy

Endpoint SOAP untuk meminta data pelacakan untuk periode tertentu

Kategori Protokol: Protokol konsolidasi data

Daftar isi

1. Apa itu Navixy Web Service?

2. Informasi teknis tentang Navixy Web Service

3. Konfigurasi Navixy Web Service

4. Pengaturan

5. Mengelola

6. Pemecahan masalah

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 berbagai tujuan atau menampilkan data di sumber daya web.

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

Informasi teknis umum Navixy Web Service

Protokol Navixy Web Service memanfaatkan SOAP untuk memungkinkan pengambilan data XML dari perangkat pelacak sebagai bagian dari lapisan aplikasi OSI. Data diambil berdasarkan permintaan.

Bidang data yang dikirim:

• dateGPS: Tanggal dan waktu dalam UTC

• ignition: Status pengapian 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 event sesuai dengan Navixy Generic Protocol's event ID

Konfigurasi Navixy Web Service

Pengaturan

Untuk mengatur penerusan data dalam protokol Navixy Web Service:

1. Buka Devices and settings dari bilah sisi kiri.

2. Pilih perangkat yang diperlukan dari Objects daftar.

3. Temukan Data forwarding portlet, kembangkan dan klik .

4. Di jendela yang terbuka, klik "+" untuk menambahkan retranslator baru.

5. Dalam New retranslation protocol dialog, masukkan informasi yang diperlukan. Untuk protokol Navixy Web Service, isi bidang berikut:

Parameter	Penjelasan
Nama	Label deskriptif untuk mengidentifikasi konfigurasi protokol retranslator ini. Masukkan nama agar retranslator ini mudah dikenali.
Protocol and Login	Protokol komunikasi yang digunakan untuk retranslation. Pilih Navixy Web Service dari menu dropdown.
Address	URL atau alamat IP server tujuan. Note: Tidak digunakan oleh Navixy Web Service, masukkan format alamat yang valid apa pun.
Port	Port jaringan untuk menghubungkan ke server tujuan. Note: Tidak digunakan oleh Navixy Web Service, masukkan nomor port apa pun.
Login	Pengidentifikasi unik untuk koneksi retranslator ini. Masukkan login apa pun yang belum digunakan oleh retranslator lain di sistem Anda.
Password	Kode autentikasi untuk koneksi retranslator ini. Masukkan kata sandi unik untuk mengamankan konfigurasi retranslator ini.

1. Aktifkan Enabled sakelar untuk mengaktifkan retranslation data. Retranslator tidak akan mengirimkan data saat dinonaktifkan.

2. The Retranslation management layar harus terlihat serupa dengan berikut ini, dengan login dan kata sandi Navixy Web Service. Pastikan statusnya Active jika Anda ingin retranslator ini mengirimkan data.

3. Selanjutnya, retranslator perlu ditautkan ke perangkat. Untuk melakukannya, aktifkan sakelar dengan nama retranslator yang diperlukan di Data forwarding portlet. External ID tidak diperlukan untuk protokol Navixy Web Service.

Anda telah berhasil membuat dan mengaktifkan protokol retranslation baru untuk perangkat ini. Sekarang retranslator tersedia untuk semua perangkat di akun, Anda dapat mengaktifkannya dengan mengalihkan sakelar di pengaturan perangkat lain.

Akses eksternal:

Parameter yang diperlukan:

• Login and password: Ini harus sesuai dengan kredensial yang Anda atur dalam konfigurasi retranslator

• deviceIDs: Maksimum 100

• startDate dan endDate: Misalnya, 9 September 2022 12am UTC hingga 11:59:59

  • UTC: 2022-09-01T00:00:00Z hingga 2022-09-01T11:59:59Z

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

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

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

Sebuah permintaan SOAP harus dibuat menggunakan salah satu halaman WSDL di atas. Permintaan XML itu sendiri adalah sebagai berikut, diganti dengan informasi terkait:

<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>IMEI of device</deviceIds>
      <startDate>2022-08-30T00:00:00Z</startDate>
      <endDate>2022-08-31T00:00:00Z</endDate>
   </tem:dataRequest>
   </soapenv:Body>
</soapenv:Envelope>

Contoh respons mungkin terlihat seperti ini:

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

Mengelola

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

1. Di mana pun Data forwarding portlet, klik untuk membuka daftar protokol yang tersedia.

2. Klik untuk mengubah pengaturan retranslator seperti nama, informasi login, atau status diaktifkan.

3. Klik dan konfirmasi untuk menghapus sebuah retranslator

Semua perubahan disimpan secara otomatis.

Untuk mengaktifkan/menonaktifkan retranslator untuk perangkat tertentu, alihkan sakelar dengan nama retranslator yang diperlukan di Data forwarding portlet perangkat.

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. Tempel jalur yang benar ke dalam bidang WSDL sesuai 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