トランジットルートの形状を取得します
ユーザーストーリー
ローマフィウミチーノ国際空港のターミナル 1 からローマテルミニ中央駅までの公共交通機関を利用したトランジットルートをリクエストする場合。 ルートのシェイプも取得する必要があります。
リクエスト
ルートの形状を取得するには、ルートリクエストの必須origin
パラメータおよびdestination
パラメータの後に return=polyline
を指定します。 これにより、各セクションにポリラインフィールドが作成されます。 このポリラインは 、 Flexible ポリラインを使用してエンコードされます。 このポリラインは 、 Flexible ポリライン レポジトリで利用できる例を使用して、多くの主要言語で簡単にデコードできます。
デコードされたポリラインは、ルートのレンダリングに使用できる一連の座標になり ます(たとえば、 JavaScript for Maps API を使用)。
次のリクエストは、形状情報を使用してトランジットルートを計算します。
GET https://transit.router.hereapi.com/v8/routes
?origin=41.79457,12.25473
&destination=41.90096,12.50243
&return=polyline
オプションのパラメータ alternatives
は、最適なルートを除いて戻る代替ルートの数を表します。 デフォルトで alternatives=0
は、設定されていない場合、最適なルートが 1 つだけ返されます。
レスポンス
ルートの計算が成功した場合 /routes
、応答には計算されたルートについて要求された詳細情報が含まれます。
alternatives
が 0 より大きい場合を除き、最適な 1 つの配送ルート - 複数の輸送セクションがあり、各セグメント(歩行者または輸送セグメントを表す)には、出発 / 到着時間、所要時間、および座標が含まれています
- 輸送セグメントには、実際の配達地点または出発地と到着地が表示されます。 必要に応じて、中間のすべての中継地点もパラメータを使用して要求できます
return=intermediate
- 代替品に含まれているサービスを実行するオペレータのセット。オペレータコード、オペレータ名、オペレータの Web サイトへのリンク ( 存在する場合 ) などが含まれます
polyline
Flexible ポリラインを使用してエンコードされた、フィールド内のルートの形状
{
"routes": [
{
"id": "R00132f-C0",
"sections": [
{
"id": "R00132f-C0-S0",
"type": "pedestrian",
"polyline": "BHkrsl9Y6503pHq9Gr1O9uB9uBhjCjmEAz1BjUp8B_1Kr2T5hKw0JruFxoKk6Dl-D",
"departure": {
"time": "2020-04-22T12:17:00+02:00",
"place": {
"type": "place",
"location": {
"lat": 41.79457,
"lng": 12.25473
}
}
},
"arrival": {
"time": "2020-04-22T12:23:00+02:00",
"place": {
"name": "Fiumicino Aeroporto",
"type": "station",
"location": {
"lat": 41.793466,
"lng": 12.251997
},
"id": "415713377"
}
}
},
{
"id": "R00132f-C0-S1",
"type": "transit",
"polyline": "BHsq1k9Yow_1pHr9sEk8sEzjGooJ7wFw9J_mE0iJngDg1Hn9Bw_IvC8jJkcg1H08BkkHgj9Bkh3E0rhDkriHoi6Nkl9egmqB4g3D4qJ49vBz9D0isB3-d89qI8gIwr_Bw2oB87_Ds9oB41oEgvUoyoD0xJ4rjE7jEgqjBrhiBs8jF4Swqa8sHghlBkm4BwngF8x-B4m3Ekq7BsixCgw0B8rmC4gTolrB8oE04rBngIgo8E_qHsqwD44CktyBs4KoppB0mgBg7sBgggF8vnD88sBoyY0k3F41kB88Y0mMgzSstXs4tB8jgCsorB40YkhpB7zBos-BnppBwlQrpF08V0rC8zV8kLo-NgsTolIw-a4hGwrkCoGgkDoGo4BA4rBoGo4Bg9D464B4SoyJAo4B4rBgxTo4B45YojEol9CoG4vEnG4vEvMwienGgvFv3CowU_xBolSn4BolS_nG4qsBnrKohhCn8E4zgB_6Oo8oDAo1FAoxCAg9DvMw2UwM4zyCnGw3CoG4mQ4rBw9TwwDw9TofwiFg-KgyaozQgxToqc41Vg9D4rBg7OwuOg-K40Ow3Cw7FwiFg-KghHo8doxCwpd4kCw9sBoqDw_hBgvFwzY4rBwwD4So4BofwiFgvFo9L4kbgmqB4yZw1mBsvHs9K03asuUoyd0oLk0J3D8mK7nCoiHvjCs9ZzkNwhcrtSsyDnzGw5QnrjBw3C_uFwla3uvBgZ3rBomZ3gxB4kCvpE4_Q36fgyB39C4kC_8Dkmaz10Bwlfn75Boh6Cz-zD48Pjha",
"departure": {
"time": "2020-04-22T12:23:00+02:00",
"place": {
"name": "Fiumicino Aeroporto",
"type": "station",
"location": {
"lat": 41.793466,
"lng": 12.251997
},
"id": "415713377"
}
},
"arrival": {
"time": "2020-04-22T12:55:00+02:00",
"place": {
"name": "Roma Termini",
"type": "station",
"location": {
"lat": 41.90054,
"lng": 12.502168
},
"id": "415712984"
}
},
"transport": {
"mode": "regionalTrain",
"name": "LE",
"category": "Regional Train",
"color": "#4C8DC1",
"textColor": "#000000",
"headsign": "Roma Termini"
},
"agency": {
"id": "aDmtre00",
"name": "Trenitalia",
"website": "http://www.trenitalia.com/"
},
"attributions": [
{
"id": "R00132f-C0-S1-link-0",
"href": "http://creativecommons.org/licenses/by/3.0/it/",
"text": "Some line names used in this product or service were edited to align with official transportation maps.",
"type": "disclaimer"
}
]
},
{
"id": "R00132f-C0-S2",
"type": "pedestrian",
"polyline": "BHyvnm_YgztuuHw8GsqH",
"departure": {
"time": "2020-04-22T12:55:00+02:00",
"place": {
"name": "Roma Termini",
"type": "station",
"location": {
"lat": 41.90054,
"lng": 12.502168
},
"id": "415712984"
}
},
"arrival": {
"time": "2020-04-22T12:56:00+02:00",
"place": {
"type": "place",
"location": {
"lat": 41.90096,
"lng": 12.50243
}
}
}
}
]
}
]
}