緯度経度でのPOI検索

API名:

poi/latlon

概要:

リクエストパラメータで指定される緯度経度を元にPOIデータベースを検索し、周辺のPOI情報を返却します。

※多言語情報または全ての詳細図情報の出力には別途契約が必要です。

URI:

http://core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/latlon

http://core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6633583,139.7613555&radius=250&word=ローソン

リクエストパラメータ

パラメータ

必須

デフォルト値

説明

latlon

○

緯度経度

取得したい地点の緯度経度を指定します。
同時に複数地点の緯度経度を指定することはできません。
本項目は必須項目であるため、未指定の場合はエラーとなります。

radius

500

検索範囲指定
検索範囲の半径を指定します。
指定できる半径は 0～50000m です。
10000mを越える検索を行う場合、応答時間の大きな遅延が発生する可能性がありますのでご注意ください。

word

絞込みワード

検索結果を施設名称で絞込みします。
複数値指定で AND または OR 検索ができます。
複数値指定の上限は50件で１語句の上限は1024文字です。

srchtype

and

絞込みタイプ
word パラメータを複数値指定した場合の絞込みタイプを指定します。

and	AND 検索
or	OR 検索

genrecode

絞込みジャンルコード
検索範囲を指定のジャンルコードに限定します。
5桁または10桁のコードで指定します。
複数値指定するとOR検索で絞込みされます。
ジャンルコードの取得はジャンルコード一覧取得APIを使用してください。
ジャンルコード一覧は下記よりダウンロードできます。
・ジャンルコード一覧(Excel)

datum

TOKYO

測地系
入出力緯度経度の測地系を指定します。

limit

0,100

検索結果取得件数
検索結果取得件数を指定します。

llunit

dec

緯度経度形式
緯度経度形式を指定します。

detailid

詳細図番号を指定します。

notmultilanguage

多言語情報出力
検索結果に多言語情報を含まないかを真偽値で指定します。
本パラメータはオプション機能で多言語機能を選択されているクライアントIDのみ有効です。

T	多言語情報を含まない
F	多言語情報を含む

出力データ

出力フォーマット

{"status":{"code":"0000",
           "text":"OK"},
 "info":{"hit":6,
         "facet":{"genre":{"0011000260":{"text":"車・交通/駅",
                                         "count":6}},
                  "areaInfo":null,
                  "detailInfo":null,
                  "genreMlang":null}},
 "item":[{"poi":{"text":"品川駅(JR 京浜東北線)",
                 "code":"20000000000000003516",
                 "point":{"lat":35.6269083,
                          "lon":139.7436694},
                 "kana":"シナガワエキジェイアール/ケイヒントウホクセン",
                 "addressText":"東京都港区高輪３丁目",
                 "zipcode":"108-0074",
                 "phoneNumber":"050-2016-1600",
                 "genre":{"code":"0011000260",
                          "text":"車・交通/駅"},
                 "detail":null,
                 "language":null,
                 "arrivalInfo":[{"text":"港南口",
                                 "kana":"コウナングチ",
                                 "exittype":{"code":"03",
                                             "text":"出入口"},
                                 "arrivalpoint":{"lat":35.6257333,
                                                 "lon":139.7443667},
                                 "exitpoint":{"lat":35.6257417,
                                              "lon":139.7442083}},
                                {"text":"高輪口",
                                 "kana":"タカナワグチ",
                                 "exittype":{"code":"03",
                                             "text":"出入口"},
                                 "arrivalpoint":{"lat":35.6256,
                                                 "lon":139.7410333},
                                 "exitpoint":{"lat":35.6255972,
                                              "lon":139.7411972}}]},
          "distance":231},
          ...]}

キー名

データ型

説明

status

object

ステータス情報が入ります。

code

string

ステータスコードが入ります。

0000	正常終了
0001	タイムアウトが発生またはデータサイズが制限値を超えたため処理が中断された

text

string

ステータス内容に関するテキスト情報が入ります。

info

object

検索結果の情報が入ります。

hit

number

入力された条件に対してヒットした件数が入ります。

facet

object

ファセット情報が入ります。

genre

object

ジャンルコード毎の件数が入ります。

areaInfo

object

エリア毎の件数が入ります。

detailInfo

object

詳細図番号毎の件数が入ります。

genreMlang

object

言語別ジャンルコード毎の件数が入ります。

item

array

検索結果の配列が入ります。
検索結果が0件の場合は空の配列となります。出力順は距離の昇順となります。

poi

object

POI情報の配列が入ります。

distance

number

検索地点とPOI代表点との距離(メートル)が入ります。

出力例

[通常出力例(多言語情報出力契約時)]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.625037686,139.742386127&radius=50

