Ubicación geográfica
Reportar la ubicación geográfica de un dispositivo
Este método permite actualizar la ubicación actual del dispositivo en la plataforma. No se almacena un histórico de la ubicación.
La actualización de la ubicación del dispositivo por HTTP lleva la siguiente estructura:
POST /services/gear/DeviceIntegrationService.svc/UpdateDeviceGeolocation HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json
{
"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"deviceID": 1,
"latitude": 40.4052,
"longitude": -3.87699
}Parámetros
| Nombre | Descripción | Tipo de datos |
|---|---|---|
| accessToken | Token de acceso con permisos para actualizar información del endpoint. Vea esta página para más información. | text |
| deviceID | Identificador único del dispositivo o dirección del dispositivo con formato [deviceAddress] (Ej: [device-1234]). Estos valores pueden verse en la página de administración de dispositivos. | number |
| latitude | Indica la latitud de la ubicación actual del dispositivo. | number |
| longitude | Indica la longitud de la ubicación actual del dispositivo. | number |
Ejemplo
Elegimos un dispositivo para modificar, en este caso elegimos uno con el nombre “Interwave Tracker Test 1" el parámetro que debemos tomar es el "DeviceID" del dispositivo, en este caso es el “23712”
Abrimos el postman y usamos el método "UpdateDeviceGeolocation", indicamos el accesToken, el DeviceId que en este caso es el 23712 y luego enviamos la longitud y latitud de dicho dispositivo. Una vez que carguemos los datos presionar “ Send ” y el dispositivo cambiara de posición.
_fac2.png&w=1920&q=75&dpl=dpl_87LH5cJ2L3jjsAK3mA5aYAZuUopg)
Dicho cambio en la posición se podrá visualizar en el mapa de dispositivos.
Última actualización
Estado de batería y RSSI
Cómo informar por la API HTTP el nivel de batería y el RSSI de un dispositivo. La plataforma guarda solo el último valor, sin historial.
Recepción y confirmación de comandos
Cómo recibe comandos un dispositivo por HTTP con long polling y cómo confirma a la plataforma que los ejecutó, paso a paso.