Building
Buildings are man-made structures with roofs that exist permanently in one place.
A building's geometry represents the two-dimensional footprint of the building as viewed from
directly above, looking down. Fields such as height and num_floors allow the
three-dimensional shape to be approximated. Some buildings, identified by the has_parts field,
have associated BuildingPart features which can be used to generate a more representative 3D
model of the building.
Fields
| Name | Type | Description |
|---|---|---|
id | Id | A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS. |
bbox | bbox (optional) | An optional bounding box for the feature |
geometry | geometry | The building's footprint or roofprint (if traced from aerial/satellite imagery). Allowed geometry types: MultiPolygon, Polygon |
theme | "buildings" | |
type | "building" | |
version | FeatureVersion | |
sources[](7) | Sources (list, optional) | Information about the source data used to assemble the feature. |
subtype | BuildingSubtype (optional) | A broad classification of the current use and purpose of the building. If the current use of the building no longer accords with the original built purpose, the current use should be specified. For example, a building built as a train station but later converted into a shopping mall would have the value "commercial" rather than "transportation". |
class | BuildingClass (optional) | A more specific classification of the current use and purpose of the building. If the current use of the building no longer accords with the original built purpose, the current use should be specified. |
has_parts | boolean (optional) | Whether the building has associated building part featuresstrict=True |
names(11) | Names (optional) | |
level | Level (optional) | Z-order of the feature where 0 is visual level |
height | float64 (optional) | Height of the building or part in meters. This is the distance from the lowest point to the highest point. > 0 |
is_underground | boolean (optional) | Whether the entire building or part is completely below ground. The underground flag is useful for display purposes. Buildings and building parts that are entirely below ground can be styled differently or omitted from the rendered image. This flag is conceptually different from the level field, which indicates relative z-ordering and, notably, can be negative even if the building is entirely above-ground.strict=True |
num_floors | int32 (optional) | Number of above-ground floors of the building or part.> 0 |
num_floors_underground | int32 (optional) | Number of below-ground floors of the building or part.> 0 |
min_height | float64 (optional) | Altitude above ground where the bottom of the building or building part starts. If present, this value indicates that the lowest part of the building or building part starts is above ground level. |
min_floor | int32 (optional) | Start floor of this building or part. If present, this value indicates that the building or part is "floating" and its bottom-most floor is above ground level, usually because it is part of a larger building in which some parts do reach down to ground level. An example is a building that has an entry road or driveway at ground level into an interior courtyard, where part of the building bridges above the entry road. This property may sometimes be populated when min_height is missing and in these cases can be used as a proxy for min_height.> 0 |
facade_color | HexColor (optional) | Facade color in #rgb or #rrggbb hex notation |
facade_material | FacadeMaterial (optional) | Outer surface material of the facade |
roof_material | RoofMaterial (optional) | Outer surface material of the roof |
roof_shape | RoofShape (optional) | Shape of the roof |
roof_direction | float64 (optional) | Bearing of the roof ridge line in degrees≥ 0< 360 |
roof_orientation | RoofOrientation (optional) | Orientation of the roof shape relative to the footprint shape |
roof_color | HexColor (optional) | The roof color in #rgb or #rrggbb hex notation |
roof_height | float64 (optional) | Height of the roof in meters. This is the distance from the base of the roof to its highest point. |
Examples
| Column | Value |
|---|---|
id | 148f35b1-7bc1-4180-9280-10d39b13883b |
bbox.xmin | -176.643798828125 |
bbox.xmax | -176.64349365234375 |
bbox.ymin | -43.9938850402832 |
bbox.ymax | -43.993709564208984 |
geometry | POLYGON ((-176.6435004 -43.9938042, -176.6435738 -43.9937107, -176.6437726 -43.9937913, -176.6436... |
theme | buildings |
type | building |
version | 1 |
sources[0].property | |
sources[0].dataset | OpenStreetMap |
sources[0].record_id | w519166507@1 |
sources[0].update_time | 2017-08-27T21:39:50.000Z |
sources[0].confidence | null |
sources[0].between | null |
subtype | null |
class | null |
has_parts | false |
names | null |
level | null |
height | null |
is_underground | false |
num_floors | null |
num_floors_underground | null |
min_height | null |
min_floor | null |
facade_color | null |
facade_material | null |
roof_material | null |
roof_shape | null |
roof_direction | null |
roof_orientation | null |
roof_color | null |
roof_height | null |