Update README.md

README.md

@@ -8,6 +8,38 @@ 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.
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+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