Package google.maps.routes.v1

Chỉ mục

RoutesPreferred

API ưu tiên cho tuyến đường.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Cho trước một tập hợp các điểm tham chiếu đầu cuối và điểm trung gian cùng với một mục tiêu tuyến đường, tính toán tuyến đường tốt nhất cho mục tiêu tuyến đường. Đồng thời trả về tuyến đường nhanh nhất và tuyến 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 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 sử dụng tham số URL $fields hoặc fields hoặc tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tham số và tiêu đề 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. Hãy xem tài liệu chi tiết về cách tạo đường dẫn trường.

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

  • Mặt nạ trường 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 thể hiện khoảng cách tuyến đường, thời gian, mã thông báo và thông tin thu phí cầu đường: 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ạ trường phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ 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, nhờ đó chúng tôi có thể trả lại kết quả cho bạn với độ trễ thấp hơn.
  • Bạn chỉ nên chọn những trường mà bạn cần trong công việc phát hành công khai để đảm bảo hiệu suất ổn định về độ trễ. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể cần thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc chọn tất cả các trường ở cấp cao nhất, thì hiệu suất của bạn có thể bị suy giảm vì mọi trường mới mà chúng tôi thêm đều sẽ tự động được đưa vào câu trả lời.
  • Việc chỉ chọn các trường bạn cần sẽ giúp kích thước phản hồi nhỏ hơn, từ đó giúp thông lượng mạng cao hơn.
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 bài viết Tổng quan về OAuth 2.0.
ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Nhận danh sách các điểm gốc và đích đến rồi trả về một luồng chứa thông tin tuyến đường cho từng tổ hợp điểm khởi hành và đích đến.

LƯU Ý: Phương thức này yêu cầu bạn chỉ định một 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 sử dụng tham số URL $fields hoặc fields hoặc tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tham số và tiêu đề 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. Hãy xem tài liệu chi tiết về cách tạo đường dẫn trường.

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

  • Mặt nạ trường 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 thể hiện thời lượng tuyến đường, khoảng cách, trạng thái phần tử, điều kiện và chỉ mục phần tử (ví dụ về chế độ thiết lập phiên bản chính thức): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Điều quan trọng là bạn phải thêm status vào mặt nạ trường vì nếu không tất cả tin nhắn sẽ có vẻ ổn. Google không khuyến khích việc sử dụng mặt nạ trường phản hồi 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, nhờ đó chúng tôi có thể trả lại kết quả cho bạn với độ trễ thấp hơn.
  • Bạn chỉ nên chọn những trường mà bạn cần trong công việc phát hành công khai để đảm bảo hiệu suất ổn định về độ trễ. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể cần thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc chọn tất cả các trường ở cấp cao nhất, thì hiệu suất của bạn có thể bị suy giảm vì mọi trường mới mà chúng tôi thêm đều sẽ tự động được đưa vào câu trả lời.
  • Việc chỉ chọn các trường bạn cần sẽ giúp kích thước phản hồi nhỏ hơn, từ đó giúp thông lượng mạng cao hơn.
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 bài viết Tổng quan về OAuth 2.0.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Trả về tuyến đường chính cùng với các tuyến thay thế không bắt buộc, với một tập hợp các điểm tham chiếu đầu cuối và trung gian.

LƯU Ý: Phương thức này yêu cầu bạn chỉ định một 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 sử dụng tham số URL $fields hoặc fields hoặc bằng cách sử dụng tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tham số và tiêu đề 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 tạo đường dẫn trường.

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

  • Mặt nạ trường 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 thể hiện thời lượng, khoảng cách và hình nhiều đường ở cấp tuyến đường (ví dụ về cách thiết lập bản phát hành chính thức): 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ạ trường phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ 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, nhờ đó chúng tôi có thể trả lại kết quả cho bạn với độ trễ thấp hơn.
  • Bạn chỉ nên chọn những trường mà bạn cần trong công việc phát hành công khai để đảm bảo hiệu suất ổn định về độ trễ. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể cần thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc chọn tất cả các trường ở cấp cao nhất, thì hiệu suất của bạn có thể bị suy giảm vì mọi trường mới mà chúng tôi thêm đều sẽ tự động được đưa vào câu trả lời.
  • Việc chỉ chọn các trường bạn cần sẽ giúp kích thước phản hồi nhỏ hơn, từ đó giúp thông lượng mạng cao hơn.
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 bài viết Tổng quan về OAuth 2.0.

ComputeCustomRoutesRequest

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

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 ngang qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
travel_mode

