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

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)
LocalizedTime (thông báo)
Location (thông báo)
Maneuver (enum)
NavigationInstruction (thông báo)
Polyline (thông báo)
PolylineDetails (thông báo)
PolylineDetails.FlyoverInfo (thông báo)
PolylineDetails.NarrowRoadInfo (thông báo)
PolylineDetails.PolylinePointIndex (thông báo)
PolylineDetails.RoadFeatureState (enum)
PolylineEncoding (enum)
PolylineQuality (enum)
Route (thông báo)
Route.RouteLocalizedValues (thông báo)
RouteLabel (enum)
RouteLeg (thông báo)
RouteLeg.RouteLegLocalizedValues (thông báo)
RouteLeg.StepsOverview (thông báo)
RouteLeg.StepsOverview.MultiModalSegment (thông báo)
RouteLegStep (thông báo)
RouteLegStep.RouteLegStepLocalizedValues (thông báo)
RouteLegStepTransitDetails (thông báo)
RouteLegStepTransitDetails.TransitDetailsLocalizedValues (thông báo)
RouteLegStepTransitDetails.TransitStopDetails (thông báo)
RouteLegStepTravelAdvisory (thông báo)
RouteLegTravelAdvisory (thông báo)
RouteMatrixDestination (thông báo)
RouteMatrixElement (thông báo)
RouteMatrixElement.LocalizedValues (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)
TrafficModel (enum)
TransitAgency (thông báo)
TransitLine (thông báo)
TransitPreferences (thông báo)
TransitPreferences.TransitRoutingPreference (enum)
TransitPreferences.TransitTravelMode (enum)
TransitStop (thông báo)
TransitVehicle (thông báo)
TransitVehicle.TransitVehicleType (enum)
Units (enum)
VehicleEmissionType (enum)
VehicleInfo (thông báo)
Waypoint (thông báo)

Tuyến đường

Routes API.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` Nhận danh sách các điểm xuất phát và điểm đến, sau đó trả về một luồng chứa thông tin tuyến đường cho mỗi tổ hợp điểm xuất phát và điểm đến. LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách sử dụng tham số URL `$fields` hoặc `fields` hoặc 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à danh sách đường dẫn trường được phân tách bằng dấu phẩy. Hãy xem tài liệu chi tiết này về cách tạo đường dẫn trường. Ví dụ: trong phương thức này: Mặt nạ trường của tất cả các trường có sẵn (để kiểm tra thủ công): `X-Goog-FieldMask: ` Mặt nạ trường của thời lượng tuyến, khoảng cách, trạng thái phần tử, tình trạng và chỉ mục phần tử (ví dụ về chế độ thiết lập sản xuất): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` Bạn cần phải đưa `status` vào mặt nạ trường, nếu không tất cả thông báo sẽ xuất hiện là OK. Google không khuyến khích 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 mà bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn. 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 độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và các trường mới đó có thể 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 vào sẽ tự động được đưa vào phản hồi. Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Nhận danh sách các điểm xuất phát và điểm đến, sau đó trả về một luồng chứa thông tin tuyến đường cho mỗi tổ hợp điểm xuất phát và điểm đến.

LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách sử dụng tham số URL $fields hoặc fields hoặc 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à danh sách đường dẫn trường được phân tách bằng dấu phẩy. Hãy xem tài liệu chi tiết này về cách tạo đường dẫn trường.

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

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

Bạn cần phải đưa status vào mặt nạ trường, nếu không tất cả thông báo sẽ xuất hiện là OK. Google không khuyến khích 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 mà bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
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 độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và các trường mới đó có thể 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 vào sẽ tự động được đưa vào phản hồi.
Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` Trả về tuyến đường chính cùng với các tuyến đường thay thế không bắt buộc, dựa trên một tập hợp các điểm trung gian và điểm cuối. LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt 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à danh sách đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách tạo đường dẫn trường. Ví dụ: trong phương thức này: Mặt nạ trường của tất cả các trường có sẵn (để kiểm tra thủ công): `X-Goog-FieldMask: ` Mặt nạ trường của thời lượng, khoảng cách và đường đa tuyến ở cấp Tuyến (ví dụ về chế độ thiết lập 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ạ trường phản hồi ký tự đại diện (``) hoặc chỉ định mặt nạ trường ở cấp cao nhất (`routes`) vì: Việc chỉ chọn những trường mà bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn. 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 độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và các trường mới đó có thể 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 vào sẽ tự động được đưa vào phản hồi. Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt 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à danh sách đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách tạo đường dẫn trường.

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

Mặt nạ trường của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
Mặt nạ trường của thời lượng, khoảng cách và đường đa tuyến ở cấp Tuyến (ví dụ về chế độ thiết lập 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ạ trường phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ trường ở cấp cao nhất (routes) vì:

Việc chỉ chọn những trường mà bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
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 độ trễ ổn định. Chúng tôi có thể thêm các trường phản hồi khác trong tương lai và các trường mới đó có thể 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 vào sẽ tự động được đưa vào phản hồi.
Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

ComputeRouteMatrixRequest

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

Trường
`origins[]`	`RouteMatrixOrigin` Bắt buộc. Mảng gốc xác định các hàng của ma trận phản hồi. Một số quy định hạn chế về kích thước áp dụng cho số lượng giá trị riêng biệt của nguồn và đích: Tổng số lượng điểm xuất phát + số lượng điểm đến được chỉ định là `place_id` hoặc `address` không được lớn hơn 50. Trong mọi trường hợp, tích của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 625. Sản phẩm của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 100 nếu bạn đặt routing_preference thành `TRAFFIC_AWARE_OPTIMAL`. Hiệu số của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 100 nếu travel_mode được đặt thành `TRANSIT`.
`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 vận 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ủ sẽ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến. Nếu lựa chọn ưu tiên định tuyến dẫn đến lỗi hoặc độ trễ quá lâu, thì hệ thống sẽ trả về lỗi. Bạn chỉ có thể chỉ định tuỳ chọn này khi `travel_mode` là `DRIVE` hoặc `TWO_WHEELER`, nếu không yêu cầu sẽ không thành công.
`departure_time`	`Timestamp` Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời điểm bạn đưa ra yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định `departure_time` trong quá khứ khi `RouteTravelMode` được đặt thành `TRANSIT`.
`arrival_time`	`Timestamp` Không bắt buộc. Thời gian đến. LƯU Ý: Bạn chỉ có thể đặt khi `RouteTravelMode` được đặt thành `TRANSIT`. Bạn có thể chỉ định `departure_time` hoặc `arrival_time`, nhưng không được chỉ định cả hai.
`language_code`	`string` Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem phần Giá trị nhận dạng ngôn ngữ Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách 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 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 bài viết Miền cấp cao nhất theo mã quốc gia.
`units`	`Units` Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị.
`extra_computations[]`	`ExtraComputation` Không bắt buộc. Danh sách các phép tính bổ sung có thể được dùng để hoàn tất 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 để được trả về trong phản hồi.
`traffic_model`	`TrafficModel` Không bắt buộc. Chỉ định các giả định cần sử dụng khi tính thời gian trong lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường duration (thời lượng) trong `RouteMatrixElement`. Trường này chứa thời gian dự đoán trong lưu lượng truy cập dựa trên mức trung bình trong quá khứ. `RoutingPreference` đến `TRAFFIC_AWARE_OPTIMAL` và `RouteTravelMode` đến `DRIVE`. Mặc định là `BEST_GUESS` nếu lưu lượng truy cập được yêu cầu và `TrafficModel` không được chỉ định.
`transit_preferences`	`TransitPreferences` Không bắt buộc. Chỉ định các tuỳ chọn ưu tiên ảnh hưởng đến tuyến đường được trả về cho các tuyến đường `TRANSIT`. LƯU Ý: Bạn chỉ có thể chỉ định `transit_preferences` khi `RouteTravelMode` được đặt thành `TRANSIT`.

