obe 0.0.4

Open Buildings Extractor

OBE (Open Buildings Extractor)

A Python package to extract building footprints from multiple open data sources including Google Open Buildings, Microsoft Building Footprints, OpenStreetMap, and Overture Maps.

Example

Run Example Notebook here:

Features

• Extract building footprints from multiple sources:
  • Google Open Buildings
  • Microsoft Building Footprints
  • OpenStreetMap
  • Overture Maps
• Support for multiple output formats:
  • GeoJSON
  • GeoPackage
  • Shapefile
  • GeoJSONSeq
  • GeoParquet
• Command-line interface
• Python API
• Streamlit web interface

Installation

Using pip:

pip install obe

Using poetry

poetry add obe

Usage

Command line interface

obe --source <source> --input <input.geojson> --output <output.geojson>

Examples:

# Google Open Buildings
obe --source google --input area.geojson --output google_buildings.geojson

# Microsoft Building Footprints (requires location)
obe --source microsoft --input area.geojson --output ms_buildings.geojson --location Nepal

# OpenStreetMap
obe --source osm --input area.geojson --output osm_buildings.geojson

# Overture Maps
obe --source overture --input area.geojson --output overture_buildings.geojson

Python API

from obe.app import download_buildings

# Download buildings from any source
download_buildings(
    source="google",  # or "microsoft", "osm", "overture"
    input_path="area.geojson",
    output_path="buildings.geojson",
    format="geojson",  # or "geopackage", "shapefile", "geojsonseq", "geoparquet"
    location=None  # required for Microsoft ("Nepal", "India", etc.)
)

Example Input

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {},
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [83.96184435207743, 28.212767538129086],
            [83.96184435207743, 28.20236573207498],
            [83.97605449676462, 28.20236573207498],
            [83.97605449676462, 28.212767538129086],
            [83.96184435207743, 28.212767538129086]
          ]
        ]
      }
    }
  ]
}