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

{
    "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
    }
}

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

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

{
    "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.

Last updated 5 months ago

{ "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 } }