API Tuyến đường hiện đang ở chế độ Xem trước (trước GA). Các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không được hỗ trợ hạn chế. Đồng thời, các thay đổi đối với sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không tương thích với các phiên bản trước giai đoạn phát hành rộng rãi khác. Các Sản phẩm trước giai đoạn phát hành rộng rãi chịu sự điều chỉnh của Điều khoản dành riêng cho dịch vụ nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả giai đoạn ra mắt.

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

Switch to English

Package google.maps.routing.v2

Chỉ mục

Routes (giao diện)
ComputeRouteMatrixRequest (thông báo)
ComputeRouteMatrixRequest.ExtraComputation (enum)
ComputeRoutesRequest (thông báo)
ComputeRoutesRequest.ExtraComputation (enum)
ComputeRoutesRequest.ReferenceRoute (enum)
ComputeRoutesResponse (thông báo)
FallbackInfo (thông báo)
FallbackReason (enum)
FallbackRoutingMode (enum)
GeocodedWaypoint (thông báo)
GeocodingResults (thông báo)
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)
RouteLabel (enum)
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)
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)

Tuyến đường

API tuyến đường.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` Lấy danh sách nguồn gốc và đích đế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 nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách dùng tham số URL `$fields` hoặc `fields`, hoặc bằng cách sử dụng tiêu đề HTTP/gRPC `X-Goog-FieldMask` (xem tiêu đề và tham số URL có sẵn). Giá trị này là danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết này về cách xây dựng các đườ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ử, điều kiện và chỉ mục phần tử (thiết lập tạo ví dụ): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` Bạn phải đưa `status` vào mặt nạ trường của mình, nếu không tất cả thông báo sẽ có vẻ OK. Google không khuyến khích sử dụng mặt nạ phản hồi ký tự đại diện (``) vì: Việc chỉ chọn các trường bạn cần sẽ giúp máy chủ của chúng tôi lưu 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 mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể yêu cầu thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn chọn tất cả các trường ở cấp cao nhất, thì bạn có thể thấy hiệu suất giảm sút vì mọi trường mới mà chúng tôi thêm đều sẽ tự động được đưa vào nội dung phản hồi. Chỉ chọn các trường bạn cần sẽ dẫn đến kích thước phản hồi nhỏ hơn, và do đó thông lượng mạng cao hơn.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Lấy danh sách nguồn gốc và đích đế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 nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách dùng tham số URL $fields hoặc fields, hoặc bằng cách sử dụng tiêu đề HTTP/gRPC X-Goog-FieldMask (xem tiêu đề và tham số URL có sẵn). Giá trị này là danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết này về cách xây dựng các đườ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ử, điều kiện và chỉ mục phần tử (thiết lập tạo ví dụ): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Bạn phải đưa status vào mặt nạ trường của mình, nếu không tất cả thông báo sẽ có vẻ OK. Google không khuyến khích sử dụng mặt nạ phản hồi ký tự đại diện (*) vì:

