Method: computeCustomRoutes

Cho một tập hợp các điểm cuối và trung gian, cùng với một mục tiêu tuyến, sẽ tính toán tuyến tốt nhất cho mục tiêu tuyến. Đồng thời trả về tuyến nhanh nhất và tuyến đường ngắn nhất làm tuyến tham chiếu.

LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ cho trường (field mask) của phản hồi bằng cách dùng tham số URL $fields hoặc fields, hoặc dùng tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tiêu đề và tham số URL có sẵn. Giá trị này là một danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết này về cách xây dựng đường dẫn trường.

Ví dụ: trong phương thức này:

  • Mặt nạ trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
  • Mặt nạ trường (field mask) của tuyến đường, thời lượng, mã thông báo và thông tin thu phí: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google không khuyến khích việc sử dụng mặt nạ cho trường (field mask) của phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ cho trường (field mask) ở cấp cao nhất (routes) vì:

  • Việc chỉ chọn những trường bạn cần sẽ giúp máy chủ của chúng tôi lưu chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
  • Chỉ chọn các trường mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và các trường mới đó có thể yêu cầu thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn chọn tất cả các trường ở cấp cao nhất, thì bạn có thể thấy hiệu suất giảm vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi.
  • Việc chỉ chọn các trường bạn cần sẽ làm giảm kích thước phản hồi, từ đó có thông lượng mạng cao hơn.

Yêu cầu HTTP

POST https://routespreferred.googleapis.com/v1alpha:computeCustomRoutes

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routeObjective": {
    object (RouteObjective)
  },
  "languageCode": string,
  "units": enum (Units)
}
Các trường
origin

object (Waypoint)

Bắt buộc. Điểm tham chiếu gốc.
destination

object (Waypoint)

Bắt buộc. Điểm tham chiếu đích.
intermediates[]

object (Waypoint)

Không bắt buộc. Một tập hợp các điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng tại hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
travelMode

enum (RouteTravelMode)

Không bắt buộc. Nêu rõ phương thức di chuyển. Hiện chỉ hỗ trợ DRIVE.
routingPreference

enum (RoutingPreference)

Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến đường. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ thêm lâu, thì lỗi sẽ được trả về. Trong tương lai, chúng tôi có thể triển khai cơ chế dự phòng để sử dụng một tuỳ chọn khác khi lựa chọn ưu tiên không cung cấp kết quả hợp lệ. Bạn chỉ có thể chỉ định tuỳ chọn này khi travelMode là DRIVE hoặc TWO_WHEELER, nếu không yêu cầu không thành công.
polylineQuality

enum (PolylineQuality)

Không bắt buộc. Chỉ định tuỳ chọn của bạn về chất lượng của hình nhiều đường.
polylineEncoding

enum (PolylineEncoding)

Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho hình nhiều đường.
departureTime

string (Timestamp format)

Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này thì giá trị này sẽ mặc định là thời gian mà bạn thực hiện yêu cầu. Nếu bạn đặt giá trị này thành một thời điểm đã xảy ra, thì yêu cầu sẽ không thành công.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
routeModifiers

object (RouteModifiers)

Không bắt buộc. Một tập hợp các điều kiện cần đáp ứng sẽ ảnh hưởng đến cách tính toán các tuyến đường.
routeObjective

object (RouteObjective)

Bắt buộc. Mục tiêu định tuyến để tối ưu hoá.
languageCode

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Xem Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của yêu cầu tuyến đường.
units

enum (Units)

Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Điều này bao gồm trường instruction trong NavigationInstruction. Giá trị này không ảnh hưởng đến các đơn vị đo lường dùng cho tuyến đường, quãng đường, quãng đường bước và thời lượng. Nếu bạn không cung cấp giá trị này thì đơn vị hiển thị sẽ được suy ra từ vị trí của yêu cầu.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của ComputeCustomRoutesResponse.

Phạm vi cấp phép

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.