Package google.maps.routes.v1

Chỉ mục

RoutesPreferred

API Ưu tiên về tuyến đường.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

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.
Phạm vi uỷ quyền

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.
ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Lấy danh sách các nguồn gốc và đích đến rồi trả về một luồng chứa thông tin tuyến đường cho mỗi tổ hợp điểm xuất phát và đích đến.

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 thời lượng tuyến đường, khoảng cách, trạng thái của thành phần, điều kiện và chỉ mục thành phần (ví dụ về cách thiết lập quy trình sản xuất): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Điều quan trọng là bạn phải đưa status vào mặt nạ cho trường (field mask) vì nếu không tất cả thông báo sẽ hiển thị là bình thường. Google không khuyến khích việc sử dụng mặt nạ cho trường phản hồi bằng ký tự đại diện (*) 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.
Phạm vi uỷ quyền

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.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Trả về tuyến chính cùng với các tuyến thay thế tuỳ chọn, dựa trên một tập hợp các điểm cuối và điểm tham chiếu trung gian.

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ạ trường 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 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 thời lượng, khoảng cách và nhiều đường ở cấp tuyến đường (ví dụ về cách thiết lập trong quá trình sản xuất): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

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 ở 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.
Phạm vi uỷ quyền

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.

ComputeCustomRoutesRequest

Thông báo yêu cầu ComputeCustomRoutes.

Các trường
origin

Waypoint

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

Waypoint

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

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.
travel_mode

RouteTravelMode

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

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 travel_mode là DRIVE hoặc TWO_WHEELER, nếu không yêu cầu không thành công.
polyline_quality

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.
polyline_encoding

PolylineEncoding

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

Timestamp

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.
route_modifiers

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.
route_objective

RouteObjective

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

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

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.

ComputeCustomRoutesResponse

Thông báo phản hồi ComputeCustomRoutes.

Các trường
routes[]

CustomRoute

Tuyến "tốt nhất" cho mục tiêu tuyến đầu vào.
fastest_route

CustomRoute

Tuyến đường tham khảo nhanh nhất.
shortest_route

CustomRoute

Lộ trình tham chiếu ngắn nhất.
fallback_info

FallbackInfo

Thông tin dự phòng cho các tuyến tuỳ chỉnh.

FallbackInfo

Đóng gói thông tin dự phòng cho ComputeCustomRoutes. ComputeCustomRoutes thực hiện hai loại dự phòng:

  1. Nếu không thể tính toán tuyến đường bằng cách sử dụng yếu tố định tuyến mà khách hàng yêu cầu, thì máy tính sẽ chuyển sang chế độ định tuyến khác. Trong trường hợp này, fallback_routing_mode vàroute_mode_fallback_reason dùng để thông báo về chế độ định tuyến dự phòng đã dùng, cũng như lý do dự phòng.

  2. Nếu không thể tính toán tuyến "tốt nhất" cho mục tiêu tuyến do khách hàng chỉ định, thì có thể phương án dự phòng sẽ là một mục tiêu khác. fallback_route_objective được dùng để truyền đạt mục tiêu tuyến dự phòng.

Các trường
routing_mode

FallbackRoutingMode

Chế độ định tuyến dùng cho phản hồi. Nếu dự phòng được kích hoạt, chế độ này có thể khác với lựa chọn ưu tiên định tuyến đã đặt trong yêu cầu máy khách ban đầu.
routing_mode_reason

FallbackReason

Lý do sử dụng câu trả lời dự phòng thay cho câu trả lời ban đầu. Trường này chỉ được điền khi chế độ dự phòng được kích hoạt và phản hồi dự phòng được trả về.
route_objective

FallbackRouteObjective

Mục tiêu định tuyến dùng cho phản hồi. Nếu tính năng dự phòng được kích hoạt, thì mục tiêu có thể khác với mục tiêu định tuyến đã cung cấp trong yêu cầu ứng dụng ban đầu.

FallbackRouteObjective

NavigationObjective được dùng cho phản hồi.

Enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Chưa xác định mục tiêu định tuyến dự phòng.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Nếu khách hàng yêu cầu RateCard (Thẻ giá) và đặt include_tolls thành true (đúng) và Google không có dữ liệu về giá cầu đường cho chặng bay này, thì API sẽ quay lại RateCard mà không xem xét đến giá cầu đường.

ComputeRouteMatrixRequest

Thông báo yêu cầu ComputeRouteMatrix

Các trường
origins[]

RouteMatrixOrigin

Bắt buộc. Mảng nguồn gốc xác định các hàng của ma trận phản hồi. Một số quy định hạn chế về kích thước áp dụng cho số lượng giá trị riêng biệt của các nguồn gốc và đích đến:

  • Số lượng phần tử (gốc × đích) không được nhiều hơn 625 trong mọi trường hợp.
  • Số phần tử (gốc × đích) không được nhiều hơn 100 nếu4_preference được đặt thành TRAFFIC_AWARE_OPTIMAL.
  • Số điểm tham chiếu (nguồn gốc + đích đến) được chỉ định là place_id không được lớn hơn 50.
