Ubicación GPS

Muchos Devices o Variables se encuentran en una posición GPS determinada. Puede ser muy útil establecer una ubicación GPS fija para un Device.

Un caso en el que los datos de localización son útiles es, por ejemplo, los dispositivos en movimiento (imagina un camión o un barco). De ahí que pueda ser necesario enviar datos de localización en cada data-point.

Hay 3 formas diferentes de enviar datos de localización a Netux | Cloud:

• Manual
• Automático
• Especificado

Configurando ubicación GPS manualmente

En este caso, la latitud y la longitud se publican en el atributo properties en el cuerpo cuando se crea un Device o se Actualiza un Device. Este es el valor por defecto de cada dispositivo.

Para añadir la ubicación manualmente añade el siguiente objeto al cuerpo del Device:

"properties": { "location_type": "manual", "_location_fixed": { "lat": 6.2486, "lng": 75.5742 } }

//POST a Device with its exact GPS coordinates

curl -X POST 'https://api.netux.com/api/v2.0/devices/' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -d '{
    "label": "truck-1-device",
    "name": "Truck 1 Device",
    "description": "Moving Truck",
    "isActive": true,
    "properties": {
        "location_type": "manual",
        "_location_fixed": { 
            "lat": 6.2486, 
            "lng": 75.5742 
        } 
    }
}'

Configurando ubicación GPS automáticamente (configuración por defecto)

Cuando la ubicación del Device está configurada como automática, se buscará la primera Variable que tenga un label que coincida con una de las tres opciones:

• position
• gps
• location

Para establecer la ubicación automáticamente, añade el siguiente objeto al cuerpo del Device:

"properties": { "_location_type":"auto" }

🚧

Por favor evita

Por favor, evita tener dos o más variables con los nombres permitidos (position, gps, location) ya que podría crear inconsistencias.

//POST a Device with automatic GPS location

curl -X POST 'https://api.netux.com/api/v2.0/devices/' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -d '{
    "label": "truck-1-device",
    "name": "Truck 1 Device",
    "description": "Moving Truck",
    "isActive": true,
    "properties": { 
        "_location_type":"auto"
    }
}'

Configurando la ubicación GPS especificada

Otra opción para establecer la ubicación GPS de un Device es establecerla como especificada, esto añadiendo lo siguiente al objeto properties de un Device:

"properties": { "_location_type":"specified", "_location_variable": <variable-label> }

La <variable_label> es la Variable que contiene la ubicación GPS, ten en cuenta que va sin ~.

Así, la key isLocationVariable se pone automáticamente en true dentro del objeto properties de la Variable correspondiente.

Usar el modo especificado te permite utilizar cualquier nombre para tu Variable.

//POST a Device with specific GPS location

curl -X POST 'https://api.netux.com/api/v2.0/devices/' \
 -H 'Content-Type: application/json' \
 -H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
 -d '{
    "label": "truck-1-device",
    "name": "Truck 1 Device",
    "description": "Moving Truck",
    "isActive": true,
    "properties": { 
        "_location_type":"specified",
        "_location_variable":<variable-label>
    }
}'