@viadukt/connect 2.12.0 → 3.0.0-next.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Options } from '@hey-api/client-fetch';
 export { createClient } from '@hey-api/client-fetch';
 
-declare const $LookupPropertiesV2: {
+declare const $LookupPropertiesV3: {
     readonly type: "object";
     readonly properties: {
         readonly street: {
@@ -60,21 +60,6 @@ declare const $LookupPropertiesV2: {
             readonly example: 127.42;
             readonly deprecated: true;
         };
-        readonly height_category: {
-            readonly type: readonly ["string", "null"];
-            readonly enum: readonly ["<= 5m", "<= 7.5m", "<= 10m", "<= 12.5m", "<= 15m", "> 15m"];
-            readonly description: "\nThe `height_category` field specifies the height category of the building. The height category is a\nnumber between 1 and 6, where 1 is the lowest and 6 is the highest category.\n\n### Classifications\n\n- **1**: <= 5m\n- **2**: <= 7.5m\n- **3**: <= 10m\n- **4**: <= 12.5m\n- **5**: <= 15m\n- **6**: > 15m\n\nIf the height category is unknown, the field is set to `null`.\n\n<br /><br />**Warning:**<br /><br />\n\nThis field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.\n    ";
-            readonly example: "<= 5m";
-            readonly deprecated: true;
-        };
-        readonly height_category_class: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 1;
-            readonly maximum: 6;
-            readonly description: "\nThe `height_category_class` field specifies the height category of the building. The height category is a\nnumber between 1 and 6, where 1 is the lowest and 6 is the highest category.\n\n### Classifications\n\n- **1**: <= 5m\n- **2**: <= 7.5m\n- **3**: <= 10m\n- **4**: <= 12.5m\n- **5**: <= 15m\n- **6**: > 15m\n\nThe field is set to `null` if the number of height category is unknown.\n\n<br /><br />**Warning:**<br /><br />\n\nThis field is deprecated and will be no longer supported in future datasets.";
-            readonly example: 1;
-            readonly deprecated: true;
-        };
         readonly levels: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 1;
@@ -90,7 +75,7 @@ declare const $LookupPropertiesV2: {
         readonly net_area: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `net_area` field specifies the net area of the building in m².\n\nThe field is set to `null` if the net area is unknown.\n\nThe `net_area` was modeled according to the Raumwärmebedarfsmodell NRW as: \n`footprint_area` * `levels` * factors between 0.7 (inhabited) and 0.8 (non-inhabited)\nthe latter was done to concider e.g., inner wall area or staircases.";
+            readonly description: "\nThe `net_area` field specifies the net area of the building in m².\n\nThe field is set to `null` if the net area is unknown.\n\nThe `net_area` was modeled according to the Raumwärmebedarfsmodell NRW as:\n`footprint_area` * `levels` * factors between 0.7 (inhabited) and 0.8 (non-inhabited)\nthe latter was done to consider e.g., inner wall area or staircases.";
             readonly example: 127.42;
         };
         readonly footprint_area: {
@@ -99,32 +84,17 @@ declare const $LookupPropertiesV2: {
             readonly description: "\nThe `footprint_area` field specifies the footprint area of the building in m².\n\nThe field is set to `null` if the footprint area is unknown.";
             readonly example: 127.42;
         };
-        readonly usage: {
-            readonly type: readonly ["string", "null"];
-            readonly enum: readonly ["residential", "non_residential", "mixed_use"];
-            readonly description: "\nThe `usage` field specifies the usage of the building. This field can have one of the following values:\n\n- **residential**: Residential building\n- **non_residential**: Non-residential building\n- **mixed_use**: Mixed-use building\n\nIf the usage is unknown, the field is set to `null`.\n\n<br /><br />**Warning:**<br /><br />\n\nThis field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.";
-            readonly example: "residential";
-            readonly deprecated: true;
-        };
-        readonly usage_class: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 1;
-            readonly maximum: 3;
-            readonly description: "\nThe `usage_class` field specifies the usage of the building. This field can have one of the following values:\n\n- **1**: Residential building\n- **2**: Non-residential building\n- **3**: Mixed-use building\n\nIf the usage is unknown, the field is set to `null`.\n\n<br /><br />**Warning:**<br /><br />\n\nThis field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.";
-            readonly example: 1;
-            readonly deprecated: true;
-        };
         readonly characteristics: {
             readonly type: readonly ["string", "null"];
             readonly enum: readonly ["single_two_family", "row_semi_detached", "multi_family", "residential_block", "high_rise", "terrace", "farmhouse", "office_other", "factory_warehouse"];
-            readonly description: "\nThe `characteristics` field defines the different types of building characteristics. This classification includes \nvarious types of residential and non-residential buildings. This field can have one of the following values:\n\n- **single_two_family**: Single- or two-family house\n- **row_semi_detached**: Row or semi-detached house\n- **multi_family**: Multi-family house\n- **residential_block**: Residential block\n- **high_rise**: High-rise residential building\n- **terrace**: Terrace house\n- **farmhouse**: Farmhouse\n- **office_other**: Office or other building\n- **factory_warehouse**: Factory or warehouse building\n\nIf the characteristics is unknown, the field is set to `null`.";
+            readonly description: "\nThe `characteristics` field defines the different types of building characteristics. This classification includes\nvarious types of residential and non-residential buildings. This field can have one of the following values:\n\n- **single_two_family**: Single- or two-family house\n- **row_semi_detached**: Row or semi-detached house\n- **multi_family**: Multi-family house\n- **residential_block**: Residential block\n- **high_rise**: High-rise residential building\n- **terrace**: Terrace house\n- **farmhouse**: Farmhouse\n- **office_other**: Office or other building\n- **factory_warehouse**: Factory or warehouse building\n\nIf the characteristics is unknown, the field is set to `null`.";
             readonly example: "residential_block";
         };
         readonly characteristics_class: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 1;
             readonly maximum: 9;
-            readonly description: "\nThe `characteristics_class` field defines the different types of building characteristics. This classification includes \nvarious types of residential and non-residential buildings. This field can have one of the following values:\n\n- **1**: Single- or two-family house\n- **2**: Row or semi-detached house\n- **3**: Multi-family house\n- **4**: Residential block\n- **5**: High-rise residential building\n- **6**: Terrace house\n- **7**: Farmhouse\n- **8**: Office or other building\n- **9**: Factory or warehouse building\n\nIf the characteristics_class is unknown, the field is set to `null`.";
+            readonly description: "\nThe `characteristics_class` field defines the different types of building characteristics. This classification includes\nvarious types of residential and non-residential buildings. This field can have one of the following values:\n\n- **1**: Single- or two-family house\n- **2**: Row or semi-detached house\n- **3**: Multi-family house\n- **4**: Residential block\n- **5**: High-rise residential building\n- **6**: Terrace house\n- **7**: Farmhouse\n- **8**: Office or other building\n- **9**: Factory or warehouse building\n\nIf the characteristics_class is unknown, the field is set to `null`.";
             readonly example: 1;
         };
         readonly development_layout: {
@@ -154,7 +124,7 @@ declare const $LookupPropertiesV2: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 1;
             readonly maximum: 12;
-            readonly description: "\nThe `construction_year_range_class` field specifies the approximate construction year of the building and can have one of the following values: \n\n- **1**: < 1899\n- **2**: 1900 - 1945\n- **3**: 1946 - 1960\n- **4**: 1961 - 1970\n- **5**: 1971 - 1980\n- **6**: 1981 - 1985\n- **7**: 1986 - 1995\n- **8**: 1996 - 2000\n- **9**: 2001 - 2005\n- **10**: 2006 - 2010\n- **11**: 2011 - 2015\n- **12**: 2016 - 2024\n\nIf the construction year range class is unknown, the field is set to `null`.";
+            readonly description: "\nThe `construction_year_range_class` field specifies the approximate construction year of the building and can have one of the following values:\n\n- **1**: < 1899\n- **2**: 1900 - 1945\n- **3**: 1946 - 1960\n- **4**: 1961 - 1970\n- **5**: 1971 - 1980\n- **6**: 1981 - 1985\n- **7**: 1986 - 1995\n- **8**: 1996 - 2000\n- **9**: 2001 - 2005\n- **10**: 2006 - 2010\n- **11**: 2011 - 2015\n- **12**: 2016 - 2024\n\nIf the construction year range class is unknown, the field is set to `null`.";
             readonly example: 1;
         };
         readonly construction_year: {
@@ -194,32 +164,32 @@ declare const $LookupPropertiesV2: {
         readonly heat_pump_minimal_number_possible_drillings: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings` field specifies the minimum \nnumber of drillings required for a heat pump installation with a distance of 5m \nto the parcel border.\nThis field will be deprecated in future versions. Please use `heat_pump_minimal_number_possible_drillings_5m` instead.\n\nThe field is set to `null` if the information is unknown.\n\n<br /><br />**Deprecation Warning:**<br /><br />\n\nPlease use `heat_pump_minimal_number_possible_drillings_5m` instead of this field.";
+            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings` field specifies the minimum\nnumber of drillings required for a heat pump installation with a distance of 5m\nto the parcel border.\nThis field will be deprecated in future versions. Please use `heat_pump_minimal_number_possible_drillings_5m` instead.\n\nThe field is set to `null` if the information is unknown.\n\n<br /><br />**Deprecation Warning:**<br /><br />\n\nPlease use `heat_pump_minimal_number_possible_drillings_5m` instead of this field.";
             readonly example: 1;
             readonly deprecated: true;
         };
         readonly heat_pump_minimal_number_possible_drillings_5m: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_5m` field specifies the minimum \nnumber of drillings required for a heat pump installation with a distance of 5m \nto the parcel border.\n\nThe field is set to `null` if the information is unknown.";
+            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_5m` field specifies the minimum\nnumber of drillings required for a heat pump installation with a distance of 5m\nto the parcel border.\n\nThe field is set to `null` if the information is unknown.";
             readonly example: 1;
         };
         readonly heat_pump_minimal_number_possible_drillings_2m: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_2m` field specifies the minimum \nnumber of drillings required for a heat pump installation with a distance of 2m \nto the parcel border.\n\nThe field is set to `null` if the information is unknown.";
+            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_2m` field specifies the minimum\nnumber of drillings required for a heat pump installation with a distance of 2m\nto the parcel border.\n\nThe field is set to `null` if the information is unknown.";
             readonly example: 1;
         };
         readonly heat_pump_minimal_number_possible_drillings_no_distance: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_no_distance` field specifies the minimum \nnumber of drillings required for a heat pump installation with no distance to the parcel border.\n\nThe field is set to `null` if the information is unknown.";
+            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_no_distance` field specifies the minimum\nnumber of drillings required for a heat pump installation with no distance to the parcel border.\n\nThe field is set to `null` if the information is unknown.";
             readonly example: 1;
         };
         readonly heat_pump_collector_free_area: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_collector_free_area` field specifies the sum of the free area suitable \nfor a collector heat pump on parcels associated to a building.\n\nThe field is set to `null` if the information is unknown.";
+            readonly description: "\nThe `heat_pump_collector_free_area` field specifies the sum of the free area suitable\nfor a collector heat pump on parcels associated to a building.\n\nThe field is set to `null` if the information is unknown.";
             readonly example: 100;
         };
         readonly flood_potential: {
@@ -241,7 +211,7 @@ declare const $LookupPropertiesV2: {
                 };
             };
             readonly minItems: 1;
-            readonly description: "\nThe `flood_potential` field is an array representing different flood risk scenarios for a given \nlocation. The objects in the array can contain the following fields:\n\n- `min_reccurence`: The minimum expected recurrence interval for flooding, measured in years. \n  This field is optional and can be `null` if the data is unavailable. A lower value indicates more \n  frequent flooding.\n  \n- `max_reccurence`: The maximum expected recurrence interval for flooding, also in years. This \n  field is optional and can be `null`. If provided, this value represents the upper bound of the \n  flood risk interval. This field allows the specification of a range of recurrence intervals.\n  \n- `protection_against_floods`: A boolean flag indicating whether flood protection measures are in \n  place for the area. This field is optional and can be `null` if the information is not available. \n  A value of `true` means flood defenses are present, while `false` indicates the absence of such \n  measures.\n\nIf this array is set to `null`, it means that no data regarding flood potential is available for the location.";
+            readonly description: "\nThe `flood_potential` field is an array representing different flood risk scenarios for a given\nlocation. The objects in the array can contain the following fields:\n\n- `min_recurrence`: The minimum expected recurrence interval for flooding, measured in years.\n  This field is optional and can be `null` if the data is unavailable. A lower value indicates more\n  frequent flooding.\n\n- `max_recurrence`: The maximum expected recurrence interval for flooding, also in years. This\n  field is optional and can be `null`. If provided, this value represents the upper bound of the\n  flood risk interval. This field allows the specification of a range of recurrence intervals.\n\n- `protection_against_floods`: A boolean flag indicating whether flood protection measures are in\n  place for the area. This field is optional and can be `null` if the information is not available.\n  A value of `true` means flood defenses are present, while `false` indicates the absence of such\n  measures.\n\nIf this array is set to `null`, it means that no data regarding flood potential is available for the location.";
             readonly example: readonly [{
                 readonly min_recurrence: 100;
                 readonly max_recurrence: null;
@@ -321,37 +291,37 @@ declare const $LookupPropertiesV2: {
         readonly eave_above_ground_weighted: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `eave_above_ground_weighted` field specifies the weighted average height of the eave above ground [meters]. For weighting \nthe `footprint_area` of sub-geometries was used, if a building consists of multiple. This can be traced on the basis of the \nfield `number_original_geometries`.  \n\n\nThe field is set to `null` if the height is unknown.";
+            readonly description: "\nThe `eave_above_ground_weighted` field specifies the weighted average height of the eave above ground [meters]. For weighting\nthe `footprint_area` of sub-geometries was used, if a building consists of multiple. This can be traced on the basis of the\nfield `number_original_geometries`.\n\n\nThe field is set to `null` if the height is unknown.";
             readonly example: 11.398919537428867;
         };
         readonly eave_above_ground_min: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `eave_above_ground_min` field specifies the minimum height of the eave above ground [meters]. This is the minimal \n`eave_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis \nof the field `number_original_geometries`.\n\nThe field is set to `null` if the height is unknown.";
+            readonly description: "\nThe `eave_above_ground_min` field specifies the minimum height of the eave above ground [meters]. This is the minimal\n`eave_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis\nof the field `number_original_geometries`.\n\nThe field is set to `null` if the height is unknown.";
             readonly example: 5.7899932861328125;
         };
         readonly eave_above_ground_max: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `eave_above_ground_max` field specifies the maximum height of the eave above ground [meters]. This is the maximal \n`eave_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of \nthe field `number_original_geometries`.\n\n\nThe field is set to `null` if the height is unknown.";
+            readonly description: "\nThe `eave_above_ground_max` field specifies the maximum height of the eave above ground [meters]. This is the maximal\n`eave_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of\nthe field `number_original_geometries`.\n\n\nThe field is set to `null` if the height is unknown.";
             readonly example: 13.722991943359375;
         };
         readonly ridge_above_ground_weighted: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `ridge_above_ground_weighted` field specifies the weighted average height of the ridge above ground [meters]. For \nweighting the `footprint_area` of sub-geometries was used, if a building consists of multiple. This can be traced on the basis \nof the field `number_original_geometries`.  \n\nThe field is set to `null` if the height is unknown.";
+            readonly description: "\nThe `ridge_above_ground_weighted` field specifies the weighted average height of the ridge above ground [meters]. For\nweighting the `footprint_area` of sub-geometries was used, if a building consists of multiple. This can be traced on the basis\nof the field `number_original_geometries`.\n\nThe field is set to `null` if the height is unknown.";
             readonly example: 13.619256575276214;
         };
         readonly ridge_above_ground_min: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `ridge_above_ground_min` field specifies the minimum height of the ridge above ground [meters]. This is the minimal \n`ridge_above_ground within` a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of the \nfield `number_original_geometries`.  \n\nThe field is set to `null` if the height is unknown.";
