# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.api.persat.com.ar/modulos/rastreo-satelital/obtener-estadisticas-de-rastreo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.