経路簡易探索

条件の指定を簡易的に行える経路探索です。

GET /v1/{format}/search/course

parameters

Name Type Description
format string レスポンスのデータ形式の指定。必須
指定できる値:
- xml: xml形式のデータ
- json: json形式のデータ
key string アクセスキー 。必須
from string 出発駅。駅コード駅の名称座標情報、 地点データ が指定可能です。必須
Example: 22828
to string 到着駅。駅コード駅の名称座標情報、 地点データ が指定可能です。必須
Example: 35.162151120836,136.889373779296,wgs84,100
via string 経由駅。駅コード駅の名称座標情報が指定可能です。座標情報を指定した場合は、座標から最も近い駅を指定したものとみなします。省略可
Example: 22828
date int 探索日付。省略可
Format: YYYYMMDD
Default: 現在日付
time int 探索時刻。省略可
Format: HHMM
Default: 現在時刻
searchType string 探索種別。省略可
Default: departure
plane string 飛行機。省略可
指定できる値:
- true: 利用する
- false: 利用しない
Default: true
shinkansen string 新幹線(のぞみ含む)。省略可
指定できる値:
- true: 利用する
- false: 利用しない
Default: true
limitedExpress string 特急。省略可
指定できる値:
- true: 利用する
- false: 利用しない
Default: true
bus string バス(路線バス・高速バス)。省略可
指定できる値:
- true: 利用する
- false: 利用しない
Default: true
gcs string リクエストやレスポンスに座標が含まれる場合、座標の測地系を指定することができます。また、リクエストパラメータの座標情報はgcsパラメータとは別の測地系を個別に指定可能です。省略可
指定できる値:
- tokyo: 日本測地系
- wgs84: 世界測地系
Default: tokyo

response

経路探索と同等。

example

