MCP Tools Reference: mapstools.googleapis.com

工具：search_places

当用户的请求是查找地点、商家、地址、位置、地图注点或任何其他与 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 字段中包含信息，则必须使用该信息将基于事实的输出归因于来源。

以下代码示例展示了如何使用 curl 调用 search_places MCP 工具。

输入架构

{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,

  // Union field _location_bias can be only one of the following:
  "locationBias": {
    object (LocationBias)
  }
  // End of list of possible types for union field _location_bias.
}

{
  "circle": {
    object (Circle)
  }
}

{
  "center": {
    object (LatLng)
  },

  // Union field _radius_meters can be only one of the following:
  "radiusMeters": number
  // End of list of possible types for union field _radius_meters.
}

{
  "latitude": number,
  "longitude": number
}

输出架构

{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string
}

{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _location can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field _location.
}

{
  "latitude": number,
  "longitude": number
}

{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}

{
  "title": string,
  "url": string
}

工具注释

工具注释会发送给 MCP 客户端，用于描述指定工具的基本风险。大多数客户端会将这些提示视为不受信任的，但它们可用于确定何时向用户发送确认提示。

除了标题字符串之外，还定义了以下布尔值提示：

• readOnlyHint：如果为 true，则工具不会修改其环境。默认值：false。
• destructiveHint：如果为 true，则工具可以执行破坏性操作。如果为 false，则该工具只能执行添加操作。默认值：true。
• idempotentHint：如果为 true，则使用相同实参重复调用该工具不会对其环境产生任何额外影响。默认值：false。
• openWorldHint：如果为 true，则工具可以与外部实体的“开放世界”进行交互。如果为 false，则该工具只能与内部实体互动。例如，网络搜索工具是开放世界，而内存工具不是开放世界。

破坏性提示：❌ | 等幂性提示：❌ | 只读提示：✅ | 开放世界提示：❌