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

API Tuyến đường.

ComputeRouteMatrix

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

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Lấy danh sách điểm gốc và điểm đến rồi trả về luồng chứa thông tin tuyến đường cho từng tổ hợp điểm gốc và điểm đến.

LƯU Ý: Phương pháp 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ạ cho trường (field mask) bằng cách sử dụng tham số URL $fields hoặc fields, hoặc tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tham số và tiêu đề URL có sẵn). Giá trị là một danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết này về cách tạo đường dẫn trường.

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

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

Điều quan trọng là bạn phải thêm status vào mặt nạ cho trường (field mask) vì nếu không thì tất cả thông báo sẽ có vẻ như bình thường. Google không khuyến khích việc sử dụng mặt nạ cho trường phản hồi ký tự đại diện (*) vì:

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

LƯU Ý: Phương pháp 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 có sẵn). Giá trị là một danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách tạo đường dẫn trường.

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

Mặt nạ cho trường (field mask) của tất cả các trường có sẵn (để kiểm tra thủ công): X-Goog-FieldMask: *
Mặt nạ trường của thời lượng, khoảng cách và hình nhiều đường ở cấp tuyến đường (ví dụ về cách thiết lập chính thức): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

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

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

ComputeRouteMatrixRequest

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

Trường
`origins[]`	`RouteMatrixOrigin` Bắt buộc. Mảng nguồn gốc xác định các hàng của ma trận phản hồi. Một số quy định hạn chế về kích thước áp dụng cho lượng số của nguồn gốc và đích đến: Tổng số lượng nguồn gốc + số lượng đích đến được chỉ định là `place_id` hoặc `address` không được lớn hơn 50. Tích số của số nguồn gốc × số lượng đích đến không được lớn hơn 625 trong mọi trường hợp. Tích của số lượng nguồn gốc × số lượng đích đến không được lớn hơn 100 nếu4_t_preference được đặt thành `TRAFFIC_AWARE_OPTIMAL`. Tích của số lượng điểm gốc × số đ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 các đích đến xác định các cột của ma trận phản hồi.
`travel_mode`	`RouteTravelMode` Không bắt buộc. Chỉ định phương thức di chuyển.
`routing_preference`	`RoutingPreference` Không bắt buộc. Chỉ định cách tính toán tuyến. Máy chủ 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ễ quá dài, 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 theo thời gian bạn thực hiện 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 Ý: 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 thể 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 Mã nhận dạng ngôn ngữ Unicode. Xem trang Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên.
`region_code`	`string` Không bắt buộc. Mã vùng được chỉ định ở dạng ccTLD (miền cấp cao nhất) gồm 2 ký tự. Để biết thêm thông tin, hãy xem phần Miền cấp cao nhất của 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ể dùng để hoàn tất yêu cầu. Lưu ý: Những phép tính bổ sung này có thể trả về các trường bổ sung trong câu trả lời. Các trường bổ sung này cũng phải được chỉ định trong mặt nạ trường (field mask) để được trả về trong phản hồi.
`traffic_model`	`TrafficModel` Không bắt buộc. Nêu các giả định cần sử dụng khi tính thời gian 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 `RouteMatrixElement`, chứa thời gian dự đoán cho lưu lượng truy cập dựa trên mức trung bình trước đây. `RoutingPreference` đến `TRAFFIC_AWARE_OPTIMAL` và `RouteTravelMode` thành `DRIVE`. Giá trị 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 lựa chọn ưu tiên ảnh hưởng đến tuyến được trả về cho các tuyến `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 cước phí 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 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), cho phép dừng hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
`travel_mode`	`RouteTravelMode` Không bắt buộc. Chỉ định phương thức di chuyển.
`routing_preference`	`RoutingPreference` Không bắt buộc. Chỉ định cách tính toán tuyến. Máy chủ cố gắng sử dụng 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ễ 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.
`polyline_quality`	`PolylineQuality` Không bắt buộc. Chỉ định tuỳ chọn của bạn về chất lượng của hình nhiều đường.
`polyline_encoding`	`PolylineEncoding` Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho hình nhiều đường.
`departure_time`	`Timestamp` Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định theo thời gian bạn thực hiện 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`. Các chuyến đi bằng phương tiện công cộng có sẵn tối đa 7 ngày trước đây hoặc 100 ngày trong tương lai.
`arrival_time`	`Timestamp` Không bắt buộc. Thời gian đến. LƯU Ý: 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 thể chỉ định cả hai. Các chuyến đi bằng phương tiện công cộng có sẵn tối đa 7 ngày trước đây hoặc 100 ngày trong tương lai.
`compute_alternative_routes`	`bool` Không bắt buộc. Chỉ định xem có tính toán các tuyến thay thế ngoài tuyến đường hay không. Không có tuyến thay thế nào được trả về cho các yêu cầu có điểm tham chiếu trung gian.
`route_modifiers`	`RouteModifiers` Không bắt buộc. Một tập hợp các điều kiện cần đáp ứng sẽ ả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 phần Mã nhận dạng ngôn ngữ Unicode. Xem trang Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của yêu cầu định tuyến.
`region_code`	`string` Không bắt buộc. Mã vùng được chỉ định ở dạng ccTLD (miền cấp cao nhất) gồm 2 ký tự. Để biết thêm thông tin, hãy xem phần Miền cấp cao nhất của 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 tuyến đường, chặng đường, quãng đường bước và thời lượng. Nếu bạn không cung cấp giá trị này thì đơn vị hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên.
`optimize_waypoint_order`	`bool` Không bắt buộc. Nếu bạn đặt chính sách này thành true (đúng), dịch vụ sẽ cố gắng giảm thiểu tổng chi phí của tuyến bằng cách sắp xếp lại thứ tự các điểm tham chiếu trung gian đã chỉ định. Yêu cầu sẽ không thành công nếu bất kỳ điểm tham chiếu trung gian nào là điểm tham chiếu `via`. Sử dụng `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` để tìm đơn đặt hàng mới. Nếu không yêu cầu `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index` trong tiêu đề `X-Goog-FieldMask`, thì yêu cầu đó sẽ không thành công. Nếu bạn đặt `optimize_waypoint_order` thành false (sai), `ComputeRoutesResponse.optimized_intermediate_waypoint_index` sẽ trống.
`requested_reference_routes[]`	`ReferenceRoute` Không bắt buộc. Chỉ định các tuyến tham chiếu cần tính toán trong yêu cầu ngoài tuyến mặc định. Tuyến tham chiếu là một 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ụ: cách tính toán tuyến tham chiếu `FUEL_EFFICIENT` sẽ xem xét nhiều tham số để 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 tất yêu cầu. Lưu ý: Những phép tính bổ sung này có thể trả về các trường bổ sung trong câu trả lời. Các trường bổ sung này cũng phải được chỉ định trong mặt nạ trường (field mask) để được trả về trong phản hồi.
`traffic_model`	`TrafficModel` Không bắt buộc. Nêu các giả định cần sử dụng khi tính thời gian 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`, có 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`. Giá trị 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 lựa chọn ưu tiên ảnh hưởng đến tuyến được trả về cho các tuyến `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`	Hình nhiều đường nhận biết 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 dùng để đọc nguyên trạng. Nội dung này chỉ dành cho mục đích hiển thị. Đừng phân tích cú pháp cú pháp tìm kiếm theo trình tự.