ExtraComputation

Các phép tính bổ sung cần thực hiện trong khi hoàn tất 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) phần tử ma trận.

ComputeRoutesRequest

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

Trường
`origin`	`Waypoint` Bắt buộc. Điểm tham chiếu gốc.
`destination`	`Waypoint` Bắt buộc. Điểm trung gian đến.
`intermediates[]`	`Waypoint` Không bắt buộc. Một tập hợp các điểm trung gian dọc theo tuyến đường (ngoại trừ các điểm cuối), để dừng lạ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 vận 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ủ sẽ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến. Nếu lựa chọn ưu tiên định tuyến dẫn đến lỗi hoặc độ trễ quá dài, thì lỗi sẽ được trả về. Bạn chỉ có thể chỉ định tuỳ chọn này khi `travel_mode` là `DRIVE` hoặc `TWO_WHEELER`, nếu không yêu cầu sẽ không thành công.
`polyline_quality`	`PolylineQuality` Không bắt buộc. Chỉ định lựa chọn ưu tiên của bạn về chất lượng của đường đa tuyến.
`polyline_encoding`	`PolylineEncoding` Không bắt buộc. Chỉ định cách mã hoá ưu tiên cho đường đa tuyến.
`departure_time`	`Timestamp` Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời điểm bạn đưa ra yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định `departure_time` trong quá khứ khi `RouteTravelMode` được đặt thành `TRANSIT`. Bạn có thể xem thông tin về các chuyến đi bằng phương tiện công cộng trong tối đa 7 ngày trước đó hoặc 100 ngày sau đó.
`arrival_time`	`Timestamp` Không bắt buộc. Thời gian đến. LƯU Ý: Bạn chỉ có thể đặt khi `RouteTravelMode` được đặt thành `TRANSIT`. Bạn có thể chỉ định `departure_time` hoặc `arrival_time`, nhưng không được chỉ định cả hai. Bạn có thể xem thông tin về các chuyến đi bằng phương tiện công cộng trong tối đa 7 ngày trước đó hoặc 100 ngày sau đó.
`compute_alternative_routes`	`bool` Không bắt buộc. Chỉ định xem có tính 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 trung gian.
`route_modifiers`	`RouteModifiers` Không bắt buộc. Một tập hợp các điều kiện cần đáp ứng ảnh hưởng đến cách tính toán tuyến.
`language_code`	`string` Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem phần Giá trị nhận dạng ngôn ngữ Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách 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 định tuyế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 bài viết Miền cấp cao nhất theo mã quốc gia.
`units`	`Units` Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Các trường này bao gồm trường `instruction` trong `NavigationInstruction`. Giá trị này không ảnh hưởng đến các đơn vị đo lường được dùng cho tuyến đường, chặng đường, khoảng cách bước và thời lượng. Nếu bạn không cung cấp giá trị này, thì các đơn vị hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên.
`optimize_waypoint_order`	`bool` Không bắt buộc. Nếu bạn đặt thành true, dịch vụ sẽ cố gắng giảm thiểu tổng chi phí của tuyến đường bằng cách sắp xếp lại các điểm trung gian đã chỉ định. Yêu cầu sẽ không thành công nếu có điểm trung gian nào đó là điểm trung gian `via`. Sử dụng `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` để tìm thứ tự mới. Nếu không yêu cầu `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index` trong tiêu đề `X-Goog-FieldMask`, yêu cầu sẽ không thành công. Nếu bạn đặt `optimize_waypoint_order` thành false, `ComputeRoutesResponse.optimized_intermediate_waypoint_index` sẽ trống.
`requested_reference_routes[]`	`ReferenceRoute` Không bắt buộc. Chỉ định các tuyến đường tham chiếu cần tính toán trong yêu cầu ngoài tuyến đường mặc định. Tuyến tham chiếu là tuyến có mục tiêu tính toán tuyến khác với tuyến mặc định. Ví dụ: tính toán tuyến đường tham chiếu `FUEL_EFFICIENT` sẽ tính đến nhiều tham số để tạo ra tuyến đường tiết kiệm nhiên liệu tối ưu. Khi sử dụng tính năng này, hãy tìm `route_labels` trên các tuyến đường thu được.
`extra_computations[]`	`ExtraComputation` Không bắt buộc. Danh sách các phép tính bổ sung có thể được dùng để hoàn tất 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 để được trả về trong phản hồi.
`traffic_model`	`TrafficModel` Không bắt buộc. Chỉ định các giả định cần sử dụng khi tính thời gian trong lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường thời lượng trong `Route` và `RouteLeg`. Trường này chứa thời gian dự đoán trong lưu lượng truy cập dựa trên mức trung bình trước đây. `TrafficModel` chỉ dùng được cho các yêu cầu đã đặt `RoutingPreference` thành `TRAFFIC_AWARE_OPTIMAL` và `RouteTravelMode` thành `DRIVE`. Mặc định là `BEST_GUESS` nếu lưu lượng truy cập được yêu cầu và `TrafficModel` không được chỉ định.
`transit_preferences`	`TransitPreferences` Không bắt buộc. Chỉ định các tuỳ chọn ưu tiên ảnh hưởng đến tuyến đường được trả về cho các tuyến đường `TRANSIT`. LƯU Ý: Bạn chỉ có thể chỉ định `transit_preferences` khi `RouteTravelMode` được đặt thành `TRANSIT`.

ExtraComputation

Các phép tính bổ sung cần thực hiện trong khi hoàn tất 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 có tính năng nhận biết tình hình giao thông cho(các) tuyến đường.
`HTML_FORMATTED_NAVIGATION_INSTRUCTIONS`	`NavigationInstructions` được trình bày dưới dạng một chuỗi văn bản HTML được định dạng. Nội dung này được đọc nguyên trạng. Nội dung này chỉ để hiển thị. Không phân tích cú pháp theo phương thức lập trình.
`FLYOVER_INFO_ON_POLYLINE`	Thông tin về đường bay cho(các) tuyến đường. Bạn phải chỉ định mặt nạ trường `routes.polyline_details.flyover_info` để trả về thông tin này. Dữ liệu này hiện chỉ được điền sẵn cho một số thành phố lớn ở Ấn Độ. Đây là tính năng thử nghiệm và SKU/phí có thể thay đổi.
`NARROW_ROAD_INFO_ON_POLYLINE`	Thông tin về đường hẹp cho(các) tuyến đường. Bạn phải chỉ định mặt nạ trường `routes.polyline_details.narrow_road_info` để trả về thông tin này. Dữ liệu này hiện chỉ được điền sẵn cho một số thành phố lớn ở Ấn Độ. Đây là tính năng thử nghiệm và SKU/phí có thể thay đổi.

ReferenceRoute

Một 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 sẽ không thành công.

FUEL_EFFICIENT Tuyến đường tiết kiệm nhiên liệu.

