利用設定

[17] この装置は、 SORACOM の SIM と組合せて使う IoT 端末です。 つまりこの装置に SIM を指すと、 SORACOM サーバーにデータを送信するようになるので、 SORACOM のサービスを介してそのデータを取得する形になります。

[24] このドキュメントの手順通りに簡単に設定できます。 このドキュメントではデータを SORACOM Harvest に送信することになっています。 SORACOM Harvest に送信すると、 SORACOM の Webサイト上で直近のデータを地図表示できます。 ちょっとした動作確認や、 簡単な利用ならこれでも十分でしょう。 (ただし有料なので注意。)

[26] SORACOM Harvest のデータは Web API 「DataEntry」 で取得できます。

[27] ただし DataEntry API は SIM 1つずつしかデータを取得できません。 複数端末を併用するときには不便です。 またポーリングが必要となり定期的に送信される GPS データの取得には不向きです。

[28] SORACOM Beam に送信するように設定すると、 新データが到着するたびに自サーバーに HTTPS で送信させることができます。 つまり GPS データを受信できる Web Hook API と考えることができます。 (ただし有料なので注意。)

[29] この設定方法として SIM ごとの設定から Beam を有効にできるような説明を見かけますが、 SORACOM の仕様変更前の古い説明のようですので、注意してください。 SIM ごとではなく、 SIM グループごとに Beam への送信を設定できます。

[30] Beam の設定は、 送信先サーバーと URL path や HTTPヘッダーを指定するだけなので、 みればわかります。プロトコルとして 「HTTP」が使えるという罠に注意です。 正しくは UDP から HTTP に変換するオプションを選ばなければなりません。 (端末から SORACOM サーバーまで UDP で送信し、 SORACOM サーバーから自サーバーまで HTTP で送信するという意味です。)

[31] SIM ごとではなく SIM グループごとの設定となっているので、 新規端末・ SIM を追加したときは、 同じグループにどんどん追加していくだけで、 既存の送信先設定を流用できます。

測位データ

[12] Base64 符号化された JSON データが送られてきます。 >>11

[14] 残念なことに測定日時が入っていません。受信日時が測定日時に十分近いと仮定するほかありません。

[15] GPS データは緯度と経度が入っています。 高度や時刻はありません。

[16] たまに緯度経度取得に失敗したのか、 null が送られてくることがあります。