緯度経度でのPOI検索

API名: 
poi/latlon
概要: 

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

※多言語情報の出力には別途契約が必要です。
※全ての地下街・駅構内詳細図情報の出力が基本契約内でご利用頂けることになりました。
ご利用をご希望の方は営業にお申し出ください。

URI: 

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

https://test.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 検索範囲指定
検索範囲の半径を指定します。(単位:m)
指定できる半径は 0～50000 です。
10000 を越える検索を行う場合、応答時間の大きな遅延が発生する可能性がありますのでご注意ください。
word   - 絞込みワード
検索結果を施設名称で絞込みします。
複数値指定で AND または OR 検索ができます。
複数値指定の上限は50件で１語句の上限は1024文字です。
srchtype   and 絞込みタイプ
word パラメータを複数値指定した場合の絞込みタイプを指定します。
and AND 検索
or OR 検索
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のみ有効です。
T 多言語情報を含まない
F 多言語情報を含む

出力データ
出力フォーマット
{"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 ステータスコードが入ります。
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代表点との距離(メートル)が入ります。
出力例

[通常出力例(多言語情報出力契約時)]

https://test.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&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
        }
    ]
}

[通常出力例(多言語情報出力未契約時)]

https://test.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&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件の例]

https://test.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": []
}