緯度経度からの周辺駅検索
座標から駅の情報を取得します。半径を指定することで中心座標から一定距離の駅を取得します。
GET /v1/{format}/geo/station
parameters
※ Requiredの「△」は、特定の条件においてそのパラメータが必須になることを示します。詳しくはパラメータのDescriptionを参照してください。
Name | Type | Required | Description |
---|---|---|---|
format | string | ◯ | レスポンスのデータ形式の指定。必須 指定できる値: - xml: xml形式のデータ - json: json形式のデータ ※クエリパラメータではなくパスに値を指定します。 |
key | string | ◯ | アクセスキーの指定。必須 |
geoPoint | string | ◯ | 座標情報。必須。半径を指定しない場合は、最寄りの1件のデータを返しますが、取得できない場合があります。 |
type | string | --- | 駅の交通種別 。複数指定可。省略可。省略時は全ての交通種別が対象となります。 |
corporationBind | string | --- | 固定会社名。指定した会社のみ利用します。複数指定可。最大50件。省略可。省略時は制限のない通常の取得となります。 |
addGateGroup | string | --- | 結果の駅に出口グループ(鉄道のみ)を付加するかどうかを指定します。省略可。 指定できる値: - true: 付加します - false: 付加しません Default: false |
excludeSameLineStation | string | --- | 同一路線(乗り入れ路線が全て同じ)の駅を複数返さない。省略可。 指定できる値: - true: 同一路線の駅は1件のみとし、他は候補から除外する - false: 同一路線かどうかを考慮しない Default: false ※true指定時の検索結果は、最大10件となります。 |
stationCount | string | --- | 最大回答駅数。省略可。省略時およびstationCount=0を指定した時は検索結果全件となります。半径指定時のみ有効。 |
communityBus | string | --- | 取得結果の路線バスに対するコミュニティバスの扱いを指定します。type未指定時またはtypeにbusおよびbus.local指定時のみ有効。corporationBind 利用時には無効。省略可。 指定できる値: - contain:除外しない - except:除外する Default: contain |
gcs | string | --- | リクエストやレスポンスに座標が含まれる場合、座標の測地系を指定することができます。また、リクエストパラメータの座標情報はgcsパラメータとは別の測地系を個別に指定可能です。省略可 指定できる値: - tokyo: 日本測地系 - wgs84: 世界測地系 Default: tokyo |
response
Name | Description |
---|---|
ResultSet / apiVersion | WebAPIバージョン |
ResultSet / engineVersion | エンジンバージョン |
ResultSet / Point / Distance | 指定した緯度経度から駅までの直線距離 単位: メートル |
ResultSet / Point / GeoPoint / gcs | 測地系 |
ResultSet / Point / GeoPoint / lati | 緯度。度分秒(DMS)単位。秒は小数第3位を四捨五入。 Format: 度.分.秒.1/100秒 Example: 35.42.6.0 |
ResultSet / Point / GeoPoint / lati_d | 緯度。十進法度(DD)単位。 Format: 度 Example: 35.701667 |
ResultSet / Point / GeoPoint / longi | 経度。度分秒(DMS)単位。秒は小数第3位を四捨五入。 Format: 度.分.秒.1/100秒 Example: 139.38.22.30 |
ResultSet / Point / GeoPoint / longi_d | 経度。十進法度(DD)単位。 Format: 度 Example: 139.639527 |
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 | 読みかな |
ResultSet / Point / Station / GateGroup / | 出口グループを表す要素 |
ResultSet / Point / Station / GateGroup / Gate | 出口を表す要素 |
ResultSet / Point / Station / GateGroup / Gate / code | 出口コード |
ResultSet / Point / Station / GateGroup / Gate / Distance | 指定した座標から出口までの直線距離 単位: メートル |
ResultSet / Point / Station / GateGroup / Gate / GeoPoint | 座標を表す要素 |
ResultSet / Point / Station / GateGroup / Gate / GeoPoint / gcs | 測地系 |
ResultSet / Point / Station / GateGroup / Gate / GeoPoint / lati | 緯度。度分秒(DMS)単位。秒は小数第3位を四捨五入。 Format: 度.分.秒.1/100秒 Example: 35.42.6.0 |
ResultSet / Point / Station / GateGroup / Gate / GeoPoint / lati_d | 緯度。十進法度(DD)単位。 Format: 度 Example: 35.701667 |
ResultSet / Point / Station / GateGroup / Gate / GeoPoint / longi | 経度。度分秒(DMS)単位。秒は小数第3位を四捨五入。 Format: 度.分.秒.1/100秒 Example: 139.38.22.30 |
ResultSet / Point / Station / GateGroup / Gate / GeoPoint / longi_d | 経度。十進法度(DD)単位。 Format: 度 Example: 139.639527 |
ResultSet / Point / Station / GateGroup / Gate / Name | 出口の名称を表す要素 |
example
GET /v1/xml/geo/station?key=アクセスキーを入力してください&geoPoint=35.6783055555556,139.770441666667,tokyo,1000
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
<Point>
<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"/>
<Distance>24</Distance>
<Station code="22828">
<Name>東京</Name>
<Yomi>とうきょう</Yomi>
<Type>train</Type>
</Station>
</Point>
<Point>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.677840" longi_d="139.770543" lati="35.40.40.22" longi="139.46.13.95"/>
<Distance>52</Distance>
<Station code="305394">
<Name>東京駅前(バス乗り場)</Name>
<Yomi>とうきょうえきまえ</Yomi>
<Type detail="midnight:highway:connection">bus</Type>
</Station>
</Point>
<Point>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.679749" longi_d="139.768527" lati="35.40.47.9" longi="139.46.6.69"/>
<Distance>235</Distance>
<Station code="35982">
<Name>東京駅丸の内北口/都営バス</Name>
<Yomi>とうきょうえきまるのうちきたぐち</Yomi>
<Type detail="local">bus</Type>
</Station>
</Point>
<Point>
:
</Point>
</ResultSet>
GET /v1/json/geo/station?key=アクセスキーを入力してください&geoPoint=35.6783055555556,139.770441666667,tokyo,1000
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"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"
},
"Distance": "24",
"Station": {
"code": "22828",
"Name": "東京",
"Yomi": "とうきょう",
"Type": "train"
}
},
{
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.677840",
"longi_d": "139.770543",
"lati": "35.40.40.22",
"longi": "139.46.13.95"
},
"Distance": "52",
"Station": {
"code": "305394",
"Name": "東京駅前(バス乗り場)",
"Yomi": "とうきょうえきまえ",
"Type": {
"text": "bus",
"detail": "midnight:highway:connection"
}
}
},
{
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.679749",
"longi_d": "139.768527",
"lati": "35.40.47.9",
"longi": "139.46.6.69"
},
"Distance": "235",
"Station": {
"code": "35982",
"Name": "東京駅丸の内北口/都営バス",
"Yomi": "とうきょうえきまるのうちきたぐち",
"Type": {
"text": "bus",
"detail": "local"
}
}
},
{
:
}
]
}
}
GET /v1/xml/geo/station?key=アクセスキーを入力してください&geoPoint=35.6783055555556,139.770441666667,tokyo,1000&addGateGroup=true
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.14.0.0" engineVersion="201404_01a">
<Point>
<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"/>
<Distance>24</Distance>
<Station code="22828">
<Name>東京</Name>
<Yomi>とうきょう</Yomi>
<Type>train</Type>
<GateGroup>
<Gate code="G4663">
<Name>丸の内中央口</Name>
<GeoPoint longi="139.46.8.78" lati="35.40.41.52" longi_d="139.769107" gcs="tokyo" lati_d="35.678201"/>
<Distance>121</Distance>
</Gate>
</GateGroup>
<GateGroup>
<Gate code="G4581">
<Name>丸の内北口</Name>
<GeoPoint longi="139.46.9.65" lati="35.40.44.43" longi_d="139.769349" gcs="tokyo" lati_d="35.679009"/>
<Distance>126</Distance>
</Gate>
<Gate code="G4641">
<Name>丸の内北口(地下鉄側)</Name>
<GeoPoint longi="139.46.9.22" lati="35.40.44.83" longi_d="139.769229" gcs="tokyo" lati_d="35.67912"/>
<Distance>142</Distance>
</Gate>
<Gate>
:
</Gate>
</GateGroup>
:
</Station>
</Point>
<Point>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.677840" longi_d="139.770543" lati="35.40.40.22" longi="139.46.13.95"/>
<Distance>52</Distance>
<Station code="305394">
<Name>東京駅前(バス乗り場)</Name>
<Yomi>とうきょうえきまえ</Yomi>
<Type detail="midnight:highway:connection">bus</Type>
</Station>
</Point>
<Point>
<Prefecture code="13">
<Name>東京都</Name>
</Prefecture>
<GeoPoint gcs="tokyo" lati_d="35.679749" longi_d="139.768527" lati="35.40.47.9" longi="139.46.6.69"/>
<Distance>235</Distance>
<Station code="35982">
<Name>東京駅丸の内北口/都営バス</Name>
<Yomi>とうきょうえきまるのうちきたぐち</Yomi>
<Type detail="local">bus</Type>
</Station>
</Point>
<Point>
:
</Point>
</ResultSet>
GET /v1/json/geo/station?key=アクセスキーを入力してください&geoPoint=35.6783055555556,139.770441666667,tokyo,1000&addGateGroup=true
{
"ResultSet": {
"apiVersion": "1.14.0.0",
"engineVersion": "201404_01a",
"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"
},
"Distance": "24",
"Station": {
"code": "22828",
"Name": "東京",
"Yomi": "とうきょう",
"Type": "train",
"GateGroup": [
{
"Gate": {
"code": "G4663",
"Name": "丸の内中央口",
"GeoPoint": {
"longi": "139.46.8.78",
"lati": "35.40.41.52",
"longi_d": "139.769107",
"gcs": "tokyo",
"lati_d": "35.678201"
},
"Distance": "121"
}
},
{
"Gate": [
{
"code": "G4581",
"Name": "丸の内北口",
"GeoPoint": {
"longi": "139.46.9.65",
"lati": "35.40.44.43",
"longi_d": "139.769349",
"gcs": "tokyo",
"lati_d": "35.679009"
},
"Distance": "126"
},
{
"code": "G4641",
"Name": "丸の内北口(地下鉄側)",
"GeoPoint": {
"longi": "139.46.9.22",
"lati": "35.40.44.83",
"longi_d": "139.769229",
"gcs": "tokyo",
"lati_d": "35.67912"
},
"Distance": "142"
},
{
:
}
]
},
{
:
}
]
}
},
{
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.677840",
"longi_d": "139.770543",
"lati": "35.40.40.22",
"longi": "139.46.13.95"
},
"Distance": "52",
"Station": {
"code": "305394",
"Name": "東京駅前(バス乗り場)",
"Yomi": "とうきょうえきまえ",
"Type": {
"text": "bus",
"detail": "midnight:highway:connection"
}
}
},
{
"Prefecture": {
"code": "13",
"Name": "東京都"
},
"GeoPoint": {
"gcs": "tokyo",
"lati_d": "35.679749",
"longi_d": "139.768527",
"lati": "35.40.47.9",
"longi": "139.46.6.69"
},
"Distance": "235",
"Station": {
"code": "35982",
"Name": "東京駅丸の内北口/都営バス",
"Yomi": "とうきょうえきまるのうちきたぐち",
"Type": {
"text": "bus",
"detail": "local"
}
}
},
{
:
}
]
}
}