緯度経度での建物検索
API名:
building/latlon
概要:
緯度経度を元に、該当する建物情報を返却します。
※この機能を利用するには別途契約が必要です。
URI:
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/building/latlon
<API使用例>
リクエストパラメータ
| パラメータ | 必須 | デフォルト値 | 説明 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| latlon | ○ | - |
緯度経度 緯度経度を指定します。 本項目は必須項目であるため、未指定の場合はエラーとなります。 |
||||||||||||||||
| limit | 0,100 |
検索結果取得件数 検索結果取得件数を指定します。 取得開始位置の指定範囲は 0～10000 です。 10001 以上の指定をした場合は10000 指定と同様の結果となります。 取得件数の指定範囲は 1~1000 です。 1001以上の指定をした場合は1000指定と同様の結果となります。 |
|||||||||||||||||
| word | - |
絞込み検索ワード 検索結果を絞り込むワードを指定します。複数指定できます。 複数指定する場合、5件まで指定できます。 それ以上の場合はエラーとなります。 半角スペース、全角スペースは取り除かれます。 1ワードの最大文字数は1024文字です。 |
|||||||||||||||||
| addrword | - |
住所 住所文字列を指定します。 丁目/番地/枝番まで指定可能です。 |
|||||||||||||||||
| radius | 500 |
検索範囲 検索範囲の半径を指定します。(単位:m) 指定できる半径は 0～10000 です。 ※半径を広範囲に指定した場合、応答時間の大きな遅延が発生する可能性がありますのでご注意ください。 |
|||||||||||||||||
| srchtype | and |
検索タイプ リクエストパラメータwordを複数指定した場合の検索タイプを指定します。
|
|||||||||||||||||
| sort | dist |
出力順 出力順を指定します。複数指定できます。 デフォルトは昇順で、降順指定の場合、ソートキーの前方にマイナス(-)を付けます。 以下のキー以外のパラメータはエラーとなります。
|
|||||||||||||||||
| datum | TOKYO |
測地系 入出力緯度経度の測地系を指定します。 |
|||||||||||||||||
| llunit | dec |
緯度経度形式 緯度経度形式を指定します。 |
出力データ
出力フォーマット
"text":"正常終了"},
"info":{"hit":3,
"facet":{"tod":{"13":2},
"shk":{"13107":1,
"13210":1}},
"item":[{"code":"7-22-50-351-8117799",
"name":"新宿余丁町パーク・ホームズ",
"point":{"lat":35.6941389,
"lon":139.7180944},
"addressText":"東京都新宿区余丁町８‐１３",
"addresscode":"13104",
"floor":9,
"distace":100}...]}
| キー名 | データ型 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|
| status | object | ステータス情報が入ります。 | ||||||
| code | string |
ステータスコード
|
||||||
| text | string | ステータス内容に関するテキスト情報が入ります。 | ||||||
| info | object | 検索結果の情報が入ります。 | ||||||
| hit | number | 検索結果総数が入ります。 | ||||||
| facet | object | ファセット情報が入ります。 | ||||||
| tod | object | 都道府県毎の件数が入ります。 | ||||||
| shk | object | 市区町村毎の件数が入ります。 | ||||||
| item | array |
検索結果の配列が入ります。 0件の場合は空の配列です。 |
||||||
| code | string | 建物コードが入ります。 | ||||||
| name | string | 建物名称が入ります。 | ||||||
| point | object | 緯度経度がオブジェクト形式で入ります。 | ||||||
| adressText | string | 住所名称が入ります。 | ||||||
| addressCode | string | 住所コードが入ります。 | ||||||
| floor | number | 階層レベルが入ります。 | ||||||
| distance | number | 距離が入ります。 | ||||||
出力例
[例 2件の場合]
{"status":{"code":"OK", "text":"正常終了"}, "info":{"hit":32, "facet":{"tod":{"27":32}, "shk":{"27111":17, "27128":15}}}, "item":[{"code":"7-22-50-25-5260984", "name":"難波八千代ビル", "point":{"lat":35.6642667, "lon":135.5015361}, "addressText":"大阪府大阪市中央区難波２丁目３－１１", "addressCode":"27128", "floor":11, "distance":244}, {"code":"7-22-50-155-32562836", "name":"太陽生命難波ビル", "point":{"lat":34.664725, "lon":135.5026889}, "addressText":"大阪府大阪市中央区難波２丁目１－２", "addressCode":"27128", "floor":10, "distance":249}]}
[例 0件の場合]
{"status":{"code":"OK", "text":"正常終了"}, "info":{"hit":0, "facet":null}, "item":[]}