destinations[]

RouteMatrixDestination

Bắt buộc. Mảng các đích đến giúp xác định các cột của ma trận phản hồi.
travel_mode

RouteTravelMode

Không bắt buộc. Nêu rõ phương thức di chuyển.
routing_preference

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, 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 travel_mode là DRIVE hoặc TWO_WHEELER, nếu không yêu cầu không thành công.
departure_time

Timestamp

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ị mặc định sẽ là thời gian bạn đưa ra 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.

ComputeRoutesRequest

Thông báo yêu cầu ComputeRoutes.

Các trường
origin

Waypoint

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

Waypoint

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

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.
travel_mode

RouteTravelMode

Không bắt buộc. Nêu rõ phương thức di chuyển.
routing_preference

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 travel_mode là DRIVE hoặc TWO_WHEELER, nếu không yêu cầu không thành công.
polyline_quality

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.
polyline_encoding

PolylineEncoding

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

Timestamp

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.
compute_alternative_routes

bool

Chỉ định xem có tính toán các tuyến đường thay thế ngoài tuyến đường hay không.
route_modifiers

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.
language_code

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

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.
optimize_waypoint_order

bool

Nếu OptimizeWaypointOrder được đặt thành true, hệ thống sẽ cố gắng sắp xếp lại các điểm tham chiếu trung gian được chỉ định để giảm thiểu tổng chi phí của tuyến. Nếu bất kỳ điểm tham chiếu trung gian nào là thông qua điểm tham chiếu, thì yêu cầu sẽ không thành công. Sử dụng ComputeRoutesResponse.Routes.Optimized_intermediate_waypoint_index để tìm thứ tự mới. Nếu không có yêu cầu route.optimize_intermediate_waypoint_index trong tiêu đề X-Goog-FieldMask, thì yêu cầu sẽ không thành công. Nếu OptimizeWaypointOrder được đặt thành false, ComputeRoutesResponse.optimization_intermediate_waypoint_index sẽ trống.

ComputeRoutesResponse

ComputeRoutes thông báo phản hồi.

Các trường
routes[]

Route

Chứa một mảng các tuyến được tính (tối đa 3 tuyến) khi bạn chỉ định Compute_alternatives_routes và chỉ chứa một tuyến khi bạn không chỉ định. Khi mảng này chứa nhiều mục nhập, tuyến đầu tiên là tuyến nên dùng nhất. Nếu mảng trống thì tức là không thể tìm thấy tuyến nào.
fallback_info

FallbackInfo

Trong một số trường hợp khi không thể tính toán kết quả tuyến với tất cả các tuỳ chọn đầu vào, máy chủ có thể dự phòng sang một cách tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.

CustomRoute

Đóng gói một tuyến tuỳ chỉnh được tính toán dựa trên mục tiêu về tuyến do khách hàng chỉ định. Customroute chứa một tuyến và mã thông báo tuyến đường có thể được truyền đến NavSDK để tạo lại tuyến đường tùy chỉnh để điều hướng từng chặng.

Các trường
route

Route

Tuyến được xem là "tốt nhất" cho mục tiêu tuyến đầu vào.
token

string

Mã thông báo tuyến đường được mã hoá base64 an toàn trên web có thể được truyền đến NavSDK, cho phép NavSDK tạo lại tuyến trong khi điều hướng và trong trường hợp định tuyến lại theo ý định ban đầu khiroutesPreferences ComputeCustomRoutes được gọi. Khách hàng nên coi mã thông báo này là một khối mờ mờ.

FallbackInfo

Thông tin liên quan đến cách thức và lý do sử dụng kết quả dự phòng. Nếu bạn đặt trường này, thì điều đó có nghĩa là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ ưu tiên của bạn làm chế độ dự phòng.

Các trường
routing_mode

FallbackRoutingMode

Chế độ định tuyến dùng cho phản hồi. Nếu dự phòng được kích hoạt, chế độ này có thể khác với lựa chọn ưu tiên định tuyến đã đặt trong yêu cầu máy khách ban đầu.
reason

FallbackReason

Lý do sử dụng câu trả lời dự phòng thay cho câu trả lời ban đầu. Trường này chỉ được điền khi chế độ dự phòng được kích hoạt và phản hồi dự phòng được trả về.

FallbackReason

Lý do sử dụng phản hồi dự phòng.

Enum
FALLBACK_REASON_UNSPECIFIED Chưa chỉ định lý do dự phòng.
SERVER_ERROR Đã xảy ra lỗi máy chủ trong khi tính toán tuyến đường bằng chế độ định tuyến ưa thích của bạn, nhưng chúng tôi có thể trả về kết quả được tính toán theo chế độ thay thế.
LATENCY_EXCEEDED Chúng tôi không thể hoàn tất việc tính toán bằng chế độ định tuyến mong muốn của bạn đúng thời gian, nhưng chúng tôi có thể trả về kết quả được tính toán bằng chế độ thay thế.

FallbackRoutingMode

