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.

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

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)` Với một tập hợp các điểm tham chiếu cuối và điểm tham chiếu trung gian, cùng với mục tiêu của tuyến đường, hãy tính toán tuyến đường tốt nhất cho mục tiêu đó. Cũng trả về tuyến đường nhanh nhất và tuyến đường ngắn nhất làm tuyến đường 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 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. 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ạ cho trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công): `X-Goog-FieldMask: ` Mặt nạ cho trường (field mask) của khoảng cách, thời lượng, mã thông báo và thông tin về phí cầu đường của tuyến đườ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ạ cho trường phản hồi ký tự đại diện (``) hoặc chỉ định mặt nạ cho trường ở cấp cao nhất (`routes`), vì: Việc chỉ chọn những trường bạn cần giúp máy chủ của chúng tôi tiết kiệm cá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. Việc chỉ chọn những trường bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn 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 chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi. Chỉ chọn những trường mà bạn cần sẽ giúp giảm kích thước phản hồi, từ đó tăng thông lượ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)

Với một tập hợp các điểm tham chiếu cuối và điểm tham chiếu trung gian, cùng với mục tiêu của tuyến đường, hãy tính toán tuyến đường tốt nhất cho mục tiêu đó. Cũng trả về tuyến đường nhanh nhất và tuyến đường ngắn nhất làm tuyến đường 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 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. 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ạ cho trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
Mặt nạ cho trường (field mask) của khoảng cách, thời lượng, mã thông báo và thông tin về phí cầu đường của tuyến đườ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ạ cho trường phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ cho trường ở cấp cao nhất (routes), vì:

Việc chỉ chọn những trường bạn cần giúp máy chủ của chúng tôi tiết kiệm cá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.
Việc chỉ chọn những trường bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn 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 chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi.
Chỉ chọn những trường mà bạn cần sẽ giúp giảm kích thước phản hồi, từ đó tăng thông lượ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 khởi hành và điểm đến, đồng thời trả về một luồng chứa thông tin về tuyến đường cho từng tổ hợp điểm khởi hành và điểm đế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 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. 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ạ cho trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công): `X-Goog-FieldMask: ` Mặt nạ trường của thời lượng, khoảng cách, trạng thái, điều kiện và chỉ mục phần tử của tuyến đường (ví dụ về chế độ thiết lập sản xuất): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` Bạn cần phải thêm `status` vào mặt nạ trường, nếu không tất cả thông báo sẽ có vẻ như đều ổ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 giúp máy chủ của chúng tôi tiết kiệm cá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. Việc chỉ chọn những trường bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn 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 chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi. Chỉ chọn những trường mà bạn cần sẽ giúp giảm kích thước phản hồi, từ đó tăng thông lượ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 khởi hành và điểm đến, đồng thời trả về một luồng chứa thông tin về tuyến đường cho từng tổ hợp điểm khởi hành và điểm đến.

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

Mặt nạ cho trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
Mặt nạ trường của thời lượng, khoảng cách, trạng thái, điều kiện và chỉ mục phần tử của tuyến đường (ví dụ về chế độ thiết lập sản xuất): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Bạn cần phải thêm status vào mặt nạ trường, nếu không tất cả thông báo sẽ có vẻ như đều ổ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 giúp máy chủ của chúng tôi tiết kiệm cá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.
Việc chỉ chọn những trường bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn 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 chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi.
Chỉ chọn những trường mà bạn cần sẽ giúp giảm kích thước phản hồi, từ đó tăng thông lượ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 nhóm điểm tham chiếu cuối và điểm tham chiếu trung gian. LƯU Ý: Phương thức này yêu cầu bạn chỉ định một 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 hiện có. 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ạ cho trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công): `X-Goog-FieldMask: ` Mặt nạ cho trường (field mask) của thời lượng, khoảng cách và đường đa tuyến ở cấp tuyến đường (ví dụ về chế độ thiết lập sản xuất): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google không khuyến khích việc sử dụng mặt nạ cho trường phản hồi ký tự đại diện (``) hoặc chỉ định mặt nạ cho trường ở cấp cao nhất (`routes`), vì: Việc chỉ chọn những trường bạn cần giúp máy chủ của chúng tôi tiết kiệm cá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. Việc chỉ chọn những trường bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn 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 chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi. Chỉ chọn những trường mà bạn cần sẽ giúp giảm kích thước phản hồi, từ đó tăng thông lượ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 nhóm điểm tham chiếu cuối và điểm tham chiếu trung gian.

LƯU Ý: Phương thức này yêu cầu bạn chỉ định một 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 hiện có. 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ạ cho trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
Mặt nạ cho trường (field mask) của thời lượng, khoảng cách và đường đa tuyến ở cấp tuyến đường (ví dụ về chế độ thiết lập sản xuất): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

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