+            readonly description: "\nThe `ridge_above_ground_min` field specifies the minimum height of the ridge above ground [meters]. This is the minimal\n`ridge_above_ground within` a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of the\nfield `number_original_geometries`.\n\nThe field is set to `null` if the height is unknown.";
             readonly example: 6.64300537109375;
         };
         readonly ridge_above_ground_max: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `ridge_above_ground_max` field specifies the maximum height of the ridge above ground [meters]. This is the maximal \n`ridge_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of the \nfield `number_original_geometries`.  \n\nThe field is set to `null` if the height is unknown.";
+            readonly description: "\nThe `ridge_above_ground_max` field specifies the maximum height of the ridge above ground [meters]. This is the maximal\n`ridge_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of the\nfield `number_original_geometries`.\n\nThe field is set to `null` if the height is unknown.";
             readonly example: 16.987991333007812;
         };
         readonly number_original_geometries: {
@@ -366,21 +336,16 @@ declare const $LookupPropertiesV2: {
             readonly description: "\nThe `roof_area` field specifies the total roof area of the building [square meters].\n\nThe field is set to `null` if the roof area is unknown.";
             readonly example: 355.37342071533203;
         };
-        readonly ogc_fid: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `ogc_fid` field specifies a unique identifier from the LOD2 dataset.\n\nThe field is set to `null` if the identifier is unavailable.";
-            readonly example: "DENW29AL1000FzW2";
-        };
         readonly outer_wall_area_free: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `outer_wall_area_free` field specifies the facade area free of adjacent structures [square meters].  \n\nThe field is set to `null` if the area is unknown.";
+            readonly description: "\nThe `outer_wall_area_free` field specifies the facade area free of adjacent structures [square meters].\n\nThe field is set to `null` if the area is unknown.";
             readonly example: 690.5686635568186;
         };
         readonly outer_wall_area_shared_heated: {
             readonly type: readonly ["number", "null"];
             readonly minimum: 0;
-            readonly description: "\nThe `outer_wall_area_shared_heated` field specifies the facade area shared with heated adjacent structures [square meters].  \n\nThe field is set to `null` if the area is unknown.";
+            readonly description: "\nThe `outer_wall_area_shared_heated` field specifies the facade area shared with heated adjacent structures [square meters].\n\nThe field is set to `null` if the area is unknown.";
             readonly example: 202.10705297163204;
         };
         readonly outer_wall_area_shared_non_heated: {
@@ -418,423 +383,38 @@ declare const $LookupPropertiesV2: {
             readonly description: "\nThe `building_function_class` field specifies the standardized English classification of the building function according to the German GFK (Gebäudefunktionsklasse) standard.\n\nThis field categorizes buildings by their primary use or purpose, such as residential, commercial, industrial, public, or mixed-use functions.\n\nThe field is set to `null` if the building function class is unknown.";
             readonly example: "residential_building";
         };
-    };
-    readonly required: readonly ["street", "city", "street_number", "postcode", "roof_type", "type", "type_class", "water_protected", "heated", "heat_demand", "height_category", "height_category_class", "levels", "household_count", "net_area", "footprint_area", "usage", "usage_class", "characteristics", "characteristics_class", "development_layout", "development_layout_class", "construction_year_range", "construction_year_range_class", "construction_year", "heritage", "geo_conductivity_100", "heat_pump_air_possible", "heat_pump_maximal_distance_drillings", "heat_pump_maximal_distance_drillings_5m", "heat_pump_minimal_number_possible_drillings", "heat_pump_minimal_number_possible_drillings_5m", "heat_pump_minimal_number_possible_drillings_2m", "heat_pump_minimal_number_possible_drillings_no_distance", "heat_pump_collector_free_area", "flood_potential", "photovoltaic_potential", "solarthermal_potential", "matching_addresses", "eave_above_ground_weighted", "eave_above_ground_min", "eave_above_ground_max", "ridge_above_ground_weighted", "ridge_above_ground_min", "ridge_above_ground_max", "number_original_geometries", "roof_area", "ogc_fid", "outer_wall_area_free", "outer_wall_area_shared_heated", "outer_wall_area_shared_non_heated", "plinth_length_free", "plinth_length_shared_heated", "plinth_length_shared_non_heated", "building_function", "building_function_class"];
-};
-declare const $LookupPropertiesV3: {
-    readonly type: "object";
-    readonly properties: {
-        readonly street: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `street` field specifies the street name of a building.\n\nThe field is set to `null` if the street is unknown.";
-            readonly example: "Friedrich Ebert Straße";
-        };
-        readonly city: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `city` field specifies the city name of a building.\n\nThe field is set to `null` if the city is unknown.";
-            readonly example: "Wuppertal";
-        };
-        readonly street_number: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `street_number` field specifies the street number name of a building.\n\nThe field is set to `null` if the street number is unknown.";
-            readonly example: "107";
-        };
-        readonly postcode: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `postcode` field specifies the postcode of a building.\n\nThe field is set to `null` if the postcode is unknown.";
-            readonly example: "107";
-        };
-        readonly roof_type: {
-            readonly type: readonly ["string", "null"];
-            readonly enum: readonly ["flat", "pitched", "mixed"];
-            readonly description: "\nThe `roof_type` field specifies the type of roof of a building. This field can have one of the following values:\n\n- **flat**: Flat roof\n- **pitched**: Pitched roof\n- **mixed**: Mixed types of roofs\n\nThe field is set to `null` if the building type is unknown.";
-            readonly example: "flat";
+        readonly grouping_strategy: {
+            readonly type: "string";
+            readonly enum: readonly ["proximity", "property"];
+            readonly default: "proximity";
+            readonly description: "The grouping strategy used to aggregate buildings in this result. Currently supports: proximity (cadastral based clustering) and property (cadastral, address, construction year, and roof type based grouping). Defaults to `proximity` when no strategy is specified in the request.";
+            readonly example: "proximity";
         };
-        readonly type: {
+        readonly ogc_fid: {
             readonly type: readonly ["string", "null"];
-            readonly enum: readonly ["single_family", "multi_family", "non_residential", "mixed_use"];
-            readonly description: "\nThe `type` field specifies the type of building. This field can have one of the following values:\n\n- **single_family**: Single-family house\n- **multi_family**: Multi-family house\n- **non_residential**: Non-residential building\n- **mixed_use**: Mixed-use building\n\nThe field is set to `null` if the building type is unknown.";
-            readonly example: "single_family";
-        };
-        readonly type_class: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 1;
-            readonly maximum: 4;
-            readonly description: "\nThe `type_class` field specifies the class of the building type. This field can have one of the following values:\n\n- **1**: Single-family house\n- **2**: Multi-family house\n- **3**: Non-residential building\n- **4**: Mixed-use building\n\nThe field is set to `null` if the building type is unknown.";
-            readonly example: 1;
-        };
-        readonly water_protected: {
-            readonly type: readonly ["boolean", "null"];
-            readonly description: "\nThe `water_protected` field specifies whether the building is within a water protection area.\n\nIf the field is set to `null`, no water protection area could be assigned.";
-            readonly example: true;
-        };
-        readonly heated: {
-            readonly type: readonly ["boolean", "null"];
-            readonly description: "\nThe `heated` field specifies whether the building is heated or not.\n\nThe field is set to `null` if the heating status is unknown.";
-            readonly example: true;
-        };
-        readonly heat_demand: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `heat_demand` field specifies the heat demand of the building in [kWh/m²a].\n\nThis attribute is deprecated and thus always set to `null`.\n\n<br /><br />**Warning:**<br /><br />\n\nThis field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.\n    ";
-            readonly example: 127.42;
+            readonly description: "\nThe `ogc_fid` field specifies a unique identifier from the LOD2 dataset. **This field is deprecated** and should no longer be used for identifying buildings.\n\nFor current and future use, refer to `building_id` (for the building geometry) or `building_address_id` (for a unique building-address combination) instead.\n\nThe field is set to `null` if the identifier is unavailable.";
+            readonly example: "DENW29AL1000FzW2";
             readonly deprecated: true;
         };
-        readonly levels: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 1;
-            readonly description: "\nThe `levels` field specifies the number of levels in the building.\n\nThe field is set to `null` if the number of levels is unknown.";
-            readonly example: 4;
-        };
-        readonly household_count: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `household_count` field specifies the number of households in the building.\n\nThe field is set to `null` if the number of households is unknown.";
-            readonly example: 3;
-        };
-        readonly net_area: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `net_area` field specifies the net area of the building in m².\n\nThe field is set to `null` if the net area is unknown.\n\nThe `net_area` was modeled according to the Raumwärmebedarfsmodell NRW as: \n`footprint_area` * `levels` * factors between 0.7 (inhabited) and 0.8 (non-inhabited)\nthe latter was done to concider e.g., inner wall area or staircases.";
-            readonly example: 127.42;
-        };
-        readonly footprint_area: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `footprint_area` field specifies the footprint area of the building in m².\n\nThe field is set to `null` if the footprint area is unknown.";
-            readonly example: 127.42;
-        };
-        readonly characteristics: {
+        readonly federal_state: {
             readonly type: readonly ["string", "null"];
-            readonly enum: readonly ["single_two_family", "row_semi_detached", "multi_family", "residential_block", "high_rise", "terrace", "farmhouse", "office_other", "factory_warehouse"];
-            readonly description: "\nThe `characteristics` field defines the different types of building characteristics. This classification includes \nvarious types of residential and non-residential buildings. This field can have one of the following values:\n\n- **single_two_family**: Single- or two-family house\n- **row_semi_detached**: Row or semi-detached house\n- **multi_family**: Multi-family house\n- **residential_block**: Residential block\n- **high_rise**: High-rise residential building\n- **terrace**: Terrace house\n- **farmhouse**: Farmhouse\n- **office_other**: Office or other building\n- **factory_warehouse**: Factory or warehouse building\n\nIf the characteristics is unknown, the field is set to `null`.";
-            readonly example: "residential_block";
-        };
-        readonly characteristics_class: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 1;
-            readonly maximum: 9;
-            readonly description: "\nThe `characteristics_class` field defines the different types of building characteristics. This classification includes \nvarious types of residential and non-residential buildings. This field can have one of the following values:\n\n- **1**: Single- or two-family house\n- **2**: Row or semi-detached house\n- **3**: Multi-family house\n- **4**: Residential block\n- **5**: High-rise residential building\n- **6**: Terrace house\n- **7**: Farmhouse\n- **8**: Office or other building\n- **9**: Factory or warehouse building\n\nIf the characteristics_class is unknown, the field is set to `null`.";
-            readonly example: 1;
+            readonly description: "\nThe `federal_state` field specifies the German federal state (Bundesland) in which the building is located.\n\nGermany is divided into 16 federal states:\n\n- Baden-Württemberg\n- Bayern (Bavaria)\n- Berlin\n- Brandenburg\n- Bremen\n- Hamburg\n- Hessen\n- Mecklenburg-Vorpommern\n- Niedersachsen (Lower Saxony)\n- Nordrhein-Westfalen (North Rhine-Westphalia)\n- Rheinland-Pfalz (Rhineland-Palatinate)\n- Saarland\n- Sachsen (Saxony)\n- Sachsen-Anhalt (Saxony-Anhalt)\n- Schleswig-Holstein\n- Thüringen (Thuringia)\n\nThe field is set to `null` if the federal state is unknown.";
+            readonly example: "Nordrhein-Westfalen";
         };
-        readonly development_layout: {
+        readonly country_code: {
             readonly type: readonly ["string", "null"];
-            readonly enum: readonly ["non_detached", "semi_detached", "detached"];
-            readonly description: "\nThe `development_layout` field specifies the layout of the building. This field can have one of the following values:\n\n- **non_detached**: Non-detached building\n- **semi_detached**: Semi-detached building\n- **detached**: Detached building\n\nIf the development layout is unknown, the field is set to `null`.\n\nThe `development_layout` was modeled based on the number and length of intersections with heated (and buildings with unknown heating status)\n neighbouring buildings and the perimeter of a geometry as follows:\n\n**detached** = intersection_length / outline_length < 0.085\n**semi_detached** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.45 for buildings with exactly 1 intersection\n**semi_detached** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.15 for buildings with more than 1 intersections\n**non_detached** = for all other buildings";
-            readonly example: "non_detached";
-        };
-        readonly development_layout_class: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 1;
-            readonly maximum: 3;
-            readonly description: "\nThe `development_layout_class` field specifies the layout of the building. This field can have one of the following values:\n\n- **1**: Non-detached building\n- **2**: Semi-detached building\n- **3**: Detached building\n\nIf the development layout is unknown, the field is set to `null`.\n\nThe `development_layout_class` was modeled based on the number and length of intersections with heated (and buildings with unknown heating status)\n neighbouring buildings and the perimeter of a geometry as follows:\n\n**1** = intersection_length / outline_length < 0.085\n**2** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.45 for buildings with exactly 1 intersection\n**2** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.15 for buildings with more than 1 intersections\n**3** = for all other buildings";
-            readonly example: 1;
-        };
-        readonly construction_year_range: {
-            readonly type: readonly ["array", "null"];
-            readonly prefixItems: readonly [{
-                readonly type: readonly ["number", "null"];
-            }, {
-                readonly type: "number";
-            }];
-            readonly description: "\nThe `construction_year_range` field specifies the approximate construction year of the building. The field is a tuple with two\nvalues: the lower and upper bound of the construction year and can have one of the following value:\n\n- **[*null*, 1899]**: Construction year is somewhere up to 1899\n- **[1900, 1945]**\n- **[1946, 1960]**\n- **[1961, 1970]**\n- **[1971, 1980]**\n- **[1981, 1985]**\n- **[1986, 1995]**\n- **[1996, 2000]**\n- **[2001, 2005]**\n- **[2006, 2010]**\n- **[2011, 2015]**\n- **[2016, 2024]**\n\nIf the construction year class is unknown, the field is set to `null`.";
-            readonly example: readonly [1990, 1995];
-        };
-        readonly construction_year_range_class: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 1;
-            readonly maximum: 12;
-            readonly description: "\nThe `construction_year_range_class` field specifies the approximate construction year of the building and can have one of the following values: \n\n- **1**: < 1899\n- **2**: 1900 - 1945\n- **3**: 1946 - 1960\n- **4**: 1961 - 1970\n- **5**: 1971 - 1980\n- **6**: 1981 - 1985\n- **7**: 1986 - 1995\n- **8**: 1996 - 2000\n- **9**: 2001 - 2005\n- **10**: 2006 - 2010\n- **11**: 2011 - 2015\n- **12**: 2016 - 2024\n\nIf the construction year range class is unknown, the field is set to `null`.";
-            readonly example: 1;
-        };
-        readonly construction_year: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `construction_year` field specifies the construction year of the building.\n\nIf the construction year is unknown, the field is set to `null`.";
-            readonly example: 1993;
-        };
-        readonly heritage: {
-            readonly type: readonly ["boolean", "null"];
-            readonly description: "\nThe `heritage` field specifies whether the building is under monumental protection.\n\nThe field is set to `null` if the heritage status is unknown.";
-            readonly example: true;
-        };
-        readonly geo_conductivity_100: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `geo_conductivity_100` field specifies the geothermal conductivity in 100 m depth.\n\nThe field is set to `null` if the geothermal conductivity is unknown.";
-            readonly example: 2;
-        };
-        readonly heat_pump_air_possible: {
-            readonly type: readonly ["boolean", "null"];
-            readonly description: "\nThe `heat_pump_air_possible` field indicates whether an air-source heat pump is a viable option for the building.\n\n- Set to `true` if an air-source heat pump is feasible.\n- Set to `false` if an air-source heat pump is not feasible.\n- Set to `null` if the information is unknown.";
-            readonly example: true;
-        };
-        readonly heat_pump_maximal_distance_drillings: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_maximal_distance_drillings` field specifies the maximum allowable distance between drillings for a heat pump installation, measured in meters.\nThis field will be deprecated in future versions. Please use `heat_pump_maximal_distance_drillings_5m` instead.\n\nThe field is set to `null` if the information is unknown.";
-            readonly example: 100;
-        };
-        readonly heat_pump_maximal_distance_drillings_5m: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_maximal_distance_drillings_5m` field specifies the maximum allowable distance between drillings for a heat pump installation, measured in meters.\n\nThe field is set to `null` if the information is unknown.";
-            readonly example: 100.35;
-        };
-        readonly heat_pump_minimal_number_possible_drillings: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings` field specifies the minimum \nnumber of drillings required for a heat pump installation with a distance of 5m \nto the parcel border.\nThis field will be deprecated in future versions. Please use `heat_pump_minimal_number_possible_drillings_5m` instead.\n\nThe field is set to `null` if the information is unknown.\n\n<br /><br />**Deprecation Warning:**<br /><br />\n\nPlease use `heat_pump_minimal_number_possible_drillings_5m` instead of this field.";
-            readonly example: 1;
-            readonly deprecated: true;
-        };
-        readonly heat_pump_minimal_number_possible_drillings_5m: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_5m` field specifies the minimum \nnumber of drillings required for a heat pump installation with a distance of 5m \nto the parcel border.\n\nThe field is set to `null` if the information is unknown.";
-            readonly example: 1;
-        };
-        readonly heat_pump_minimal_number_possible_drillings_2m: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_2m` field specifies the minimum \nnumber of drillings required for a heat pump installation with a distance of 2m \nto the parcel border.\n\nThe field is set to `null` if the information is unknown.";
-            readonly example: 1;
-        };
-        readonly heat_pump_minimal_number_possible_drillings_no_distance: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_minimal_number_possible_drillings_no_distance` field specifies the minimum \nnumber of drillings required for a heat pump installation with no distance to the parcel border.\n\nThe field is set to `null` if the information is unknown.";
-            readonly example: 1;
-        };
-        readonly heat_pump_collector_free_area: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `heat_pump_collector_free_area` field specifies the sum of the free area suitable \nfor a collector heat pump on parcels associated to a building.\n\nThe field is set to `null` if the information is unknown.";
-            readonly example: 100;
-        };
-        readonly flood_potential: {
-            readonly type: readonly ["array", "null"];
-            readonly items: {
-                readonly type: "object";
-                readonly properties: {
-                    readonly min_recurrence: {
-                        readonly type: readonly ["number", "null"];
-                        readonly minimum: 0;
-                    };
-                    readonly max_recurrence: {
-                        readonly type: readonly ["number", "null"];
-                        readonly minimum: 0;
-                    };
-                    readonly protection_against_floods: {
-                        readonly type: readonly ["boolean", "null"];
-                    };
-                };
-            };
-            readonly minItems: 1;
-            readonly description: "\nThe `flood_potential` field is an array representing different flood risk scenarios for a given \nlocation. The objects in the array can contain the following fields:\n\n- `min_reccurence`: The minimum expected recurrence interval for flooding, measured in years. \n  This field is optional and can be `null` if the data is unavailable. A lower value indicates more \n  frequent flooding.\n  \n- `max_reccurence`: The maximum expected recurrence interval for flooding, also in years. This \n  field is optional and can be `null`. If provided, this value represents the upper bound of the \n  flood risk interval. This field allows the specification of a range of recurrence intervals.\n  \n- `protection_against_floods`: A boolean flag indicating whether flood protection measures are in \n  place for the area. This field is optional and can be `null` if the information is not available. \n  A value of `true` means flood defenses are present, while `false` indicates the absence of such \n  measures.\n\nIf this array is set to `null`, it means that no data regarding flood potential is available for the location.";
-            readonly example: readonly [{
-                readonly min_recurrence: 100;
-                readonly max_recurrence: null;
-                readonly protection_against_floods: true;
-            }, {
-                readonly min_recurrence: 101;
-                readonly max_recurrence: 1000;
-                readonly protection_against_floods: false;
-            }];
+            readonly description: "\nThe `country_code` field specifies the ISO 3166-1 alpha-2 country code of the country in which the building is located.\n\nThe field is set to `null` if the country code is unknown.";
+            readonly example: "DE";
         };
