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。

Instructions for Tool Call:

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

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

• 仅当明确提供坐标时，或者当从用户的已知情境推断位置信息对于获得更好的结果是适当且必要的时，才使用 location_bias。

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

输入架构

{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "pageToken": 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 (google.type.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,
  "nextPageToken": string
}

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

  // Union field _location can be only one of the following:
  "location": {
    object (google.type.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
}

工具注释

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