緯度経度でのPOI検索
API名:
poi/latlon
概要:
リクエストパラメータで指定される緯度経度を元にPOIデータベースを検索し、周辺のPOI情報を返却します。
※多言語情報の出力には別途契約が必要です。
※全ての地下街・駅構内詳細図情報の出力が基本契約内でご利用頂けることになりました。
ご利用をご希望の方は営業にお申し出ください。
URI:
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/poi/latlon
リクエストパラメータ
| パラメータ | 必須 | デフォルト値 | 説明 | ||||
|---|---|---|---|---|---|---|---|
| latlon | ○ | - | 緯度経度 | ||||
| radius | 500 |
検索範囲指定 検索範囲の半径を指定します。(単位:m) 指定できる半径は 0～50000 です。 10000 を越える検索を行う場合、応答時間の大きな遅延が発生する可能性がありますのでご注意ください。 |
|||||
| word | - | 絞込みワード | |||||
| srchtype | and |
絞込みタイプ word パラメータを複数値指定した場合の絞込みタイプを指定します。
|
|||||
| genrecode | - |
絞込みジャンルコード 検索範囲を指定のジャンルコードに限定します。 5桁または10桁のコードで指定します。 複数値指定するとOR検索で絞込みされます。 ジャンルコードの取得はジャンルコード一覧取得APIを使用してください。 ジャンルコード一覧は下記よりダウンロードできます。 ・ジャンルコード一覧(Excel) |
|||||
| datum | TOKYO |
測地系 入出力緯度経度の測地系を指定します。 |
|||||
| limit | 0,100 |
検索結果取得件数 検索結果取得件数を指定します。 取得開始位置の指定範囲は 0～10000 です。 10001 以上の指定をした場合は10000 指定と同様の結果となります。 取得件数の指定範囲は 1~1000 です。 1001以上の指定をした場合は1000指定と同様の結果となります。 |
|||||
| llunit | dec |
緯度経度形式 緯度経度形式を指定します。 |
|||||
| detailid | - |
地下街・駅構内詳細図番号 地下街・駅構内詳細図番号を指定します。 |
|||||
| notmultilanguage | F |
多言語情報出力 検索結果に多言語情報を含まないかを真偽値で指定します。 本パラメータはオプション機能で多言語機能を選択されているクライアントIDのみ有効です。
|
出力データ
出力フォーマット
{"status":{"code":"0000", "text":"OK"}, "info":{"hit":6, "facet":{"genre":{"0014000180":{"text":"買い物/コンビニ", "count":6}}, "areaInfo":string, "detailInfo":{"00000080":{"text":"ＪＲ品川駅", "count":1}}, "genreMlang":null}}, "item":[{"poi":{"text":"ローソン新橋1丁目店", "code":"00000000000000244227", "point":{"lat":35.66485, "lon":139.7605056}, "kana":"ローソンシンバシイッチョウメテン", "addressText":"東京都港区新橋１丁目１５－７", "zipcode":"105-0004", "phoneNumber":"03-3504-8805", "genre":{"code":"0014000180", "text":"買い物/コンビニ"}, "detail":{"areaid":string, "areaname":string, "detailid":string, "detailname":string, "floorname":string, "level":string}, "language":{"zh-cn":{"text":"罗森新桥一丁目店", "addressParts":["东京都", "港区", "新桥", "1丁目", "15", "7"], "genre":"购物/便利店"}, "zh-tw":{"text":"羅森新橋一丁目店", "addressParts":["東京都", "港區", "新橋", "1丁目", "15", "7"], "genre":"購物/便利店"}, "en":{"text":"Lawson Shinbashi 1 Chome", "addressParts":["Tokyo", "Minato", "Shinbashi", "1", "15", "7"], "genre":"Shopping/Convenience Store"}, "ko":{"text":"로손 신바시 1 쵸메 점", "addressParts":["도쿄도", "미나토 구", "신바시", "1초메", "15", "7"], "genre":"쇼핑 / 편의점"}}, "arrivalInfo":[{"text":"出入口", "kana":"デイリグチ", "exittype":{"code": "99", "text":"未調査"}, "arrivalpoint":{"lat": 35.6646556,"lon": 139.7603944}, "exitpoint":{"lat": 35.6646556,"lon": 139.7603944}}]}, "distance": 182}, ...]}
| キー名 | データ型 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|
| status | object | ステータス情報が入ります。 | ||||||
| code | string |
ステータスコードが入ります。
|
||||||
| 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代表点との距離(メートル)が入ります。 | ||||||
出力例
[通常出力例(多言語情報出力契約時)]
if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip
&latlon=35.625037686,139.742386127&radius=50&word=ニューデイズ
{ "status": { "code": "0000", "text": "OK" }, "info": { "hit": 1, "facet": { "genre": { "0014000180": { "text": "買い物/コンビニ", "count": 1 } }, "areaInfo": null, "detailInfo": null, "genreMlang": { "zh-cn": { "0014000180": { "text": "购物/便利店", "count": 1 } }, "zh-tw": { "0014000180": { "text": "購物/便利店", "count": 1 } }, "en": { "0014000180": { "text": "Shopping/Convenience Store", "count": 1 } }, "ko": { "0014000180": { "text": "쇼핑/편의점", "count": 1 } } } } }, "item": [ { "poi": { "text": "ニューデイズ＋くすりエキュート品川サウス", "code": "00000000000003263105", "point": { "lat": 35.6248556, "lon": 139.7423 }, "kana": "ニューデイズプラスクスリエキュートシナガワサウス", "addressText": "東京都港区高輪３丁目２６－２７", "zipcode": "108-0074", "phoneNumber": "03-5421-8004", "genre": { "code": "0014000180", "text": "買い物/コンビニ" }, "detail": null, "language": { "zh-cn": { "text": "New Days+药局ecute品川south店", "addressParts": [ "东京都", "港区", "高轮", "3丁目", "26", "27" ], "genre": "购物/便利店" }, "zh-tw": { "text": "New Days+藥局ecute品川south店", "addressParts": [ "東京都", "港區", "高輪", "3丁目", "26", "27" ], "genre": "購物/便利店" }, "en": { "text": "NewDays + Kusuri ecute Shinagawa south", "addressParts": [ "Tokyo", "Minato", "Takanawa", "3", "26", "27" ], "genre": "Shopping/Convenience Store" }, "ko": { "text": "뉴 데이즈 +쿠스리 ecute 시나가와 south점", "addressParts": [ "도쿄도", "미나토구", "타카나와", "3쵸메", "26", "27" ], "genre": "쇼핑/편의점" } }, "arrivalInfo": [ { "text": "出入口１", "kana": "デイリグチイチ", "exittype": { "code": "99", "text": "未調査" }, "arrivalpoint": { "lat": 35.6256722, "lon": 139.7410333 }, "exitpoint": { "lat": 35.6256722, "lon": 139.7410333 } }, { "text": "出入口２", "kana": "デイリグチニ", "exittype": { "code": "99", "text": "未調査" }, "arrivalpoint": { "lat": 35.6256833, "lon": 139.7443611 }, "exitpoint": { "lat": 35.6256833, "lon": 139.7443611 } } ] }, "distance": 21 } ] }
[通常出力例(多言語情報出力未契約時)]
if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip
&latlon=35.625037686,139.742386127&radius=50&word=ニューデイズ
{ "status": { "code": "0000", "text": "OK" }, "info": { "hit": 1, "facet": { "genre": { "0014000180": { "text": "買い物/コンビニ", "count": 1 } }, "areaInfo": null, "detailInfo": null, "genreMlang": null } }, "item": [ { "poi": { "text": "ニューデイズ＋くすりエキュート品川サウス", "code": "00000000000003263105", "point": { "lat": 35.6248556, "lon": 139.7423 }, "kana": "ニューデイズプラスクスリエキュートシナガワサウス", "addressText": "東京都港区高輪３丁目２６－２７", "zipcode": "108-0074", "phoneNumber": "03-5421-8004", "genre": { "code": "0014000180", "text": "買い物/コンビニ" }, "detail": null, "language": null, "arrivalInfo": [ { "text": "出入口１", "kana": "デイリグチイチ", "exittype": { "code": "99", "text": "未調査" }, "arrivalpoint": { "lat": 35.6256722, "lon": 139.7410333 }, "exitpoint": { "lat": 35.6256722, "lon": 139.7410333 } }, { "text": "出入口２", "kana": "デイリグチニ", "exittype": { "code": "99", "text": "未調査" }, "arrivalpoint": { "lat": 35.6256833, "lon": 139.7443611 }, "exitpoint": { "lat": 35.6256833, "lon": 139.7443611 } } ] }, "distance": 21 } ] }
[検索結果が0件の例]
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": [] }