送信されるデータフォーマット
GPS マルチユニットから送信されるペイロードは、以下のプロパティおよび値を JSON 形式で準備したあとに Base64 形式でエンコードして生成しています。ただし、Harvest Data や Lagoon でデータを確認する場合や、Funnel や Funk を利用して転送する場合は、各サービスで自動的にデコードされるため、以下のプロパティおよび値をすぐに確認できます。
プロパティ | 説明 |
---|---|
lat | 緯度 (度)。-90 ~ 90 、null : 測位失敗 (*1) |
lon | 経度 (度)。-180 ~ 180 、null : 測位失敗 (*1) |
bat | 電池残量。-1 : 充電中、1 ~ 3 : 電池残量 |
rs | 電波強度。-1 : 圏外、0 ~ 4 : 電波強度 |
temp | 温度 (℃)。-20 ~ 60 |
humi | 湿度 (%)。0 ~ 100 |
x | 加速度 X (mG)。-8128 ~ 8128 |
y | 加速度 Y (mG)。-8128 ~ 8128 |
z | 加速度 Z (mG)。-8128 ~ 8128 |
type | 送信種別。0 : 定期送信または加速度割り込み送信、1 : 手動送信、-1 : デバイスで一時的な問題が発生 |
- (*1) 屋内など、場所によっては測位に失敗することがあります。場所の変更を検討してください。
送信されない場合や、null や異常値が送信される場合があります
- 動作モードによっては、一部のプロパティが送信されない場合があります。
- デバイスで一時的な問題が発生した場合 (
type
が-1
の場合) は、各プロパティでnull
や異常値が送信される場合があります。
精度などの動作保証範囲については、製品仕様 を参照してください。
mG は加速度の単位で G の 1000 分の 1 です。たとえば、水平面上にファンクションボタンを上部にして、GPS マルチユニットを静止させた場合は、下方向に重力加速度がかかるため z
が約 -1000
(mG) になります。
ペイロードのデコードについて
ペイロードのフォーマットは以下のとおりです。
{
"payload": "eyJsYXQiOjM1LjAsImxvbiI6MTM5LjAsImJhdCI6MywicnMiOjQsInRlbXAiOjE2LjAsImh1bWkiOjMyLjQsIngiOjAuMCwieSI6LTY0LjAsInoiOi05NjAuMCwidHlwZSI6MH0="
}
eyJs...
の部分は Base64 形式でエンコードされています。Beam でデータを転送する場合は、転送先でデコードしてください。デコードすると、以下の JSON 形式のデータが取得できます。
{
"lat": 35.0,
"lon": 139.0,
"bat": 3,
"rs": 4,
"temp": 16.0,
"humi": 32.4,
"x": 0.0,
"y": -64.0,
"z": -960.0,
"type": 0
}
- Harvest Data や Lagoon を使用してセンサーデータを確認する場合は、Harvest Data で自動的に Base64 形式でデコードされます。
- Funnel や Funk を使用してセンサーデータを転送する場合は、各サービスで自動的に Base64 形式でデコードされます。