Google 地图 🗺️

由 Routes API 驱动的 Google 地图集成。

要求

• GOOGLE_API_KEY环境变量
• 在 Google Cloud Console 中启用：Routes API、Places API、Geocoding API
• Python 包：requests(pip install requests)

配置

在OpenClaw配置中设置：

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

脚本位置

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

操作

distance - 计算行程时间

python3 skills/google-maps/lib/map_helper.py distance "origin" "destination" [options]

选项：

示例：

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

路线指引 - 逐向导航

{
  "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]

选项

响应包含：

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

摘要、标签、时长、静态时长、警告、步骤[]、优化后的途经点顺序矩阵 - 距离矩阵

计算多个起点与目的地之间的距离：

示例：

python3 skills/google-maps/lib/map_helper.py matrix "orig1|orig2" "dest1|dest2"

响应：

python3 skills/google-maps/lib/map_helper.py matrix "New York|Boston" "Philadelphia|Washington DC"

地理编码 - 地址转坐标

{
  "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

search - Find places

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>"

交通模式

区域注意事项

部分功能可能并非在所有国家/地区都可用：

检查Google 地图覆盖范围以获取详细信息。

多语言支持

适用于任何语言的地址：

# 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 "دبي" "أبو ظبي"

语言配置：

1. 通过环境变量设置默认值：GOOGLE_MAPS_LANG=he（持久有效）
2. 按请求覆盖：--lang=ja

# Set Hebrew as default in OpenClaw config
GOOGLE_MAPS_LANG=he

# Override 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