Integrar Dispositivos de Rastreo a Persat

Si lo que necesita es integrar su flota actual de vehículos a Persat, y ya cuenta con dispositivos de rastreo propios o brindados por un tercero, entonces este es el lugar indicado.

Mediante el siguiente endpoint podrá enviar datos GPS para cada uno de sus dispositivos y luego visualizar los mismos en los mapas de Persat.

Persat cuenta con una variedad de Partners de Rastreo autorizados. Consulte previamente los partners de Rastreo actuales para evitar tener que realizar esta integración por su cuenta.

IMPORTANTE

Si la integración la realiza un tercero, es imperativo no compartir la API key con acceso TOTAL, sino que se debe compartir la Api Key con "Acceso restringido a insertar datos de Rastreo únicamente". Ver Niveles de Acceso y Consideraciones Importantes

Endpoint para enviar datos GPS

Para enviar un dato GPS para un dispositivo en Persat, se debe enviar una consulta POST como la que se especifica a continuación.

POST https://api.persat.com.ar/v1/devices-geoposition/device_id

Path Parameters

Name	Type	Description
device_id*	Number	Identificador del device. Se puede obtener la lista de Devices desde Listar Dispositivos

Headers

Name	Type	Description
Authorization*	String	Bearer API_KEY
Content-Type*	String	application/json

Request Body

Objeto Json con los siguientes fields

Name	Type	Description
date*	String	Fecha y hora, en formato yyyy-MM-ddTHH:mm:ss.SSSZ, indicando el momento en que se obtiene la posición GPS del vehículo.
lat*	number	Número entre -90 y +90, representando la latitud
lng*	number	Número entre -180 y + 180, representando la longitud
relative_odometer	number	Número [Opcional] representando el odómetro del vehiculo. En realidad no es el valor real del odometro, si no un valor de referencia que va aumentando con cada movimiento del vehiculo. Está representado en metros. La ventaja de utilizar este valor es que se puede hacer uso del módulo de Mantenimiento Preventivo

Ejemplo de body request

{
    "date": "2024-06-06T13:35:21.000Z",
    "lat": -25.23123,
    "lng": 120.000023,
    "relative_odometer": 0
}

Posbibles Respuestas

200: OK La consulta se ejecutó con éxito

{
    "success": true,
    "data": {}
}

400: Bad Request schema_id no es un número

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'lng' invalido. Debe ser un number"
    }
}

404: Not Found No existe este tipo de formulario

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe un device con este id"
    }
}

IMPORTANTE:

Persat realiza procesamiento digital de los datos GPS recibidos para evitar fluctuaciones rápidas o fallas de intermitencia. Es decir que es posible que, sobre todo para el caso en que se esten realizando pruebas, algunos de los valores enviados no aparezcan en el mapa.

Se debe simular un recorrido "real" de un vehículo. Por ejemplo: no se debería enviar dos puntos GPS con 1 segundo de diferencia a 1 km de distancia, dado que no hay vehículo que cumpla con esos parámetros de velocidad.