Sử dụng thêm các tính năng của công cụ tác nhân Maps Experience với SKU Pro! Liên hệ với nhóm bán hàng để được cấp quyền truy cập.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Tính toán tuyến đường

Công cụ compute_routes trả về một tuyến đường giữa điểm xuất phát và điểm đến cho một phương tiện di chuyển nhất định. Phản hồi bao gồm khoảng cách và thời gian của tuyến đường. Theo mặc định, các tuyến đường được tính toán mà không có thông tin giao thông theo thời gian thực. Pro bổ sung tính năng định tuyến có tính đến tình hình giao thông theo thời gian thực và các tuyến đường có nhiều điểm dừng trung gian hơn.

Trang này mô tả các lựa chọn yêu cầu, bao gồm cả các lựa chọn Pro; nội dung phản hồi; và cách tính phí cho các yêu cầu. Để xem giản đồ đầy đủ của công cụ, hãy xem tài liệu tham khảo về compute_routes.

Tuỳ chọn yêu cầu

Phương thức	Mô tả
`origin`, `destination`	Bắt buộc. Mỗi điểm là một điểm tham chiếu: `address` (địa chỉ mà con người có thể đọc được hoặc Plus Code), `place_id` hoặc `lat_lng`. Bạn có thể kết hợp các định dạng, ví dụ: địa chỉ cho điểm xuất phát và Mã địa điểm cho điểm đến.
`travel_mode`	Phương thức di chuyển: `DRIVE` (mặc định), `WALK`, `BICYCLE` hoặc `TRANSIT`. Tuyến đường dành cho `WALK` đang trong giai đoạn thử nghiệm và đôi khi có thể thiếu vỉa hè hoặc lối đi rõ ràng cho người đi bộ. Bạn phải hiển thị cảnh báo này cho người dùng đối với tất cả tuyến đường đi bộ mà bạn hiển thị trong ứng dụng của mình.
`routing_preference`	Cách sử dụng dữ liệu lưu lượng truy cập để tính toán tuyến đường: `ROUTING_PREFERENCE_TRAFFIC_UNAWARE` (mặc định) hoặc `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL`, đây là Lựa chọn chuyên nghiệp. `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` không được hỗ trợ cho `WALK` hoặc `BICYCLE`. Xem phần Định tuyến dựa trên tình hình giao thông.
`intermediate_waypoints`	Các điểm dừng theo thứ tự giữa điểm xuất phát và điểm đến. Tuyến đường đi qua các điểm này theo thứ tự đã cho. Một yêu cầu có thể bao gồm tối đa 10 điểm tham chiếu trung gian hoặc từ 11 đến 25 điểm tham chiếu trung gian dưới dạng Lựa chọn Pro. Yêu cầu có hơn 25 mục sẽ trả về lỗi `INVALID_ARGUMENT`. Tuyến đường đi phương tiện công cộng không hỗ trợ các điểm tham chiếu trung gian.
`departure_time` hoặc `arrival_time`	Thời điểm khởi hành từ điểm xuất phát hoặc đến điểm đến, dưới dạng dấu thời gian RFC 3339. Đặt tối đa một. Giá trị mặc định là khởi hành vào thời điểm hiện tại. Đối với `TRANSIT`, thời gian có thể là tối đa 7 ngày trước hoặc 100 ngày sau. Đối với các phương thức di chuyển khác, thời gian không được là thời gian trong quá khứ và có thể là tối đa 365 ngày trong tương lai.
`compute_alternative_routes`	Khi `true`, phản hồi sẽ bao gồm các tuyến đường thay thế ngoài tuyến đường được đề xuất (nếu có tuyến đường thay thế). Giá trị mặc định là `false`.
`include_polyline`	Khi `true`, mỗi tuyến đường trong phản hồi sẽ bao gồm `encodedPolyline`. Mặc định là `false`.
`location_bias`	Vĩ độ và kinh độ giúp định hướng cách phân giải điểm tham chiếu dạng văn bản, chẳng hạn như để phân biệt một địa chỉ.

Lựa chọn chuyên nghiệp

Hai lựa chọn chọn SKU Pro. Yêu cầu sử dụng một hoặc cả hai tham số này sẽ được tính phí theo SKU Pro:

Lựa chọn chuyên nghiệp	Trường hợp sử dụng
`routing_preference` được đặt thành `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL`	Người dùng hỏi về tình hình giao thông, tình trạng tắc nghẽn hoặc thời gian di chuyển dựa trên tình hình giao thông hiện tại. Xem phần Định tuyến dựa trên tình hình giao thông.
11 đến 25 `intermediate_waypoints`	Tuyến đường cần có hơn 10 điểm dừng giữa điểm xuất phát và điểm đến.

Tất cả các lựa chọn khác đều được tính phí theo SKU Essentials, bao gồm cả chế độ di chuyển, thời gian, tuyến đường thay thế, hình nhiều đường và độ lệch vị trí.

Định tuyến dựa trên tình hình giao thông

Theo mặc định, các tuyến đường được tính toán mà không có tình trạng giao thông trực tiếp (ROUTING_PREFERENCE_TRAFFIC_UNAWARE). Chế độ cài đặt này có độ trễ thấp nhất. Chế độ này phù hợp với những yêu cầu không quan trọng hoặc không áp dụng tình hình giao thông, chẳng hạn như tuyến đường đi bộ hoặc kế hoạch sơ bộ.

