https://github.com/osgeonepal/obe
Open Buildings Extractor
https://github.com/osgeonepal/obe
buildings download gis google microsoft opensource osm overture
Last synced: 8 days ago
JSON representation
Open Buildings Extractor
- Host: GitHub
- URL: https://github.com/osgeonepal/obe
- Owner: osgeonepal
- Created: 2025-02-20T15:26:04.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-20T21:30:59.000Z (7 months ago)
- Last Synced: 2026-06-15T05:34:19.064Z (8 days ago)
- Topics: buildings, download, gis, google, microsoft, opensource, osm, overture
- Language: Jupyter Notebook
- Homepage: https://pypi.org/project/obe/
- Size: 2.76 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# 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:](./example_obe_usage.ipynb)
## 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](https://obextract.streamlit.app/)
## Installation
Using pip:
```bash
pip install obe
```
Using poetry
```bash
poetry add obe
```
## Usage
### Command line interface
```bash
obe --source --input --output
```
### Examples:
```bash
# 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
```python
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
```json
{
"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
### Authors
- Initiated by @kshitijrajsharma