> For the complete documentation index, see [llms.txt](https://docs.api.persat.com.ar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.persat.com.ar/modulos/rastreo-satelital/obtener-estadisticas-de-rastreo.md).

# 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](/entidades-basicas/dispositivos.md)

{% hint style="info" %} <mark style="color:blue;">**IMPORTANTE:**</mark>

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.
{% endhint %}

<mark style="color:blue;">`GET`</mark> `https://api.persat.com.ar/v1/devices-pathtrack-sumary/YYYY-MM-dd/device_id`

#### Path Parameters

| Name                                         | Type   | Description                              |
| -------------------------------------------- | ------ | ---------------------------------------- |
| device\_id<mark style="color:red;">\*</mark> | Number | Identificador del dispositivo            |
| YYYY-MM-dd<mark style="color:red;">\*</mark> | Date   | Fecha en la que quiero obtener los datos |

#### Headers

| Name                                            | Type   | Description     |
| ----------------------------------------------- | ------ | --------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_KEY |

{% tabs %}
{% tab title="200: OK La consulta se ejecutó con éxito" %}

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

{% endtab %}

{% tab title="404: Not Found No se encontro el dispositivo" %}

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

{% endtab %}

{% tab title="400: Bad Request device\_id no es un número" %}

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

{% endtab %}

{% tab title="400: Bad Request Error en la fecha" %}

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

{% endtab %}
{% endtabs %}

### Analizando la Respuesta

```json
{
    "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.&#x20;

**date:** Fecha de la consulta.&#x20;

{% hint style="info" %}
Si bien la fecha esta representada en UTC, hay que considerarla en <mark style="color:blue;">**horario local**</mark>. 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",
```

{% endhint %}

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

{% hint style="warning" %}
La suma de <mark style="color:orange;">**time\_inside\_wa**</mark> y <mark style="color:orange;">**time\_outside\_wa**</mark> 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.
{% endhint %}