Đặt routing_preference thành ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL để tính toán tuyến đường và thời gian di chuyển theo tình trạng giao thông hiện tại, khi có dữ liệu giao thông. Hãy sử dụng ý định này khi người dùng hỏi về thời gian lái xe ngay lúc này. Đối với các tuyến đường TRANSIT, chế độ cài đặt này sử dụng dữ liệu về phương tiện công cộng theo thời gian thực, chẳng hạn như tình trạng chậm trễ và huỷ chuyến (nếu có). Tham số này không được hỗ trợ cho các tuyến WALK hoặc BICYCLE; những yêu cầu đó sẽ trả về lỗi INVALID_ARGUMENT. Đây là một lựa chọn của gói Pro, nên yêu cầu này sẽ được tính phí theo SKU Pro. Lựa chọn này cũng làm tăng độ trễ.

Trong giai đoạn Phát hành rộng rãi có hạn chế, nếu dự án của bạn không có trong danh sách cho phép của Pro, thì lựa chọn này sẽ được coi là ROUTING_PREFERENCE_TRAFFIC_UNAWARE. Để biết thông tin chi tiết, hãy xem phần Các lựa chọn cho gói Pro trong giai đoạn phát hành rộng rãi có hạn chế.

Ví dụ

Yêu cầu sau đây yêu cầu một tuyến đường lái xe có thông tin về tình hình giao thông, có một điểm dừng trung gian và một hình nhiều đường được mã hoá. Gói này được tính phí theo SKU Pro:

{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      "origin": {"address": "Ferry Building, San Francisco, CA"},
      "destination": {"address": "Golden Gate Park, San Francisco, CA"},
      "intermediate_waypoints": [
        {"address": "Palace of Fine Arts, San Francisco, CA"}
      ],
      "travel_mode": "DRIVE",
      "routing_preference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
      "include_polyline": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

Phản hồi

Câu trả lời chứa routes[], được sắp xếp theo thứ tự từ đề xuất nhiều nhất đến ít nhất. Chỉ có một tuyến đường được trả về, trừ phi compute_alternative_routes là true. Mỗi tuyến đường bao gồm:

distanceMeters: Khoảng cách di chuyển của tuyến đường, tính bằng mét.
duration: Thời gian cần thiết để di chuyển trên tuyến đường. Với ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, thời lượng sẽ tính đến tình trạng giao thông.
encodedPolyline: Đường dẫn của tuyến dưới dạng một hình nhiều đường được mã hoá, khi include_polyline là true. Bạn có thể dùng thông tin này để vẽ tuyến đường trên bản đồ bằng các API khác của Google Maps Platform.
attribution: Thông tin ghi nhận tác giả mà bạn phải hiển thị cùng với tuyến đường. Xem Yêu cầu về thông tin ghi công.

Các lựa chọn Pro trong giai đoạn Phát hành rộng rãi có hạn chế

Trong giai đoạn Phát hành rộng rãi có hạn chế, các lựa chọn của gói Pro chỉ dành cho những dự án có trong danh sách cho phép của gói Pro. Nếu dự án của bạn chưa có trong danh sách cho phép, hãy làm như sau:

ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL được coi là ROUTING_PREFERENCE_TRAFFIC_UNAWARE và yêu cầu được tính phí theo SKU Essentials.
Yêu cầu có hơn 10 điểm tham chiếu trung gian sẽ trả về lỗi INVALID_ARGUMENT ("Hỗ trợ tối đa 10 điểm tham chiếu trung gian").

Để yêu cầu quyền truy cập, hãy xem phần Các lựa chọn cho gói Pro trong giai đoạn phát hành rộng rãi có hạn chế.

Thanh toán và hạn mức

Mỗi yêu cầu compute_routes là một sự kiện có tính phí:

Yêu cầu không sử dụng bất kỳ lựa chọn nào của gói Pro sẽ được tính phí theo SKU Essentials.
Yêu cầu sử dụng một lựa chọn Pro sẽ được tính phí theo SKU Pro. Việc sử dụng cả hai lựa chọn Pro trong một yêu cầu không làm thay đổi mức phí. Để biết giá của gói Pro, hãy xem bài viết So sánh gói Essentials, Pro và Grounding with Google Maps.

Việc yêu cầu tuyến đường thay thế, hình nhiều đường, thời gian khởi hành hoặc thời gian đến, hoặc một phương thức di chuyển khác không làm thay đổi SKU.

Hạn mức compute_routes là 300 truy vấn mỗi phút, mỗi dự án, được chia sẻ bởi cả hai SKU. Để biết thông tin về giá, hãy xem Bảng giá chính và Bảng giá tại Ấn Độ.

Giới hạn

Một yêu cầu có thể bao gồm tối đa 25 điểm tham chiếu trung gian; 11 đến 25 là một lựa chọn Pro. Yêu cầu có nhiều hơn số lượng này sẽ trả về lỗi INVALID_ARGUMENT.
Tuyến phương tiện công cộng không hỗ trợ các điểm tham chiếu trung gian. Yêu cầu về phương tiện công cộng có các điểm tham chiếu trung gian sẽ trả về lỗi INVALID_ARGUMENT.
ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL không được hỗ trợ cho tuyến đường đi bộ hoặc tuyến đường xe đạp.
Đối với tuyến đường đi bằng phương tiện công cộng, thời gian khởi hành và thời gian đến có thể là tối đa 7 ngày trước hoặc 100 ngày sau. Đối với các phương thức di chuyển khác, ngày khởi hành không được là ngày trong quá khứ và có thể là ngày trong vòng 365 ngày tới.
Toạ độ của điểm tham chiếu phải nằm trong ranh giới địa lý hợp lệ (vĩ độ từ -90 đến 90, kinh độ từ -180 đến 180).
Công cụ này không trả về thông tin chi tiết về các bước từng chặng, chặng hoặc tuyến phương tiện công cộng.