利用開始
このセクションでは 、 HERE platform の HERE Traffic API v7 を使用してはじめに をすばやく実行する方法について説明します。
- HERE アカウントを取得
- プロジェクトを作成
- API キー を入手
- リクエストの送信
- 次のステップ
注
このセクションでは、 HERE Traffic API v7 の使用を迅速に開始するために必要な最小限の設定について説明します。 HERE アカウントの設定、プロジェクトの作成、サービスのリンク、アプリの登録、および認証の詳細については、 ID およびアクセス管理開発者ガイドを参照してください。
HERE アカウントの取得
フレキシブル HERE 基本プランから無料の HERE platform アカウントを使用し作成できます。 詳細については、 HERE 基本プランの価格表を参照してください。 または、会社がすでに HERE platform 組織を作成している場合は、組織管理者に連絡して、会社の組織に参加するよう招待してください。
プロジェクトを作成
プロジェクトを作成するには、次の手順に従います。
- HERE アカウントを使用して HERE platform にサインイン。
- ランチャからプロジェクト管理者を開きます。
- [ 新しいプロジェクトを作成] をクリックする。
- プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
- プロジェクト ID を入力します。 プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ~ 16 文字である必要があります。
- オプション : 説明を入力する。
- [保存]をクリックする。
- [ リソース ] タブで 、 [ サービス] を選択し、 [ サービスのリンク ] をクリックします。
- HERE Traffic API サービスを検索し 、 [ リンク] をクリックします。
- [完了]をクリックします。
API キー を入手
API キー を取得するには、次の手順を実行します。
- HERE アカウントを使用して HERE platform にサインイン。
- ランチャから [アクセスマネージャ] を選択します。
- [ アプリ] タブを選択し、[ 新しいアプリ を登録 ] をクリックします。
- アプリ の名前を入力します。
- オプション: アプリ の説明を入力します。
- 新規アプリで、[新しいアプリを登録]を選択します。
- オプション : 前の手順で作成したプロジェクトを、プロジェクト フィールドへの既定のアクセス権から選択します。
- [ 登録] をクリックします HERE platform によって、一意のアプリ ID を持つ新しいアプリ が作成されます。
- [資格情報]タブで 、[API Keys]を選択 し、[API キーを生成]をクリック して、アプリケーション認証資格情報用に 最大 2 つのAPI キーを生成します。API キー が作成され、表示されます。
リクエストの送信
Traffic API v7 リクエストは、フロー情報またはインシデント情報を取得する 1 つの GET リクエストで構成されます。 以下の例では、フローデータに焦点を当てています。
エンドポイントには 2 つの必須パラメータがあります。
-
in
- 内のフローデータを要求するリージョン -
locationReferencing
- 応答で使用された位置データ
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"
curl "https://data.traffic.hereapi.com/v7/flow?locationReferencing=shape&in=bbox:13.400,52.500,13.405,52.505&apiKey=$API_KEY"
応答には、指定されたエリア内のフロー情報が含まれています。 次の例では 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
},
{
"points": [
{
"lat": 52.506989976391196,
"lng": 13.39867003262043
},
{
"lat": 52.506729969754815,
"lng": 13.399609979242086
}
],
"length": 70.0
},
{
"points": [
{
"lat": 52.506729969754815,
"lng": 13.399609979242086
},
{
"lat": 52.50655001029372,
"lng": 13.40023996308446
}
],
"length": 47.0
},
{
"points": [
{
"lat": 52.50655001029372,
"lng": 13.40023996308446
},
{
"lat": 52.506150025874376,
"lng": 13.401690032333136
}
],
"length": 109.0
},
{
"points": [
{
"lat": 52.506150025874376,
"lng": 13.401690032333136
},
{
"lat": 52.506060004234314,
"lng": 13.402009969577193
}
],
"length": 24.0
},
{
"points": [
{
"lat": 52.506060004234314,
"lng": 13.402009969577193
},
{
"lat": 52.50577996484935,
"lng": 13.403040021657944
}
],
"length": 77.0
},
{
"points": [
{
"lat": 52.50577996484935,
"lng": 13.403040021657944
},
{
"lat": 52.50564996153116,
"lng": 13.403479987755418
}
],
"length": 33.0
},
{
"points": [
{
"lat": 52.50564996153116,
"lng": 13.403479987755418
},
{
"lat": 52.505549965426326,
"lng": 13.403879972174764
}
],
"length": 29.0
},
{
"points": [
{
"lat": 52.505549965426326,
"lng": 13.403879972174764
},
{
"lat": 52.5053199660033,
"lng": 13.404720006510615
}
],
"length": 63.0
},
{
"points": [
{
"lat": 52.5053199660033,
"lng": 13.404720006510615
},
{
"lat": 52.505160039290786,
"lng": 13.40528997592628
}
],
"length": 43.0
},
{
"points": [
{
"lat": 52.505160039290786,
"lng": 13.40528997592628
},
{
"lat": 52.50504001043737,
"lng": 13.405700018629432
}
],
"length": 31.0
},
{
"points": [
{
"lat": 52.50504001043737,
"lng": 13.405700018629432
},
{
"lat": 52.504900032654405,
"lng": 13.406239980831742
}
],
"length": 40.0
},
{
"points": [
{
"lat": 52.504900032654405,
"lng": 13.406239980831742
},
{
"lat": 52.50478000380099,
"lng": 13.406659997999668
}
],
"length": 32.0
},
{
"points": [
{
"lat": 52.50478000380099,
"lng": 13.406659997999668
},
{
"lat": 52.50475997105241,
"lng": 13.40675001963973
}
],
"length": 7.0
},
{
"points": [
{
"lat": 52.50475997105241,
"lng": 13.40675001963973
},
{
"lat": 52.504729963839054,
"lng": 13.406850015744567
}
],
"length": 8.0
},
{
"points": [
{
"lat": 52.504729963839054,
"lng": 13.406850015744567
},
{
"lat": 52.50464002601802,
"lng": 13.407210018485785
}
],
"length": 27.0
},
{
"points": [
{
"lat": 52.50464002601802,
"lng": 13.407210018485785
},
{
"lat": 52.504429975524545,
"lng": 13.407960031181574
}
],
"length": 56.0
},
{
"points": [
{
"lat": 52.504429975524545,
"lng": 13.407960031181574
},
{
"lat": 52.50422998331487,
"lng": 13.408669978380203
},
{
"lat": 52.50405999831855,
"lng": 13.409310020506382
}
],
"length": 101.0
},
{
"points": [
{
"lat": 52.50405999831855,
"lng": 13.409310020506382
},
{
"lat": 52.504020016640425,
"lng": 13.409470031037927
}
],
"length": 12.0
},
{
"points": [
{
"lat": 52.504020016640425,
"lng": 13.409470031037927
},
{
"lat": 52.503869980573654,
"lng": 13.410019967705011
}
],
"length": 41.0
},
{
"points": [
{
"lat": 52.503869980573654,
"lng": 13.410019967705011
},
{
"lat": 52.50376998446882,
"lng": 13.410369995981455
}
],
"length": 26.0
},
{
"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
},
{
"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
}
]
}
},
"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"
}
]
}
}
]
}
次のステップ