premium
building_pos

建物・テナント座標検索

緯度経度座標位置から該当の建物内のテナントや部屋情報を検索します。

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

https://[domain]/search/building_pos

HTTP request method

POST/GET

ContentType

application/x-www-form-urlencoded

Parameters

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

名前	説明
position*required array[number] ※カンマ区切り	座標を指定 "経度,緯度"で指定してください。
building_shape boolean default false	建物形状、面積、周辺長の取得有無 true 取得する false 取得しない
sort_attribute array[string]	attribute内の出力順を指定(複数指定可) デフォルトは昇順です。降順指定の場合、ソートキーの前方にマイナス(-)を付加してください。入居者情報を含めたソートになります。個人情報の取り扱いの観点から入居者情報は返却されません。 name テナント名称 floor_sort フロア階数 tenant_room_name 部屋名称
pastmap_year array[integer] ※カンマ区切り	premium 過去地図年度を指定(複数指定可) ※本パラメータを利用するには別途契約が必要です。 ※地域と提供年の組み合わせについては「過去地図データ提供地区一覧表」をご参照ください。
pastmap_id array[integer]	premium 過去地図管理IDを指定(複数指定可) ※本パラメータを利用するには別途契約が必要です。
datum string default JGD	入出力座標の測地系を指定 JGD 世界測地系 TOKYO 日本測地系 TOKYO_NAVI 日本測地系(ゼンリンナビ地図)

Responses

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

Media type:application/json

Status Code:200

キー名				説明
status string				ステータス
result
	item
		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		部屋数
		parking_exist_flag integer		駐車場有無 0 未調査 1 あり(一般車両) 2 あり(一般車両、大型車両)
		building_top_floor_num integer		建物の最上階数
		building_bottom_floor_num integer		建物の地下階数 (地下階が存在しない場合は0、地下階数が不明な場合は-1が返却されます。)
		position array[number]		["経度","緯度"]
		building_shape string		建物形状ポリゴン(GeoJSON形式) 建物形状取得有を指定した場合のみ返却します。
		shape_area number		建物面積(単位:m² 平方メートル) 建物形状取得有を指定した場合のみ返却します。
		shape_length number		建物形状ポリゴンより計算した周辺長(単位:m メートル) 建物形状取得有を指定した場合のみ返却します。
		pastmap_id integer		premium 過去地図管理ID(過去地図データの場合のみ) ※本パラメータを利用するには別途契約が必要です。
		pastmap_year integer		premium 過去地図年度(過去地図データの場合のみ) ※本パラメータを利用するには別途契約が必要です。
		attribute		テナント・部屋の情報
			zid_attr string	属性ZID 建物や地物内のテナント施設等といった属性情報毎にふられるパーマネントのID
			id_attr string	ID(属性) 属性ZIDを0パディングし22桁に揃えた文字列
			name string	テナント名称 ※building_typeが２”個人表札”の場合、個人情報の関係からNULL値となります。
			name_read string	名称読み
			name_read_through string	名称読み下し
			building_type integer	建物・テナントなどを判別する区分 1 テナント 2 個人表札
			tenant_floor_type integer	階数種別。該当階の地上、地下などの種別 0 無効値 1 地上 2 地下 3 中地上 4 中地下 5 屋上
			tenant_floor string	テナント・部屋の階数
			tenant_floor_num integer	テナント・部屋の階数数値
			tenant_room_name string	部屋名称
		attribute_count integer		テナント・部屋レコード数

Example

リクエストURL

https://[domain]/search/building_pos?position=139.723646,35.651638&building_shape=true&datum=JGD

レスポンス

{
  "status": "OK",
  "result": {
    "item": [
      {
        "zid": "307803340446770134",
        "id": "0000307803340446770134",
        "zid_attr": "000000000000000000",
        "id_attr": "000000000000000000",
        "building_name": "○○○○○○○広尾",
        "building_name_read": null,
        "building_name_read_through": null,
        "building_type": 3,
        "building_use": null,
        "building_use_level": null,
        "post_code": "106-0047",
        "address_code": "1310310026100050001600003",
        "address": "東京都港区南麻布５丁目○－○",
        "room_count": 23,
        "parking_exist_flag": 0,
        "building_top_floor_num": 5,
        "building_bottom_floor_num": 1,
        "position": [
          139.723652072483,
          35.6515923394097
        ],
        "building_shape": {
          "type": "MultiPolygon",
          "coordinates": [
            [
              [
                [
                  139.723814290365,
                  35.6516715494792
                ],
                [
                  139.723698187934,
                  35.6514472113715
                ],
                ・・・
        },
        "shape_area": 683.3320979177952,
        "shape_length": 121.33830121894884,
        "pastmap_id": null,
        "pastmap_year": null,
        "attribute": [
          {
            "zid_attr": "1748578671490277012",
            "id_attr": "0001748578671490277012",
            "name": ○○○○○○○,
            "name_read": null,
            "name_read_through": null,
            "building_type": 1,
            "tenant_floor": "4F",
            "tenant_floor_num": 4,
            "tenant_room_name": "402"
          },
          ・・・
        "attribute_count": 23
      }
    ]
  }
}

premiumbuilding_pos