premium
targeting

建物ターゲティング

建物情報をより詳細な条件で検索する事ができます。
テナント又は建物、建物最上階、建物地下階、部屋数、面積、延べ床面積を指定して検索する事ができます。

建物情報の詳細についてはこちらをご確認ください

※本APIを利用するには別途契約が必要です。

※一部パラメータを利用するには別途契約が必要です。

https://[domain]/data-coding/targeting

HTTP request method

POST/GET

ContentType

application/x-www-form-urlencoded

Parameters

名前 説明
boundary
string		 任意範囲の検索
カンマ区切りでポリゴン座標を指定してください。最初の点と最後の点は同一とします。
経度緯度をスペース区切り、複数座標をカンマ区切りで指定します。
例)"139.74536 35.658878,139.745898 35.65854,139.745796 35.6583959,139.745673 35.658135,139.74536 35.658878"
word
string		 名称、読みを指定(全角カタカナで指定)
複数ワードはスペース区切りで指定してください。AND検索となります。
最大文字数 1024
word_match_type
integer
default 3		 検索語句のマッチタイプを指定
  • 1

    完全一致

  • 2

    前方一致

  • 3

    部分一致
address_code_list
array[string]		 住所コードを指定(前方一致)
複数指定の場合はOR検索となります。
各住所コードの最大文字数 255
指定できる値は最大50件
proximity
array[number]
※カンマ区切り		 中心座標、半径で範囲を指定
代表点の近傍検索。
"経度,緯度,半径(m)"で指定してください。
半径の上限は5000です。
building_type
array[integer]
default 1,3		 区分を指定(複数指定可)
  • 1

    テナント

  • 3

    建物
building_top_floor_num
array[string]
※カンマ区切り		 建物最上階を指定
数値で一致/以上/以下/範囲の指定が可能です。
  • 範囲指定[number,number]
    '1,10' ;1から10
  • 条件指定[operator,number]
    '>=,10' ;10以上
  • 指定可能operator
    '=,>,<,>=,<=,!='
building_bottom_floor_num
array[string]
※カンマ区切り		 建物地下階指定
数値で一致/以上/以下/範囲の指定が可能です。
  • 範囲指定[number,number]
    '1,10' ;1から10
  • 条件指定[operator,number]
    '>=,10' ;10以上
  • 指定可能operator
    '=,>,<,>=,<=,!='
room_count
array[string]
※カンマ区切り		 部屋数を指定
数値で一致/以上/以下/範囲の指定が可能です。
  • 範囲指定[number,number]
    '1,10' ;1から10
  • 条件指定[operator,number]
    '>=,10' ;10以上
  • 指定可能operator
    '=,>,<,>=,<=,!='
area_size
array[string]
※カンマ区切り		 面積を指定。単位は㎡。
数値で一致/以上/以下/範囲の指定が可能です。
  • 範囲指定[number,number]
    '1,10' ;1から10
  • 条件指定[operator,number]
    '>=,10' ;10以上
  • 指定可能operator
    '=,>,<,>=,<=,!='
total_area_size
array[string]
※カンマ区切り		 延べ床面積を指定。単位は㎡。
数値で一致/以上/以下/範囲の指定が可能です。
  • 範囲指定[number,number]
    '1,10' ;1から10
  • 条件指定[operator,number]
    '>=,10' ;10以上
  • 指定可能operator
    '=,>,<,>=,<=,!='
build_year
array[string]
※カンマ区切り		 建築年を指定。YYYYで指定してください。
数値で一致/以上/以下/範囲の指定が可能です。
※本パラメータはオプションとなります。
  • 範囲指定[number,number]
    '1,10' ;1から10
  • 条件指定[operator,number]
    '>=,10' ;10以上
  • 指定可能operator
    '=,>,<,>=,<=,!='
building_structure1
array[integer]
 建物構造(大分類)を指定(複数指定可)
指定がない場合絞り込みなしとなります。
※本パラメータはオプションとなります。
  • 0

    非木造

  • 1

    木造
building_structure2
array[integer]
 建物構造(詳細分類)を指定(複数指定可)
指定がない場合絞り込みなしとなります。
※本パラメータはオプションとなります。
  • 1

    木造

  • 2

    鉄骨造

  • 3

    鉄筋コンクリート造

  • 4

    鉄筋鉄骨コンクリート造

  • 5

    軽量鉄骨造

  • 6

    ブロック造

  • 7

    その他
ownership_type
array[integer]
 所有種別を指定(複数指定可)
指定がない場合絞り込みなしとなります。
※本パラメータはオプションとなります。
  • 1

    分譲

  • 2

    賃貸
