Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

osgeonepal/obe

Repository files navigation

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
  • 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]
 ]
 ]
 }
 }
 ]
}

Example Output

image

Authors

  • Initiated by @kshitijrajsharma

AltStyle によって変換されたページ (->オリジナル) /