緯度経度での駅POI検索
API名:
station/latlon
概要:
リクエストパラメータで指定される緯度経度を元に周辺の駅情報を返却します。
※多言語情報の出力には別途契約が必要です。
URI:
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/station/latlon
<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/station/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.677488,139.7769888&radius=500
リクエストパラメータ
| パラメータ | 必須 | デフォルト値 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| latlon | ○ | - | 緯度経度 | ||||||
| radius | 500 |
検索範囲指定 検索範囲の半径を指定します。 指定できる半径は 0～50000(単位:m)です。 10000 を越える検索を行う場合、応答時間の大きな遅延が発生する可能性がありますのでご注意ください。 |
|||||||
| datum | TOKYO |
測地系 入出力緯度経度の測地系を指定します。 |
|||||||
| linecode | - |
路線コード 検索範囲を路線コードで限定します。 |
|||||||
| limit | 0,100 |
検索結果取得件数 検索結果取得件数を指定します。 取得開始位置の指定範囲は 0～10000 です。 10001 以上の指定をした場合は10000 指定と同様の結果となります。 取得件数の指定範囲は 1~1000 です。 1001以上の指定をした場合は1000指定と同様の結果となります。 |
|||||||
| llunit | dec |
緯度経度形式 緯度経度形式を指定します。 |
|||||||
| notmultilanguage | F |
多言語情報出力 検索結果に多言語情報を含まないかを真偽値で指定します。 本パラメータはオプション機能で多言語機能を選択されているクライアントIDのみ有効です。
|
出力データ
出力フォーマット
{
"status": {
"code": "0000",
"text": "OK"
},
"info": {
"hit": 2
},
"item": [
{
"poi": {
"text": "日本橋駅(東京メトロ 銀座線)",
"code": "20000000000000003485",
"point": {
"lat": 35.6786722,
"lon": 139.7765472
},
"kana": "ニホンバシエキ",
"addressText": "東京都中央区日本橋１丁目３－１１",
"zipcode": "103-0027",
"phoneNumber": "03-3271-2768",
"genre": null,
"detail": null,
"language": {
"zh-cn": {
"text": "日本桥站(东京Metro地铁银座线)",
"addressParts": [
"东京都",
"中央区",
"日本桥",
"1丁目",
"3",
"11"
],
"genre": null
},
"zh-tw": {
"text": "日本橋站(東京Metro地鐵銀座線)",
"addressParts": [
"東京都",
"中央區",
"日本橋",
"1丁目",
"3",
"11"
],
"genre": null
},
"en": {
"text": "Nihombashi (Tokyo Metro Ginza Line)",
"addressParts": [
"Tokyo",
"Chuo",
"Nihonbashi",
"1",
"3",
"11"
],
"genre": null
},
"ko": {
"text": "니혼바시 역(도쿄메트로 긴자선)",
"addressParts": [
"도쿄도",
"츄오구",
"니혼바시",
"1쵸메",
"3",
"11"
],
"genre": null
}
},
"arrivalInfo": [
{
"text": "Ａ１",
"kana": "エーイチ",
"exittype": {
"code": "11",
"text": "地下鉄出入口"
},
"arrivalpoint": {
"lat": 35.6800722,
"lon": 139.7750917
},
"exitpoint": {
"lat": 35.6800722,
"lon": 139.7750917
}
}, ... }
]
},
"line": {
"code": "0507",
"text": "東京メトロ 銀座線",
"textMulti": {
"zh-cn": "东京Metro地铁银座线",
"zh-tw": "東京Metro地鐵銀座線",
"en": "Tokyo Metro Ginza Line",
"ko": "도쿄메트로 긴자선"
}
},
"distance": 0
}, ... }
]
}
| キー名 | データ型 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|
| status | object | ステータス情報が入ります。 | ||||||
| code | string |
ステータスコードが入ります。
|
||||||
| text | string | ステータス内容に関するテキスト情報が入ります。 | ||||||
| info | object | 検索結果の情報が入ります。 | ||||||
| hit | number | 入力された条件に対してヒットした件数が入ります。 | ||||||
| item | array |
検索結果の配列が入ります。 検索結果が0件の場合は空の配列となります。出力順は距離の昇順となります。 |
||||||
| poi | object | POI情報の配列が入ります。 | ||||||
| line | number | 路線情報が入ります。 | ||||||
| code | string | 路線コードが入ります。 | ||||||
| text | string | 路線名称が入ります。 | ||||||
| textmulti | object | 路線名称(言語別)が入ります。 | ||||||
| distance | number | 検索地点とPOI代表点との距離(単位:m)が入ります。 | ||||||
出力例
[通常出力例(多言語情報出力契約時)]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/station/latlon?
if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip
&latlon=35.6187528,139.742275&radius=500
{"status":{"code":"0000",
"text":"OK"},
"info":{"hit":1},
"item":[{"poi":{"text":"北品川駅(京急本線)",
"code":"20000000000000003067",
"point":{"lat":35.619325,
"lon":139.7425194},
"kana":"キタシナガワエキ",
"addressText":"東京都品川区北品川１丁目２",
"zipcode":null,
"phoneNumber":null,
"genre":null,
"detail":null,
"language":{"zh-cn":{"text":"北品川站(京急本线)",
"addressParts":[
"东京都",
"品川区",
"北品川",
"1丁目",
"2"],
"genre":null},
"zh-tw":{"text":"北品川站(京急本線)",
"addressParts":[
"東京都",
"品川區",
"北品川",
"1丁目",
"2"],
"genre":null},
"en":{"text":"Kitashinagawa(KeikyuMainLine)",
"addressParts":[
"Tokyo",
"Shinagawa",
"Kitashinagawa",
"1",
"2"],
"genre":null},
"ko":{"text":"키타시나가와역(케이힌급행전철본선)",
"addressParts":[
"도쿄도",
"시나가와구",
"키타시나가와",
"1쵸메",
"2"],
"genre":null}},
"arrivalInfo":[{"text":"出入口",
"kana":"デイリグチ",
"exittype":{"code":"99",
"text":"未調査"},
"arrivalpoint":{"lat":35.6187528,
"lon":139.742275},
"exitpoint":{"lat":35.6187528,
"lon":139.7422778}}]},
"line":{"code":"0284",
"text":"京急本線",
"textMulti":{"zh-cn":"京急本线",
"zh-tw":"京急本線",
"en":"KeikyuMainLine",
"ko":"케이힌급행전철본선"}},
"distance":67}]}
[通常出力例(多言語情報出力未契約時)]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/station/latlon?
if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip
&latlon=35.6187528,139.742275&radius=500
{"status":{"code":"0000",
"text":"OK"},
"info":{"hit":1},
"item":[{"poi":{"text":"北品川駅(京急本線)",
"code":"20000000000000003067",
"point":{"lat":35.619325,
"lon":139.7425194},
"kana":"キタシナガワエキ",
"addressText":"東京都品川区北品川１丁目２",
"zipcode":null,
"phoneNumber":null,
"genre":null,
"detail":null,
"language":null,
"arrivalInfo":[{"text":"出入口",
"kana":"デイリグチ",
"exittype":{"code":"99",
"text":"未調査"},
"arrivalpoint":{"lat":35.6187528,
"lon":139.742275},
"exitpoint":{"lat":35.6187528,
"lon":139.7422778}}]},
"line":{"code":"0284",
"text":"京急本線",
"textMulti":null,
"distance":67}]}
[検索結果が0件の例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/station/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.677488,139.7769888&radius=100
{"status":{"code":"0000",
"text":"OK"},
"info":{"hit":0},
"item":[]}