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ợ: LÁI XE (mặc định), ĐI BỘ.

Yêu cầu về thông tin đầu vào (QUAN TRỌNG): Yêu cầu cả điểm khởi hành và điểm đế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 ý: Thông tin đầu vào địa chỉ 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ã địa điểm 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ăn cứ 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ẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ compute_routes MCP.

Yêu cầu Curl 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

ComputeRoutesRequest.

ComputeRoutesRequest

Biểu diễn dưới dạng JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}
Trường
origin

object (Waypoint)

Bắt buộc. Điểm tham chiếu ban đầu.
destination

object (Waypoint)

Bắt buộc. Điểm tham chiếu trên đường đi.
travelMode

enum (RouteTravelMode)

Không bắt buộc. Chỉ định phương tiện giao thông.

Waypoint

Biểu diễn dưới dạng JSON 
{

  // 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.
}
Trường
Trường nhóm location_type. Các cách thể hiện vị trí. location_type chỉ có thể là một trong những trạng thái sau:
latLng

object (LatLng)

Một điểm được chỉ định bằng toạ độ địa lý.
placeId

string

Mã địa điểm được liên kết với điểm tham chiếu.
address

string

Địa chỉ mà con người đọc được hoặc plus code. Hãy truy cập https://plus.codes để biết thông tin chi tiết.

LatLng

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].
longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

Giản đồ đầu ra

ComputeRoutesResponse.

ComputeRoutesResponse

Biểu diễn dưới dạng JSON 
{
  "routes": [
    {
      object (Route)
    }
  ]
}
Trường
routes[]

object (Route)

Chứa các tuyến đường giữa điểm khởi hành và điểm đến được yêu cầu. Hiện tại, chỉ có một tuyến đường được trả về.

Tuyến đường

Biểu diễn dưới dạng JSON 
{
  "distanceMeters": integer,
  "duration": string,
  "attribution": {
    object (Attribution)
  }
}
Trường
distanceMeters

integer

Quãng đường di chuyển của tuyến đường, tính bằng mét.
duration

string (Duration format)

Khoảng thời gian cần thiết để đi theo tuyến đường.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
attribution

object (Attribution)

Thông tin phân bổ bắt buộc phải xuất hiện cùng với tuyến đường.

Thời lượng

Biểu diễn dưới dạng JSON 
{
  "seconds": string,
  "nanos": integer
}
Trường
seconds

string (int64 format)

Số giây đã ký của khoảng thời gian. Giá trị phải nằm trong khoảng từ -315.576.000.000 đến +315.576.000.000. Lưu ý: các giới hạn này được tính từ: 60 giây/phút * 60 phút/giờ * 24 giờ/ngày * 365,25 ngày/năm * 10.000 năm
nanos

integer

Phân số có dấu của một giây ở độ phân giải nano giây của khoảng thời gian. Khoảng thời gian dưới một giây được biểu thị bằng trường 0 seconds và trường nanos dương hoặc âm. Đối với thời lượng từ một giây trở lên, giá trị khác 0 cho trường nanos phải có cùng dấu với trường seconds. Phải nằm trong khoảng từ -999.999.999 đến +999.999.999.

Phân bổ

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "url": string
}
Trường
title

string

Tiêu đề sẽ xuất hiện trong thông tin phân bổ.
url

string

URL để liên kết cho việc phân bổ.

Chú giải công cụ

Gợi ý mang tính huỷ diệt: ❌ | Gợi ý mang tính luỹ đẳng: ❌ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