GuidesAPI Reference
Guides

See data in the cloud

Your device is now reporting its data to the HERE Tracking API. The next step is accessing that reported data.

Retrieve device data from the HERE Tracking API

Prerequisites

  • The trackingId of a virtual device that has been claimed to a user project and has sent data to the HERE Tracking API

User login

Login the user into the HERE Tracking API and obtain an accessToken.

Retrieve the device shadow

Send a GET request to the shadows endpoint:

curl -X GET \
  'https://{tcHost}/shadows/v2/{trackingId}' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'content-type: application/json'

This will return the device's most recent reported and desired shadows.

Retrieve the device trace

Send a GET request to the traces endpoint. A number of traces to be retrieved can be specified in the optional query parameter count.

curl -X GET \
  'https://{tcHost}/traces/v2/{trackingId}?count=5' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'content-type: application/json'

This will return the device's trace.