SBI Topography Tool

A Python tool for generating 3D topographical models from Google Maps Elevation API data. It generates OBJ files for visualization.

Requirements

• Python 3.13+
• uv
• Google Maps API key

Setup

1. Clone this repository

2. Update your environment with uv: uv sync

3. Activate the virtual environment:

   • Windows: .venv\Scripts\activate
   • Unix/MacOS: source .venv/bin/activate

4. Create a .env file and add your Google Maps API key:

   GOOGLE_MAPS_API_KEY=your_api_key_here
   

Usage

1. Fill in the 4 corners in main.py

2. Run the main script to collect elevation data:

   uv run topography/main.py

3. Generate 3D models:

   uv run topography/utils/json_to_obj.py

   (Make sure to change the input file name)

4. Visualize the data:

   uv run topography/utils/visualize_topography.py

   (Make sure to change the input file name) It may be very slow depending on the number of points the json file contains.