Saltar al contenido principal
CloudStudio

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

NombreDescripciónTipo de datos
accessTokenToken de acceso con permisos para actualizar información del endpoint. Vea esta página para más información.text
deviceIDIdentificador ú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
latitudeIndica la latitud de la ubicación actual del dispositivo.number
longitudeIndica 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”

Lista de dispositivos con un rastreador desplegado mostrando su DeviceID y sus endpoints

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.

Petición POST en Postman al método UpdateDeviceGeolocation con token, DeviceId y coordenadas

Dicho cambio en la posición se podrá visualizar en el mapa de dispositivos.

Mapa de dispositivos con la nueva posición del rastreador resaltado en la lista lateral

Última actualización

En esta página