GET /v1/xml/search/course?key=アクセスキーを入力してください&from=22828&to=25853
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
  <Course searchType="departure" dataType="onTimetable">
    <Route index="1" timeOnBoard="157" timeWalk="0" timeOther="7" transferCount="1" distance="5564" exhaustCO2="10571" exhaustCO2atPassengerCar="93475">
      <Point index="1">
        <Prefecture code="13">
          <Name>東京都</Name>
        </Prefecture>
        <GeoPoint gcs="tokyo" lati_d="35.678082" longi_d="139.770443" lati="35.40.41.9" longi="139.46.13.59"/>
        <Station code="22828">
          <Name>東京</Name>
          <Yomi>とうきょう</Yomi>
          <Type>train</Type>
        </Station>
      </Point>
      <Line index="1" fareIndex="1" chargeIndex="2" timeOnBoard="153" distance="5526" stopStationCount="4" exhaustCO2="10499" exhaustCO2atPassengerCar="92836">
        <Name>JR新幹線のぞみ</Name>
        <Type detail="shinkansen">train</Type>
        <Number>117</Number>
        <Color>051102255</Color>
        <DepartureState no="16">
          <Type>normal</Type>
          <Datetime operation="today">2014-03-24T15:50:00+09:00</Datetime>
        </DepartureState>
        <ArrivalState no="21">
          <Type>normal</Type>
          <Datetime operation="today">2014-03-24T18:23:00+09:00</Datetime>
        </ArrivalState>
        <TimeReliability>onTimetable</TimeReliability>
        <Destination>広島</Destination>
      </Line>
      <Point index="2">
        <Prefecture code="27">
          <Name>大阪府</Name>
        </Prefecture>
        <GeoPoint gcs="tokyo" lati_d="34.729999" longi_d="135.502777" lati="34.43.48.0" longi="135.30.10.0"/>
        <Station code="25978">
          <Name>新大阪</Name>
          <Yomi>しんおおさか</Yomi>
          <Type>train</Type>
        </Station>
      </Point>
      <Line index="2" fareIndex="1" timeOnBoard="4" distance="38" stopStationCount="0" exhaustCO2="72" exhaustCO2atPassengerCar="638">
        <Name>JR東海道本線快速・姫路行</Name>
        <Type>train</Type>
        <Color>133165064</Color>
        <DepartureState no="16">
          <Type>normal</Type>
          <Datetime operation="today">2014-03-24T18:30:00+09:00</Datetime>
        </DepartureState>
        <ArrivalState no="5">
          <Type>normal</Type>
          <Datetime operation="today">2014-03-24T18:34:00+09:00</Datetime>
        </ArrivalState>
        <TimeReliability>onTimetable</TimeReliability>
        <Destination>姫路</Destination>
      </Line>
      <Point index="3">
        <Prefecture code="27">
          <Name>大阪府</Name>
        </Prefecture>
        <GeoPoint gcs="tokyo" lati_d="34.698721" longi_d="135.497943" lati="34.41.55.39" longi="135.29.52.59"/>
        <Station code="25853">
          <Name>大阪</Name>
          <Yomi>おおさか</Yomi>
          <Type>train</Type>
        </Station>
      </Point>
    </Route>
    <Price kind="FareSummary">
      <Oneway>8510</Oneway>
      <Round>17020</Round>
    </Price>
    <Price kind="Fare" index="1" fromLineIndex="1" toLineIndex="2" fareRevisionStatus="none" selected="true">
      <Oneway>8510</Oneway>
      <Round>17020</Round>
      <Type>Fare</Type>
    </Price>
    <Price kind="ChargeSummary">
      <Oneway>4730</Oneway>
      <Round>9460</Round>
    </Price>
    <Price kind="Charge" index="1" fromLineIndex="1" toLineIndex="1" fareRevisionStatus="none" selected="false">
      <Oneway>5740</Oneway>
      <Round>11480</Round>
      <Name>指定席</Name>
      <Type>Reserved</Type>
      <Rate area="Main">High</Rate>
    </Price>
    <Price kind="Charge" index="2" fromLineIndex="1" toLineIndex="1" fareRevisionStatus="none" selected="true">
      <Oneway>4730</Oneway>
      <Round>9460</Round>
      <Name>自由席</Name>
      <Type>Free</Type>
    </Price>
    <Price>
    :
    </Price>
    <SerializeData>SHlUczAxLjAwLjA0rAQBAAAAJFEzAQIAAQAAAAEAAgAAAAgAAf9_Av_3AwAAAAAAAAACACxZAAB6ZQAA_WQAAAAAAAAKAIEAAABY0AABAAYkUTMBtgMAAE8EAAAKAIEAAAA8AQAUABUkUTMBVgQAAFoEAAACAAEAAQABAAEAAQAAAAAAAQABAAIAAAA*--T3221233232319:F3321122120:A23121141:--78776c0c356e89068a8c85d3eb4b4acec81a7a63</SerializeData>
  </Course>
  <Course>
  :
  </Course>