Chế độ định tuyến thực tế dùng cho phản hồi dự phòng được trả về.

Enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Không được sử dụng.
FALLBACK_TRAFFIC_UNAWARE Cho biết chế độ định tuyến "TRAFFIC_UNAWARE" đã được dùng để tính toán phản hồi.
FALLBACK_TRAFFIC_AWARE Cho biết chế độ định tuyến "TRAFFIC_AWARE" đã được dùng để tính toán phản hồi.

Vị trí

Bao gồm một vị trí (một điểm địa lý và một tiêu đề không bắt buộc).

Các trường
lat_lng

LatLng

Toạ độ địa lý của điểm tham chiếu.
heading

Int32Value

Hướng la bàn được liên kết với hướng của luồng giao thông. Giá trị này được dùng để chỉ định phía đường được dùng để đón và trả khách. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định tiêu đề đến hạn về phía Bắc, 90 chỉ định tiêu đề đến hạn về phía Đông, v.v. Bạn chỉ có thể sử dụng trường này cho phương tiện đi lại DRIVE và TWO_WHEELER.

Thao tác

Một tập hợp các giá trị chỉ định thao tác điều hướng cần thực hiện cho bước hiện tại (ví dụ: rẽ trái, hợp nhất, đi thẳng, v.v.).

Enum
MANEUVER_UNSPECIFIED Không được sử dụng.
TURN_SLIGHT_LEFT Xoay một chút sang trái.
TURN_SHARP_LEFT Xoay mạnh sang trái.
UTURN_LEFT Vòng ngược lại.
TURN_LEFT Quay sang trái.
TURN_SLIGHT_RIGHT Xoay một chút sang phải.
TURN_SHARP_RIGHT Xoay mạnh sang phải.
UTURN_RIGHT Vòng ngược lại.
TURN_RIGHT Quay sang phải.
STRAIGHT Hãy nói thẳng.
RAMP_LEFT Đi theo đoạn đường dốc bên trái.
RAMP_RIGHT Đi vào đoạn đường dốc bên phải.
MERGE Hợp nhất vào lưu lượng truy cập.
FORK_LEFT Đi theo ngã ba bên trái.
FORK_RIGHT Chọn đúng ngã ba.
FERRY Đi phà.
FERRY_TRAIN Đi tàu dẫn lên phà.
ROUNDABOUT_LEFT rẽ trái tại chỗ đường vòng.
ROUNDABOUT_RIGHT rẽ phải tại chỗ đường vòng.
Các trường
maneuver

Maneuver

Đóng gói hướng dẫn điều hướng cho bước hiện tại (ví dụ: rẽ trái, hợp nhất, đi thẳng, v.v.). Trường này xác định biểu tượng nào sẽ hiển thị.
instructions

string

Hướng dẫn cách thực hiện bước này.

Hình nhiều đường

Đóng gói một hình nhiều đường đã mã hoá.

Các trường
Trường nhóm polyline_type. Đóng gói loại hình nhiều đường. Giá trị mặc định là được mã hoá_polyline. polyline_type chỉ có thể là một trong những trạng thái sau đây:
encoded_polyline

string

Mã hoá chuỗi của hình nhiều đường bằng thuật toán mã hoá hình nhiều đường
geo_json_linestring

Struct

Chỉ định một hình nhiều đường bằng định dạng GeoJSON LineString

PolylineEncoding

Chỉ định loại hình nhiều đường ưu tiên cần được trả về.

Enum
POLYLINE_ENCODING_UNSPECIFIED Chưa chỉ định tùy chọn loại hình nhiều đường. Giá trị mặc định là ENCODED_POLYLINE.
ENCODED_POLYLINE Chỉ định một hình nhiều đường được mã hoá bằng thuật toán mã hoá hình nhiều đường.
GEO_JSON_LINESTRING Chỉ định một hình nhiều đường bằng định dạng GeoJSON LineString

PolylineQuality

Một tập hợp các giá trị chỉ định chất lượng của hình nhiều đường.

Enum
POLYLINE_QUALITY_UNSPECIFIED Chưa chỉ định lựa chọn ưu tiên về chất lượng hình nhiều đường. Giá trị mặc định là OVERVIEW.
HIGH_QUALITY Chỉ định một hình nhiều đường chất lượng cao (được tạo bằng nhiều điểm hơn OVERVIEW) nhưng sẽ tăng kích thước phản hồi. Hãy dùng giá trị này khi bạn cần độ chính xác cao hơn.
OVERVIEW Chỉ định một hình nhiều đường tổng quan – được tạo bằng một số lượng nhỏ các điểm. Sử dụng giá trị này khi hiển thị thông tin tổng quan về tuyến đường. Việc sử dụng tuỳ chọn này có độ trễ yêu cầu thấp hơn so với sử dụng tuỳ chọn HIGH_QUALITY.

Tuyến đường

Bao bọc một tuyến đường, bao gồm một loạt các đoạn đường được kết nối với nhau để kết hợp với các điểm đầu, cuối và trung gian.

Các trường
legs[]

