地理位置
报告 the 地理位置 of a Device
This method allows updating the current location of the device on the platform. Location history is not stored.
The HTTP device location update使用以下结构:
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
}参数
| 名称 | 说明 | 数据类型 |
|---|---|---|
| accessToken | 具有更新端点信息权限的访问令牌。更多信息请参见该页面。 | text |
| deviceID | 唯一设备标识符或设备地址(格式为 [deviceAddress],例如:[device-1234])。这些值可以在设备管理页面找到。 | number |
| latitude | Indicates the latitude of the device's current location. | number |
| longitude | Indicates the longitude of the device's current location. | number |
示例
We choose a device to modify; in this case, we choose one named "Interwave Tracker Test 1". The parameter we need is the device's "DeviceID", which in this case is "23712".
Open Postman and use the "UpdateDeviceGeolocation" method, 输入 the accessToken, the DeviceId (which in this case is 23712), and then send the longitude and latitude of the device. Once the data is loaded, 按下 "Send" and the device will change position.
_fac2.png&w=3840&q=75&dpl=dpl_6cgp2Tn7zd4TRxPCQxXqwQWxbswN)
This position change can be viewed on the device map.
电池与 RSSI 状态
报告 the RSSI status and/or battery level of a device. This method does not store a history of the status; it only takes the last reported value and displays it on the platform.
命令 Reception and Confirmation
Basic command integration flow The gateway, device, or endpoint must be listening for commands by executing the corresponding method. A long polling mechanism is used for this purpose.