cloud-to-cloud コネクタ
Tracking API は 、 SigFox デバイスクラウドへのcloud-to-cloud間接続をサポートしています。 この接続は、 SigFox クラウドから SigFox アカウントのデバイスのレポートを受信するcloud-to-cloudコネクタを作成することで形成され、 トラッキングバックエンドで仮想デバイスを自動的に作成して、 SigFox デバイスレポートを Tracking API への入力に変換します。 したがって、トラッキングバックエンドを使用して SigFox デバイスを追跡できます。
前提条件
ログイン
curl -X POST \
https://tracking.api.here.com/users/v2/login \
-H 'Content-Type: application/json' \
-d '{
"email": "{userEmail}",
"password": "{userPassword}"
}'
HERE アカウントaccessToken
が返されます。
SigFox Cloud-to-Cloud Connector を作成
利用可能なcloud-to-cloud のドライバーを取得
curl -X GET \
https://tracking.api.here.com/c2c/v4/drivers \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json'
これにより、利用可能なcloud-to-cloudのドライバーの配列が返されます。 SigFox Cloud のドライバーに provider
sigfox
はとがあり driverId
DRV-bf8642c2-f163-40f9-863c-b2ea85d6378c
ます。
cloud-to-cloud コネクターを作成します
cloud-to-cloudコネクタを作成するに は、 C2C エンドポイントにPOST
要求を送信します。 複数のプロジェクトのメンバーの場合 projectId
は、クエリ パラメーター でプロジェクト ID を指定してください。
externalCloudInfo
リクエスト本文のオブジェクトには、追跡する SigFox デバイスの SigFox API アクセス資格情報およびデバイスタイプ ID が含まれている必要があります。 これらは、 SigFox アカウントのログイン資格情報ではなく、 API が SigFox デバイスグループの資格情報にアクセスすることに注意してください。
curl -X POST \
https://tracking.api.here.com/c2c/v4/connectors?projectId=`projectId` \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Name for C2C connector",
"description": "Description for C2C connector",
"externalCloudInfo": {
"login": "sigfoxApiAccessLogin",
"password": "sigfoxApiAccessPassword",
"deviceType": "sigfoxDeviceTypeId"
},
"driverId": "DRV-bf8642c2-f163-40f9-863c-b2ea85d6378c",
"refreshIntervalS": 600,
"enabled": true
}'
作成されたコネクタは、refreshIntervalS
秒ごとに定期的に実行されます。これは、デバイスレポートが処理される間隔です。
cloud-to-cloud コネクターのリストを取得
curl -X GET \
https://tracking.api.here.com/c2c/v4/connectors?projectId=`projectId` \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json'
これにより、プロジェクト用に作成されたcloud-to-cloudコネクターの配列が返されます。 複数のプロジェクトのメンバーの場合 projectId
は、クエリ パラメーター でプロジェクト ID を指定してください。
クラウド内の外部デバイスデータを表示
外部デバイスのリストを取得
curl -X GET \
https://tracking.api.here.com/c2c/v4/connectors/{connectorId}/ext-devices \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json'
コネクタに登録されている外部デバイスの配列が返されます。 応答の中のexternalDeviceId
は外部クラウドのデバイス ID であり 、トラッキング API でデバイスを識別するときに、プロジェクトappId
と一緒に仮想デバイスexternalId
として使用されます。
外部デバイスのシャドウとトレースは 、物理デバイスと同じ方法で照会できます。
外部デバイスのシャドウを取得
curl -X GET \
'https://tracking.api.here.com/shadows/v2/{externalDeviceId}?appId=`appId`' \
-H 'Authorization: Bearer {accessToken}' \
-H 'content-type: application/json'
これにより、外部デバイスの最新のreported
とdesired
シャドウが返されます。
外部デバイスのトレースを取得
curl -X GET \
'https://tracking.api.here.com/traces/v2/{externalDeviceId}?appId=`appId`' \
-H 'Authorization: Bearer {accessToken}' \
-H 'content-type: application/json'
外部デバイスのトレースが返されます。
cloud-to-cloud コネクターを削除
cloud-to-cloudコネクタを削除しても、Tracking バックエンドから外部デバイスは削除されません。
curl -X DELETE \
https://tracking.api.here.com/c2c/v4/connectors/{connectorId} \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json'