API Ưu tiên cho tuyến đường hiện chỉ có sẵn cho một số khách hàng. Liên hệ với bộ phận bán hàng để tìm hiểu thêm.

Trang này được dịch bởi Cloud Translation API.

Package google.maps.routes.v1

Chỉ mục

RoutesPreferred (giao diện)
ComputeCustomRoutesRequest (thông báo)
ComputeCustomRoutesResponse (thông báo)
ComputeCustomRoutesResponse.FallbackInfo (thông báo)
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective (enum)
ComputeRouteMatrixRequest (thông báo)
ComputeRoutesRequest (thông báo)
ComputeRoutesResponse (thông báo)
CustomRoute (thông báo)
FallbackInfo (thông báo)
FallbackReason (enum)
FallbackRoutingMode (enum)
Location (thông báo)
Maneuver (enum)
NavigationInstruction (thông báo)
Polyline (thông báo)
PolylineEncoding (enum)
PolylineQuality (enum)
Route (thông báo)
RouteLeg (thông báo)
RouteLegStep (thông báo)
RouteLegStepTravelAdvisory (thông báo)
RouteLegTravelAdvisory (thông báo)
RouteMatrixDestination (thông báo)
RouteMatrixElement (thông báo)
RouteMatrixElementCondition (enum)
RouteMatrixOrigin (thông báo)
RouteModifiers (thông báo)
RouteObjective (thông báo)
RouteObjective.RateCard (thông báo)
RouteObjective.RateCard.MonetaryCost (thông báo)
RouteTravelAdvisory (thông báo)
RouteTravelMode (enum)
RoutingPreference (enum)
SpeedReadingInterval (thông báo)
SpeedReadingInterval.Speed (enum)
TollInfo (thông báo)
TollPass (enum)
Units (enum)
VehicleEmissionType (enum)
VehicleInfo (thông báo)
Waypoint (thông báo)

RoutesPreferred

Routes Preferred API.

ComputeCustomRoutes

ComputeCustomRoutes
`rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)` Cho một tập hợp các điểm trung gian và điểm cuối cùng, cũng như một mục tiêu tuyến đường, hãy 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 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 này 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 giúp máy chủ của chúng tôi tiết kiệm được 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. 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 mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng. 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 bài viết Tổng quan về OAuth 2.0.

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Cho một tập hợp các điểm trung gian và điểm cuối cùng, cũng như một mục tiêu tuyến đường, hãy 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 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 này 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 giúp máy chủ của chúng tôi tiết kiệm được 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.
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 mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

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 bài viết Tổng quan về OAuth 2.0.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` Nhận danh sách các điểm xuất phát và điểm đến, sau đó 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à điểm đế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ạ 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 của thời lượng tuyến, khoảng cách, trạng thái phần tử, tình trạng và chỉ mục phần tử (ví dụ về chế độ thiết lập chính thức): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` Bạn cần phải đưa `status` vào mặt nạ trường, nếu không tất cả thông báo sẽ xuất hiện là OK. 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 mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng. 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 bài viết Tổng quan về OAuth 2.0.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Nhận danh sách các điểm xuất phát và điểm đến, sau đó 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à điểm đến.

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

Bạn cần phải đưa status vào mặt nạ trường, nếu không tất cả thông báo sẽ xuất hiện là OK. 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 mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

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 bài viết Tổng quan về OAuth 2.0.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` Trả về tuyến đường chính cùng với các tuyến đường thay thế không bắt buộc, dựa trên một tập hợp các điểm trung gian và điểm cuối. 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 của thời lượng, khoảng cách và đường đa tuyến ở cấp Tuyến (ví dụ về chế độ thiết lập 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 giúp máy chủ của chúng tôi tiết kiệm được 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. 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 mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng. 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 bài viết Tổng quan về OAuth 2.0.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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 của thời lượng, khoảng cách và đường đa tuyến ở cấp Tuyến (ví dụ về chế độ thiết lập 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 giúp máy chủ của chúng tôi tiết kiệm được 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.
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 mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

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 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 trung gian đến.
`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 trung gian.
`travel_mode`	`RouteTravelMode` Không bắt buộc. Chỉ định phương thức di chuyển. Chỉ hỗ trợ `DRIVE` và "TWO_WHEELER".
`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 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. 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 của đường đa tuyến.
`polyline_encoding`	`PolylineEncoding` Không bắt buộc. Chỉ định cách mã hoá ưu tiên cho đường đa tuyến.
`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 điểm bạn đưa ra 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 xem Mã nhận dạng ngôn ngữ Unicode. 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`. Giá trị này không ảnh hưởng đến các đơn vị đo lường được dùng cho tuyến đường, chặng đường, khoảng cách bước và thời lượng. Nếu bạn không cung cấp giá trị này, thì các đơ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:

Nếu không thể tính toán tuyến đường bằng routing_preference do khách hàng yêu cầu, thì ứng dụng sẽ chuyển sang một chế độ định tuyến khác. Trong trường hợp này, fallback_routing_mode và routing_mode_fallback_reason được dùng để thông báo chế độ định tuyến dự phòng được sử dụng, cũng như lý do sử dụng chế độ dự phòng.
Nếu không thể tính toán tuyến đường "tốt nhất" cho mục tiêu tuyến đường do khách hàng chỉ định, thì hệ thống có thể quay lại một mục tiêu khác. fallback_route_objective dùng để truyền đạt mục tiêu tuyến dự phòng.

Trường

Trường
`routing_mode`	`FallbackRoutingMode` Chế độ định tuyến được dùng cho phản hồi. Nếu chế độ 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 được đặt trong yêu cầu ban đầu của ứng dụng.
`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 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 phản hồ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.

