Nominatim Bulk Geocoder

Bulk-geocode addresses (string → lat/lon + structured address) via OSM Nominatim. Maps to "geocode this list of N addresses" briefs — real estate, logistics, delivery routing, retail-site-selection, customer-base mapping.

Built 2026-05-03 as Demo #44.

Run

. ~/freelance/.venv/bin/activate
cd ~/freelance/portfolio_demos/nominatim_geocoder
python extract.py --addresses "Empire State Building NYC,Eiffel Tower Paris,Sydney Opera House"
python extract.py --file addresses.txt

Result

• 4/5 geocoded (Brandenburg Gate needed more disambiguation — handled gracefully) ✅
• Per-row: lat, lon, city, state, country, country_code, postcode, road, house_number, neighbourhood, class, type, importance, OSM type/id, full display_name ✅
• 1.1s sleep between requests — Nominatim's strict 1 req/s policy honored ✅
• Free, no API key ✅