Geografische Position
Melden der geografischen Position eines Geräts
Diese Methode ermöglicht die Aktualisierung der aktuellen Position des Geräts auf der Plattform. Der Positionsverlauf wird nicht gespeichert.
Die HTTP-Gerätepositionsaktualisierung verwendet die folgende Struktur:
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
}Parameter
| Name | Description | Data Type |
|---|---|---|
| accessToken | Access token with permissions to update endpoint information. See this page for more information. | text |
| deviceID | Unique device identifier or device address in format [deviceAddress] (e.g.: [device-1234]). These values can be found on the device management page. | number |
| latitude | Indicates the latitude of the device's current location. | number |
| longitude | Indicates the longitude of the device's current location. | number |
Beispiel
Wir wählen ein zu änderndes Gerät aus; in diesem Fall wählen wir eines mit dem Namen "Interwave Tracker Test 1". Der benötigte Parameter ist die "DeviceID" des Geräts, die in diesem Fall "23712" lautet.
Öffnen Sie Postman und verwenden Sie die Methode "UpdateDeviceGeolocation", geben Sie das accessToken, die DeviceId (die in diesem Fall 23712 ist) ein und senden Sie dann den Längen- und Breitengrad des Geräts. Sobald die Daten geladen sind, drücken Sie "Send" und das Gerät wird seine Position ändern.
_fac2.png&w=3840&q=75&dpl=dpl_Cujn5e4HF3uUcBpsiVcAymmwNeb3)
Diese Positionsänderung kann auf der Gerätekarte angezeigt werden.
Batterie- und RSSI-Status
Melden Sie den RSSI-Status und/oder den Batteriestand eines Geräts. Diese Methode speichert keinen Verlauf des Status; sie übernimmt nur den zuletzt gemeldeten Wert und zeigt ihn auf der Plattform an.
Empfang und Bestätigung von Befehlen
Grundlegender Ablauf der Befehlsintegration Das Gateway, Gerät oder der Endpunkt muss auf Befehle warten, indem die entsprechende Methode ausgeführt wird. Hierfür wird ein Long-Polling-Mechanismus verwendet.