Enum
`REFERENCE_ROUTE_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.
`FUEL_EFFICIENT`	Tuyến đường tiết kiệm nhiên liệu.
`SHORTER_DISTANCE`	Tuyến đường có quãng đường di chuyển ngắn hơn. Đây là tính năng thử nghiệm. Đối với các yêu cầu `DRIVE`, tính năng này ưu tiên quãng đường ngắn hơn so với sự thoải mái khi lái xe. Ví dụ: tính năng này có thể ưu tiên đường địa phương thay vì đường cao tốc, đi theo đường đất, cắt ngang bãi đỗ xe, v.v. Tính năng này không trả về bất kỳ thao tác nào mà Google Maps biết là bất hợp pháp. Đối với các yêu cầu `BICYCLE` và `TWO_WHEELER`, tính năng này trả về các tuyến tương tự như các tuyến được trả về khi bạn không chỉ định `requested_reference_routes`. Tính năng này không tương thích với bất kỳ phương thức di chuyển nào khác, thông qua các điểm trung gian hoặc `optimize_waypoint_order`; các yêu cầu như vậy sẽ không thành công. Tuy nhiên, bạn có thể sử dụng nó với bất kỳ `routing_preference` nào.

SHORTER_DISTANCE

Tuyến đường có quãng đường di chuyển ngắn hơn. Đây là tính năng thử nghiệm.

Đối với các yêu cầu DRIVE, tính năng này ưu tiên quãng đường ngắn hơn so với sự thoải mái khi lái xe. Ví dụ: tính năng này có thể ưu tiên đường địa phương thay vì đường cao tốc, đi theo đường đất, cắt ngang bãi đỗ xe, v.v. Tính năng này không trả về bất kỳ thao tác nào mà Google Maps biết là bất hợp pháp.

Đối với các yêu cầu BICYCLE và TWO_WHEELER, tính năng này trả về các tuyến tương tự như các tuyến được trả về khi bạn không chỉ định requested_reference_routes.

Tính năng này không tương thích với bất kỳ phương thức di chuyển nào khác, thông qua các điểm trung gian hoặc optimize_waypoint_order; các yêu cầu như vậy sẽ không thành công. Tuy nhiên, bạn có thể sử dụng nó với bất kỳ routing_preference nào.

ComputeRoutesResponse

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

Trường

Trường
`routes[]`	`Route` Chứa một mảng các tuyến đườ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 nhập, mục nhập đầu tiên là tuyến đường được đề xuất nhất. Nếu mảng này trống, thì 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 không thể tính toán kết quả tuyến đường bằng tất cả các tuỳ chọn ưu tiên đầu vào, máy chủ có thể quay lại sử dụng một phương thức tính toán khác. Khi chế độ dự phòng được sử dụng, trường này sẽ chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.
`geocoding_results`	`GeocodingResults` Chứa thông tin phản hồi về việc mã hoá địa lý cho các điểm trung gian được chỉ định dưới dạng địa chỉ.

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

geocoding_results

GeocodingResults

Chứa thông tin phản hồi về việc mã hoá địa lý cho các điểm trung gian được chỉ định dưới dạng địa chỉ.

FallbackInfo

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

Trường

Trường
`routing_mode`	`FallbackRoutingMode` Chế độ định tuyến được dùng cho phản hồi. Nếu chế độ dự phòng được kích hoạt, chế độ này có thể khác với lựa chọn ưu tiên định tuyến được đặt trong yêu cầu ban đầu của ứng dụng.
`reason`	`FallbackReason` Lý do sử dụng phản hồi dự phòng thay vì phản hồi ban đầu. Trường này chỉ được điền khi chế độ dự phòng được kích hoạt và phản hồi dự phòng được trả về.

routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

FallbackReason

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

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

FallbackRoutingMode

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

Enum
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	Không được sử dụng.
`FALLBACK_TRAFFIC_UNAWARE`	Cho biết `TRAFFIC_UNAWARE` `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.

GeocodedWaypoint

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

