用途：回答真实世界的位置问题，使用包内的独立 exec CLI，无需为此工作流启动或配置 MCP 服务器。
主要能力：地址或地标转坐标（maps_geocode）、坐标转地址（maps_reverse_geocode）、附近发现（maps_search_nearby 配合 maps_place_details）、自然语言地点搜索（maps_search_places 配合 maps_place_details）、地点比较（maps_compare_places 或搜索→详情→距离矩阵）、路线或出行方式比较（maps_directions、maps_distance_matrix）、多站点路线（maps_plan_route）、沿途地点（maps_search_along_route）、街区信息（maps_explore_area 配合定向附近搜索）、海拔/时区/天气/空气质量（对应环境工具，必要时先地理编码）、静态地图（maps_static_map）。
调用方式：npx -y @cablate/mcp-google-map exec <tool> '<json_params>'
CLI 同时接受 MCP 风格名称（如 maps_geocode）和短名称（如 geocode）。每次调用无状态，JSON 输出到 stdout。首次调用或执行失败后，应阅读 ../_shared/setup-and-diagnostics.md 并运行非计费的本地预检。展示 Places 评论、照片或 AI 摘要前，阅读 ../_shared/content-attribution.md。需要精确参数、响应字段或多工具组合时，阅读 references/tools-api.md。优先使用坐标而非模糊地址，优先 place_id 而非重复名称搜索。仅串联达成结果所需的调用，复用返回的标识符与坐标。非零退出状态或 { "success": false } 视为失败，不是地理数据。总结有用结果而非返回原始 JSON，按要求保留来源与归属元数据。
限制：用户必须提供 GOOGLE_MAPS_API_KEY，且绝不可打印或放入命令中，除非用户明确接受 shell 历史和进程列表暴露风险。多日行程、旅行日程或旅行日优化请改用 google-maps-travel-planning。Google Business Profile 可见性、网格排名、关键词覆盖或竞争对手审计请改用 google-maps-local-seo。maps_weather 在日本、中国、韩国、古巴、伊朗、朝鲜和叙利亚不可用，这些地区应使用当前网络来源。不支持公交站点优化，公交路线请使用 optimize: false。仅凭地理邻近和海拔不能确定安全性、可达性、洪水风险或适宜性，相关限制须说明。