RouteLeg

Một tập hợp các chân (đoạn đường dẫn giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chân tương ứng với chuyến đi giữa hai Điểm tham chiếu không phải via. Ví dụ: một tuyến đường không có điểm tham chiếu trung gian thì chỉ có một chặng. Tuyến đường có một điểm trung gian không phải via có hai chân. Tuyến đường có một điểm tham chiếu trung gian via có một chân. Thứ tự của các chân khớp với thứ tự của Điểm tham chiếu từ origin đến intermediates đến destination.
distance_meters

int32

Khoảng cách đi được của tuyến đường, tính bằng mét.
duration

Duration

Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập routing_preference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với static_duration. Nếu bạn đặt routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán dựa trên điều kiện lưu lượng truy cập.
static_duration

Duration

Thời gian đi qua tuyến đường mà không tính đến tình trạng giao thông.
polyline

Polyline

Hình nhiều đường tổng thể của tuyến đường. Hình nhiều đường này sẽ là hình nhiều đường tổng hợp của tất cả legs.
description

string

Nội dung mô tả về tuyến đường.
warnings[]

string

Một mảng cảnh báo sẽ xuất hiện khi hiển thị tuyến đường.
viewport

Viewport

Hộp giới hạn khung nhìn của hình nhiều đường.
travel_advisory

RouteTravelAdvisory

Thông tin bổ sung về tuyến đường.
optimized_intermediate_waypoint_index[]

int32

Nếu ComputeRoutesRequest.optimize_waypoint_order được đặt thành true, trường này sẽ chứa thứ tự được tối ưu hoá của điểm tham chiếu trung gian. Nếu không, trường này sẽ trống. Ví dụ: giả sử dữ liệu đầu vào là Xuất xứ: LA; Trung cấp: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm tham chiếu trung gian được tối ưu hoá là: Phoenix, Dallas, Bangor. Khi đó trường này chứa các giá trị [2, 0, 1]. Chỉ mục bắt đầu bằng 0 cho điểm tham chiếu trung gian đầu tiên.

RouteLeg

Đóng gói một phân đoạn giữa các điểm tham chiếu không phải via.

Các trường
distance_meters

int32

Quãng đường đi được của chân tuyến đường, tính bằng mét.
duration

Duration

Khoảng thời gian cần thiết để di chuyển chân. Nếu bạn đặt route_preference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với static_duration. Nếu route_preference là TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này được tính toán có tính đến điều kiện lưu lượng truy cập.
static_duration

Duration

Thời gian di chuyển qua chặng, được tính toán mà không tính đến tình trạng giao thông.
polyline

Polyline

Hình nhiều đường tổng thể cho chân này. Quy định này cũng áp dụng cho hình nhiều đường của mỗi step.
start_location

Location

Vị trí bắt đầu của chân này. Mã này có thể khác với origin được cung cấp. Ví dụ: khi origin được cung cấp không nằm gần một con đường, thì đây là một điểm trên đường.
end_location

Location

Vị trí kết thúc của chân này. Mã này có thể khác với destination được cung cấp. Ví dụ: khi destination được cung cấp không nằm gần một con đường, thì đây là một điểm trên đường.
steps[]

RouteLegStep

Một dãy các bước cho biết các đoạn trong chân này. Mỗi bước đại diện cho một hướng dẫn điều hướng.
travel_advisory

RouteLegTravelAdvisory

Bao gồm thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra, v.v. trên đoạn tuyến đường.

RouteLegStep

Đóng gói một phân đoạn của RouteLeg. Mỗi bước tương ứng với một hướng dẫn di chuyển. Chân của tuyến đường được tạo thành từ các bước.

Các trường
distance_meters

int32

Quãng đường đi được của bước này (tính bằng mét). Trong một số trường hợp, trường này có thể không có giá trị.
static_duration

Duration

Thời gian di chuyển qua bước này mà không tính đến tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị.
polyline

Polyline

Hình nhiều đường liên kết với bước này.
start_location

Location

Vị trí bắt đầu của bước này.
end_location

Location

Vị trí kết thúc của bước này.
navigation_instruction

NavigationInstruction

Hướng dẫn di chuyển.
travel_advisory

RouteLegStepTravelAdvisory

Đưa ra thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra ở bước chân.

RouteLegStepTravelAdvisory

Đưa ra thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra ở bước chân.

Các trường
speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Có thể áp dụng trong trường hợp có các lựa chọn ưu tiên định tuyến đến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian bao phủ toàn bộ hình nhiều đường của RouteLegStep mà không chồng chéo. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng thời gian trước đó.

Ví dụ:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteLegTravelAdvisory

Bao gồm thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra, v.v. trên đoạn tuyến đường.

Các trường
toll_info

TollInfo

Cung cấp thông tin chi tiết về lệ phí cầu đường trên Tuyến đường cụ thể. Trường này chỉ được điền nếu chúng ta cho rằng có thu phí trên Tuyến đường. Nếu trường này được đặt nhưng trường phụ refund_price (giá_trị_ước_tính) không có dữ liệu, thì chúng tôi dự kiến là đường có thu phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu trường này không tồn tại thì sẽ không có thu phí trên Tuyến{0/}.
speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Có thể áp dụng trong trường hợp có các lựa chọn ưu tiên định tuyến đến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian bao phủ toàn bộ hình nhiều đường của Tuyến đường Lg mà không chồng chéo. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng thời gian trước đó.

Ví dụ:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

Một đích đến duy nhất cho ComputeRouteMatrixRequest

Các trường
waypoint

Waypoint

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

RouteMatrixElement

Đóng gói thông tin tuyến đường đã tính toán cho cặp điểm xuất phát/đích đến trong API ComputeRouteMatrix. Proto này có thể được truyền trực tuyến đến ứng dụng khách.

Các trường
origin_index

int32

Chỉ mục gốc 0 của nguồn gốc trong yêu cầu.
destination_index

int32

Chỉ mục dựa trên giá trị 0 của đích đến trong yêu cầu.
status

Status

Mã trạng thái lỗi cho phần tử này.
condition

RouteMatrixElementCondition

Cho biết đã tìm thấy tuyến đường hay chưa. Không phụ thuộc vào trạng thái.
distance_meters

int32

Khoảng cách đi được của tuyến đường, tính bằng mét.
duration

Duration

Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập routing_preference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với static_duration. Nếu bạn đặt routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán dựa trên điều kiện lưu lượng truy cập.
static_duration

Duration

Thời gian đi qua tuyến đường mà không tính đến tình trạng giao thông.
travel_advisory

RouteTravelAdvisory

Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về quy định hạn chế và thông tin về thu phí cầu đường
fallback_info

FallbackInfo

Trong một số trường hợp khi không thể tính toán tuyến đường với các tuỳ chọn đã cho cho cặp điểm gốc/đích cụ thể này, máy chủ có thể quay lại sử dụng chế độ tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.

RouteMatrixElementCondition

Điều kiện của tuyến được trả về.

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Chỉ được dùng khi status của phần tử không được chấp nhận.
ROUTE_EXISTS Đã tìm thấy một tuyến đường và thông tin tương ứng đã được điền cho phần tử.
ROUTE_NOT_FOUND Không tìm thấy tuyến đường nào. Các trường có chứa thông tin về tuyến đường, chẳng hạn như distance_meters hoặc duration, sẽ không được điền vào phần tử.

RouteMatrixOrigin

Một nguồn gốc duy nhất cho ComputeRouteMatrixRequest

Các trường
waypoint

Waypoint

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

RouteModifiers

Không bắt buộc. Đối tượng sửa đổi cho mọi tuyến lấy đây làm nguồn gốc

RouteModifiers

Đóng gói một tập hợp các điều kiện không bắt buộc để đáp ứng khi tính toán các tuyến đường.

Các trường
avoid_tolls

bool

Chỉ định xem có tránh đường có thu phí hay không khi thích hợp. Sẽ ưu tiên áp dụng cho các tuyến đường không chứa đường có thu phí. Chỉ áp dụng cho các phương tiện đi lại DRIVE và TWO_WHEELER.
avoid_highways

bool

Chỉ định xem có tránh đường cao tốc khi thích hợp hay không. Sẽ ưu tiên các tuyến đường không chứa đường cao tốc. Chỉ áp dụng cho các phương tiện đi lại DRIVE và TWO_WHEELER.
avoid_ferries

bool

Chỉ định xem có tránh phà khi thích hợp hay không. Chúng tôi sẽ ưu tiên các tuyến đường không cho phép di chuyển bằng phà. Chỉ áp dụng cho phương tiện đi lại DRIVE và TWO_WHEELER.
avoid_indoor

bool

Chỉ định xem có tránh đi trong nhà khi thích hợp hay không. Hệ thống sẽ ưu tiên các tuyến đường không chứa tính năng chỉ đường trong nhà. Chỉ áp dụng cho phương tiện đi lại WALK.
vehicle_info

VehicleInfo

Nêu thông tin về xe.
toll_passes[]

TollPass

Cung cấp thông tin về thẻ thu phí cầu đường. Nếu phí cầu đường được cung cấp, API sẽ cố gắng trả về giá vé. Nếu phí cầu đường không được cung cấp, API sẽ coi phí cầu đường là không xác định và cố gắng trả về giá tiền mặt. Chỉ áp dụng cho chế độ đi lại DRIVE và TWO_WHEELER.

RouteObjective

Đóng gói một mục tiêu để tối ưu hoá theo ComputeCustomRoutes.

Các trường
rate_card

RateCard

Mục tiêu RateCard.

RateCard

Đóng gói mục tiêu tuyến trên RateCard.

Các trường
cost_per_minute

MonetaryCost

Không bắt buộc. Chi phí mỗi phút.
cost_per_km

MonetaryCost

Không bắt buộc. Chi phí mỗi km.
include_tolls

bool

Không bắt buộc. Liệu có bao gồm phí cầu đường trong tổng chi phí hay không.

MonetaryCost

Trình bày chi phí sử dụng trong thẻ giá.

Các trường
value

double

Bắt buộc. Giá trị chi phí bằng nội tệ suy ra được từ yêu cầu.

RouteTravelAdvisory

Đưa ra thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra, v.v.

Các trường
toll_info

TollInfo

Cung cấp thông tin chi tiết về lệ phí cầu đường trên Tuyến đường. Trường này chỉ được điền nếu chúng ta cho rằng có thu phí trên Tuyến đường. Nếu trường này được đặt nhưng trường phụ refund_price (giá_trị_ước_tính) không có dữ liệu, thì chúng tôi dự kiến là đường có thu phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu bạn không đặt trường này, thì chúng tôi sẽ hiểu là không có thu phí trên Tuyến đường này.
speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Có thể áp dụng trong trường hợp có các lựa chọn ưu tiên định tuyến đến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian bao phủ toàn bộ hình nhiều đường của tuyến đường mà không chồng chéo. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng thời gian trước đó.

Ví dụ:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteTravelMode

Một tập hợp các giá trị dùng để chỉ định phương tiện đi lại.

Enum
TRAVEL_MODE_UNSPECIFIED Chưa chỉ định phương tiện đi lại. Giá trị mặc định là DRIVE.
DRIVE Đi bằng xe ô tô khách.
BICYCLE Đi bằng xe đạp.
WALK Đi bộ.
TWO_WHEELER Xe mô tô hai bánh. Ví dụ: xe mô tô. Xin lưu ý rằng chế độ này khác với chế độ đi lại BICYCLE bao gồm chế độ do con người sử dụng.
TAXI

Đi bằng taxi được cấp phép, nghĩa là phương tiện có thể đi trên các làn đường taxi được chỉ định ở một số khu vực.

Chế độ TAXI là tính năng thử nghiệm. Nếu khách hàng yêu cầu tuyến đường TAXI trong một thành phố không có dữ liệu làn đường taxi, thì một tuyến đường DRIVE sẽ được trả về.

RoutingPreference

Một tập hợp giá trị chỉ định các yếu tố cần xem xét khi tính toán tuyến đường.

Enum
ROUTING_PREFERENCE_UNSPECIFIED Chưa chỉ định tùy chọn định tuyến. Mặc định là TRAFFIC_AWARE.
TRAFFIC_UNAWARE Tính toán các tuyến đường mà không tính đến tình trạng giao thông. Phù hợp khi tình trạng giao thông không quan trọng. Việc sử dụng giá trị này sẽ tạo ra độ trễ thấp nhất.
TRAFFIC_AWARE Tính toán các tuyến đường có xét đến tình trạng giao thông. Trái ngược với TRAFFIC_AWARE_OPTIMAL, một số tính năng tối ưu hoá được áp dụng để giảm đáng kể độ trễ.
TRAFFIC_AWARE_OPTIMAL Tính toán các tuyến đường có tính đến tình trạng giao thông mà không áp dụng hầu hết các chế độ tối ưu hoá hiệu suất. Việc sử dụng giá trị này sẽ tạo ra độ trễ cao nhất.

SpeedReadingInterval

Chỉ báo mật độ giao thông trên một đoạn liền kề của một đường nhiều đường hoặc đường dẫn. Cho một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên 0), SpeedReadingInterval xác định khoảng thời gian và mô tả lưu lượng truy cập của nó bằng các danh mục sau.

