Search condition generator


 Attention!

This page has not been fully translated into English yet. It is possible that some parts of description may contains old information. Please see Japanese Documents if you need the latest and accurate information.

Returns a string representing conditions of route search which is specified at request parameters. When "detail" parameter is not specified, this API generates a condition string based on default conditions. When "detail" parameter is specified, search conditions specified at other request parameters will be applied to the corresponding "detail" conditions. This means that you can partially modify the previously-created conditions using "detail" parameter.

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

parameters

Name Type Description
format string Specifying the response data format. Required.
Possible values:
- xml: xml format data
- json: json format data.
key string Your access key. Required.
detail string String representing detailed search conditions. Optional.
Default: T32212332323191:F33211221200001:A23121141:
plane string Use of plane. Optional.
Available Values:
- light: Feel free to use. ※When specified search type is not "plain", the value of this parameter will be "normal".
- normal: Use normally.
- bit: Avoid to use as much as possible. ※When specified search type is not "plain", the value of this parameter will be "never".
- never: Never use.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
shinkansen string Use of Shinkansen(Bullet train). Optional.
Available Values:
- normal: Use
- never: Never use
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
shinkansenNozomi string Use of Shinkansen Nozomi. Optional.
Available Values:
- normal: Use
- never: Never use
Defalt: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
sleeperTrain string Use of sleeper train. Optional.
Available Values:
- possible: Preferable. ※When specified search type is not "plain", it will show the same behavior as when speficying normal.
- normal: Use normally.
- never: Never use.
Defalt: never (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
limitedExpress string Use of limited express. Optional.
Available Values:
- normal: Use
- never: Never use
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
highwayBus string Use of highway bus. Optional.
Available Values:
- light: Feel free to use. ※When specified search type is not "plain", the value of this parameter will be "normal".
- normal: Use normally.
- bit: Avoid to use as much as possible. ※When specified search type is not "plain", it will show the same behavior as when specifying never.
- never: Never use.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
connectionBus string Use of connecting bus. Optional.
Available values:
- light: Feel free to use. ※When specified search type is not "plain", the value of this parameter will be "normal".
- normal: Use normally.
- bit: Avoid to use as much as possible. ※When specified search type is not "plain", it will show the same behavior as when specifying never.
- never: Never use.
Default: normal (When "detail" parameter is specified, it is the value of the
localBus string Use of local bus. Optional.
Available Values:
- normal: Use
- never: Never use.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
communityBus string 路線バスに対するコミュニティバスの扱いを指定します。localBusがneverの場合無効。省略可。
指定できる値:
- contain:除外しない
- except:除外する
Default: contain
midnightBus string Use of night express bus. Invalid when search type is "plain". Optional.
Available Values:
- normal: Use
- never: Never use.
Default: never (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
ship string Use of Ship. Optional.
Available Values:
- light: Feel free to use. ※When specified search type is not "plain", the value of this parameter will be "normal".
- normal: Use normally.
- bit: Avoid to use as much as possible. ※When specified search type is not "plain", it will show the same behavior as when specifying never.
- never: Never use.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
liner string Use of fee-charging local train. Invalid when search type is "plain". Optional.
Available Values:
- normal: Use
- never: Never use.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
walk string Walking from station to station. Only valid when search type is "plain". Optional.
Available Values:
- normal: Do not mind
- little: Avoid
- never: Never use.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
useJR string Use of JR line. Only valid when search type is "plain". Optional.
Available Values:
- light: Feel free to use.
- normal: Use normally.
- bit: Avoid to use as much as possible.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
transfer string Transfer of trains. Only valid when search type is "plain". Optional.
Available Values:
- normal: Do not mind
- little: Avoid
- never: Never.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
waitAverageTime string Use of average wait time at the departure station. Only valid when search type is "plain". Optional.
Available Values:
- true: Use average wait time
- false: No wait time
Default: true (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
expressStartingStation string Use of starting station of express train. Only valid when search type is "plain". Optional.
Available Values:
- possible: Preferable
- normal: Use normally.
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
localBusOnly string Search route which uses only local bus. Only valid when search type is "plain". Optional.
Available Values:
- true: Enable
- false: Disable
Default: false (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
transferTime string The time required to transfer train. When search type is plain, it is not valid. Optional.
Available Values:
- normal: standard time defined by Ekispert
- moreMargin: Allow slightly more time than the standard
- mostMargin: Allow more time than the standard
- lessMargin: Reduce more time than the standard
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
fuzzyLine string Whether allowing ambiguous specification of average rail name. Only valid when search type is "plain". Optional.
Available Values:
- true: Search ambiguously
- false: Search strictly
Default: false (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
entryPathBehavior string Keep specification of via-stations when editing the route. Optional.
Available Values:
- true: Enable
- false: Disable
Default: false (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
Please check here for more details.
surchargeKind string Specifying initial value of limited express price type. Optional.
Available Values:
- free: Non-reserved
- reserved: Reserved
- green: Green(first class)
Default: free (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
teikiKind string Specifying initial value of commuter pass type. Optional.
Available Value:
- bussiness: Commute
- highSchool: Student Discount (High School)
- university: Student Discount
Default: bussiness (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
JRSeasonalRate string Considering JR Seasonal Price. Optional.
Available Values:
- true: Consider busy season/off-season
- false: Ignore
Default: true (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
JRReservation string EX予約/スマートEXサービス。studentDiscountと同時指定は不可。経路探索で回数券が指定された場合は、回数券が優先されます。省略可
指定できる値:
- none: 計算しない
EX予約
- exYoyaku: EX予約
- exETokkyu: EX予約(e特急券)
- exHayatoku: EX予約(EX早特)
- exHayatoku1: EX予約(EX早特1)
- exHayatoku21: EX予約(EX早特21)
- exHayatoku28: EX予約(EX早特28)
- exGreenHayatoku: EX予約(EXグリーン早特)
スマートEX
- smartEx: スマートEX
- smartExHayatoku: スマートEX(EX早特)
- smartExHayatoku1: スマートEX(EX早特1)
- smartExHayatoku21: スマートEX(EX早特21)
- smartExHayatoku28: スマートEX(EX早特28)
- smartExGreenHayatoku: スマートEX(EXグリーン早特)
Default: none
shinkansenETicket string 新幹線eチケットサービス。studentDiscountと同時指定は不可。経路探索で回数券が指定された場合は、回数券が優先されます。省略可
指定できる値:
- none: 計算しない
- eTicket: 新幹線eチケット
Default: none
studentDiscount string Considering student discount ticket. JRReservation、shinkansenETicketと同時指定は不可。 Optional.
Available Values:
- true: Do calculate
- false: Do not calculate
Default: false (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
ticketSystemType string Specifying Ticket calculation system. Optional.
Available Values:
- normal:Only calculate normal ticket
- ic: Also calculate IC card ticket
Default: normal (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
preferredTicketOrder string Specifying preferred order of ticket. Only valid when setting "ic" at "ticketSystemType" parameter. Optional.
Available Values:
- none: Do not specify
- normal: Prioritize normal ticket
- ic: Prioritize IC card
- cheap: Prioritize cheap ticket
Default: none (When "detail" parameter is specified, this value will be the same as value specified at "detail" parameter.)
nikukanteiki string 定期券の種類: 二区間定期券」の利用。省略可
指定できる値:
- true:利用する
- false:利用しない
Default: false (detailパラメータ指定時はdetailの値)
offpeakTeiki string オフピーク定期券として計算する。省略可。
指定できる値:
- true:計算する
- false:計算しない
Default: false (detailパラメータ指定時はdetailの値)

※offpeakTeiki=trueを指定した場合、経路探索の結果に定期区間が「オフピーク定期区間かの状態判定」が追加され、オフピーク定期区間の場合は定期代がオフピーク定期券の金額となります。詳しくはオフピーク定期券の定期代を調べるをご確認ください。

entryPathBehavior

This parameter may be used to keep specification of via-stations when editing routes. If you edit the route using route reproduction or cummuter pass / train assginment, e.g. allocating the next timetable, there is a possibility that redundant section including via-stations are deleted for the reason of route optimization. You can keep via-station at result route by using detailed search condition with "entryPathBehavior=true".

response

Name Description
ResultSet Root element of response
ResultSet / apiVersion Web API version
ResultSet / engineVersion Engine version
ResultSet / Condition Element representing detailed search condition

example

GET /v1/xml/toolbox/course/condition?key=your_access_key_here&plane=normal&walk=little
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="202303_01a">
  <Condition>T32212332322191:F33211221200001:A23121141:</Condition>
</ResultSet>
GET /v1/json/toolbox/course/condition?key=your_access_key_here&plane=normal&walk=little
{
  "ResultSet": {
    "apiVersion": "1.27.0.0",
    "engineVersion": "202303_01a",
    "Condition": "T32212332322191:F33211221200001:A23121141:"
  }
}
ページ上部へ