利用開始
このセクションでは、 HERE platform でウェイポイントシーケンス V8 サービスを使用し実行する方法について説明します。
- HERE アカウントを取得
- プロジェクトを作成
- API キー を入手
- リクエストの送信
- 次のステップ
HERE アカウントの取得
組織が HERE Workspace または HERE Marketplace にサインアップしている場合は、組織の管理者に連絡して、会社に設定されている HERE platform 組織の参加を招待をしてもらってください。 組織が設定されていない場合は、 HERE platform の無料試用版をリクエストすることもできます。 詳細については 、 HERE platform の価格表を参照してください。
プロジェクトを作成
プロジェクトを作成するには、次の手順に従います。
- HERE アカウントを使用して HERE platform にサインイン。
- ランチャーから[プロジェクトマネージャ]を開きます。
- [ 新しいプロジェクトを作成] をクリックする。
- プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
- プロジェクト ID を入力します。 プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ~ 16 文字である必要があります。
- 任意 :任意の説明を入力します。
- [保存]をクリックする。
- [ リソース ] タブで 、 [ サービス] を選択し、 [ サービスのリンク ] をクリックします。
- HERE Waypoints Sequence の API V8 サービスを検索し 、 [ リンク] をクリックします。
- [完了]をクリックします。
API キー を入手
API キー を取得するには、次の手順を実行します。
- HERE アカウントを使用して HERE platform にサインインする。
- ランチャから [アクセスマネージャ] を選択します。
- [ アプリ] タブを選択し、[ 新しいアプリ を登録 ] をクリックします。
- アプリ の名前を入力します。
- オプション: アプリ の説明を入力します。
- オプション : 前の手順で作成したプロジェクトを 、プロジェクト フィールドへの既定のアクセス権から選択します。
- [ 登録] をクリックします HERE platform によって、一意のアプリ ID を持つ新しいアプリ が作成されます。
- [資格情報]タブで 、[API Keys]を選択 し、[API キーを生成]をクリック して、アプリケーション認証資格情報用に 最大 2 つのAPI キーを生成します。API キー が作成され、表示されます。
リクエストの送信
このリクエスト例では、ドイツのヴィースバーデンにある中央駅からドイツのマインツにある中央駅までの最速のルートを探しています。フランクフルト、ダルムシュタット、ハナウ、フランクフルト空港を通過します。 ユーザーが交通情報に関心があり、時間的に最適化されたルートを探しています。
リクエスト
curl -H "Authorization: Bearer TOKEN_HERE" "https://wps.hereapi.com/v8/findsequence2?start=WiesbadenCentralStation;50.0715,8.2434&destination1=FranfurtCentralStation;50.1073,8.6647&destination2=DarmstadtCentralStation;49.8728,8.6326&destination3=FrankfurtAirport;50.0505,8.5698&destination4=HanauCentralStation;50.1218,8.9298&end=MainzCentralStation;50.0021,8.259&improveFor=time&departure=2014-12-09T09:30:00%2b01:00&mode=fastest;car;traffic:enabled"
curl "https://wps.hereapi.com/v8/findsequence2?start=WiesbadenCentralStation;50.0715,8.2434&destination1=FranfurtCentralStation;50.1073,8.6647&destination2=DarmstadtCentralStation;49.8728,8.6326&destination3=FrankfurtAirport;50.0505,8.5698&destination4=HanauCentralStation;50.1218,8.9298&end=MainzCentralStation;50.0021,8.259&improveFor=time&departure=2014-12-09T09:30:00%2b01:00&mode=fastest;car;traffic:enabled?apikey=APIKEY_HERE"
レスポンス
{
"results": [{
"waypoints": [{
"id": "WiesbadenCentralStation",
"lat": 50.0715,
"lng": 8.2434,
"sequence": 0,
"estimatedArrival": null,
"estimatedDeparture": "2014-12-09T09:30:00+01:00",
"fulfilledConstraints": []
},
{
"id": "FranfurtCentralStation",
"lat": 50.1073,
"lng": 8.6647,
"sequence": 1,
"estimatedArrival": null,
"estimatedDeparture": "2014-12-09T10:01:02+01:00",
"fulfilledConstraints": []
},
{
"id": "HanauCentralStation",
"lat": 50.1218,
"lng": 8.9298,
"sequence": 2,
"estimatedArrival": null,
"estimatedDeparture": "2014-12-09T10:30:43+01:00",
"fulfilledConstraints": []
},
{
"id": "FrankfurtAirport",
"lat": 50.0505,
"lng": 8.5698,
"sequence": 3,
"estimatedArrival": null,
"estimatedDeparture": "2014-12-09T10:56:10+01:00",
"fulfilledConstraints": []
},
{
"id": "DarmstadtCentralStation",
"lat": 49.8728,
"lng": 8.6326,
"sequence": 4,
"estimatedArrival": null,
"estimatedDeparture": "2014-12-09T11:16:55+01:00",
"fulfilledConstraints": []
},
{
"id": "MainzCentralStation",
"lat": 50.0021,
"lng": 8.259,
"sequence": 5,
"estimatedArrival": null,
"estimatedDeparture": null,
"fulfilledConstraints": []
}],
"distance": "169262",
"time": "8362",
"interconnections": [{
"fromWaypoint": "WiesbadenCentralStation",
"toWaypoint": "FranfurtCentralStation",
"distance": 36461.0,
"time": 1862.0
},
{
"fromWaypoint": "FranfurtCentralStation",
"toWaypoint": "HanauCentralStation",
"distance": 34485.0,
"time": 1781.0
},
{
"fromWaypoint": "HanauCentralStation",
"toWaypoint": "FrankfurtAirport",
"distance": 33489.0,
"time": 1527.0
},
{
"fromWaypoint": "FrankfurtAirport",
"toWaypoint": "DarmstadtCentralStation",
"distance": 26905.0,
"time": 1245.0
},
{
"fromWaypoint": "DarmstadtCentralStation",
"toWaypoint": "MainzCentralStation",
"distance": 37922.0,
"time": 1947.0
}],
"description": "Targeted best time; with improvement for traffic"
}],
"processingTimeDesc": "1345ms",
"responseCode": "200",
"warnings": null,
"requestId": null
}
次のステップ
リクエストの作成方法については 、「リクエストの作成」を参照してください。 サンプルリクエストについて は、「交通情報を用いて最適化された ウェイポイントシーケンスを使用した車両ルート」を参照してください。 その他の例については 、例を参照してください。 このドキュメントをカバーする利用規約 については 、『 HERE Documentation License』を参照してください。