緯度経度での建物検索

API名: 
building/latlon
概要: 

緯度経度を元に、該当する建物情報を返却します。

※この機能を利用するには別途契約が必要です。

URI: 

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

<API使用例>
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/building/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=34.66645413,135.50081815&word=難波&limit=2,2&sort=dist&srchtype=and&datum=TOKYO

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon - 緯度経度
緯度経度を指定します。必須項目です。
limit   0,100 検索結果取得件数
検索結果取得件数を指定します。
指定可能値は、取得開始位置:0~1000、取得件数:1~1000となります。
word   - 絞込み検索ワード
検索結果を絞り込むワードを指定します。複数指定できます。
複数指定する場合、5件まで指定できます。
それ以上の場合はエラーとなります。
半角スペース、全角スペースは取り除かれます。
1ワードの最大文字数は1024文字です。
radius   500 検索範囲
検索範囲の半径をメートルで指定します。
0~10000の間で設定してください。
※半径を広範囲に指定すると、レスポンスが遅くなります。
srchtype   and 検索タイプ
リクエストパラメータwordを複数指定した場合の検索タイプを指定します。
指定値 説明
and AND検索
or OR検索
sort   dist 出力順
出力順を指定します。複数指定可。
デフォルトは昇順で、降順指定の場合、ソートキーの前方にマイナス(-)を付けます。
以下のキー以外のパラメータはエラーとなります。
指定値 説明
dist 距離
score マッチングスコア
nm 施設名称
tod 都道府県コード
nmlen 名称の文字数
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット
{"status":{"code":"00000",
           "text":"OK"},
 "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":"東京都新宿区余丁町8‐13",
          "addresscode":"13104",
          "floor":9,
          "distace":100}...]}
キー名 データ型 説明
status     object ステータス情報
  code   string ステータスコード  
OK 正常終了
ERR_FORCED_
TERMINATION
タイムアウトが発生またはデータサイズが制限値を超えたため処理を中断
  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件の場合]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/building/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&?latlon=34.66645413,135.50081815&word=難波&limit=2,2&sort=dist&srchtype=and&datum=TOKYO

{"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":"大阪府大阪市中央区難波2丁目3-11",
          "addressCode":"27128",
          "floor":11,
          "distance":244},
         {"code":"7-22-50-155-32562836",
          "name":"太陽生命難波ビル",
          "point":{"lat":34.664725,
                   "lon":135.5026889},
          "addressText":"大阪府大阪市中央区難波2丁目1-2",
          "addressCode":"27128",
          "floor":10,
          "distance":249}]}

[例 0件の場合]
http://core.its-mo.com/zmaps/api/apicore/core/v1_0/building/latlon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=34.29814291,134.7816533&limit=1,50&radius=80

{"status":{"code":"OK",
           "text":"正常終了"},
 "info":{"hit":0,
         "facet":null},
 "item":[]}