探索条件生成

リクエストパラメータを元に、経路探索に利用する条件を生成します。 detailの指定がない場合は、デフォルトの条件を元に探索条件を生成します。 detailを指定した場合は、detailの値に対して指定パラメータの値を置き換えます。つまり、前回生成した詳細条件探索データの一部を変更したものを取得できます。

GET /v1/{format}/toolbox/course/condition

parameters

Name Type Description
format string レスポンスのデータ形式の指定。必須
指定できる値:
- xml: xml形式のデータ
- json: json形式のデータ
key string アクセスキー 。必須
detail string 詳細探索条件データ。省略可
Default: T3221233232319:F3321122120:A23121141:
plane string 飛行機。省略可。
指定できる値:
- light:気軽に利用 ※探索種別がplain以外の場合、normalを指定した時と同じ挙動となります。
- normal:普通に利用
- bit:極力利用しない ※探索種別がplain以外の場合、neverを指定した時と同じ挙動となります。
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
shinkansen string 新幹線。省略可
指定できる値:
- normal:利用する
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
shinkansenNozomi string 新幹線のぞみ。省略可
指定できる値:
- normal:利用する
- never:利用しない
Defailt:normal (detailパラメータ指定時はdetailの値)
sleeperTrain string 寝台列車。省略可。
指定できる値:
- possible:極力利用する ※探索種別がplain以外の場合、normalを指定した時と同じ挙動となります。
- normal:普通に利用
- never:利用しない
Defailt:never (detailパラメータ指定時はdetailの値)
limitedExpress string 有料特急。省略可
指定できる値:
- normal:利用する
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
highwayBus string 高速バス。省略可。
指定できる値:
- light:気軽に利用
- normal:普通に利用
- bit:極力利用しない ※探索種別がplain以外の場合、neverを指定した時と同じ挙動となります。
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
connectionBus string 連絡バス 。省略可。
指定できる値:
- light:気軽に利用 ※探索種別がplain以外の場合、normalを指定した時と同じ挙動となります。
- normal:普通に利用
- bit:極力利用しない ※探索種別がplain以外の場合、neverを指定した時と同じ挙動となります。
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
localBus string 路線バス 。省略可
指定できる値:
- normal:利用する
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
midnightBus string 深夜急行バス 。探索種別がplainの場合無効。省略可
指定できる値:
- normal:利用する
- never:利用しない
Default: never (detailパラメータ指定時はdetailの値)
ship string 船 。省略可。
指定できる値:
- light:気軽に利用 ※探索種別がplain以外の場合、normalを指定した時と同じ挙動となります。
- normal:普通に利用
- bit:極力利用しない ※探索種別がplain以外の場合、neverを指定した時と同じ挙動となります。
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
liner string 有料普通列車。探索種別がplainの場合無効。省略可
指定できる値:
- normal:利用する
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
walk string 駅間徒歩。 探索種別がplainの場合のみ有効。省略可
指定できる値:
- normal:気にならない
- little:少し気になる
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
useJR string JR路線。探索種別がplainの場合のみ有効。省略可
指定できる値:
- light:気軽に利用
- normal:普通に利用
- bit:極力利用しない
Default: normal (detailパラメータ指定時はdetailの値)
transfer string 乗換え。探索種別がplainの場合のみ有効。省略可
指定できる値:
- normal:気にならない
- little:少し気になる
- never:利用しない
Default: normal (detailパラメータ指定時はdetailの値)
waitAverageTime string 出発駅乗車待ち平均時間の利用。探索種別がplainの場合のみ有効。省略可
指定できる値:
- true:平均待ち時間を利用する
- false:待ち時間なし
Default: true (detailパラメータ指定時はdetailの値)
expressStartingStation string 特急始発駅。探索種別がplainの場合にのみ有効。省略可
指定できる値:
- possible:なるべく利用
- normal:普通に利用
Default: normal (detailパラメータ指定時はdetailの値)
localBusOnly string 路線バスのみ探索。探索種別がplainの場合にのみ有効。省略可
指定できる値:
- true:する
- false:しない
Default: false (detailパラメータ指定時はdetailの値)
transferTime string 乗換え時間。探索種別がplainの場合は無効。省略可
指定できる値:
- normal:駅すぱあとの規定値
- moreMargin:規定値より少し余裕をみる
- mostMargin:規定値より余裕をみる
- lessMargin:規定値より短い時間にする
Default: normal (detailパラメータ指定時はdetailの値)
fuzzyLine string 平均路線名あいまい指定。探索種別がplainの場合にのみ有効。省略可
指定できる値:
- true:あいまいに行う
- false:厳格に行う
Default: false (detailパラメータ指定時はdetailの値)
entryPathBehavior string 経路を加工する際に、経由駅を継承する。省略可
指定できる値:
- true:する
- false:しない
Default: false (detailパラメータ指定時はdetailの値)
詳しくはこちらを参照。
surchargeKind string 特急料金種別希望初期値。省略可
指定できる値:
- free:自由席
- reserved:指定席
- green:グリーン
Default: free (detailパラメータ指定時はdetailの値)
teikiKind string 定期種別初期値。省略可
指定できる値:
- bussiness:通勤
- highSchool:学割 (高校)
- university:学割
Default: bussiness (detailパラメータ指定時はdetailの値)
JRSeasonalRate string JR季節料金。省略可
指定できる値:
- true:繁忙期・閑散期の季節料金を考慮する
- false:無視する
Default: true (detailパラメータ指定時はdetailの値)
studentDiscount string 学割乗車券。省略可
指定できる値:
- true:計算する
- false:計算しない
Default: false (detailパラメータ指定時はdetailの値)
airFare string 航空運賃の指定。省略可
指定できる値:
- normal:常に普通運賃を採用
- tokuwari:特定便割引を極力採用
Default: tokuwari (detailパラメータ指定時はdetailの値)
includeInsurance string 航空保険特別料金。省略可
指定できる値:
- true:運賃に含む
- false:運賃に含まない
Default: true (detailパラメータ指定時はdetailの値)
ticketSystemType string 乗車券計算のシステム。省略可
指定できる値:
- normal:普通乗車券のみ計算する
- ic:ICカード乗車券も計算する
Default: normal (detailパラメータ指定時はdetailの値)
preferredTicketOrder string 優先する乗車券の順序。乗車券計算のシステムに"ic"を設定した場合のみ有効。省略可
指定できる値:
- none:指定なし
- normal:普通乗車券を優先する
- ic:ICカード乗車券を優先する
- cheap:安い乗車券を優先する
Default: none (detailパラメータ指定時はdetailの値)
nikukanteiki string 二区間定期の利用。省略可
指定できる値:
- true:利用する
- false:利用しない
Default: false (detailパラメータ指定時はdetailの値)

entryPathBehavior

経路を加工する際に、経由駅指定を継承させたい場合に利用します。 再現もしくは定期・列車割り当てを利用して「次のダイヤを割り当てる」などの経路の加工を行った場合、経路の最適化により経由駅を含む冗長な区間が削除される可能性があります。 entryPathBehavior=trueを指定した詳細探索条件を探索時に利用することで、経路を加工する際に経由駅指定が継承される探索結果を得られます。

response

Name Description
ResultSet レスポンスの最下部を表す要素
ResultSet / apiVersion WebAPIバージョン
ResultSet / engineVersion エンジンバージョン
ResultSet / Condition 詳細探索条件を表す要素

example

GET /v1/xml/toolbox/course/condition?key=アクセスキーを入力してください&plane=normal&walk=little
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
  <Condition>T3221233232219:F3321122120:A23121141:</Condition>
</ResultSet>
GET /v1/json/toolbox/course/condition?key=アクセスキーを入力してください&plane=normal&walk=little
{
  "ResultSet": {
    "apiVersion": "1.14.0.0",
    "engineVersion": "201404_01a",
    "Condition": "T3221233232219:F3321122120:A23121141:"
  }
}