Các trường
start_polyline_point_index

int32

Chỉ mục bắt đầu của khoảng thời gian này trong hình nhiều đường. Trong JSON, khi chỉ mục bằng 0, trường sẽ có vẻ như không được điền.
end_polyline_point_index

int32

Chỉ mục kết thúc của khoảng này trong hình nhiều đường. Trong JSON, khi chỉ mục bằng 0, trường sẽ có vẻ như không được điền.
speed

Speed

Tốc độ giao thông trong khoảng thời gian này.

Tốc độ

Phân loại tốc độ hình nhiều đường dựa trên dữ liệu giao thông.

Enum
SPEED_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
NORMAL Tốc độ bình thường, không phát hiện thấy ùn tắc nhẹ.
SLOW Đã phát hiện thấy tắc nghẽn nhưng không có tắc nghẽn giao thông.
TRAFFIC_JAM Đã phát hiện kẹt xe.

TollInfo

Trình bày thông tin thu phí cầu đường trên Route hoặc RouteLeg.

Các trường
estimated_price[]

Money

Số tiền lệ phí cầu đường cho Tuyến đường hoặc Tuyến đường tương ứng. Danh sách này chứa số tiền tương ứng với mỗi đơn vị tiền tệ mà các trạm thu phí này dự kiến sẽ thu. Thông thường, danh sách này sẽ chỉ chứa một mục cho các tuyến đường có thu phí bằng một đơn vị tiền tệ. Đối với các chuyến đi quốc tế, danh sách này có thể chứa nhiều mục thể hiện phí cầu đường bằng các đơn vị tiền tệ khác nhau.