ReferenceRoute

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. Những tuyến đường có gắn nhãn giá trị này được xác định là tối ưu hoá cho các tham số như mức tiêu thụ nhiên liệu.

ComputeRoutesResponse

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

Trường

Trường
`routes[]`	`Route` Chứa một mảng các tuyến được tính toán (tối đa 3) khi bạn chỉ định `compute_alternatives_routes` và chỉ chứa một tuyến khi bạn không chỉ định. Khi mảng này chứa nhiều mục nhập, mục đầu tiên sẽ là tuyến được đề xuất nhiều nhất. Nếu mảng trống thì tức là không tìm thấy tuyến nào.
`fallback_info`	`FallbackInfo` Trong một số trường hợp khi không thể tính toán kết quả định tuyến với tất cả tuỳ chọn đầu vào, máy chủ có thể dự phòng sang sử dụng một cách tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.
`geocoding_results`	`GeocodingResults` Chứa thông tin phản hồi mã hoá địa lý cho các điểm tham chiếu được chỉ định dưới dạng địa chỉ.

routes[]

Route

Chứa một mảng các tuyến được tính toán (tối đa 3) khi bạn chỉ định compute_alternatives_routes và chỉ chứa một tuyến khi bạn không chỉ định. Khi mảng này chứa nhiều mục nhập, mục đầu tiên sẽ là tuyến được đề xuất nhiều nhất. Nếu mảng trống thì tức là không tìm thấy tuyến nào.

fallback_info

FallbackInfo

Trong một số trường hợp khi không thể tính toán kết quả định tuyến với tất cả tuỳ chọn đầu vào, máy chủ có thể dự phòng sang sử dụng một cách tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.

geocoding_results

GeocodingResults

Chứa thông tin phản hồi mã hoá địa lý cho các điểm tham chiếu đượ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ì có nghĩa là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ ưu tiên của bạn làm chế độ dự phòng.

Trường

