Google Maps integration for OpenClaw with Routes API. Use for: (1) Distance/travel time calculations with traffic prediction, (2) Turn-by-turn directions, (3...
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Google Maps integration powered by the Routes API.
GOOGLE_API_KEYrequestspip install requests| Env Variable | Default | Description |
|---|---|---|
| - | Required. Your Google Maps API key |
| - | Alternative to |
| | Response language (en, he, ja, etc.) |
Set in OpenClaw config:
{ "env": { "GOOGLE_API_KEY": "AIza...", "GOOGLE_MAPS_LANG": "en" } }
python3 skills/google-maps/lib/map_helper.py <action> [options]
python3 skills/google-maps/lib/map_helper.py distance "origin" "destination" [options]
Options:
| Option | Values | Description |
|---|---|---|
| driving, walking, bicycling, transit | Travel mode (default: driving) |
| now, +30m, +1h, 14:00, 2026-02-07 08:00 | Departure time |
| 14:00 | Arrival time (transit only) |
| best_guess, pessimistic, optimistic | Traffic model |
| tolls, highways, ferries | Comma-separated |
Examples:
python3 skills/google-maps/lib/map_helper.py distance "New York" "Boston" python3 skills/google-maps/lib/map_helper.py distance "Los Angeles" "San Francisco" --depart="+1h" python3 skills/google-maps/lib/map_helper.py distance "Chicago" "Detroit" --depart="08:00" --traffic=pessimistic python3 skills/google-maps/lib/map_helper.py distance "London" "Manchester" --mode=transit --arrive="09:00" python3 skills/google-maps/lib/map_helper.py distance "Paris" "Lyon" --avoid=tolls,highways
Response:
{ "distance": "215.2 mi", "distance_meters": 346300, "duration": "3 hrs 45 mins", "duration_seconds": 13500, "static_duration": "3 hrs 30 mins", "duration_in_traffic": "3 hrs 45 mins" }
python3 skills/google-maps/lib/map_helper.py directions "origin" "destination" [options]
Additional options (beyond distance):
| Option | Description |
|---|---|
| Return multiple routes |
| Intermediate stops (pipe-separated) |
| Optimize waypoint order (TSP) |
Examples:
python3 skills/google-maps/lib/map_helper.py directions "New York" "Washington DC" python3 skills/google-maps/lib/map_helper.py directions "San Francisco" "Los Angeles" --alternatives python3 skills/google-maps/lib/map_helper.py directions "Miami" "Orlando" --waypoints="Fort Lauderdale|West Palm Beach" --optimize
Response includes: summary, labels, duration, static_duration, warnings, steps[], optimized_waypoint_order
Calculate distances between multiple origins and destinations:
python3 skills/google-maps/lib/map_helper.py matrix "orig1|orig2" "dest1|dest2"
Example:
python3 skills/google-maps/lib/map_helper.py matrix "New York|Boston" "Philadelphia|Washington DC"
Response:
{ "origins": ["New York", "Boston"], "destinations": ["Philadelphia", "Washington DC"], "results": [ {"origin_index": 0, "destination_index": 0, "distance": "97 mi", "duration": "1 hr 45 mins"}, {"origin_index": 0, "destination_index": 1, "distance": "225 mi", "duration": "4 hrs 10 mins"} ] }
python3 skills/google-maps/lib/map_helper.py geocode "1600 Amphitheatre Parkway, Mountain View, CA" python3 skills/google-maps/lib/map_helper.py geocode "10 Downing Street, London"
python3 skills/google-maps/lib/map_helper.py reverse 40.7128 -74.0060 # New York City python3 skills/google-maps/lib/map_helper.py reverse 51.5074 -0.1278 # London
python3 skills/google-maps/lib/map_helper.py search "coffee near Times Square" python3 skills/google-maps/lib/map_helper.py search "pharmacy in San Francisco" --open
python3 skills/google-maps/lib/map_helper.py details "<place_id>"
| Model | Use Case |
|---|---|
| Default balanced estimate |
| Important meetings (worst-case) |
| Best-case scenario |
Some features may not be available in all countries:
| Feature | Availability |
|---|---|
| US, EU, select countries |
| Limited availability |
| Asia, select countries |
Check Google Maps coverage for details.
Works with addresses in any language:
# Hebrew python3 skills/google-maps/lib/map_helper.py distance "תל אביב" "ירושלים" python3 skills/google-maps/lib/map_helper.py geocode "דיזנגוף 50, תל אביב"Japanese
python3 skills/google-maps/lib/map_helper.py distance "東京" "大阪"
Arabic
python3 skills/google-maps/lib/map_helper.py distance "دبي" "أبو ظبي"
Language configuration:
GOOGLE_MAPS_LANG=he--lang=ja# Set Hebrew as default in OpenClaw config GOOGLE_MAPS_LANG=heOverride for specific request
python3 skills/google-maps/lib/map_helper.py distance "Tokyo" "Osaka" --lang=ja
python3 skills/google-maps/lib/map_helper.py help
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.