Việc chỉ chọn những trường bạn cần giúp máy chủ của chúng tôi tiết kiệm cá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.
Việc chỉ chọn những trường bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn 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 chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi.
Chỉ chọn những trường mà bạn cần sẽ giúp giảm kích thước phản hồi, từ đó tăng thông lượ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 tham chiếu trên đường đi.
`intermediates[]`	`Waypoint` Không bắt buộc. Một nhóm điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng lại hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
`travel_mode`	`RouteTravelMode` Không bắt buộc. Chỉ định phương tiện giao thông. 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 về đị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 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 lựa 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 nhiều đoạn.
`polyline_encoding`	`PolylineEncoding` Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho đường nhiều đoạn.
`departure_time`	`Timestamp` Không bắt buộc. Giờ khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời gian bạn đưa ra yêu cầu. Nếu bạn đặt giá trị này thành một 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 nhóm các điều kiện cần đáp ứng ảnh hưởng đến cách tính toán tuyến đường.
`route_objective`	`RouteObjective` Bắt buộc. Mục tiêu của tuyến đường cần tối ưu hoá.
`language_code`	`string` Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem bài viết Mã nhận dạng ngôn ngữ theo chuẩn 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 về tuyến đường.
`units`	`Units` Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Điều này bao gồm trường `instruction` trong `NavigationInstruction`. Giá trị này không ảnh hưởng đến đơn vị đo lường được dùng cho tuyến đường, đoạn đường, khoảng cách và thời lượng của bước. Nếu bạn không cung cấp giá trị này, thì các đơn vị hiển thị sẽ được suy luận từ vị trí của yêu cầu.

ComputeCustomRoutesResponse

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

Trường
`routes[]`	`CustomRoute` Tuyến đường "tốt nhất" cho mục tiêu tuyến đường đầu vào.
`fastest_route`	`CustomRoute` Tuyến đường tham khảo nhanh nhất.
`shortest_route`	`CustomRoute` Tuyến đường tham khảo ngắn nhất.
`fallback_info`	`FallbackInfo` Thông tin dự phòng cho các tuyến đường 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ì hệ thố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 để truyền đạt chế độ định tuyến dự phòng được sử dụng, cũng như lý do 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ể chuyển sang một mục tiêu khác. fallback_route_objective được dùng để truyền đạt mục tiêu của tuyến đường dự phòng.

Trường

Trường
`routing_mode`	`FallbackRoutingMode` Chế độ định tuyến được dùng cho câu trả lờ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 về định tuyến được đặt trong yêu cầu ban đầu của ứng dụng.
`routing_mode_reason`	`FallbackReason` Lý do khiến câu trả lời dự phòng được dùng thay vì câu trả lờ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 của tuyến đường được dùng cho câu trả lời. Nếu kích hoạt phương án dự phòng, mục tiêu có thể khác với mục tiêu của tuyến đường được cung cấp trong yêu cầu ban đầu của ứng dụng.

routing_mode

FallbackRoutingMode

Chế độ định tuyến được dùng cho câu trả lờ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 về định tuyến được đặt trong yêu cầu ban đầu của ứng dụng.

routing_mode_reason

FallbackReason

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

FallbackRouteObjective

RouteObjective được dùng cho câu trả lời.

