premium
building_zid_premium

ZID検索(属性付与)

建物データを対象にZIDの存在有無、建物情報を取得します。

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

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

HTTP request method

POST/GET

ContentType

application/x-www-form-urlencoded

Parameters

*requiredは必須
Array型のパラメータの区切り文字は特記のない限りカンマ(,)およびセミコロン(;)です。

名前	説明
zid*required array[integer]	建物ZIDを指定(複数指定可) 建物等の地物毎にふられるパーマネントのID 100件まで
building_shape boolean default false	建物形状の取得有無 true 取得する false 取得しない
datum string default JGD	入出力座標の測地系を指定 JGD 世界測地系 TOKYO 日本測地系 TOKYO_NAVI 日本測地系(ゼンリンナビ地図)

Responses

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

Media type:application/json

Status Code:200

キー名				説明
status string				ステータス
result	item	exist boolean		存在有無 true データあり false データなし
		input_zid string		入力されたZID
		attribute		建物情報 existがfalseの場合null
			zid string	建物ZID 建物等の地物毎にふられるパーマネントのID
			id string	ID(地物) 建物ZIDを0パディングし22桁に揃えた文字列
			zid_attr string	属性ZID 建物や地物内のテナント施設等といった属性情報毎にふられるパーマネントのID
			id_attr string	ID(属性) 属性ZIDを0パディングし22桁に揃えた文字列
			building_name string	建物名称
			building_name_read string	建物名称読み常にnullです
			building_name_read_through string	建物名称読み下し読みと読み下しの違いは以下の通り・読み：英数字は英数字のまま返却・読み下し：英数字の読みを返却（例：１→イチ、A→エー） ※いずれか、もしくはいずれもnullで返却される場合があります
			building_type integer	建物・テナント等を判別する区分 3 建物
			building_use string	建物用途 ※データがレスポンスされるのは2024年11月中を予定しています。それまでの期間はnullとなります。 1001 専用住宅 1002 ｱﾊﾟｰﾄ・ﾏﾝｼｮﾝ 1003 公営住宅 1004 寮・社宅 2000 事業施設(未分類) 2001 官公庁施設 2002 文化施設 2003 教育施設 2004 厚生施設 2005 業務施設 2006 商業施設 2007 宿泊施設 2008 交通施設 2009 物流施設 2010 インフラ施設 2011 工場 2012 農林水産施設 2013 防衛施設 3001 店舗等併用住宅 3002 作業所併用住宅 3003 併用ｱﾊﾟｰﾄ・ﾏﾝｼｮﾝ 3004 併用公営住宅 3005 併用寮・社宅 3006 商業系用途複合施設 9999 その他（用途推定不可な建物）
			building_use_level string	建物用途の推定情報 ※データがレスポンスされるのは2024年11月中を予定しています。それまでの期間はnullとなります。 BまたはX:ゼンリン住宅地図データと他社出典データ ※B,Xはデータ上の管理を目的とした区分でありご利用時に区別いただく必要はありません。 D:ゼンリン住宅地図データ
			post_code string	郵便番号
			address_code string	住所コード
			address string	住所
			room_count integer	部屋数
			building_top_floor_num integer	建物の最上階数
			building_bottom_floor_num integer	建物の地下階数 (地下階が存在しない場合は0、地下階数が不明な場合は-1が返却されます。)
			position array[number]	["経度","緯度"]
			shape_area number	面積(単位:m² 平方メートル)
			shape_length number	周辺長(単位:m メートル)
			building_shape string	建物形状ポリゴン(GeoJSON形式) 建物形状取得有を指定した場合のみ返却します。
			build_year integer	建築年
			build_year_month_level string	建築年の推定情報 B ゼンリン住宅地図データと他社出典データ D ゼンリン住宅地図データ
			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

リクエストURL

https://[domain]/data-coding/building_zid_premium?zid=308791801400040964&building_shape=true&datum=JGD

レスポンス

{
  "status": "OK",
  "result": {
      "item": [
          {
              "exist": true,
              "input_zid": "308791801400040964",
              "attribute": {
                  "zid": "308791801400040964",
                  "id": "0000308791801400040964",
                  "zid_attr": "308795683245262506",
                  "id_attr": "0000308795683245262506",
                  "building_name": "品川インターシティC棟",
                  "building_name_read": null,
                  "building_name_read_through": null,
                  "building_type": 3,
                  "building_use": null,
                  "building_use_level": null,
                  "post_code": "108-0075",
                  "address_code": "131030090020001500003",
                  "address": "東京都港区港南2丁目15-3",
                  "room_count": 53,
                  "building_top_floor_num": 31,
                  "building_bottom_floor_num": 2,
                  "position": [
                      139.7420556640625,
                      35.62540635850694
                  ],
                  "shape_area": 3286,
                  "shape_length": 240,
                  "building_shape": {
                      "type": "MultiPolygon",
                      "coordinates": [
                          [
                              [
                                  [
                                      139.742142740885,
                                      35.6251011827257
                                  ],
                                  [
                                      139.742052680122,
                                      35.6250868055556
                                  ],
                                  [
                                      139.742050238715,
                                      35.62509765625
                                  ],
                                  ...
                              ]
                          ]
                      ]
                  },
                  "build_year": 1998,
                  "build_year_month_level": "D",
                  "building_structure1": 0,
                  "building_structure2": null,
                  "building_structure_level": "D",
                  "ownership_type": 1,
                  "ownership_type_level": "D"
              }
          }
      ]
  }
}