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_use
array[integer]
※カンマ区切り 		建物用途を指定（複数指定可）
デフォルト指定はありません。
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_use
string
 建物用途
building_use_level
string
 建物用途の推定情報
  • BまたはX:ゼンリン住宅地図データと他社出典データ
    ※B,Xはデータ上の管理を目的とした区分でありご利用時に区別いただく必要はありません。
  • D:ゼンリン住宅地図データ
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を指定した場合のみ返却)
単位はｍ
build_year
integer
 建築年
build_year_month_level
string
 建築年の推定情報
  • B:ゼンリン住宅地図データと他社出典データ
  • D:ゼンリン住宅地図データ
    ※D1,D2,D3を含みますが数字はデータ上の管理番号でありご利用時に区別いただく必要はありません。
building_structure1
integer
 建物構造(大分類)
  • 0:非木造
  • 1:木造
building_structure2
integer
 建物構造(詳細分類)
  • 1:木造
  • 2:鉄骨造
  • 3:鉄筋コンクリート造
  • 4:鉄筋鉄骨コンクリート造
  • 5:軽量鉄骨造
  • 6:ブロック造
  • 7:その他
building_structure_level
string
 建物構造の推定情報
  • B:ゼンリン住宅地図データと他社出典データ
  • D:ゼンリン住宅地図データ
ownership_type
integer
 分譲/賃貸区分
  • 1:分譲
  • 2:賃貸
ownership_type_level
string
 分譲/賃貸区分の推定情報
  • B:ゼンリン住宅地図データと他社出典データ
  • D:ゼンリン住宅地図データ

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_use": null,
              "building_use_level": null,
              "building_top_floor_num": 2,
              "building_bottom_floor_num": -1,
              "position": [
                  139.71715684678819,
                  35.66097140842014
              ],
              "area_size": 155,
              "total_area_size": 310,
              "distance": null,
              "build_year": 1995,
              "build_year_month_level": "B",
              "building_structure1": 1,
              "building_structure2": 1,
              "building_structure_level": "B",
              "ownership_type": null,
              "ownership_type_level": 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_use": null,
              "building_use_level": null,
              "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,
              "build_year": 1995,
              "build_year_month_level": "D",
              "building_structure1": 0,
              "building_structure2": null,
              "building_structure_level": "D",
              "ownership_type": null,
              "ownership_type_level": null
          },
          ...
      ]
  }
}