インシデントデータリクエストを移行します
このセクションでは、 Traffic API V6 から v7 にインシデントのデータリクエストを移行する方法について説明します。
リクエスト
Traffic API v7 の要求パラメータの詳細について は、 Traffic API v7 開発者ガイド の Flow-Request Parameters セクションを参照してください。
パラメータが追加されました
次のパラメータが追加されました。
パラメータが変更されました
次のパラメータが変更されました。
endTime
i18n
lg
startTime
パラメータが削除されました
次の地理空間 パラメータが in
パラメータに置き換えられました。
bbox
corridor
prox
-
quadkey
( Traffic API v7 ではサポートされていません。代わりにバウンディング ボックス を使用してください)
次のパラメータが削除されました。
c
inc22
jsoncallback
localtime
maxresults
profile
sort
status
tables
verified
詳細について は、パラメーターマッピングの表を参照してください。
基本 URL 、バージョン、およびリソース
パラメーター | Traffic API v6 | Traffic API v7. | 移行メモ |
基本 URL | https://traffic.api.here.com | https://data.traffic.hereapi.com | |
バージョン | /traffic/6.3 | v7 | |
リソース | /incidents.{format} | incidents | Traffic API v7 は JSON のみをサポートします。 |
リソース | /incidents/{format} | incidents | Traffic API v7 は JSON のみをサポートします。 |
リソース | /incidents/{zoom}/{x}/{y}/{format} | incidents | バウンディング ボックス に翻訳する必要があります。 |
V6 API のインシデントデータに使用できる形式は json
AND xml
です。 Traffic API v7 の応答データは常に JSON 形式です。
{zoom}/{x}/{y}
フォームのタイル アドレスを バウンディング ボックス に変換する方法について は、「地理空間 フィルターパラメーターを移行する」の手順を参照してください。
パラメーターマッピング
Traffic API v6 | Traffic API v7. | 移行メモ |
bbox | in=bbox: | 詳細については、「地理空間 フィルタパラメータを移行する」を参照してください |
corridor | in=corridor: | 詳細については、「地理空間 フィルタパラメータを移行する」を参照してください |
prox | in=circle: | 詳細については、「地理空間 フィルタパラメータを移行する」を参照してください |
quadkey | in=bbox: | Traffic API v7 では、 地理空間 フィルタパラメータの移行はサポート されていません。バウンディング ボックス への変換方法については、「フィルタパラメータの移行」を参照してください。 |
c | | Traffic API v7 データモデルは、すべてのユニットで標準形式を使用します。 |
criticality | criticality | |
endTime | latestEndTime | |
i18n | lang | i18n および lg は、単一 lang のパラメータで置き換えられます。 |
inc22 | | Traffic API v7 は、 V6 API TML データ形式をサポートしていません。 |
jsoncallback | | 機能ラップド JSON 応答は、 CORS がサポートされているため、 Traffic API v7 ではサポートされていません。 |
lg | lang | i18n および lg は、単一 lang のパラメータで置き換えられます。 |
localtime | | トラフィック API v7 は常に UTC 時間を返します。 |
maxresults | | 結果数の上限は現在サポートされていません。 |
profile | | プロファイルは Traffic API v7 ではサポートされていません。 すべての地域がすべてのリクエストで利用できます。 |
sort | | Traffic API v7 では、並べ替えはサポートされていません。 |
startTime | earliestStartTime | |
status | | v7 データモデル active からステータスが削除されました ( 以前使用されていたもののみ ) 。 |
tables | | TMC テーブルによるフィルタリングは、 Traffic API v7 では現在サポートされていません。 |
type | type | |
verified | | v7 データモデル true が以前使用されていたものとして削除されたことを確認しました。 |
units | units | Traffic API v7 は、メートル単位の長さと、メートル / 秒単位の速度を表します。 |
データモデル
V6 と v7 のトラフィック API では、データモデルが大幅に異なります。 完全な v7 データモデルは 、 API リファレンス にあります。
概念については 、開発者ガイド の「インシデントの概念」セクションで説明しています。