</ResultSet>
GET /v1/json/search/course?key=アクセスキーを入力してください&from=22828&to=25853
{
  "ResultSet": {
    "apiVersion": "1.14.0.0",
    "engineVersion": "201404_01a",
    "Course": [
      {
        "searchType": "departure",
        "dataType": "onTimetable",
        "Route": {
          "timeOnBoard": "157",
          "timeWalk": "0",
          "timeOther": "7",
          "transferCount": "1",
          "distance": "5564",
          "exhaustCO2": "10571",
          "exhaustCO2atPassengerCar": "93475",
          "Point": [
            {
              "Prefecture": {
                "code": "13",
                "Name": "東京都"
              },
              "GeoPoint": {
                "gcs": "tokyo",
                "lati_d": "35.678082",
                "longi_d": "139.770443",
                "lati": "35.40.41.9",
                "longi": "139.46.13.59"
              },
              "Station": {
                "code": "22828",
                "Name": "東京",
                "Yomi": "とうきょう",
                "Type": "train"
              }
            },
            {
              "Prefecture": {
                "code": "27",
                "Name": "大阪府"
              },
              "GeoPoint": {
                "gcs": "tokyo",
                "lati_d": "34.729999",
                "longi_d": "135.502777",
                "lati": "34.43.48.0",
                "longi": "135.30.10.0"
              },
              "Station": {
                "code": "25978",
                "Name": "新大阪",
                "Yomi": "しんおおさか",
                "Type": "train"
              }
            },
            {
              "Prefecture": {
                "code": "27",
                "Name": "大阪府"
              },
              "GeoPoint": {
                "gcs": "tokyo",
                "lati_d": "34.698721",
                "longi_d": "135.497943",
                "lati": "34.41.55.39",
                "longi": "135.29.52.59"
              },
              "Station": {
                "code": "25853",
                "Name": "大阪",
                "Yomi": "おおさか",
                "Type": "train"
              }
            }
          ],
          "Line": [
            {
              "fareIndex": "1",
              "chargeIndex": "2",
              "timeOnBoard": "153",
              "distance": "5526",
              "stopStationCount": "4",
              "exhaustCO2": "10499",
              "exhaustCO2atPassengerCar": "92836",
              "Name": "JR新幹線のぞみ",
              "Type": {
                "text": "train",
                "detail": "shinkansen"
              },
              "Number": "117",
              "Color": "051102255",
              "DepartureState": {
                "no": "16",
                "Type": "normal",
                "Datetime": {
                  "text": "2014-03-24T15:50:00+09:00",
                  "operation": "today"
                }
              },
              "ArrivalState": {
                "no": "21",
                "Type": "normal",
                "Datetime": {
                  "text": "2014-03-24T18:23:00+09:00",
                  "operation": "today"
                }
              },
              "TimeReliability": "onTimetable",
              "Destination": "広島"
            },
            {
              "fareIndex": "1",
              "timeOnBoard": "4",
              "distance": "38",
              "stopStationCount": "0",
              "exhaustCO2": "72",
              "exhaustCO2atPassengerCar": "638",
              "Name": "JR東海道本線快速・姫路行",
              "Type": "train",
              "Color": "133165064",
              "DepartureState": {
                "no": "16",
                "Type": "normal",
                "Datetime": {
                  "text": "2014-03-24T18:30:00+09:00",
                  "operation": "today"
                }
              },
              "ArrivalState": {
                "no": "5",
                "Type": "normal",
                "Datetime": {
                  "text": "2014-03-24T18:34:00+09:00",
                  "operation": "today"
                }
              },
              "TimeReliability": "onTimetable",
              "Destination": "姫路"
            }
          ]
        },
        "Price": [
          {
            "kind": "FareSummary",
            "Oneway": "8510",
            "Round": "17020"
          },
          {
            "kind": "Fare",
            "index": "1",
            "fromLineIndex": "1",
            "toLineIndex": "2",
            "fareRevisionStatus": "none",
            "selected": "true",
            "Oneway": "8510",
            "Round": "17020",
            "Type": "Fare"
          },
          {
            "kind": "ChargeSummary",
            "Oneway": "4730",
            "Round": "9460"
          },
          {
            "kind": "Charge",
            "index": "1",
            "fromLineIndex": "1",
            "toLineIndex": "1",
            "fareRevisionStatus": "none",
            "selected": "false",
            "Oneway": "5740",
            "Round": "11480",
            "Name": "指定席",
            "Type": "Reserved",
            "Rate": {
              "text": "High",
              "area": "Main"
            }
          },
          {
            "kind": "Charge",
            "index": "2",
            "fromLineIndex": "1",
            "toLineIndex": "1",
            "fareRevisionStatus": "none",
            "selected": "true",
            "Oneway": "4730",
            "Round": "9460",
            "Name": "自由席",
            "Type": "Free"
          },
          {
            :
          }
        ],
        "SerializeData": "SHlUczAxLjAwLjA0rAQBAAAAJFEzAQIAAQAAAAEAAgAAAAgAAf9_Av_3AwAAAAAAAAACACxZAAB6ZQAA_WQAAAAAAAAKAIEAAABY0AABAAYkUTMBtgMAAE8EAAAKAIEAAAA8AQAUABUkUTMBVgQAAFoEAAACAAEAAQABAAEAAQAAAAAAAQABAAIAAAA*--T3221233232319:F3321122120:A23121141:--78776c0c356e89068a8c85d3eb4b4acec81a7a63"
      },
      {
        :
      }
    ]
  }
}