SORACOM Users

GPS マルチユニット SORACOM Edition の位置情報をSORACOM Beam でサーバーに転送する

GPS マルチユニット SORACOM Edition の位置情報を SORACOM Beam でサーバーに転送する

このドキュメントでは GPS マルチユニット SORACOM Edition の位置情報を SORACOM Beam でサーバーに転送する方法について記載します。今回は動作確認のために転送先として HTTP リクエストを確認できる Web サービスであるPostBin を設定し、その様子を確認します。

当ガイドの前提は以下のとおりです。

GPS マルチユニット SORACOM Edition (以降、GPS マルチユニット) では Unified Endpoint にデータを送信します。 Unified Endpoint に対応する SORACOM Beam、SORACOM Funnel、SORACOM Funk、SORACOM Harvest Data のいずれかを設定することで、クラウドサービスと連携できます。

ステップ1: 転送先としてPostBin を構成する

PostBin は 30 分間有効な URL を発行し、その URL に送ったリクエストを確認できる Web サービスです。 https://postb.in/ にアクセスし、[Create Bin] ボタンをクリックしURLを発行します。

コマンド実行例に表示される https://postb.in/XXXXX をBeam の転送先として利用するので、XXXXX 部分の文字列をコピーし控えておきます。

ステップ2: ユーザーコンソールの GPS マルチユニットメニューから GPS マルチユニットを確認する

ユーザーコンソールの GPS マルチユニットメニューから登録した GPS マルチユニットを確認します。登録が済んでいない場合はこちらのステップ 2 までを完了してください。

ステップ3: SORACOM Beam を設定する

ユーザーコンソールの GPS マルチユニットメニューより、設定したい GPS マルチユニットを選択し、[グループ変更設定変更]をクリックします。なお所属するグループを変更したい場合はデバイス設定を一度削除し、再度新規デバイス設定として設定します。

[SORACOM Beam 設定] グループに設定を追加します。[ + ] - [UDP → HTTP/HTTPS エントリポイント] をクリックします。

[SORACOM Beam - UDP → HTTP/HTTPS 設定] ダイアログが開いたら、以下を入力し保存します。デバイス設定変更の場合と異なり、グループ設定変更においてはファンクションボタンの押下は不要です。

項目名 備考
ホスト名 postb.in
パス /XXXXX ステップ 1 でコピーした文字列をペーストします
IMSI ヘッダ ON 必須ではありませんが、転送先でどの GPS マルチユニットからの情報かを識別するために利用できます
ステータスコードを省略 ON GPS マルチユニットに関してはステータスコードは不要です

ステップ4: PostBin でデータのアップロードを確認する

ファンクションボタンを短押し (約 1 秒間) すると、定期送信の設定に関わらず、センサーデータ(電波強度・位置情報・加速度・温度・湿度・電池残量)を送信できます。 または、デバイス設定にて設定した GPS マルチユニットの送信間隔を合わせてデータが送信されるのを待ってください。 こちらのドキュメントで SORACOM Harvest Data へデータを送信するよう設定していれば、SORACOM Harvest Data を確認することでデータが送信されたか判別できます。

データが送信されたら Postbin の画面を再読み込みし、Beam によって転送されたリクエストを確認します。

x-soracom-imsi ヘッダには GPS マルチユニットに搭載された SIM の IMSI が確認でき、リクエストボディには送信されたデータの内容が Base64 エンコードされていることが確認できます。この Base64 エンコードされたデータをデコードすると JSON 形式のデータが確認できます。Base64 デコードにはこちらのサイトなどをお使いください。

デコードされた JSON の要素は以下の通りです。デバイス設定によって、送信されない要素もあります。

項目名 範囲 説明
lat -90 ~ 90 緯度
lon -180 ~ 180 経度
bat 1 ~ 3 電池ピクト(3段階)
rs -1 ~ 4 アンテナピクト (-1は圏外)
temp -20 ~ 60 温度
humi 0 ~ 100 湿度
x -8128 ~ 8128 加速度 X
y -8128 ~ 8128 加速度 Y
z -8128 ~ 8128 加速度 Z
type 0 or 1 0:定期送信 1:ボタン押下時の送信


以上で SORACOM GPS マルチユニット SORACOM Edition のデータを SORACOM Beam で転送し、リクエストデータが確認できました。

Getting Started

SORACOM Air for セルラー

SORACOM Air for LoRaWAN

SORACOM Air for Sigfox

SORACOM Beam

SORACOM Canal/Direct/Door

SORACOM Endorse

SORACOM Funnel

SORACOM Funk

SORACOM Gate

SORACOM Harvest

SORACOM Inventory

SORACOM Junction

SORACOM Krypton

SORACOM Lagoon

SORACOM Mosaic

SORACOM Napter

SORACOM LTE-M Button

GPS マルチユニット SORACOM Edition

IoT 体験キット

Device

サービス機能詳細

Developer Tools

Design Patterns

pagetop