Obtener estadísticas de Rastreo

Mediante este endpoint, se puede obtener los datos derivados del rastro GPS para un dispositivo determinado.

Los dispositivos se pueden ver en los endpoints de Dispositivos

IMPORTANTE:

Debido a que la generación del recorrido, requiere de una gran demanda de computo. Los recorridos son generados y procesdados automáticamente por la madrugada. Siendo el resultado obtenido, los datos del día anterior.

Por lo que si quiero obtener los datos de rastreo de "hoy", el resultado va a ser nulo. La consulta debe hacerse a día vencido.

GET https://api.persat.com.ar/v1/devices-pathtrack-sumary/YYYY-MM-dd/device_id

Path Parameters

Name	Type	Description
device_id*	Number	Identificador del dispositivo
YYYY-MM-dd*	Date	Fecha en la que quiero obtener los datos

Headers

Name	Type	Description
Authorization*	String	Bearer API_KEY

200: OK La consulta se ejecutó con éxito

{
    "success": true,
    "data": {
        "device_id": 3,
        "date": "2014-04-15T00:00:00.000Z",
        "distance_inside_wa": 68.3,
        "distance_outside_wa": 21.15,
        "time_inside_wa": 38368000,
        "time_outside_wa": 49242000
    }
}

404: Not Found No se encontro el dispositivo

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

400: Bad Request device_id no es un número

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'device_id' debe ser un número entero"
    }
}

400: Bad Request Error en la fecha

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'localdate' debe estar definido en formato YYYY-MM-DD"
    }
}

Analizando la Respuesta

{
    "success": true,
    "data": {
        "device_id": 3,
        "date": "2014-04-15T00:00:00.000Z",
        "distance_inside_wa": 68.3,
        "distance_outside_wa": 21.15,
        "time_inside_wa": 38368000,
        "time_outside_wa": 49242000
    }
}

device_id: Identificador del Dispositivo.

date: Fecha de la consulta.

Si bien la fecha esta representada en UTC, hay que considerarla en horario local. Entonces para el caso del ejemplo, y sin importar si soy un cliente de Argentina, Ecuardor o Mexico, la fecha mostrada representa el día 15 de Abril de 2014 hora de mi país

"timestamp": "2014-04-15T00:00:00.000Z",

distance_inside_wa: "Distance inside Working Area". Recorrido realizado en KM dentro de la zona de trabajo asignada.

distance_outside_wa: "Distance outside Working Area". Recorrido realizado en KM fuera de la zona de trabajo asignada.

time_inside_wa: "Time inside Working Area". Tiempo en ms (milisegundos) dentro de la zona de trabajo asignada.

time_outside_wa: "Time outside Working Area". Tiempo en ms (milisegundos) fuera de la zona de trabajo asignada.

La suma de time_inside_wa y time_outside_wa no necesariamente dará 24 horas. Puesto que, en el caso que el dispositivo sea un celular, el mismo solo enviará datos dentro de la jornada laboral configurada.