# Seguimiento GPS de activos estacionarios con etiquetas BLE

Cualquier objeto puede integrarse en el Internet de las Cosas. La plataforma permite rastrear no solo objetos móviles, sino también estacionarios, como maquinaria pesada, equipos agrícolas, carga, mercancías o equipos de seguridad. Instalar dispositivos GPS en cada uno de estos objetos puede ser muy costoso. En su lugar, resulta más rentable instalar un dispositivo en un vehículo o en una instalación y rastrear todos los demás con etiquetas BLE más económicas.

En este tutorial, explicaremos cómo organizar el rastreo de objetos estacionarios, qué dispositivos GPS y etiquetas ayudarán a recopilar los datos necesarios y cómo configurarlos usando remolques de camión como ejemplo. También cubriremos cómo obtener información sobre viajes y uso para trabajos de servicio posteriores y qué llamadas de API proporcionarán información sobre las etiquetas. Además, compartiremos otros casos de uso basados en situaciones reales.

## Lo que necesita para rastrear objetos estacionarios

Varios dispositivos pueden leer datos de balizas BLE: Galileosky, Quecklink, Ruptela, Teltonika, TopFlyTech\*.\* Describiremos el ejemplo de [Teltonika FMB920](https://www.navixy.com/devices/teltonika/teltonika-fmb920/) modelo y la baliza BLE [Eye Sensor](https://teltonika-gps.com/products/accessories/sensors-beacons/eye).\
Para comenzar a rastrear objetos estacionarios, necesitará lo siguiente:

1. Un dispositivo GPS que pueda leer etiquetas BLE y sea compatible con la plataforma.
2. Etiquetas BLE que sean compatibles con el dispositivo GPS.\
   Cabe señalar que muchas etiquetas BLE pueden transmitir información sobre temperatura y humedad, así como su nivel de batería. Esto amplía la capacidad de estas etiquetas para rastrear información, pero para nuestro propósito nos centraremos específicamente en objetos estacionarios.
3. APIs de la plataforma que proporcionen información sobre qué dispositivo GPS está cerca de una etiqueta determinada. Para crear soluciones personalizadas para sus usuarios mediante APIs, necesitará desarrolladores. Por lo general, los clientes contratan a sus propios desarrolladores o a equipos externos.

Ahora examinemos el procedimiento para implementar un caso real: el rastreo de remolques de camión para obtener información sobre viajes y uso, y para trabajos de servicio posteriores.

## Cómo configurar su dispositivo

Siga estos pasos para configurar su dispositivo para enviar datos de balizas BLE a la plataforma:

1. Descargue [Teltonika Configurator](https://wiki.teltonika-gps.com/view/Teltonika_Configurator_versions). Esta aplicación simplifica muchos ajustes a la vez. Puede guardar el preajuste y usarlo en FOTA Web para configurar otros dispositivos, lo que hace que el proceso sea más conveniente.
2. En la pestaña System, establezca el Data Protocol en Codec 8 Extended. Esto permite que el dispositivo funcione con etiquetas BLE.\
   ![How to configure your device](/files/38e51bf4d6ebb32c69046b567fcaa2fc29abb1f7)
3. Active Bluetooth en la configuración de Bluetooth y elija "Enable (hidden)" o "Enable (visible)". De lo contrario, Bluetooth estará desactivado.\
   ![How to configure your device](/files/98d9f96dbafad357abe12aa5d5c58413749dd429)
4. En la configuración de Bluetooth 4.0, desactive Non-Stop Scan y configure Update Frequency y Scan Duration en 30 segundos. Estos ajustes optimizan el escaneo BLE con el dispositivo.
5. En la configuración de Bluetooth 4.0 Advanced Mode Settings, cargue el preajuste EYE Sensor de acuerdo con la configuración de paquetes en la app EYE.
6. Configure la dirección MAC del sensor.

El dispositivo ya está listo para transmitir datos de las etiquetas cercanas a la plataforma.

## Cómo obtener información sobre balizas BLE cerca del dispositivo GPS

En el lado de la plataforma, existe un objeto de entrada de datos de baliza BLE:

```json
{
  "tracker_id": 10181654,
  "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
  "rssi": -101,
  "get_time": "2023-04-17 17:14:42",
  "latitude": 50.3487321,
  "longitude": 7.58238,
  "ext_data": {
    "voltage": 3.075,
    "temperature": 24.0
  }
}
```

Puede leer información de él:

* `tracker_id` - int. Un ID del rastreador (también conocido como "object\_id").
* `hardware_id` - string. Un ID de la baliza.
* `rssi` - int. RSSI significa indicador de intensidad de señal recibida y representa la potencia de la señal recibida en un dispositivo. Con base en ello, puede entender qué tan lejos está la baliza del rastreador.
* `get_time` - [fecha/hora](https://www.navixy.com/docs/navixy-api/user-api/backend-api#data-types). Cuando se recibió este dato.
* `latitude` - float. Latitud.
* `longitude` - float. Longitud.
* `ext_data` - object. Datos adicionales de la baliza.

### Llamadas de API para obtener información sobre etiquetas BLE

Hay dos llamadas de API que le permiten obtener toda la información necesaria sobre balizas BLE:

1. La primera llamada recupera [datos históricos de los dispositivos](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/beacon/index#read). Puede establecer los parámetros "from" y "to" para obtener datos durante un período específico sobre las balizas BLE conectadas. Como necesitamos la información desde el punto de vista de las etiquetas BLE, es decir, de los remolques, solicitemos la información usando el parámetro "beacons".\
   Ejemplo de solicitud:

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.navixy.com/v2/beacon/data/read' \
    -H 'Content-Type: application/json' \
    -d '{"hash":"59be129c1855e34ea9eb272b1e26ef1d","from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00","beacons": ["7cf9501df3d6924e423cabcde4c924ff"]}'
```

{% endcode %}

Esto mostrará qué dispositivos estuvieron en las proximidades de esta baliza BLE durante el período.

Respuesta:

```json
{
  "list": [
    {
      "tracker_id": 10181654,
      "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
      "rssi": -101,
      "get_time": "2023-04-17 17:05:42",
      "latitude": 50.3487321,
      "longitude": 7.58238,
      "ext_data": {
        "voltage": 3.075,
        "temperature": 24.0
      }
    },{//other objects per period
    },
    {
      "tracker_id": 10181654,
      "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
      "rssi": -101,
      "get_time": "2023-04-17 17:40:22", //a last point per period
      "latitude": 55.348890,
      "longitude": 6.59403,
      "ext_data": {
        "voltage": 3.075,
        "temperature": 24.0
  }
  ],
  "success": true
}
```

2\. La segunda llamada recupera información sobre [las balizas conectadas actualmente](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/beacon/index#last-values) a un dispositivo específico. Por ejemplo, si desea saber qué remolque está actualmente cerca del dispositivo, utilice la siguiente solicitud:

Ejemplo de solicitud:

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.navixy.com/v2/beacon/data/last_values' \
    -H 'Content-Type: application/json' \
    -d '{"hash":"59be129c1855e34ea9eb272b1e26ef1d", "trackers": [10181654], "skip_older_than_seconds": 1200}
```

{% endcode %}

Esto proporcionará información de que hay un remolque "7cf..." junto al dispositivo.

Respuesta:

```json
{
  "list": [
    {
      "tracker_id": 10181654,
      "hardware_id": "7cf9501df3d6924e423cabcde4c924ff",
      "rssi": -101,
      "get_time": "2023-04-17 17:40:22",
      "latitude": 55.348890,
      "longitude": 6.59403,
      "ext_data": {
        "voltage": 3.075,
        "temperature": 24.0
    }
  ],
  "success": true
}

```

## Cómo obtener información sobre tiempos de uso y detalles del viaje

Ya hemos recopilado datos históricos usando la primera de las llamadas de API presentadas, que mostró en qué dispositivos se visualizó el remolque en un momento específico. Para obtener información sobre los viajes y el tiempo de uso de este remolque, simplemente necesitamos usar una de las dos llamadas de API:

1. llamada a la API [track/list](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/track/index#list) para obtener información del viaje del período. Esto proporcionará información general sobre los viajes, como dónde y cuándo comenzaron y terminaron, la velocidad máxima, el kilometraje y más.\
   Solicitud:

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.navixy.com/v2/track/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "59be129c1855e34ea9eb272b1e26ef1d", "tracker_id": 10181654, "from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00", "split": true, "limit": 3000, "filter": true, "include_gsm_lbs": true}'
```

{% endcode %}

Respuesta:

```json
{
    "id": 11672,
    "start_date": "2023-04-17 17:05:42",
    "start_address": "10470, County Road, Town of Clarence, Erie County, New York, United States, 14031",
    "max_speed": 62,
    "end_date": "2023-04-17 17:40:22",
    "end_address": "Fast Teddy's, 221, Main Street, City of Tonawanda, New York, United States, 14150",
    "length": 18.91,
    "points": 59,
    "avg_speed": 49,
    "event_count": 3,
    "norm_fuel_consumed": 6.32,
    "type": "regular",
    "gsm_lbs": false
}
```

A partir de estos datos, podemos ver que el viaje duró casi 35 minutos (end\_date - start\_date), con una velocidad media de 49 km/h y una velocidad máxima de 62 km/h. La longitud del viaje fue de 18,91 km. Esta información nos permite determinar cuánto pagar al conductor por transportar la carga, si se superó la velocidad contractual y otros detalles. Además, la longitud del viaje puede utilizarse en el futuro para calcular el número de kilómetros hasta el siguiente mantenimiento del remolque. 2. Si desea un registro detallado de la trayectoria del remolque en el que está instalado la baliza para mostrarla en un informe, por ejemplo, puede usar la [track/read](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/track/index#read) solicitud. Esto nos dará datos sobre todos los puntos recibidos por la plataforma durante el viaje.\
Solicitud:

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.navixy.com/v2/track/read' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": 10181654, "from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00", "filter": true}'
```

{% endcode %}

Respuesta:

```json
{
    "success": true,
    "limit_exceeded": true,
    "list": [
        {
        "address": "10470, County Road, Town of Clarence, Erie County, New York, United States, 14031",
        "satellites": 10,
        "mileage": 0,
        "heading": 173,
        "speed": 42,
        "get_time": "2023-04-17 17:05:42",
        "alt": 0,
        "lat": 43.0318683,
        "lng": -78.5985733
        },
        {//other point objects per this trip
        }
    ]
}
```

Puede utilizar estos puntos junto con su API de mapas preferida para mostrarlos en un mapa.

## Otros ejemplos de uso de etiquetas BLE y la API de Navixy

Aquí tiene otros ejemplos de cómo usar etiquetas BLE con un breve algoritmo para obtener los resultados que necesita:

### Asientos para niños

Los asientos para niños son obligatorios para los pasajeros que viajan con niños. Si usted o el usuario opera un servicio de transporte de pasajeros, saber si un asiento para niños está disponible en un vehículo puede ayudarle a determinar rápidamente qué conductores son adecuados para determinados pasajeros y evitar perder tiempo y combustible. También puede averiguar qué conductor tiene actualmente instalado un asiento para niños en su vehículo. Además, es importante tener en cuenta a los pasajeros con dos o más niños e identificar los coches equipados con más de un asiento para niños.

Para solucionar esto, deberá instalar una baliza BLE en cada asiento para niños. A continuación, supongamos que su aplicación de reserva de transporte necesita solicitar información a todos los conductores que tengan instalado un asiento para niños. Para ello, utilice la llamada de API beacon/last\_values para recopilar información sobre qué conductores pueden asignarse a un pedido concreto.

También puede usar el parámetro RSSI para determinar si el asiento está situado dentro del vehículo o en el maletero. Para lograrlo, deberá realizar algunas pruebas. Por ejemplo, si el valor de RSSI es más bajo en el habitáculo que en el maletero, probablemente el asiento esté en el maletero. Como resultado, puede priorizar su búsqueda de vehículos: primero, los que tengan un asiento para niños en el habitáculo y luego los que tengan un asiento para niños en el maletero. Este enfoque garantiza que empareje de manera eficiente a los pasajeros con vehículos y conductores adecuados.

### Maquinaria agrícola

Suponga que su cliente tiene maquinaria agrícola que puede conectarse a varios equipos. ¿Cómo puede rastrear qué tractor está usando una sembradora y cuál tiene un arado? Esta información le ayudará a comprender la frecuencia y el alcance del uso de las herramientas, y también a determinar su ubicación actual. De este modo, los trabajadores pueden dedicar más tiempo a trabajar en el campo en lugar de buscar equipos. Para lograrlo, instale dispositivos en los tractores y cosechadoras, así como en las áreas de almacenamiento de herramientas. Coloque una baliza BLE en cada herramienta en un lugar seguro donde sea difícil retirarla, evitando que se pierda durante el trabajo. A continuación, para determinar cuánto tiempo han estado en uso las herramientas, consulte la `beacon/read` llamada de API. La información de la respuesta será útil, igual que con los remolques en nuestro ejemplo detallado. Para determinar la ubicación de una herramienta específica, consulte `beacon/last_values` con una búsqueda de balizas para identificar dónde y en qué dispositivo está instalada la herramienta. Este enfoque garantiza un rastreo y una utilización eficientes de su equipo agrícola, lo que en última instancia aumenta la productividad.

### Uso en obras de construcción

Las obras de construcción suelen contar con numerosas herramientas y equipos costosos. Aunque instalar una baliza con fines de rastreo es beneficioso, surge otra preocupación: ¿cómo puede asegurarse de que el equipo se rastree con frecuencia y de que el rastreador GPS no se quede sin energía? Para supervisar el uso y la ubicación del equipo, las balizas BLE también pueden resultar muy útiles.

La solución para las obras de construcción puede ser similar a la de la maquinaria agrícola: instale dispositivos en la maquinaria y también en los lugares de almacenamiento. Este enfoque le permite rastrear eficazmente su valioso equipo, asegurando que se utilice de forma eficiente y minimizando el riesgo de pérdida o extravío. Al vigilar de cerca sus herramientas y maquinaria, puede optimizar la productividad en la obra.

### Rastreo en interiores

Puede rastrear eficazmente elementos en interiores utilizando la plataforma y las etiquetas BLE. Todo lo que necesita hacer es instalar dispositivos GPS en diferentes partes del almacén o edificio y etiquetar los objetos que desea rastrear. Aquí tiene algunos ejemplos:

* **Rastreo de empleados en distintas áreas de un almacén o tienda**: Esto le permite saber en qué área se encuentra un empleado o cuántos asistentes de ventas están cerca del mostrador de información. Tener esta información ayuda a mejorar la eficiencia y garantiza que los miembros del personal estén donde deben estar.
* **Rastreo de mercancías o maquinaria en diferentes áreas del almacén**: Conocer la ubicación de las mercancías o los equipos ahorra tiempo, ya que no tiene que buscarlos por todo el almacén. Esto agiliza el proceso de localización, haciendo que sus operaciones sean más eficientes.

### Rastreo de mercancías con balizas BLE

Utilizar balizas BLE para el rastreo puede beneficiar enormemente a las empresas de transporte, ya que les permite determinar qué camión transporta un palé específico de mercancías en cualquier momento. Este método no solo permite rastrear las rutas de las mercancías, sino que también ayuda a calcular los costos de transporte con mayor precisión.

Al adoptar este enfoque innovador, las empresas de transporte pueden mejorar sus operaciones, haciéndolas más eficientes y precisas. En última instancia, esto se traduce en un mejor servicio para los clientes y en procesos empresariales más optimizados.


---

# 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://navixy.com/docs/expert-center/es/faq-and-troubleshooting/access-iot-data/gps-tracking-of-stationary-assets-with-ble-tags.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.