{"status":{"code":"0000",

"text":"OK"},

"info":{"hit":2,

"facet":{"genre":{"0014000160":{"text":"買い物/複合モール",

"count":1},

"0014000180":{"text":"買い物/コンビニ",

"count":1}},

"areaInfo":null,

"detailInfo":null,

"genreMlang":{"zh-cn":{"0014000160":{"text":"购物/综合购物中心",

"count":1},

"0014000180":{"text":"购物/便利店",

"count":1}},

"zh-tw":{"0014000160":{"text":"購物/綜合購物中心",

"count":1},

"0014000180":{"text":"購物/便利店",

"count":1}},

"en":{"0014000160":{"text":"Shopping/Shopping Mall",

"count":1},

"0014000180":{"text":"Shopping/Convenience Store",

"count":1}},

"ko":{"0014000160":{"text":"쇼핑/복합 쇼핑몰",

"count":1},

"0014000180":{"text":"쇼핑/편의점",

"count":1}}}}},

"item":[{"poi":{"text":"NEW　DAYS",

"code":"30000000000000001629",

"point":{"lat":35.625025,

"lon":139.742325},

"kana":"ニューデイズ",

"addressText":"東京都港区",

"zipcode":null,

"phoneNumber":null,

"genre":{"code":"0014000180",

"text":"買い物/コンビニ"},

"detail":{"areaid":"005",

"areaname":"ＪＲ品川駅",

"detailid":"00000080",

"detailname":"ＪＲ品川駅",

"floorname":"２階",

"level":"1"},

"language":{"zh-cn":{"text":"NEW　DAYS",

"addressParts":["东京都","港区"],

"genre":"购物/便利店"},

"zh-tw":{"text":"NEW　DAYS",

"addressParts":["東京都","港區"],

"genre":"購物/便利店"},

"en":{"text":"NEW DAYS",

"addressParts":["Tokyo","Minato-ku"],

"genre":"Shopping/Convenience Store"},

"ko":{"text":"NEW　DAYS",

"addressParts":["도쿄도","미나토구"],

"genre":"쇼핑/편의점"}},

"arrivalInfo":[]},

"distance":5},

{"poi":{"text":"エキュート品川サウス",

"code":"00000000000002648064",

"point":{"lat":35.6248556,

"lon":139.7419694},

"kana":"エキュートシナガワサウス",

"addressText":"東京都港区高輪３丁目２６－２７",

"zipcode":"108-0074",

"phoneNumber":"03-5421-8001",

"genre":{"code":"0014000160",

"text":"買い物/複合モール"},

"detail":null,

"language":{"zh-cn":{"text":"Ecute",

"addressParts":["东京都","港区","高轮","3丁目","26","27"],

"genre":"购物/综合购物中心"},

"zh-tw":{"text":"Ecute",

"addressParts":["東京都","港區","高輪","3丁目","26","27"],

"genre":"購物/綜合購物中心"},

"en":{"text":"Ecute",

"addressParts":["Tokyo","Minato-ku","Takanawa","3Chome","26","27"],

"genre":"Shopping/Shopping Mall"},

"ko":{"text":"에큐토",

"addressParts":["도쿄도","미나토구","타카나와","3쵸메","26","27"],

"genre":"쇼핑/복합 쇼핑몰"}},

"arrivalInfo":[{"text":"出入口",

"kana":"デイリグチ",

"exittype":{"code":"99",

"text":"未調査"},

"arrivalpoint":{"lat":35.6256167,

"lon":139.7410333},

"exitpoint":{"lat":35.6256167,

"lon":139.7410333}}]},

"distance":41}]}

[通常出力例(多言語情報出力未契約時)] http://core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.625037686,139.742386127&radius=50

{"status":{"code":"0000",

"text":"OK"},

"info":{"hit":3,

"facet":{"genre":{"0014000160":{"text":"買い物/複合モール",

"count":2},

"0014000180":{"text":"買い物/コンビニ",

"count":1}},

"areaInfo":{"005":{"text":"ＪＲ品川駅",

"count":1}},

"detailInfo":{"00000080":{"text":"ＪＲ品川駅",

"count":1}},

"genreMlang":null}},

"item":[{"poi":{"text":"NEW　DAYS",

"code":"30000000000000001629",

"point":{"lat":35.625025,

"lon":139.742325},

"kana":"ニューデイズ",

"addressText":"東京都港区",

"zipcode":null,

"phoneNumber":null,

"genre":{"code":"0014000180",

"text":"買い物/コンビニ"},

"detail":{"areaid":"005",

"areaname":"ＪＲ品川駅",

"detailid":"00000080",

"detailname":"ＪＲ品川駅",

"floorname":"２階",

"level":"1"},

"language":null,

"arrivalInfo":[]},

"distance":5},

{"poi":{"text":"ユニクロエキュート品川サウス店",

"code":"00000000000002670251",

"point":{"lat":35.6248778,

"lon":139.7420083},

"kana":"ユニクロエキュートシナガワサウステン",

"addressText":"東京都港区高輪３丁目２６－２７",

"zipcode":"108-0074",

"phoneNumber":"03-5421-8012",

"genre":{"code":"0014000160",

"text":"買い物/複合モール"},

"detail":null,

"language":null,

"arrivalInfo":[{"text":"出入口",

"kana":"デイリグチ",

"exittype":{"code":"99",

"text":"未調査"},

"arrivalpoint":{"lat":35.6256306,

"lon":139.7410333},

"exitpoint":{"lat":35.6256306,

"lon":139.7410333}}]},

"distance":37},

{"poi":{"text":"エキュート品川サウス",

"code":"00000000000002648064",

"point":{"lat":35.6248556,

"lon":139.7419694},

"kana":"エキュートシナガワサウス",

"addressText":"東京都港区高輪３丁目２６－２７",

"zipcode":"108-0074",

"phoneNumber":"03-5421-8001",

"genre":{"code":"0014000160",

"text":"買い物/複合モール"},

"detail":null,

"language":null,

"arrivalInfo":[{"text":"出入口",

"kana":"デイリグチ",

"exittype":{"code":"99",

"text":"未調査"},

"arrivalpoint":{"lat":35.6256167,

"lon":139.7410333},

"exitpoint":{"lat":35.6256167,

"lon":139.7410333}}]},

"distance":41}]}

[検索結果が0件の例]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6633583,139.7613555&radius=50&word=ローソン

{"status":{"code":"0000",

"text":"OK"},

"info":{"hit":0,

"facet":null},

"item":[]}

ヘッダー用問い合わせリンク

メインメニュー

API マニュアル

緯度経度でのPOI検索

copyright

検索フォーム

ヘッダー用問い合わせリンク

メインメニュー

現在地

API マニュアル

緯度経度でのPOI検索

copyright