Traffic API 開発者ガイド(交通情報)

タイル

このリソースは、特定の地理的領域の交通情報を反映するマップタイルのリクエストを処理します。 応答によって、マップ タイルがビットマップとして配信されます。

非推奨のお知らせ

HERE は、トラフィックタイルのサービス方法を変更しました。 Traffic API ではライブトラフィックタイルが廃止 され、マップ タイル API インフラストラクチャによって提供されるようになりました。 ライブトラフィックタイルのドキュメントは 、マップ タイル API のドキュメントの一部です。

これは、 Traffic API によって引き続き処理されるトラフィックパターンタイルには影響しません。

一般的な使用例のパラメータの組み合わせ

表 1. トラフィックパターンタイルを要求します
必須です オプションです
  • quadkey ( quadkey アドレスでのみ使用)
  • pattern_time
  • nc ( 内容がありません )
  • profile
  • tables
  • res ( quadkey アドレスのみ)
  • depth ( quadkey アドレスのみ)
表 2. Traffic タイルの色深度を設定します
必須です オプションです
  • エンドポイントの変更 ([Z]/[X]/[Y] アドレスでのみ使用 ) :
    .../{zoom}/{column}/{row}/{size}/{format}?
  • quadkey ( quadkey アドレスでのみ使用)
  • depth ( quadkey アドレスでのみ使用)
  • nc
  • profile
  • tables
  • pattern_time
  • res ( quadkey アドレスのみ)
表 3. トラフィックタイルのサイズを設定します
必須です オプションです
  • エンドポイントの変更 ([Z]/[X]/[Y] アドレスでのみ使用 ) :
    .../{zoom}/{column}/{row}/{size}/{format}?
  • quadkey ( quadkey アドレスでのみ使用)
  • res ( quadkey アドレスでのみ使用)
  • depth ( quadkey アドレスのみ)
  • nc
  • profile
  • pattern_time
  • tables
表 4. タイル表示を TMC テーブルでフィルタリングします
必須です オプションです
  • quadkey ( quadkey アドレスでのみ使用)
  • tables
  • depth ( quadkey アドレスのみ)
  • nc
  • profile
  • pattern_time
  • res ( quadkey アドレスのみ)

リソースパラメーター

表 5. タイルリクエストのパラメータ
パラメーター 説明
app_id

xs:string

クライアント アプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。

app_id すべて app_code のリクエストに AND を含める必要があります。  認証の詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。

app_code

xs:string

クライアント アプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。

app_id すべて app_code のリクエストに AND を含める必要があります。 認証の詳細について は、『 Identity & Access Management 開発者ガイド』を参照してください。

apiKey

xs:string

A 43-byte Base64 URL-safe encoded string used for the authentication of the client application. As a logged in user, you can generate it at https://here-tech.skawa.fun/projects. API Keys never expire but you can invalidate your API Keys at any time. You cannot have more than two API Keys for one app at the same time.

apiKey すべてのリクエストにを含める必要があります。 認証の詳細については、『 Identity & Access Management 開発者ガイド』を参照してください。

depth

xs:string

タイルの色深度のインジケータ。 使用できる値は次のとおりです。

  • 8bit
  • 32bit

quadkey タイルアドレッシングでのみ使用されます。

nc

xs:int

未割り当てのトラフィックタイルについて、レスポンスが HTTP エラーコード 204 (空)を返すかどうかを示すフラグ ()1

使用できる値は次のとおりです。

  • 1
  • 0
pattern_time

xs:int

トラフィックパターンタイルを取得する時間(週単位)のインジケータ。 この値は、日曜日の午前 0 時から開始する、ターゲット領域のローカル時間を秒単位で表します。 許容値は数値で、 0 ~ 604800 の範囲内である必要があります。

profile

xs:string

プロファイルでは、地理的カバレッジ (TMC テーブルを使用可能 ) やタイルオーバーレイのカスタムカラーマッピングなどの属性を定義します。

quadkey

QuadkeyType

地球全体に及ぶタイルのグリッド内のマップ タイルの識別子。 quadkey は、 0 ~ 21 桁の 1 つの数値文字列です。 quadkey が参照するグリッドのマップズーム レベルは、 quadkey 文字列の桁数と同じです。 quadkey アドレッシング方式のエンドポイントでのみ使用します。 Quadkeys も参照してください。

res

xs:string

quadkey タイルアドレスでのみ使用されるマップ タイル解決のインジケータ。 レンダリングされた正方形のマップ タイルのサイズをピクセル単位で指定します。 使用できる値は次のとおりです。

  • bitmap128
  • bitmap256
  • bitmap512
tables

TMCCodeType

プロファイル内の TMC テーブルを指定して、応答に含めるか、または応答から除外するかを指定するパラメータ。 値に複数のテーブルが指定されている場合、テーブル ID はカンマで区切ります。 正の値が含まれ、負の値は除外されます。
注 : 正の値と負の値の組み合わせはサポートされていません。その結果、エラー応答が発生します。
デフォルトでは ( パラメータがリクエストで使用されていない場合 ) 、応答にはプロファイル内のすべてのテーブルが含まれます。 利用可能なテーブルの一覧については、 TMCCodeType の TMC テーブルまたは顧客プロファイルの一覧を参照してください。

タイル応答パラメータ

Traffic タイル要求が成功すると、 PNG オーバーレイイメージと、イメージに関する追加情報を含む次の項目が返されます。

表 6. 交通状況の応答
属性 必須です 説明
ステータスコード はい サーバー応答ステータスコード。 200 OK です
キャッシュ制御 はい max-age 値は、タイルをクライアントキャッシュに保存できる期間(秒単位)を定義します。 パブリック、最大年齢 = 39
期限が切れます はい このタイルの有効期限が切れた日時。 クライアントキャッシュは、有効期限が切れた後でタイルを要求する必要があります。 火曜日、 7 月 27 日 14 時 59 分( GMT
コンテンツタイプ はい 応答のコンテンツタイプ。 リクエストに応じて、 PNG 画像またはプレーンテキストを指定できます。 image/png
コンテンツ - 長さ はい 応答のサイズ。 7989
日付 はい タイルが作成された日時。 火曜日、 7 月 27 日 14:56:18 GMT
X-LastUpdateFromTrafficAdapter はい このタイル情報が最後に更新された日時。 2015 年 10 月 29 日 14:49:32 UTC
X-served-by いいえ リクエストを処理したインスタンス / サーバーの識別子。 I-4864c4f0.eu-west -1b