MCP Tools Reference: mapstools.googleapis.com

Công cụ: compute_routes

Tính toán tuyến đường di chuyển giữa một điểm khởi hành và điểm đến cụ thể. Các chế độ di chuyển được hỗ trợ: DRIVE (mặc định), WALK.

Yêu cầu về thông tin đầu vào (TỐI QUAN TRỌNG): Yêu cầu cả nơi xuất phát và đích đến. Bạn phải cung cấp từng thông tin bằng một trong các phương thức sau, được lồng trong trường tương ứng:

• address: (chuỗi, ví dụ: "Tháp Eiffel, Paris"). Lưu ý: Địa chỉ đầu vào càng chi tiết hoặc cụ thể thì kết quả sẽ càng tốt.

• lat_lng: (đối tượng, {"latitude": number, "longitude": number})

• place_id: (chuỗi, ví dụ: "ChIJOwE_Id1w5EAR4Q27FkL6T_0") Lưu ý: Bạn có thể lấy mã nhận dạng này từ công cụ search_places. Bạn có thể kết hợp các loại dữ liệu đầu vào (ví dụ: điểm xuất phát theo địa chỉ, điểm đến theo lat_lng). Nếu thiếu điểm xuất phát hoặc điểm đến, BẠN PHẢI yêu cầu người dùng làm rõ trước khi tìm cách gọi công cụ.

Ví dụ về lệnh gọi công cụ: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

• Đầu ra có cơ sở phải được quy cho nguồn bằng cách sử dụng thông tin từ trường attribution (nếu có).

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ compute_routes MCP.

Giản đồ đầu vào

{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}

{

  // 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
}

Giản đồ đầu ra

{
  "routes": [
    {
      object (Route)
    }
  ]
}

{
  "distanceMeters": integer,
  "duration": string,
  "attribution": {
    object (Attribution)
  }
}

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

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

Chú thích bằng công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng chúng có thể được dùng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

• readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
• destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
• idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không ảnh hưởng gì thêm đến môi trường của công cụ. Mặc định: false.
• openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

Gợi ý phá huỷ: ❌ | Gợi ý bất biến: ❌ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