Trường
`geocoder_status`	`Status` Cho biết mã trạng thái do thao tác liên kết địa lý.
`type[]`	`string` (Các) loại kết quả, ở dạng từ 0 thẻ loại trở lên. Các loại được hỗ trợ: Loại địa chỉ và loại thành phần địa chỉ.
`partial_match`	`bool` Cho biết trình dịch địa lý không trả về kết quả khớp chính xác cho yêu cầu ban đầu, mặc dù có thể khớp một phần của địa chỉ được yêu cầu. Bạn nên kiểm tra yêu cầu ban đầu để xem có lỗi chính tả và/hoặc địa chỉ chưa hoàn chỉnh hay không.
`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.

GeocodingResults

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 trung gian địa chỉ.

Trường

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

origin

GeocodedWaypoint

Điểm trung gian được mã hoá địa lý của điểm xuất phát.

destination

GeocodedWaypoint

Điểm trung gian được mã hoá địa lý của điểm đến.

intermediates[]

GeocodedWaypoint

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

LocalizedTime

Nội dung mô tả đã bản địa hoá về thời gian.

Trường

Trường
`time`	`LocalizedText` Thời gian được chỉ định dưới dạng một chuỗi theo múi giờ nhất định.
`time_zone`	`string` Chứa múi giờ. Giá trị này là tên của múi giờ được xác định trong Cơ sở dữ liệu múi giờ IANA, ví dụ: "Hoa Kỳ/New_York".

time

LocalizedText

Thời gian được chỉ định dưới dạng một chuỗi theo múi giờ nhất định.

time_zone

string

Chứa múi giờ. Giá trị này là tên của múi giờ được xác định trong Cơ sở dữ liệu múi giờ IANA, ví dụ: "Hoa Kỳ/New_York".

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 trung gian.
`heading`	`Int32Value` Hướng la bàn liên quan đến hướng của luồng giao thông. Giá trị này chỉ định bên đường để đón và trả khách. Giá trị hướng có thể từ 0 đến 360, trong đó 0 chỉ định hướng chính Bắc, 90 chỉ định hướng chính Đô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 trung gian.

heading

Int32Value

Hướng la bàn liên quan đến hướng của luồng giao thông. Giá trị này chỉ định bên đường để đón và trả khách. Giá trị hướng có thể từ 0 đến 360, trong đó 0 chỉ định hướng chính Bắc, 90 chỉ định hướng chính Đô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, nhập hoặc đi thẳng).

Enum
`MANEUVER_UNSPECIFIED`	Không được sử dụng.
`TURN_SLIGHT_LEFT`	Rẽ nhẹ sang trái.
`TURN_SHARP_LEFT`	Rẽ trái đột ngột.
`UTURN_LEFT`	Rẽ trái rồi rẽ ngược lại.
`TURN_LEFT`	Rẽ trái.
`TURN_SLIGHT_RIGHT`	Rẽ nhẹ sang phải.
`TURN_SHARP_RIGHT`	Rẽ ngoặt sang phải.
`UTURN_RIGHT`	Rẽ phải rồi quay đầu.
`TURN_RIGHT`	Rẽ phải.
`STRAIGHT`	Đi thẳng.
`RAMP_LEFT`	Đi theo đường dốc bên trái.
`RAMP_RIGHT`	Đi theo đường dốc bên phải.
`MERGE`	Hợp nhất vào luồng giao thông.
`FORK_LEFT`	Rẽ trái.
`FORK_RIGHT`	Rẽ phải.
`FERRY`	Đi phà.
`FERRY_TRAIN`	Đi tàu đến phà.
`ROUNDABOUT_LEFT`	Rẽ trái tại vòng xoay.
`ROUNDABOUT_RIGHT`	Rẽ phải tại vòng xoay.
`DEPART`	Thao tác ban đầu.
`NAME_CHANGE`	Dùng để cho biết tên đường đã thay đổi.

NavigationInstruction

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

Trường

maneuver

Maneuver

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

instructions

string

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

Hình nhiều đường

Đóng gói một đường đa tuyến đã mã hoá.

Trường

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

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

encoded_polyline

string

Mã hoá chuỗi của đa tuyến bằng thuật toán mã hoá đa tuyến

geo_json_linestring

Struct

Chỉ định một đa tuyến bằng định dạng GeoJSON LineString.

PolylineDetails

Thông tin chi tiết tương ứng với một chỉ mục hoặc đoạn liên tiếp của một đa tuyến. Với một đa tuyến có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên 0), PolylineDetails xác định một khoảng thời gian và siêu dữ liệu liên quan.

Trường

Trường
`flyover_info[]`	`FlyoverInfo` Thông tin chi tiết về đường bay dọc theo đường đa tuyến.
`narrow_road_info[]`	`NarrowRoadInfo` Thông tin chi tiết về đường hẹp dọc theo đường đa tuyến.

flyover_info[]

FlyoverInfo

Thông tin chi tiết về đường bay dọc theo đường đa tuyến.

narrow_road_info[]

NarrowRoadInfo

Thông tin chi tiết về đường hẹp dọc theo đường đa tuyến.

FlyoverInfo

Đóng gói thông tin về cầu vượt dọc theo đường đa tuyến.

Trường

Trường
`flyover_presence`	`RoadFeatureState` Chỉ có đầu ra. Cho biết liệu có cầu vượt cho một đoạn đường đa tuyến nhất định hay không.
`polyline_point_index`	`PolylinePointIndex` Vị trí của thông tin liên quan đến chế độ xem đường bay dọc theo đường đa tuyến.

flyover_presence

RoadFeatureState

Chỉ có đầu ra. Cho biết liệu có cầu vượt cho một đoạn đường đa tuyến nhất định hay không.

polyline_point_index

PolylinePointIndex

Vị trí của thông tin liên quan đến chế độ xem đường bay dọc theo đường đa tuyến.

NarrowRoadInfo

Đóng gói thông tin về các đường hẹp dọc theo đường đa tuyến.

Trường

Trường
`narrow_road_presence`	`RoadFeatureState` Chỉ có đầu ra. Cho biết liệu có một con đường hẹp cho một đoạn đường cụ thể của đường đa tuyến hay không.
`polyline_point_index`	`PolylinePointIndex` Vị trí của thông tin liên quan đến đường hẹp dọc theo đường đa tuyến.

narrow_road_presence

RoadFeatureState

Chỉ có đầu ra. Cho biết liệu có một con đường hẹp cho một đoạn đường cụ thể của đường đa tuyến hay không.

polyline_point_index

PolylinePointIndex

Vị trí của thông tin liên quan đến đường hẹp dọc theo đường đa tuyến.

PolylinePointIndex

Đóng gói các chỉ mục bắt đầu và kết thúc cho thông tin chi tiết về đường đa tuyến. Đối với các trường hợp dữ liệu tương ứng với một điểm, start_index và end_index sẽ bằng nhau.

Trường

Trường
`start_index`	`int32` Chỉ mục bắt đầu của chi tiết này trong đường đa tuyến.
`end_index`	`int32` Chỉ mục kết thúc của chi tiết này trong đường đa tuyến.

start_index

int32

Chỉ mục bắt đầu của chi tiết này trong đường đa tuyến.

end_index

int32

Chỉ mục kết thúc của chi tiết này trong đường đa tuyến.

RoadFeatureState

Đóng gói các trạng thái của các đặc điểm đường dọc theo một đoạn đường đa tuyến.

Enum
`ROAD_FEATURE_STATE_UNSPECIFIED`	Trạng thái của đối tượng đường không được tính toán (giá trị mặc định).
`EXISTS`	Tính năng đường đã tồn tại.
`DOES_NOT_EXIST`	Đối tượng đường không tồn tại.

PolylineEncoding

Chỉ định loại đường đa tuyến ưu tiên được trả về.

Enum
`POLYLINE_ENCODING_UNSPECIFIED`	Không chỉ định loại đường đa tuyến. Giá trị mặc định là `ENCODED_POLYLINE`.
`ENCODED_POLYLINE`	Chỉ định một đa tuyến được mã hoá bằng thuật toán mã hoá đa tuyến.
`GEO_JSON_LINESTRING`	Chỉ định một đa tuyến bằng định dạng GeoJSON LineString

PolylineQuality

Một tập hợp các giá trị chỉ định chất lượng của đa tuyến.

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

Tuyến đường

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

Trường
`route_labels[]`	`RouteLabel` 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 tuyến đường khác.
`legs[]`	`RouteLeg` Tập hợp các chặng (phân đoạn đường dẫn giữa các điểm trung gian) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai `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ặng. Một tuyến đường có một điểm trung gian không phải `via` sẽ có hai chặng. Một tuyến đường có một điểm trung gian `via` sẽ có một chặng. Thứ tự của các chặng khớp với thứ tự của các điểm trung gian từ `origin` đến `intermediates` đến `destination`.
`distance_meters`	`int32` Quãng đường đi của tuyến đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để đi theo tuyến đường. Nếu bạn đặt `routing_preference` thành `TRAFFIC_UNAWARE`, thì giá trị này sẽ giống với `static_duration`. Nếu bạn đặt `routing_preference` thành `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`, thì giá trị này sẽ được tính toán có tính đến điều kiện giao thông.
`static_duration`	`Duration` Thời gian di chuyển theo tuyến đường mà không tính đến tình trạng giao thông.
`polyline`	`Polyline` Hình nhiều đường của tuyến đường tổng thể. Đường đa tuyến này là đường đa tuyến kết hợp của tất cả `legs`.
`description`	`string` Nội dung mô tả tuyến đường.
`warnings[]`	`string` Một mảng cảnh báo sẽ hiển thị khi hiển thị tuyến đường.
`viewport`	`Viewport` Hộp giới hạn khung nhìn của đường đa tuyến.
`travel_advisory`	`RouteTravelAdvisory` Thông tin bổ sung về tuyến đường.
`optimized_intermediate_waypoint_index[]`	`int32` Nếu bạn đặt `optimize_waypoint_order` thành true, trường này sẽ chứa thứ tự tối ưu hoá của các điểm trung gian. Nếu không, trường này sẽ trống. Ví dụ: nếu bạn nhập thông tin đầu vào là Điểm xuất phát: LA; Điểm trung gian: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm trung gian được tối ưu hoá là Phoenix, Dallas, Bangor, thì trường này sẽ chứa các giá trị [2, 0, 1]. Chỉ mục bắt đầu bằng 0 cho điểm trung gian đầu tiên được cung cấp trong dữ liệu đầu vào.
`localized_values`	`RouteLocalizedValues` Biểu diễn văn bản của các thuộc tính của `Route`.
`route_token`	`string` Mã thông báo mờ có thể được truyền đến Navigation SDK để 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 tuân thủ ý định ban đầu khi tạo tuyến đường. Xem mã thông báo này là một blob mờ. Đừng so sánh giá trị của thuộc tính này trên các yêu cầu vì giá trị của thuộc tính này có thể thay đổi ngay cả khi dịch vụ trả về cùng một tuyến. LƯU Ý: `Route.route_token` chỉ dùng được cho các yêu cầu đã đặt `ComputeRoutesRequest.routing_preference` thành `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`. `Route.route_token` không được hỗ trợ cho các yêu cầu có điểm trung gian Via.
`polyline_details`	`PolylineDetails` Chứa thông tin về các chi tiết dọc theo đường đa tuyến.

RouteLocalizedValues

Biểu thị văn bản của một số thuộc tính.

Trường
`distance`	`LocalizedText` Quãng đường di chuyển được thể hiện ở dạng văn bản.
`duration`	`LocalizedText` Thời lượng, được biểu thị ở dạng văn bản và được bản địa hoá theo khu vực của cụm từ tìm kiếm. Cân nhắc tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin lưu lượng truy cập, thì giá trị này sẽ giống với `static_duration`.
`static_duration`	`LocalizedText` Thời lượng mà không xem xét đến điều kiện lưu lượng truy cập, được thể hiện ở dạng văn bản.
`transit_fare`	`LocalizedText` Giá vé phương tiện công cộng được thể hiện ở dạng văn bản.

