駅簡易情報
指定された条件に当てはまる駅の簡易情報を返します。
このAPIは主に候補駅の確定を想定しているため、必要最低限の簡易データのみ返します。 また、一度に取得できる最大件数は30件です。 候補駅の確定(インクリメンタルサーチ)などで利用される場合、アクセスの回数は最大2回/1秒程度を目安にご利用ください。
GET /v1/{format}/station/light
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
Name | Type | Required | Description |
---|---|---|---|
format | string | ◯ | レスポンスのデータ形式の指定。必須 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
key | string | ◯ | アクセスキーの指定。必須 |
name | string | --- | 候補文字列。codeと排他。かつ省略可なため、codeが存在しない場合はname扱いとなります。 |
nameMatchType | string | --- | nameのマッチング方式の指定。nameパラメータ指定時のみ有効。省略可。 指定できる値: - forward : 前方一致 - partial : 部分一致 Default: forward ※部分一致の場合、名称の末尾に付く括弧内やスラッシュ以降の補足情報はマッチング対象外となります。(例: 「中野(東京都)」の (東京都) 部分、「浦安駅/東京ベイシティバス」の/東京ベイシティバス 部分) |
code | int | --- | 駅コード。nameと排他。 |
type | string | --- | 駅の交通種別。複数指定可。省略可。省略時は指定なしとなります。 |
prefectureCode | string | --- | 都道府県コード。code利用時には無効です。複数指定可。省略可。省略時は全国が対象となります。 |
corporationBind | string | --- | 固定会社名。指定した会社のみ利用します。複数指定可。最大50件。省略可。省略時は制限のない通常の取得となります。 |
communityBus | string | --- | 取得結果の路線バスに対するコミュニティバスの扱いを指定します。type未指定時またはtypeにbusおよびbus.local指定時のみ有効。code, corporationBind 利用時には無効。省略可。 指定できる値: - contain:除外しない - except:除外する Default: contain |
response
Name | Description |
---|---|
ResultSet / apiVersion | WebAPIバージョン |
ResultSet / engineVersion | エンジンバージョン |
ResultSet / Point | 地点を表す要素 |
ResultSet / Point / Prefecture / code | 都道府県コード |
ResultSet / Point / Prefecture / Name | 都道府県の名称 |
ResultSet / Point / Station / code | 駅コード |
ResultSet / Point / Station / Name | 駅の名称 |
ResultSet / Point / Station / Type | 交通種別 |
ResultSet / Point / Station / Type / detail | 交通種別の詳細。複数の場合は: 区切り。 |
ResultSet / Point / Station / Yomi | 読みかな |
example
GET /v1/xml/station/light?key=アクセスキーを入力してください&name=東京
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
<Point>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<Station code="22828">
<Name>東京</Name>
<Yomi>とうきょう</Yomi>
<Type>train</Type>
</Station>
</Point>
<Point>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<Station code="59336">
<Name>東京オペラシティ/京王バス</Name>
<Yomi>とうきょうおぺらしてぃ</Yomi>
<Type detail="local">bus</Type>
</Station>
</Point>
<Point>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<Station code="35724">
<Name>東京オペラシティ南/都営バス</Name>
<Yomi>とうきょうおぺらしてぃみなみ</Yomi>
<Type detail="local">bus</Type>
</Station>
</Point>
<Point>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<Station code="56203">
<Name>東京オペラシティ南/小田急バス</Name>
<Yomi>とうきょうおぺらしてぃみなみ</Yomi>
<Type detail="local">bus</Type>
</Station>
</Point>
<Point>
:
</Point>
</ResultSet>
GET /v1/json/station/light?key=アクセスキーを入力してください&name=東京
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"Point": [
{
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"Station": {
"code": "22828",
"Name": "東京",
"Yomi": "とうきょう",
"Type": "train"
}
},
{
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"Station": {
"code": "59336",
"Name": "東京オペラシティ/京王バス",
"Yomi": "とうきょうおぺらしてぃ",
"Type": {
"text": "bus",
"detail": "local"
}
}
},
{
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"Station": {
"code": "35724",
"Name": "東京オペラシティ南/都営バス",
"Yomi": "とうきょうおぺらしてぃみなみ",
"Type": {
"text": "bus",
"detail": "local"
}
}
},
{
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"Station": {
"code": "56203",
"Name": "東京オペラシティ南/小田急バス",
"Yomi": "とうきょうおぺらしてぃみなみ",
"Type": {
"text": "bus",
"detail": "local"
}
}
},
{
:
}
]
}
}