TollPass

Danh sách thẻ thu phí cầu đường trên khắp thế giới mà chúng tôi hỗ trợ.

Enum
TOLL_PASS_UNSPECIFIED Không được sử dụng. Nếu giá trị này được sử dụng, thì yêu cầu sẽ không thành công.
AU_ETOLL_TAG Một trong nhiều nhà cung cấp dịch vụ cầu đường ở Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Một trong nhiều nhà cung cấp dịch vụ cầu đường ở Sydney. https://www.tollpay.com.au/
AU_LINKT Thẻ phí cầu đường trên toàn nước Úc. Xem thêm thông tin tại https://www.linkt.com.au/.
AR_TELEPASE Phí cầu đường ở Argentina. Xem thêm thông tin chi tiết tại https://telepase.com.ar
BR_AUTO_EXPRESO Phí cầu đường ở Brazil. Xem thêm chi tiết tại https://www.autoexpreso.com
BR_CONECTCAR Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com.
BR_MOVE_MAIS Phí cầu đường ở Brazil. Xem thêm thông tin tại https://movemais.com.
BR_PASSA_RAPIDO Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://pasorapido.gob.do/
BR_SEM_PARAR Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://www.semparar.com.br.
BR_TAGGY Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://taggy.com.br.
BR_VELOE Phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Đường biên giới giữa Canada sang Hoa Kỳ.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Đường biên giới giữa Canada sang Hoa Kỳ.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Canada đến băng qua biên giới Hoa Kỳ.
CA_US_CONNEXION Ontario, Canada đến băng qua biên giới Hoa Kỳ.
CA_US_NEXUS_CARD Đường biên giới giữa Canada sang Hoa Kỳ.
ID_E_TOLL Indonesia. Thẻ điện tử do nhiều ngân hàng cung cấp, dùng để thanh toán lệ phí cầu đường. Tất cả thẻ điện tử thông qua ngân hàng đều được tính phí như nhau nên chỉ cần một giá trị enum. Ví dụ: Bank Mandiri https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT Ấn Độ, được miễn thuế biển số của tiểu bang HP.
MX_TAG_IAVE Thẻ cầu đường Mexico.
MX_TAG_TELEVIA Công ty thu phí cầu đường ở Mexico. Một trong số đó đang hoạt động ở Thành phố Mexico. Xem thêm thông tin chi tiết tại https://www.televia.com.mx.
MX_VIAPASS Thẻ cầu đường Mexico. Xem thêm thông tin chi tiết tại https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, Hoa Kỳ.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, Hoa Kỳ.
US_CA_FASTRAK CA, Hoa Kỳ.
US_CA_FASTRAK_CAV_STICKER Cho biết tài xế có thẻ FasTrak ngoài hình dán Xe sạch (CAV) do DMV cấp. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, Hoa Kỳ.
US_CO_GO_PASS CO, Hoa Kỳ.
US_DE_EZPASSDE Đức, Hoa Kỳ.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, Hoa Kỳ.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, Hoa Kỳ.
US_FL_EPASS FL, Hoa Kỳ.
US_FL_GIBA_TOLL_PASS FL, Hoa Kỳ.
US_FL_LEEWAY FL, Hoa Kỳ.
US_FL_SUNPASS FL, Hoa Kỳ.
US_FL_SUNPASS_PRO FL, Hoa Kỳ.
US_IL_EZPASSIL IL, Hoa Kỳ.
US_IL_IPASS IL, Hoa Kỳ.
US_IN_EZPASSIN Ấn Độ, Hoa Kỳ.
US_KS_BESTPASS_HORIZON KS, Hoa Kỳ.
US_KS_KTAG KS, Hoa Kỳ.
US_KS_NATIONALPASS KS, Hoa Kỳ.
US_KS_PREPASS_ELITEPASS KS, Hoa Kỳ.
US_LA_GEAUXPASS LA, Hoa Kỳ.
US_LA_TOLL_TAG LA, Hoa Kỳ.
US_MA_EZPASSMA MA, Hoa Kỳ.
US_MD_EZPASSMD MD, Hoa Kỳ.
US_ME_EZPASSME ME, Hoa Kỳ.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, Hoa Kỳ.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, Hoa Kỳ.
US_MI_IQ_PROX_CARD MI, Hoa Kỳ.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, Hoa Kỳ.
US_MI_NEXPRESS_TOLL MI, Hoa Kỳ.
US_MN_EZPASSMN MN, Hoa Kỳ.
US_NC_EZPASSNC NC, Hoa Kỳ.
US_NC_PEACH_PASS NC, Hoa Kỳ.
US_NC_QUICK_PASS NC, Hoa Kỳ.
US_NH_EZPASSNH NH, Hoa Kỳ.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Hoa Kỳ.
US_NJ_EZPASSNJ NJ, Hoa Kỳ.
US_NY_EXPRESSPASS New York, Hoa Kỳ.
US_NY_EZPASSNY New York, Hoa Kỳ.
US_OH_EZPASSOH OH, Hoa Kỳ.
US_PA_EZPASSPA PA, Hoa Kỳ.
US_RI_EZPASSRI RI, Hoa Kỳ.
US_SC_PALPASS SC, Hoa Kỳ.
US_TX_BANCPASS TX, Hoa Kỳ.
US_TX_DEL_RIO_PASS TX, Hoa Kỳ.
US_TX_EFAST_PASS TX, Hoa Kỳ.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, Hoa Kỳ.
US_TX_EPTOLL TX, Hoa Kỳ.
US_TX_EZ_CROSS TX, Hoa Kỳ.
US_TX_EZTAG TX, Hoa Kỳ.
US_TX_LAREDO_TRADE_TAG TX, Hoa Kỳ.
US_TX_PLUSPASS TX, Hoa Kỳ.
US_TX_TOLLTAG TX, Hoa Kỳ.
US_TX_TXTAG TX, Hoa Kỳ.
US_TX_XPRESS_CARD TX, Hoa Kỳ.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, Hoa Kỳ.
US_VA_EZPASSVA VA, Hoa Kỳ.
US_WA_BREEZEBY WA, Hoa Kỳ.
US_WA_GOOD_TO_GO WA, Hoa Kỳ.
US_WV_EZPASSWV WV, Hoa Kỳ.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, Hoa Kỳ.
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Hoa Kỳ.

