乗り換えルート検索

API名: 
jorudan/transit
概要: 
リクエストパラメータで指定される出発駅名、到着駅名、経由駅名指定、と検索オプションを受け取り、 0個以上の乗換ルート情報を返却します。 また定期券計算にも対応しております。

※この機能を利用するには別途契約が必要です。
※定期券計算及び時刻表連動の利用には
別途契約が必要です。

URI: 

http://core.its-mo.com/zmaps/api/apicore/core/v1_0/jorudan/transit

<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/jorudan/transit?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&from=東京&to=品川

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
from - 出発駅名
出発駅名を指定します。
駅名検索で返却された結果を利用してください。
本項目は必須項目であるため、未指定の場合はエラーとなります。
to - 到着駅名
到着駅名を指定指定います。
駅名検索で返却された結果を利用してください。
本項目は必須項目であるため、未指定の場合はエラーとなります。
via - - 経由駅名指定
経由駅名を指定します。
複数指定できます。
上限は4駅までです。
when - now 時間指定区分
時間指定区分を指定します。
now 現在時刻
departure 出発時刻
arrival 到着時刻
date - 日時指定
日時を指定します。 秒の指定は無視されます。
whenの指定により動作が変わります。
now 本パラメータは無効
departure 出発日時を指定 ※必須項目
arrival 到着日時を指定 ※必須項目

※timetable=Fの場合本項目は無視されます。

transittype   normal 乗り換え条件
乗り換え条件を指定ます。
normal 乗換案内標準
time 時間優先
cost 安さ優先
transifer 乗り換えの少なさ優先
seat   unreserved 特急料金種別
特急料金種別を指定します。
unreserved  乗換案内標準
reserved  時間優先
green  安さ優先
express   F 特急利用指定
100km以内で特急を利用を制限(利用しない)するかを真偽値で指定します。
shape    F 路線形状取得指定
路線形状を取得するかを真偽値で指定します。
※本パラメータを利用する場合は別途契約が必要です。
cnt    3 最大返却数
結果の最大返却数を 1~8 から指定します。
timetable   F 時刻表連動
時刻表連動をするかどうかを真偽値で指定します。
※本パラメータを利用する場合は別途契約が必要です。
teiki_opt     定期代計算指定
定期代計算、定期清算計算を結果に含めるかを指定します。
複数指定できます。
teiki  定期代計算を結果に含める
seisan  定期精算計算を結果に含める(定期区間を考慮した金額が算出されます)

※本パラメータを利用する場合は別途契約が必要です。

teiki_type   business 定期区分
定期区分を指定します
business 通勤定期
college  通学定期(大学)
highschool  通学定期(高校)
juniorhighschool  乗り換えの少なさ優先
green グリーン定期

※クエリパラメータteiki_optにteikiを指定した場合のみ有効となります。

teiki_rosen    定期路線名
定期区間の路線名を指定します。複数指定できます。
teiki_from、teiki_toの指定数と差異がある場合、エラーとなります。
※クエリパラメータteiki_optにseisanが含まれている場合、必須項目となります。
※クエリパラメータteiki_optにseisanを指定した場合のみ有効となります。
teiki_from    定期区間発駅
定期区間の発駅を指定します。複数指定できます。
teiki_rosen、teiki_toの指定数と差異がある場合、エラーとなります。
※クエリパラメータteiki_optにseisanが含まれている場合、必須項目となります。
※クエリパラメータteiki_optにseisanを指定した場合のみ有効となります。
teiki_to   定期区間着駅
定期区間の着駅を指定します。複数指定できます。
teiki_from、teiki_rosenの指定数と差異がある場合、エラーとなります。
※クエリパラメータteiki_optにseisanが含まれている場合、必須項目となります。
※クエリパラメータteiki_optにseisanを指定した場合のみ有効となります。
datum   TOKYO 測地系
返却される住所代表点の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ

出力フォーマット