-        readonly photovoltaic_potential: {
+        readonly esg: {
             readonly type: "object";
             readonly properties: {
-                readonly suitable_roof_area: {
+                readonly overall_class: {
                     readonly type: readonly ["number", "null"];
-                    readonly minimum: 0;
-                    readonly description: "\nThe `suitable_roof_area` field specifies the roof area suited for photovoltaics [m^2].\n\nThe field is set to `null` if the roof area suited for photovoltaics is unknown.";
-                    readonly example: 77;
-                };
-                readonly gross_collector_area: {
-                    readonly type: readonly ["number", "null"];
-                    readonly minimum: 0;
-                    readonly description: "\nThe `gross_collector_area` field specifies the maximal collector area for photovoltaics including module frames [m^2].\n\nThe field is set to `null` if the maximal collector area for photovoltaics is unknown.";
-                    readonly example: 48;
-                };
-                readonly net_collector_area: {
-                    readonly type: readonly ["number", "null"];
-                    readonly minimum: 0;
-                    readonly description: "\nThe `net_collector_area` field specifies the maximal collector area for photovoltaics excluding module frames [m^2].\n\nThe field is set to `null` if the maximal collector area for photovoltaics excluding module frames is unknown.";
-                    readonly example: 48;
-                };
-                readonly electricity_generation: {
-                    readonly type: readonly ["number", "null"];
-                    readonly minimum: 0;
-                    readonly description: "\nThe `electricity_generation` field specifies the maximal electricity generation from photovoltaics of the building per year [kWh/a].\n\nThe field is set to `null` if the maximal electricity generation per year is unknown.";
-                    readonly example: 6401;
-                };
-                readonly nominal_power: {
-                    readonly type: readonly ["number", "null"];
-                    readonly minimum: 0;
-                    readonly description: "\nThe `nominal_power` field specifies the nominal power a photovoltaics system could have at this building per year [kWp].\n\nThe field is set to `null` if the the nominal power is unknown.";
-                    readonly example: 7.5;
-                };
-            };
-            readonly required: readonly ["suitable_roof_area", "gross_collector_area", "net_collector_area", "electricity_generation", "nominal_power"];
-        };
-        readonly solarthermal_potential: {
-            readonly type: "object";
-            readonly properties: {
-                readonly suitable_roof_area: {
-                    readonly type: readonly ["number", "null"];
-                    readonly minimum: 0;
-                    readonly description: "\nThe `st_suitable_roof_area` field specifies the roof area suited for solarthermie [m^2].\n\nThe field is set to `null` if the roof area suited for solarthermie is unknown.";
-                    readonly example: 90;
-                };
-                readonly heat_generation: {
-                    readonly type: readonly ["number", "null"];
-                    readonly minimum: 0;
-                    readonly description: "\nThe `st_heat_generation` field specifies the potential solarthermic heat generation on this bulding [kWh/a].\n\nThe field is set to `null` if the heat generation by solarthermie is unknown.";
-                    readonly example: 25201;
-                };
-                readonly net_collector_area: {
-                    readonly type: readonly ["number", "null"];
-                    readonly minimum: 0;
-                    readonly description: "\nThe `st_net_collector_area` field specifies the maximal collector area for solarthermie [m^2].\n\nThe field is set to `null` if the maximal collector area for solarthermie is unknown.";
-                    readonly example: 25201;
-                };
-            };
-            readonly required: readonly ["suitable_roof_area", "heat_generation", "net_collector_area"];
-        };
-        readonly matching_addresses: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `matching_addresses` field indicates the number of addresses associated with the geometry.\n\nThe field is set to `null` if no matching addresses are found.";
-            readonly example: 1;
-        };
-        readonly eave_above_ground_weighted: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `eave_above_ground_weighted` field specifies the weighted average height of the eave above ground [meters]. For weighting \nthe `footprint_area` of sub-geometries was used, if a building consists of multiple. This can be traced on the basis of the \nfield `number_original_geometries`.  \n\n\nThe field is set to `null` if the height is unknown.";
-            readonly example: 11.398919537428867;
-        };
-        readonly eave_above_ground_min: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `eave_above_ground_min` field specifies the minimum height of the eave above ground [meters]. This is the minimal \n`eave_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis \nof the field `number_original_geometries`.\n\nThe field is set to `null` if the height is unknown.";
-            readonly example: 5.7899932861328125;
-        };
-        readonly eave_above_ground_max: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `eave_above_ground_max` field specifies the maximum height of the eave above ground [meters]. This is the maximal \n`eave_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of \nthe field `number_original_geometries`.\n\n\nThe field is set to `null` if the height is unknown.";
-            readonly example: 13.722991943359375;
-        };
-        readonly ridge_above_ground_weighted: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `ridge_above_ground_weighted` field specifies the weighted average height of the ridge above ground [meters]. For \nweighting the `footprint_area` of sub-geometries was used, if a building consists of multiple. This can be traced on the basis \nof the field `number_original_geometries`.  \n\nThe field is set to `null` if the height is unknown.";
-            readonly example: 13.619256575276214;
-        };
-        readonly ridge_above_ground_min: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `ridge_above_ground_min` field specifies the minimum height of the ridge above ground [meters]. This is the minimal \n`ridge_above_ground within` a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of the \nfield `number_original_geometries`.  \n\nThe field is set to `null` if the height is unknown.";
-            readonly example: 6.64300537109375;
-        };
-        readonly ridge_above_ground_max: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `ridge_above_ground_max` field specifies the maximum height of the ridge above ground [meters]. This is the maximal \n`ridge_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of the \nfield `number_original_geometries`.  \n\nThe field is set to `null` if the height is unknown.";
-            readonly example: 16.987991333007812;
-        };
-        readonly number_original_geometries: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `number_original_geometries` field specifies the number of original geometries used for weighted calculations.\n\nThe field is set to `null` if the count is unknown.";
-            readonly example: 3;
-        };
-        readonly roof_area: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `roof_area` field specifies the total roof area of the building [square meters].\n\nThe field is set to `null` if the roof area is unknown.";
-            readonly example: 355.37342071533203;
-        };
-        readonly outer_wall_area_free: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `outer_wall_area_free` field specifies the facade area free of adjacent structures [square meters].  \n\nThe field is set to `null` if the area is unknown.";
-            readonly example: 690.5686635568186;
-        };
-        readonly outer_wall_area_shared_heated: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `outer_wall_area_shared_heated` field specifies the facade area shared with heated adjacent structures [square meters].  \n\nThe field is set to `null` if the area is unknown.";
-            readonly example: 202.10705297163204;
-        };
-        readonly outer_wall_area_shared_non_heated: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `outer_wall_area_shared_non_heated` field specifies the facade area shared with non-heated adjacent structures [square meters].\n\nThe field is set to `null` if the area is unknown.";
-            readonly example: 298.6121580931941;
-        };
-        readonly plinth_length_free: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `plinth_length_free` field specifies the length of the building's plinth that is not shared with adjacent structures [meters].\n\nThe field is set to `null` if the length is unknown.";
-            readonly example: 48.672734987814366;
-        };
-        readonly plinth_length_shared_heated: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `plinth_length_shared_heated` field specifies the length of the building's plinth shared with heated adjacent structures [meters].\n\nThe field is set to `null` if the length is unknown.";
-            readonly example: 13.16187444425839;
-        };
-        readonly plinth_length_shared_non_heated: {
-            readonly type: readonly ["number", "null"];
-            readonly minimum: 0;
-            readonly description: "\nThe `plinth_length_shared_non_heated` field specifies the length of the building's plinth shared with non-heated adjacent structures [meters].\n\nThe field is set to `null` if the length is unknown.";
-            readonly example: 31.994775355440325;
-        };
-        readonly building_function: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `building_function` field contains the original German building function name (GFK - Gebäudefunktionsklasse) from the source data.\n\nThis is the raw German value. For the standardized English classification, use the `building_function_class` field.\n\nThe field is set to `null` if the building function is unknown.";
-            readonly example: "Wohngebäude";
-        };
-        readonly building_function_class: {
-            readonly type: readonly ["string", "null"];
-            readonly enum: readonly ["residential_building", "residential_house", "dormitory", "childrens_home", "nursing_home", "nurses_dormitory", "student_dormitory", "school_country_home", "mixed_use_building_with_residential", "residential_building_with_public_amenities", "residential_building_with_commerce_services", "residential_and_administrative_building", "residential_and_office_building", "residential_and_commercial_building", "residential_commercial_industrial_building", "agricultural_forestry_residential_building", "agricultural_forestry_residential_commercial_building", "farmhouse", "residential_and_agricultural_building", "forest_house", "leisure_facility_building", "holiday_home", "weekend_house", "garden_house", "commercial_building", "commercial_and_service_building", "office_building", "credit_institution", "insurance_office", "department_store", "shopping_center", "market_hall", "shop", "kiosk", "pharmacy", "exhibition_hall", "accommodation_building", "hotel_motel_guesthouse", "youth_hostel", "hut_with_overnight_stay", "campground_building", "catering_building", "restaurant", "hut_no_overnight_stay", "canteen", "leisure_and_entertainment_venue", "banquet_hall", "cinema", "bowling_alley", "casino", "arcade", "commercial_and_industrial_building", "production_building", "factory", "operations_building", "brewery", "distillery", "workshop", "sawmill", "gas_station", "car_wash", "storage_building", "cold_storage", "warehouse", "freight_forwarding_building", "research_building", "raw_material_extraction_building", "mine", "saltworks", "company_social_facility_building", "other_commercial_industrial_building", "mill", "windmill", "watermill", "pumping_station", "weather_station", "commercial_service_residential_building", "commercial_industrial_residential_building", "traffic_facility_operations_building_general", "road_traffic_operations_building", "road_maintenance_depot", "waiting_hall", "rail_traffic_operations_building", "railroad_crossing_keeper_house", "locomotive_shed_carriage_hall", "signal_box_block_post", "freight_yard_operations_building", "air_traffic_operations_building", "aircraft_hangar", "maritime_traffic_operations_building", "shipyard_hall", "dock_hall", "lock_operations_building", "boathouse", "cable_car_operations_building", "cable_car_tensioning_station", "parking_building", "parking_garage", "garage", "vehicle_hall", "supply_building", "energy_supply_building", "water_supply_building", "waterworks", "water_reservoir", "electricity_supply_building", "power_plant", "substation", "transformer", "reactor_building", "turbine_house", "boiler_house", "telecommunications_building", "building_at_underground_lines", "gas_supply_building", "gas_works", "heating_plant", "utility_building", "pumping_station_non_water_supply", "disposal_building", "wastewater_treatment_building", "sewage_treatment_plant_building", "public_toilet", "waste_treatment_building", "waste_bunker", "waste_incineration_plant", "landfill_building", "agricultural_forestry_building", "agricultural_forestry_commercial_building", "barn", "shed", "stable", "barn_and_stable", "large_scale_animal_housing", "riding_hall", "alpine_hut", "hunting_lodge_cabin", "greenhouse", "moveable_greenhouse", "public_building", "administrative_building", "parliament_building", "town_hall", "post_office", "customs_office", "court_building", "embassy_consulate", "district_administration", "regional_government", "tax_office", "education_research_building", "general_education_school", "vocational_school", "higher_education_building_university", "research_institute", "cultural_building", "palace", "theater_opera", "concert_hall", "museum", "broadcasting_television", "event_building", "library", "castle_fortress", "religious_building", "church", "synagogue", "chapel", "community_hall", "house_of_worship", "mosque", "temple", "monastery", "healthcare_building", "hospital", "sanatorium_nursing_home_nursing_station", "doctors_office_polyclinic", "rescue_station", "social_services_building", "youth_center", "leisure_club_community_center", "senior_center", "homeless_shelter", "daycare_kindergarten", "refugee_shelter", "security_and_order_building", "police_station", "fire_station", "barracks", "air_raid_shelter", "correctional_facility", "cemetery_building", "funeral_hall", "crematorium", "reception_building", "railway_station_building", "airport_building", "subway_station_building", "suburban_railway_station_building", "bus_station_building", "maritime_terminal_building", "public_purpose_residential_building", "recreational_building", "sports_building", "sports_gymnasium", "sports_field_building", "bathhouse", "indoor_swimming_pool", "outdoor_pool_building", "stadium_building", "spa_facility_building", "medical_bath_building", "sanatorium", "zoo_building", "zoo_entrance_building", "aquarium_terrarium_aviary", "animal_exhibition_building", "zoo_stable", "botanical_garden_building", "botanical_garden_entrance_building", "botanical_greenhouse", "conservatory", "other_recreational_facility_building", "mountain_hut_shelter", "tourist_information_center", "not_specified_due_to_source_situation", "water_tower", "church_tower", "observation_tower", "control_tower", "cooling_tower", "lighthouse", "fire_watchtower", "transmission_radio_tower", "city_gate_tower", "winding_tower", "drilling_tower", "castle_tower", "other", "biogas_plant", "wind_turbine", "solar_panels", "mast", "power_line_mast", "radio_mast", "radio_telescope", "chimney", "crane", "slewing_crane", "gantry_crane", "traveling_crane", "blast_furnace", "silo", "tank", "gasometer", "grandstand", "covered_grandstand", "uncovered_grandstand", "stadium", "covered_stadium", "uncovered_stadium", "ski_jump_inrun", "graduation_tower", "historic_water_pipeline", "watchtower", "fortification_castle_ruin", "historic_wall", "city_wall", "other_historic_wall", "canopy", "carport", "wall", "monument", "ship_lift", "chamber_lock", "bridge", "swing_bridge", "lifting_bridge", "drawbridge", "elevated_railway_elevated_road", "lock_chamber", "dam", "weir", "security_gate", "sewer_drain", "barrage"];
-            readonly description: "\nThe `building_function_class` field specifies the standardized English classification of the building function according to the German GFK (Gebäudefunktionsklasse) standard.\n\nThis field categorizes buildings by their primary use or purpose, such as residential, commercial, industrial, public, or mixed-use functions.\n\nThe field is set to `null` if the building function class is unknown.";
-            readonly example: "residential_building";
-        };
-        readonly grouping_strategy: {
-            readonly type: "string";
-            readonly enum: readonly ["proximity", "property"];
-            readonly default: "proximity";
-            readonly description: "The grouping strategy used to aggregate buildings in this result. Currently supports: proximity (cadastral based clustering) and property (cadastral, address, construction year, and roof type based grouping). Defaults to `proximity` when no strategy is specified in the request.";
-            readonly example: "proximity";
-        };
-        readonly ogc_fid: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `ogc_fid` field specifies a unique identifier from the LOD2 dataset. **This field is deprecated** and should no longer be used for identifying buildings.   \n\nFor current and future use, refer to `building_id` (for the building geometry) or `building_address_id` (for a unique building-address combination) instead.   \n\nThe field is set to `null` if the identifier is unavailable.";
-            readonly example: "DENW29AL1000FzW2";
-            readonly deprecated: true;
-        };
-        readonly federal_state: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `federal_state` field specifies the German federal state (Bundesland) in which the building is located.\n\nGermany is divided into 16 federal states:\n\n- Baden-Württemberg\n- Bayern (Bavaria)\n- Berlin\n- Brandenburg\n- Bremen\n- Hamburg\n- Hessen\n- Mecklenburg-Vorpommern\n- Niedersachsen (Lower Saxony)\n- Nordrhein-Westfalen (North Rhine-Westphalia)\n- Rheinland-Pfalz (Rhineland-Palatinate)\n- Saarland\n- Sachsen (Saxony)\n- Sachsen-Anhalt (Saxony-Anhalt)\n- Schleswig-Holstein\n- Thüringen (Thuringia)\n\nThe field is set to `null` if the federal state is unknown.";
-            readonly example: "Nordrhein-Westfalen";
-        };
-        readonly country_code: {
-            readonly type: readonly ["string", "null"];
-            readonly description: "\nThe `country_code` field specifies the ISO 3166-1 alpha-2 country code of the country in which the building is located.\n\nThe field is set to `null` if the country code is unknown.";
-            readonly example: "DE";
-        };
-        readonly esg: {
-            readonly type: "object";
-            readonly properties: {
-                readonly overall_class: {
-                    readonly type: readonly ["number", "null"];
-                    readonly minimum: 1;
-                    readonly maximum: 5;
-                    readonly description: "\nThe `overall_class` field specifies the overall ESG rating class of the building. This field can have one of the following values:\n\n- **1**: Negative\n- **2**: Rather negative\n- **3**: Average\n- **4**: Rather positive\n- **5**: Positive\n\nThe field is set to `null` if the overall ESG rating class is unknown.";
-                    readonly example: 1;
+                    readonly minimum: 1;
+                    readonly maximum: 5;
+                    readonly description: "\nThe `overall_class` field specifies the overall ESG rating class of the building. This field can have one of the following values:\n\n- **1**: Negative\n- **2**: Rather negative\n- **3**: Average\n- **4**: Rather positive\n- **5**: Positive\n\nThe field is set to `null` if the overall ESG rating class is unknown.";
+                    readonly example: 1;
                 };
                 readonly overall: {
                     readonly type: readonly ["string", "null"];
@@ -1231,754 +811,134 @@ declare const $ParcelPropertiesV4: {
     };
     readonly required: readonly ["parcel_id", "total_area", "developed_area", "free_area"];
 };
-
-type LookupPropertiesV2 = {
-    /**
-     *
-     * The `street` field specifies the street name of a building.
-     *
-     * The field is set to `null` if the street is unknown.
-     */
-    street: string | null;
-    /**
-     *
-     * The `city` field specifies the city name of a building.
-     *
-     * The field is set to `null` if the city is unknown.
-     */
-    city: string | null;
-    /**
-     *
-     * The `street_number` field specifies the street number name of a building.
-     *
-     * The field is set to `null` if the street number is unknown.
-     */
-    street_number: string | null;
-    /**
-     *
-     * The `postcode` field specifies the postcode of a building.
-     *
-     * The field is set to `null` if the postcode is unknown.
-     */
-    postcode: string | null;
-    /**
-     *
-     * The `roof_type` field specifies the type of roof of a building. This field can have one of the following values:
-     *
-     * - **flat**: Flat roof
-     * - **pitched**: Pitched roof
-     * - **mixed**: Mixed types of roofs
-     *
-     * The field is set to `null` if the building type is unknown.
-     */
-    roof_type: 'flat' | 'pitched' | 'mixed' | null;
-    /**
-     *
-     * The `type` field specifies the type of building. This field can have one of the following values:
-     *
-     * - **single_family**: Single-family house
-     * - **multi_family**: Multi-family house
-     * - **non_residential**: Non-residential building
-     * - **mixed_use**: Mixed-use building
-     *
-     * The field is set to `null` if the building type is unknown.
-     */
-    type: 'single_family' | 'multi_family' | 'non_residential' | 'mixed_use' | null;
-    /**
-     *
-     * The `type_class` field specifies the class of the building type. This field can have one of the following values:
-     *
-     * - **1**: Single-family house
-     * - **2**: Multi-family house
-     * - **3**: Non-residential building
-     * - **4**: Mixed-use building
-     *
-     * The field is set to `null` if the building type is unknown.
-     */
-    type_class: number | null;
-    /**
-     *
-     * The `water_protected` field specifies whether the building is within a water protection area.
-     *
-     * If the field is set to `null`, no water protection area could be assigned.
-     */
-    water_protected: boolean | null;
-    /**
-     *
-     * The `heated` field specifies whether the building is heated or not.
-     *
-     * The field is set to `null` if the heating status is unknown.
-     */
-    heated: boolean | null;
-    /**
-     *
-     * The `heat_demand` field specifies the heat demand of the building in [kWh/m²a].
-     *
-     * This attribute is deprecated and thus always set to `null`.
-     *
-     * <br /><br />**Warning:**<br /><br />
-     *
-     * This field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.
-     *
-     * @deprecated
-     */
-    heat_demand: number | null;
-    /**
-     *
-     * The `height_category` field specifies the height category of the building. The height category is a
-     * number between 1 and 6, where 1 is the lowest and 6 is the highest category.
-     *
-     * ### Classifications
-     *
-     * - **1**: <= 5m
-     * - **2**: <= 7.5m
-     * - **3**: <= 10m
-     * - **4**: <= 12.5m
-     * - **5**: <= 15m
-     * - **6**: > 15m
-     *
-     * If the height category is unknown, the field is set to `null`.
-     *
-     * <br /><br />**Warning:**<br /><br />
-     *
-     * This field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.
-     *
-     * @deprecated
-     */
-    height_category: '<= 5m' | '<= 7.5m' | '<= 10m' | '<= 12.5m' | '<= 15m' | '> 15m' | null;
-    /**
-     *
-     * The `height_category_class` field specifies the height category of the building. The height category is a
-     * number between 1 and 6, where 1 is the lowest and 6 is the highest category.
-     *
-     * ### Classifications
-     *
-     * - **1**: <= 5m
-     * - **2**: <= 7.5m
-     * - **3**: <= 10m
-     * - **4**: <= 12.5m
-     * - **5**: <= 15m
-     * - **6**: > 15m
-     *
-     * The field is set to `null` if the number of height category is unknown.
-     *
-     * <br /><br />**Warning:**<br /><br />
-     *
-     * This field is deprecated and will be no longer supported in future datasets.
-     * @deprecated
-     */
-    height_category_class: number | null;
-    /**
-     *
-     * The `levels` field specifies the number of levels in the building.
-     *
-     * The field is set to `null` if the number of levels is unknown.
-     */
-    levels: number | null;
-    /**
-     *
-     * The `household_count` field specifies the number of households in the building.
-     *
-     * The field is set to `null` if the number of households is unknown.
-     */
-    household_count: number | null;
-    /**
-     *
-     * The `net_area` field specifies the net area of the building in m².
-     *
-     * The field is set to `null` if the net area is unknown.
-     *
-     * The `net_area` was modeled according to the Raumwärmebedarfsmodell NRW as:
-     * `footprint_area` * `levels` * factors between 0.7 (inhabited) and 0.8 (non-inhabited)
-     * the latter was done to concider e.g., inner wall area or staircases.
-     */
-    net_area: number | null;
-    /**
-     *
-     * The `footprint_area` field specifies the footprint area of the building in m².
-     *
-     * The field is set to `null` if the footprint area is unknown.
-     */
-    footprint_area: number | null;
-    /**
-     *
-     * The `usage` field specifies the usage of the building. This field can have one of the following values:
-     *
-     * - **residential**: Residential building
-     * - **non_residential**: Non-residential building
-     * - **mixed_use**: Mixed-use building
-     *
-     * If the usage is unknown, the field is set to `null`.
-     *
-     * <br /><br />**Warning:**<br /><br />
-     *
-     * This field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.
-     * @deprecated
-     */
-    usage: 'residential' | 'non_residential' | 'mixed_use' | null;
-    /**
-     *
-     * The `usage_class` field specifies the usage of the building. This field can have one of the following values:
-     *
-     * - **1**: Residential building
-     * - **2**: Non-residential building
-     * - **3**: Mixed-use building
-     *
-     * If the usage is unknown, the field is set to `null`.
-     *
-     * <br /><br />**Warning:**<br /><br />
-     *
-     * This field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.
-     * @deprecated
-     */
-    usage_class: number | null;
-    /**
-     *
-     * The `characteristics` field defines the different types of building characteristics. This classification includes
-     * various types of residential and non-residential buildings. This field can have one of the following values:
-     *
-     * - **single_two_family**: Single- or two-family house
-     * - **row_semi_detached**: Row or semi-detached house
-     * - **multi_family**: Multi-family house
-     * - **residential_block**: Residential block
-     * - **high_rise**: High-rise residential building
-     * - **terrace**: Terrace house
-     * - **farmhouse**: Farmhouse
-     * - **office_other**: Office or other building
-     * - **factory_warehouse**: Factory or warehouse building
-     *
-     * If the characteristics is unknown, the field is set to `null`.
-     */
-    characteristics: 'single_two_family' | 'row_semi_detached' | 'multi_family' | 'residential_block' | 'high_rise' | 'terrace' | 'farmhouse' | 'office_other' | 'factory_warehouse' | null;
-    /**
-     *
-     * The `characteristics_class` field defines the different types of building characteristics. This classification includes
-     * various types of residential and non-residential buildings. This field can have one of the following values:
-     *
-     * - **1**: Single- or two-family house
-     * - **2**: Row or semi-detached house
-     * - **3**: Multi-family house
-     * - **4**: Residential block
-     * - **5**: High-rise residential building
-     * - **6**: Terrace house
-     * - **7**: Farmhouse
-     * - **8**: Office or other building
-     * - **9**: Factory or warehouse building
-     *
-     * If the characteristics_class is unknown, the field is set to `null`.
-     */
-    characteristics_class: number | null;
-    /**
-     *
-     * The `development_layout` field specifies the layout of the building. This field can have one of the following values:
-     *
-     * - **non_detached**: Non-detached building
-     * - **semi_detached**: Semi-detached building
-     * - **detached**: Detached building
-     *
-     * If the development layout is unknown, the field is set to `null`.
-     *
-     * The `development_layout` was modeled based on the number and length of intersections with heated (and buildings with unknown heating status)
-     * neighbouring buildings and the perimeter of a geometry as follows:
-     *
-     * **detached** = intersection_length / outline_length < 0.085
-     * **semi_detached** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.45 for buildings with exactly 1 intersection
-     * **semi_detached** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.15 for buildings with more than 1 intersections
-     * **non_detached** = for all other buildings
-     */
-    development_layout: 'non_detached' | 'semi_detached' | 'detached' | null;
-    /**
-     *
-     * The `development_layout_class` field specifies the layout of the building. This field can have one of the following values:
-     *
-     * - **1**: Non-detached building
-     * - **2**: Semi-detached building
-     * - **3**: Detached building
-     *
-     * If the development layout is unknown, the field is set to `null`.
-     *
-     * The `development_layout_class` was modeled based on the number and length of intersections with heated (and buildings with unknown heating status)
-     * neighbouring buildings and the perimeter of a geometry as follows:
-     *
-     * **1** = intersection_length / outline_length < 0.085
-     * **2** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.45 for buildings with exactly 1 intersection
-     * **2** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.15 for buildings with more than 1 intersections
-     * **3** = for all other buildings
-     */
-    development_layout_class: number | null;
-    /**
-     *
-     * The `construction_year_range` field specifies the approximate construction year of the building. The field is a tuple with two
-     * values: the lower and upper bound of the construction year and can have one of the following value:
-     *
-     * - **[*null*, 1899]**: Construction year is somewhere up to 1899
-     * - **[1900, 1945]**
-     * - **[1946, 1960]**
-     * - **[1961, 1970]**
-     * - **[1971, 1980]**
-     * - **[1981, 1985]**
-     * - **[1986, 1995]**
-     * - **[1996, 2000]**
-     * - **[2001, 2005]**
-     * - **[2006, 2010]**
-     * - **[2011, 2015]**
-     * - **[2016, 2024]**
-     *
-     * If the construction year class is unknown, the field is set to `null`.
-     */
-    construction_year_range: unknown[] | null;
-    /**
-     *
-     * The `construction_year_range_class` field specifies the approximate construction year of the building and can have one of the following values:
-     *
-     * - **1**: < 1899
-     * - **2**: 1900 - 1945
-     * - **3**: 1946 - 1960
-     * - **4**: 1961 - 1970
-     * - **5**: 1971 - 1980
-     * - **6**: 1981 - 1985
-     * - **7**: 1986 - 1995
-     * - **8**: 1996 - 2000
-     * - **9**: 2001 - 2005
-     * - **10**: 2006 - 2010
-     * - **11**: 2011 - 2015
-     * - **12**: 2016 - 2024
-     *
-     * If the construction year range class is unknown, the field is set to `null`.
-     */
-    construction_year_range_class: number | null;
-    /**
-     *
-     * The `construction_year` field specifies the construction year of the building.
-     *
-     * If the construction year is unknown, the field is set to `null`.
-     */
-    construction_year: number | null;
-    /**
-     *
-     * The `heritage` field specifies whether the building is under monumental protection.
-     *
-     * The field is set to `null` if the heritage status is unknown.
-     */
-    heritage: boolean | null;
-    /**
-     *
-     * The `geo_conductivity_100` field specifies the geothermal conductivity in 100 m depth.
-     *
-     * The field is set to `null` if the geothermal conductivity is unknown.
-     */
-    geo_conductivity_100: number | null;
-    /**
-     *
-     * The `heat_pump_air_possible` field indicates whether an air-source heat pump is a viable option for the building.
-     *
-     * - Set to `true` if an air-source heat pump is feasible.
-     * - Set to `false` if an air-source heat pump is not feasible.
-     * - Set to `null` if the information is unknown.
-     */
-    heat_pump_air_possible: boolean | null;
-    /**
-     *
-     * The `heat_pump_maximal_distance_drillings` field specifies the maximum allowable distance between drillings for a heat pump installation, measured in meters.
-     * This field will be deprecated in future versions. Please use `heat_pump_maximal_distance_drillings_5m` instead.
-     *
-     * The field is set to `null` if the information is unknown.
-     */
-    heat_pump_maximal_distance_drillings: number | null;
-    /**
-     *
-     * The `heat_pump_maximal_distance_drillings_5m` field specifies the maximum allowable distance between drillings for a heat pump installation, measured in meters.
-     *
-     * The field is set to `null` if the information is unknown.
-     */
-    heat_pump_maximal_distance_drillings_5m: number | null;
-    /**
-     *
-     * The `heat_pump_minimal_number_possible_drillings` field specifies the minimum
-     * number of drillings required for a heat pump installation with a distance of 5m
-     * to the parcel border.
-     * This field will be deprecated in future versions. Please use `heat_pump_minimal_number_possible_drillings_5m` instead.
-     *
-     * The field is set to `null` if the information is unknown.
-     *
-     * <br /><br />**Deprecation Warning:**<br /><br />
-     *
-     * Please use `heat_pump_minimal_number_possible_drillings_5m` instead of this field.
-     * @deprecated
-     */
-    heat_pump_minimal_number_possible_drillings: number | null;
-    /**
-     *
-     * The `heat_pump_minimal_number_possible_drillings_5m` field specifies the minimum
-     * number of drillings required for a heat pump installation with a distance of 5m
-     * to the parcel border.
-     *
-     * The field is set to `null` if the information is unknown.
-     */
-    heat_pump_minimal_number_possible_drillings_5m: number | null;
-    /**
-     *
-     * The `heat_pump_minimal_number_possible_drillings_2m` field specifies the minimum
-     * number of drillings required for a heat pump installation with a distance of 2m
-     * to the parcel border.
-     *
-     * The field is set to `null` if the information is unknown.
-     */
-    heat_pump_minimal_number_possible_drillings_2m: number | null;
-    /**
-     *
-     * The `heat_pump_minimal_number_possible_drillings_no_distance` field specifies the minimum
-     * number of drillings required for a heat pump installation with no distance to the parcel border.
-     *
-     * The field is set to `null` if the information is unknown.
-     */
-    heat_pump_minimal_number_possible_drillings_no_distance: number | null;
-    /**
-     *
-     * The `heat_pump_collector_free_area` field specifies the sum of the free area suitable
-     * for a collector heat pump on parcels associated to a building.
-     *
-     * The field is set to `null` if the information is unknown.
-     */
-    heat_pump_collector_free_area: number | null;
-    /**
-     *
-     * The `flood_potential` field is an array representing different flood risk scenarios for a given
-     * location. The objects in the array can contain the following fields:
-     *
-     * - `min_reccurence`: The minimum expected recurrence interval for flooding, measured in years.
-     * This field is optional and can be `null` if the data is unavailable. A lower value indicates more
-     * frequent flooding.
-     *
-     * - `max_reccurence`: The maximum expected recurrence interval for flooding, also in years. This
-     * field is optional and can be `null`. If provided, this value represents the upper bound of the
-     * flood risk interval. This field allows the specification of a range of recurrence intervals.
-     *
-     * - `protection_against_floods`: A boolean flag indicating whether flood protection measures are in
-     * place for the area. This field is optional and can be `null` if the information is not available.
-     * A value of `true` means flood defenses are present, while `false` indicates the absence of such
-     * measures.
-     *
-     * If this array is set to `null`, it means that no data regarding flood potential is available for the location.
-     */
-    flood_potential: Array<{
-        min_recurrence?: number | null;
-        max_recurrence?: number | null;
-        protection_against_floods?: boolean | null;
-    }> | null;
-    photovoltaic_potential: {
-        /**
-         *
-         * The `suitable_roof_area` field specifies the roof area suited for photovoltaics [m^2].
-         *
-         * The field is set to `null` if the roof area suited for photovoltaics is unknown.
-         */
-        suitable_roof_area: number | null;
-        /**
-         *
-         * The `gross_collector_area` field specifies the maximal collector area for photovoltaics including module frames [m^2].
-         *
-         * The field is set to `null` if the maximal collector area for photovoltaics is unknown.
-         */
-        gross_collector_area: number | null;
-        /**
-         *
-         * The `net_collector_area` field specifies the maximal collector area for photovoltaics excluding module frames [m^2].
-         *
-         * The field is set to `null` if the maximal collector area for photovoltaics excluding module frames is unknown.
-         */
-        net_collector_area: number | null;
-        /**
-         *
-         * The `electricity_generation` field specifies the maximal electricity generation from photovoltaics of the building per year [kWh/a].
-         *
-         * The field is set to `null` if the maximal electricity generation per year is unknown.
-         */
-        electricity_generation: number | null;
-        /**
-         *
-         * The `nominal_power` field specifies the nominal power a photovoltaics system could have at this building per year [kWp].
-         *
-         * The field is set to `null` if the the nominal power is unknown.
-         */
-        nominal_power: number | null;
+declare const $Position3D: {
+    readonly type: "array";
+    readonly prefixItems: readonly [{
+        readonly type: "number";
+    }, {
+        readonly type: "number";
+    }, {
+        readonly type: "number";
+    }];
+};
+declare const $Polygon3DGeometry: {
+    readonly type: "object";
+    readonly properties: {
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["Polygon"];
+        };
+        readonly coordinates: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "array";
+                readonly items: {
+                    readonly $ref: "#/components/schemas/Position3D";
+                };
+            };
+        };
     };
-    solarthermal_potential: {
-        /**
-         *
-         * The `st_suitable_roof_area` field specifies the roof area suited for solarthermie [m^2].
-         *
-         * The field is set to `null` if the roof area suited for solarthermie is unknown.
-         */
-        suitable_roof_area: number | null;
-        /**
-         *
-         * The `st_heat_generation` field specifies the potential solarthermic heat generation on this bulding [kWh/a].
-         *
-         * The field is set to `null` if the heat generation by solarthermie is unknown.
-         */
-        heat_generation: number | null;
-        /**
-         *
-         * The `st_net_collector_area` field specifies the maximal collector area for solarthermie [m^2].
-         *
-         * The field is set to `null` if the maximal collector area for solarthermie is unknown.
-         */
-        net_collector_area: number | null;
+    readonly required: readonly ["type", "coordinates"];
+};
+declare const $MultiPolygon3DGeometry: {
+    readonly type: "object";
+    readonly properties: {
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["MultiPolygon"];
+        };
+        readonly coordinates: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/components/schemas/Position3D";
+                    };
+                };
+            };
+        };
     };
-    /**
-     *
-     * The `matching_addresses` field indicates the number of addresses associated with the geometry.
-     *
-     * The field is set to `null` if no matching addresses are found.
-     */
-    matching_addresses: number | null;
-    /**
-     *
-     * The `eave_above_ground_weighted` field specifies the weighted average height of the eave above ground [meters]. For weighting
-     * the `footprint_area` of sub-geometries was used, if a building consists of multiple. This can be traced on the basis of the
-     * field `number_original_geometries`.
-     *
-     *
-     * The field is set to `null` if the height is unknown.
-     */
-    eave_above_ground_weighted: number | null;
-    /**
-     *
-     * The `eave_above_ground_min` field specifies the minimum height of the eave above ground [meters]. This is the minimal
-     * `eave_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis
-     * of the field `number_original_geometries`.
-     *
-     * The field is set to `null` if the height is unknown.
-     */
-    eave_above_ground_min: number | null;
-    /**
-     *
-     * The `eave_above_ground_max` field specifies the maximum height of the eave above ground [meters]. This is the maximal
-     * `eave_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of
-     * the field `number_original_geometries`.
-     *
-     *
-     * The field is set to `null` if the height is unknown.
-     */
-    eave_above_ground_max: number | null;
-    /**
-     *
-     * The `ridge_above_ground_weighted` field specifies the weighted average height of the ridge above ground [meters]. For
-     * weighting the `footprint_area` of sub-geometries was used, if a building consists of multiple. This can be traced on the basis
-     * of the field `number_original_geometries`.
-     *
-     * The field is set to `null` if the height is unknown.
-     */
-    ridge_above_ground_weighted: number | null;
-    /**
-     *
-     * The `ridge_above_ground_min` field specifies the minimum height of the ridge above ground [meters]. This is the minimal
-     * `ridge_above_ground within` a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of the
-     * field `number_original_geometries`.
-     *
-     * The field is set to `null` if the height is unknown.
-     */
-    ridge_above_ground_min: number | null;
-    /**
-     *
-     * The `ridge_above_ground_max` field specifies the maximum height of the ridge above ground [meters]. This is the maximal
-     * `ridge_above_ground` within a group of sub-geometries, if a building consists of multiple. This can be traced on the basis of the
-     * field `number_original_geometries`.
-     *
-     * The field is set to `null` if the height is unknown.
-     */
-    ridge_above_ground_max: number | null;
-    /**
-     *
-     * The `number_original_geometries` field specifies the number of original geometries used for weighted calculations.
-     *
-     * The field is set to `null` if the count is unknown.
-     */
-    number_original_geometries: number | null;
-    /**
-     *
-     * The `roof_area` field specifies the total roof area of the building [square meters].
-     *
-     * The field is set to `null` if the roof area is unknown.
-     */
-    roof_area: number | null;
-    /**
-     *
-     * The `ogc_fid` field specifies a unique identifier from the LOD2 dataset.
-     *
-     * The field is set to `null` if the identifier is unavailable.
-     */
-    ogc_fid: string | null;
-    /**
-     *
-     * The `outer_wall_area_free` field specifies the facade area free of adjacent structures [square meters].
-     *
-     * The field is set to `null` if the area is unknown.
-     */
-    outer_wall_area_free: number | null;
-    /**
-     *
-     * The `outer_wall_area_shared_heated` field specifies the facade area shared with heated adjacent structures [square meters].
-     *
-     * The field is set to `null` if the area is unknown.
-     */
-    outer_wall_area_shared_heated: number | null;
-    /**
-     *
-     * The `outer_wall_area_shared_non_heated` field specifies the facade area shared with non-heated adjacent structures [square meters].
-     *
-     * The field is set to `null` if the area is unknown.
-     */
-    outer_wall_area_shared_non_heated: number | null;
-    /**
-     *
-     * The `plinth_length_free` field specifies the length of the building's plinth that is not shared with adjacent structures [meters].
-     *
-     * The field is set to `null` if the length is unknown.
-     */
-    plinth_length_free: number | null;
-    /**
-     *
-     * The `plinth_length_shared_heated` field specifies the length of the building's plinth shared with heated adjacent structures [meters].
-     *
-     * The field is set to `null` if the length is unknown.
-     */
-    plinth_length_shared_heated: number | null;
-    /**
-     *
-     * The `plinth_length_shared_non_heated` field specifies the length of the building's plinth shared with non-heated adjacent structures [meters].
-     *
-     * The field is set to `null` if the length is unknown.
-     */
-    plinth_length_shared_non_heated: number | null;
-    /**
-     *
-     * The `building_function` field contains the original German building function name (GFK - Gebäudefunktionsklasse) from the source data.
-     *
-     * This is the raw German value. For the standardized English classification, use the `building_function_class` field.
-     *
-     * The field is set to `null` if the building function is unknown.
-     */
-    building_function: string | null;
-    /**
-     *
-     * The `building_function_class` field specifies the standardized English classification of the building function according to the German GFK (Gebäudefunktionsklasse) standard.
-     *
-     * This field categorizes buildings by their primary use or purpose, such as residential, commercial, industrial, public, or mixed-use functions.
-     *
-     * The field is set to `null` if the building function class is unknown.
-     */
-    building_function_class: 'residential_building' | 'residential_house' | 'dormitory' | 'childrens_home' | 'nursing_home' | 'nurses_dormitory' | 'student_dormitory' | 'school_country_home' | 'mixed_use_building_with_residential' | 'residential_building_with_public_amenities' | 'residential_building_with_commerce_services' | 'residential_and_administrative_building' | 'residential_and_office_building' | 'residential_and_commercial_building' | 'residential_commercial_industrial_building' | 'agricultural_forestry_residential_building' | 'agricultural_forestry_residential_commercial_building' | 'farmhouse' | 'residential_and_agricultural_building' | 'forest_house' | 'leisure_facility_building' | 'holiday_home' | 'weekend_house' | 'garden_house' | 'commercial_building' | 'commercial_and_service_building' | 'office_building' | 'credit_institution' | 'insurance_office' | 'department_store' | 'shopping_center' | 'market_hall' | 'shop' | 'kiosk' | 'pharmacy' | 'exhibition_hall' | 'accommodation_building' | 'hotel_motel_guesthouse' | 'youth_hostel' | 'hut_with_overnight_stay' | 'campground_building' | 'catering_building' | 'restaurant' | 'hut_no_overnight_stay' | 'canteen' | 'leisure_and_entertainment_venue' | 'banquet_hall' | 'cinema' | 'bowling_alley' | 'casino' | 'arcade' | 'commercial_and_industrial_building' | 'production_building' | 'factory' | 'operations_building' | 'brewery' | 'distillery' | 'workshop' | 'sawmill' | 'gas_station' | 'car_wash' | 'storage_building' | 'cold_storage' | 'warehouse' | 'freight_forwarding_building' | 'research_building' | 'raw_material_extraction_building' | 'mine' | 'saltworks' | 'company_social_facility_building' | 'other_commercial_industrial_building' | 'mill' | 'windmill' | 'watermill' | 'pumping_station' | 'weather_station' | 'commercial_service_residential_building' | 'commercial_industrial_residential_building' | 'traffic_facility_operations_building_general' | 'road_traffic_operations_building' | 'road_maintenance_depot' | 'waiting_hall' | 'rail_traffic_operations_building' | 'railroad_crossing_keeper_house' | 'locomotive_shed_carriage_hall' | 'signal_box_block_post' | 'freight_yard_operations_building' | 'air_traffic_operations_building' | 'aircraft_hangar' | 'maritime_traffic_operations_building' | 'shipyard_hall' | 'dock_hall' | 'lock_operations_building' | 'boathouse' | 'cable_car_operations_building' | 'cable_car_tensioning_station' | 'parking_building' | 'parking_garage' | 'garage' | 'vehicle_hall' | 'supply_building' | 'energy_supply_building' | 'water_supply_building' | 'waterworks' | 'water_reservoir' | 'electricity_supply_building' | 'power_plant' | 'substation' | 'transformer' | 'reactor_building' | 'turbine_house' | 'boiler_house' | 'telecommunications_building' | 'building_at_underground_lines' | 'gas_supply_building' | 'gas_works' | 'heating_plant' | 'utility_building' | 'pumping_station_non_water_supply' | 'disposal_building' | 'wastewater_treatment_building' | 'sewage_treatment_plant_building' | 'public_toilet' | 'waste_treatment_building' | 'waste_bunker' | 'waste_incineration_plant' | 'landfill_building' | 'agricultural_forestry_building' | 'agricultural_forestry_commercial_building' | 'barn' | 'shed' | 'stable' | 'barn_and_stable' | 'large_scale_animal_housing' | 'riding_hall' | 'alpine_hut' | 'hunting_lodge_cabin' | 'greenhouse' | 'moveable_greenhouse' | 'public_building' | 'administrative_building' | 'parliament_building' | 'town_hall' | 'post_office' | 'customs_office' | 'court_building' | 'embassy_consulate' | 'district_administration' | 'regional_government' | 'tax_office' | 'education_research_building' | 'general_education_school' | 'vocational_school' | 'higher_education_building_university' | 'research_institute' | 'cultural_building' | 'palace' | 'theater_opera' | 'concert_hall' | 'museum' | 'broadcasting_television' | 'event_building' | 'library' | 'castle_fortress' | 'religious_building' | 'church' | 'synagogue' | 'chapel' | 'community_hall' | 'house_of_worship' | 'mosque' | 'temple' | 'monastery' | 'healthcare_building' | 'hospital' | 'sanatorium_nursing_home_nursing_station' | 'doctors_office_polyclinic' | 'rescue_station' | 'social_services_building' | 'youth_center' | 'leisure_club_community_center' | 'senior_center' | 'homeless_shelter' | 'daycare_kindergarten' | 'refugee_shelter' | 'security_and_order_building' | 'police_station' | 'fire_station' | 'barracks' | 'air_raid_shelter' | 'correctional_facility' | 'cemetery_building' | 'funeral_hall' | 'crematorium' | 'reception_building' | 'railway_station_building' | 'airport_building' | 'subway_station_building' | 'suburban_railway_station_building' | 'bus_station_building' | 'maritime_terminal_building' | 'public_purpose_residential_building' | 'recreational_building' | 'sports_building' | 'sports_gymnasium' | 'sports_field_building' | 'bathhouse' | 'indoor_swimming_pool' | 'outdoor_pool_building' | 'stadium_building' | 'spa_facility_building' | 'medical_bath_building' | 'sanatorium' | 'zoo_building' | 'zoo_entrance_building' | 'aquarium_terrarium_aviary' | 'animal_exhibition_building' | 'zoo_stable' | 'botanical_garden_building' | 'botanical_garden_entrance_building' | 'botanical_greenhouse' | 'conservatory' | 'other_recreational_facility_building' | 'mountain_hut_shelter' | 'tourist_information_center' | 'not_specified_due_to_source_situation' | 'water_tower' | 'church_tower' | 'observation_tower' | 'control_tower' | 'cooling_tower' | 'lighthouse' | 'fire_watchtower' | 'transmission_radio_tower' | 'city_gate_tower' | 'winding_tower' | 'drilling_tower' | 'castle_tower' | 'other' | 'biogas_plant' | 'wind_turbine' | 'solar_panels' | 'mast' | 'power_line_mast' | 'radio_mast' | 'radio_telescope' | 'chimney' | 'crane' | 'slewing_crane' | 'gantry_crane' | 'traveling_crane' | 'blast_furnace' | 'silo' | 'tank' | 'gasometer' | 'grandstand' | 'covered_grandstand' | 'uncovered_grandstand' | 'stadium' | 'covered_stadium' | 'uncovered_stadium' | 'ski_jump_inrun' | 'graduation_tower' | 'historic_water_pipeline' | 'watchtower' | 'fortification_castle_ruin' | 'historic_wall' | 'city_wall' | 'other_historic_wall' | 'canopy' | 'carport' | 'wall' | 'monument' | 'ship_lift' | 'chamber_lock' | 'bridge' | 'swing_bridge' | 'lifting_bridge' | 'drawbridge' | 'elevated_railway_elevated_road' | 'lock_chamber' | 'dam' | 'weir' | 'security_gate' | 'sewer_drain' | 'barrage' | null;
+    readonly required: readonly ["type", "coordinates"];
 };