Đơn vị

Một tập hợp các giá trị chỉ định đơn vị đo lường dùng trong màn hình.

Enum
UNITS_UNSPECIFIED Chưa chỉ định đơn vị đo lường. Giá trị mặc định là đơn vị đo lường suy ra được từ yêu cầu.
METRIC Đơn vị đo lường hệ mét.
IMPERIAL Đơn vị đo lường Hoàng gia (tiếng Anh).

VehicleEmissionType

Một tập hợp giá trị mô tả loại khí thải của xe. Chỉ áp dụng cho chế độ đi lại DRIVE.

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Chưa chỉ định loại khí thải. Mặc định là GASOLINE.
GASOLINE Xe chạy bằng xăng/xăng.
ELECTRIC Xe chạy bằng điện.
HYBRID Xe sử dụng nhiên liệu kết hợp (chẳng hạn như xăng + xe điện).

VehicleInfo

Cung cấp thông tin về xe, chẳng hạn như ký tự cuối cùng của biển số xe.

Các trường
emission_type

VehicleEmissionType

Mô tả loại khí thải của xe. Chỉ áp dụng cho chế độ đi lại DRIVE.

Waypoint

Đóng gói một điểm tham chiếu. Điểm tham chiếu đánh dấu cả điểm đầu và điểm cuối của tuyến đường, đồng thời bao gồm các điểm dừng trung gian dọc theo tuyến đường.