routing_mode

FallbackRoutingMode

Chế độ định tuyến được dùng cho phản hồi. Nếu chế độ 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 được đặt trong yêu cầu ban đầu của ứng dụng.

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 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 phản hồ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 include_tolls thành true, đồng thời Google không có dữ liệu về giá đường thu phí cho tuyến đường đó, thì API sẽ quay lại `RateCard` mà không xem xét giá đường thu phí.

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 số lượng giá trị riêng biệt của nguồn và đích: Trong mọi trường hợp, số lượng phần tử (nguồn gốc × đích đến) không được vượt quá 625. Số lượng phần tử (nguồn gốc × đích đến) không được lớn hơn 100 nếu bạn đặt routing_preference thành `TRAFFIC_AWARE_OPTIMAL`. Số lượng điểm trung gian (điểm xuất phát + điểm đế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. Chỉ đị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ủ sẽ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến. Nếu lựa chọn ưu tiên định tuyến dẫn đến lỗi hoặc độ trễ quá lâu, thì hệ thống sẽ trả về lỗi. 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, giá trị mặc định sẽ là thời điểm 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, yêu cầu sẽ không thành công.

ComputeRoutesRequest

Tin nhắn 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 trung gian đến.
`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 trung gian.
`travel_mode`	`RouteTravelMode` Không bắt buộc. Chỉ định phương tiện giao thông.
`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 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 dẫn đến lỗi hoặc độ trễ quá dài, thì lỗi sẽ được trả về. 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 của đường đa tuyến.
`polyline_encoding`	`PolylineEncoding` Không bắt buộc. Chỉ định cách mã hoá ưu tiên cho đường đa tuyến.
`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 điểm bạn đưa ra 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` Không bắt buộc. Chỉ định xem có tính toán các tuyến thay thế ngoài tuyến đường hay không. Không có tuyến đường thay thế nào được trả về cho các yêu cầu có điểm trung gian.
`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 xem phần Giá trị nhận dạng ngôn ngữ Unicode. 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 trường `instruction` trong `NavigationInstruction`. Giá trị này không ảnh hưởng đến các đơn vị đo lường được dùng cho tuyến đường, chặng đường, khoảng cách bước và thời lượng. Nếu bạn không cung cấp giá trị này, thì các đơ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.optimized_intermediate_waypoint_index` để tìm thứ tự mới. Nếu bạn không yêu cầu `routes.optimized_intermediate_waypoint_index` trong tiêu đề `X-Goog-FieldMask`, yêu cầu sẽ không thành công. Nếu bạn đặt `optimize_waypoint_order` thành false, `ComputeRoutesResponse.optimized_intermediate_waypoint_index` sẽ trống.

ComputeRoutesResponse

Tính toán các tuyến đường của thông báo phản hồi.

Trường

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 không thể tính toán kết quả tuyến đường bằng tất cả các tuỳ chọn ưu tiên đầu vào, máy chủ có thể sử dụng một phương thức tính toán khác. Khi chế độ dự phòng được sử dụng, trường này sẽ 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.

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 không thể tính toán kết quả tuyến đường bằng tất cả các tuỳ chọn ưu tiên đầu vào, máy chủ có thể sử dụng một phương thức tính toán khác. Khi chế độ dự phòng được sử dụng, trường này sẽ 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 tuyến 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. Bạn có thể truyền các thông tin này đến NavSDK để tạo lại tuyến đường tuỳ chỉnh cho tính năng chỉ đường từng chặng.

Trường

Trường
`route`	`Route` Tuyến đường được coi là "tốt nhất" cho mục tiêu tuyến đường đầ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. Điều này 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, hãy tuân theo ý định ban đầu khi `RoutesPreferred` `ComputeCustomRoutes` được gọi. Khách hàng nên coi mã thông báo này là một blob mờ.

route

Route

Tuyến đường được coi là "tốt nhất" cho mục tiêu tuyến đường đầ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. Điều này 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, hãy tuân theo ý định ban đầu khi RoutesPreferred 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ì tức 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

Trường
`routing_mode`	`FallbackRoutingMode` Chế độ định tuyến được dùng cho phản hồi. Nếu chế độ 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 được đặt trong yêu cầu ban đầu của ứng dụng.
`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ề.

routing_mode

FallbackRoutingMode

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ủ khi tính toán các tuyến bằng chế độ định tuyến mà bạn ưu tiên, nhưng chúng tôi có thể trả về kết quả được tính bằng một 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ờ. Tuy nhiên, 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 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í

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

Trường

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 chỉ định lề đường sẽ sử dụng để nhận và trả xe. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định hướng đến là hướng Bắc, 90 chỉ định hướng đến theo 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`.

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 chỉ định lề đường sẽ sử dụng để nhận và trả xe. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định hướng đến là hướng Bắc, 90 chỉ định hướng đến theo 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 hành động điều hướng cần thực hiện cho bước hiện tại (ví dụ: rẽ trái, nhập hoặc đi thẳng).

Enum
`MANEUVER_UNSPECIFIED`	Không được sử dụng.
`TURN_SLIGHT_LEFT`	Rẽ nhẹ sang trái.
`TURN_SHARP_LEFT`	Rẽ trái đột ngột.
`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`	Rẽ phải rồi quay đầu.
`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 dốc 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 đến phà.
`ROUNDABOUT_LEFT`	Rẽ trái tại đường vòng.
`ROUNDABOUT_RIGHT`	Rẽ phải tại đường vòng.
`DEPART`	Thao tác ban đầu.
`NAME_CHANGE`	Dùng để biểu thị việc thay đổi tên đường phố.

NavigationInstruction

Trường

maneuver

Maneuver

Trình bày hướng dẫn di chuyển cho chặng hiện tại (ví dụ: rẽ trái, hợp nhất hoặc đi thẳng). 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 đa tuyến được mã hoá.

Trường

Trường
Trường hợp hợp nhất `polyline_type`. Đóng gói loại hình nhiều đường. Giá trị mặc định là encoded_polyline. `polyline_type` chỉ có thể là một trong những giá trị sau:
`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 đa tuyến bằng định dạng GeoJSON LineString.

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

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 đa tuyến 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`	Không chỉ định loại đường đa tuyến. 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 đa tuyến 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 đa tuyến.

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 đa tuyến chất lượng cao – được tạo bằng nhiều điểm hơn `OVERVIEW`, nhưng kích thước phản hồi sẽ tăng lên. 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 đa tuyến 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. Khi sử dụng tuỳ chọn này, độ trễ yêu cầu sẽ thấp hơn so với khi 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` Tập hợp các chặng (phân đoạn đường dẫn giữa các điểm trung gian) 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 trung gian chỉ có một chặng. Một tuyến đường có một điểm trung gian không phải `via` sẽ có hai chặng. Một tuyến đường có một điểm trung gian `via` sẽ có một chặng. 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 theo 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 của tuyến đường tổng thể. Hình nhiều đường này là hình nhiều đường kết hợp của tất cả `legs`.
`description`	`string` Nội dung mô tả tuyến đường.
`warnings[]`	`string` Một mảng cảnh báo sẽ hiển thị khi hiển thị tuyến đường.
`viewport`	`Viewport` Hộp giới hạn khung nhìn của đường đa tuyến.
`travel_advisory`	`RouteTravelAdvisory` Thông tin bổ sung về tuyến đường.
`optimized_intermediate_waypoint_index[]`	`int32` Nếu bạn đặt `ComputeRoutesRequest.optimize_waypoint_order` thành true, 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ử dữ liệu đầu vào là Origin: LA; Trung cấp: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm trung gian được tối ưu hoá là: Phoenix, Dallas, Bangor. Sau đó, trường này sẽ 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 trung gian không phải via.

Trường
`distance_meters`	`int32` Khoảng cách di chuyển của chặng đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để di chuyển chặng bay. 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 dựa trê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` Đường đa tuyến tổng thể cho chặng này. Điều này bao gồm cả đường đa tuyến 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. Giá trị này có thể khác với `destination` đã cung cấp. Ví dụ: khi `destination` được cung cấp không ở gần đường, thì đây là một điểm trên đường.
`steps[]`	`RouteLegStep` Một mảng các bước biểu thị các phân đoạn trong chặng này. Mỗi bước đại diện cho một hướng dẫn đ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ột bước tương ứng với một hướng dẫn điều hướng. Các chặng đường bao gồm 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` Đường đa tuyến 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` Đóng gói thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như quy định hạn chế có thể có đối với khu vực giao thông trên một bước đi.

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

Trường
`speed_reading_intervals[]`	`SpeedReadingInterval` LƯU Ý: Trường này hiện chưa được điền sẵn.

speed_reading_intervals[]

SpeedReadingInterval

LƯU Ý: Trường này hiện chưa được điền sẵn.

RouteLegTravelAdvisory

Đóng gói thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như quy định hạn chế có thể có đối với khu vực giao thông, v.v. trên một chặng đường.

Trường

Trường
`toll_info`	`TollInfo` Trình bày thông tin về phí cầu đường trên `RouteLeg` cụ thể. Trường này chỉ được điền nếu chúng tôi dự kiến có đường thu phí trên `RouteLeg`. Nếu bạn đặt trường này nhưng trường phụ `estimated_price` 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 nhanh nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn ưu tiên định tuyến `TRAFFIC_AWARE` và `TRAFFIC_AWARE_OPTIMAL`. Các khoảng này bao gồm toàn bộ hình nhiều đường của `RouteLeg` 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).`

toll_info

TollInfo

Trình bày thông tin về phí cầu đường trên RouteLeg cụ thể. Trường này chỉ được điền nếu chúng tôi dự kiến có đường thu phí trên RouteLeg. Nếu bạn đặt trường này nhưng trường phụ estimated_price 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 nhanh nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn ưu tiên định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng này bao gồm toàn bộ hình nhiều đường của RouteLeg 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

Trường
`waypoint`	`Waypoint` Bắt buộc. Điểm tham chiếu đích

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 một cặp điểm xuất phát/điểm đến trong API ComputeRouteMatrix. Bạn có thể truyền trực tuyến proto này đến ứng dụng.

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 số 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` Quãng đường đi của tuyến đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để đi theo 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à thông tin về đường thu phí
`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 đường 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 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

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 đường lấy giá trị này làm gốc

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 đường lấy giá trị này làm 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` Khi được đặt thành đúng, chế độ này sẽ tránh các đường có thu phí khi hợp lý, ưu tiên các tuyến không chứa đường có thu phí. Chỉ áp dụng cho các chế độ đi lại `DRIVE` và `TWO_WHEELER`.
`avoid_highways`	`bool` Khi bạn đặt chính sách này thành true, hãy tránh đường cao tốc khi hợp lý, ưu tiên các tuyến đường không chứa đường cao tốc. Chỉ áp dụng cho các chế độ đi lại `DRIVE` và `TWO_WHEELER`.
`avoid_ferries`	`bool` Khi bạn đặt chính sách này thành true, hãy tránh phà khi hợp lý, ưu tiên các tuyến đường không chứa phà. Chỉ áp dụng cho các chế độ đi lại `DRIVE` và`TWO_WHEELER`.
`avoid_indoor`	`bool` Khi bạn đặt chính sách này thành true, hãy tránh điều hướng trong nhà khi thích hợp, ưu tiên các tuyến đường không chứa điều hướng trong nhà. Chỉ áp dụng cho chế độ đi lại `WALK`.
`vehicle_info`	`VehicleInfo` Nêu rõ thông tin về xe.
`toll_passes[]`	`TollPass` Bao gồm thông tin về thẻ thu phí. Nếu bạn cung cấp thẻ thu phí, API sẽ cố gắng trả về giá của thẻ đó. Nếu bạn không cung cấp thẻ thu phí, API sẽ coi thẻ thu phí là không xác định và cố gắng trả về giá bằng tiền mặt. Chỉ áp dụng cho các 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á theo ComputeCustomRoutes.

Trường

Trường
Trường kết hợp `objective`. Mục tiêu tuyến đường. `objective` chỉ có thể là một trong những giá trị sau:
`rate_card`	`RateCard` Mục tiêu Thẻ tỷ lệ.

Trường kết hợp objective. Mục tiêu tuyến đường. objective chỉ có thể là một trong những giá trị sau:

rate_card

RateCard

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

RateCard

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

Trường

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.

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 thẻ giá.

Trường

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.

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ế lưu lượng truy cập theo vùng, v.v.

Trường

Trường
`toll_info`	`TollInfo` Bao gồm thông tin về 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ụ `estimated_price` 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 lựa chọn ưu tiên định tuyến `TRAFFIC_AWARE` và `TRAFFIC_AWARE_OPTIMAL`. Các khoảng thời gian này bao phủ toàn bộ đường đa tuyến của tuyến đường mà không bị chồng chéo. Điểm bắt đầu của một 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).`

toll_info

TollInfo

Bao gồm thông tin về 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ụ estimated_price 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 lựa chọn ưu tiên định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này bao phủ toàn bộ đường đa tuyến của tuyến đường mà không bị chồng chéo. Điểm bắt đầu của một 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 thức di chuyển.

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`	Đi bộ.
`TWO_WHEELER`	Xe hai bánh, có động cơ. Ví dụ: xe máy. Xin lưu ý rằng phương thức này khác với phương thức đi lại `BICYCLE` bao gồm cả phương thức đi bộ.
`TAXI`	Đi bằng taxi được cấp phép, có thể cho phép xe đi trên làn đường dành riêng cho taxi ở 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 TAXI ở một thành phố không có dữ liệu về làn đường dành cho taxi, thì hệ thống sẽ trả về tuyến ĐI XE.

RoutingPreference

Một tập hợp các 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 xem xét tình trạng giao thông trực tiếp. Phù hợp khi tình trạng giao thông không quan trọng hoặc không áp dụng được. Việc sử dụng giá trị này sẽ tạo ra độ trễ thấp nhất. Lưu ý: Đối với `RouteTravelMode` DRIVE và TWO_WHEELER, tuyến đường và thời gian đi đã chọn sẽ dựa trên mạng lưới đường và tình trạng giao thông trung bình không phụ thuộc vào thời gian, chứ không phải tình trạng đường hiện tại. Do đó, các tuyến đường có thể bao gồm các đường đang tạm thời bị đóng. Kết quả cho một yêu cầu nhất định có thể thay đổi theo thời gian do những thay đổi về mạng lưới đường bộ, tình trạng giao thông trung bình đã cập nhật và tính chất phân tán của dịch vụ. Kết quả cũng có thể khác nhau giữa các tuyến gần tương đương bất cứ lúc nào hoặc theo tần suất.
`TRAFFIC_AWARE`	Tính toán các tuyến đường có tính đến tình trạng giao thông. Ngược lại 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. Với 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 một khoảng thời gian và mô tả lưu lượng truy cập của khoảng thời gian đó bằng các danh mục sau.

Trường

Trường
`start_polyline_point_index`	`int32` Chỉ mục bắt đầu của khoảng thời gian này trong đường đa tuyến. Trong JSON, khi chỉ mục là 0, trường này 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.

start_polyline_point_index

int32

Chỉ mục bắt đầu của khoảng thời gian này trong đường đa tuyến. Trong JSON, khi chỉ mục là 0, trường này 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 độ của đường đa tuyến dựa trên dữ liệu lưu lượng truy cập.

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 ù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

Trường
`estimated_price[]`	`Money` Số tiền phí cầu đường cho `Route` 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 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.

estimated_price[]

Money

Số tiền phí cầu đường cho Route 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 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 sử dụng giá trị này, 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 thẻ thu phí ở Sydney. https://www.tollpay.com.au/
`AU_LINKT`	Thẻ thu phí trên toàn Úc. Xem thêm thông tin chi tiết tại https://www.linkt.com.au/.
`AR_TELEPASE`	Thẻ thu 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`	Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com.
`BR_MOVE_MAIS`	Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://movemais.com.
`BR_PASSA_RAPIDO`	Thẻ thu phí cầu đường của 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 chi tiết 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 thông tin chi tiết tại https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	Cửa khẩu Canada đến Hoa Kỳ.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Cửa khẩu Canada đến Hoa Kỳ.
`CA_US_BLUE_WATER_EDGE_PASS`	Cửa khẩu Ontario, Canada đến Michigan, Hoa Kỳ.
`CA_US_CONNEXION`	Cửa khẩu Ontario, Canada đến Michigan, Hoa Kỳ.
`CA_US_NEXUS_CARD`	Cửa khẩu Canada đến 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.
`JP_ETC`	Nhật Bản ETC. Hệ thống không dây điện tử để thu phí. https://www.go-etc.jp/
`JP_ETC2`	Nhật Bản ETC2.0. Phiên bản ETC mới được giảm giá nhiều hơn và khả năng giao tiếp hai chiều giữa thiết bị trên xe và ăng-ten trên đường. https://www.go-etc.jp/etc2/index.html
`MX_IAVE`	Mexico https://iave.capufe.gob.mx/#/
`MX_PASE`	Mexico https://www.pase.com.mx
`MX_QUICKPASS`	Mexico https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	Mexico http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	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 tại https://www.televia.com.mx.
`MX_TELEVIA`	Công ty thu phí cầu đường ở Mexico. Một trong nhiều đài truyền hình hoạt động ở Thành phố Mexico. 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`	Alaska, Hoa Kỳ.
`US_CA_FASTRAK`	CA, Hoa Kỳ.
`US_CA_FASTRAK_CAV_STICKER`	Cho biết người lái xe có thẻ FasTrak bất kỳ ngoài nhãn 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`	Florida, Hoa Kỳ.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	Florida, Hoa Kỳ.
`US_FL_EPASS`	Florida, Hoa Kỳ.
`US_FL_GIBA_TOLL_PASS`	Florida, Hoa Kỳ.
`US_FL_LEEWAY`	Florida, Hoa Kỳ.
`US_FL_SUNPASS`	Florida, Hoa Kỳ.
`US_FL_SUNPASS_PRO`	Florida, 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_KY_RIVERLINK`	KY, Hoa Kỳ.
`US_LA_GEAUXPASS`	LA, Hoa Kỳ.
`US_LA_TOLL_TAG`	Los Angeles, Hoa Kỳ.
`US_MA_EZPASSMA`	MA, Hoa Kỳ.
`US_MD_EZPASSMD`	MD, Hoa Kỳ.
`US_ME_EZPASSME`	Maine, Hoa Kỳ.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	MI, Hoa Kỳ.
`US_MI_BCPASS`	MI, Hoa Kỳ.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI, Hoa Kỳ.
`US_MI_IQ_PROX_CARD`	MI, Hoa Kỳ. Không còn được dùng nữa vì loại thẻ và vé này không còn tồn tại. Mục này không còn được dùng nữa!
`US_MI_IQ_TAG`	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`	Bắc Carolina, Hoa Kỳ.
`US_NC_QUICK_PASS`	Bắc Carolina, 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`	New York, Hoa Kỳ.
`US_OH_EZPASSOH`	OH, Hoa Kỳ.
`US_PA_EZPASSPA`	Pennsylvania, Hoa Kỳ.
`US_RI_EZPASSRI`	RI, Hoa Kỳ.
`US_SC_PALPASS`	SC, Hoa Kỳ.
`US_TX_AVI_TAG`	TX, 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_FUEGO_TAG`	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`	Virginia, 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`	West Virginia, Hoa Kỳ.
`US_WV_MOV_PASS`	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`	Chưa chỉ định đơn vị đo lường. Mặc định là đơn vị đo lường được suy ra từ yêu cầu.
`METRIC`	Đơn vị đo lường hệ mét.
`IMPERIAL`	Đơn vị đo lường theo hệ 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 chạy bằ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ư loại khí thải của xe.

Trường

Trường
`emission_type`	`VehicleEmissionType` Mô tả loại khí thải của xe. Chỉ áp dụng cho `DRIVE` `RouteTravelMode`.

emission_type

VehicleEmissionType

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

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 trung gian không phải là điểm trung gian trong yêu cầu, phản hồi sẽ thêm một mục vào mảng `legs` để cung cấp thông tin chi tiết về điểm dừng chân 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 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 `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 các phương tiện dừng lại khi bạn muốn nhận xe 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 thuộc `via` trên những con đường không phù hợp để đón và trả khách. Lựa chọn này chỉ áp dụng cho phương tiện đ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 trung gian này là để xe 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í đó để xe có thể dừng ở bên đường mà vị trí đó nghiêng về phía trung tâm đường. Lựa chọn này chỉ dành cho các phương tiện đi lại "DRIVE" và "TWO_WHEELER".
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.