Trường
`routing_mode`	`FallbackRoutingMode` Chế độ định tuyến dùng cho phản hồi. Nếu tính năng dự phòng được kích hoạt, chế độ đó 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 phản hồi dự phòng được sử dụng thay cho câu trả lờ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 dùng cho phản hồi. Nếu tính năng dự phòng được kích hoạt, chế độ đó 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 phản hồi dự phòng được sử dụng thay cho câu trả lờ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 tính nă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 đường với chế độ định tuyến ưa thích của bạn, nhưng chúng tôi đã có thể trả về một kết quả được tính 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 mà bạn ưu tiên đúng giờ, nhưng chúng tôi đã có thể trả về kết quả do chế độ thay thế tính toán.

FallbackRoutingMode

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` `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ề vị trí được dùng làm điểm tham chiếu. Chỉ được điền cho đ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 xác định địa chỉ được mã hoá địa lý đến.

Trường
`geocoder_status`	`Status` Cho biết mã trạng thái do thao tác mã hoá địa lý tạo ra.
`type[]`	`string` (Các) loại kết quả, ở dạng 0 hoặc nhiều thẻ loại. 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 rằng bộ mã hoá đị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ù bộ mã hoá có thể khớp với một phần địa chỉ được yêu cầu. Bạn có thể kiểm tra lỗi chính tả trong yêu cầu ban đầu và/hoặc địa chỉ chưa hoàn chỉnh.
`place_id`	`string` Mã địa điểm cho kết quả này.
`intermediate_waypoint_request_index`	`int32` Chỉ mục của điểm tham chiếu trung gian tương ứng trong yêu cầu. Chỉ được điền nếu điểm tham chiếu tương ứng là điểm tham chiếu trung gian.

GeocodingResults

Chứa GeocodedWaypoints cho điểm gốc, điểm đến và điểm tham chiếu trung gian. Chỉ được điền cho điểm tham chiếu địa chỉ.

Trường

Trường
`origin`	`GeocodedWaypoint` Điểm tham chiếu được mã hoá địa lý tại nguồn gốc.
`destination`	`GeocodedWaypoint` Điểm tham chiếu được mã hoá địa lý cho đích đến.
`intermediates[]`	`GeocodedWaypoint` Danh sách các điểm tham chiếu được mã hoá địa lý 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 tham chiếu được mã hoá địa lý tại nguồn gốc.

destination

GeocodedWaypoint

Điểm tham chiếu được mã hoá địa lý cho đích đến.

intermediates[]

GeocodedWaypoint

Danh sách các điểm tham chiếu được mã hoá địa lý 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.

LocalizedTime

Mô tả thời gian đã bản địa hoá.

Trường

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

time

LocalizedText

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

time_zone

string

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

Vị trí

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

Trường

Trường
`lat_lng`	`LatLng` Toạ độ địa lý của điểm tham chiếu.
`heading`	`Int32Value` Hướng la bàn được liên kết với hướng của luồng giao thông. Giá trị này chỉ định lề đường cho đón và trả xe. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định tiêu đề của phía Bắc, 90 chỉ định tiêu đề của phía Đô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

Hướng la bàn được liên kết với hướng của luồng giao thông. Giá trị này chỉ định lề đường cho đón và trả xe. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định tiêu đề của phía Bắc, 90 chỉ định tiêu đề của phía Đông, v.v. Bạn chỉ có thể sử dụng trường này cho DRIVE và TWO_WHEELER RouteTravelMode.

Điều khiển

Tập hợp các giá trị chỉ định thao tác đ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 hoặc đi thẳng).

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.
`TURN_LEFT`	Quay sang 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.
`TURN_RIGHT`	Hãy rẽ phải.
`STRAIGHT`	Đi thẳng.
`RAMP_LEFT`	Đi theo đoạn đường nối bên trái.
`RAMP_RIGHT`	Đi vào đoạn đường nối bên phải.
`MERGE`	Hợp nhất vào giao thông.
`FORK_LEFT`	Đi theo ngã ba bên trái.
`FORK_RIGHT`	Đi theo ngã ba bên phải.
`FERRY`	Đi phà.
`FERRY_TRAIN`	Đi vào chuyến tàu dẫn lên phà.
`ROUNDABOUT_LEFT`	Rẽ trái tại chỗ đường vòng.
`ROUNDABOUT_RIGHT`	rẽ phải tại chỗ đường vòng.
`DEPART`	Thao tác ban đầu.
`NAME_CHANGE`	Được dùng để biểu thị việc thay đổi tên đường.

NavigationInstruction

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

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 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 cách thực hiện bước này.

Hình nhiều đường

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

Trường

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

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

encoded_polyline

string

Mã hoá chuỗi cho hình nhiều đường bằng thuật toán mã hoá nhiều đường

geo_json_linestring

Struct

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

PolylineEncoding

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

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

PolylineQuality

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

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

