乗車位置情報
次の路線への乗り換えに便利な乗車位置の情報を表します。
ダイヤによる探索時、かつ乗り換えがある経路が対象となります。
なお、乗り換え先の区間が「徒歩」の場合は乗車位置情報は返りません。
乗車位置情報が付加される場合、されない場合の例
※乗車位置情報を付加するパラメータ(addChange)にtrueを指定していることが前提です。
■例 A駅 - 路線1 - B駅 - 路線2 - C駅
「A駅」でその位置に乗ると「B駅」での乗り換えに便利な位置を表す情報が「路線1」に付加されます。
「A駅」から「路線1」に乗って「B駅から路線2に乗り換える」という乗り換え先の情報があって、「路線1」の乗車位置情報が決まります。 そのため、「C駅」で乗り換えがない「路線2」には乗車位置の情報は付加されません。
■例 A駅 - 路線1 - B駅
ひとつ前の「A駅 - 路線1 - B駅 - 路線2 - C駅」の例と同様に、「B駅」での乗り換えの情報がないため、「路線1」には乗車位置の情報は付加されません。 つまり、到着駅につながる路線には、乗車位置の情報は付加されません。
■例 A駅 - 路線1 - B駅 - 徒歩 - C駅
「B駅」での乗り換え先の区間は「徒歩」なので、「路線1」には乗車位置の情報は付加されません。
乗り換え先路線の行き先方面について
次の路線への乗り換えに便利な乗車位置情報は、乗り換え先路線の行き先方面によって変わります。
乗り換え先路線の行き先方面がない場合は、行き先方面に関わらず乗り換えに便利な乗車位置情報は同じです。
乗り換え手段について
次の路線への乗り換え手段を持つ車両情報によって、次の路線への乗り換えに便利な乗車位置情報を表します。
なお、車両に対して乗り換え手段が複数存在する場合もあります。
具体的な乗り換え手段は乗り換え手段種別を参照してください。
また、乗り換え手段が存在しない(つまり、便利ではない)場合は、乗り換え手段のない車両情報のみが返ります。
レスポンス例
※レスポンス例はサンプルです。実際の返却値とは異なる場合があります。
渋谷から九段下経由で馬喰横山までの経路を探索した場合
GET /v1/json/search/course/extreme?key=アクセスキーを入力してください&viaList=22715:22645:22919&time=1500&addChange=true
{
"ResultSet": {
"Course": [
{
"Route": {
"Line": [
{
"Name": "東京メトロ半蔵門線急行・久喜行",
// `Change` の値には、乗り換え後の路線の行き先の方面ごとの情報が返却されます。
// 行き先の方面が複数存在する場合、 `Change` の値はオブジェクトの配列になります。
// 行き先の方面が1つだけの場合、 `Change` の値はオブジェクトになります。
"Change": [
{
"openSide": "左",
"nextLineDirection": "新宿方面",
// `Formation` の値には、車両編成ごとの情報が返却されます。
// 車両編成が複数存在する場合、 `Formation` の値はオブジェクトの配列になります。
// 車両編成が1つだけの場合、 `Formation` の値はオブジェクトになります。
"Formation": {
"number": "10",
// `Car` の値は車両ごとの乗り換え手段を表します。
// 列車が2両編成より長い場合、 `Car` の値はオブジェクトの配列になります。
// 列車が1両編成の場合、 `Car` の値はオブジェクトになります。
// 配列の0番目は先頭車両(1両目)を表します。
// `Car / number` は進行方向によらない車両の絶対的な数え方を表します。
// この例における `Car` の0番目のデータは、この車両は1号車であり、進行方向が逆になっても1号車であることは変わらないことを意味します。
"Car": [
{ "number": "1" },
{ "number": "2" },
{ "number": "3" },
{
"number": "4",
"Means": { "Type": "platform" }
},
{
"number": "5",
"Means": { "Type": "platform" }
},
{
"number": "6",
"Means": { "Type": "platform" }
},
{ "number": "7" },
{ "number": "8" },
{ "number": "9" },
{ "number": "10" }
]
}
},
{
"openSide": "左",
"nextLineDirection": "本八幡方面",
"Formation": {
"number": "10",
"Car": [
{ "number": "1" },
// `Means`は乗り換え手段を表します。
// このオブジェクトは、2両目(2号車)に乗るとエレベーターに近い位置になることを表します。
{
"number": "2",
"Means": { "Type": "elevator" }
},
// `Means`は配列になることもあります。
// このオブジェクトは、3両目(3号車)に乗ると階段とエスカレーターに近い位置になることを表します。
{
"number": "3",
"Means": [
{ "Type": "stairs" },
{ "Type": "escalator" }
]
},
{ "number": "4" },
{ "number": "5" },
{
"number": "6",
"Means": [
{ "Type": "stairs" },
{ "Type": "escalator" }
]
},
{ "number": "7" },
{ "number": "8" },
{
"number": "9",
"Means": [
{ "Type": "stairs" },
{ "Type": "escalator" }
]
},
{ "number": "10" }
]
}
}
]
// ...
},
{
"Name": "都営新宿線・本八幡行",
// ...
}
]
}
}
]
}
}
白山(東京都)から神保町経由で青山一丁目までの経路を探索した場合
GET /v1/json/search/course/extreme?key=アクセスキーを入力してください&viaList=22897:22756:22484&time=1500&addChange=true
{
"ResultSet": {
"Course": [
{
"Route": {
// ...
"Line": [
{
"Name": "都営三田線急行・海老名行",
// この例では、乗り換え後の路線の行き先の方面による違いは無いため、 `Change` の情報が1つだけ返ります。
"Change": {
"openSide": "右",
// この例では、7両編成と8両編成の2つの車両編成が存在するため、 `Formation` の値はオブジェクトの配列になります。
"Formation": [
{
"number": "6",
// `Car` の値は車両ごとの乗り換え手段を表します。
"Car": [
{ "number": "6" },
{ "number": "5" },
{
"number": "4",
"Means": { "Type": "escalator" }
},
{
"number": "3",
"Means": { "Type": "stairs" }
},
{ "number": "2" },
{
"number": "1",
"Means": { "Type": "elevator" }
}
]
},
{
"number": "8",
"Car": [
{ "number": "8" },
{ "number": "7" },
{ "number": "6" },
{ "number": "5" },
{
"number": "4",
"Means": { "Type": "escalator" }
},
{
"number": "3",
"Means": { "Type": "stairs" }
},
{ "number": "2" },
{
"number": "1",
"Means": { "Type": "elevator" }
}
]
}
]
}
},
{
"Name": "東京メトロ半蔵門線準急・中央林間行",
// ...
}
]
}
},
// ...
]
}
}
赤羽から新宿経由で高円寺までの経路を探索した場合
列車の編成両数が分かる区間の場合、その編成両数に応じた乗車位置情報が返却されます。
GET /v1/json/search/course/extreme?addChange=true&viaList=22487:22741:22671&time=1600&key=アクセスキーを入力してください
{
"ResultSet": {
"apiVersion": "1.27.0.0",
"engineVersion": "202507_01a",
"Course": [
{
"Route": {
// ...
"Line": [
{
// 列車の編成数が分かる区間だった場合、cars属性が返却される（このLineオブジェクトでは、15両編成）
"cars": "15",
"Name": "ＪＲ湘南新宿ライン快速・平塚行",
"Change": {
"openSide": "右",
// 湘南新宿ラインには10両編成と15両編成が存在するが、cars属性の値と一致する乗車位置情報が返却される。(このFormation要素では、15両編成)
"Formation": {
"number": "15",
"Car": [
{ "number": "1" },
{ "number": "2" },
{ "number": "3" },
{ "number": "4" },
{ "number": "5" },
{ "number": "6" },
{ "number": "7" },
{ "number": "8" },
{ "number": "9" },
{
"number": "10",
"Means": { "Type": "stairs" }
},
{
"number": "11",
"Means": { "Type": "elevator" }
},
{ "number": "12" },
{
"number": "13",
"Means": [
{ "Type": "stairs" },
{ "Type": "escalator" }
]
},
{ "number": "14" },
{
"number": "15",
"Means": { "Type": "stairs" }
}
]
}
}
},
{
"Name": "ＪＲ中央線快速・高尾行",
// ...
}
]
}
},
// ...
]
}
}