MCP Reference: mapstools.googleapis.com

当用户的请求是查找地点、商家、地址、位置、兴趣点或任何其他与 Google 地图相关的搜索时，请调用此工具。

输入要求（重要）：

1. text_query（字符串 - 必需）： 主要搜索查询。此查询必须清楚地定义用户要查找的内容。

   • 示例： 'restaurants in New York'、'coffee shops near Golden Gate Park'、'SF MoMA'、'1600 Amphitheatre Pkwy, Mountain View, CA, USA'、'pets friendly parks in Manhattan, New York'、'date night restaurants in Chicago'、'accessible public libraries in Los Angeles'。
   • 如需了解特定地点的详细信息： 请添加请求的属性（例如 'Google Store Mountain View opening hours'、'SF MoMa phone number'、'Shoreline Park Mountain View address'）。

2. location_bias（对象 - 可选）： 使用此参数可优先显示特定地理区域附近的结果。

   • 格式： {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
   • 用法：
     • 偏向于 5 公里半径范围内的地点： {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
     • 强烈偏向于中心点： {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}}（省略 radius_meters）。

3. language_code（字符串 - 可选）： 用于显示搜索结果摘要的语言。

   • 格式： 由两个字母组成的语言代码 (ISO 639-1)，可以选择后跟下划线和由两个字母组成的国家/地区代码 (ISO 3166-1 alpha-2)，例如 en、ja、en_US、zh_CN、es_MX。如果未提供语言代码，结果将以英语显示。

4. region_code（字符串 - 可选）： 用户的 Unicode CLDR 区域代码。此参数用于显示地点详细信息，例如特定于区域的地点名称（如果有）。此参数可能会根据适用法律影响结果。

   • 格式： 由两个字母组成的国家/地区代码 (ISO 3166-1 alpha-2)，例如 US、CA。

工具调用说明：

• 位置信息（重要）：搜索必须包含足够的位置信息。如果位置不明确（例如仅为“披萨店”），您必须在 text_query 中指定位置（例如“纽约的披萨店”），或者使用 location_bias 参数。 如果需要消除歧义，请添加城市、州/省/自治区/直辖市和区域/国家/地区名称。

• 请始终提供尽可能具体且贴合上下文的 text_query。

• 只有在明确提供坐标的情况下，或者在从用户的已知上下文中推断位置信息是合适且必要的情况下，才使用 location_bias，以获得更好的结果。

• 如有必要，必须使用 attribution 字段中的信息将实际输出归因于来源。

检索全面的天气数据，包括当前天气状况、每小时天气预报和每日天气预报。

可用的具体数据： 温度（当前温度、体感温度、最高/最低温度、热指数）、风（风速、阵风、风向）、天象（日出/日落、月相）、降水（类型、概率、降水量/QPF）、大气状况（紫外线指数、湿度、云量、雷暴概率）和地理编码位置地址。

位置和位置规则（重要）：

使用 location 字段指定请求天气数据的位置。此字段是“oneof”结构，这意味着您必须为以下三个位置子字段中的**一个** 提供值，以确保准确查找天气数据。

1. 地理坐标 (lat_lng)

   • 当您获得确切的纬度/经度坐标时，请使用此字段。
   • 示例：{"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // 洛杉矶

2. 地点 ID (place_id)

   • 明确的字符串标识符（Google 地图地点 ID）。
   • 可以从 search_places 工具中提取 place_id。
   • 示例：{"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // 埃菲尔铁塔

3. 地址字符串 (address)

   • 自由格式的字符串，需要具体说明才能进行地理编码。
   • 城市和区域：请始终添加区域/国家/地区（例如“London, UK”，而不是“London”）。
   • 街道地址：请提供完整地址（例如“1600 Pennsylvania Ave NW, Washington, DC”）。
   • 邮政编码：必须附带国家/地区名称（例如“90210, USA”，而不是“90210”）。
   • 示例：{"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

使用模式：

• 当前天气状况： 仅提供 location。请勿指定 date 和 hour。

• 每小时天气预报： 提供 location、date 和 hour (0-23)。适用于特定时间（例如“下午 5 点”）或“未来几个小时”或“今天晚些时候”等术语。如果用户指定了分钟，请向下舍入到最接近的小时。不支持超过 120 小时后的每小时天气预报。支持过去 24 小时内的每小时历史天气数据。

• 每日天气预报： 提供 location 和 date。请勿指定 hour。适用于一般日期请求（例如“明天的天气”“周五的天气”“12/25 的天气”）。如果上下文中没有今天的日期，您应向用户说明。不支持包括今天在内的 10 天后的每日天气预报。不支持历史天气数据。

参数限制：

• 时区： 所有 date 和 hour 输入都必须相对于位置的本地时区，而不是用户的时区。
• 日期格式： 输入必须分为 {year, month, day} 整数。
• 单位： 默认为 METRIC。如果用户暗示美国标准或明确要求使用华氏度/英里，请将 units_system 设置为 IMPERIAL。

• 如有必要，必须使用 attribution 字段中的信息将实际输出归因于来源。

计算指定出发地和目的地之间的行程路线。支持的出行方式： DRIVE（默认）、WALK。

输入要求（重要）： 需要出发地 和目的地 。必须使用以下方法之一在各自的字段中嵌套提供每个字段：

• address： （字符串，例如“Eiffel Tower, Paris”）。注意：输入地址越精细或具体，结果就越好。

• lat_lng:： （对象，{"latitude": number, "longitude": number}）

• place_id:： （字符串，例如“ChIJOwE_Id1w5EAR4Q27FkL6T_0”）注意：此 ID 可从 search_places 工具中获取。允许使用任何输入类型组合（例如，按地址指定出发地，按纬度/经度指定目的地）。如果缺少出发地或目的地，您必须先向用户询问以进行澄清 ，然后再尝试调用该工具。

工具调用示例： {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

• 如有必要，必须使用 attribution 字段中的信息将实际输出归因于来源。

将批量列表中的特定位置查询（地标名称或确切地址）解析为规范的 Google 地图地点 ID。

输入要求（重要）：

1. queries（对象数组 - 必需）： 要解析的位置查询列表。您最多可以指定 20 个查询。

   • 每个查询对象都必须具有：
     • text （字符串 - 必需）： 表示要解析的特定地点名称或地址的文本查询。
       • 示例： 'Googleplex, Mountain View, CA'、'1600 Amphitheatre Pkwy, Mountain View, CA'、'Eiffel Tower, Paris'。

2. location_bias（对象 - 可选）： 使用此参数可优先显示特定地理区域附近的结果。

   • 格式： {"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}

3. region_code（字符串 - 可选）： 用户的 Unicode CLDR 区域代码（由两个字母组成的国家/地区代码，例如 US、CA），用于偏向结果。

工具调用说明：

• 具体性（重要）：查询必须表示特定的地点名称或地址。不支持一般搜索（例如 'restaurants'）或连锁店名称（例如 'Starbucks'）。
• 如果您计划调用的下游工具已直接接受原始地址或地点名称字符串，请勿调用此工具。

错误处理（重要）：

• 这是一个批量处理工具。请求可能会返回“混合结果”（例如，某些查询成功解析，而其他查询失败）。
• 输出 results 列表保证与输入 queries 索引一一对应。如果查询失败，则会在 results 列表中相应索引处生成一个空的 Result 消息（未设置 entity）。
• 您必须 检查响应中的 failed_requests 映射字段，以确定哪个特定查询索引失败。failed_requests 的键表示请求中失败查询的从 0 开始的索引。请勿因部分失败而假定整个批量调用失败。

将 Google 地图网址列表解析为规范的 Google 地图地点 ID。

何时调用此工具（重要）：

• 当用户提供一个或多个 Google 地图分享链接或网址（例如“https://maps.app.goo.gl/...”“https://www.google.com/maps/place/...”或“https://maps.google.com/...”），并且您需要提取底层规范地点 ID 时，请使用此工具。“https://www.google.com/maps/place/...”或“https://maps.google.com/...”）并需要提取底层规范地点 ID。
• 您可以在单个批量请求中指定最多 20 个要解析的网址。

输入要求（重要）：

• urls（字符串数组 - 必需）： 要解析的 Google 地图网址列表。每个网址都必须是有效的单地点 Google 地图网址。

错误处理（重要）：

• 这是一个批量处理工具。请求可能会返回“混合结果”（例如，某些网址成功解析，而其他网址失败）。
• 输出 entities 列表保证与输入 urls 索引一一对应。如果网址解析失败，则会在 entities 列表中相应索引处生成一个空的 Entity 消息（未设置任何字段）。
• 您必须 检查响应中的 failed_requests 映射字段，以确定哪个特定网址索引失败。failed_requests 的键表示请求中失败网址的从 0 开始的索引。请勿因部分失败而假定整个批量调用失败。