sort
array[string]		 出力順を指定(複数指定可)
デフォルトは昇順です。降順指定の場合、ソートキーの前方にマイナス(-)を付加してください。
(sortを指定しない場合データ格納順で出力されます)
zid
建物ZID
zid_attr
属性ZID
name
名称
name_read_through
名称読み下し
building_type
区分
building_top_floor_num
建物の最上階数
building_bottom_floor_num
建物の地下階数
room_count
部屋数
area_size
面積
total_area_size
延べ床面積
distance
検索座標と建物代表点の直線距離
limit
array[integer]
※カンマ区切り
default List[0,100]		 検索結果取得件数を"オフセット,件数"で指定
最大値 2000,1000
datum
string
default JGD		 入出力座標の測地系を指定
JGD
世界測地系
TOKYO
日本測地系
TOKYO_NAVI
日本測地系(ゼンリン ナビ地図)

Responses

エラーについては「エラーメッセージ一覧」を参照してください。

Media type:application/json

キー名 説明
status
string
 		ステータス
result info hit
integer
 検索結果総数
item zid
string		 建物ZID
建物等の地物毎にふられるパーマネントのID
zid_attr
string		 属性ZID
地物内のテナント施設等といった属性情報毎にふられるパーマネントのID
building_name
string		 建物名称
name
string		 名称
name_read_through
string		 名称読み下し(全角カタカナ)
post_code
string		 郵便番号
address_code
string		 住所コード
address
string		 住所
room_count
integer		 部屋数
tenant_floor_type
integer		 階数種別
該当階の地上、地下などの種別です。
  • 0

    無効値

  • 1

    地上

  • 2

    地下

  • 3

    中地上

  • 4

    中地下

  • 5

    屋上
tenant_floor
string		 テナント・部屋の階数
tenant_floor_num
integer		 テナント・部屋の階数数値
tenant_room_name
string		 部屋名称
building_type
integer		 建物・テナントを判別する区分
  • 1

    テナント

  • 3

    建物
building_top_floor_num
integer		 建物の最上階数
building_bottom_floor_num
integer		 建物の地下階数
(地下階が存在しない場合は0、地下階数が不明な場合は-1が返却されます。)
position ["経度","緯度"]
area_size
integer		 面積(単位:m² 平方メートル)
total_area_size
integer		 延べ床面積(単位:m² 平方メートル)
distance
number		 検索座標と代表点の直線距離(proximityを指定した場合のみ返却)
単位はｍ

Example

■boundary(座標を結んだ矩形の範囲)指定
　boundary:139.717405 35.650959,139.748235 35.661923,139.707654 35.669526,139.717405 35.650959

リクエストURL 
https://[domain]/data-coding/targeting?boundary=139.717405%2035.650959%2C139.748235%2035.661923%2C139.707654%2035.669526%2C139.717405%2035.650959&word_match_type=3&limit=0,100&datum=JGD
 レスポンス 
{
  "status": "OK",
  "result": {
      "info": {
          "hit": 46377
      },
      "item": [
          {
              "zid": "307803340446764969",
              "zid_attr": "1",
              "building_name": null,
              "name": null,
              "name_read_through": null,
              "post_code": "107-0062",
              "address_code": "131030250060000500005",
              "address": "東京都港区南青山6丁目5-45",
              "room_count": 1,
              "tenant_floor_type": 0,
              "tenant_floor": null,
              "tenant_floor_num": null,
              "tenant_room_name": null,
              "building_type": 3,
              "building_top_floor_num": 2,
              "building_bottom_floor_num": -1,
              "position": [
                  139.71715684678819,
                  35.66097140842014
              ],
              "area_size": 155,
              "total_area_size": 310,
              "distance": null
          },
          ...
      ]
  }
}

■proximity(中心座標と半径で指定した範囲)指定
　proximity:139.74536,35.658878,200(m)

リクエストURL 
          https://[domain]/data-coding/targeting?proximity=139.74536,35.658878,2008&word=%E6%9D%B1%E4%BA%AC&word_match_type=3&limit=0,100&datum=JGD
 レスポンス 
{
  "status": "OK",
  "result": {
      "info": {
          "hit": 2838
      },
      "item": [
          {
              "zid": "308867667702363608",
              "zid_attr": "308231633780092229",
              "building_name": "東京都東京港管理事務所",
              "name": "東京都東京港管理事務所",
              "name_read_through": null,
              "post_code": "105-0022",
              "address_code": "131030070020000700002",
              "address": "東京都港区海岸2丁目7-104",
              "room_count": 2,
              "tenant_floor_type": 0,
              "tenant_floor": null,
              "tenant_floor_num": null,
              "tenant_room_name": null,
              "building_type": 3,
              "building_top_floor_num": 5,
              "building_bottom_floor_num": -1,
              "position": [
                  139.76059868706596,
                  35.65125868055556
              ],
              "area_size": 686,
              "total_area_size": 3430,
              "distance": 1616.61
          },
          ...
      ]
  }
}