Manage trace output streams

Tracking service publishes traces to the stream layer in the HERE platform catalog.

Traces are published to tc-traces layer within the catalog.

Messages sent to the stream are in JSON format and contain following properties:

  • type: <string>, Type of the message, identifies the used data format. The only supported value is traces.
  • version: <string>, Data format version. The only supported value is 1.0.
  • traces: <array>, Array of traces objects.
  • correlationId: <uuid>, ID used for tracing requests. Used for logging and error reporting.

The following is an example of a traces message:

{
  "type": "traces",
  "version": "1.0",
  "traces": [
    {
      "timestamp": 1451425708216,
      "position": {
        "lat": "52.4988217",
        "lng": "13.35170005",
        "alt": "86",
        "accuracy": "25",
      },
      "system": {
        "reportedSensorData": {
          "pressureHpa": 994.416,
          "batteryLevel": 100,
          "temperatureC": 24.46,
          "relativeHumidity": 31.37
        }
      },
      "payload": {},
      "serverTimestamp": 1451425710434
    }
  ],
  "correlationId": "06d4f6ef-b323-43f1-b1ca-e5f15df546c7",
  "trackingId": "HERE-626daaf1-cd80-4165-8785-1718cf76bd07"
}

To learn how to enable and receive traces, see Receive traces from output stream.

Traces schema

For specification of traces stream messages, refer to the Traces schema.


Did this page help you?