HERE Traffic API v7の使用を開始する
注
このセクションでは、HERE Traffic API v7の使用を迅速に開始するために必要な最小限の設定について説明します。HEREアカウントの設定、プロジェクトの作成、サービスのリンク、アプリの登録、認証の詳細については、Identity and Access Managementの開発者ガイドを参照してください。
HEREアカウントを取得する
組織管理者からの招待状を通じて、または無料で利用を開始して、HEREプラットフォームへのアクセスを入手します。
- 会社がすでにHEREプラットフォーム組織を設立している場合は、組織への参加に招待できる管理者に連絡してください。
- 会社がまだHEREプラットフォーム組織を設立していない場合は、無料で利用を開始できます。詳細については、「HEREプラットフォームの価格設定」を参照してください。
APIキーを入手する
APIキーを入手するには、次の手順を実行します。
- HEREアカウントを使用してHEREプラットフォームにサインインします。
- ランチャーから[アクセスマネージャー]を開きます。
- [アプリ]タブを選択し、[新しいアプリを登録]をクリックします。
- アプリの名前を入力します。
- [登録]をクリックします。HEREプラットフォームで、一意のアプリIDを持つ新しいアプリが作成されます。
- [資格情報]タブで、[APIキー]を選択し、[APIキーを生成]をクリックして、アプリ認証資格情報用に最大2つのAPIキーを生成します。APIキーが作成され、表示されます。
リクエストを送信する
Traffic API v7はフローおよびインシデント情報を提供します。以下の例では、フローデータに重点を置きます。 エンドポイントには次の2つのパラメーターが必要です。
in- フローデータをリクエストする対象の地域locationReferencing- レスポンス内で使用される位置データ
パラメーターは、GETリクエストのURL内で指定するか、POSTリクエストでJSONデータとして指定できます。
ここでは、inパラメーターにバウンディングボックスを使用します。地理空間のフィルタリングの詳細については、「地理空間フィルタリング」を参照してください。
locationReferencingパラメーターの場合、ここではshapeを指定します。これは、影響する道路の形状をWGS84座標を使用して記述します。位置の参照に使用可能な形式の詳細については、「位置の参照」を参照してください。
curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/flow?locationReferencing=shape&in=bbox:13.400,52.500,13.405,52.505"注
上記のリクエストは、APIキーとOAuthトークンの両方の認証の例を示しています。OAuthトークン認証の詳細については、Identity and Access Managementの開発者ガイドを参照してください。
レスポンスには、指定された地域内のフロー情報が含まれます。以下の例でresults配列は、読みやすいように省略されています。
{
"sourceUpdated": "2021-07-01T13:53:03Z",
"results": [
{
"location": {
"length": 988.0,
"shape": {
"links": [
{
"points": [
{
"lat": 52.50708997249603,
"lng": 13.398289997130632
},
{
"lat": 52.506989976391196,
"lng": 13.39867003262043
}
],
"length": 28.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.506989976391196,
"lng": 13.39867003262043
},
{
"lat": 52.506729969754815,
"lng": 13.399609979242086
}
],
"length": 70.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.506729969754815,
"lng": 13.399609979242086
},
{
"lat": 52.50655001029372,
"lng": 13.40023996308446
}
],
"length": 47.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50655001029372,
"lng": 13.40023996308446
},
{
"lat": 52.506150025874376,
"lng": 13.401690032333136
}
],
"length": 109.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.506150025874376,
"lng": 13.401690032333136
},
{
"lat": 52.506060004234314,
"lng": 13.402009969577193
}
],
"length": 24.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.506060004234314,
"lng": 13.402009969577193
},
{
"lat": 52.50577996484935,
"lng": 13.403040021657944
}
],
"length": 77.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50577996484935,
"lng": 13.403040021657944
},
{
"lat": 52.50564996153116,
"lng": 13.403479987755418
}
],
"length": 33.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50564996153116,
"lng": 13.403479987755418
},
{
"lat": 52.505549965426326,
"lng": 13.403879972174764
}
],
"length": 29.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.505549965426326,
"lng": 13.403879972174764
},
{
"lat": 52.5053199660033,
"lng": 13.404720006510615
}
],
"length": 63.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.5053199660033,
"lng": 13.404720006510615
},
{
"lat": 52.505160039290786,
"lng": 13.40528997592628
}
],
"length": 43.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.505160039290786,
"lng": 13.40528997592628
},
{
"lat": 52.50504001043737,
"lng": 13.405700018629432
}
],
"length": 31.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50504001043737,
"lng": 13.405700018629432
},
{
"lat": 52.504900032654405,
"lng": 13.406239980831742
}
],
"length": 40.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.504900032654405,
"lng": 13.406239980831742
},
{
"lat": 52.50478000380099,
"lng": 13.406659997999668
}
],
"length": 32.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50478000380099,
"lng": 13.406659997999668
},
{
"lat": 52.50475997105241,
"lng": 13.40675001963973
}
],
"length": 7.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50475997105241,
"lng": 13.40675001963973
},
{
"lat": 52.504729963839054,
"lng": 13.406850015744567
}
],
"length": 8.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.504729963839054,
"lng": 13.406850015744567
},
{
"lat": 52.50464002601802,
"lng": 13.407210018485785
}
],
"length": 27.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50464002601802,
"lng": 13.407210018485785
},
{
"lat": 52.504429975524545,
"lng": 13.407960031181574
}
],
"length": 56.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.504429975524545,
"lng": 13.407960031181574
},
{
"lat": 52.50422998331487,
"lng": 13.408669978380203
},
{
"lat": 52.50405999831855,
"lng": 13.409310020506382
}
],
"length": 101.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50405999831855,
"lng": 13.409310020506382
},
{
"lat": 52.504020016640425,
"lng": 13.409470031037927
}
],
"length": 12.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.504020016640425,
"lng": 13.409470031037927
},
{
"lat": 52.503869980573654,
"lng": 13.410019967705011
}
],
"length": 41.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.503869980573654,
"lng": 13.410019967705011
},
{
"lat": 52.50376998446882,
"lng": 13.410369995981455
}
],
"length": 26.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.50376998446882,
"lng": 13.410369995981455
},
{
"lat": 52.503720028325915,
"lng": 13.410349963232875
},
{
"lat": 52.50365003943443,
"lng": 13.410330014303327
},
{
"lat": 52.503590025007725,
"lng": 13.410349963232875
},
{
"lat": 52.50353001058102,
"lng": 13.410390028730035
},
{
"lat": 52.50347997061908,
"lng": 13.410439984872937
},
{
"lat": 52.503439988940954,
"lng": 13.410520032048225
}
],
"length": 41.0,
"functionalClass": 3
},
{
"points": [
{
"lat": 52.503439988940954,
"lng": 13.410520032048225
},
{
"lat": 52.503420040011406,
"lng": 13.410599995404482
},
{
"lat": 52.503420040011406,
"lng": 13.410699991509318
},
{
"lat": 52.50343001447618,
"lng": 13.41079001314938
},
{
"lat": 52.50344996340573,
"lng": 13.410890009254217
},
{
"lat": 52.50347997061908,
"lng": 13.410969972610474
},
{
"lat": 52.50350997783244,
"lng": 13.411029987037182
},
{
"lat": 52.503549959510565,
"lng": 13.411080026999116
}
],
"length": 43.0,
"functionalClass": 3
}
]
}
},
"currentFlow": {
"speed": 3.6111112,
"speedUncapped": 3.6111112,
"freeFlow": 10.555556,
"jamFactor": 8.2,
"confidence": 0.99,
"traversability": "open",
"subSegments": [
{
"length": 418.0,
"speed": 7.2222223,
"speedUncapped": 7.2222223,
"freeFlow": 11.111112,
"jamFactor": 3.2,
"jamTendency": 1,
"confidence": 0.99,
"traversability": "open"
},
{
"length": 570.0,
"speed": 2.777778,
"speedUncapped": 2.777778,
"freeFlow": 10.277778,
"jamFactor": 8.7,
"jamTendency": 1,
"confidence": 0.99,
"traversability": "open"
}
]
}
}
]
}次のステップ
- フローデータの構造の概要については、「フロー」を参照してください。
- フローデータをリクエストする方法については、「フローデータをリクエストする」を参照してください。
- 車道の特定のセクションに影響を与えるイベントの例については、「インシデント」(交通障害) を参照してください。
- Traffic APIの詳細については、「APIリファレンス」を参照してください。
7 日前の更新