次の出発便を場所で検索します
ユーザーストーリー
ローマのテルミニ中央駅から一定の距離にある出発地点の情報をリクエストしたいと考えています。
リクエスト
1 つの GET リクエストで、次の出発地点を検索できます。 唯一の必須パラメータ in
は、フォーム<latitude>,<longitude>
内の WGS84 座標のペアとして定義されている検索領域の中心を指定します。 オプションのパラメータ r
で、検索範囲の半径をメートル単位で指定します。 デフォルトでは、 r=500
です。 次のリクエストは 500
、指定された場所からメートル以内に次の出発地点を検索します 41.900138,12.501924
。
GET https://transit.hereapi.com/v8/departures
?in=41.900138,12.501924;r=500
レスポンス
リクエストに対する応答には、次の情報ブロックが含まれています。
-
各駅につき、最大 50 個のデパーチャーボードをご利用いただけます。 デパーチャーボードの要素数は、デフォルトの半径 500 メートル以内の指定された場所への近隣のステーションの近接度によって異なります。 オプションの maxPlaces
request パラメータで、応答に含めるステーションの最大数を設定します。
-
boards
応答オブジェクト内departures
の各出発要素には、次の上位レベルの要素が含まれています。
-
place
名前、場所、 ID 、タイプなどのステーション / ストップ情報を使用します。 -
departures
出発時間、遅延、ステータス、オペレータなどの交通情報を利用できます。 -
attributions
免責事項などの必須情報が表示されます。
{
"boards": [
{
"place": {
"name": "Roma Termini",
"type": "station",
"location": {
"lat": 41.900503,
"lng": 12.502027
},
"id": "722068214"
},
"departures": [
{
"time": "2020-04-21T10:28:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "Regionale 7213",
"category": "Regional Train",
"color": "#05655D",
"textColor": "#FFFFFF",
"headsign": "Velletri"
},
"agency": {
"id": "fKf00800",
"name": "TRENITALIA",
"website": "http://www.trenitalia.com"
}
},
{
"time": "2020-04-21T10:35:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "Regionale Veloce 3270",
"category": "Regional Train",
"color": "#05655D",
"textColor": "#FFFFFF",
"headsign": "Fiumicino Aeroporto"
},
"agency": {
"id": "fKf00800",
"name": "TRENITALIA",
"website": "http://www.trenitalia.com"
}
},
{
"time": "2020-04-21T10:36:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "Regionale 2383",
"category": "Regional Train",
"color": "#05655D",
"textColor": "#FFFFFF",
"headsign": "Napoli Centrale"
},
"agency": {
"id": "fKf00800",
"name": "TRENITALIA",
"website": "http://www.trenitalia.com"
}
},
{
"time": "2020-04-21T10:42:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "Regionale 12240",
"category": "Regional Train",
"color": "#05655D",
"textColor": "#FFFFFF",
"headsign": "Civitavecchia"
},
"agency": {
"id": "fKf00800",
"name": "TRENITALIA",
"website": "http://www.trenitalia.com"
}
},
{
"time": "2020-04-21T10:42:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "Regionale 12165",
"category": "Regional Train",
"color": "#05655D",
"textColor": "#FFFFFF",
"headsign": "Nettuno"
},
"agency": {
"id": "fKf00800",
"name": "TRENITALIA",
"website": "http://www.trenitalia.com"
}
}
],
"attributions": [
{
"id": "-link-0",
"href": "http://www.trenitalia.com/tcom",
"text": "TRENITALIA",
"type": "disclaimer"
}
]
},
{
"place": {
"name": "Roma Termini",
"type": "station",
"location": {
"lat": 41.90054,
"lng": 12.502168
},
"id": "415712984"
},
"departures": [
{
"time": "2020-04-21T10:28:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "FL4",
"category": "Regional Train",
"color": "#7A2900",
"textColor": "#FFFFFF",
"headsign": "Velletri"
},
"agency": {
"id": "aDmtre00",
"name": "Trenitalia",
"website": "http://www.trenitalia.com/"
}
},
{
"time": "2020-04-21T10:35:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "LE",
"category": "Regional Train",
"color": "#4C8DC1",
"textColor": "#000000",
"headsign": "Fiumicino Aeroporto"
},
"agency": {
"id": "aDmtre00",
"name": "Trenitalia",
"website": "http://www.trenitalia.com/"
}
},
{
"time": "2020-04-21T10:42:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "FL8",
"category": "Regional Train",
"color": "#00B85C",
"textColor": "#FFFFFF",
"headsign": "Nettuno"
},
"agency": {
"id": "aDmtre00",
"name": "Trenitalia",
"website": "http://www.trenitalia.com/"
}
},
{
"time": "2020-04-21T10:50:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "LE",
"category": "Regional Train",
"color": "#4C8DC1",
"textColor": "#000000",
"headsign": "Fiumicino Aeroporto"
},
"agency": {
"id": "aDmtre00",
"name": "Trenitalia",
"website": "http://www.trenitalia.com/"
}
},
{
"time": "2020-04-21T11:05:00+02:00",
"transport": {
"mode": "regionalTrain",
"name": "LE",
"category": "Regional Train",
"color": "#4C8DC1",
"textColor": "#000000",
"headsign": "Fiumicino Aeroporto"
},
"agency": {
"id": "aDmtre00",
"name": "Trenitalia",
"website": "http://www.trenitalia.com/"
}
}
],
"attributions": [
{
"id": "-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"
}
]
}
]
}