Enum
`FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED`	Chưa chỉ định mục tiêu của tuyến đường 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á vé cầu đường cho tuyến đường, thì API sẽ quay lại `RateCard` mà không xem xét giá vé 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, xác định các hàng của ma trận phản hồi. Một số 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: Số lượng phần tử (điểm xuất phát × điểm đến) không được lớn hơn 625 trong mọi trường hợp. Số lượng phần tử (điểm xuất phát × điểm đến) không được lớn hơn 100 nếu routing_preference được đặt thành `TRAFFIC_AWARE_OPTIMAL`. Số lượng điểm tham chiếu (đ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 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 về đị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ì sẽ trả về lỗi. Bạn chỉ có thể chỉ định lựa 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. Giờ khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời gian bạn đưa ra yêu cầu. Nếu bạn đặt giá trị này thành một thời điểm đã xảy ra, thì yêu cầu sẽ không thành công.

ComputeRoutesRequest

ComputeRoutes tin nhắn yêu cầu.

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 trên đường đi.
`intermediates[]`	`Waypoint` Không bắt buộc. Một nhóm điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng lại hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
`travel_mode`	`RouteTravelMode` Không bắt buộc. 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 về đị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 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 lựa 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 nhiều đoạn.
`polyline_encoding`	`PolylineEncoding` Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho đường nhiều đoạn.
`departure_time`	`Timestamp` Không bắt buộc. Giờ khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời gian bạn đưa ra yêu cầu. Nếu bạn đặt giá trị này thành một 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 đường 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 tham chiếu trung gian.
`route_modifiers`	`RouteModifiers` Không bắt buộc. Một nhóm các điều kiện cần đáp ứng ảnh hưởng đến cách tính toán 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 bài viết Mã nhận dạng ngôn ngữ theo chuẩn 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 về tuyến đường.
`units`	`Units` Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Điều này bao gồm trường `instruction` trong `NavigationInstruction`. Giá trị này không ảnh hưởng đến đơn vị đo lường được dùng cho tuyến đường, đoạn đường, khoảng cách và thời lượng của bước. Nếu bạn không cung cấp giá trị này, thì các đơn vị hiển thị sẽ được suy luận từ vị trí của yêu cầu.
`optimize_waypoint_order`	`bool` Nếu bạn đặt optimizeWaypointOrder thành true, hệ thống sẽ cố gắng sắp xếp lại các điểm tham chiếu trung gian đã chỉ định để giảm thiểu tổng chi phí của tuyến đường. Nếu có bất kỳ điểm tham chiếu trung gian nào là đ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 `routes.optimized_intermediate_waypoint_index` không được yêu cầu trong tiêu đề `X-Goog-FieldMask`, thì yêu cầu sẽ không thành công. Nếu `optimize_waypoint_order` được đặt thành false, `ComputeRoutesResponse.optimized_intermediate_waypoint_index` sẽ trống.

ComputeRoutesResponse

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

Trường

Trường
`routes[]`	`Route` Chứa một mảng các tuyến đường đã tính toán (tối đa 3) khi bạn chỉ định `compute_alternatives_routes` và chỉ chứa một tuyến đường khi bạn không chỉ định. Khi mảng này chứa nhiều mục, mục đầu tiên là tuyến đường được đề xuất nhiều nhất. Nếu mảng này trống, tức là không tìm thấy tuyến đường 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ả về 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ể chuyển sang sử dụng một cách tính toán khác. Khi chế độ dự phòng được dù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.

routes[]

Route

Chứa một mảng các tuyến đường đã tính toán (tối đa 3) khi bạn chỉ định compute_alternatives_routes và chỉ chứa một tuyến đường khi bạn không chỉ định. Khi mảng này chứa nhiều mục, mục đầu tiên là tuyến đường được đề xuất nhiều nhất. Nếu mảng này trống, tức là không tìm thấy tuyến đường 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ả về 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ể chuyển sang sử dụng một cách tính toán khác. Khi chế độ dự phòng được dùng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.

CustomRoute

Đóng gói một tuyến đường tuỳ chỉnh được tính toán dựa trên mục tiêu của tuyến đường do khách hàng chỉ định. CustomRoute chứa một tuyến đường và mã thông báo tuyến đường. Bạn có thể truyền mã thông báo này đến NavSDK để tạo lại tuyến đường tuỳ chỉnh cho chế độ 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 trên web có thể được truyền đến NavSDK, cho phép NavSDK tái tạo tuyến đường trong quá trình điều hướng và trong trường hợp định tuyến lại, hãy tôn trọng ý đị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 trên web có thể được truyền đến NavSDK, cho phép NavSDK tái tạo tuyến đường trong quá trình điều hướng và trong trường hợp định tuyến lại, hãy tôn trọng ý đị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, tức là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ bạn muốn làm chế độ dự phòng.

Trường

Trường
`routing_mode`	`FallbackRoutingMode` Chế độ định tuyến được dùng cho câu trả lờ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 về định tuyến được đặt trong yêu cầu ban đầu của ứng dụng.
`reason`	`FallbackReason` Lý do khiến câu trả lời dự phòng được dùng thay vì câu trả lờ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

FallbackReason

Lý do sử dụng câu trả lời dự phòng.

Enum
`FALLBACK_REASON_UNSPECIFIED`	Không 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 đường 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 toán bằng một chế độ thay thế.
`LATENCY_EXCEEDED`	Chúng tôi không thể hoàn tất việc tính toán với chế độ định tuyến mà bạn ưu tiên đúng thời gian, nhưng chúng tôi có thể trả về kết quả được tính toán bằng một chế độ khác.

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.

Thông tin vị trí

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

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 quan đến hướng lưu lượng truy cập. Giá trị này chỉ định phía đường cần sử dụng để đón và trả khách. Giá trị hướng có thể từ 0 đến 360, trong đó 0 chỉ định hướng Bắc, 90 chỉ định hướng Đông, v.v. Bạn chỉ có thể sử dụng trường này cho chế độ di chuyển `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 quan đến hướng lưu lượng truy cập. Giá trị này chỉ định phía đường cần sử dụng để đón và trả khách. Giá trị hướng có thể từ 0 đến 360, trong đó 0 chỉ định hướng Bắc, 90 chỉ định hướng Đông, v.v. Bạn chỉ có thể sử dụng trường này cho chế độ di chuyển DRIVE và TWO_WHEELER.

Maneuver

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

Enum
`MANEUVER_UNSPECIFIED`	Không được sử dụng.
`TURN_SLIGHT_LEFT`	Rẽ chếch sang trái.
`TURN_SHARP_LEFT`	Rẽ trái đột ngột.
`UTURN_LEFT`	Quay đầu xe sang trái.
`TURN_LEFT`	Rẽ trái.
`TURN_SLIGHT_RIGHT`	Rẽ chếch sang phải.
`TURN_SHARP_RIGHT`	Rẽ ngoặt sang phải.
`UTURN_RIGHT`	Quay đầu xe sang phải.
`TURN_RIGHT`	Rẽ phải.
`STRAIGHT`	Đi thẳng.
`RAMP_LEFT`	Đi theo đường dẫn bên trái.
`RAMP_RIGHT`	Đi theo đường dẫn bên phải.
`MERGE`	Nhập vào dòng xe.
`FORK_LEFT`	Đi theo ngã rẽ bên trái.
`FORK_RIGHT`	Đi theo ngã rẽ bên phải.
`FERRY`	Đi phà.
`FERRY_TRAIN`	Đi tàu để lên phà.
`ROUNDABOUT_LEFT`	Rẽ trái tại vòng xuyến.
`ROUNDABOUT_RIGHT`	Đến vòng xuyến, hãy rẽ phải.
`DEPART`	Thao tác ban đầu.
`NAME_CHANGE`	Dùng để cho biết việc đổi tên đường.
`DESTINATION`	Dùng để cho biết thời điểm đến một điểm đến.

NavigationInstruction

Trường

maneuver

Maneuver

Đóng gói chỉ dẫn điều hướng cho bước 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 cần hiển thị.

instructions

string

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

Hình nhiều đường

Đóng gói một đường nhiều đoạn được mã hoá.

Trường

Trường
Trường nhóm `polyline_type`. Đóng gói loại đường nhiều đoạn. Giá trị mặc định là encoded_polyline. `polyline_type` chỉ có thể là một trong những trạng thái sau:
`encoded_polyline`	`string` Chuỗi mã hoá của đường nhiều đoạn bằng thuật toán mã hoá đường nhiều đoạn.
`geo_json_linestring`	`Struct` Chỉ định một đường nhiều đoạn bằng định dạng GeoJSON LineString.

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

encoded_polyline

string

Chuỗi mã hoá của đường nhiều đoạn bằng thuật toán mã hoá đường nhiều đoạn.

geo_json_linestring

Struct

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

PolylineEncoding

Chỉ định loại đường nhiều đoạn ưu tiên sẽ được trả về.

Enum
`POLYLINE_ENCODING_UNSPECIFIED`	Không chỉ định lựa chọn ưu tiên về loại đường nhiều đoạn. Giá trị mặc định là `ENCODED_POLYLINE`.
`ENCODED_POLYLINE`	Chỉ định một đường nhiều đoạn được mã hoá bằng thuật toán mã hoá đường nhiều đoạn.
`GEO_JSON_LINESTRING`	Chỉ định một đường nhiều đoạ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 đường nhiều đoạn.

Enum
`POLYLINE_QUALITY_UNSPECIFIED`	Không chỉ định lựa chọn ưu tiên về chất lượng đường nhiều đoạn. Giá trị mặc định là `OVERVIEW`.
`HIGH_QUALITY`	Chỉ định một đường nhiều đoạn có chất lượng cao – được tạo thành từ nhiều điểm hơn `OVERVIEW`, với chi phí là kích thước phản hồi tăng lên. Hãy sử dụng giá trị này khi bạn cần độ chính xác cao hơn.
`OVERVIEW`	Chỉ định một đường nhiều đoạn tổng quan, được tạo thành từ 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 lựa chọn này, độ trễ yêu cầu sẽ thấp hơn so với khi sử dụng lựa chọn `HIGH_QUALITY`.

Tuyến đường

Đóng gói một tuyến đường, bao gồm một chuỗi các đoạn đường được kết nối với nhau, nối các điểm bắt đầu, điểm kết thúc và điểm tham chiếu trung gian.

Trường
`legs[]`	`RouteLeg` Một tập hợp các đoạn đường (đoạn đường 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 2 Điểm tham chiếu không phải `via`. Ví dụ: một tuyến đường không có điểm tham chiếu trung gian chỉ có một đoạn đường. Một tuyến đường có một điểm tham chiếu trung gian không phải `via` sẽ có hai chặng. Một tuyến đường có một điểm tham chiếu trung gian `via` sẽ có một chặng. Thứ tự của các chặng trùng khớp với thứ tự của các Điểm tham chiếu từ `origin` đến `intermediates` rồi đến `destination`.
`distance_meters`	`int32` Quãng đường di chuyển 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 tình trạng 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ể của tuyến đường. Đường nhiều đoạn này là đường nhiều đoạn 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ác cảnh báo sẽ xuất hiện khi hiển thị tuyến đường.
`viewport`	`Viewport` Hộp bao quanh khung nhìn của hình nhiều đường.
`travel_advisory`	`RouteTravelAdvisory` Thông tin bổ sung về tuyến đường.
`optimized_intermediate_waypoint_index[]`	`int32` Nếu `ComputeRoutesRequest.optimize_waypoint_order` được đặt thành true, trường này sẽ chứa thứ tự tối ưu của các điểm tham chiếu trung gian. Nếu không, trường này sẽ trống. Ví dụ: giả sử thông tin đầu vào là Điểm khởi hành: Los Angeles; Điểm dừng chân trung gian: 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. 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 tham chiếu trung gian đầu tiên.

RouteLeg

Đóng gói một đoạn đường giữa các điểm đánh dấu không phải là via.

Trường
`distance_meters`	`int32` Quãng đường di chuyển của đoạn đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để di chuyển trên đoạn đường. Nếu `route_preference` được đặt thành `TRAFFIC_UNAWARE`, thì giá trị này sẽ giống với `static_duration`. Nếu `route_preference` là `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`, thì giá trị này được tính có tính đến tình trạng giao thông.
`static_duration`	`Duration` Thời lượng di chuyển qua chặng đường, được tính mà không xem xét tình trạng giao thông.
`polyline`	`Polyline` Đường nhiều đoạn tổng thể cho chặng này. Điều này bao gồm đường nhiều đoạn của từng `step`.
`start_location`	`Location` Vị trí bắt đầu của chặng này. Giá trị này có thể khác với `origin` mà bạn cung cấp. Ví dụ: khi `origin` được cung cấp không nằm gần đườ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` mà bạn cung cấp. Ví dụ: khi `destination` được cung cấp không nằm 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 đoạn trong chặng này. Mỗi bước đại diện cho một chỉ dẫn điều hướng.
`travel_advisory`	`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ư các hạn chế có thể có về vùng giao thông, v.v. trên một đoạ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 chỉ dẫn điều hướng duy nhất. Các đoạn đường trong tuyến đường bao gồm các bước.

Trường
`distance_meters`	`int32` Quãng đường di chuyển của bước này, tính bằng mét. Trong một số trường hợp, trường này có thể không có giá trị.
`static_duration`	`Duration` Thời gian di chuyển qua bước này mà không xem xét 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 nhiều đoạ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ều hướng.
`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ó về khu vực giao thông trên một bước của chặng đường.

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ó về khu vực giao thông trên một bước của chặng đường.

Trường

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

speed_reading_intervals[]

SpeedReadingInterval

LƯU Ý: Trường này hiện không đượ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ư các hạn chế có thể có về vùng giao thông, v.v. trên một đoạn đường.

Trường

Trường
`toll_info`	`TollInfo` Đóng gói thông tin về 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ự đoán có trạm thu phí trên `RouteLeg`. Nếu bạn đặt trường này nhưng không điền vào trường phụ `estimated_price`, thì chúng tôi dự kiến đườ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, tức là `RouteLeg` không có phí cầu đường.
`speed_reading_intervals[]`	`SpeedReadingInterval` Khoảng thời gian đọc nhanh cho biết mật độ giao thông. Á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ộ đường nhiều đoạn của `RouteLeg` mà không bị trùng lặp. Điểm bắt đầu của một khoảng thời gian cụ thể 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

Đóng gói thông tin về 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ự đoán có trạm thu phí trên RouteLeg. Nếu bạn đặt trường này nhưng không điền vào trường phụ estimated_price, thì chúng tôi dự kiến đườ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, tức là RouteLeg không có phí cầu đường.

speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc nhanh cho biết mật độ giao thông. Á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ộ đường nhiều đoạn của RouteLeg mà không bị trùng lặp. Điểm bắt đầu của một khoảng thời gian cụ thể giống với điểm kết thúc của khoảng thời gian trước đó.

Ví dụ:

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

RouteMatrixDestination

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

Trường

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

waypoint

Waypoint

Bắt buộc. Điểm tham chiếu trên đường đi

RouteMatrixElement

Đóng gói thông tin về tuyến đường được tính toán cho một cặp điểm xuất phát/đích đến trong ComputeRouteMatrix API. 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 từ 0 của nguồn gốc trong yêu cầu.
`destination_index`	`int32` Chỉ mục dựa trên 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 tuyến đường có được tìm thấy hay không. Không phụ thuộc vào trạng thái.
`distance_meters`	`int32` Quãng đường di chuyển 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 tình trạng 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ề 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 theo các lựa chọn ưu tiên đã cho đối với cặp điểm xuất phát/đích đến cụ thể này, thì máy chủ có thể quay lại sử dụng một chế độ tính toán khác. Khi chế độ dự phòng được dùng, trường này sẽ chứa thông tin chi tiết về câu trả lời dự phòng. Nếu không, trường này sẽ không được đặt.

RouteMatrixElementCondition

Tình trạng của tuyến đường được trả về.

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

RouteMatrixOrigin

Một điểm xuất phát 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. Các đối tượng sửa đổi cho mọi tuyến đường lấy đối tượng này làm điểm xuất phát

waypoint

Waypoint

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

route_modifiers

RouteModifiers

Không bắt buộc. Các đối tượng sửa đổi cho mọi tuyến đường lấy đối tượng này làm điểm xuất phát

RouteModifiers

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

Trường
`avoid_tolls`	`bool` Khi được đặt thành true, hệ thống sẽ tránh đường có thu phí nếu có thể, ưu tiên những tuyến đường không có đường có thu phí. Chỉ áp dụng cho chế độ di chuyển `DRIVE` và `TWO_WHEELER`.
`avoid_highways`	`bool` Khi được đặt thành true, hệ thống sẽ tránh đường cao tốc nếu có thể, ưu tiên những tuyến đường không có đường cao tốc. Chỉ áp dụng cho chế độ di chuyển `DRIVE` và `TWO_WHEELER`.
`avoid_ferries`	`bool` Khi được đặt thành true, hệ thống sẽ tránh phà nếu có thể, ưu tiên những tuyến đường không có phà. Chỉ áp dụng cho chế độ di chuyển `DRIVE` và `TWO_WHEELER`.
`avoid_indoor`	`bool` Khi được đặt thành true, hệ thống sẽ tránh điều hướng trong nhà nếu có thể, ưu tiên những tuyến đường không chứa thông tin điều hướng trong nhà. Chỉ áp dụng cho chế độ di chuyển `WALK`.
`vehicle_info`	`VehicleInfo` Chỉ định thông tin về xe.
`toll_passes[]`	`TollPass` Đóng gói thông tin về phí cầu đường. Nếu bạn cung cấp phí cầu đường, API sẽ cố gắng trả về giá của phí cầu đường. Nếu không cung cấp phí cầu đường, API sẽ coi phí cầu đường là không xác định và cố gắng trả về giá tiền mặt. Chỉ áp dụng cho chế độ di chuyển `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 nhóm `objective`. Mục tiêu của tuyến đường. `objective` chỉ có thể là một trong những trạng thái sau:
`rate_card`	`RateCard` Mục tiêu RateCard.

Trường nhóm objective. Mục tiêu của tuyến đường. objective chỉ có thể là một trong những trạng thái sau:

rate_card

RateCard

Mục tiêu RateCard.

RateCard

Đóng gói một mục tiêu về 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í cho mỗi km.
`include_tolls`	`bool` Không bắt buộc. Có nên tính phí cầu đường vào 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í cho mỗi km.

include_tolls

bool

Không bắt buộc. Có nên tính phí cầu đường vào 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ệ được suy ra từ yêu cầu.

value

double

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

RouteTravelAdvisory

Đó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ư hạn chế về khu vực giao thông có thể có, v.v.

Trường

Trường
`toll_info`	`TollInfo` Đóng gói 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ự đoán có phí cầu đường trên Tuyến đường. Nếu bạn đặt trường này nhưng không điền vào trường phụ `estimated_price`, thì chúng tôi dự kiến đườ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 cho rằng Tuyến đường không có phí cầu đường.
`speed_reading_intervals[]`	`SpeedReadingInterval` Khoảng thời gian đọc nhanh cho biết mật độ giao thông. Á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ộ đường nhiều đường của tuyến đường mà không bị trùng lặp. Điểm bắt đầu của một khoảng thời gian cụ thể 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

Đóng gói 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ự đoán có phí cầu đường trên Tuyến đường. Nếu bạn đặt trường này nhưng không điền vào trường phụ estimated_price, thì chúng tôi dự kiến đườ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 cho rằng Tuyến đường không có phí cầu đường.

speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc nhanh cho biết mật độ giao thông. Á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ộ đường nhiều đường của tuyến đường mà không bị trùng lặp. Điểm bắt đầu của một khoảng thời gian cụ thể 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`	Bạn chưa chỉ định chế độ di chuyển. Giá trị mặc định là `DRIVE`.
`DRIVE`	Đi bằng xe chở khách.
`BICYCLE`	Đi xe đạp.
`WALK`	Đi bộ.
`TWO_WHEELER`	Xe có động cơ và có hai bánh. Ví dụ: xe máy. Xin lưu ý rằng chế độ này khác với chế độ di chuyển `BICYCLE`, trong đó có chế độ di chuyển bằng sức người.
`TAXI`	Di chuyển bằng taxi có giấy phép, có thể cho phép xe di chuyển trên làn đường dành riêng cho taxi ở một số khu vực. Chế độ TAXI là một tính năng thử nghiệm. Nếu khách hàng yêu cầu tuyến đường TAXI ở một thành phố không có dữ liệu về làn đường dành cho taxi, thì tuyến đường LÁI XE sẽ được trả về.

RoutingPreference

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

Enum
`ROUTING_PREFERENCE_UNSPECIFIED`	Chưa chỉ định lựa chọn ưu tiên về định tuyến. Giá trị mặc định là `TRAFFIC_AWARE`.
`TRAFFIC_UNAWARE`	Tính toán tuyến đường mà không xem xét tình trạng giao thông theo thời gian thực. Phù hợp khi tình trạng giao thông không quan trọng hoặc không áp dụng. 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 lượng được chọn dựa trên mạng lưới đường bộ và điều kiện giao thông trung bình không phụ thuộc vào thời gian, chứ không dựa trên điều kiện đường bộ hiện tại. Do đó, các tuyến đường có thể bao gồm những con đường bị đóng tạm thời. 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 trong mạng lưới đường bộ, tình trạng giao thông trung bình mới nhất và bản 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 đường gần tương đương vào bất kỳ thời điểm hoặc tần suất nào.
`TRAFFIC_AWARE`	Tính toán 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ố hoạt động tối ưu hoá được áp dụng để giảm đáng kể độ trễ.
`TRAFFIC_AWARE_OPTIMAL`	Tính toán các tuyến đường có xem xét tình trạng giao thông mà không áp dụng hầu hết các hoạt động tối ưu hoá hiệu suất. Việc sử dụng giá trị này sẽ tạo ra độ trễ cao nhất.

SpeedReadingInterval

Chỉ báo mật độ giao thông trên một đoạn liên tục của đường nhiều đường hoặc đường dẫn. Cho trước một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục từ 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 nhiều đường. Trong JSON, khi chỉ mục là 0, trường này sẽ không được điền sẵn.
`end_polyline_point_index`	`int32` Chỉ mục kết thúc của khoảng thời gian này trong đường nhiều đường. Trong JSON, khi chỉ mục là 0, trường này sẽ 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 nhiều đường. Trong JSON, khi chỉ mục là 0, trường này sẽ không được điền sẵn.

end_polyline_point_index

int32

Chỉ mục kết thúc của khoảng thời gian này trong đường nhiều đường. Trong JSON, khi chỉ mục là 0, trường này sẽ 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 hình nhiều đường dựa trên dữ liệu giao thông.

Enum
`SPEED_UNSPECIFIED`	Giá trị mặc định. Giá trị này không được dùng.
`NORMAL`	Tốc độ bình thường, không phát hiện thấy tình trạng chậm.
`SLOW`	Đã phát hiện tình trạng giảm tốc độ, nhưng không xảy ra tắc nghẽn giao thông.
`TRAFFIC_JAM`	Đã phát hiện tình trạng tắc nghẽn giao thông.

TollInfo

Đóng gói thông tin về 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 mỗi đơn vị tiền tệ mà các trạm thu phí dự kiến sẽ tính 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 loại 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 để phản ánh phí cầu đường bằng nhiều đơn vị tiền tệ.

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 mỗi đơn vị tiền tệ mà các trạm thu phí dự kiến sẽ tính 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 loại 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 để phản ánh phí cầu đường bằng nhiều đơn vị tiền tệ.

TollPass

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

Enum
`TOLL_PASS_UNSPECIFIED`	Không được sử dụng. Nếu giá trị này được dùng, thì yêu cầu sẽ không thành công.
`AU_ETOLL_TAG`	Một trong nhiều nhà cung cấp phí cầu đường ở Sydney. https://www.myetoll.com.au
`AU_EWAY_TAG`	Một trong nhiều nhà cung cấp phí cầu đường ở Sydney. https://www.tollpay.com.au/
`AU_LINKT`	Thẻ thu phí cầu đường trên toàn nước Ú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 ở Argentina. Xem thêm thông tin chi tiết tại https://telepase.com.ar
`BR_AUTO_EXPRESO`	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://www.autoexpreso.com
`BR_CONECTCAR`	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com.
`BR_MOVE_MAIS`	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://movemais.com.
`BR_PASSA_RAPIDO`	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin tại https://pasorapido.gob.do/
`BR_SEM_PARAR`	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://www.semparar.com.br.
`BR_TAGGY`	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://taggy.com.br.
`BR_VELOE`	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin tại https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	Đường biên giới từ Canada sang Hoa Kỳ.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Đường biên giới từ Canada sang Hoa Kỳ.
`CA_US_BLUE_WATER_EDGE_PASS`	Đường biên giới từ Ontario, Canada đến Michigan, Hoa Kỳ.
`CA_US_CONNEXION`	Đường biên giới từ Ontario, Canada đến Michigan, Hoa Kỳ.
`CA_US_NEXUS_CARD`	Đường biên giới từ Canada sang Hoa Kỳ.
`ID_E_TOLL`	Indonesia. Thẻ điện tử do nhiều ngân hàng cung cấp, dùng để thanh toán phí cầu đường. Tất cả thẻ điện tử qua ngân hàng đều được tính phí như nhau, vì vậy bạn chỉ cần một giá trị enum. Ví dụ: Bank Mandiri https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.
`IN_LOCAL_HP_PLATE_EXEMPT`	Ấn Độ, miễn biển số xe của bang HP.
`JP_ETC`	ETC Nhật Bản. Hệ thống không dây điện tử để thu phí cầu đường. https://www.go-etc.jp/
`JP_ETC2`	ETC2.0 của Nhật Bản. Phiên bản mới của ETC với chiết khấu cao hơn và khả năng giao tiếp hai chiều giữa các 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 cung cấp thẻ thu phí cầu đường ở Mexico. Một trong nhiều tuyến đường đang hoạt động ở Thành phố Mexico. Xem thêm thông tin tại https://www.televia.com.mx.
`MX_TELEVIA`	Công ty cung cấp thẻ thu phí cầu đường ở Mexico. Một trong nhiều công ty đang hoạt động ở Thành phố Mexico. https://www.televia.com.mx
`MX_VIAPASS`	Thẻ thu 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`	Canada, Hoa Kỳ.
`US_CA_FASTRAK_CAV_STICKER`	Cho biết người lái xe có thẻ FasTrak ngoài giấy đề can Xe không gây ô nhiễm (CAV) do DMV cấp. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	Colorado, Hoa Kỳ.
`US_CO_GO_PASS`	Colorado, 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`	IN, Hoa Kỳ.
`US_KS_BESTPASS_HORIZON`	Kansas, Hoa Kỳ.
`US_KS_KTAG`	Kansas, Hoa Kỳ.
`US_KS_NATIONALPASS`	Kansas, Hoa Kỳ.
`US_KS_PREPASS_ELITEPASS`	Kansas, Hoa Kỳ.
`US_KY_RIVERLINK`	KY, Hoa Kỳ.
`US_LA_GEAUXPASS`	LA, Hoa Kỳ.
`US_LA_TOLL_TAG`	LA, Hoa Kỳ.
`US_MA_EZPASSMA`	Massachusetts, Hoa Kỳ.
`US_MD_EZPASSMD`	Maryland, 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 dùng nữa vì loại thẻ này không còn tồn tại. Mục này không đượ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`	NC, Hoa Kỳ.
`US_NC_QUICK_PASS`	NC, Hoa Kỳ.
`US_NH_EZPASSNH`	New Hampshire, Hoa Kỳ.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	New Jersey, Hoa Kỳ.
`US_NJ_EZPASSNJ`	New Jersey, Hoa Kỳ.
`US_NY_EXPRESSPASS`	New York, Hoa Kỳ.
`US_NY_EZPASSNY`	New York, Hoa Kỳ.
`US_OH_EZPASSOH`	Ohio, Hoa Kỳ.
`US_PA_EZPASSPA`	PA, Hoa Kỳ.
`US_RI_EZPASSRI`	RI, Hoa Kỳ.
`US_SC_PALPASS`	SC, Hoa Kỳ.
`US_TX_AVI_TAG`	Texas, Hoa Kỳ.
`US_TX_BANCPASS`	Texas, Hoa Kỳ.
`US_TX_DEL_RIO_PASS`	Texas, Hoa Kỳ.
`US_TX_EFAST_PASS`	Texas, Hoa Kỳ.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	Texas, Hoa Kỳ.
`US_TX_EPTOLL`	Texas, Hoa Kỳ.
`US_TX_EZ_CROSS`	Texas, Hoa Kỳ.
`US_TX_EZTAG`	Texas, Hoa Kỳ.
`US_TX_FUEGO_TAG`	Texas, Hoa Kỳ.
`US_TX_LAREDO_TRADE_TAG`	Texas, Hoa Kỳ.
`US_TX_PLUSPASS`	Texas, Hoa Kỳ.
`US_TX_TOLLTAG`	Texas, Hoa Kỳ.
`US_TX_TXTAG`	Texas, Hoa Kỳ.
`US_TX_XPRESS_CARD`	Texas, Hoa Kỳ.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	UT, Hoa Kỳ.
`US_VA_EZPASSVA`	VA, Hoa Kỳ.
`US_WA_BREEZEBY`	Washington, Hoa Kỳ.
`US_WA_GOOD_TO_GO`	Washington, Hoa Kỳ.
`US_WV_EZPASSWV`	West Virginia, Hoa Kỳ.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	West Virginia, Hoa Kỳ.
`US_WV_MOV_PASS`	West Virginia, Hoa Kỳ
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	West Virginia, Hoa Kỳ.

Đơn vị

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

Enum
`UNITS_UNSPECIFIED`	Bạn chưa chỉ định đơn vị đo lường. Mặc định là đơn vị đo lường được suy luận từ yêu cầu.
`METRIC`	Đơn vị đo lường theo hệ mét.
`IMPERIAL`	Đơn vị đo lường theo hệ đo lườ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 LÁI XE.

Enum
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	Chưa chỉ định loại khí thải. Giá trị mặc định là GASOLINE.
`GASOLINE`	Xe chạy bằng xăng/dầu.
`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ư 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 đánh dấu đánh dấu cả điểm bắt đầu và điểm kết thúc của một tuyến đường, đồng thời bao gồm các điểm dừng chân dọc theo tuyến đường.

Trường
`via`	`bool` Đánh dấu điểm tham chiếu này là một cột mốc chứ không phải điểm dừng. Đối với mỗi điểm tham chiếu không phải là điểm tham chiếu 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ề các điểm dừng chân trên chặng đường đó. Đặt giá trị này thành true khi bạn muốn tuyến đường đi qua điểm tham chiếu này mà không dừng lại. Điểm tham chiếu không khiến một mục đượ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 đánh dấu là điểm trung gian. Yêu cầu sẽ không thành công nếu bạn đặt trường này trên các điểm tham chiế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 này dành cho xe dừng lại, với mục đích là đón hoặc trả khách. Khi bạn đặt giá trị này, tuyến đường được tính toán sẽ không bao gồm các điểm tham chiếu không phải `via` trên những con đường không phù hợp để đón và trả khách. Lựa chọn này chỉ hoạt động cho chế độ di chuyển `DRIVE` và `TWO_WHEELER`, đồng thời 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ó nghĩa là xe nê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í đó để xe có thể dừng ở lề đường mà vị trí đó hướng đến từ giữa đường. Lựa chọn này chỉ hoạt động đối với chế độ di chuyển "LÁI XE" và "XE HAI BÁNH".
Trường nhóm `location_type`. Các cách thể hiện vị trí. `location_type` chỉ có thể là một trong những trạng thái sau:
`location`	`Location` Một điểm được chỉ định bằng toạ độ địa lý, bao gồm cả hướng không bắt buộc.
`place_id`	`string` Mã địa điểm của địa điểm yêu thích được liên kết với điểm tham chiếu.

Package google.maps.routes.v1 Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Chỉ mục

RoutesPreferred

ComputeCustomRoutesRequest

ComputeCustomRoutesResponse

FallbackInfo

FallbackRouteObjective

ComputeRouteMatrixRequest

ComputeRoutesRequest

ComputeRoutesResponse

CustomRoute

FallbackInfo

FallbackReason

FallbackRoutingMode

Thông tin vị trí

Maneuver

NavigationInstruction

Hình nhiều đường

PolylineEncoding

PolylineQuality

Tuyến đường

RouteLeg

RouteLegStep

RouteLegStepTravelAdvisory

RouteLegTravelAdvisory

RouteMatrixDestination

RouteMatrixElement

RouteMatrixElementCondition

RouteMatrixOrigin

RouteModifiers

RouteObjective

RateCard

MonetaryCost

RouteTravelAdvisory

RouteTravelMode

RoutingPreference

SpeedReadingInterval

Tốc độ

TollInfo

TollPass

Đơn vị

VehicleEmissionType

VehicleInfo

Waypoint

Package google.maps.routes.v1