Trường
`route_labels[]`	`RouteLabel` Các nhãn cho `Route` rất hữu ích trong việc 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 khác.
`legs[]`	`RouteLeg` Một tập hợp các châ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 chặng không phải là `via` `Waypoints`. Ví dụ: tuyến đường không có điểm trung gian chỉ có một chặng. Tuyến đường có một điểm tham chiếu trung gian không phải `via` có hai chân. Tuyến đường có 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 đi lại của tuyến đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập `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.
`polyline`	`Polyline` Hình nhiều đường chung của tuyến đường. Hình nhiều đường này là hình nhiều đường kết hợp của tất cả `legs`.
`description`	`string` Nội dung mô tả về tuyến đường.
`warnings[]`	`string` Một mảng các cảnh báo sẽ xuất hiện khi cho thấy tuyến đường.
`viewport`	`Viewport` Hộp giới hạn khung nhìn của hình nhiều đường.
`travel_advisory`	`RouteTravelAdvisory` Thông tin bổ sung về tuyến đường.
`optimized_intermediate_waypoint_index[]`	`int32` Nếu bạn đặt `optimize_waypoint_order` thành true, trường này sẽ chứa thứ tự được tối ưu hoá của các điểm tham chiếu trung gian. Nếu không, trường này trống. Ví dụ: nếu bạn cung cấp dữ liệu đầu vào là Origin: LA; Điểm tham chiếu trung gian: Dallas, Bangor, Phoenix; Destination: New York; và thứ tự điểm tham chiếu được tối ưu hoá là Phoenix, Dallas, Bangor, thì trường này chứa các giá trị [2, 0, 1]. Chỉ mục bắt đầu bằng 0 cho điểm tham chiếu trung gian đầu tiên được cung cấp trong đầu vào.
`localized_values`	`RouteLocalizedValues` Văn bản đại diện cho các thuộc tính của `Route`.
`route_token`	`string` Mã thông báo tuyến đường được mã hoá base64 an toàn trên web, có thể được truyền đến SDK điều hướng, cho phép SDK điều hướng tạo lại tuyến đường trong khi điều hướng và trong trường hợp định tuyến lại, hãy thực hiện ý định ban đầu khi bạn tạo tuyến đường bằng cách gọi ComputeRoutes. Khách hàng nên coi mã thông báo này là một blob mờ. Tệp này không nhằm mục đích đọc hoặc thay đổi. 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 tham chiếu.

RouteLocalizedValues

Phần văn bản đại diện cho một số thuộc tính nhất định.

Trường
`distance`	`LocalizedText` Quãng đường đi được thể hiện dưới dạng văn bản.
`duration`	`LocalizedText` Thời lượng có tính đến điều kiện giao thông, được thể hiện dưới dạng văn bản. 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ẽ bằng với `static_duration`.
`static_duration`	`LocalizedText` Thời lượng không tính đến điều kiện giao thông, đượ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

Các nhãn cho Route rất hữu ích trong việc 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 khác.

Enum
`ROUTE_LABEL_UNSPECIFIED`	Mặc định – không được sử dụng.
`DEFAULT_ROUTE`	Tuyến "tốt nhất" mặc định được trả về để tính toán tuyến đường.
`DEFAULT_ROUTE_ALTERNATE`	Lựa chọn thay thế cho tuyến "tốt nhất" mặc định. Các tuyến 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. Những tuyến đường có gắn nhãn giá trị này được xác định là tối ưu hoá theo tham số Tiết kiệm nhiên liệu, chẳng hạn như mức tiêu thụ nhiên liệu.

RouteLeg

Chứa một phân đoạn giữa các điểm tham chiếu không phải là via.

Trường
`distance_meters`	`int32` Khoảng cách di chuyển của chặng 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 sẽ được tính có tính đến điều kiện lưu lượng truy cập.
`static_duration`	`Duration` Thời gian di chuyển qua chân, được tính toán mà không tính đến tình trạng giao thông.
`polyline`	`Polyline` Hình nhiều đường chung cho chân này bao gồm hình nhiều đường của mỗi `step`.
`start_location`	`Location` Vị trí bắt đầu của chân này. Vị trí này có thể khác với `origin` được cung cấp. Ví dụ: khi `origin` được cung cấp không nằm gần một con đường, thì đây là một điểm trên đường.
`end_location`	`Location` Vị trí kết thúc của chân này. Vị trí này có thể khác với `destination` được cung cấp. Ví dụ: khi `destination` được cung cấp không nằm gần một con đường, thì đây là một điểm trên đường.
`steps[]`	`RouteLegStep` Một mảng các bước biểu thị các phân đoạn trong chân này. Mỗi bước đại diện cho một hướng dẫn di chuyển.
`travel_advisory`	`RouteLegTravelAdvisory` Chứa thông tin bổ sung mà người dùng phải được thông báo, chẳng hạn như các khu vực hạn chế giao thông có thể xảy ra ở một chặng của tuyến đường.
`localized_values`	`RouteLegLocalizedValues` Văn bản đại diện cho 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 đường TRANSIT.

RouteLegLocalizedValues

Phần văn bản đại diện cho một số thuộc tính nhất định.

Trường

distance

LocalizedText

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

duration

LocalizedText

Thời lượng có tính đến điều kiện giao thông, được thể hiện dưới dạng văn bản. Lưu ý: Nếu bạn không yêu cầu thông tin lưu lượng truy cập, giá trị này sẽ giống với giá trị với static_duration.

static_duration

LocalizedText

Thời lượng không tính đến điều kiện giao thông, đượ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 sẽ không được điền nếu `RouteLeg` không chứa phân đoạn đa phương thức 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 sẽ không được điền nếu RouteLeg không chứa phân đoạn đa phương thức 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 định nghĩa là một hoặc nhiều RouteLegStep liền kề có cùng RouteTravelMode. Trường này sẽ không được điền nếu RouteLeg không chứa phân đoạn đa phương thức trong các bước.

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

RouteLegStep

Chứa một phân đoạn của RouteLeg. Mỗi bước tương ứng với một hướng dẫn điều hướng. Các chân tuyến đường được tạo thành từ các bướ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 tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị.
`polyline`	`Polyline` Hình nhiều đường liên kết với bước này.
`start_location`	`Location` Vị trí bắt đầu của bước này.
`end_location`	`Location` Vị trí kết thúc của bước này.
`navigation_instruction`	`NavigationInstruction` Hướng dẫn di chuyển.
`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ế về vùng giao thông có thể xảy ra) ở bước chân.
`localized_values`	`RouteLegStepLocalizedValues` Văn bản đại diện cho 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 phương tiện đi lại là `TRANSIT`.
`travel_mode`	`RouteTravelMode` Phương tiện đi lại dùng cho bước này.

