緯度経度での建物検索

API名: 
building/latlon
概要: 

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

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

URI: 

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

<API使用例>

https://test.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～10000 です。
10001 以上の指定をした場合は10000 指定と同様の結果となります。
取得件数の指定範囲は 1~1000 です。
1001以上の指定をした場合は1000指定と同様の結果となります。
word   - 絞込み検索ワード
検索結果を絞り込むワードを指定します。複数指定できます。
複数指定する場合、5件まで指定できます。
それ以上の場合はエラーとなります。
半角スペース、全角スペースは取り除かれます。
1ワードの最大文字数は1024文字です。
addrword   - 住所
住所文字列を指定します。
丁目/番地/枝番まで指定可能です。
radius   500 検索範囲
検索範囲の半径を指定します。(単位:m)
指定できる半径は 0～10000 です。
※半径を広範囲に指定した場合、応答時間の大きな遅延が発生する可能性がありますのでご注意ください。
srchtype   and 検索タイプ
リクエストパラメータwordを複数指定した場合の検索タイプを指定します。
指定値 説明
and AND検索
or OR検索
sort   dist 出力順
出力順を指定します。複数指定できます。
デフォルトは昇順で、降順指定の場合、ソートキーの前方にマイナス(-)を付けます。
以下のキー以外のパラメータはエラーとなります。
指定値 説明
dist 距離
score マッチングスコア
nm 施設名称
tod 都道府県コード
shk 市区町村コード
oaz 大字コード
nmlen 名称の文字数
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット
{"status":{"code":"OK",
           "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 ステータスコード　　
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件の場合]

https://test.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":"大阪府大阪市中央区難波２丁目３－１１",
          "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件の場合]

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