{"status":{"code":"0000",
           "text":"OK"},
 "routelist":[{"id":"1",
               "transcnt":0,
               "fare":140,
               "ic_fare":133,
               "total_time":4,
               "distance":2000,
               "routestatus":{"hayai":true,
                              "yasui":true,
                              "raku":true,
                              "kuuro":false,
                              "shindai":false,
                              "kousoku":false,
                              "ic_card":true,
                              "norikae":true,
                              "co2":true},
               "routekubun":{"shinkansen":false,
                             "nozomi":false,
                             "tokkyu":false,
                             "shindai":false,
                             "kuuro":false,
                             "bus":false,
                             "kousoku":false,
                             "renraku":false,
                             "shinya":false,
                             "ferry":false,
                             "walk":false,
                             "yuryou":false},
               "path":[{"rosenname":"山手線",
                        "rosentype":"0",
                        "from_info":{"name":"品川",
                                     "date":null,
                                     "point":{"lat":35.6252778,
                                              "lon":139.7416667}},
                        "to_info":{"name":"大崎",
                                   "date":null,
                                   "point":{"lat":35.6163889,
                                            "lon":139.7316667}},
                        "distance":2000,
                        "time_ride":4,
                        "time_move":0,
                        "norikae":false,
                        "norikae_wait":0,
                        "fare_info":{"fare":140,
                                     "tuusan":1,
                                     "green":0},
                        "ic_fare_info":{"fare":133,
                                        "tuusan":1,
                                        "green":0},
                        "linename":null,
                        "linetype":null,
                        "linecolor":{"type":"0",
                                     "rgb":["73c11d"]},
                        "rosencorp":"JR",
                        "buscorp":"",
                        "josyatext":null,
                        "platformfrom":null,
                        "platformto":null,
                        "passingcnt":null,
                        "passing_stations":[],
                        "line":null}]}],
 "teikilist":[],
 "seisanlist":[]}

キー名 データ型 説明
status         object ステータス情報が入ります。
routelist          object 経路検索結果が入ります。検索結果が0件の場合は空の配列となります。
  id       string 経路ID
  transcnt       number 乗換回数
  fare       number 料金(合計金額 円単位)
  ic_fare       number IC料金(IC利用時の合計額 円単位)
  total_time       number 所用時間(分単位)
  distance       number 総距離(m単位)
  routestatus       object 経路内の評価情報が入ります。
    hayai     boolean 結果の中で最も所要時間が短い場合はtrue, そうでない場合はfalse。不明の場合はnullとなる。
    yasui     boolean 結果の中で最も費用が安い場合はtrue, そうでない場合はfalse。不明の場合はnullとなる。
    raku     boolean  結果の中で最も路線数が少ない場合はtrue, そうでない場合はfalse。不明の場合はnullとなる。
    kuuro     boolean 結果に飛行機を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    shindai     boolean 結果に寝台列車を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    kousoku     boolean 結果に高速バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    ic_card     boolean IC カードを使用した際に異なる運賃がある場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    norikae     boolean 結果の中で最も乗換時間が短い場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    co2     boolean 結果の中で最もCO2 排出量が少ない場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
  routekubun       object 経路内の区分情報が入ります。
    shinkansen     boolean 結果に新幹線を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    nozomi     boolean 結果に新幹線のぞみを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    tokkyu     boolean 結果に有料特急列車を含む場合true,そうでない場合はfalse。不明の場合はnullとなる。
    shindai     boolean 結果に寝台列車を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    kuuro     boolean 結果に空路を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    bus     boolean 結果に路線バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    kousoku     boolean 結果に高速バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    renraku     boolean 結果に連絡バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    shinya     boolean 結果に深夜急行バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    ferry     boolean 結果に航路を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    walk     boolean 結果に徒歩を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    yuryou     boolean 結果に有料普通列車を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
  path       array 路線ごとの情報が入ります。
    rosenname     string 路線名
    rosentype     string 路線種別
0 JR在来線
1 私鉄在来線
2 地下鉄
3 路面電車
4 徒歩
5 バス
6 飛行機
7
8 有料特急列車
9 新幹線
10 寝台列車
11 有料急行列車
12 高速バス
13 自動車
14 空港連絡バス
    from_info     object 出発情報が入ります。
      name   string 出発地名称
      date   string 出発時間 (YYYYMMDDhhmm形式)。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
      point   object 形状ポリラインデータが入ります。
    to_info     object 到着情報が入ります。
      name   string 到着地名称
      date   string 到着時間 (YYYYMMDDhhmm形式)。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
      point   object 形状ポリラインデータが入ります。
    distance     number 距離(m単位)
    time_ride     number 乗車時間(分単位)
    time_move     number 移動時間(分単位)
    norikae     number 乗換の場合はtrue,そうでない場合(乗換無し、直通など)はfalse。不明の場合はnullとなる。
    norikae_wait     number 乗換待ち時間(分単位)
    fare_info     object 料金情報が入ります。
      fare   number 料金(円単位)
      tuusan   number 運賃ID。この値の同じ範囲が運賃の有効範囲となります。
0 金額なし
1 ~ 運賃ID
84 定期精算区間
      green   number 特急料金内のグリーン席分の料金。
    ic_fare_info     object IC料金情報が入ります。
      fare   number IC料金(円単位) 不明な場合nullとなります。
      tuusan   number 運賃ID。この値の同じ範囲が運賃の有効範囲となります。