RouteLegStepLocalizedValues

Phần văn bản đại diện cho một số thuộc tính nhất định.

Trường

distance

LocalizedText

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

static_duration

LocalizedText

Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản.

RouteLegStepTransitDetails

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

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

TransitDetailsLocalizedValues

Mô tả giá trị đã bản địa hoá cho RouteTransitDetails.

Trường

Trường
`arrival_time`	`LocalizedTime` Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng.
`departure_time`	`LocalizedTime` Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng.

arrival_time

LocalizedTime

Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng.

departure_time

LocalizedTime

Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng.

TransitStopDetails

Thông tin chi tiết về điểm dừng phương tiện công cộng cho RouteLegStep.

Trường
`arrival_stop`	`TransitStop` Thông tin về điểm dừng đến cho bước này.
`arrival_time`	`Timestamp` Thời gian đến dự kiến cho bước này.
`departure_stop`	`TransitStop` Thông tin về điểm dừng khởi hành cho bước này.
`departure_time`	`Timestamp` Thời gian khởi hành dự kiến 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 hạn chế về vùng giao thông có thể xảy ra đối với bước chân.

Trường

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

speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

Chứa thông tin bổ sung mà người dùng sẽ được thông báo về bước chân, chẳng hạn như các quy định hạn chế về khu vực giao thông có thể xảy ra.

Trường

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

speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn định tuyến ưu tiên của TRAFFIC_AWARE và TRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian bao phủ toàn bộ hình nhiều đường của RouteLeg mà không chồng chéo. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng thời gian trước đó.

Ví dụ:

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

RouteMatrixDestination

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

Trường

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

waypoint

Waypoint

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

RouteMatrixElement

Chứa thông tin tuyến đường được tính toán cho cặp nguồn gốc/đích đến trong API ComputeRouteMatrix. Proto này có thể được truyền trực tuyến đến ứng dụng khách.

Trường
`status`	`Status` Mã trạng thái lỗi của phần tử này.
`condition`	`RouteMatrixElementCondition` Cho biết liệu tuyến đường có được tìm thấy hay không. Không phụ thuộc vào trạng thái.
`distance_meters`	`int32` Khoảng cách đi lại của tuyến đường, tính bằng mét.
`duration`	`Duration` Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập `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 với các tuỳ chọn đã cho cho cặp điểm 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 sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.
`localized_values`	`LocalizedValues` Văn bản đại diện cho các thuộc tính của `RouteMatrixElement`.
`origin_index`	`int32` Chỉ mục gốc 0 của nguồn gốc trong yêu cầu.
`destination_index`	`int32` Chỉ mục dựa trên 0 của đích đến trong yêu cầu.

LocalizedValues

Phần văn bản đại diện cho một số thuộc tính nhất định.

Trường
`distance`	`LocalizedText` Quãng đường đi được thể hiện dưới dạng văn bản.
`duration`	`LocalizedText` Thời lượng được biểu thị ở dạng văn bản có tính đến điều kiện giao thông. Lưu ý: Nếu hệ thống không yêu cầu thông tin lưu lượng truy cập, thì giá trị này giống với static_duration.
`static_duration`	`LocalizedText` Thời lượng được biểu thị dưới dạng văn bản mà không tính đến điều kiện giao thông.
`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 được trả về.

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