-/**
- *
- * The `roof_type` field specifies the type of roof of a building. This field can have one of the following values:
- *
- * - **flat**: Flat roof
- * - **pitched**: Pitched roof
- * - **mixed**: Mixed types of roofs
- *
- * The field is set to `null` if the building type is unknown.
- */
-type roof_type = 'flat' | 'pitched' | 'mixed';
-/**
- *
- * The `type` field specifies the type of building. This field can have one of the following values:
- *
- * - **single_family**: Single-family house
- * - **multi_family**: Multi-family house
- * - **non_residential**: Non-residential building
- * - **mixed_use**: Mixed-use building
- *
- * The field is set to `null` if the building type is unknown.
- */
-type type = 'single_family' | 'multi_family' | 'non_residential' | 'mixed_use';
-/**
- *
- * The `height_category` field specifies the height category of the building. The height category is a
- * number between 1 and 6, where 1 is the lowest and 6 is the highest category.
- *
- * ### Classifications
- *
- * - **1**: <= 5m
- * - **2**: <= 7.5m
- * - **3**: <= 10m
- * - **4**: <= 12.5m
- * - **5**: <= 15m
- * - **6**: > 15m
- *
- * If the height category is unknown, the field is set to `null`.
- *
- * <br /><br />**Warning:**<br /><br />
- *
- * This field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.
- *
- * @deprecated
- */
-type height_category = '<= 5m' | '<= 7.5m' | '<= 10m' | '<= 12.5m' | '<= 15m' | '> 15m';
-/**
- *
- * The `usage` field specifies the usage of the building. This field can have one of the following values:
- *
- * - **residential**: Residential building
- * - **non_residential**: Non-residential building
- * - **mixed_use**: Mixed-use building
- *
- * If the usage is unknown, the field is set to `null`.
- *
- * <br /><br />**Warning:**<br /><br />
- *
- * This field is deprecated and will be removed in future API versions. It is no longer actively supported and may be omitted from upcoming endpoints. We recommend updating your implementation to use the latest supported fields.
- * @deprecated
- */
-type usage = 'residential' | 'non_residential' | 'mixed_use';
-/**
- *
- * The `characteristics` field defines the different types of building characteristics. This classification includes
- * various types of residential and non-residential buildings. This field can have one of the following values:
- *
- * - **single_two_family**: Single- or two-family house
- * - **row_semi_detached**: Row or semi-detached house
- * - **multi_family**: Multi-family house
- * - **residential_block**: Residential block
- * - **high_rise**: High-rise residential building
- * - **terrace**: Terrace house
- * - **farmhouse**: Farmhouse
- * - **office_other**: Office or other building
- * - **factory_warehouse**: Factory or warehouse building
- *
- * If the characteristics is unknown, the field is set to `null`.
- */
-type characteristics = 'single_two_family' | 'row_semi_detached' | 'multi_family' | 'residential_block' | 'high_rise' | 'terrace' | 'farmhouse' | 'office_other' | 'factory_warehouse';
-/**
- *
- * The `development_layout` field specifies the layout of the building. This field can have one of the following values:
- *
- * - **non_detached**: Non-detached building
- * - **semi_detached**: Semi-detached building
- * - **detached**: Detached building
- *
- * If the development layout is unknown, the field is set to `null`.
- *
- * The `development_layout` was modeled based on the number and length of intersections with heated (and buildings with unknown heating status)
- * neighbouring buildings and the perimeter of a geometry as follows:
- *
- * **detached** = intersection_length / outline_length < 0.085
- * **semi_detached** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.45 for buildings with exactly 1 intersection
- * **semi_detached** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.15 for buildings with more than 1 intersections
- * **non_detached** = for all other buildings
- */
-type development_layout = 'non_detached' | 'semi_detached' | 'detached';
-/**
- *
- * The `building_function_class` field specifies the standardized English classification of the building function according to the German GFK (Gebäudefunktionsklasse) standard.
- *
- * This field categorizes buildings by their primary use or purpose, such as residential, commercial, industrial, public, or mixed-use functions.
- *
- * The field is set to `null` if the building function class is unknown.
- */
-type building_function_class = 'residential_building' | 'residential_house' | 'dormitory' | 'childrens_home' | 'nursing_home' | 'nurses_dormitory' | 'student_dormitory' | 'school_country_home' | 'mixed_use_building_with_residential' | 'residential_building_with_public_amenities' | 'residential_building_with_commerce_services' | 'residential_and_administrative_building' | 'residential_and_office_building' | 'residential_and_commercial_building' | 'residential_commercial_industrial_building' | 'agricultural_forestry_residential_building' | 'agricultural_forestry_residential_commercial_building' | 'farmhouse' | 'residential_and_agricultural_building' | 'forest_house' | 'leisure_facility_building' | 'holiday_home' | 'weekend_house' | 'garden_house' | 'commercial_building' | 'commercial_and_service_building' | 'office_building' | 'credit_institution' | 'insurance_office' | 'department_store' | 'shopping_center' | 'market_hall' | 'shop' | 'kiosk' | 'pharmacy' | 'exhibition_hall' | 'accommodation_building' | 'hotel_motel_guesthouse' | 'youth_hostel' | 'hut_with_overnight_stay' | 'campground_building' | 'catering_building' | 'restaurant' | 'hut_no_overnight_stay' | 'canteen' | 'leisure_and_entertainment_venue' | 'banquet_hall' | 'cinema' | 'bowling_alley' | 'casino' | 'arcade' | 'commercial_and_industrial_building' | 'production_building' | 'factory' | 'operations_building' | 'brewery' | 'distillery' | 'workshop' | 'sawmill' | 'gas_station' | 'car_wash' | 'storage_building' | 'cold_storage' | 'warehouse' | 'freight_forwarding_building' | 'research_building' | 'raw_material_extraction_building' | 'mine' | 'saltworks' | 'company_social_facility_building' | 'other_commercial_industrial_building' | 'mill' | 'windmill' | 'watermill' | 'pumping_station' | 'weather_station' | 'commercial_service_residential_building' | 'commercial_industrial_residential_building' | 'traffic_facility_operations_building_general' | 'road_traffic_operations_building' | 'road_maintenance_depot' | 'waiting_hall' | 'rail_traffic_operations_building' | 'railroad_crossing_keeper_house' | 'locomotive_shed_carriage_hall' | 'signal_box_block_post' | 'freight_yard_operations_building' | 'air_traffic_operations_building' | 'aircraft_hangar' | 'maritime_traffic_operations_building' | 'shipyard_hall' | 'dock_hall' | 'lock_operations_building' | 'boathouse' | 'cable_car_operations_building' | 'cable_car_tensioning_station' | 'parking_building' | 'parking_garage' | 'garage' | 'vehicle_hall' | 'supply_building' | 'energy_supply_building' | 'water_supply_building' | 'waterworks' | 'water_reservoir' | 'electricity_supply_building' | 'power_plant' | 'substation' | 'transformer' | 'reactor_building' | 'turbine_house' | 'boiler_house' | 'telecommunications_building' | 'building_at_underground_lines' | 'gas_supply_building' | 'gas_works' | 'heating_plant' | 'utility_building' | 'pumping_station_non_water_supply' | 'disposal_building' | 'wastewater_treatment_building' | 'sewage_treatment_plant_building' | 'public_toilet' | 'waste_treatment_building' | 'waste_bunker' | 'waste_incineration_plant' | 'landfill_building' | 'agricultural_forestry_building' | 'agricultural_forestry_commercial_building' | 'barn' | 'shed' | 'stable' | 'barn_and_stable' | 'large_scale_animal_housing' | 'riding_hall' | 'alpine_hut' | 'hunting_lodge_cabin' | 'greenhouse' | 'moveable_greenhouse' | 'public_building' | 'administrative_building' | 'parliament_building' | 'town_hall' | 'post_office' | 'customs_office' | 'court_building' | 'embassy_consulate' | 'district_administration' | 'regional_government' | 'tax_office' | 'education_research_building' | 'general_education_school' | 'vocational_school' | 'higher_education_building_university' | 'research_institute' | 'cultural_building' | 'palace' | 'theater_opera' | 'concert_hall' | 'museum' | 'broadcasting_television' | 'event_building' | 'library' | 'castle_fortress' | 'religious_building' | 'church' | 'synagogue' | 'chapel' | 'community_hall' | 'house_of_worship' | 'mosque' | 'temple' | 'monastery' | 'healthcare_building' | 'hospital' | 'sanatorium_nursing_home_nursing_station' | 'doctors_office_polyclinic' | 'rescue_station' | 'social_services_building' | 'youth_center' | 'leisure_club_community_center' | 'senior_center' | 'homeless_shelter' | 'daycare_kindergarten' | 'refugee_shelter' | 'security_and_order_building' | 'police_station' | 'fire_station' | 'barracks' | 'air_raid_shelter' | 'correctional_facility' | 'cemetery_building' | 'funeral_hall' | 'crematorium' | 'reception_building' | 'railway_station_building' | 'airport_building' | 'subway_station_building' | 'suburban_railway_station_building' | 'bus_station_building' | 'maritime_terminal_building' | 'public_purpose_residential_building' | 'recreational_building' | 'sports_building' | 'sports_gymnasium' | 'sports_field_building' | 'bathhouse' | 'indoor_swimming_pool' | 'outdoor_pool_building' | 'stadium_building' | 'spa_facility_building' | 'medical_bath_building' | 'sanatorium' | 'zoo_building' | 'zoo_entrance_building' | 'aquarium_terrarium_aviary' | 'animal_exhibition_building' | 'zoo_stable' | 'botanical_garden_building' | 'botanical_garden_entrance_building' | 'botanical_greenhouse' | 'conservatory' | 'other_recreational_facility_building' | 'mountain_hut_shelter' | 'tourist_information_center' | 'not_specified_due_to_source_situation' | 'water_tower' | 'church_tower' | 'observation_tower' | 'control_tower' | 'cooling_tower' | 'lighthouse' | 'fire_watchtower' | 'transmission_radio_tower' | 'city_gate_tower' | 'winding_tower' | 'drilling_tower' | 'castle_tower' | 'other' | 'biogas_plant' | 'wind_turbine' | 'solar_panels' | 'mast' | 'power_line_mast' | 'radio_mast' | 'radio_telescope' | 'chimney' | 'crane' | 'slewing_crane' | 'gantry_crane' | 'traveling_crane' | 'blast_furnace' | 'silo' | 'tank' | 'gasometer' | 'grandstand' | 'covered_grandstand' | 'uncovered_grandstand' | 'stadium' | 'covered_stadium' | 'uncovered_stadium' | 'ski_jump_inrun' | 'graduation_tower' | 'historic_water_pipeline' | 'watchtower' | 'fortification_castle_ruin' | 'historic_wall' | 'city_wall' | 'other_historic_wall' | 'canopy' | 'carport' | 'wall' | 'monument' | 'ship_lift' | 'chamber_lock' | 'bridge' | 'swing_bridge' | 'lifting_bridge' | 'drawbridge' | 'elevated_railway_elevated_road' | 'lock_chamber' | 'dam' | 'weir' | 'security_gate' | 'sewer_drain' | 'barrage';
+declare const $GeometryCollection3D: {
+    readonly type: "object";
+    readonly properties: {
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["GeometryCollection"];
+        };
+        readonly geometries: {
+            readonly type: "array";
+            readonly items: {
+                readonly anyOf: readonly [{
+                    readonly $ref: "#/components/schemas/Polygon3DGeometry";
+                }, {
+                    readonly $ref: "#/components/schemas/MultiPolygon3DGeometry";
+                }];
+            };
+        };
+    };
+    readonly required: readonly ["type", "geometries"];
+};
+declare const $Geometry3D: {
+    readonly anyOf: readonly [{
+        readonly $ref: "#/components/schemas/Polygon3DGeometry";
+    }, {
+        readonly $ref: "#/components/schemas/MultiPolygon3DGeometry";
+    }, {
+        readonly $ref: "#/components/schemas/GeometryCollection3D";
+    }];
+};
+declare const $SurfaceType: {
+    readonly type: "string";
+    readonly enum: readonly ["wall", "ground", "roof"];
+    readonly description: "The surface type of this geometry (wall, ground, or roof)";
+    readonly example: "roof";
+};
+declare const $BuildingGeometryPropertiesV4: {
+    readonly type: "object";
+    readonly properties: {
+        readonly type: {
+            readonly $ref: "#/components/schemas/SurfaceType";
+        };
+    };
+    readonly required: readonly ["type"];
+};
+declare const $BuildingGeometryFeatureV4: {
+    readonly type: "object";
+    readonly properties: {
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["Feature"];
+        };
+        readonly geometry: {
+            readonly $ref: "#/components/schemas/Geometry3D";
+        };
+        readonly properties: {
+            readonly $ref: "#/components/schemas/BuildingGeometryPropertiesV4";
+        };
+    };
+    readonly required: readonly ["type", "geometry", "properties"];
+};
+declare const $BuildingGeometryResponseV4: {
+    readonly type: "object";
+    readonly properties: {
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["FeatureCollection"];
+        };
+        readonly features: {
+            readonly type: "array";
+            readonly items: {
+                readonly $ref: "#/components/schemas/BuildingGeometryFeatureV4";
+            };
+        };
+    };
+    readonly required: readonly ["type", "features"];
+};
+
 type LookupPropertiesV3 = {
     /**
      *
@@ -2092,7 +1052,7 @@ type LookupPropertiesV3 = {
      *
      * The `net_area` was modeled according to the Raumwärmebedarfsmodell NRW as:
      * `footprint_area` * `levels` * factors between 0.7 (inhabited) and 0.8 (non-inhabited)
-     * the latter was done to concider e.g., inner wall area or staircases.
+     * the latter was done to consider e.g., inner wall area or staircases.
      */
     net_area: number | null;
     /**
@@ -2316,11 +1276,11 @@ type LookupPropertiesV3 = {
      * The `flood_potential` field is an array representing different flood risk scenarios for a given
      * location. The objects in the array can contain the following fields:
      *
-     * - `min_reccurence`: The minimum expected recurrence interval for flooding, measured in years.
+     * - `min_recurrence`: The minimum expected recurrence interval for flooding, measured in years.
      * This field is optional and can be `null` if the data is unavailable. A lower value indicates more
      * frequent flooding.
      *
-     * - `max_reccurence`: The maximum expected recurrence interval for flooding, also in years. This
+     * - `max_recurrence`: The maximum expected recurrence interval for flooding, also in years. This
      * field is optional and can be `null`. If provided, this value represents the upper bound of the
      * flood risk interval. This field allows the specification of a range of recurrence intervals.
      *
@@ -3085,6 +2045,75 @@ type LookupPropertiesV3 = {
      */
     biosphere_reserve: boolean | null;
 };
