Sometimes you gotta fudge a track..
Convert routes from Google Routes API into GPX files for GPS devices, bike computers, and mapping software.
Try it online → — No installation required!
A browser app that keeps route planning state locally. Route requests go directly from your browser to Google Routes API, optional coordinate label lookups go directly to Google Geocoding API, and deployed elevation lookups use the configured same-origin Amplify rewrite to Open-Topo-Data.
- 🗺️ Interactive map with click-to-add waypoints
- 📍 Plain map clicks can confirm empty origin/destination fields without entering guided picker mode
↕️ Reorder intermediate waypoints before route calculation- 🚗🚴🚶🚌 Support for Drive, Bicycle, Walk, and Transit modes
- 📥 Download individual routes or all at once as GPX files
- 📂 Import GPX, KML, FIT, TCX, GeoJSON, and gzipped GPS files
- 🎨 Auto-cycling color palette for multiple routes
- 💾 Routes persist in browser localStorage
- 📱 Mobile-friendly responsive design
- ♿ Full keyboard navigation and screen reader support
- 🔒 No app server stores your routes or API key
- 🌫️ Fog of World data visualization — upload your FoW
.zipexport to see explored areas on the map
- Visit the web app
- Enter your Google Routes API key
- Enter origin and destination (addresses, places, or coordinates)
- Press Enter or click "Get Route"
- Download your GPX file
For safer browser use, create a dedicated Google API key for this app and restrict it to your website referrer. Restrict API access to the Routes API; also allow the Geocoding API if you want clicked/GPS coordinates to be labeled with human-readable place names. The web app keeps the key for the current tab by default; you can opt in to remembering it on this browser. If persistent browser storage is blocked, the app falls back to tab-only storage instead of losing the key silently. Imported GPS files are processed locally, capped by file and decompressed-size limits, and validated for coordinate bounds before rendering. Saved browser routes are also validated on restore so one corrupt route cannot block the rest of the session. If browser storage fills up, the app warns you instead of silently pretending the latest routes were saved.
GPX exports include the route track plus exact start and end waypoints. Intermediate waypoints entered as coordinates are exported as GPX waypoints; address or place-name waypoints are kept in the route description because the app should not invent coordinates it does not actually know.
npm ci
npm test
npm run buildRun npm run build after source changes before static preview or deployment; the build follows the browser ES module graph from app.js, writes hashed JavaScript and CSS assets into dist/, and rewrites the generated HTML references. The CSP is declared in both index.html and the Amplify custom headers in infra/main.tf; keep those policies in sync when adding third-party assets.
Production elevation lookup uses the Amplify rewrite from /api/elevation/<path> to Open-Topo-Data. A plain local file or static dev server does not provide that rewrite, so route calculation, imports, and GPX export work locally while elevation enrichment may show as unavailable unless you run a compatible local proxy.
A simple command-line tool for scripting or batch processing.
- Retrieves routes using Google's modern Routes API
- Supports Drive, Transit, Bicycle, and Walk modes
- Exports routes to GPX format with timestamps and placeholder elevation values
Requirements:
- Python 3.13+
- Poetry
- Google Routes API key
git clone https://github.com/robert-bryson/route2gpx.git
cd route2gpx
poetry installCreate a .env file with your API key:
GOOGLE_ROUTES_API_KEY=your_api_key_herepoetry run python route2gpx.py "Start Location" "End Location" MODEMODE can be DRIVE, TRANSIT, BICYCLE, or WALK.
Example:
poetry run python route2gpx.py "Seattle, WA" "Portland, OR" DRIVEOutputs: drive-route_Seattle_WA-Portland_OR.gpx
poetry run pytest
poetry run black --check .
poetry run isort --check .MIT License — see LICENSE for details.