RouteMatrixOrigin

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

Trường

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

Trường
`avoid_tolls`	`bool` Khi bạn đặt chính sách này thành true (đúng), hãy tránh các đường có thu phí ở mức hợp lý, ư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` Khi đặt thành đúng, hãy tránh đường cao tốc khi hợp lý, ưu tiên các tuyến đường không chứa đường cao tốc. Chỉ áp dụng cho `DRIVE` và `TWO_WHEELER` `RouteTravelMode`.
`avoid_ferries`	`bool` Khi bạn đặt thành true, sẽ tránh phà khi hợp lý, ưu tiên các tuyến đường không chứa phà. Chỉ áp dụng cho `DRIVE` và `TWO_WHEELER` `RouteTravelMode`.
`avoid_indoor`	`bool` Khi bạn đặt chính sách này thành true (đúng), hãy tránh điều hướng trong nhà ở vị trí hợp lý, ưu tiên các tuyến đường không chứa tính năng chỉ đường trong nhà. Chỉ áp dụng cho `WALK` `RouteTravelMode`.
`vehicle_info`	`VehicleInfo` Chỉ định thông tin về xe.
`toll_passes[]`	`TollPass` Đóng gói thông tin về phí cầu đường. Nếu có cung cấp phí cầu đường, API sẽ cố gắng trả về giá vé. Nếu phí cầu đường không được cung cấp, API sẽ coi phí cầu đường là không xác định và cố gắng trả lại giá 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 phải được biết, chẳng hạn như các hạn chế về khu vực giao thông có thể xảy ra.

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 phí lưu thông dự kiến trên tuyến đường. Nếu bạn đặt trường này nhưng trường phụ `estimatedPrice` chưa được điền thì tuyến đường sẽ chứa phí cầu đường nhưng giá ước tính là chưa xác định. Nếu bạn không đặt trường này thì sẽ không có trạm thu phí dự kiến trên tuyến đường này.
`speed_reading_intervals[]`	`SpeedReadingInterval` Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn định tuyến ưu tiên của `TRAFFIC_AWARE` và `TRAFFIC_AWARE_OPTIMAL`. Các khoảng này bao gồm toàn bộ hình nhiều đường của tuyến đường mà không chồng chéo nhau. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng 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 trả về có thể có những hạn chế không phù hợp cho phương tiện đi lại được yêu cầu hoặc đối tượng sửa đổi tuyến đường.
`transit_fare`	`Money` Nếu có, hãy chứa tổng giá vé hoặc phí vé của chặng bay này. Cơ sở lưu trú này chỉ được trả về cho các yêu cầu `TRANSIT` và chỉ cho những tuyến đường có thông tin giá vé cho tất cả các bước đi phương tiện công cộng.

RouteTravelMode

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 trong giai đoạn beta 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 cho người dùng thấy cảnh báo này trên mọi tuyến đường đi bộ, đi xe đạp và đi xe hai bánh mà bạn hiển thị trong ứng dụng của mình.

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 xe ô tô.
`BICYCLE`	Đi bằng xe đạp.
`WALK`	Di chuyển bằng cách đi bộ.
`TWO_WHEELER`	Xe có động cơ hai bánh. Ví dụ: xe mô tô. Xin lưu ý rằng chế độ này khác với chế độ đi lại `BICYCLE` vốn áp dụng chế độ sử dụng năng lượng của con người.
`TRANSIT`	Di chuyển bằng các tuyến phương tiện công cộng (nếu có).

RoutingPreference

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

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

SpeedReadingInterval

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

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

Tốc độ

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

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

TollInfo

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

Trường

Trường
`estimated_price[]`	`Money` Số tiền phí cầu đường cho `Route` hoặc `RouteLeg` tương ứng. Danh sách này chứa số tiền cho mỗi đơn vị tiền tệ mà các trạm thu phí dự kiến sẽ thu. Thông thường, danh sách này sẽ chỉ chứa một mục cho các tuyến đường có thu phí bằng một đơn vị tiền tệ. Đối với các chuyến đi quốc tế, danh sách này có thể chứa nhiều mục để 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à các trạm thu phí dự kiến sẽ thu. Thông thường, danh sách này sẽ chỉ chứa một mục cho các tuyến đường có thu phí bằng một đơn vị tiền tệ. Đối với các chuyến đi quốc tế, danh sách này có thể chứa nhiều mục để phản ánh phí cầu đường bằng các đơn vị tiền tệ khác nhau.

TollPass

Danh sách các thẻ thu 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 tại https://www.tollpay.com.au.
`AU_LINKT`	Phí cầu đường 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 chi tiết tại https://telepase.com.ar
`BR_AUTO_EXPRESO`	Phí cầu đường Brazil. Xem thêm thông tin chi tiết tại https://www.autoexpreso.com
`BR_CONECTCAR`	Phí cầu đường Brazil. 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 chi tiết 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. 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`	Canada đến cửa khẩu biên giới Hoa Kỳ.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Canada đến cửa khẩu biên giới Hoa Kỳ.
`CA_US_BLUE_WATER_EDGE_PASS`	Ontario, Canada đến đường biên giới giữa Hoa Kỳ và Michigan.
`CA_US_CONNEXION`	Ontario, Canada đến đường biên giới giữa Hoa Kỳ và Michigan.
`CA_US_NEXUS_CARD`	Canada đến cửa khẩu biên giới 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 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ố xe của tiểu bang HP.
`JP_ETC`	Nhật Bản ETC. Hệ thống không dây điện tử thu phí cầu đường. https://www.go-etc.jp/
`JP_ETC2`	Nhật Bản ETC2.0. Phiên bản mới của ETC có thêm chiết khấu và hỗ trợ 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`	Phí cầu đường 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 tại Mexico. Một trong số đó đang hoạt động tại thành phố Mexico. Xem thêm thông tin chi tiết tại https://www.televia.com.mx.
`MX_TELEVIA`	Công ty thu phí cầu đường tại Mexico. Một trong nhiều công ty hoạt động ở Thành phố Mexico. https://www.televia.com.mx
`MX_VIAPASS`	Phí cầu đường Mexico. Xem thêm thông tin 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`	CA, Hoa Kỳ.
`US_CA_FASTRAK_CAV_STICKER`	Cho biết rằng tài xế có thẻ FasTrak bất kỳ ngoài hình dán Xe khí sạch (CAV) do DMV cấp. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, Hoa Kỳ.
`US_CO_GO_PASS`	CO, Hoa Kỳ.
`US_DE_EZPASSDE`	Đức, Hoa Kỳ.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	FL, Hoa Kỳ.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	FL, Hoa Kỳ.
`US_FL_EPASS`	FL, Hoa Kỳ.
`US_FL_GIBA_TOLL_PASS`	FL, Hoa Kỳ.
`US_FL_LEEWAY`	FL, Hoa Kỳ.
`US_FL_SUNPASS`	FL, Hoa Kỳ.
`US_FL_SUNPASS_PRO`	FL, Hoa Kỳ.
`US_IL_EZPASSIL`	IL, Hoa Kỳ.
`US_IL_IPASS`	IL, Hoa Kỳ.
`US_IN_EZPASSIN`	Ấn Độ, Hoa Kỳ.
`US_KS_BESTPASS_HORIZON`	KS, Hoa Kỳ.
`US_KS_KTAG`	KS, Hoa Kỳ.
`US_KS_NATIONALPASS`	KS, Hoa Kỳ.
`US_KS_PREPASS_ELITEPASS`	KS, Hoa Kỳ.
`US_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_BCPASS`	MI, Hoa Kỳ.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI, Hoa Kỳ.
`US_MI_IQ_PROX_CARD`	MI, Hoa Kỳ. Không dùng nữa vì loại thẻ và vé này không còn tồn tại. Mục này không được dùng nữa!
`US_MI_IQ_TAG`	MI, Hoa Kỳ.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	MI, Hoa Kỳ.
`US_MI_NEXPRESS_TOLL`	MI, Hoa Kỳ.
`US_MN_EZPASSMN`	MN, Hoa Kỳ.
`US_NC_EZPASSNC`	NC, Hoa Kỳ.
`US_NC_PEACH_PASS`	NC, Hoa Kỳ.
`US_NC_QUICK_PASS`	NC, Hoa Kỳ.
`US_NH_EZPASSNH`	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_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`	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_MOV_PASS`	WV, Hoa Kỳ
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, Hoa Kỳ.

