Building

Buildings are human-made structures with roofs or interior spaces that are permanently or semi-permanently in one place (OSM building definition).

Geometry Type	Polygon or MultiPolygon
Theme	buildings
Type	building

The most basic form of a building feature in the Overture Schema. The geometry is expected to be the most outer footprint (or roofprint if traced from satellite/aerial imagery) of a building.

Schema

Browsable

Loading ....

YAML

---
"$schema": https://json-schema.org/draft/2020-12/schema
title: building
description: >-
  A building is a man-made structure with a roof that exists permanently in one place. Buildings are compatible with
  GeoJSON Polygon features.
type: object
properties:
  id:
    "$ref": ../defs.yaml#/$defs/propertyDefinitions/id
  geometry:
    description: >-
      A regular building's geometry is defined as its footprint or
      roofprint (if traced from aerial/satellite imagery). It MUST be a
      Polygon or MultiPolygon as defined by the GeoJSON schema.
    unevaluatedProperties: false
    oneOf:
      - "$ref": https://geojson.org/schema/Polygon.json
      - "$ref": https://geojson.org/schema/MultiPolygon.json
  properties:
    unevaluatedProperties: false
    allOf:
      - "$ref": ../defs.yaml#/$defs/propertyContainers/overtureFeaturePropertiesContainer
      - "$ref": ../defs.yaml#/$defs/propertyContainers/namesContainer
      - "$ref": ../defs.yaml#/$defs/propertyContainers/levelContainer
      - "$ref": ./defs.yaml#/$defs/propertyContainers/shapeContainer
    properties:
      subtype:
        description: >-
          A broad category of the building type/purpose. When the
          current use of the building does not match the built purpose,
          the subtype should be set to represent the current use of the
          building.
        type: string
        enum:
          - agricultural
          - civic
          - commercial
          - education
          - entertainment
          - industrial
          - medical
          - military
          - outbuilding
          - religious
          - residential
          - service
          - transportation
      class:
        description: >-
          Further delineation of the building's built purpose.
        type: string
        enum:
          - agricultural
          - allotment_house
          - apartments
          - barn
          - beach_hut
          - boathouse
          - bridge_structure
          - bungalow
          - bunker
          - cabin
          - carport
          - cathedral
          - chapel
          - church
          - civic
          - college
          - commercial
          - cowshed
          - detached
          - digester
          - dormitory
          - dwelling_house
          - factory
          - farm
          - farm_auxiliary
          - fire_station
          - garage
          - garages
          - ger
          - glasshouse
          - government
          - grandstand
          - greenhouse
          - guardhouse
          - hangar
          - hospital
          - hotel
          - house
          - houseboat
          - hut
          - industrial
          - kindergarten
          - kiosk
          - library
          - manufacture
          - military
          - monastery
          - mosque
          - office
          - outbuilding
          - parking
          - pavilion
          - post_office
          - presbytery
          - public
          - religious
          - residential
          - retail
          - school
          - semi
          - semidetached_house
          - service
          - shed
          - shrine
          - silo
          - slurry_tank
          - sports_centre
          - sports_hall
          - stable
          - stadium
          - static_caravan
          - stilt_house
          - storage_tank
          - sty
          - supermarket
          - synagogue
          - temple
          - terrace
          - toilets
          - train_station
          - transformer_tower
          - transportation
          - trullo
          - university
          - warehouse
          - wayside_shrine

      has_parts:
        description: Flag indicating whether the building has parts
        type: boolean

Examples

Polygon Building

{
  "id": "overture:buildings:building:1234",
  "type": "Feature",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -77.036873,
          38.897804
        ],
        [
          -77.036873,
          38.897559
        ],
        [
          -77.03626,
          38.897559
        ],
        [
          -77.03626,
          38.897804
        ],
        [
          -77.036873,
          38.897804
        ]
      ]
    ]
  },
  "properties": {
    "ext_foo": "I am a customer user property.",
    "ext_bar": "Me too!",
    "theme": "buildings",
    "type": "building",
    "version": 1,
    "level": 1,
    "height": 21.34,
    "num_floors": 4,
    "num_floors_underground": 1,
    "subtype": "transportation",
    "class": "parking",
    "is_underground": false,
    "sources": [
      {
        "property": "",
        "dataset": "microsoftMLBuildings,",
        "confidence": 1
      },
      {
        "property": "/properties/height",
        "dataset": "metaLidarExtractions,",
        "confidence": 0.95
      }
    ]
  }
}

MultiPolygon Building

{
  "id": "overture:buildings:building:1234",
  "type": "Feature",
  "geometry": {
    "type": "MultiPolygon",
    "coordinates": [
      [
        [
          [
            0,
            0
          ],
          [
            0,
            1
          ],
          [
            1,
            1
          ],
          [
            1,
            0
          ],
          [
            0,
            0
          ]
        ]
      ]
    ]
  },
  "properties": {
    "ext_foo": "I am a customer user property.",
    "ext_bar": "Me too!",
    "theme": "buildings",
    "type": "building",
    "version": 0
  }
}

Building with Multiple Names

{
  "id": "overture:buildings:building:1234",
  "type": "Feature",
  "properties": {
    "ext_foo": "I am a customer user property.",
    "ext_bar": "Me too!",
    "theme": "buildings",
    "type": "building",
    "version": 1,
    "names": {
      "primary": "The White house",
      "common": {
        "es": "La Casa Blanca"
      },
      "rules": [
        {
          "variant": "official",
          "value": "The White House"
        },
        {
          "variant": "alternate",
          "value": "White House"
        }
      ]
    }
  },
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -77.036873,
          38.897804
        ],
        [
          -77.036873,
          38.897559
        ],
        [
          -77.03626,
          38.897559
        ],
        [
          -77.03626,
          38.897804
        ],
        [
          -77.036873,
          38.897804
        ]
      ]
    ]
  }
}