Việc chỉ chọn các trường bạn cần sẽ giúp máy chủ của chúng tôi lưu 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 mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể yêu cầu thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn chọn tất cả các trường ở cấp cao nhất, thì bạn có thể thấy hiệu suất giảm sút vì mọi trường mới mà chúng tôi thêm đều sẽ tự động được đưa vào nội dung phản hồi.
Chỉ chọn các trường bạn cần sẽ dẫn đến kích thước phản hồi nhỏ hơn, và do đó thông lượng mạng cao hơn.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` Trả về tuyến 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 các điểm tham chiếu đầu cuối và trung gian. LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt 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 tiêu đề và tham số URL có sẵn). Giá trị này là danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách xây dựng các đườ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 cấp độ, khoảng cách và nhiều đường (một ví dụ về cách thiết lập trong quá trình sản xuất): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google không khuyến khích 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 các trường bạn cần sẽ giúp máy chủ của chúng tôi lưu 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 mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể yêu cầu thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn chọn tất cả các trường ở cấp cao nhất, thì bạn có thể thấy hiệu suất giảm sút vì mọi trường mới mà chúng tôi thêm đều sẽ tự động được đưa vào nội dung phản hồi. Chỉ chọn các trường bạn cần sẽ dẫn đến kích thước phản hồi nhỏ hơn, và do đó thông lượng mạng cao hơn.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Trả về tuyến 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 các điểm tham chiếu đầu cuối và trung gian.

LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt 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 tiêu đề và tham số URL có sẵn). Giá trị này là danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách xây dựng các đườ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 cấp độ, khoảng cách và nhiều đường (một ví dụ về cách thiết lập trong quá trình sản xuất): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google không khuyến khích 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 các trường bạn cần sẽ giúp máy chủ của chúng tôi lưu 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 mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và những trường mới đó có thể yêu cầu thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn chọn tất cả các trường ở cấp cao nhất, thì bạn có thể thấy hiệu suất giảm sút vì mọi trường mới mà chúng tôi thêm đều sẽ tự động được đưa vào nội dung phản hồi.
Chỉ chọn các trường bạn cần sẽ dẫn đến kích thước phản hồi nhỏ hơn, và do đó thông lượng mạng cao hơn.

Điện toán định tuyến

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

Các trường
`origins[]`	`RouteMatrixOrigin` Bắt buộc. Mảng nguồn gốc giúp 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 lượng số của nguồn gốc và đích đến: Số lượng phần tử (nguồn gốc × đích) không được lớn hơn 625 trong mọi trường hợp. Số lượng phần tử (nguồn gốc × điểm đến) không được lớn hơn 100 nếu định tuyến_preference là `TRAFFIC_AWARE_OPTIMAL`. Số điểm tham chiếu (nguồn gốc + đích) được chỉ định là `place_id` không được lớn hơn 50.
`destinations[]`	`RouteMatrixDestination` Bắt buộc. Mảng đích, 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 đường. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ bổ sung dài thì 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 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, giá trị này sẽ được đặt mặc định theo thời gian bạn thực hiện yêu cầu. Nếu bạn đặt giá trị này thành một thời điểm đã xảy ra, thì yêu cầu sẽ không thành công.
`language_code`	`string` Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem http://www.unicode.org/reporting/tr35/#Unicode_locale_identifier. Xem nội dung Hỗ trợ ngôn ngữ để biết danh sách ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị được suy ra từ vị trí của nguồn gốc đầu tiên.
`region_code`	`string` Không bắt buộc. Mã vùng, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Để biết thêm thông tin, hãy xem https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
`extra_computations[]`	`ExtraComputation` Không bắt buộc. Danh sách các phép tính bổ sung có thể dùng để hoàn thành yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trong phản hồi. Bạn cũng phải chỉ định các trường bổ sung này trong mặt nạ trường để trả về phản hồi.

Điện toán bổ sung

Các phép tính bổ sung cần thực hiện trong khi hoàn thành yêu cầu.

Enum
`EXTRA_COMPUTATION_UNSPECIFIED`	Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công.
`TOLLS`	Thông tin về phí cho(các) phần tử ma trận.

Yêu cầu điện toán

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

Các trường
`origin`	`Waypoint` Bắt buộc. Điểm tham chiếu ban đầu.
`destination`	`Waypoint` Bắt buộc. Điểm tham chiếu đích.
`intermediates[]`	`Waypoint` Không bắt buộc. Một tập hợp các điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối) để dừng tại hoặc đi qua. Hỗ trợ tối đa 25 điểm trung gian.
`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 đường. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ dài hơn thì một 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 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 hình.
`polyline_encoding`	`PolylineEncoding` Không bắt buộc. Chỉ định chế độ mã hoá ưu tiên cho hình nhiều đườ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 theo thời gian bạn thực hiện yêu cầu. Nếu bạn đặt giá trị này thành thời gian đã xảy ra, thì yêu cầu 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 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 ả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 http://www.unicode.org/reporting/tr35/#Unicode_locale_identifier. Xem nội dung Hỗ trợ ngôn ngữ để biết danh sách ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị được suy ra từ vị trí của yêu cầu tuyến đường.
`region_code`	`string` Không bắt buộc. Mã vùng, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Để biết thêm thông tin, hãy xem https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
`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 tuyến đường, số chân, quãng đường đi bộ 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ị được suy ra từ vị trí của yêu cầu.
`requested_reference_routes[]`	`ReferenceRoute` Không bắt buộc. Xác định tuyến tham chiếu nào cần tính toán trong yêu cầu ngoài tuyến mặc định. Tuyến tham chiếu là tuyến có mục tiêu tính toán tuyến đường khác với tuyến mặc định. Ví dụ: Việc tính toán tuyến đường tham chiếu `FUEL_EFFICIENT` sẽ xem xét nhiều thông số nhằm tạo ra tuyến đường tiết kiệm nhiên liệu tối ưu.
`extra_computations[]`	`ExtraComputation` Không bắt buộc. Danh sách các phép tính bổ sung có thể dùng để hoàn thành yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trong phản hồi. Bạn cũng phải chỉ định các trường bổ sung này trong mặt nạ trường để trả về phản hồi.

Điện toán bổ sung

Các phép tính bổ sung cần thực hiện trong khi hoàn thành yêu cầu.

Enum
`EXTRA_COMPUTATION_UNSPECIFIED`	Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công.
`TOLLS`	Thông tin về phí cầu đường cho(các) tuyến đường.
`FUEL_CONSUMPTION`	Mức tiêu thụ nhiên liệu ước tính cho(các) tuyến đường.
`TRAFFIC_ON_POLYLINE`	Đường đa tuyến nhận biết giao thông cho(các) tuyến đường.

Tham chiếu tuyến

Tuyến tham chiếu được hỗ trợ trên ComputeRoutesRequest.

Enum
`REFERENCE_ROUTE_UNSPECIFIED`	Không được sử dụng. Các yêu cầu chứa giá trị này không thực hiện được.
`FUEL_EFFICIENT`	Tuyến đường tiết kiệm nhiên liệu. Các tuyến đường được gắn nhãn bằng giá trị này được xác định là tối ưu hóa cho các thông số như mức tiêu thụ nhiên liệu.

Phản hồi về Tuyến tính

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

Các trường

Các 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 Compu_alternatives_routes và chỉ chứa 1 tuyến nếu bạn không có. Khi mảng này chứa nhiều mục nhập, thì mục đầu tiên là tuyến đường được đề xuất nhiều nhất. Nếu mảng trống thì điều đó có nghĩa là không thể 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ả tuyến đường bằng tất cả các tùy chọn đầu vào, máy chủ có thể dự phòng bằng một cách tính khác. Khi dùng chế độ dự phòng, trường này có chứa thông tin chi tiết về nội dung phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.
`geocoding_results`	`GeocodingResults` Chứa thông tin phản hồi mã hóa địa lý cho các điểm tham chiếu được chỉ định làm địa chỉ.

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 Compu_alternatives_routes và chỉ chứa 1 tuyến nếu bạn không có. Khi mảng này chứa nhiều mục nhập, thì mục đầu tiên là tuyến đường được đề xuất nhiều nhất. Nếu mảng trống thì điều đó có nghĩa là không thể 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ả tuyến đường bằng tất cả các tùy chọn đầu vào, máy chủ có thể dự phòng bằng một cách tính khác. Khi dùng chế độ dự phòng, trường này có chứa thông tin chi tiết về nội dung phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.

geocoding_results

GeocodingResults

Chứa thông tin phản hồi mã hóa địa lý cho các điểm tham chiếu được chỉ định làm địa chỉ.

Thông tin dự phòng

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ì có nghĩa là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ bạn muốn dùng làm chế độ dự phòng.

Các trường

Các trường
`routing_mode`	`FallbackRoutingMode` Chế độ định tuyến được sử dụng cho phản hồi. Nếu tính năng 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 thiết lập trong yêu cầu ứng dụng ban đầu.
`reason`	`FallbackReason` Lý do tại sao phản hồi dự phòng được sử dụng thay cho phản hồi gốc. 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

Chế độ định tuyến được sử dụng cho phản hồi. Nếu tính năng 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 thiết lập trong yêu cầu ứng dụng ban đầu.

reason

FallbackReason

Lý do tại sao phản hồi dự phòng được sử dụng thay cho phản hồi gốc. 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ề.

Lý do dự phòng

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

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

Chế độ định tuyến dự phòng

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

Enum
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	Không được sử dụng.
`FALLBACK_TRAFFIC_UNAWARE`	Cho biết `TRAFFIC_UNAWARE` `google.maps.routing.v2.RoutingPreference` được dùng để tính toán phản hồi.
`FALLBACK_TRAFFIC_AWARE`	Cho biết `TRAFFIC_AWARE` `RoutingPreference` được dùng để tính toán phản hồi.

Điểm mã hoá địa lý

Thông tin chi tiết về các địa điểm được dùng làm điểm trung gian. Chỉ được điền sẵn cho các điểm tham chiếu địa chỉ. Bao gồm thông tin chi tiết về kết quả mã hoá địa lý nhằm mục đích xác định địa chỉ nào được mã hoá địa lý.

Các trường
`geocoder_status`	`Status` Cho biết mã trạng thái từ hoạt động mã hoá địa lý.
`type[]`	`string` (Các) loại kết quả, ở dạng không hoặc nhiều thẻ loại. Các loại được hỗ trợ: https://developers.google.com/maps/documentation/geocodes/requests-geocodes#Types
`partial_match`	`bool` Cho biết rằng bộ mã hoá dữ liệu không trả về kết quả khớp chính xác với yêu cầu ban đầu, mặc dù bộ mã hoá có thể so khớp một phần của địa chỉ đã yêu cầu. Bạn nên kiểm tra yêu cầu ban đầu để tìm lỗi chính tả và/hoặc địa chỉ không đầy đủ.
`place_id`	`string` Mã địa điểm của kết quả này.
`intermediate_waypoint_request_index`	`int32` Chỉ mục của điểm trung gian tương ứng trong yêu cầu. Chỉ được điền nếu điểm trung gian tương ứng là điểm trung gian.

Mã hoá kết quả địa lý

Chứa GeocodedWaypoints cho điểm xuất phát, điểm đến và điểm trung gian. Chỉ được điền sẵn cho các điểm tham chiếu địa chỉ.

Các trường

Các trường
`origin`	`GeocodedWaypoint` Điểm xuất phát được mã hóa địa lý gốc.
`destination`	`GeocodedWaypoint` Điểm tham chiếu được mã hóa địa lý đích.
`intermediates[]`	`GeocodedWaypoint` Danh sách các điểm tham chiếu được mã hóa trung gian, mỗi điểm chứa một trường chỉ mục tương ứng với vị trí dựa trên 0 của điểm tham chiếu theo thứ tự được chỉ định trong yêu cầu.

origin

GeocodedWaypoint

Điểm xuất phát được mã hóa địa lý gốc.

destination

GeocodedWaypoint

Điểm tham chiếu được mã hóa địa lý đích.

intermediates[]

GeocodedWaypoint

Danh sách các điểm tham chiếu được mã hóa trung gian, mỗi điểm chứa một trường chỉ mục tương ứng với vị trí dựa trên 0 của điểm tham chiếu theo thứ tự được chỉ định trong yêu cầu.

Vị trí

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

Các trường

Các trường
`lat_lng`	`LatLng` Toạ độ địa lý của điểm tham chiếu.
`heading`	`Int32Value` Tiêu đề la bàn gắn với hướng của luồng lưu lượng truy cập. Giá trị này dùng để chỉ định phía một con đường để sử dụng tính năng đến lấy hàng và trả khách. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định tiêu đề đến hạn của miền Bắc, 90 chỉ định tiêu đề đến hạn của miền Đông, v.v. Bạn chỉ có thể sử dụng trường này cho `DRIVE` và `TWO_WHEELER` `RouteTravelMode`.

lat_lng

LatLng

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

heading

Int32Value

Tiêu đề la bàn gắn với hướng của luồng lưu lượng truy cập. Giá trị này dùng để chỉ định phía một con đường để sử dụng tính năng đến lấy hàng và trả khách. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định tiêu đề đến hạn của miền Bắc, 90 chỉ định tiêu đề đến hạn của miền Đông, v.v. Bạn chỉ có thể sử dụng trường này cho DRIVE và TWO_WHEELER RouteTravelMode.

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, hợp nhất, thẳng, v.v.).

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

Hướng dẫn sử dụng Navigation

Đóng gói hướng dẫn điều hướng cho RouteLegStep

Các trường

maneuver

Maneuver

Đóng gói hướng dẫn điều hướng cho bước hiện tại (ví dụ: rẽ trái, hợp nhất, thẳng, v.v.). Trường này xác định biểu tượng 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 polyline mã hoá.

Các trường

Các trường
Trường liên kết `polyline_type`. Đóng gói loại polyline. Giá trị mặc định làEncrypt_polyline. `polyline_type` chỉ có thể là một trong những trạng thái sau:
`encoded_polyline`	`string` Phương thức mã hoá chuỗi của polyline bằng thuật toán mã hoá polyline
`geo_json_linestring`	`Struct` Chỉ định một hình nhiều đường bằng cách sử dụng định dạng GeoLine LineString

Trường liên kết polyline_type. Đóng gói loại polyline. Giá trị mặc định làEncrypt_polyline. polyline_type chỉ có thể là một trong những trạng thái sau:

encoded_polyline

string

Phương thức mã hoá chuỗi của polyline bằng thuật toán mã hoá polyline

geo_json_linestring

Struct

Chỉ định một hình nhiều đường bằng cách sử dụng định dạng GeoLine LineString

PolylineMã hoá

Chỉ định loại polyline ưu tiên cần trả về.

Enum
`POLYLINE_ENCODING_UNSPECIFIED`	Chưa chỉ định tuỳ chọn loại đa hình. Giá trị mặc định là `ENCODED_POLYLINE`.
`ENCODED_POLYLINE`	Chỉ định một polyline mã hoá bằng thuật toán mã hoá polyline.
`GEO_JSON_LINESTRING`	Chỉ định một hình nhiều đường bằng cách sử dụng định dạng GeoLine LineString

Chất lượng hình nhiều đường

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

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

Tuyến đường

Bao gồm một tuyến đường, bao gồm một loạt các đoạn đường nối với các điểm bắt đầu, kết thúc và trung gian.

Các trường
`route_labels[]`	`RouteLabel` Các nhãn cho `Route` hữu ích để xác định các thuộc tính cụ thể của tuyến đường để so sánh với các thuộc tính khác.
`legs[]`	`RouteLeg` Một tập hợp các chân (phân đoạn đường dẫn giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai `Waypoints` không phải `via`. Ví dụ: một tuyến đường không có điểm trung gian chỉ có một chân. Một tuyến bao gồm một điểm trung gian không phải `via` có hai chân. Tuyến bao gồm một điểm tham chiếu trung gian `via` có một chân. Thứ tự của các chân khớp với thứ tự của các Điểm tham chiếu từ `origin` đến `intermediates` đến `destination`.
`distance_meters`	`int32` Khoảng cách 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ều hướng tuyến đường. Nếu bạn đặt `routing_preference` thành `TRAFFIC_UNAWARE`, thì giá trị này sẽ giống với `static_duration`. Nếu bạn đặt `routing_preference` thành `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`, thì giá trị này được tính khi xét đến điều kiện lưu lượng truy cập.
`static_duration`	`Duration` Thời gian di chuyển qua tuyến đường mà không tính đến điều kiện giao thông.
`polyline`	`Polyline` Tổng thể tuyến đường đa tuyến. Hình nhiều đường này sẽ là hình đa giác kết hợp của tất cả `legs`.
`description`	`string` Thông tin mô tả tuyến đường.
`warnings[]`	`string` Một loạt các cảnh báo cần hiển thị khi hiển thị tuyến đường.
`viewport`	`Viewport` Hộp giới hạn khung nhìn của polyline.
`travel_advisory`	`RouteTravelAdvisory` Thông tin bổ sung về tuyến đường.
`route_token`	`string` Mã thông báo tuyến đường được mã hóa base64 an toàn cho web có thể được chuyển tới NavigationSDK, cho phép SDK điều hướng tạo lại tuyến trong quá trình điều hướng và trong trường hợp định tuyến lại tôn trọng ý định ban đầu khi Tuyến tính toán Tuyến đường được gọi. Khách hàng nên coi mã thông báo này là một blob mờ. LƯU Ý: `Route.route_token` chỉ có sẵn cho những yêu cầu đã đặt `ComputeRoutesRequest.routing_preference` thành `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`. `Route.route_token` cũng không được hỗ trợ cho các yêu cầu có điểm tham chiếu Qua.

Nhãn định tuyến

Các nhãn cho Route hữu ích để xác định các thuộc tính cụ thể của tuyến đường để so sánh với các thuộc tính khác.

Enum
`ROUTE_LABEL_UNSPECIFIED`	Mặc định – không được sử dụng.
`DEFAULT_ROUTE`	Tuyến đường "tốt nhất" mặc định được trả về để tính toán tuyến đường.
`DEFAULT_ROUTE_ALTERNATE`	Một tuyến đường thay thế cho tuyến đường "tốt nhất" mặc định. Các tuyến đường như thế này sẽ được trả về khi `compute_alternative_routes` được chỉ định.
`FUEL_EFFICIENT`	Tuyến đường tiết kiệm nhiên liệu. Các tuyến đường được gắn nhãn với giá trị này được xác định là tối ưu hóa cho các thông số Eco như mức tiêu thụ nhiên liệu.

Tuyến đường

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

Các trường
`distance_meters`	`int32` Khoảng cách di chuyển của chân tuyến đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để di chuyển ở chân. Nếu bạn đặt `route_preference` thành `TRAFFIC_UNAWARE`, thì giá trị này sẽ giống với `static_duration`. Nếu `route_preference` là `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`, thì giá trị này được tính đến dựa trên các điều kiện lưu lượng truy cập.
`static_duration`	`Duration` Thời gian di chuyển qua chặng đường, được tính toán mà không tính đến điều kiện giao thông.
`polyline`	`Polyline` Hình nhiều đường tổng thể cho chân này. Điều này bao gồm nhiều đường liên kết của mỗi `step`.
`start_location`	`Location` Vị trí bắt đầu của chân này. Giá trị này có thể khác với `origin` đã cung cấp. Ví dụ: khi `origin` mà bạn cung cấp không ở gần một con đường, thì đây là một điểm trên đường.
`end_location`	`Location` Vị trí kết thúc của chân này. Giá trị này có thể khác với `destination` đã cung cấp. Ví dụ: khi `destination` mà bạn cung cấp không ở gần một con đường, thì đây là một điểm trên đường.
`steps[]`	`RouteLegStep` Một loạt các bước biểu thị các phân khúc trong chân này. Mỗi bước đại diện cho một hướng dẫn điều hướng.
`travel_advisory`	`RouteLegTravelAdvisory` Bao gồm các 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ùng giao thông có thể bị ảnh hưởng, v.v. ở một tuyến đường.

Tuyến đường

Đóng gói một phân đoạn của RouteLeg. Một bước tương ứng với một lệnh điều hướng duy nhất. Chân của tuyến đường bao gồm các bước.

Các trường
`distance_meters`	`int32` Khoảng cách 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 tính đến điều kiện giao thông. Trong một số trường hợp, trường này có thể không có giá trị.
`polyline`	`Polyline` Hình nhiều đường liên kết với bước này.
`start_location`	`Location` Vị trí bắt đầu của bước này.
`end_location`	`Location` Vị trí kết thúc của bước này.
`navigation_instruction`	`NavigationInstruction` Hướng dẫn điều hướng.
`travel_advisory`	`RouteLegStepTravelAdvisory` Đóng gói thông tin bổ sung mà người dùng nên được thông báo, chẳng hạn như hạn chế vùng lưu lượng truy cập có thể có ở bước chân.

Tuyến đường du lịch

Đóng gói thông tin bổ sung mà người dùng nên được thông báo, chẳng hạn như hạn chế vùng lưu lượng truy cập có thể có ở bước chân.

Các trường

Các trường
`speed_reading_intervals[]`	`SpeedReadingInterval` LƯU Ý: Hiện tại, trường này chưa được điền sẵn.

speed_reading_intervals[]

SpeedReadingInterval

LƯU Ý: Hiện tại, trường này chưa được điền sẵn.

Tuyến đường du lịch

Bao gồm các 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ùng giao thông có thể bị ảnh hưởng, v.v. ở một tuyến đường.

Các trường

Các trường
`toll_info`	`TollInfo` Đóng gói thông tin về trạm thu phí trên RouteLeg cụ thể. Trường này chỉ được điền sẵn nếu chúng tôi dự kiến sẽ có trạm thu phí trên RouteLeg. Nếu bạn đặt trường này nhưng trường phụ ước tính price_price không được điền, chúng tôi dự kiến rằng đường đó sẽ chứa phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu trường này không tồn tại, thì không có phí cầu đường trên RouteLeg.
`speed_reading_intervals[]`	`SpeedReadingInterval` Tốc độ đọc chi tiết nêu rõ mật độ giao thông. Có thể áp dụng trong trường hợp tuỳ chọn định tuyến `TRAFFIC_AWARE` và `TRAFFIC_AWARE_OPTIMAL`. Các khoảng thời gian này bao gồm toàn bộ đường đa của RouteLg 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

Đóng gói thông tin về trạm thu phí trên RouteLeg cụ thể. Trường này chỉ được điền sẵn nếu chúng tôi dự kiến sẽ có trạm thu phí trên RouteLeg. Nếu bạn đặt trường này nhưng trường phụ ước tính price_price không được điền, chúng tôi dự kiến rằng đường đó sẽ chứa phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu trường này không tồn tại, thì không có phí cầu đường trên RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

Tốc độ đọc chi tiết nêu rõ mật độ giao thông. Có thể áp dụng trong trường hợp tuỳ chọn định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này bao gồm toàn bộ đường đa của RouteLg 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).

Đích đến Ma trận

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

Các trường

Các 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 cặp cặp điểm xuất phát/đích trong API ComputeRouteMatrix. Proto này có thể được phát trực tuyến đến ứng dụng.

Các trường
`status`	`Status` Mã trạng thái lỗi của phần tử này.
`condition`	`RouteMatrixElementCondition` Cho biết tuyến đường có được tìm thấy hay không. Trạng thái độc lập.
`distance_meters`	`int32` Khoảng cách 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ều hướng tuyến đường. Nếu bạn đặt `routing_preference` thành `TRAFFIC_UNAWARE`, thì giá trị này sẽ giống với `static_duration`. Nếu bạn đặt `routing_preference` thành `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`, thì giá trị này được tính khi xét đến điều kiện lưu lượng truy cập.
`static_duration`	`Duration` Thời gian di chuyển qua tuyến đường mà không tính đến điều kiện giao thông.
`travel_advisory`	`RouteTravelAdvisory` Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về việc hạn chế và thông tin về mức 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 với các tùy chọn đã cho cho cặp nguồn gốc/đích cụ thể này, máy chủ có thể quay lại sử dụng chế độ tính toán khác. Khi dùng chế độ dự phòng, trường này có chứa thông tin chi tiết về nội dung phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.
`origin_index`	`int32` Chỉ mục dựa trên 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 trong yêu cầu.

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 ổn.
`ROUTE_EXISTS`	Đã tìm thấy một tuyến đường và thông tin tương ứng đã được điền cho phần tử.
`ROUTE_NOT_FOUND`	Không tìm thấy tuyến đường nào. Các trường 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ử.

Tuyến đường ma trận

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

Các trường

Các trường
`waypoint`	`Waypoint` Bắt buộc. Điểm tham chiếu ban đầu
`route_modifiers`	`RouteModifiers` Không bắt buộc. Công cụ sửa đổi cho mỗi tuyến lấy điểm này làm điểm khởi hành

waypoint

Waypoint

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

route_modifiers

RouteModifiers

Không bắt buộc. Công cụ sửa đổi cho mỗi tuyến lấy điểm này làm điểm khởi hành

Bộ định tuyến

Đó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 tuyến đường.

Các trường
`avoid_tolls`	`bool` Chỉ định xem có nên tránh đường có thu phí khi hợp lý hay không. Hệ thống sẽ ưu tiên các tuyến đường không chứa đường có thu phí. Chỉ áp dụng cho `DRIVE` và `TWO_WHEELER` `RouteTravelMode`.
`avoid_highways`	`bool` Chỉ định xem có nên tránh đường cao tốc khi hợp lý hay không. Ưu tiên cho các tuyến đường không chứa đường cao tốc. Chỉ áp dụng cho `DRIVE` và `TWO_WHEELER` `RouteTravelMode`.
`avoid_ferries`	`bool` Chỉ định xem có nên tránh phà khi hợp lý hay không. Ưu tiên các tuyến đường không đi bằng phà. Chỉ áp dụng cho `DRIVE` và`TWO_WHEELER` `RouteTravelMode`.
`avoid_indoor`	`bool` Chỉ định xem có nên tránh điều hướng trong nhà khi hợp lý hay không. Hệ thống sẽ ưu tiên các tuyến đường không chứa đường đi trong nhà. Chỉ áp dụng cho `WALK` `RouteTravelMode`.
`vehicle_info`	`VehicleInfo` Chỉ định thông tin xe.
`toll_passes[]`	`TollPass` Bao gồm thông tin về phí cầu đường. Nếu cung cấp phí cầu đường, API sẽ cố gắng trả về giá vé. 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 `DRIVE` và `TWO_WHEELER` `RouteTravelMode`.

Tuyến đường du lịch

Đóng gói thông tin bổ sung mà người dùng phải được thông báo, chẳng hạn như hạn chế vùng lưu lượng truy cập có thể xảy ra, v.v.

Các trường

Các trường
`toll_info`	`TollInfo` Đóng gói thông tin về trạm thu phí 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ó trạm thu phí trên Tuyến đường. Nếu bạn đặt trường này nhưng trường phụ ước tính price_price không được điền, chúng tôi dự kiến rằng đường đó sẽ chứa phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu bạn không đặt trường này, thì chúng tôi hy vọng sẽ không có phí cầu đường trên Tuyến đường.
`speed_reading_intervals[]`	`SpeedReadingInterval` Tốc độ đọc chi tiết nêu rõ mật độ giao thông. Có thể áp dụng trong trường hợp tuỳ chọn định tuyến `TRAFFIC_AWARE` và `TRAFFIC_AWARE_OPTIMAL`. Các khoảng thời gian này bao gồm toàn bộ nhiều đường của tuyến đường mà không chồng chéo nhau. Đ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).`
`fuel_consumption_microliters`	`int64` Thông tin dự đoán về mức tiêu thụ nhiên liệu (tính bằng lít).