RouteTravelMode

Không bắt buộc. Xác định 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. Máy chủ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến đường. Nếu lựa chọn ưu tiên về định tuyến gây ra lỗi hoặc độ trễ thêm lâu, thì hệ thống sẽ trả về lỗi. Trong tương lai, chúng tôi có thể triển khai cơ chế dự phòng để sử dụng tuỳ chọn khác khi tuỳ chọn ưu tiên không cho 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 sẽ không thành công.
polyline_quality

PolylineQuality

Không bắt buộc. Chỉ định lựa chọn ưu tiên của bạn về chất lượng 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ị mặc định sẽ là thời gian bạn yêu cầu. Nếu bạn đặt giá trị này thành thời gian đã 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 để đáp ứng điều kiện ả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 lộ trình để 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 truy cập vào http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Hãy xem phần 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.
units

Units

Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. bao gồm cả trường instruction trong NavigationInstruction. Các đơn vị đo lường dùng cho tuyến đường, chặng, quãng đường bước và thời gian không bị giá trị này ảnh hưở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.

Trường
routes[]

CustomRoute

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

CustomRoute

Tuyến đường tham chiếu nhanh nhất.
shortest_route

CustomRoute

Tuyến 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 bằng cách sử dụng định tuyến_preference do khách hàng yêu cầu, thì mã sẽ chuyển sang chế độ định tuyến khác. Trong trường hợp này dự phòng_routing_mode và định tuyến_mode_fallback_reason được dùng để thông báo về chế độ định tuyến dự phòng được sử dụng, cũng như lý do cho việc dự phòng.

  2. Nếu hệ thống không thể tính toán giá trị "tốt nhất" tuyến cho mục tiêu định tuyến do khách hàng chỉ định, nó có thể dự phòng đến một mục tiêu khác. backup_route_objective được dùng để thông báo mục tiêu tuyến dự phòng.

Trường
routing_mode

FallbackRoutingMode

Chế độ định tuyến được dùng cho phản hồi. Nếu tính năng dự phòng được kích hoạt thì 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 ứng dụng ban đầu.
routing_mode_reason

FallbackReason

Lý do tại sao phản hồi dự phòng được sử dụng thay cho phản hồi ban đầu. Trường này chỉ được điền sẵ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 tuyến đường được dùng cho câu trả lời. Nếu dự phòng được kích hoạt thì mục tiêu có thể khác với mục tiêu tuyến đã cung cấp trong yêu cầu ban đầu của khách hàng.

FallbackRouteObjective

Mục tiêu định tuyến được dùng cho phản hồi.

Enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Chưa chỉ định mục tiêu tuyến dự phòng.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Nếu khách hàng yêu cầu RateCard và tập hợp include_tolls thành true và Google không có dữ liệu về giá thu phí cầu đường cho tuyến đường, API sẽ chuyển lại về RateCard mà không xem xét đến mức phí cầu đường.

