Navixy Web Service

El protocolo de reenvío de datos del servicio web de Navixy transmite datos de flotas desde el sistema de Navixy a cualquier sistema de terceros.

Categoría del Protocolo: Protocolo de consolidación de datos 

Tabla de contenidos

1. ¿Qué es el servicio web de Navixy?
2. Información técnica sobre el servicio web de Navixy
3. Configuración del servicio web de Navixy
   1. Configuración
   2. Gestión
   3. Resolución de problemas

¿Qué es el servicio web de Navixy?

El protocolo de reenvío de datos del servicio web de Navixy es flexible, lo que permite a terceros almacenar datos de flotas en sus bases de datos para usarlos con cualquier propósito o para mostrar datos en recursos web.

Dado que este protocolo de reenvío de datos es independiente de la plataforma, sería la opción ideal para cualquier socio que trabaje con archivos XML.

Información técnica general del servicio web de Navixy

El protocolo del servicio web de Navixy utiliza SOAP para permitir la extracción de datos XML desde dispositivos de rastreo como parte de la capa de aplicación OSI. Los datos se extraen bajo demanda.

Campos de datos que se envían:

• DateGPS
  • Fecha y hora en UTC
• Ignition
  • Estado de encendido booleano
• Latitud
• Longitud
• SpeedGPS
  • km/h
• UnitPlate
  • Matrícula
• Altitude
  • Metros
• Course
  • Dirección en la que se dirige el vehículo, por ejemplo: N, S, E, O, NO, NE, SO, SE
• DeviceID
  • IMEI
• NumSat
  • Número de satélites GNSS que el dispositivo está utilizando
• Odometer
  • Distancia recorrida en km

Configuración del servicio web de Navixy

Configuración

Una pantalla de gestión de retransmisión debería verse similar a la siguiente, con el usuario y contraseña del servicio web de Navixy. Asegúrese de que el botón "Habilitado" esté marcado y haga clic en el botón "Guardar" para completar el proceso.

A continuación, será necesario vincular el retransmisor al dispositivo. Para hacerlo, seleccione el botón “Vincular” en el widget de reenvío de datos.

Seleccione el retransmisor que se conectará y haga clic en “Vincular” a continuación.

Seleccione el retransmisor que se conectará y haga clic en “Vincular”.

No se necesita ID externo para el protocolo del servicio web de Navixy.

Seleccione “Guardar” una vez completado.

Acceso externo:

Parámetros requeridos

• Usuario y contraseña
  • Esto debe coincidir con lo que se ingresó anteriormente
• deviceIDs
  • Máximo de 100
• startDate y endDate
  • El siguiente es un ejemplo para el 9 de septiembre de 2022 a las 12 am UTC hasta las 11:59:59 UTC:
  • 2022-09-01T00:00:00Z a 2022-09-01T11:59:59Z

La descripción del protocolo en WSDL se puede encontrar a continuación, según la ubicación del servidor:

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

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

Se debe realizar una solicitud SOAP utilizando una de las páginas WSDL anteriores. La solicitud XML en sí es la siguiente, reemplazada con la información asociada:

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

Una respuesta de ejemplo puede verse algo así:

      <result>

         <dateGps>2022-08-30T00:02:55.000Z</dateGps>

         <ignition>false</ignition>

         <latitude>75.9270866</latitude>

         <longitude>-85.5207616</longitude>

         <speedGps>0.0</speedGps>

         <unitPlate>ss3ssj</unitPlate>

         <altitude>284.0</altitude>

         <course>E</course>

         <deviceId>866258048802349</deviceId>

         <numSat>15</numSat>

         <odometer>59845</odometer>

      </result>

Gestión

Para editar o detener el reenvío de datos, consulte los siguientes pasos:

Para detener el reenvío de datos, haga clic en el botón “Papelera”.

A continuación, confirme el cambio en la ventana emergente.

Para cambiar la configuración del retransmisor, como el nombre, la información de inicio de sesión o habilitado, haga clic en “Gestión de retransmisores.”

Esto abrirá la ventana de gestión de retransmisores. Seleccione la fila para editar y haga clic en el lápiz en la parte superior izquierda, o haga doble clic en la fila en cuestión para permitir la edición. Guarde los cambios realizados.

Resolución de problemas

Para verificar y probar su solicitud SOAP a la plataforma, se sugiere usar SoapUI que se puede encontrar aquí: https://www.soapui.org/downloads/soapui/

1. Instale Soap UI
2. Desde el menú archivo, seleccione “Nuevo Proyecto SOAP”
3. Pegue la ruta correcta en el campo WSDL según el servidor y seleccione “¿Crear solicitudes de muestra para todas las operaciones?”
   1. US: https://soap.us.navixy.com/LocationDataService?wsdl
   2. EU: https://soap.navixy.com/LocationDataService?wsdl