toll_info

TollInfo

Đóng gói thông tin về trạm thu phí 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ó trạm thu phí trên Tuyến đường. Nếu bạn đặt trường này nhưng trường phụ ước tính price_price không được điền, chúng tôi dự kiến rằng đường đó sẽ chứa phí cầu đường nhưng chúng tôi không biết giá ước tính. Nếu bạn không đặt trường này, thì chúng tôi hy vọng sẽ không có phí cầu đường trên Tuyến đường.

speed_reading_intervals[]

SpeedReadingInterval

Tốc độ đọc chi tiết nêu rõ mật độ giao thông. Có thể áp dụng trong trường hợp tuỳ chọn định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này bao gồm toàn bộ nhiều đường của tuyến đường mà không chồng chéo nhau. Đ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).

fuel_consumption_microliters

int64

Thông tin dự đoán về mức tiêu thụ nhiên liệu (tính bằng lít).

Lộ trình đi lại

Một tập hợp các giá trị dùng để chỉ định phương tiện đi lại. LƯU Ý: Các tuyến đường WALK, BICYCLE và TWO_WHEELER đang ở giai đoạn thử nghiệm và đôi khi có thể thiếu các vỉa hè rõ ràng, đường dành cho người đi bộ hoặc đường dành cho xe đạp. Bạn phải hiển thị cảnh báo này cho người dùng về tất cả các tuyến đường đi bộ, đi xe đạp và xe hai bánh mà bạn hiển thị trong ứng dụng của mình.