ComputeRouteMatrixRequest

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

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 lượng số của nguồn gốc và đích đến:

  • Số lượng phần tử (origins × destination) không được lớn hơn 625 trong mọi trường hợp.
  • Số lượng phần tử (gốc × đích) không được lớn hơn 100 nếu định tuyến_preference được đặt thành TRAFFIC_AWARE_OPTIMAL.
  • Số lượng điểm tham chiếu (điểm 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 đích đến, 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. Xác định 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. Máy chủ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến đường. Nếu lựa chọn ưu tiên định tuyến gây ra lỗi hoặc độ trễ thêm lâu, thì hệ thống sẽ trả về lỗi. Trong tương lai, chúng tôi có thể triển khai cơ chế dự phòng để sử dụng tuỳ chọn khác khi tuỳ chọn ưu tiên không cho 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 sẽ 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 yêu cầu. Nếu bạn đặt giá trị này thành thời gian đã 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.

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 ngang qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
travel_mode

RouteTravelMode

Không bắt buộc. Xác định 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. Máy chủ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến đường. Nếu lựa chọn ưu tiên định tuyến gây ra lỗi hoặc độ trễ lâu hơn thì hệ thống sẽ trả về lỗi. Trong tương lai, chúng tôi có thể triển khai cơ chế dự phòng để sử dụng tuỳ chọn khác khi tuỳ chọn ưu tiên không cho 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 sẽ không thành công.
polyline_quality

PolylineQuality

Không bắt buộc. Chỉ định lựa chọn ưu tiên của bạn về chất lượng 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ị mặc định sẽ là thời gian bạn yêu cầu. Nếu bạn đặt giá trị này thành thời gian đã 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 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 để đáp ứng điều kiện ả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 truy cập vào http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Hãy xem phần 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.
units

Units

Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. bao gồm cả trường instruction trong NavigationInstruction. Các đơn vị đo lường dùng cho tuyến đường, chặng, quãng đường bước và thời gian không bị giá trị này ảnh hưở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 bạn đặt OptimizeWaypointOrder thành true, thì 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 nhằm giảm thiểu tổng chi phí của tuyến. Nếu có bất kỳ điểm tham chiếu trung gian nào là qua điểm tham chiếu thì yêu cầu sẽ không thành công. Sử dụng ComputeRoutesResponse.Routes.optimize_ trước_waypoint_index để tìm thứ tự mới. Nếu không yêu cầu thoát.optimize_ chéo_waypoint_index trong tiêu đề X-Goog-FieldMask, thì yêu cầu đó sẽ không thành công. Nếu bạn đặt OptimizeWaypointOrder thành false, thì ComputeRoutesResponse.Optimized_interstitial_waypoint_index sẽ trống.

ComputeRoutesResponse

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

Trường
routes[]

Route

Chứa một mảng các tuyến đã tính toán (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, thì tuyến đầu tiên sẽ là tuyến được đề xuất nhiều nhất. Nếu mảng trống thì có nghĩa là không tìm thấy tuyến nào.
fallback_info

FallbackInfo

Trong một số trường hợp khi máy chủ không thể tính toán kết quả tuyến đường với tất cả các lựa chọn ưu tiên đầu vào, thì máy chủ có thể sử dụng 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 tuyến đường tuỳ chỉnh được tính toán dựa trên mục tiêu tuyến đường do khách hàng chỉ định. CustomRoute chứa một tuyến đường và một mã thông báo tuyến đường. Hệ thống có thể truyền mã này đến NavSDK để xây dựng lại tuyến đường tuỳ chỉnh cho hoạt động điều hướng từng chặng.

Trường
route

Route

Tuyến đường đượ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 cho web có thể được truyền đến NavSDK, cho phép NavSDK xây dựng lại tuyến đường trong khi điều hướng và trong trường hợp định tuyến lại theo ý định ban đầu khi RoutesPreference ComputeCustomRoutes được gọi. Khách hàng nên coi mã thông báo này là một blob 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.

Trường
routing_mode

FallbackRoutingMode

Chế độ định tuyến được dùng cho phản hồi. Nếu tính năng dự phòng được kích hoạt thì 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 ứng dụng ban đầu.
reason

FallbackReason

Lý do tại sao phản hồi dự phòng được sử dụng thay cho phản hồi ban đầu. Trường này chỉ được điền sẵ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 các tuyến đường bằng chế độ định tuyến ưu tiên của bạn. Tuy nhiên, chúng tôi có thể trả về kết quả được tính bằng chế độ thay thế.
LATENCY_EXCEEDED Chúng tôi không thể hoàn thành phép tính bằng chế độ định tuyến mong muốn của bạn đúng giờ, nhưng chúng tôi có thể trả về kết quả được tính bằng chế độ thay thế.

FallbackRoutingMode

Chế độ định tuyến thực tế được 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 "TRAFFIC_UNAWARE" chế độ định tuyến này đã được dùng để tính toán phản hồi.
FALLBACK_TRAFFIC_AWARE Cho biết "TRAFFIC_AWARE" chế độ định tuyến này đã được dùng để tính toán phản hồi.

Vị trí

Đóng gói vị trí (điểm địa lý và tiêu đề tùy chọn).

Trường
lat_lng

LatLng

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

Int32Value

Hướng la bàn liên kết với hướng cho phép lưu thông. Giá trị này dùng để chỉ định lề đường dùng để đón và trả xe. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định một tiêu đề đến hạn là hướng Bắc, 90 chỉ định một tiêu đề đến hạn hướng Đông, v.v. Bạn chỉ có thể sử dụng trường này cho các 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 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 nhẹ sang trái.
TURN_SHARP_LEFT Rẽ ngoặt sang trái.
UTURN_LEFT Vòng sang trái.
TURN_LEFT Rẽ trái.
TURN_SLIGHT_RIGHT Xoay nhẹ sang phải.
TURN_SHARP_RIGHT Rẽ ngoặt sang phải.
UTURN_RIGHT Vòng sang phải.
TURN_RIGHT Rẽ phải.
STRAIGHT Đi thẳng.
RAMP_LEFT Đi theo đoạn đường nối bên trái.
RAMP_RIGHT Đi theo đoạn đường nối bên phải.
MERGE Hợp nhất vào lưu lượng truy cập.
FORK_LEFT Rẽ trái.
FORK_RIGHT Chọn ngã ba bên phải.
FERRY Đi phà.
FERRY_TRAIN Đi tàu dẫn lên phà.
ROUNDABOUT_LEFT Rẽ trái tại đường vòng.
ROUNDABOUT_RIGHT Rẽ phải tại đường vòng.
Trường
maneuver

Maneuver

Trình bày hướng dẫn điều hướng cho chặng 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 thực hiện bước này.

Hình nhiều đường

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

Trường
Trường kết hợp polyline_type. Đóng gói loại hình nhiều đường. Giá trị mặc định là encrypted_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 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 tùy chọn 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 cách sử dụng nhiều điểm hơn OVERVIEW), nhưng sẽ tăng kích thước phản hồi. Hãy sử dụng giá trị này khi bạn cần chính xác hơn.
OVERVIEW Chỉ định một hình nhiều đường tổng quan – được tạo bằng một số ít đ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 sẽ có độ trễ yêu cầu thấp hơn so với việc sử dụng tuỳ chọn HIGH_QUALITY.

Tuyến đường

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

Trường
legs[]

RouteLeg

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

int32

Khoảng cách đi lại 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 đặt 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 có tính đến điều kiện giao thông.
static_duration

Duration

Thời gian di chuyển trên 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ể. Hình nhiều đường này sẽ là hình nhiều đường kết 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 cần xuất hiện khi hiện 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, thì trường này sẽ chứa thứ tự tối ưu của các điểm tham chiếu của trung gian. nếu không, trường này sẽ trống. Ví dụ: giả sử đầu vào là Origin: 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. Rồi 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 trung gian đầu tiên.

RouteLeg

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

Trường
distance_meters

int32

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

Duration

Khoảng thời gian cần thiết để di chuyển một chặng. 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 sẽ được tính toán có tính đến điều kiện giao thông.
static_duration

Duration

Thời gian di chuyển qua đoạn đường đó, được tính 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 đoạn đường này. Điều này bao gồm cả hình nhiều đường của mỗi step.
start_location

Location

Vị trí bắt đầu của chặng 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ặng 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 biểu thị các đoạn trong chặng này. Mỗi bước đại diện cho một lệnh điều hướng.
travel_advisory

RouteLegTravelAdvisory

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế khu vực giao thông, v.v. trên một 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 lệnh điều hướng. Chân tuyến đường được tạo thành từ các bước.

Trường
distance_meters

int32

Khoảng cách đi lại 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 thông 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 đi theo chỉ dẫn.
travel_advisory

RouteLegStepTravelAdvisory

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế khu vực giao thông đối với một chặng chân.

RouteLegStepTravelAdvisory

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế khu vực giao thông đối với một chặng chân.

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. Áp dụng trong trường hợp có lựa chọn ưu tiên về định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này 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 trước đó.

Ví dụ:

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

RouteLegTravelAdvisory

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế khu vực giao thông, v.v. trên một tuyến đường.

Trường
toll_info

TollInfo

Đóng gói thông tin về lệ phí cầu đường trên RouteLeg cụ thể. Trường này chỉ được điền sẵn nếu chúng tôi dự kiến sẽ có thu phí trên RouteLeg. Nếu bạn đặt trường này nhưng trường phụ giá_ước_tính không được điền thì chúng tôi dự kiến rằng đường đó có thu phí 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ó phí trên RouteLeg.
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. Áp dụng trong trường hợp có lựa chọn ưu tiên về định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng này bao phủ toàn bộ hình nhiều đường của RouteLg mà không chồng chéo nhau. Đ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 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

Trường
waypoint

Waypoint

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

RouteMatrixElement

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

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 từ 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 liệu có tìm thấy tuyến đường hay không. Không phụ thuộc vào trạng thái.
distance_meters

int32

Khoảng cách đi lại 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 đặt 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 có tính đến điều kiện giao thông.
static_duration

Duration

Thời gian di chuyển trên 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à phí cầu đường
fallback_info

FallbackInfo

Trong một số trường hợp khi máy chủ không thể tính toán tuyến đường bằng các lựa chọn ưu tiên đã cho cho cặp điểm đi/đích cụ thể này, máy chủ có thể quay lại sử dụng một 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 đường được trả về.

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Chỉ được dùng khi status của phần tử không OK.
ROUTE_EXISTS Đã tìm thấy một tuyến và điền thông tin tương ứng 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 tuyến đường, chẳng hạn như distance_meters hoặc duration, sẽ không được điền trong phần tử.

RouteMatrixOrigin

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

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 tuyến nà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.

Trường
avoid_tolls

bool

Chỉ định xem có tránh đường có thu phí cầu đường khi hợp lý hay không. Ưu tiên các tuyến đường không có đườ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. Ưu tiên những tuyến đường không có đườ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 hợp lý hay không. Ưu tiên các tuyến đường không dành cho việc đi lại bằng phà. Chỉ áp dụng cho các phương tiện đi lại DRIVE và TWO_WHEELER.
avoid_indoor

bool

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

VehicleInfo

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

TollPass

Đóng gói thông tin về phí cầu đường. Nếu thẻ thu phí cầu đường được cung cấp, API sẽ cố gắng trả về giá của 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à sẽ cố gắng trả lại giá bằng tiền mặt. Chỉ áp dụng cho phương tiện đi lại DRIVE và TWO_WHEELER.

RouteObjective

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

Trường
rate_card

RateCard

Mục tiêu Thẻ tỷ lệ.

RateCard

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

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 chi phí cầu đường trong tổng chi phí hay không.

MonetaryCost

Đóng gói chi phí được sử dụng trong bảng giá.

Trường
value

double

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

RouteTravelAdvisory

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế vùng lưu lượng truy cập, v.v.

Trường
toll_info

TollInfo

Đóng gói thông tin về lệ phí cầu đường trên Tuyến đường. Trường này chỉ được điền sẵn nếu chúng tôi dự kiến sẽ có thu phí trên Tuyến đường. Nếu bạn đặt trường này nhưng trường phụ giá_ước_tính không được điền thì chúng tôi dự kiến rằng đường đó có thu phí 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ẽ không thu phí trên Tuyến đườ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. Áp dụng trong trường hợp có lựa chọn ưu tiên về định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này bao phủ toàn bộ hình nhiều đường mà không chồng chéo nhau. Đ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 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ị được dùng để chỉ định phương thức đ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 Di chuyển bằng xe khách.
BICYCLE Di chuyển bằng xe đạp.
WALK Di chuyển bằng cách đi bộ.
TWO_WHEELER Xe hai bánh, có động cơ. Ví dụ: xe máy. Lưu ý rằng chế độ này khác với chế độ đi lại BICYCLE (bao gồm chế độ sử dụng năng lượng của con người).
TAXI

Đi bằng taxi được cấp phép, có thể cho phép xe di chuyển trên 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ì 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 nào. Giá trị mặc định là TRAFFIC_AWARE.
TRAFFIC_UNAWARE Tính toán các tuyến đường mà không tính đến điều kiện 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 tạo ra độ trễ thấp nhất.
TRAFFIC_AWARE Tính toán các tuyến đường có tính đến điều kiện giao thông. Trái ngược với TRAFFIC_AWARE_OPTIMAL, một số biện pháp tối ưu hoá được áp dụng để giảm đáng kể độ trễ.
TRAFFIC_AWARE_OPTIMAL Tính toán những tuyến đường có tính đến điều kiện giao thông mà không áp dụng hầu hết các biện pháp 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 độ lưu lượng truy cập trên đoạn tiếp giáp của hình nhiều đường hoặc lối đi. Cho trước một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên giá trị không), 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.