TrafficModel

Nêu các giả định cần sử dụng khi tính thời gian 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 rằng `duration` được trả về phải là thời gian di chuyển ước tính chính xác nhất, dựa trên những gì đã biết về cả tình trạng giao thông trước đây và giao thông trực tiếp. Giao thông trực tiếp càng quan trọng hơn khi gần đến thời điểm `departure_time` hơn.
`PESSIMISTIC`	Cho biết rằng thời gian được trả về phải dài hơn thời gian di chuyển thực tế trong hầu hết các ngày, mặc dù thỉnh thoảng những ngày có điều kiện giao thông đặc biệt xấu có thể vượt quá giá trị này.
`OPTIMISTIC`	Cho biết rằng thời gian trả về phải ngắn hơn thời gian di chuyển thực tế trong hầu hết các ngày, mặc dù thỉnh thoảng những ngày có điều kiện giao thông đặc biệt tốt có thể nhanh hơn giá trị này.

TransitAgency

Công ty vận tải điều hành đường chuyển tuyến.

Trường

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ó định dạng dành riêng cho từng khu vực của công ty vận tải.
`uri`	`string` URI của công ty vận tải.

name

string

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

phone_number

string

Số điện thoại có định dạng dành riêng cho từng khu vực của công ty vận tải.

uri

