voxcity.downloader.overture¶
Module for downloading and processing building footprint data from Overture Maps.
This module provides functionality to download and process building footprints, handling the conversion of Overture Maps data to GeoJSON format with standardized properties.
The module includes functions for: - Converting data types between numpy and Python native types - Processing and validating building footprint data - Handling geometric operations and coordinate transformations - Combining and standardizing building data from multiple sources
Main workflow: 1. Download building data from Overture Maps using a bounding box 2. Process and standardize the data format 3. Combine building and building part data 4. Add unique identifiers and standardize properties
Functions¶
|
Download and process building footprint data from Overture Maps. |
Module Contents¶
- voxcity.downloader.overture.load_gdf_from_overture(rectangle_vertices, floor_height=3.0)¶
Download and process building footprint data from Overture Maps.
This function serves as the main entry point for downloading building data. It handles the complete workflow of downloading both building and building part data, combining them, and preparing them for further processing.
- Parameters:
rectangle_vertices (list) – List of (lon, lat) coordinates defining the bounding box for data download
- Returns:
- Combined dataset containing:
Building and building part geometries
Standardized properties
Sequential numeric IDs
- Return type:
GeoDataFrame
Note
Downloads both building and building_part data from Overture Maps
Combines the datasets while preserving all properties
Assigns sequential IDs based on the final dataset index