緯度経度での駅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のみ有効です。
指定値 説明
T 多言語情報を含まない
F 多言語情報を含む

出力データ
出力フォーマット
{
    "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 ステータスコードが入ります。
0000 正常終了
0001 タイムアウトが発生またはデータサイズが
制限値を超えたため処理が中断された
  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":[]}