+/**
+ *
+ * The `roof_type` field specifies the type of roof of a building. This field can have one of the following values:
+ *
+ * - **flat**: Flat roof
+ * - **pitched**: Pitched roof
+ * - **mixed**: Mixed types of roofs
+ *
+ * The field is set to `null` if the building type is unknown.
+ */
+type roof_type = 'flat' | 'pitched' | 'mixed';
+/**
+ *
+ * The `type` field specifies the type of building. This field can have one of the following values:
+ *
+ * - **single_family**: Single-family house
+ * - **multi_family**: Multi-family house
+ * - **non_residential**: Non-residential building
+ * - **mixed_use**: Mixed-use building
+ *
+ * The field is set to `null` if the building type is unknown.
+ */
+type type = 'single_family' | 'multi_family' | 'non_residential' | 'mixed_use';
+/**
+ *
+ * The `characteristics` field defines the different types of building characteristics. This classification includes
+ * various types of residential and non-residential buildings. This field can have one of the following values:
+ *
+ * - **single_two_family**: Single- or two-family house
+ * - **row_semi_detached**: Row or semi-detached house
+ * - **multi_family**: Multi-family house
+ * - **residential_block**: Residential block
+ * - **high_rise**: High-rise residential building
+ * - **terrace**: Terrace house
+ * - **farmhouse**: Farmhouse
+ * - **office_other**: Office or other building
+ * - **factory_warehouse**: Factory or warehouse building
+ *
+ * If the characteristics is unknown, the field is set to `null`.
+ */
+type characteristics = 'single_two_family' | 'row_semi_detached' | 'multi_family' | 'residential_block' | 'high_rise' | 'terrace' | 'farmhouse' | 'office_other' | 'factory_warehouse';
+/**
+ *
+ * The `development_layout` field specifies the layout of the building. This field can have one of the following values:
+ *
+ * - **non_detached**: Non-detached building
+ * - **semi_detached**: Semi-detached building
+ * - **detached**: Detached building
+ *
+ * If the development layout is unknown, the field is set to `null`.
+ *
+ * The `development_layout` was modeled based on the number and length of intersections with heated (and buildings with unknown heating status)
+ * neighbouring buildings and the perimeter of a geometry as follows:
+ *
+ * **detached** = intersection_length / outline_length < 0.085
+ * **semi_detached** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.45 for buildings with exactly 1 intersection
+ * **semi_detached** = intersection_length / outline_length >= 0.085 AND intersection_length / outline_length < 0.15 for buildings with more than 1 intersections
+ * **non_detached** = for all other buildings
+ */
+type development_layout = 'non_detached' | 'semi_detached' | 'detached';
+/**
+ *
+ * The `building_function_class` field specifies the standardized English classification of the building function according to the German GFK (Gebäudefunktionsklasse) standard.
+ *
+ * This field categorizes buildings by their primary use or purpose, such as residential, commercial, industrial, public, or mixed-use functions.
+ *
+ * The field is set to `null` if the building function class is unknown.
+ */
+type building_function_class = 'residential_building' | 'residential_house' | 'dormitory' | 'childrens_home' | 'nursing_home' | 'nurses_dormitory' | 'student_dormitory' | 'school_country_home' | 'mixed_use_building_with_residential' | 'residential_building_with_public_amenities' | 'residential_building_with_commerce_services' | 'residential_and_administrative_building' | 'residential_and_office_building' | 'residential_and_commercial_building' | 'residential_commercial_industrial_building' | 'agricultural_forestry_residential_building' | 'agricultural_forestry_residential_commercial_building' | 'farmhouse' | 'residential_and_agricultural_building' | 'forest_house' | 'leisure_facility_building' | 'holiday_home' | 'weekend_house' | 'garden_house' | 'commercial_building' | 'commercial_and_service_building' | 'office_building' | 'credit_institution' | 'insurance_office' | 'department_store' | 'shopping_center' | 'market_hall' | 'shop' | 'kiosk' | 'pharmacy' | 'exhibition_hall' | 'accommodation_building' | 'hotel_motel_guesthouse' | 'youth_hostel' | 'hut_with_overnight_stay' | 'campground_building' | 'catering_building' | 'restaurant' | 'hut_no_overnight_stay' | 'canteen' | 'leisure_and_entertainment_venue' | 'banquet_hall' | 'cinema' | 'bowling_alley' | 'casino' | 'arcade' | 'commercial_and_industrial_building' | 'production_building' | 'factory' | 'operations_building' | 'brewery' | 'distillery' | 'workshop' | 'sawmill' | 'gas_station' | 'car_wash' | 'storage_building' | 'cold_storage' | 'warehouse' | 'freight_forwarding_building' | 'research_building' | 'raw_material_extraction_building' | 'mine' | 'saltworks' | 'company_social_facility_building' | 'other_commercial_industrial_building' | 'mill' | 'windmill' | 'watermill' | 'pumping_station' | 'weather_station' | 'commercial_service_residential_building' | 'commercial_industrial_residential_building' | 'traffic_facility_operations_building_general' | 'road_traffic_operations_building' | 'road_maintenance_depot' | 'waiting_hall' | 'rail_traffic_operations_building' | 'railroad_crossing_keeper_house' | 'locomotive_shed_carriage_hall' | 'signal_box_block_post' | 'freight_yard_operations_building' | 'air_traffic_operations_building' | 'aircraft_hangar' | 'maritime_traffic_operations_building' | 'shipyard_hall' | 'dock_hall' | 'lock_operations_building' | 'boathouse' | 'cable_car_operations_building' | 'cable_car_tensioning_station' | 'parking_building' | 'parking_garage' | 'garage' | 'vehicle_hall' | 'supply_building' | 'energy_supply_building' | 'water_supply_building' | 'waterworks' | 'water_reservoir' | 'electricity_supply_building' | 'power_plant' | 'substation' | 'transformer' | 'reactor_building' | 'turbine_house' | 'boiler_house' | 'telecommunications_building' | 'building_at_underground_lines' | 'gas_supply_building' | 'gas_works' | 'heating_plant' | 'utility_building' | 'pumping_station_non_water_supply' | 'disposal_building' | 'wastewater_treatment_building' | 'sewage_treatment_plant_building' | 'public_toilet' | 'waste_treatment_building' | 'waste_bunker' | 'waste_incineration_plant' | 'landfill_building' | 'agricultural_forestry_building' | 'agricultural_forestry_commercial_building' | 'barn' | 'shed' | 'stable' | 'barn_and_stable' | 'large_scale_animal_housing' | 'riding_hall' | 'alpine_hut' | 'hunting_lodge_cabin' | 'greenhouse' | 'moveable_greenhouse' | 'public_building' | 'administrative_building' | 'parliament_building' | 'town_hall' | 'post_office' | 'customs_office' | 'court_building' | 'embassy_consulate' | 'district_administration' | 'regional_government' | 'tax_office' | 'education_research_building' | 'general_education_school' | 'vocational_school' | 'higher_education_building_university' | 'research_institute' | 'cultural_building' | 'palace' | 'theater_opera' | 'concert_hall' | 'museum' | 'broadcasting_television' | 'event_building' | 'library' | 'castle_fortress' | 'religious_building' | 'church' | 'synagogue' | 'chapel' | 'community_hall' | 'house_of_worship' | 'mosque' | 'temple' | 'monastery' | 'healthcare_building' | 'hospital' | 'sanatorium_nursing_home_nursing_station' | 'doctors_office_polyclinic' | 'rescue_station' | 'social_services_building' | 'youth_center' | 'leisure_club_community_center' | 'senior_center' | 'homeless_shelter' | 'daycare_kindergarten' | 'refugee_shelter' | 'security_and_order_building' | 'police_station' | 'fire_station' | 'barracks' | 'air_raid_shelter' | 'correctional_facility' | 'cemetery_building' | 'funeral_hall' | 'crematorium' | 'reception_building' | 'railway_station_building' | 'airport_building' | 'subway_station_building' | 'suburban_railway_station_building' | 'bus_station_building' | 'maritime_terminal_building' | 'public_purpose_residential_building' | 'recreational_building' | 'sports_building' | 'sports_gymnasium' | 'sports_field_building' | 'bathhouse' | 'indoor_swimming_pool' | 'outdoor_pool_building' | 'stadium_building' | 'spa_facility_building' | 'medical_bath_building' | 'sanatorium' | 'zoo_building' | 'zoo_entrance_building' | 'aquarium_terrarium_aviary' | 'animal_exhibition_building' | 'zoo_stable' | 'botanical_garden_building' | 'botanical_garden_entrance_building' | 'botanical_greenhouse' | 'conservatory' | 'other_recreational_facility_building' | 'mountain_hut_shelter' | 'tourist_information_center' | 'not_specified_due_to_source_situation' | 'water_tower' | 'church_tower' | 'observation_tower' | 'control_tower' | 'cooling_tower' | 'lighthouse' | 'fire_watchtower' | 'transmission_radio_tower' | 'city_gate_tower' | 'winding_tower' | 'drilling_tower' | 'castle_tower' | 'other' | 'biogas_plant' | 'wind_turbine' | 'solar_panels' | 'mast' | 'power_line_mast' | 'radio_mast' | 'radio_telescope' | 'chimney' | 'crane' | 'slewing_crane' | 'gantry_crane' | 'traveling_crane' | 'blast_furnace' | 'silo' | 'tank' | 'gasometer' | 'grandstand' | 'covered_grandstand' | 'uncovered_grandstand' | 'stadium' | 'covered_stadium' | 'uncovered_stadium' | 'ski_jump_inrun' | 'graduation_tower' | 'historic_water_pipeline' | 'watchtower' | 'fortification_castle_ruin' | 'historic_wall' | 'city_wall' | 'other_historic_wall' | 'canopy' | 'carport' | 'wall' | 'monument' | 'ship_lift' | 'chamber_lock' | 'bridge' | 'swing_bridge' | 'lifting_bridge' | 'drawbridge' | 'elevated_railway_elevated_road' | 'lock_chamber' | 'dam' | 'weir' | 'security_gate' | 'sewer_drain' | 'barrage';
 /**
  * The grouping strategy used to aggregate buildings in this result. Currently supports: proximity (cadastral based clustering) and property (cadastral, address, construction year, and roof type based grouping). Defaults to `proximity` when no strategy is specified in the request.
  */
