# Send Google Maps to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "google-maps",
    "name": "Google Maps",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Shaharsha/google-maps",
    "canonicalUrl": "https://clawhub.ai/Shaharsha/google-maps",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/google-maps",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-maps",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "lib/map_helper.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "google-maps",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T21:52:00.106Z",
      "expiresAt": "2026-05-10T21:52:00.106Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-maps",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-maps",
        "contentDisposition": "attachment; filename=\"google-maps-3.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "google-maps"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/google-maps"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/google-maps",
    "downloadUrl": "https://openagent3.xyz/downloads/google-maps",
    "agentUrl": "https://openagent3.xyz/skills/google-maps/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-maps/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-maps/agent.md"
  }
}
```
## Documentation

### Google Maps 🗺️

Google Maps integration powered by the Routes API.

### Requirements

GOOGLE_API_KEY environment variable
Enable in Google Cloud Console: Routes API, Places API, Geocoding API

### Configuration

Env VariableDefaultDescriptionGOOGLE_API_KEY-Required. Your Google Maps API keyGOOGLE_MAPS_API_KEY-Alternative to GOOGLE_API_KEY (fallback)GOOGLE_MAPS_LANGenResponse language (en, he, ja, etc.)

Set in OpenClaw config:

{
  "env": {
    "GOOGLE_API_KEY": "AIza...",
    "GOOGLE_MAPS_LANG": "en"
  }
}

### Script Location

python3 skills/google-maps/lib/map_helper.py <action> [options]

### distance - Calculate travel time

python3 lib/map_helper.py distance "origin" "destination" [options]

Options:

OptionValuesDescription--modedriving, walking, bicycling, transitTravel mode (default: driving)--departnow, +30m, +1h, 14:00, 2026-02-07 08:00Departure time--arrive14:00Arrival time (transit only)--trafficbest_guess, pessimistic, optimisticTraffic model--avoidtolls, highways, ferriesComma-separated

Examples:

python3 lib/map_helper.py distance "New York" "Boston"
python3 lib/map_helper.py distance "Los Angeles" "San Francisco" --depart="+1h"
python3 lib/map_helper.py distance "Chicago" "Detroit" --depart="08:00" --traffic=pessimistic
python3 lib/map_helper.py distance "London" "Manchester" --mode=transit --arrive="09:00"
python3 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"
}

### directions - Turn-by-turn route

python3 lib/map_helper.py directions "origin" "destination" [options]

Additional options (beyond distance):

OptionDescription--alternativesReturn multiple routes--waypointsIntermediate stops (pipe-separated)--optimizeOptimize waypoint order (TSP)

Examples:

python3 lib/map_helper.py directions "New York" "Washington DC"
python3 lib/map_helper.py directions "San Francisco" "Los Angeles" --alternatives
python3 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

### matrix - Distance matrix

Calculate distances between multiple origins and destinations:

python3 lib/map_helper.py matrix "orig1|orig2" "dest1|dest2"

Example:

python3 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"}
  ]
}

### geocode - Address to coordinates

python3 lib/map_helper.py geocode "1600 Amphitheatre Parkway, Mountain View, CA"
python3 lib/map_helper.py geocode "10 Downing Street, London"

### reverse - Coordinates to address

python3 lib/map_helper.py reverse 40.7128 -74.0060  # New York City
python3 lib/map_helper.py reverse 51.5074 -0.1278  # London

### search - Find places

python3 lib/map_helper.py search "coffee near Times Square"
python3 lib/map_helper.py search "pharmacy in San Francisco" --open

### details - Place information

python3 lib/map_helper.py details "<place_id>"

### Traffic Models

ModelUse Casebest_guessDefault balanced estimatepessimisticImportant meetings (worst-case)optimisticBest-case scenario

### Regional Notes

Some features may not be available in all countries:

FeatureAvailability--fuel-efficientUS, EU, select countries--shorterLimited availability--mode=two_wheelerAsia, select countries

Check Google Maps coverage for details.

### Multilingual Support

Works with addresses in any language:

# Hebrew
python3 lib/map_helper.py distance "תל אביב" "ירושלים"
python3 lib/map_helper.py geocode "דיזנגוף 50, תל אביב"

# Japanese
python3 lib/map_helper.py distance "東京" "大阪"

# Arabic
python3 lib/map_helper.py distance "دبي" "أبو ظبي"

Language configuration:

Set default via env: GOOGLE_MAPS_LANG=he (persists)
Override per-request: --lang=ja

# Set Hebrew as default in OpenClaw config
GOOGLE_MAPS_LANG=he

# Override for specific request
python3 lib/map_helper.py distance "Tokyo" "Osaka" --lang=ja

### Help

python3 lib/map_helper.py help
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Shaharsha
- Version: 3.1.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T21:52:00.106Z
- Expires at: 2026-05-10T21:52:00.106Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/google-maps)
- [Send to Agent page](https://openagent3.xyz/skills/google-maps/agent)
- [JSON manifest](https://openagent3.xyz/skills/google-maps/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/google-maps/agent.md)
- [Download page](https://openagent3.xyz/downloads/google-maps)