Các trường
via

bool

Đánh dấu điểm tham chiếu này là một mốc quan trọng thay vì là điểm dừng. Đối với mỗi điểm tham chiếu không phải trong yêu cầu, phản hồi sẽ thêm một mục nhập vào mảng legs để cung cấp thông tin chi tiết về các điểm dừng ở chặng đó của chuyến đi. Đặt giá trị này thành true khi bạn muốn tuyến đường đi qua điểm tham chiếu này mà không dừng lại. Thông qua các điểm tham chiếu không khiến một mục nhập được thêm vào mảng legs nhưng sẽ định tuyến hành trình qua điểm tham chiếu. Bạn chỉ có thể đặt giá trị này trên các điểm tham chiếu là trung gian. Yêu cầu sẽ không thành công nếu bạn đặt trường này tại điểm tham chiếu của thiết bị đầu cuối. Nếu ComputeRoutesRequest.optimize_waypoint_order được đặt thành true, thì bạn không thể đặt trường này thành true; nếu không, yêu cầu sẽ không thành công.
vehicle_stopover

bool

Cho biết rằng điểm tham chiếu dành cho xe dừng ở đó với mục đích là đón hoặc trả xe. Khi bạn đặt giá trị này, tuyến đường được tính toán sẽ không bao gồm các điểm tham chiếu không phải là via trên các con đường không phù hợp để đến lấy hàng và trả xe. Lựa chọn này chỉ hoạt động cho chế độ đi lại DRIVE và TWO_WHEELER và khi location_type là location.
side_of_road

bool

Cho biết vị trí của điểm tham chiếu này có nghĩa là xe sẽ được ưu tiên dừng ở một phía đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí để xe có thể dừng ở bên đường mà vị trí bị dịch chuyển từ tâm đường. Lựa chọn này chỉ dùng được cho chế độ đi lại "DRIVE" và "TWO_WHEELER" (hệ thống đi lại), cũng như khi bạn đặt "location_type" thành "location".
Trường nhóm location_type. Nhiều cách để đại diện cho một vị trí. location_type chỉ có thể là một trong những trạng thái sau đây:
location

Location

Điểm được xác định bằng cách sử dụng toạ độ địa lý, bao gồm cả tiêu đề không bắt buộc.
place_id

string

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