RouteLabel

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 tuyến đường 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ề cho quá trình 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 bạn chỉ định `compute_alternative_routes`.
`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à được tối ưu hoá cho các tham số Tiết kiệm, chẳng hạn như mức tiêu thụ nhiên liệu.
`SHORTER_DISTANCE`	Tuyến đường có quãng đường di chuyển ngắn hơn. Đây là tính năng thử nghiệm.

RouteLeg

Chứa một đoạn giữa các điểm trung gian không phải via.

Trường
`distance_meters`	`int32` Khoảng cách di chuyển của chặng đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để di chuyển chặng. Nếu bạn đặt `route_preference` thành `TRAFFIC_UNAWARE`, thì giá trị này sẽ giống với `static_duration`. Nếu `route_preference` là `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`, thì giá trị này sẽ được tính toán dựa trên điều kiện giao thông.
`static_duration`	`Duration` Thời gian di chuyển qua chặng, được tính toán mà không tính đến tình trạng giao thông.
`polyline`	`Polyline` Đường đa tuyến tổng thể cho chặng này bao gồm đường đa tuyến của mỗi `step`.
`start_location`	`Location` Vị trí bắt đầu của chặng này. Vị trí này có thể khác với `origin` đã cung cấp. Ví dụ: khi `origin` được cung cấp không ở 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. Vị trí này có thể khác với `destination` đã cung cấp. Ví dụ: khi `destination` được cung cấp không ở gần đường, thì đây là một điểm trên đường.
`steps[]`	`RouteLegStep` Một mảng các bước biểu thị các phân đoạn trong chặng này. Mỗi bước đại diện cho một hướng dẫn điều hướng.
`travel_advisory`	`RouteLegTravelAdvisory` Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các quy định hạn chế có thể có trong khu vực giao thông, trên một chặng đường.
`localized_values`	`RouteLegLocalizedValues` Biểu diễn văn bản của các thuộc tính của `RouteLeg`.
`steps_overview`	`StepsOverview` Thông tin tổng quan về các bước trong `RouteLeg` này. Trường này chỉ được điền sẵn cho các tuyến PHƯƠNG TIỆN CÔNG CỘNG.

RouteLegLocalizedValues

Biểu thị văn bản của một số thuộc tính.

Trường

distance

LocalizedText

Quãng đường di chuyển được thể hiện ở dạng văn bản.

duration

LocalizedText

Thời lượng, được biểu thị ở dạng văn bản và được bản địa hoá theo khu vực của cụm từ tìm kiếm. Cân nhắc tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin về lưu lượng truy cập, thì giá trị này sẽ giống với static_duration.

static_duration

LocalizedText

Thời lượng mà không xem xét đến điều kiện lưu lượng truy cập, được thể hiện ở dạng văn bản.

StepsOverview

Cung cấp thông tin tổng quan về danh sách RouteLegStep.

Trường

Trường
`multi_modal_segments[]`	`MultiModalSegment` Thông tin tóm tắt về các phân đoạn đa phương thức khác nhau của `RouteLeg.steps`. Trường này không được điền nếu `RouteLeg` không chứa bất kỳ phân đoạn đa phương thức nào trong các bước.

multi_modal_segments[]

MultiModalSegment

Thông tin tóm tắt về các phân đoạn đa phương thức khác nhau của RouteLeg.steps. Trường này không được điền nếu RouteLeg không chứa bất kỳ phân đoạn đa phương thức nào trong các bước.

MultiModalSegment

Cung cấp thông tin tóm tắt về các phân đoạn đa phương thức khác nhau của RouteLeg.steps. Phân đoạn đa phương thức được xác định là một hoặc nhiều RouteLegStep liền kề có cùng RouteTravelMode. Trường này không được điền nếu RouteLeg không chứa bất kỳ phân đoạn đa phương thức nào trong các bước.

Trường
`navigation_instruction`	`NavigationInstruction` NavigationInstruction cho phân đoạn đa phương thức.
`travel_mode`	`RouteTravelMode` Phương tiện đi lại của đoạn đường đa phương thức.
`step_start_index`	`int32` Chỉ mục `RouteLegStep` tương ứng là điểm bắt đầu của một phân đoạn đa phương thức.
`step_end_index`	`int32` Chỉ mục `RouteLegStep` tương ứng là phần cuối của một phân đoạn đa phương thức.

RouteLegStep

Chứa một phân đoạn của RouteLeg. Một bước tương ứng với một hướng dẫn điều hướng. Các chặng đường bao gồm các bước.

Trường
`distance_meters`	`int32` 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 tính đến tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị.
`polyline`	`Polyline` Đường đa tuyến liên kết với bước này.
`start_location`	`Location` Vị trí bắt đầu của bước này.
`end_location`	`Location` Vị trí kết thúc của bước này.
`navigation_instruction`	`NavigationInstruction` Hướng dẫn điều hướng.
`travel_advisory`	`RouteLegStepTravelAdvisory` Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các quy định hạn chế có thể có đối với khu vực giao thông, trong một bước của chặng.
`localized_values`	`RouteLegStepLocalizedValues` Biểu diễn văn bản của các thuộc tính của `RouteLegStep`.
`transit_details`	`RouteLegStepTransitDetails` Thông tin chi tiết liên quan đến bước này nếu chế độ đi lại là `TRANSIT`.
`travel_mode`	`RouteTravelMode` Phương thức di chuyển được sử dụng cho bước này.

RouteLegStepLocalizedValues

Biểu thị văn bản của một số thuộc tính.

Trường

distance

LocalizedText

Quãng đường di chuyển được thể hiện ở dạng văn bản.

static_duration

LocalizedText

Thời lượng mà không xem xét đến điều kiện lưu lượng truy cập, được thể hiện ở dạng văn bản.

RouteLegStepTransitDetails

Thông tin bổ sung cho RouteLegStep liên quan đến các tuyến TRANSIT.

Trường
`stop_details`	`TransitStopDetails` Thông tin về điểm đến và điểm khởi hành của bước.
`localized_values`	`TransitDetailsLocalizedValues` Biểu diễn văn bản của các thuộc tính của `RouteLegStepTransitDetails`.
`headsign`	`string` Chỉ định hướng di chuyển trên tuyến này như được đánh dấu trên xe hoặc tại điểm dừng khởi hành. Hướng thường là ga cuối.
`headway`	`Duration` Chỉ định thời gian dự kiến dưới dạng thời lượng giữa các chuyến khởi hành từ cùng một điểm dừng tại thời điểm này. Ví dụ: với giá trị khoảng thời gian giữa các chuyến xe là 600 giây, bạn sẽ phải chờ 10 phút nếu lỡ chuyến xe buýt.
`transit_line`	`TransitLine` Thông tin về tuyến phương tiện công cộng được sử dụng trong bước này.
`stop_count`	`int32` Số điểm dừng từ điểm khởi hành đến điểm đến. Số lượng này bao gồm điểm dừng đến nhưng không bao gồm điểm dừng khởi hành. Ví dụ: nếu tuyến xe buýt của bạn khởi hành từ Bến A, đi qua Bến B và C rồi đến Bến D, `stop_count` trả về 3.
`trip_short_text`	`string` Văn bản xuất hiện trong lịch trình và bảng hiệu để xác định chuyến đi bằng phương tiện công cộng cho hành khách. Văn bản phải xác định một chuyến đi trong một ngày hoạt động. Ví dụ: "538" là `trip_short_text` của chuyến tàu Amtrak khởi hành từ San Jose, California lúc 15:10 vào các ngày trong tuần đến Sacramento, California.

TransitDetailsLocalizedValues

Nội dung mô tả được bản địa hoá về các giá trị cho RouteTransitDetails.

Trường

Trường
`arrival_time`	`LocalizedTime` Thời gian được thể hiện dưới dạng văn bản được định dạng với múi giờ tương ứng.
`departure_time`	`LocalizedTime` Thời gian được thể hiện dưới dạng văn bản được định dạng với múi giờ tương ứng.

arrival_time

LocalizedTime

Thời gian được thể hiện dưới dạng văn bản được định dạng với múi giờ tương ứng.

departure_time

LocalizedTime

Thời gian được thể hiện dưới dạng văn bản được định dạng với múi giờ tương ứng.

TransitStopDetails

Thông tin chi tiết về các trạm trung chuyển của RouteLegStep.

Trường
`arrival_stop`	`TransitStop` Thông tin về điểm dừng đến của bước.
`arrival_time`	`Timestamp` Thời gian đến dự kiến của bước.
`departure_stop`	`TransitStop` Thông tin về điểm dừng khởi hành của bước.
`departure_time`	`Timestamp` Thời gian khởi hành ước tính cho bước này.

RouteLegStepTravelAdvisory

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

Trường

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

speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

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

Trường

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

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

speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc nhanh nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn ưu tiên định tuyến TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này bao phủ toàn bộ đường đa tuyến của RouteLeg 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).

RouteMatrixDestination

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

Trường

Trường
`waypoint`	`Waypoint` Bắt buộc. Điểm trung gian đến

waypoint

Waypoint

Bắt buộc. Điểm trung gian đến

RouteMatrixElement

Chứa thông tin tuyến đường được tính toán cho một cặp điểm xuất phát/điểm đến trong API ComputeRouteMatrix. Bạn có thể truyền trực tuyến proto này đến ứng dụng.

Trường
`status`	`Status` Mã trạng thái lỗi cho phần tử này.
`condition`	`RouteMatrixElementCondition` Cho biết liệu có tìm thấy tuyến đường hay không. Không phụ thuộc vào trạng thái.
`distance_meters`	`int32` Quãng đường đi của tuyến đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để đi theo tuyến đường. Nếu bạn đặt `routing_preference` thành `TRAFFIC_UNAWARE`, thì giá trị này sẽ giống với `static_duration`. Nếu bạn đặt `routing_preference` thành `TRAFFIC_AWARE` hoặc `TRAFFIC_AWARE_OPTIMAL`, thì giá trị này sẽ được tính toán có tính đến điều kiện giao thông.
`static_duration`	`Duration` Thời gian di chuyển qua tuyến đường mà không tính đến tình trạng giao thông.
`travel_advisory`	`RouteTravelAdvisory` Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về quy định hạn chế và thông tin về phí cầu đường
`fallback_info`	`FallbackInfo` Trong một số trường hợp, khi không thể tính toán tuyến đường bằng các lựa chọn ưu tiên đã cho cho cặp điểm xuất phát/điểm đến cụ thể này, máy chủ có thể quay lại sử dụng một chế độ tính toán khác. Khi chế độ dự phòng được sử dụng, trường này sẽ chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.
`localized_values`	`LocalizedValues` Biểu diễn văn bản của các thuộc tính của `RouteMatrixElement`.
`origin_index`	`int32` Chỉ mục gốc dựa trên 0 trong yêu cầu.
`destination_index`	`int32` Chỉ mục dựa trên số 0 của đích đến trong yêu cầu.

LocalizedValues

Biểu thị văn bản của một số thuộc tính.

Trường
`distance`	`LocalizedText` Quãng đường di chuyển được thể hiện ở dạng văn bản.
`duration`	`LocalizedText` Thời lượng được thể hiện dưới dạng văn bản, có tính đến điều kiện lưu lượng truy cập. Lưu ý: Nếu bạn không yêu cầu thông tin về lưu lượng truy cập, thì giá trị này sẽ giống với static_duration.
`static_duration`	`LocalizedText` Thời lượng được thể hiện ở dạng văn bản mà không xem xét đến điều kiện lưu lượng truy cập.
`transit_fare`	`LocalizedText` Giá vé phương tiện công cộng được thể hiện ở dạng văn bản.

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

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

Trường

Trường
`waypoint`	`Waypoint` Bắt buộc. Điểm tham chiếu gốc
`route_modifiers`	`RouteModifiers` Không bắt buộc. Đối tượng sửa đổi cho mọi tuyến đường lấy giá trị này làm gốc

waypoint

Waypoint

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

route_modifiers

RouteModifiers

Không bắt buộc. Đối tượng sửa đổi cho mọi tuyến đường lấy giá trị này làm gốc

RouteModifiers

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

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

RouteTravelAdvisory

Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các quy định hạn chế có thể có trong khu vực giao thông.

Trường
`toll_info`	`TollInfo` Chứa thông tin về phí cầu đường trên tuyến đường. Trường này chỉ được điền nếu có thu phí trên tuyến đường. Nếu bạn đặt trường này nhưng không điền trường con `estimatedPrice`, thì tuyến đường sẽ có trạm thu phí nhưng không xác định được giá ước tính. Nếu bạn không đặt trường này, thì sẽ không có phí cầu đường nào trên tuyến đường.
`speed_reading_intervals[]`	`SpeedReadingInterval` Khoảng thời gian đọc nhanh nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn ưu tiên định tuyến `TRAFFIC_AWARE` và `TRAFFIC_AWARE_OPTIMAL`. Các khoảng thời gian này bao phủ toàn bộ đường đa tuyến của tuyến đường mà không 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).`
`fuel_consumption_microliters`	`int64` Mức tiêu thụ nhiên liệu dự đoán tính bằng microlit.
`route_restrictions_partially_ignored`	`bool` Tuyến đường được trả về có thể có các quy định hạn chế không phù hợp với phương thức di chuyển hoặc đối tượng sửa đổi tuyến đường được yêu cầu.
`transit_fare`	`Money` Nếu có, chứa tổng chi phí đi lại hoặc giá vé trên tuyến đường này. Thuộc tính này chỉ được trả về cho các yêu cầu `TRANSIT` và chỉ dành cho các tuyến đường có thông tin về giá vé cho tất cả các bước đi lại.