@@ -3226,86 +2255,41 @@ type ParcelPropertiesV4 = {
      */
     free_area: number | null;
 };
-type GetAddressLookupV2Data = {
-    query: {
-        city: string;
-        postcode: string;
-        street: string;
-        streetNumber: string;
-    };
+type Position3D = unknown[];
+type Polygon3DGeometry = {
+    type: 'Polygon';
+    coordinates: Array<Array<Position3D>>;
 };
-type GetAddressLookupV2Response = {
-    type: 'Feature';
-    geometry: {
-        type: 'Polygon';
-        coordinates: Array<Array<(unknown[])>>;
-    } | {
-        type: 'MultiPolygon';
-        coordinates: Array<Array<Array<(unknown[])>>>;
-    };
-    properties: LookupPropertiesV2;
+type type2 = 'Polygon';
+type MultiPolygon3DGeometry = {
+    type: 'MultiPolygon';
+    coordinates: Array<Array<Array<Position3D>>>;
 };
-type GetAddressLookupV2Error = unknown;
-type GetCoordinateLookupV2Data = {
-    query?: {
-        lat?: number | null;
-        lng?: number | null;
-    };
+type type3 = 'MultiPolygon';
+type GeometryCollection3D = {
+    type: 'GeometryCollection';
+    geometries: Array<(Polygon3DGeometry | MultiPolygon3DGeometry)>;
 };
-type GetCoordinateLookupV2Response = {
-    type: 'Feature';
-    geometry: {
-        type: 'Polygon';
-        coordinates: Array<Array<(unknown[])>>;
-    } | {
-        type: 'MultiPolygon';
-        coordinates: Array<Array<Array<(unknown[])>>>;
-    };
-    properties: LookupPropertiesV2;
+type type4 = 'GeometryCollection';
+type Geometry3D = Polygon3DGeometry | MultiPolygon3DGeometry | GeometryCollection3D;
+/**
+ * The surface type of this geometry (wall, ground, or roof)
+ */
+type SurfaceType = 'wall' | 'ground' | 'roof';
+type BuildingGeometryPropertiesV4 = {
+    type: SurfaceType;
 };
-type GetCoordinateLookupV2Error = unknown;
-type PostCoordinateBatchLookupV2Data = {
-    /**
-     * Array of up to 500 geo coordinates
-     */
-    body: {
-        [key: string]: {
-            lat: number | null;
-            lng: number | null;
-        };
-    };
+type BuildingGeometryFeatureV4 = {
+    type: 'Feature';
+    geometry: Geometry3D;
+    properties: BuildingGeometryPropertiesV4;
 };
-type PostCoordinateBatchLookupV2Response = {
+type type5 = 'Feature';
+type BuildingGeometryResponseV4 = {
     type: 'FeatureCollection';
-    metadata: {
-        counts: {
-            total: number;
-            found: number;
-            not_found: number;
-        };
-        references: {
-            found: Array<(string)>;
-            not_found: Array<(string)>;
-        };
-    };
-    features: Array<{
-        type: 'Feature';
-        geometry: {
-            type: 'Polygon';
-            coordinates: Array<Array<(unknown[])>>;
-        } | {
-            type: 'MultiPolygon';
-            coordinates: Array<Array<Array<(unknown[])>>>;
-        };
-        properties: LookupPropertiesV2 & {
-            /**
-             * A unique identifier for the feature, which is provided by the client.
-             */
-            reference: string;
-        };
-    }>;
+    features: Array<BuildingGeometryFeatureV4>;
 };
-type PostCoordinateBatchLookupV2Error = unknown;
+type type6 = 'FeatureCollection';
 type GetAddressLookupV3Data = {
     query: {
         city: string;
@@ -3396,218 +2380,42 @@ type PostCoordinateBatchLookupV3Response = {
         properties: LookupPropertiesV3 & {
             /**
              * A unique identifier for the feature, which is provided by the client.
-             */
-            reference: string;
-        };
-    }>;
-};
-type PostCoordinateBatchLookupV3Error = unknown;
-type GetParcelCoordinateLookupV4Data = {
-    query?: {
-        lat?: number | null;
-        lng?: number | null;
-    };
-};
-type GetParcelCoordinateLookupV4Response = {
-    type: 'FeatureCollection';
-    features: Array<{
-        type: 'Feature';
-        geometry: {
-            type: 'Polygon';
-            coordinates: Array<Array<(unknown[])>>;
-        } | {
-            type: 'MultiPolygon';
-            coordinates: Array<Array<Array<(unknown[])>>>;
-        };
-        properties: ParcelPropertiesV4;
-    }>;
-};
-type GetParcelCoordinateLookupV4Error = unknown;
-type $OpenApiTs = {
-    '/v2/addressLookup': {
-        get: {
-            req: GetAddressLookupV2Data;
-            res: {
-                /**
-                 *
-                 * Retrieves the building data based on the provided address. The response includes detailed
-                 * information about the building. A more detailed description of the response can be found
-                 * in the schema definition.
-                 *
-                 */
-                '200': {
-                    type: 'Feature';
-                    geometry: {
-                        type: 'Polygon';
-                        coordinates: Array<Array<(unknown[])>>;
-                    } | {
-                        type: 'MultiPolygon';
-                        coordinates: Array<Array<Array<(unknown[])>>>;
-                    };
-                    properties: LookupPropertiesV2;
-                };
-                /**
-                 * Invalid address
-                 */
-                '400': {
-                    /**
-                     * Invalid address
-                     */
-                    error: string;
-                };
-                /**
-                 * Address not found
-                 */
-                '404': {
-                    /**
-                     * Address not found
-                     */
-                    error: string;
-                };
-                /**
-                 * Internal server error
-                 */
-                '500': {
-                    /**
-                     * Internal server error
-                     */
-                    error: string;
-                };
-            };
-        };
-    };
-    '/v2/coordinateLookup': {
-        get: {
-            req: GetCoordinateLookupV2Data;
-            res: {
-                /**
-                 *
-                 * Retrieves the building data based on the provided address. The response includes detailed
-                 * information about the building. A more detailed description of the response can be found in
-                 * the schema definition.
-                 *
-                 */
-                '200': {
-                    type: 'Feature';
-                    geometry: {
-                        type: 'Polygon';
-                        coordinates: Array<Array<(unknown[])>>;
-                    } | {
-                        type: 'MultiPolygon';
-                        coordinates: Array<Array<Array<(unknown[])>>>;
-                    };
-                    properties: LookupPropertiesV2;
-                };
-                /**
-                 * Invalid coordinate
-                 */
-                '400': {
-                    /**
-                     * Invalid coordinate
-                     */
-                    error: string;
-                };
-                /**
-                 * Unauthorized access
-                 */
-                '401': {
-                    /**
-                     * Unauthorized access
-                     */
-                    error: string;
-                };
-                /**
-                 * Coordinate not found
-                 */
-                '404': {
-                    /**
-                     * Coordinate not found
-                     */
-                    error: string;
-                };
-                /**
-                 * Internal server error
-                 */
-                '500': {
-                    /**
-                     * Internal server error
-                     */
-                    error: string;
-                };
-            };
+             */
+            reference: string;
         };
+    }>;
+};
+type PostCoordinateBatchLookupV3Error = unknown;
+type GetParcelCoordinateLookupV4Data = {
+    query?: {
+        lat?: number | null;
+        lng?: number | null;
     };
-    '/v2/coordinateBatchLookup': {
-        post: {
-            req: PostCoordinateBatchLookupV2Data;
-            res: {
-                /**
-                 *
-                 * Retrieves the building data for each of the provided coordinates. The response includes an array of detailed
-                 * information about the buildings associated with each coordinate. A more detailed description of the response can be found in
-                 * the schema definition.
-                 *
-                 */
-                '200': {
-                    type: 'FeatureCollection';
-                    metadata: {
-                        counts: {
-                            total: number;
-                            found: number;
-                            not_found: number;
-                        };
-                        references: {
-                            found: Array<(string)>;
-                            not_found: Array<(string)>;
-                        };
-                    };
-                    features: Array<{
-                        type: 'Feature';
-                        geometry: {
-                            type: 'Polygon';
-                            coordinates: Array<Array<(unknown[])>>;
-                        } | {
-                            type: 'MultiPolygon';
-                            coordinates: Array<Array<Array<(unknown[])>>>;
-                        };
-                        properties: LookupPropertiesV2 & {
-                            /**
-                             * A unique identifier for the feature, which is provided by the client.
-                             */
-                            reference: string;
-                        };
-                    }>;
-                };
-                /**
-                 * Invalid coordinates
-                 */
-                '400': {
-                    /**
-                     * Invalid coordinates
-                     */
-                    error: string;
-                };
-                /**
-                 * Unauthorized access
-                 */
-                '401': {
-                    /**
-                     * Unauthorized access
-                     */
-                    error: string;
-                };
-                /**
-                 * Internal server error
-                 */
-                '500': {
-                    /**
-                     * Internal server error
-                     */
-                    error: string;
-                };
-            };
+};
+type GetParcelCoordinateLookupV4Response = {
+    type: 'FeatureCollection';
+    features: Array<{
+        type: 'Feature';
+        geometry: {
+            type: 'Polygon';
+            coordinates: Array<Array<(unknown[])>>;
+        } | {
+            type: 'MultiPolygon';
+            coordinates: Array<Array<Array<(unknown[])>>>;
         };
+        properties: ParcelPropertiesV4;
+    }>;
+};
+type GetParcelCoordinateLookupV4Error = unknown;
+type GetBuildingPart3dGeometryLookupV4Data = {
+    query: {
+        building_id: string;
+        grouping_strategy?: 'proximity' | 'property';
     };
+};
+type GetBuildingPart3dGeometryLookupV4Response = BuildingGeometryResponseV4;
+type GetBuildingPart3dGeometryLookupV4Error = unknown;
+type $OpenApiTs = {
     '/v3/addressLookup': {
         get: {
             req: GetAddressLookupV3Data;
@@ -3849,143 +2657,46 @@ type $OpenApiTs = {
             };
         };
     };
+    '/v4/buildingPart3dGeometryLookup': {
+        get: {
+            req: GetBuildingPart3dGeometryLookupV4Data;
+            res: {
+                /**
+                 *
+                 * Retrieves the 3D building part geometries for the group that contains the given building identifier.
+                 * The response includes wall, roof, and ground surface geometries as individual Features in a FeatureCollection.
+                 *
+                 */
+                '200': BuildingGeometryResponseV4;
+                /**
+                 * Invalid or missing building_id
+                 */
+                '400': {
+                    error: string;
+                };
+                /**
+                 * Unauthorized access
+                 */
+                '401': {
+                    error: string;
+                };
+                /**
+                 * Building not found
+                 */
+                '404': {
+                    error: string;
+                };
+                /**
+                 * Internal server error
+                 */
+                '500': {
+                    error: string;
+                };
+            };
+        };
+    };
 };
 
-/**
- * Retrieve building data based on a given address
- *
- * This endpoint allows users to retrieve detailed building data by providing an address.
- * The data includes information from both public and private sources, aggregated into a
- * comprehensive dataset.
- *
- * ### Permissions
- * - `api.lookup.address.read`: This permission grants the ability
- * to read and retrieve building data based on a provided address. It ensures that the
- * user has access rights to query the address-based lookup endpoint.
- *
- * ### Address-based Lookup
- * This endpoint is designed to retrieve building data based on a given address, focusing
- * solely on exact matches. If the address is not found, the endpoint will return an empty
- * response. For use cases involving un-geocoded addresses, we recommend using our
- * coordinate-based lookup endpoint.
- *
- * ### Response Structure
- * - **GeoJSON Type**: In v2, the response format has been simplified to a `Feature` object, representing a single feature, rather than the `FeatureCollection` type returned by v1. This change reflects the endpoint's focus on returning a single or no result based on the query.
- */
-declare const getAddressLookupV2: (options: Options<GetAddressLookupV2Data>) => Promise<{
-    error?: unknown;
-    data?: GetAddressLookupV2Response | undefined;
-    request: Request;
-    response: Response;
-}>;
-/**
- * Retrieve building data based on a given coordinate
- *
- * This endpoint allows users to retrieve detailed building data by providing a geo coordinate.
- * The data includes information from both public and private sources, aggregated into a
- * comprehensive dataset.
- *
- * ### Key Changes in v2
- * In v2, the response format has been optimized to return a `Feature` rather than a `FeatureCollection`. This adjustment reflects the endpoint’s focus on retrieving a single result or no result, rather than a collection, simplifying client-side handling.
- *
- * ### Permissions
- * - `api.lookup.coordinate.read`: This permission grants the ability to
- * read and retrieve building data based on a provided coordinate. It ensures that the user has
- * access rights to query the coordinate-based lookup endpoint.
- *
- * ### Response Structure
- * - **GeoJSON Type**: The response in v2 is now a single `Feature` object representing one building result or an empty response if no match is found. This differs from v1, which returned a `FeatureCollection` object.
- */
-declare const getCoordinateLookupV2: (options?: Options<GetCoordinateLookupV2Data>) => Promise<{
-    error?: unknown;
-    data?: GetCoordinateLookupV2Response | undefined;
-    request: Request;
-    response: Response;
-}>;
-/**
- * Retrieve building data for a batch of coordinates
- *
- * This endpoint allows users to retrieve detailed building data by providing a batch of
- * geo-coordinates. The response is a GeoJSON object containing a FeatureCollection, where each
- * feature represents a building and includes additional properties for tracking back to the
- * requested coordinates.
- *
- * ### Key Improvements in v2
- *
- * In v2, each coordinate can be assigned a unique reference ID in the request body, allowing for
- * more precise handling of results. The response includes a metadata section that provides:
- * - The total number of coordinates processed.
- * - A count of found and not-found coordinates.
- * - Lists of references for found and not-found coordinates, making it easier to manage unmatched
- * entries without requiring complex client-side matching logic.
- *
- * ### Request Body Format
- * The request body is structured as an object where each key is a unique reference ID for a
- * coordinate:
- *
- * ```json
- * {
- * "reference_id1": { "lat": 51.252258, "lng": 7.13107 },
- * "reference_id2": { "lat": 51.29342, "lng": 7.21936 },
- * "reference_id3": { "lat": 51.18941, "lng": 7.14259 }
- * }
- * ```
- *
- * ### Response Structure
- * - **GeoJSON Type**: The response includes a FeatureCollection containing matched features.
- * - **Metadata**:
- * - `counts`: Provides total, found, and not-found counts for the requested coordinates.
- * - `references`: Lists reference IDs of matched (`found`) and unmatched (`not_found`)
- * coordinates.
- *
- * #### Example Response:
- * ```json
- * {
- * "type": "FeatureCollection",
- * "metadata": {
- * "counts": {
- * "total": 3,
- * "found": 2,
- * "not_found": 1
- * },
- * "references": {
- * "found": ["reference_id1", "reference_id2"],
- * "not_found": ["reference_id3"]
- * }
- * },
- * "features": [
- * {
- * "type": "Feature",
- * "geometry": { * geometry details * },
- * "properties": {
- * "ref": "reference_id1",
- * ...
- * }
- * },
- * ...
- * ]
- * }
- * ```
- *
- * ### Handling Non-Matching Coordinates
- *
- * For unmatched coordinates, v2 includes metadata listing these coordinates, enabling clients to
- * easily filter out or handle non-matching entries. This improves upon v1, where clients had to
- * manage complex matching logic without clear references for non-matching coordinates.
- *
- * ### Limitations
- * This endpoint supports up to 500 coordinates per request. If more are needed, split into multiple
- * requests.
- *
- * ### Permissions
- * - `api.batch.lookup.coordinate.read`: Grants the ability to access this endpoint.
- */
-declare const postCoordinateBatchLookupV2: (options: Options<PostCoordinateBatchLookupV2Data>) => Promise<{
-    error?: unknown;
-    data?: PostCoordinateBatchLookupV2Response | undefined;
-    request: Request;
-    response: Response;
-}>;
 /**
  * Retrieve building data based on a given address
  *
@@ -4120,7 +2831,7 @@ declare const getCoordinateLookupV3: (options?: Options<GetCoordinateLookupV3Dat
  *
  * ### Handling Non-Matching Coordinates
  *
- * For unmatched coordinates, v2 includes metadata listing these coordinates, enabling clients to
+ * For unmatched coordinates, the response includes metadata listing these coordinates, enabling clients to
  * easily filter out or handle non-matching entries. This improves upon v1, where clients had to
  * manage complex matching logic without clear references for non-matching coordinates.
  *
@@ -4168,5 +2879,41 @@ declare const getParcelCoordinateLookupV4: (options?: Options<GetParcelCoordinat
     request: Request;
     response: Response;
 }>;
+/**
+ * Retrieve 3D building part geometries for the group of a building
+ *
+ * This endpoint retrieves the 3D building part geometries for the group that contains the queried building.
+ * The data includes wall, roof, and ground surface geometries as individual GeoJSON Features with
+ * 3D coordinates (longitude, latitude, altitude).
+ *
+ * ### New in v4
+ * This is a new endpoint in v4 dedicated to 3D building geometry retrieval. Each building is decomposed
+ * into its constituent surfaces — walls, roofs, and ground planes — each returned as a separate Feature
+ * with a `type` property indicating the surface kind.
+ *
+ * ### Permissions
+ * - `api.lookup.building.geometry.read`: This permission grants the ability to
+ * read and retrieve 3D building part geometries for a given building identifier.
+ *
+ * ### Grouping Strategy
+ * This endpoint resolves the full building group for the queried building using the selected grouping strategy:
+ * - `proximity` (default) — geometry-based spatial clustering via `gold__proximity_groups`
+ * - `property` — cadastral address-based grouping via `gold__property_groups`
+ *
+ * It then returns 3D geometries for all buildings in that resolved group, not only the single queried building. This enables rendering complete building clusters in 3D.
+ *
+ * ### Response Structure
+ * - **GeoJSON Type**: The response returns a `FeatureCollection` containing all geometry parts
+ * for the requested building.
+ * - **Properties**: Each Feature includes a `type` property with value `wall`, `ground`, or `roof`.
+ * - **Geometry**: Contains 3D Polygon coordinates in WGS84 (EPSG:4326) with altitude values as the
+ * third coordinate element `[longitude, latitude, altitude]`.
+ */
+declare const getBuildingPart3dGeometryLookupV4: (options: Options<GetBuildingPart3dGeometryLookupV4Data>) => Promise<{
+    error?: unknown;
+    data?: BuildingGeometryResponseV4 | undefined;
+    request: Request;
+    response: Response;
+}>;
 
-export { $LookupPropertiesV2, $LookupPropertiesV3, type $OpenApiTs, $ParcelPropertiesV4, type GetAddressLookupV2Data, type GetAddressLookupV2Error, type GetAddressLookupV2Response, type GetAddressLookupV3Data, type GetAddressLookupV3Error, type GetAddressLookupV3Response, type GetCoordinateLookupV2Data, type GetCoordinateLookupV2Error, type GetCoordinateLookupV2Response, type GetCoordinateLookupV3Data, type GetCoordinateLookupV3Error, type GetCoordinateLookupV3Response, type GetParcelCoordinateLookupV4Data, type GetParcelCoordinateLookupV4Error, type GetParcelCoordinateLookupV4Response, type LookupPropertiesV2, type LookupPropertiesV3, type ParcelPropertiesV4, type PostCoordinateBatchLookupV2Data, type PostCoordinateBatchLookupV2Error, type PostCoordinateBatchLookupV2Response, type PostCoordinateBatchLookupV3Data, type PostCoordinateBatchLookupV3Error, type PostCoordinateBatchLookupV3Response, type building_function_class, type characteristics, type development_layout, type dominant, type environment, getAddressLookupV2, getAddressLookupV3, getCoordinateLookupV2, getCoordinateLookupV3, getParcelCoordinateLookupV4, type governance, type grouping_strategy, type height_category, type investment_perspective, type milieus_dominant, type modernisation_potential, type overall, postCoordinateBatchLookupV2, postCoordinateBatchLookupV3, type roof_type, type social, type type, type usage };
+export { $BuildingGeometryFeatureV4, $BuildingGeometryPropertiesV4, $BuildingGeometryResponseV4, $Geometry3D, $GeometryCollection3D, $LookupPropertiesV3, $MultiPolygon3DGeometry, type $OpenApiTs, $ParcelPropertiesV4, $Polygon3DGeometry, $Position3D, $SurfaceType, type BuildingGeometryFeatureV4, type BuildingGeometryPropertiesV4, type BuildingGeometryResponseV4, type Geometry3D, type GeometryCollection3D, type GetAddressLookupV3Data, type GetAddressLookupV3Error, type GetAddressLookupV3Response, type GetBuildingPart3dGeometryLookupV4Data, type GetBuildingPart3dGeometryLookupV4Error, type GetBuildingPart3dGeometryLookupV4Response, type GetCoordinateLookupV3Data, type GetCoordinateLookupV3Error, type GetCoordinateLookupV3Response, type GetParcelCoordinateLookupV4Data, type GetParcelCoordinateLookupV4Error, type GetParcelCoordinateLookupV4Response, type LookupPropertiesV3, type MultiPolygon3DGeometry, type ParcelPropertiesV4, type Polygon3DGeometry, type Position3D, type PostCoordinateBatchLookupV3Data, type PostCoordinateBatchLookupV3Error, type PostCoordinateBatchLookupV3Response, type SurfaceType, type building_function_class, type characteristics, type development_layout, type dominant, type environment, getAddressLookupV3, getBuildingPart3dGeometryLookupV4, getCoordinateLookupV3, getParcelCoordinateLookupV4, type governance, type grouping_strategy, type investment_perspective, type milieus_dominant, type modernisation_potential, type overall, postCoordinateBatchLookupV3, type roof_type, type social, type type, type type2, type type3, type type4, type type5, type type6 };