---
title: Trackemdown
emoji: 🐢
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.46.1
app_file: app.py
pinned: false
license: apache-2.0
short_description: A simple learning project to explore H3 geospatial indexing.
---

Type any address and get:
- Exact coordinates (latitude, longitude)
- H3 geotag (hierarchical hexagonal identifier)
- Interactive map with hexagon boundaries

#### How it works

1. Address → Coordinates: Uses `OpenStreetMap Nominatim` to find locations
2. Coordinates → H3 Geotag: Converts to Uber's H3 hexagonal grid system
3. Visualisation: Shows results on an interactive map

#### Examples

Try typing:
- San Francisco - City names
- 37.7749,-122.4194 - Direct coordinates
- Eiffel Tower - Landmarks
- Main Street - Generic addresses (shows multiple matches)

#### What's H3?

H3 divides Earth into hexagonal cells at different resolutions:
- Low resolution (0-5): Continental/country level
- Medium resolution (6-10): City/neighborhood level
- High resolution (11-15): Building/room level

#### Tech Stack

- Backend: FastAPI + H3 library
- Geocoding: OpenStreetMap Nominatim (free service)
- Frontend: Gradio interface
- Maps: Plotly with hexagon boundary visualization