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 Footprint Schema
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 it's footprint or roofprint (if traced from aerial/satellite imagery). These MUST be a Polygon as defined by 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/levelContainer
    properties:
      names: { "$ref": "../defs.yaml#/$defs/propertyDefinitions/names" }
      height:
        description: Height of the building in meters
        type: number
        exclusiveMinimum: 0
      numFloors:
        description: Number of above-ground floors of the building
        type: integer
        exclusiveMinimum: 0
      class:
        description: >-
          A broad category of the building type / purpose. When the current use of the building does not match the built purpose, the class should
          be set to represent the current use of the building.
        type: string
        enum:
          - residential
          - outbuilding
          - agricultural
          - commercial
          - industrial
          - education
          - service
          - religious
          - civic
          - transportation
          - medical
          - entertainment
          - military

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": {
    "extFoo": "I am a customer user property.",
    "extBar": "Me too!",
    "theme": "buildings",
    "type": "building",
    "version": 1,
    "level": 1,
    "updateTime": "2023-06-06T10:30:00-08:00",
    "height": 21.34,
    "numFloors": 4,
    "class": "civic",
    "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": {
    "extFoo": "I am a customer user property.",
    "extBar": "Me too!",
    "theme": "buildings",
    "type": "building",
    "version": 0,
    "updateTime": "2023-02-22T23:55:01-08:00"
  }
}

Building with Multiple Names

{
  "id": "overture:buildings:building:1234",
  "type": "Feature",
  "properties": {
    "extFoo": "I am a customer user property.",
    "extBar": "Me too!",
    "theme": "buildings",
    "type": "building",
    "version": 1,
    "updateTime": "2023-02-22T23:55:01-08:00",
    "names": {
      "common": [
        {
          "value": "The White House",
          "language": "local"
        },
        {
          "value": "La Casa Blanca",
          "language": "es"
        }
      ],
      "official": [
        {
          "value": "The White House",
          "language": "local"
        }
      ],
      "alternate": [
        {
          "value": "White House",
          "language": "local"
        }
      ]
    }
  },
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -77.036873,
          38.897804
        ],
        [
          -77.036873,
          38.897559
        ],
        [
          -77.03626,
          38.897559
        ],
        [
          -77.03626,
          38.897804
        ],
        [
          -77.036873,
          38.897804
        ]
      ]
    ]
  }
}