デバイスがHERE Tracking APIにデータを取り込み、保存できるようにするには、まずエンドユーザーがデバイスを登録する必要があります。未登録のデバイスはAPIと通信できません。 HERE Tracking APIでは、デバイスを登録したエンドユーザーをデバイス所有者と呼びます。 デバイス所有者はデバイスを制御し、そのデバイスが取り込んだデータにアクセスできます。

デバイスをプロジェクトに登録する

仮想デバイスをユーザープロジェクトに登録するには、まだ登録されていないプロビジョニング済みの仮想デバイスが必要です。 詳細については、「デバイスを登録する」を参照してください。

curl -X PUT \
  https://{tcHost}/registry/v2/devices/{externalId}?appId=`appId` \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'
{
  "trackingId": "VRTR-11111111-2222-3333-4444-555555555555555"
}  

📘

注

リクエストURLで指定するexternalIdは、事前にプロビジョニングした仮想デバイスのIDです (例：my-first-device)。仮想デバイスの登録に必要なのはexternalIdとappIdのみで、deviceIdは必要ありません。

新たに作成されたtrackingIdが返されます。これはトラッキングバックエンドのデバイスデータに関連付けられている一意の識別子です。

デバイスがユーザーのデバイスリストに含まれていることを確認する

詳細については、「プロジェクトで登録したすべてのデバイスを取得する」を参照してください。 ユーザーが複数のプロジェクトのメンバーである場合は、クエリパラメーターprojectIdでターゲットプロジェクトIDを指定する必要があります。

curl -X GET \
  https://{tcHost}/users/v2/devices?projectId=`projectId` \
  -H 'Authorization: Bearer {accessToken}'

projectIdによって特定されたユーザープロジェクトで登録したすべてのデバイスが一覧表示されます。

次のステップ

これでHERE Tracking APIにデータを送信する手順に進むことができます。