0 金額なし
1 ~ 運賃ID
84 定期精算区間
      green   number 特急料金内のグリーン席分のIC料金。
    linename     string 列車名。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    linetype     string 列車種別。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    linecolor     object 路線色情報が入ります。
      type   string 路線色種別
0 通常
横じま
      rgb   array 路線色rgbの配列(複数の色が入る場合があります)
    rosencorp     string 路線の会社略称
    buscorp     string バス会社名。バス以外の場合nullとなります。
    josyatext     string 乗車位置情報。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    platformfrom     string 発番線。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    platformto     string 着番線。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    passingcnt     number 途中停車駅数 時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    passing_stations     object 停車駅リストの配列となります。時刻表連動(クエリパラメータ timetable)にFを指定した場合空配列となります。
      arrive_time   string 停車駅到着時刻 hhmm形式
      name   string 停車駅名称
    line     object 経路形状情報。クエリパラメータshapeにFを指定した場合はnullとなります。
※路線形状は電車のみ対応されています。電車以外はnullとなります。
teikilist         array 定期代計算の結果が経路分入ります。
検索結果が0件の場合は空の配列となります。
クエリパラメータteiki_optにteikiを指定した場合のみ出力されます。指定されていない場合、空の配列となります。
  id       string 経路ID
  path       array 路線ごとの定期代計算情報が入ります。
    rosenname     string 路線名
    rosentype     string 路線種別
0 JR在来線
1 私鉄在来線
2 地下鉄
3 路面電車
4 徒歩
5 バス
6 飛行機
7
8 有料特急列車
9 新幹線
10 寝台列車
11 有料急行列車
12 高速バス
13 自動車
14 空港連絡バス
    from_name     string 発駅名
    to_name     string 着駅名
    price1     number 1ヶ月の定期代。不明の場合はnullとなります。
    price3     number 3ヶ月の定期代。不明の場合はnullとなります。
    price6     number 6ヶ月の定期代。不明の場合はnullとなります。
    tuusan     number 定期運賃通算ID。
この値の同じ範囲が金額の有効範囲となります。
seisanlist         array 定期精算計算の結果が経路分入ります。
クエリパラメータteiki_optにseisanを指定した場合のみ出力されます。指定されていない場合、空の配列となります。
  id       string 経路ID
  transcnt       number 乗換回数
  fare       number 料金(合計金額 円単位)
  ic_fare       number IC料金(IC利用時の合計額 円単位)
  total_time       number 所用時間(分単位)
  distance       number 総距離(m単位)
  routestatus       object 経路内の評価情報が入ります。
    hayai     boolean 結果の中で最も所要時間が短い場合はtrue, そうでない場合はfalse。不明の場合はnullとなる。
    yasui     boolean 結果の中で最も費用が安い場合はtrue, そうでない場合はfalse。不明の場合はnullとなる。
    raku     boolean 結果の中で最も路線数が少ない場合はtrue, そうでない場合はfalse。不明の場合はnullとなる。
    kuuro     boolean 結果に飛行機を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    shindai     boolean 結果に寝台列車を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    kousoku     boolean 結果に高速バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    ic_card     boolean IC カードを使用した際に異なる運賃がある場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    norikae     boolean 結果の中で最も乗換時間が短い場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    co2     boolean 結果の中で最もCO2 排出量が少ない場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
  routekubun       object 経路内の区分情報が入ります。
    shinkansen     boolean 結果に新幹線を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    nozomi     boolean 結果に新幹線のぞみを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    tokkyu     boolean 結果に有料特急列車を含む場合true,そうでない場合はfalse。不明の場合はnullとなる。
    shindai     boolean 結果に寝台列車を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    kuuro     boolean 結果に空路を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    bus     boolean 結果に路線バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    kousoku     boolean 結果に高速バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    renraku     boolean 結果に連絡バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    shinya     boolean 結果に深夜急行バスを含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    ferry     boolean 結果に航路を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    walk     boolean 結果に徒歩を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
    yuryou     boolean 結果に有料普通列車を含む場合はtrue,そうでない場合はfalse。不明の場合はnullとなる。
  path       array 路線ごとの情報が入ります。
    rosenname     string 路線名
    rosentype     string 路線種別
