MCP Tools Reference: mapstools.googleapis.com

工具：search_along_route

当用户想要查找旅行路线沿途的地点、商家或地图注点（例如“去太浩湖路上的加油站”“旧金山和圣何塞之间的咖啡店”）时，请调用此工具。调用此工具的费用高于 search_places，因此在搜索单个地点附近（而非沿路线）时，请改用 search_places。

输入要求（至关重要）：

1. text_query（字符串 - 必填）：沿路线搜索的内容的自然语言说明。

   • 示例：'ev chargers'、'coffee'、'vegetarian restaurants'、'rest stops'。

2. 路线规范（必填 - 仅提供以下其中一项）：

   • retrieval_token（字符串）：先前针对 DRIVE 路线调用 compute_routes 返回的 retrieval_token。只要路线已计算完毕，就首选此方法。令牌的有效期为 10 分钟。
   • route_endpoints（对象）：路线的 origin 和 destination。每个都必须使用 address、lat_lng 或 place_id 之一提供。
     • 示例： {"route_endpoints": {"origin": {"address": "San Francisco, CA"}, "destination": {"address": "Lake Tahoe, CA"}}}
   • encoded_polyline（字符串）：表示 DRIVE 路线的编码多段线。

3. travel_mode（枚举 - 可选）：DRIVE（默认）、WALK 或 BICYCLE。WALK 和 BICYCLE 仅支持 route_endpoints。不支持 TRANSIT。

4. routing_preference（枚举 - 可选）：

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE（默认）：在不考虑实时路况的情况下计算路线和绕行路线。延迟时间最短。
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL：使用实时路况信息（如有）。WALK 或 BICYCLE 不支持此方法。仅当用户询问路况、拥堵情况或根据路况调整的绕行时间时，才设置此参数。它会产生更高的延迟。

5. include_extended_details（布尔值 - 可选）：仅当请求需要定性评价数据分析、特定菜单项或产品/服务、氛围、访客提示或繁忙程度、电动汽车充电桩可用性、油价或其他丰富的定性详细信息时，才设置为 true。此字段的默认值为 false。启用此功能可能会增加延迟时间。

6. language_code（字符串 - 可选）：结果摘要和地点详情的语言，例如 en、ja、en-US。默认值为 en-US。

7. region_code（字符串 - 可选）：用户的 Unicode CLDR 区域代码，例如 US、CA。

工具调用说明：

• 每个结果都包含一个 detour_summary（如果可用），用于说明在该地点停留所产生的额外距离 (localized_detour_distance) 和额外时间 (detour_duration)（除非路线指定为 encoded_polyline）。您可以使用它来比较各种选项。
• 回答 summary 可能包含从零开始的引用（例如“[0]”），这些引用指向 results 中的条目。
• 必须使用每个 results[].place 的 attribution 字段（如果可用）将接地输出归因于来源。

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

输入架构

{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "routingPreference": enum (RoutingPreference),
  "includeExtendedDetails": boolean,
  "travelMode": enum (RouteTravelMode),

  // Union field route_spec can be only one of the following:
  "encodedPolyline": string,
  "retrievalToken": string,
  "routeEndpoints": {
    object (RouteEndpoints)
  }
  // End of list of possible types for union field route_spec.
}

{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  }
}

{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}

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

输出架构

{
  "results": [
    {
      object (Result)
    }
  ],
  "summary": string,
  "contentToken": string
}

{
  "place": {
    object (PlaceView)
  },
  "detourSummary": {
    object (DetourSummary)
  }
}

{
  "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
}

{
  "detourDuration": string,
  "localizedDetourDistance": string
}

{
  "seconds": string,
  "nanos": integer
}

工具注释

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

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

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

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