用途：这是一个面向 Google Maps Platform 的 CLI 客户端技能，通过 Python 脚本直接调用 Google 的 REST API，返回快速、结构化的 JSON 结果，覆盖地图、路线、地点、环境与地理空间服务共 20 多个 API。
主要能力：地理编码与逆地理编码；路线与距离矩阵（支持 transit、bicycling 等模式、途经点、避开收费）；地点文本搜索、附近搜索、详情、自动补全与照片；空气质量当前/历史/预报；花粉预报；太阳能潜力与数据图层；天气当前/逐小时/每日/历史；海拔；时区；地址验证（含 USPS CASS）；道路吸附与最近道路；街景；静态地图；地理定位；航拍视图（仅美国）；路线优化（VRP）；地点聚合洞察；以及免费的嵌入 URL 生成。
使用方式：先获取 Google Maps API Key，在 Google Cloud Console 启用所需 API，并将密钥写入项目目录 .env、~/.env 或环境变量 GOOGLE_MAPS_API_KEY。脚本位于 ~/.claude/skills/google-maps-api/scripts/gmaps.py，仅依赖 Python 标准库。调用示例：python3 ~/.claude/skills/google-maps-api/scripts/gmaps.py geocode "Tokyo Tower" --language ja --region jp；python3 ~/.claude/skills/google-maps-api/scripts/gmaps.py directions "New York, NY" "Boston, MA"；python3 ~/.claude/skills/google-maps-api/scripts/gmaps.py weather 40.7128 -74.0060 --mode daily --days 7。
适用场景：位置查询、地址解析、路线与距离计算、周边地点检索、环境与天气信息、地址校验、太阳能评估、配送路线优化等。
限制与规则：API 调用失败（403、REQUEST_DENIED、未启用等）时应立即告知用户，不得静默用网页搜索等替代；生成 HTML 前必须先询问用户，选择输出格式前也应先确认。HTML 默认使用零密钥的 embed iframe（output=embed），不要对 Google Maps 嵌入 iframe 使用 loading="lazy"；街景在 HTML 中必须使用 https://www.google.com/maps/@?api=1&map_action=pano&viewpoint={lat},{lng}&heading={heading}&pitch={pitch}&fov=90 直链，禁止在页面中使用街景 JS API 或 Embed API 以免暴露密钥；除非用户明确要求高级交互功能，否则不要引入 Maps JavaScript API。街景 CLI 下载按每 1000 次 7 美元计费。航拍视图仅限美国。具体配额、价格与各 API 限制以 Google 官方为准，资料未逐一提供。