This repository contains tools to extract all cities visited during a cross-country bike trip from GPX files, with minimal API usage.

88 cities from Santa Monica, CA to New York City, NY

• cities_route.csv - Complete list in CSV format
• cities_route.txt - Complete list in readable format

• run_city_finder.py - Recommended: Hybrid approach (minimal API calls)
• comprehensive_city_finder.py - Comprehensive approach (more cities, more API calls)
• efficient_city_finder.py - Efficient clustering approach
• offline_city_finder.py - Zero API calls (major cities only)

• Total Cities Found: 88
• Route: Santa Monica, CA → New York City, NY
• API Calls: 69-225 (vs 600+ in original approach)
• States Covered: California, Arizona, New Mexico, Oklahoma, Arkansas, Missouri, Illinois, Indiana, Ohio, Pennsylvania, New York, New Jersey, West Virginia

# Install dependencies
pip install gpxpy geopy

# Run the recommended approach
python run_city_finder.py

• gpx/ - All GPX files from the bike trip
• compressed/ - Original FIT files
• *.json - Cache files (avoid duplicate API calls)
• CITY_FINDER_README.md - Detailed documentation

• 90% reduction in API calls through smart sampling
• Geographic segmentation for complete route coverage
• Offline city database for major cities
• Comprehensive caching to avoid duplicate calls
• Multiple output formats (CSV, TXT)
• Error handling and rate limiting