Enum
`TRAVEL_MODE_UNSPECIFIED`	Bạn chưa chỉ định phương tiện đi lại nào. Giá trị mặc định là `DRIVE`.
`DRIVE`	Đi ô tô chở khách.
`BICYCLE`	Đi xe đạp.
`WALK`	Du lịch bằng cách đi bộ.
`TWO_WHEELER`	Xe hai bánh, có động cơ. Ví dụ: xe mô tô. Xin lưu ý rằng chế độ này khác với chế độ đi lại `BICYCLE`, có chế độ chạy bằng con người.

Tùy chọn định tuyến

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 lựa chọn ưu tiên về định tuyến. Giá trị mặc định là `TRAFFIC_UNAWARE`.
`TRAFFIC_UNAWARE`	Tính toán tuyến đường mà không tính đến điều kiện giao thông trực tiếp. Phù hợp khi điều kiện giao thông không quan trọng hoặc không phù hợp. 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`, việc lựa chọn tuyến đường và thời lượng 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. Kết quả cho một yêu cầu nhất định có thể thay đổi theo thời gian do thay đổi mạng lưới, tình trạng giao thông cập nhật trung bình và tính chất phân phối 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 bất cứ lúc nào hoặc 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 trực tiếp. Trái ngược với `TRAFFIC_AWARE_OPTIMAL`, một số phương pháp tối ưu hoá được áp dụng để giảm đáng kể độ trễ.
`TRAFFIC_AWARE_OPTIMAL`	Tính toán các tuyến đường có tính đến điều kiện giao thông trực tiếp mà không cần áp dụng hầu hết các phương pháp tối ưu hoá hiệu suất. Việc sử dụng giá trị này tạo ra độ trễ cao nhất.

Khoảng thời gian đọc

Chỉ báo mật độ lưu lượng truy cập trên một đoạn liền kề của đường đa hoặc đường dẫn. Với một đường dẫn 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 nó bằng cách sử dụng các danh mục sau.

Các trường
`start_polyline_point_index`	`int32` Chỉ mục bắt đầu của khoảng thời gian này trong nhiều đường.
`end_polyline_point_index`	`int32` Chỉ mục kết thúc của khoảng thời gian này trong hình nhiều đường.
Trường liên kết `speed_type`. `speed_type` chỉ có thể là một trong những trạng thái sau:
`speed`	`Speed` Tốc độ giao thông trong khoảng thời gian này.

Tốc độ

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

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

Thông tin về cầu đường

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

Các trường

Các 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à trạm thu phí dự kiến. Thông thường, danh sách này sẽ chỉ chứa một mặt hàng 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 để phản ánh 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 mỗi đơn vị tiền tệ mà trạm thu phí dự kiến. Thông thường, danh sách này sẽ chỉ chứa một mặt hàng 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 để phản ánh phí cầu đường bằng các đơn vị tiền tệ khác nhau.

Phí cầu đường

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

Đơn vị

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

Enum
`UNITS_UNSPECIFIED`	Đơn vị đo lường không được chỉ định. Giá trị mặc định là đơn vị đo lường được suy ra từ yêu cầu.
`METRIC`	Đơn vị đo lường chỉ số.
`IMPERIAL`	Đơn vị đo lường Anh (Anh).

Loại phát thải xe

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

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/xăng.
`ELECTRIC`	Xe điện.
`HYBRID`	Xe sử dụng nhiên liệu kết hợp (chẳng hạn như xăng và xe điện).
`DIESEL`	Xe chạy bằng dầu diesel.

Thông tin xe

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

Các trường

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

emission_type

VehicleEmissionType

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

Waypoint

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

Các trường
`via`	`bool` Đánh dấu điểm tham chiếu này là một điểm mốc thay vì một điểm dừng. Đối với mỗi điểm tham chiếu không thông qua trong yêu cầu, phản hồi sẽ thêm một mục nhập vào mảng `legs` để cung cấp thông tin chi tiết về các điểm dừng trên chặng đi đó của chuyến đi. Đặt giá trị này là true khi bạn muốn tuyến đường đi qua điểm tham chiếu này mà không dừng lại. Thông qua các điểm tham chiếu không khiến một mục nhập được thêm vào mảng `legs`, nhưng các điểm tham chiếu này sẽ định tuyến hành trình thông qua điểm tham chiếu. Bạn chỉ có thể đặt giá trị này trên các điểm trung gian là trung gian. Yêu cầu không thành công nếu bạn đặt trường này trên các điểm tham chiếu đầu cuối. Nếu bạn đặt `ComputeRoutesRequest.optimize_waypoint_order` thành true thì 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 điểm tham chiếu dành cho các phương tiện dừng lại, với ý định 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 điểm tham chiếu không phải `via` trên những con đường không phù hợp để đến lấy hàng và trả khách. Tùy chọn này chỉ hoạt động với các phương tiện đi lại `DRIVE` và `TWO_WHEELER` và khi `location_type` là `Location`.
`side_of_road`	`bool` Cho biết rằng vị trí của điểm tham chiếu này có nghĩa là các tuỳ chọn cho xe dừng tại 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í đó thiên vị từ trung tâm của con đường. Lựa chọn này chỉ dành cho "DRIVE" và "TWO_WHEELER" `RouteTravelMode`.
Trường liên kết `location_type`. Nhiều cách thể hiện thông tin vị trí. `location_type` chỉ có thể là một trong những trạng thái sau:
`location`	`Location` Đ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 yêu thích (POI) liên kết với điểm tham chiếu.
`address`	`string` Địa chỉ hoặc mã cộng mà người dùng có thể đọc được. Hãy xem https://plus.codes để biết chi tiết.