Trường
start_polyline_point_index

int32

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

int32

Chỉ số kết thúc của khoảng này trong hình nhiều đường. Trong JSON, khi chỉ mục là 0, trường có vẻ như không được điền sẵ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 chưa được sử dụng.
NORMAL Tốc độ bình thường, không phát hiện ùn tắc nhẹ.
SLOW Đã phát hiện thấy ùn tắc nhẹ, nhưng không có tình trạng tắc đường.
TRAFFIC_JAM Đã phát hiện tắc đường.

TollInfo

Đóng gói thông tin thu phí cầu đường trên Route hoặc trên RouteLeg.

Trường
estimated_price[]

Money

Số tiền phí cầu đường cho Tuyến đường hoặc RouteLeg tương ứng. Danh sách này chứa số tiền cho từng loại tiền tệ dự kiến sẽ được các trạm thu phí thu phí. 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 các khoản phí cầu đường trên thế giới mà chúng tôi hỗ trợ.

Enum
TOLL_PASS_UNSPECIFIED Không được sử dụng. Nếu bạn dùng giá trị này 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ụ thu phí cầu đường ở Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Một trong nhiều nhà cung cấp dịch vụ thu phí cầu đường ở Sydney. https://www.tollpay.com.au/
AU_LINKT Phí cầu đường trên toàn Úc. Xem thêm thông tin chi tiết tại https://www.linkt.com.au/.
AR_TELEPASE Phí cầu đường của Argentina. Xem thêm thông tin chi tiết tại https://telepase.com.ar
BR_AUTO_EXPRESO Phí cầu đường tại Brazil. Xem thêm thông tin tại https://www.autoexpreso.com
BR_CONECTCAR Phí cầu đường tại Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com.
BR_MOVE_MAIS Phí cầu đường tại Brazil. Xem thêm thông tin chi tiết tại https://movemais.com.
BR_PASSA_RAPIDO Phí cầu đường tại Brazil. Xem thêm thông tin chi tiết tại https://pasorapido.gob.do/
BR_SEM_PARAR Phí cầu đường tại Brazil. Xem thêm thông tin tại https://www.semparar.com.br.
BR_TAGGY Phí cầu đường tại Brazil. Xem thêm thông tin chi tiết tại https://taggy.com.br.
BR_VELOE Phí cầu đường tại Brazil. Xem thêm chi tiết tại https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD biên giới giữa Canada và Hoa Kỳ.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD biên giới giữa Canada và Hoa Kỳ.
CA_US_BLUE_WATER_EDGE_PASS Cửa khẩu từ Ontario, Canada đến Michigan, Hoa Kỳ.
CA_US_CONNEXION Cửa khẩu từ Ontario, Canada đến Michigan, Hoa Kỳ.
CA_US_NEXUS_CARD biên giới giữa Canada và 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 phí cầu đường. Tất cả thẻ điện tử qua ngân hàng đều được tính phí như nhau, nên bạn chỉ cần một giá trị enum. Ví dụ: Ngân hàng 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 Miễn trừ biển số tiểu bang của Ấn Độ, HP.
MX_TAG_IAVE Phí cầu đường ở Mexico.
MX_TAG_TELEVIA Công ty thu phí cầu đường Mexico. Một trong nhiều cơ sở lưu trú hoạt động tại Thành phố Mexico. Xem thêm thông tin chi tiết tại https://www.televia.com.mx.
MX_VIAPASS Phí cầu đường ở Mexico. Xem thêm thông tin 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 người lái xe 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 NY, Hoa Kỳ.
US_NY_EZPASSNY NY, 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 giá trị chỉ định đơn vị đo lường dùng trong màn hình.

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