string

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

TransitLine

Chứa thông tin về đường chuyển tuyến được 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 quảng cáo) điều hành đường chuyển tuyến này.
`name`	`string` Tên đầy đủ của đường chuyển tuyến này, ví dụ: "8 Avenue Local".
`uri`	`string` URI cho đường chuyển tuyến này do công ty vận tải cung cấp.
`color`	`string` Màu sắc thường được sử dụng trong bảng hiệu cho đườ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 đường chuyển tuyến 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 sắc thường được sử dụng trong văn bản trên bảng hiệu cho dòng 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 đường chuyển tuyến này.

TransitPreferences

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

Trường

allowed_travel_modes[]

TransitTravelMode

Một nhóm các chế độ đi lại để sử dụng khi nhận tuyến đường TRANSIT. Chế độ mặc định là mọi phương tiện đi lại được hỗ trợ.

routing_preference

TransitRoutingPreference

Một lựa chọn ưu tiên định tuyến (khi được chỉ định) sẽ ảnh hưởng đến tuyến TRANSIT được trả về.

TransitRoutingPreference

Chỉ định tuỳ chọn định tuyến cho các tuyến đường chuyển tuyến.

Enum
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	Chưa chỉ định tùy chọn.
`LESS_WALKING`	Cho biết tuyến đường được tính toán nên đi bộ hạn chế.
`FEWER_TRANSFERS`	Cho biết tuyến đường được tính toán nên có số lượng phương tiện hạn chế.

TransitTravelMode

Tập hợp các giá trị dùng để chỉ định phương thức di chuyển.

Enum
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	Chưa chỉ định phương tiện công cộng nào.
`BUS`	Di chuyển bằng xe buýt.
`SUBWAY`	Di chuyển bằng tàu điện ngầm.
`TRAIN`	Di chuyển bằng tàu hoả.
`LIGHT_RAIL`	Đi bằng tàu điện hoặc xe điện.
`RAIL`	Di chuyển bằng tàu lửa. Điều này tương đương với việc kết hợp `SUBWAY`, `TRAIN` và `LIGHT_RAIL`.

TransitStop

Thông tin về điểm dừng phương tiện công cộng.

Trường

name

string

Tên của điểm dừng chuyển tuyến.

location

Location

Vị trí của điểm dừng được thể hiện bằng vĩ độ/kinh độ.

TransitVehicle

Thông tin về một loại xe được sử dụng trên các tuyến đường phương tiện công cộng.

Trường
`name`	`LocalizedText` Tên của chiếc xe này, được viết hoa.
`type`	`TransitVehicleType` Loại phương tiện được sử dụng.
`icon_uri`	`string` URI cho 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 phương tiện này, dựa trên biển hiệu phương tiện giao thông địa phương.

TransitVehicleType

Loại phương tiện cho các tuyến đường chuyển tuyến.

Enum
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	Không sử dụng.
`BUS`	Xe buýt.
`CABLE_CAR`	Phương tiện vận hành bằng cáp, thường ở trên mặt đất. Cáp treo trên không 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 bị cáp kéo lên dốc. Xe lửa có dây kéo thường bao gồm hai toa, mỗi toa đóng vai trò là đối trọng của xe còn lại.
`GONDOLA_LIFT`	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`	Chuyến tàu đường dài.
`METRO_RAIL`	Phương tiện công cộng bằng xe điện.
`MONORAIL`	Xe lửa chạy trên đường một ray.
`OTHER`	Tất cả các xe khác.
`RAIL`	Đường sắt.
`SHARE_TAXI`	Taxi đi chung là một loại xe buýt có khả năng trả khách và đón khách ở bất cứ đâu trên tuyến đường.
`SUBWAY`	Tàu điện ngầm.
`TRAM`	Phía trên đường sắt điện trên mặt đất.
`TROLLEYBUS`	Xe điện.

Đơn vị

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

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

VehicleEmissionType

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. Mặc định là `GASOLINE`.
`GASOLINE`	Xe chạy bằng xăng/xăng.
`ELECTRIC`	Xe chạy điện.
`HYBRID`	Xe sử dụng nhiên liệu kết hợp (chẳng hạn như xe chạy bằng xăng + xe điện).
`DIESEL`	Xe chạy bằng động cơ 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 tham chiếu đánh dấu cả điểm bắt đầu và kết thúc của một tuyến đường và bao gồm các điểm dừng trung gian dọc theo tuyến đường.

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