PricingLog inGet startedAsk Navixy AI

Navixy Web Service

Endpoint SOAP para solicitar datos de seguimiento de un período especificado

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

Tabla de contenidos

  1. ¿Qué es Navixy Web Service?

  2. Información técnica sobre Navixy Web Service

  3. Configuración de Navixy Web Service

  4. Configuración

  5. Administración

  6. Resolución de problemas

¿Qué es Navixy Web Service?

Navixy Web Service el protocolo de reenvío de datos transmite datos de la flota desde el sistema Navixy a cualquier sistema de terceros. El protocolo es flexible, permitiendo que terceros almacenen los datos de la flota en sus bases de datos para usarlos con cualquier propósito o para mostrar los 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 de Navixy Web Service

El protocolo Navixy Web Service utiliza SOAP para permitir la extracción de datos XML desde los dispositivos de seguimiento como parte de la capa de aplicación del modelo OSI. Los datos se extraen bajo demanda.

Campos de datos que se envían:

  • dateGPS: Fecha y hora en UTC

  • ignition: Estado de ignición booleano

  • latitude

  • longitude

  • speedGPS: km/h

  • unitPlate: Matrícula

  • altitude: Metros

  • course: Dirección del vehículo, por ejemplo: N,S,E,O,NO,NE,SO,SE

  • deviceId: IMEI

  • numSat: Número de satélites GNSS que utiliza el dispositivo

  • odometer: Distancia recorrida en km

  • eventId: el código de evento según Navixy Generic Protocol's event ID

Configuración de Navixy Web Service

Configuración

Para configurar el reenvío de datos en el protocolo Navixy Web Service:

  1. Vaya a Dispositivos y ajustes desde la barra lateral izquierda.

  2. Seleccione el dispositivo necesario de la Objects lista.

  3. Busque el Data forwarding portlet, expándalo y haga clic .

  4. En la ventana abierta, haga clic en "+" para agregar una nueva retransmisión.

  5. En el New retranslation protocol diálogo, introduzca la información requerida. Para el protocolo Navixy Web Service, rellene los siguientes campos:

Parámetro
Explicación

Nombre

Una etiqueta descriptiva para identificar esta configuración del protocolo de retransmisión. Introduzca un nombre para que este retransmisor sea fácilmente identificable.

Protocolo y Login

El protocolo de comunicación utilizado para la retransmisión. Seleccione Navixy Web Service del menú desplegable.

Dirección

La URL o dirección IP del servidor de destino. Nota: No es utilizada por Navixy Web Service, introduzca cualquier formato de dirección válido.

Puerto

El puerto de red para conectar con el servidor de destino. Nota: No es utilizado por Navixy Web Service, introduzca cualquier número de puerto.

Login

Un identificador único para esta conexión de retransmisor. Introduzca cualquier login que no esté ya en uso por otro retransmisor en su sistema.

Password

Código de autenticación para esta conexión del retransmisor. Introduzca una contraseña única para asegurar esta configuración de retransmisor.

  1. Active el Enabled interruptor para activar la retransmisión de datos. El retransmisor no transmitirá ningún dato mientras esté desactivado.

  2. La Retranslation management pantalla debería verse similar a la siguiente, con el login y la contraseña de Navixy Web Service. Asegúrese de que el estado esté Active si desea que este retransmisor envíe datos.

  3. A continuación, será necesario vincular el retransmisor al dispositivo. Para hacerlo, active el interruptor con el nombre del retransmisor necesario en el Data forwarding portlet. El ID externo no es necesario para el protocolo Navixy Web Service.

Ha creado y activado correctamente un nuevo protocolo de retransmisión para este dispositivo. Ahora el retransmisor está disponible para todos los dispositivos de la cuenta; puede activarlo cambiando el interruptor en la configuración de otros dispositivos.

Acceso externo:

Parámetros requeridos:

  • Login y contraseña: Estos deben coincidir con las credenciales que configuró en la configuración del retransmisor

  • deviceIDs: Máx. de 100

  • startDate y endDate: Por ejemplo, 9 de septiembre de 2022 00:00 UTC a 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, relativa a dónde se encuentra el 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 propia solicitud XML 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 así:

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

Administración

Para editar o detener el reenvío de datos, siga estos pasos:

  1. En cualquier Data forwarding portlet, haga clic para abrir la lista de protocolos disponibles.

  2. Haga clic para cambiar la configuración del retransmisor, como nombre, información de inicio de sesión o estado habilitado.

  3. Haga clic y confirme para eliminar un retransmisor

Todos los cambios se guardan automáticamente.

Para habilitar/deshabilitar un retransmisor para cierto dispositivo, active el interruptor con el nombre del retransmisor necesario en el Data forwarding portlet.

Resolución de problemas

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

  1. Instalar Soap UI

  2. Desde el menú Archivo, seleccione “New SOAP Project”

  3. Pegue la ruta correcta en el campo WSDL según el servidor y seleccione ¿Crear solicitudes de ejemplo para todas las operaciones?

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

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

AnteriorILSPSiguienteRecurso Confiable

Última actualización

¿Te fue útil?