0 JR在来線
1 私鉄在来線
2 地下鉄
3 路面電車
4 徒歩
5 バス
6 飛行機
7
8 有料特急列車
9 新幹線
10 寝台列車
11 有料急行列車
12 高速バス
13 自動車
14 空港連絡バス
    from_info     object 出発情報が入ります。
      name   string 出発地名称
      date   string 出発時間 (YYYYMMDDhhmm形式)。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
      point   object 形状ポリラインデータが入ります。
    to_info     object 到着情報が入ります。
      name   string 到着地名称
      date   string 到着時間 (YYYYMMDDhhmm形式)。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
      point   object 形状ポリラインデータが入ります。
    distance     number 距離(m単位)
    time_ride     number 乗車時間(分単位)
    time_move     number 移動時間(分単位)
    norikae     boolean 乗換の場合はtrue,そうでない場合(乗換無し、直通など)はfalse。不明の場合はnullとなる。
    norikae_wait     number 乗換待ち時間(分単位)
    fare_info     object 料金情報が入ります。
      fare   number 料金(円単位)
      tuusan   number 運賃ID。この値の同じ範囲が運賃の有効範囲となります。
0 金額なし
1 ~ 運賃ID
84 定期精算区間
      green   number 特急料金内のグリーン席分の料金。
    ic_fare_info     object IC料金情報が入ります。
      fare   number IC料金(円単位) 不明な場合nullとなります。
      tuusan   number 運賃ID。この値の同じ範囲が運賃の有効範囲となります。
0 金額なし
1 ~ 運賃ID
84 定期精算区間
      green   number 特急料金内のグリーン席分のIC料金。
    linename     string 列車名。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    linetype     string 列車種別。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    linecolor     object 路線色情報が入ります。
      type   string 路線色種別
0 通常
横じま
      rgb   array 路線色rgbの配列(複数の色が入る場合があります)
    rosencorp     string 路線の会社略称
    buscorp     string バス会社名。バス以外の場合nullとなります。
    josyatext     string 乗車位置情報。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    platformfrom     string 発番線。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    platformto     string 着番線。時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    passingcnt     number 途中停車駅数 時刻表連動(クエリパラメータ timetable)にFを指定した場合nullとなります。
    passing_stations     object 停車駅リストの配列となります。時刻表連動(クエリパラメータ timetable)にFを指定した場合空配列となります。
      arrive_time   string 停車駅到着時刻 hhmm形式
      name   string 停車駅名称
    line     object 経路形状情報。クエリパラメータshapeにFを指定した場合はnullとなります。
※路線形状は電車のみ対応されています。電車以外はnullとなります。
出力例

[通常出力例] http://core.its-mo.com/zmaps/api/apicore/core/v1_0/jorudan/transit?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&from=東京&to=品川

{"status":{"code":"0000",
           "text":"OK"},
 "routelist":[{"id":"1",
               "transcnt":0,
               "fare":140,
               "ic_fare":133,
               "total_time":4,
               "distance":2000,
               "routestatus":{"hayai":true,
                              "yasui":true,
                              "raku":true,
                              "kuuro":false,
                              "shindai":false,
                              "kousoku":false,
                              "ic_card":true,
                              "norikae":true,
                              "co2":true},
               "routekubun":{"shinkansen":false,
                             "nozomi":false,
                             "tokkyu":false,
                             "shindai":false,
                             "kuuro":false,
                             "bus":false,
                             "kousoku":false,
                             "renraku":false,
                             "shinya":false,
                             "ferry":false,
                             "walk":false,
                             "yuryou":false},
               "path":[{"rosenname":"山手線",
                        "rosentype":"0",
                        "from_info":{"name":"品川",
                                     "date":null,
                                     "point":{"lat":35.6252778,
                                              "lon":139.7416667}},
                        "to_info":{"name":"大崎",
                                   "date":null,
                                   "point":{"lat":35.6163889,
                                            "lon":139.7316667}},
                        "distance":2000,
                        "time_ride":4,
                        "time_move":0,
                        "norikae":false,
                        "norikae_wait":0,
                        "fare_info":{"fare":140,
                                     "tuusan":1,
                                     "green":0},
                        "ic_fare_info":{"fare":133,
                                        "tuusan":1,
                                        "green":0},
                        "linename":null,
                        "linetype":null,
                        "linecolor":{"type":"0",
                                     "rgb":["73c11d"]},
                        "rosencorp":"JR",
                        "buscorp":"",
                        "josyatext":null,
                        "platformfrom":null,
                        "platformto":null,
                        "passingcnt":null,
                        "passing_stations":[],
                        "line":null}]}],
 "teikilist":[],
 "seisanlist":[]}

[検索結果が0件の場合]

{"status":{"code":"0000",
           "text":"OK"},
 "routelist":[],
 "teikilist":[],
 "seisanlist":[]}

[検索に失敗した場合]検索に失敗した場合には、ステータスコードが 0000 以外となり、結果が 空配列 となります。

{"status":{"code":2406,
           "text":"経路検索 経路検索失敗"},
 "routelist":[],
 "teikilist":[],
 "seisanlist":[]}