ガイドAPIリファレンス
ガイド

トレース出力ストリームの管理

トラッキングサービスはHEREプラットフォームカタログストリームレイヤートレースを公開します。

トレースはカタログ内のtc-tracesレイヤーに公開されます。

ストリームに送信されるメッセージはJSON形式で、次のプロパティを含みます。

  • type: <string>、メッセージの型で、使用されるデータの形式を識別します。サポートされている値はtracesのみです。
  • version: <string>、データ形式のバージョン。サポートされている値は1.0のみです。
  • traces<array>、トレースオブジェクトの配列。
  • correlationId: <uuid>、リクエストのトレースに使用されるID。ログ記録およびエラーレポートで使用されます。

以下はトレースメッセージの例です。

{
  "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"
}

トレースを有効にして受信する方法については、「出力ストリームからトレースを受け取る」を参照してください。

トレーススキーマ

トレースストリームメッセージの仕様については、OpenAPIスキーマを参照してください。