RouteTravelMode

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

Enum
`TRAVEL_MODE_UNSPECIFIED`	Chưa chỉ định phương tiện đi lại. Giá trị mặc định là `DRIVE`.
`DRIVE`	Đi bằng ô tô.
`BICYCLE`	Đi bằng xe đạp.
`WALK`	Đi bộ.
`TWO_WHEELER`	Xe hai bánh, có động cơ. Ví dụ: xe máy. Xin lưu ý rằng phương thức này khác với phương thức đi lại `BICYCLE` bao gồm cả phương thức đi bộ.
`TRANSIT`	Đi theo tuyến phương tiện công cộng (nếu có).

RoutingPreference

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

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

SpeedReadingInterval

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

Trường
`start_polyline_point_index`	`int32` Chỉ mục bắt đầu của khoảng thời gian này trong đường đa tuyến.
`end_polyline_point_index`	`int32` Chỉ mục kết thúc của khoảng thời gian này trong đa tuyến.
Trường hợp hợp nhất `speed_type`. `speed_type` chỉ có thể là một trong những loạ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 độ của đường đa tuyến dựa trên dữ liệu lưu lượng truy cập.

Enum
`SPEED_UNSPECIFIED`	Giá trị mặc định. Giá trị này không được sử dụng.
`NORMAL`	Tốc độ bình thường, không phát hiện thấy hiện tượng chậm.
`SLOW`	Phát hiện tình trạng chậm lại nhưng không có nút thắt cổ chai nào hình thành.
`TRAFFIC_JAM`	Đã phát hiện ách tắc 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

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 sẽ tính phí. Thông thường, danh sách này sẽ chỉ chứa một mục cho các tuyến đường có phí cầu đường 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 nhiều đơn vị tiền tệ.

TollPass

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

