Traffic API 開発者ガイド（交通情報）

リクエストパターンを選択しています

各要求は 、トラフィック 情報を取得する領域を定義するために要求が使用するリソース（サービス機能）およびアドレッシング方式（地理空間フィルタ）に適した形式に準拠する必要があります。

サポートされているアドレッシング方式は次のとおりです。

タイルアドレッシング方式 :
- [Z]/[X]/[Y] - マップズームレベルと、そのズームレベルに対応するタイルグリッド内のマップタイルの座標を指定します。詳細については、「メルカトル図法」を参照してください
- quadkey – マップタイルを特定するために単一の値を使用する [Z]/[X]/[Y] アドレス指定スキームの代わりに使用されます。「 Quadkeys 」も参照してください
エリアフィルタ :
- バウンディングボックス –情報をバウンディングボックスとして取得する領域を定義します ( パラメータを使用 bboxします。このパラメータの値は、領域の左上および右下の角の緯度および経度として指定されます。例 : ) bbox=52.516,13.355;52.511,13.400
- 近傍（ Proximity ） - 情報を円として取得する領域を定義します（パラメーターを使用 proxします。このパラメーターの値は、検索センターの半径（緯度）および半径（経度）、続いて検索領域の半径（メートル））です）。
- Corridor –指定したパスに沿って情報を取得する領域を定義 corridorします ( パスと幅のパラメーターを使用 ) 。経路は、一連の緯度と経度のペアで表される、回廊の中央に沿った線です。廊下の幅はメートル単位で指定されています ) 。

アドレッシング方式および使用可能なリソースについては、表 1を参照してください。

リソースとアドレッシング方式を決定したら、次のガイドラインに従って、適切な要求形式のパターンを選択します（ API リソースに応じて、名前がカッコで囲んで示されています）。

トラフィックフローデータ（フロー）

次のいずれかの要求パターンを使用して、アドレッシング方式を反映したトラフィックフローを取得できます。

表 1. トラフィックフローデータ要求パターン
アドレッシング方式	URL パターン
[Z]/[X] / [Y]	`{base-url}/{path}/{resource}/{format}/{zoom}/{column}/{row}?`
quadkey	`{base-url}/{path}/{resource}.{format}?quadkey={quadkey}`
Bounding Box	`{base-url}/{path}/{resource}.{format}?bbox={bounding box coordinates}`
近接性	`{base-url}/{path}/{resource}.{format}?prox={proximity coordinates}`
Corridor	`{base-url}/{path}/{resource}.{format}?corridor={corridor coordinates}`

注 : 上記のリクエストパターンで {path} は、がである必要 /traffic/6.2/ があります。

アドレッシング方式を反映した次のいずれかの要求パターンを使用して、トラフィックインシデントレポートを取得でき traffic/6.1/incidentstraffic/6.2/incidentsます（これは、インシデントエンドポイントとの両方に適用されます）。

表 2. 交通事故リクエストのパターン
アドレッシング方式	URL パターン
[Z]/[X] / [Y]	`{base-url}/{path}/{resource}/{format}/{zoom}/{column}/{row}?`
quadkey	`{base-url}/{path}/{resource}.{format}?quadkey={quadkey}`
Bounding Box	`{base-url}/{path}/{resource}.{format}?bbox={bounding box coordinates}`
近接性	`{base-url}/{path}/{resource}.{format}?prox={proximity coordinates}`
廊下の座標	`{base-url}/{path}/{resource}.{format}?corridor={corridor coordinates}`

次のいずれかの要求パターンを使用して、アドレッシング方式を反映したトラフィックタイルを取得できます。

表 3. Traffic タイルの要求パターン
アドレッシング方式	URL パターン
[Z]/[X] / [Y]	`{tile-base-url}/{path}/{resource}/{format}/{resource}/{zoom}/{column}/{row}/{size}?`
quadkey	`{tile-base-url}/{path}/{resource}/quadkeytraffic?quadkey={quadkey}`

注 : [Z]/[X]/[Y] タイルアドレッシング方式を使用する場合、タイルのサイズと色深度を次のように指定できます。

詳細については、「タイルサイズの選択」および「タイルの色深度の選択」を参照してください。

プロファイルのトラフィックフローの可用性情報は、以下のパターンに従ってアドレスを使用して取得できます。

表 4. トラフィックフローのアベイラビリティ要求パターン
アドレッシング方式	URL パターン
プロファイル	`{base-url}/{path}/{resource}.{format}?profile={profile name}`