タイル
このリソースは、特定の地理的領域の交通情報を反映するマップタイルのリクエストを処理します。 応答によって、マップ タイルがビットマップとして配信されます。
非推奨のお知らせ |
---|
HERE は、トラフィックタイルのサービス方法を変更しました。 Traffic API ではライブトラフィックタイルが廃止 され、マップ タイル API インフラストラクチャによって提供されるようになりました。 ライブトラフィックタイルのドキュメントは 、マップ タイル API のドキュメントの一部です。 これは、 Traffic API によって引き続き処理されるトラフィックパターンタイルには影響しません。 |
一般的な使用例のパラメータの組み合わせ
必須です | オプションです |
---|---|
|
|
必須です | オプションです |
---|---|
|
|
必須です | オプションです |
---|---|
|
|
必須です | オプションです |
---|---|
|
|
リソースパラメーター
パラメーター | 説明 |
---|---|
app_id | クライアント アプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。 |
app_code | クライアント アプリケーションの認証に使用される 20 バイトの Base64 URL セーフエンコード文字列。 |
apiKey | 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. |
depth | タイルの色深度のインジケータ。 使用できる値は次のとおりです。
quadkey タイルアドレッシングでのみ使用されます。 |
nc | 未割り当てのトラフィックタイルについて、レスポンスが HTTP エラーコード 204 (空)を返すかどうかを示すフラグ () 使用できる値は次のとおりです。
|
pattern_time | トラフィックパターンタイルを取得する時間(週単位)のインジケータ。 この値は、日曜日の午前 0 時から開始する、ターゲット領域のローカル時間を秒単位で表します。 許容値は数値で、 0 ~ 604800 の範囲内である必要があります。 |
profile | プロファイルでは、地理的カバレッジ (TMC テーブルを使用可能 ) やタイルオーバーレイのカスタムカラーマッピングなどの属性を定義します。 |
quadkey | 地球全体に及ぶタイルのグリッド内のマップ タイルの識別子。 quadkey は、 0 ~ 21 桁の 1 つの数値文字列です。 quadkey が参照するグリッドのマップズーム レベルは、 quadkey 文字列の桁数と同じです。 quadkey アドレッシング方式のエンドポイントでのみ使用します。 Quadkeys も参照してください。 |
res | quadkey タイルアドレスでのみ使用されるマップ タイル解決のインジケータ。 レンダリングされた正方形のマップ タイルのサイズをピクセル単位で指定します。 使用できる値は次のとおりです。
|
tables | プロファイル内の TMC テーブルを指定して、応答に含めるか、または応答から除外するかを指定するパラメータ。 値に複数のテーブルが指定されている場合、テーブル ID はカンマで区切ります。 正の値が含まれ、負の値は除外されます。 注 : 正の値と負の値の組み合わせはサポートされていません。その結果、エラー応答が発生します。 デフォルトでは ( パラメータがリクエストで使用されていない場合 ) 、応答にはプロファイル内のすべてのテーブルが含まれます。 利用可能なテーブルの一覧については、 TMCCodeType の TMC テーブルまたは顧客プロファイルの一覧を参照してください。 |
タイル応答パラメータ
Traffic タイル要求が成功すると、 PNG オーバーレイイメージと、イメージに関する追加情報を含む次の項目が返されます。
属性 | 必須です | 説明 | 例 |
---|---|---|---|
ステータスコード | はい | サーバー応答ステータスコード。 | 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 |