名称: google-maps 描述: 地点搜索、方向、地理编码和交互式地图
谷歌地图
可用工具
-
search_places(query, location?, radius?, type?, open_now?, language?): 使用文本查询搜索地点。
query(字符串, 必需): 搜索文本(例如,“首尔的餐厅”)location(字符串, 可选): 中心位置为 “纬度,经度”(例如,“37.5665,126.9780”)radius(整数, 可选): 搜索半径,单位米(最大50,000)type(字符串, 可选): 地点类型过滤(例如,“餐厅”、“旅游景点”、“酒店”)open_now(布尔值, 可选, 默认: false): 仅返回当前开放的地点language(字符串, 可选, 默认: “en”): 语言代码
-
search_nearby_places(location, radius, keyword?, type?, rank_by?, open_now?, language?): 在特定坐标附近搜索。
location(字符串, 必需): 中心为 “纬度,经度”(例如,“37.5665,126.9780”)radius(整数, 必需): 搜索半径,单位米(最大50,000)keyword(字符串, 可选): 搜索关键词type(字符串, 可选): 地点类型过滤rank_by(字符串, 可选, 默认: “prominence”): “prominence” 或 “distance”open_now(布尔值, 可选, 默认: false): 仅开放地点language(字符串, 可选, 默认: “en”): 语言代码
-
get_place_details(place_id, language?, reviews_sort?): 获取详细地点信息,包括评论和营业时间。
place_id(字符串, 必需): 从搜索结果中获取的地点IDlanguage(字符串, 可选, 默认: “en”): 语言代码reviews_sort(字符串, 可选, 默认: “most_relevant”): “most_relevant” 或 “newest”
-
get_directions(origin, destination, mode?, alternatives?, avoid?, language?): 获取两个位置之间的方向。
origin(字符串, 必需): 起点(地址或 “纬度,经度”)destination(字符串, 必需): 目的地(地址或 “纬度,经度”)mode(字符串, 可选, 默认: “driving”): “driving”、“walking”、“bicycling”、“transit”alternatives(布尔值, 可选, 默认: false): 返回替代路线avoid(字符串, 可选): “tolls”、“highways” 或 “ferries”language(字符串, 可选, 默认: “en”): 语言代码
-
geocode_address(address, language?, region?): 将文本地址转换为地理坐标。
address(字符串, 必需): 要地理编码的地址language(字符串, 可选, 默认: “en”): 语言代码region(字符串, 可选): 国家代码用于区域偏置
-
reverse_geocode(latlng, language?): 将坐标转换为可读地址。
latlng(字符串, 必需): 坐标为 “纬度,经度”(例如,“37.5665,126.9780”)language(字符串, 可选, 默认: “en”): 语言代码
-
show_on_map(map_type, markers?, directions?, center?, zoom?): 在交互式地图上显示位置或路线。
map_type(字符串, 必需): “markers”(位置标记)、“directions”(路线)或 “area”markers(数组, 对 “markers” 必需): 标记对象列表,包含 lat 和 lngdirections(对象, 对 “directions” 必需): 路线数据,包含起点和目的地center(对象, 可选): 地图中心 {lat, lng}zoom(整数, 可选): 缩放级别 1-20
使用指南
- 在收集位置数据后始终调用 show_on_map — 可视化地图是主要价值。
- 保留
place_id从搜索结果中,用于get_place_details。 - 从上下文推断交通模式(长距离驾驶,短距离步行)。
- 每个地图显示1-5个最相关的地点。
响应模式
遵循 文本 -> 地图 -> 文本 序列。不要在与其他工具调用并行时调用 show_on_map。
- 文本: 介绍将要显示的内容
- 地图: 调用
show_on_map显示结果 - 文本: 解释结果
多个类别: 使用单独的地图按顺序显示 — 永不并行。