Enum
`TOLL_PASS_UNSPECIFIED`	Không được sử dụng. Nếu bạn sử dụng giá trị này, yêu cầu sẽ không thành công.
`AU_ETOLL_TAG`	Thẻ thu phí cầu đường Sydney. Xem thêm thông tin chi tiết tại https://www.myetoll.com.au.
`AU_EWAY_TAG`	Thẻ thu phí cầu đường Sydney. Xem thêm thông tin chi tiết tại https://www.tollpay.com.au.
`AU_LINKT`	Thẻ thu phí trên toàn Úc. Xem thêm thông tin chi tiết tại https://www.linkt.com.au/.
`AR_TELEPASE`	Thẻ thu phí cầu đường của Argentina. Xem thêm thông tin chi tiết tại https://telepase.com.ar
`BR_AUTO_EXPRESO`	Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://www.autoexpreso.com
`BR_CONECTCAR`	Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com.
`BR_MOVE_MAIS`	Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://movemais.com.
`BR_PASSA_RAPIDO`	Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://pasorapido.gob.do/
`BR_SEM_PARAR`	Thẻ thu phí cầu đường của 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 của Brazil. Xem thêm thông tin chi tiết tại https://taggy.com.br.
`BR_VELOE`	Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	Cửa khẩu Canada đến Hoa Kỳ.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Cửa khẩu Canada đến Hoa Kỳ.
`CA_US_BLUE_WATER_EDGE_PASS`	Cửa khẩu biên giới từ Ontario, Canada đến Michigan, Hoa Kỳ.
`CA_US_CONNEXION`	Cửa khẩu biên giới từ Ontario, Canada đến Michigan, Hoa Kỳ.
`CA_US_NEXUS_CARD`	Cửa khẩu Canada đến Hoa Kỳ.
`ID_E_TOLL`	Indonesia. Thẻ điện tử do nhiều ngân hàng cung cấp, dùng để thanh toán phí cầu đường. Tất cả thẻ điện tử qua ngân hàng đều được tính phí như nhau nên bạn chỉ cần một giá trị enum. Ví dụ: – 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 trừ biển số tiểu bang HP.
`JP_ETC`	Nhật Bản ETC. Hệ thống không dây điện tử để thu phí. https://www.go-etc.jp/
`JP_ETC2`	Nhật Bản ETC2.0. Phiên bản ETC mới có mức 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`	Thẻ thu phí đường bộ ở 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 ở Mexico. Một trong nhiều công ty hoạt động ở Mexico City. Xem thêm thông tin tại https://www.televia.com.mx.
`MX_TELEVIA`	Công ty thu phí cầu đường ở Mexico. Một trong nhiều đài truyền hình hoạt động ở Thành phố Mexico. https://www.televia.com.mx
`MX_VIAPASS`	Thẻ thu phí đường bộ của 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`	Alaska, Hoa Kỳ.
`US_CA_FASTRAK`	Canada, Hoa Kỳ.
`US_CA_FASTRAK_CAV_STICKER`	Cho biết người lái xe có thẻ FasTrak nào đó ngoài hình dán Xe chạy bằng không khí sạch (CAV) do DMV phát hành. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, Hoa Kỳ.
`US_CO_GO_PASS`	CO, Hoa Kỳ.
`US_DE_EZPASSDE`	Đức, Hoa Kỳ.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	Florida, Hoa Kỳ.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	Florida, Hoa Kỳ.
`US_FL_EPASS`	Florida, Hoa Kỳ.
`US_FL_GIBA_TOLL_PASS`	Florida, Hoa Kỳ.
`US_FL_LEEWAY`	Florida, Hoa Kỳ.
`US_FL_SUNPASS`	Florida, Hoa Kỳ.
`US_FL_SUNPASS_PRO`	Florida, Hoa Kỳ.
`US_IL_EZPASSIL`	IL, Hoa Kỳ.
`US_IL_IPASS`	IL, Hoa Kỳ.
`US_IN_EZPASSIN`	Ấn Độ, Hoa Kỳ.
`US_KS_BESTPASS_HORIZON`	KS, Hoa Kỳ.
`US_KS_KTAG`	KS, Hoa Kỳ.
`US_KS_NATIONALPASS`	KS, Hoa Kỳ.
`US_KS_PREPASS_ELITEPASS`	KS, Hoa Kỳ.
`US_KY_RIVERLINK`	KY, Hoa Kỳ.
`US_LA_GEAUXPASS`	Los Angeles, Hoa Kỳ.
`US_LA_TOLL_TAG`	Los Angeles, Hoa Kỳ.
`US_MA_EZPASSMA`	MA, 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 còn được dùng nữa vì loại thẻ và vé này không còn tồn tại. Mục này không còn được dùng nữa!
`US_MI_IQ_TAG`	MI, Hoa Kỳ.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	MI, Hoa Kỳ.
`US_MI_NEXPRESS_TOLL`	MI, Hoa Kỳ.
`US_MN_EZPASSMN`	MN, Hoa Kỳ.
`US_NC_EZPASSNC`	Bắc Carolina, Hoa Kỳ.
`US_NC_PEACH_PASS`	Bắc Carolina, Hoa Kỳ.
`US_NC_QUICK_PASS`	Bắc Carolina, Hoa Kỳ.
`US_NH_EZPASSNH`	NH, Hoa Kỳ.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	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`	Pennsylvania, Hoa Kỳ.
`US_RI_EZPASSRI`	RI, Hoa Kỳ.
`US_SC_PALPASS`	SC, Hoa Kỳ.
`US_TX_AVI_TAG`	TX, Hoa Kỳ.
`US_TX_BANCPASS`	TX, Hoa Kỳ.
`US_TX_DEL_RIO_PASS`	TX, Hoa Kỳ.
`US_TX_EFAST_PASS`	TX, Hoa Kỳ.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	TX, Hoa Kỳ.
`US_TX_EPTOLL`	TX, Hoa Kỳ.
`US_TX_EZ_CROSS`	TX, Hoa Kỳ.
`US_TX_EZTAG`	TX, Hoa Kỳ.
`US_TX_FUEGO_TAG`	TX, Hoa Kỳ.
`US_TX_LAREDO_TRADE_TAG`	TX, Hoa Kỳ.
`US_TX_PLUSPASS`	TX, Hoa Kỳ.
`US_TX_TOLLTAG`	TX, Hoa Kỳ.
`US_TX_TXTAG`	TX, Hoa Kỳ.
`US_TX_XPRESS_CARD`	TX, Hoa Kỳ.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	UT, Hoa Kỳ.
`US_VA_EZPASSVA`	Virginia, Hoa Kỳ.
`US_WA_BREEZEBY`	WA, Hoa Kỳ.
`US_WA_GOOD_TO_GO`	WA, Hoa Kỳ.
`US_WV_EZPASSWV`	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ỳ.

TrafficModel

Chỉ định các giả định cần sử dụng khi tính thời gian trong lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường duration trong phản hồi, chứa thời gian dự đoán trong lưu lượng truy cập dựa trên mức trung bình trước đây.

Enum
`TRAFFIC_MODEL_UNSPECIFIED`	Không sử dụng. Nếu được chỉ định, giá trị mặc định sẽ là `BEST_GUESS`.
`BEST_GUESS`	Cho biết `duration` được trả về phải là thời gian di chuyển ước tính tốt nhất dựa trên những thông tin đã biết về cả tình trạng giao thông trước đây và tình trạng giao thông trực tiếp. Lưu lượng truy cập trực tiếp càng quan trọng hơn khi `departure_time` càng gần thời điểm hiện tại.
`PESSIMISTIC`	Cho biết thời lượng được trả về phải dài hơn thời gian di chuyển thực tế vào hầu hết các ngày, mặc dù đôi khi những ngày có tình trạng giao thông đặc biệt xấu có thể vượt quá giá trị này.
`OPTIMISTIC`	Cho biết thời lượng được trả về phải ngắn hơn thời gian di chuyển thực tế vào hầu hết các ngày, mặc dù đôi khi vào những ngày có điều kiện giao thông đặc biệt tốt, thời gian di chuyển có thể nhanh hơn giá trị này.

TransitAgency

Một công ty vận tải vận hành một tuyến vận tải.

Trường

name

string

Tên của công ty vận tải này.

phone_number

string

Số điện thoại của công ty vận tải theo định dạng theo ngôn ngữ của địa phương.

uri

string

URI của công ty vận tải.

TransitLine

Chứa thông tin về tuyến phương tiện công cộng được sử dụng trong bước này.

Trường
`agencies[]`	`TransitAgency` Công ty vận tải (hoặc các công ty vận tải) vận hành tuyến phương tiện công cộng này.
`name`	`string` Tên đầy đủ của tuyến phương tiện công cộng này. Ví dụ: "8 Avenue Local".
`uri`	`string` URI cho tuyến phương tiện công cộng này do công ty vận tải cung cấp.
`color`	`string` Màu sắc thường dùng trong biển báo cho tuyến đường này. Được biểu thị bằng hệ thập lục phân.
`icon_uri`	`string` URI cho biểu tượng liên kết với dòng này.
`name_short`	`string` Tên ngắn của tuyến phương tiện công cộng này. Tên này thường là số dòng, chẳng hạn như "M7" hoặc "355".
`text_color`	`string` Màu thường dùng trong văn bản trên biển báo cho tuyến này. Được biểu thị bằng hệ thập lục phân.
`vehicle`	`TransitVehicle` Loại phương tiện hoạt động trên tuyến phương tiện công cộng này.

TransitPreferences

Lựa chọn ưu tiên cho các tuyến đường dựa trên TRANSIT ảnh hưởng đến tuyến đường được trả về.

Trường

allowed_travel_modes[]

TransitTravelMode

Một tập hợp các chế độ di chuyển để sử dụng khi nhận được tuyến TRANSIT. Mặc định là tất cả các phương tiện di chuyển được hỗ trợ.

routing_preference

TransitRoutingPreference

Một tuỳ chọn định tuyến, khi được chỉ định, sẽ ảnh hưởng đến tuyến TRANSIT được trả về.

TransitRoutingPreference

Chỉ định lựa chọn ưu tiên định tuyến cho các tuyến phương tiện công cộng.

Enum
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	Chưa chỉ định lựa chọn ưu tiên.
`LESS_WALKING`	Cho biết tuyến đường được tính toán nên ưu tiên đi bộ ở mức hạn chế.
`FEWER_TRANSFERS`	Cho biết tuyến đường được tính toán nên ưu tiên số lượng chuyến chuyển phương tiện có giới hạn.

TransitTravelMode

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

Enum
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	Không chỉ định phương thức di chuyển bằng phương tiện công cộng.
`BUS`	Đi bằng xe buýt.
`SUBWAY`	Đi tàu điện ngầm.
`TRAIN`	Đi tàu hỏa.
`LIGHT_RAIL`	Đi bằng tàu điện hoặc xe điện.
`RAIL`	Đi bằng tàu hỏa. Điều này tương đương với tổ hợp `SUBWAY`, `TRAIN` và `LIGHT_RAIL`.

TransitStop

Thông tin về trạm trung chuyển.

Trường

name

string

Tên của điểm dừng phương tiện công cộng.

location

Location

Vị trí của trạm dừng được biểu thị bằng toạ độ vĩ độ/kinh độ.

TransitVehicle

Thông tin về một phương tiện được sử dụng trong tuyến xe buýt.

Trường
`name`	`LocalizedText` Tên của xe này, viết hoa.
`type`	`TransitVehicleType` Loại xe được sử dụng.
`icon_uri`	`string` URI cho một biểu tượng liên kết với loại xe này.
`local_icon_uri`	`string` URI cho biểu tượng liên kết với loại xe này, dựa trên biển báo phương tiện giao thông địa phương.

TransitVehicleType

Loại phương tiện cho tuyến đường công cộng.

Enum
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	Không sử dụng.
`BUS`	Xe buýt.
`CABLE_CAR`	Xe hoạt động trên cáp, thường là trên mặt đất. Cáp treo có thể thuộc loại `GONDOLA_LIFT`.
`COMMUTER_TRAIN`	Tàu chở khách đi làm.
`FERRY`	Phà.
`FUNICULAR`	Một chiếc xe được kéo lên dốc bằng cáp. Tàu điện trên cáp thường bao gồm hai toa, mỗi toa đóng vai trò là đối trọng cho toa còn lại.
`GONDOLA_LIFT`	Một chiếc cáp treo trên không.
`HEAVY_RAIL`	Đường sắt nặng.
`HIGH_SPEED_TRAIN`	Tàu cao tốc.
`INTERCITY_BUS`	Xe buýt liên thành phố.
`LONG_DISTANCE_TRAIN`	Tàu đường dài.
`METRO_RAIL`	Đường sắt đô thị.
`MONORAIL`	Tàu một ray.
`OTHER`	Tất cả các loại xe khác.
`RAIL`	Đường sắt.
`SHARE_TAXI`	Xe taxi đi chung là một loại xe buýt có thể đón và trả khách ở bất cứ đâu trên tuyến đường của xe.
`SUBWAY`	Xe điện ngầm.
`TRAM`	Xe điện trên mặt đất.
`TROLLEYBUS`	Xe điện bánh hơi.

Đơ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 hiển thị.

Enum
`UNITS_UNSPECIFIED`	Chưa chỉ định đơn vị đo lường. Mặc định là đơn vị đo lường được suy ra từ yêu cầu.
`METRIC`	Đơn vị đo lường theo hệ mét.
`IMPERIAL`	Đơn vị đo lường theo hệ Anh.

VehicleEmissionType

Một tập hợp các giá trị mô tả loại khí thải của xe. Chỉ áp dụng cho 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.
`ELECTRIC`	Xe chạy bằng điện.
`HYBRID`	Xe chạy bằng nhiên liệu kết hợp (chẳng hạn như xăng + điện).
`DIESEL`	Xe chạy bằng dầu diesel.

VehicleInfo

Chứa thông tin về xe, chẳng hạn như loại khí thải của xe.

Trường

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 trung gian đá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 trung gian dọc theo tuyến đường.

Trường
`via`	`bool` Đánh dấu điểm trung gian này là mốc quan trọng thay vì điểm dừng. Đối với mỗi điểm trung gian không phải là điểm trung gian trong yêu cầu, phản hồi sẽ thêm một mục vào mảng `legs` để cung cấp thông tin chi tiết về điểm dừng chân trên chặng đó của chuyến đi. Đặt giá trị này thành true khi bạn muốn tuyến đường đi qua điểm trung gian này mà không dừng lại. Điểm trung gian không làm cho một mục nhập được thêm vào mảng `legs`, nhưng các điểm trung gian này sẽ định tuyến hành trình thông qua điểm trung gian. Bạn chỉ có thể đặt giá trị này trên các đ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 trung gian cuối cùng. 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 điểm trung gian là nơi xe dừng lại để đó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 trung gian không phải `via` trên những con đường không phù hợp để đón và trả khách. Tuỳ chọn này chỉ hoạt động đối với các chế độ di chuyển `DRIVE` và `TWO_WHEELER`, cũng như khi `location_type` là `Location`.
`side_of_road`	`bool` Cho biết vị trí của điểm trung gian này là để ưu tiên xe dừng ở một bên đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí đó để xe có thể dừng ở bên đường mà vị trí đó nghiêng về phía trung tâm đường. Tuỳ chọn này chỉ hoạt động với `DRIVE` và `TWO_WHEELER` `RouteTravelMode`.
Trường hợp hợp nhất `location_type`. Các cách khác nhau để biểu thị một vị trí. `location_type` chỉ có thể là một trong những loại sau:
`location`	`Location` Một điểm được chỉ định bằng toạ độ địa lý, bao gồm cả tiêu đề không bắt buộc.
`place_id`	`string` Mã địa điểm POI được liên kết với điểm trung gian.
`address`	`string` Địa chỉ mà con người đọc được hoặc plus code. Hãy xem https://plus.codes để biết thông tin chi tiết.