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)

   • 需要明确指定地理编码的自由格式字符串。
   • 城市和地区：始终包含地区/国家/地区（例如“英国伦敦”，而不是“伦敦”）。
   • 街道地址：提供完整地址（例如“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:（字符串，例如“巴黎埃菲尔铁塔”）。注意：输入的地址越精细或越具体，结果就越好。

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

• place_id:：（字符串，例如“ChIJOwE_Id1w5EAR4Q27FkL6T_0”）注意：此 ID 可通过 search_places 工具获取。允许使用任何输入类型组合（例如，按地址指定出发地，按 lat_lng 指定目的地）。如果缺少出发地或目的地，您必须先询问用户以明确信息，然后再尝试调用该工具。

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

• 如果 attribution 字段中包含信息，则必须使用该信息将基于事实的输出归因于来源。