VehicleEmissionType

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

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Chưa xác định loại khí thải. Giá trị 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 + điện).

VehicleInfo

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

Trường
emission_type

VehicleEmissionType

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

Waypoint

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

Trường
via

bool

Đánh dấu điểm tham chiếu này là một mốc quan trọng thay vì điểm dừng. Đối với mỗi điểm tham chiếu không qua 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 trên 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 cần dừng lại. Các điểm tham chiếu không khiến mục nhập được thêm vào mảng legs, nhưng chú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 không thành công nếu bạn đặt trường này trên các điểm tham chiếu của thiết bị đầu cuối. Nếu bạn đặt ComputeRoutesRequest.optimize_waypoint_order thành true, thì bạn sẽ không đặt được 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 điểm tham chiếu dành cho các phương tiện dừng lại khi bạn muốn đến lấy hàng hoặc trả xe. Khi bạn đặt giá trị này, tuyến đường đã tính toán sẽ không bao gồm các điểm tham chiếu không phải via trên những con đường không phù hợp để đón và trả xe. Lựa chọn này chỉ hoạt động cho các phương tiện đi lại DRIVE và TWO_WHEELER, và khi location_type là location.
side_of_road

bool

Cho biết rằng vị trí của điểm tham chiếu này được dành cho xe cộ ưu tiên dừng ở một bên đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí này để xe có thể dừng ở bên đường mà vị trí lệch về phía giữa đường. Tuỳ chọn này chỉ dùng được cho "DRIVE" và "TWO_WHEELER" phương tiện đi lại và khi thuộc tính "location_type" được đặt thành 'vị trí'.
Trường kết hợp location_type. Các cách khác nhau để thể hiện một vị trí. location_type chỉ có thể là một trong những trạng thái sau đây:
location

Location

Một điểm được chỉ định bằ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.