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.BridgeInfo (thông báo)
• PolylineDetails.FlyoverInfo (thông báo)
• PolylineDetails.NarrowRoadInfo (thông báo)
• PolylineDetails.PolylinePointIndex (thông báo)
• PolylineDetails.RestrictionInfo (thông báo)
• PolylineDetails.RoadFeatureState (enum)
• PolylineDetails.SkywayInfo (thông báo)
• PolylineDetails.TunnelInfo (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)
• VehicleInfo.HazardousGoodsType (enum)
• VehicleInfo.TrailerInfo (thông báo)
• Waypoint (thông báo)

Tuyến đường

Routes API.

ComputeRouteMatrix

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

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

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ố 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ố điểm xuất phát + số đ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. 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 100 nếu routing_preference được đặt thành TRAFFIC_AWARE_OPTIMAL. 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 100 nếu travel_mode được đặt thành TRANSIT.
destinations[]	RouteMatrixDestination Bắt buộc. Mảng đích đến, xác định các cột của ma trận phản hồi.
travel_mode	RouteTravelMode Không bắt buộc. Chỉ định phương tiện giao thông.
routing_preference	RoutingPreference Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ cố gắng sử dụng lựa chọn ưu tiên về định tuyến đã chọn để tính toán tuyến đường. Nếu lựa chọn ưu tiên về định tuyến dẫn đến lỗi hoặc độ trễ quá dài, thì sẽ trả về lỗi. Bạn chỉ có thể chỉ định lựa chọn này khi travel_mode là DRIVE hoặc TWO_WHEELER. Nếu không, yêu cầu sẽ không thành công.
departure_time	Timestamp Không bắt buộc. Giờ khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời gian bạn đưa ra yêu cầu. 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 bài viết Mã nhận dạng ngôn ngữ theo chuẩn Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên.
region_code	string Không bắt buộc. Mã khu vực, được chỉ định là giá trị gồm 2 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 ý: Những 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 toán thời gian di chuyển. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường 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ứ. TrafficModel chỉ dành cho những 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 lựa 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 một 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. Những yêu cầu có 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 ban đầu.
destination	Waypoint Bắt buộc. Điểm tham chiếu trên đường đi.
intermediates[]	Waypoint Không bắt buộc. Một nhóm điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng lại hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian.
travel_mode	RouteTravelMode Không bắt buộc. Chỉ định phương tiện giao thông.
routing_preference	RoutingPreference Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ cố gắng sử dụng lựa chọn ưu tiên về định tuyến đã chọn để tính toán tuyến đường. Nếu lựa chọn ưu tiên về định tuyến dẫn đến lỗi hoặc độ trễ quá dài, thì lỗi sẽ được trả về. Bạn chỉ có thể chỉ định lựa chọn này khi travel_mode là DRIVE hoặc TWO_WHEELER. Nếu không, yêu cầu sẽ không thành công.
polyline_quality	PolylineQuality Không bắt buộc. Chỉ định lựa chọn ưu tiên của bạn về chất lượng của đường nhiều đoạn.
polyline_encoding	PolylineEncoding Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho đường nhiều đoạn.
departure_time	Timestamp Không bắt buộc. Giờ khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời gian bạn đưa ra yêu cầu. 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 Ý: Trường này sẽ bị bỏ qua khi các yêu cầu chỉ định một RouteTravelMode khác với 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 toán các tuyến đường thay thế ngoài tuyến đường hay không. Không có tuyến đường thay thế nào được trả về cho các yêu cầu có điểm tham chiếu trung gian.
route_modifiers	RouteModifiers Không bắt buộc. Một nhóm các điều kiện cần đáp ứng ảnh hưởng đến cách tính toán tuyến đường.
language_code	string Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem bài viết Mã nhận dạng ngôn ngữ theo chuẩn Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của yêu cầu về tuyến đường.
region_code	string Không bắt buộc. Mã khu vực, được chỉ định là giá trị gồm 2 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. 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 không bị ảnh hưởng bởi giá trị này. 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 tham chiếu trung gian đã chỉ định. Yêu cầu sẽ không thành công nếu có 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 thứ tự mới. Nếu ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index không được yêu cầu trong tiêu đề X-Goog-FieldMask, thì yêu cầu sẽ không thành công. Nếu optimize_waypoint_order được đặt thành false, ComputeRoutesResponse.optimized_intermediate_waypoint_index sẽ trống.
requested_reference_routes[]	ReferenceRoute Không bắt buộc. Chỉ định những 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 đường tham chiếu là tuyến đường có mục tiêu tính toán tuyến đường khác với tuyến đường mặc định. Ví dụ: tính năng tính toán tuyến đường tham chiếu FUEL_EFFICIENT sẽ xem xét nhiều thông số để tạo ra một 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 biểu tượng route_labels trên các tuyến đường xuất hiện.
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 ý: Những 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 toán thời gian di chuyển. 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 tình hình giao thông dựa trên mức trung bình trong quá khứ. TrafficModel chỉ dành cho những 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 lựa 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 một 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. Các giá trị khác có thể được thêm vào trong tương lai.

Enum
EXTRA_COMPUTATION_UNSPECIFIED	Không được sử dụng. Những yêu cầu có 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 có thông tin về giao thông cho(các) tuyến đường.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	NavigationInstruction đượ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 chỉ được dùng để hiển thị và không được chỉnh sửa. Đừ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 trên cao cho(các) tuyến đường. Bạn phải chỉ định trường routes.polyline_details.flyover_info fieldmask để trả về thông tin này. Hiện tại, dữ liệu này sẽ chỉ được điền sẵn cho một số thành phố lớn ở Ấn Độ. Tính năng này đang trong giai đoạn 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 trường routes.polyline_details.narrow_road_info fieldmask để trả về thông tin này. Hiện tại, dữ liệu này sẽ chỉ được điền sẵn cho một số thành phố lớn ở Ấn Độ. Tính năng này đang trong giai đoạn thử nghiệm và SKU/phí có thể thay đổi.
TUNNEL_INFO_ON_POLYLINE	Thông tin về đường hầm cho(các) tuyến đường. Bạn phải chỉ định trường routes.polyline_details.tunnel_info fieldmask để trả về thông tin này.
BRIDGE_INFO_ON_POLYLINE	Thông tin về cầu cho(các) tuyến đường. Bạn phải chỉ định trường routes.polyline_details.bridge_info fieldmask để trả về thông tin này.
SKYWAY_INFO_ON_POLYLINE	Thông tin về đường trên cao cho(các) tuyến đường. Bạn phải chỉ định trường routes.polyline_details.skyway_info fieldmask để trả về thông tin này.

ReferenceRoute

Một tuyến đường tham chiếu được hỗ trợ trên ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED	Không được sử dụng. Những yêu cầu có 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ó khoảng cách 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 khoảng cách 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 đường đất, đi qua 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 sẽ trả về các tuyến đường tương tự như các tuyến đường đượ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ỳ chế độ di chuyển nào khác, thông qua các điểm tham chiếu trung gian hoặc optimize_waypoint_order; những yêu cầu như vậy sẽ không thành công. Tuy nhiên, bạn có thể dùng phương thức này với bất kỳ routing_preference nào.

ComputeRoutesResponse

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

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

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

Enum
FALLBACK_REASON_UNSPECIFIED	Không có lý do dự phòng nào được chỉ định.
SERVER_ERROR	Đã xảy ra lỗi máy chủ khi tính toán các tuyến đường bằng chế độ định tuyến mà bạn ưu tiên, nhưng chúng tôi đã có thể trả về kết quả được tính toán bằng một chế độ thay thế.
LATENCY_EXCEEDED	Chúng tôi không thể hoàn tất việc tính toán với chế độ định tuyến mà bạn ưu tiên đúng thời gian, nhưng chúng tôi đã có thể trả về kết quả được tính toán bằng một chế độ 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 câu trả lời.
FALLBACK_TRAFFIC_AWARE	Cho biết TRAFFIC_AWARE RoutingPreference được dùng để tính toán câu trả lời.

GeocodedWaypoint

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

Trường
geocoder_status	Status Cho biết mã trạng thái do thao tác mã hoá địa lý.
type[]	string (Các) loại kết quả, dưới dạng 0 hoặc nhiều thẻ loại. Các loại được hỗ trợ: Các loại địa chỉ và loại thành phần địa chỉ.
partial_match	bool Cho biết rằng trình 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ù trình mã hoá này 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ỉ không đầy đủ hay không.
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 sẵn nếu điểm tham chiếu tương ứng là một điểm tham chiếu trung gian.

GeocodingResults

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

Trường
origin	GeocodedWaypoint Điểm tham chiếu được mã hoá địa lý của điểm xuất phát.
destination	GeocodedWaypoint Điểm tham chiếu được mã hoá địa lý của điểm đế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

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

Trường
time	LocalizedText Thời gian được chỉ định dưới dạng một chuỗi trong một 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ờ như được xác định trong Cơ sở dữ liệu múi giờ IANA, ví dụ: "America/New_York".

Thông tin vị trí

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

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

Maneuver

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

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

NavigationInstruction

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

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

Hình nhiều đường

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

Trường
Trường nhóm polyline_type. Đóng gói loại đường nhiều đường. Giá trị mặc định là encoded_polyline. polyline_type chỉ có thể là một trong những trạng thái sau:
encoded_polyline	string Chuỗi mã hoá của đường nhiều đoạn bằng thuật toán mã hoá đường nhiều đoạn
geo_json_linestring	Struct Chỉ định một đường nhiều đoạn bằng cách sử dụ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 tục nhất định của một hình nhiều đường. Cho trước một đường nhiều đoạn có các điểm P_0, P_1, ... , P_N (chỉ mục từ 0), PolylineDetails xác định một khoảng thời gian và siêu dữ liệu được liên kết.

Trường
tunnel_info[]	TunnelInfo Thông tin chi tiết về đường hầm dọc theo đường nhiều đoạn. Trường này được điền sẵn nếu yêu cầu chỉ định bộ sửa đổi tuyến đường avoid_tunnels và tuyến đường kết quả không tránh được các bộ sửa đổi đó, HOẶC nếu TUNNEL_INFO_ON_POLYLINE được chỉ định trong extra_computations và tuyến đường có đường hầm.
restriction_info[]	RestrictionInfo Thông tin chi tiết về chế độ hạn chế dọc theo đường nhiều đoạn. Trường này chỉ được điền sẵn nếu một yêu cầu chỉ định đối tượng sửa đổi tuyến đường vehicle_info và tuyến đường kết quả có chứa một quy định hạn chế áp dụng. Nếu không, trường này sẽ không được dùng.
flyover_info[]	FlyoverInfo Thông tin chi tiết về đường bay dọc theo đường nhiều đoạn.
narrow_road_info[]	NarrowRoadInfo Thông tin chi tiết về đường hẹp dọc theo đường đa tuyến.
bridge_info[]	BridgeInfo Thông tin chi tiết về cầu dọc theo đường nhiều đoạn.
skyway_info[]	SkywayInfo Thông tin chi tiết về đường trên cao dọc theo đường đa tuyến.

BridgeInfo

Đóng gói thông tin về các cây cầu dọc theo đường nhiều đoạn.

Trường
bridge_presence	RoadFeatureState Cho biết liệu có cầu cho một đoạn đường nhất định của hình nhiều đường hay không.
polyline_point_index	PolylinePointIndex Vị trí của thông tin liên quan đến cầu dọc theo đường nhiều đường.

FlyoverInfo

Đóng gói thông tin về các đường bay dọc theo đường nhiều đoạn.

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

NarrowRoadInfo

Đóng gói thông tin về đường hẹp dọc theo đường nhiều đoạn.

Trường
narrow_road_presence	RoadFeatureState Chỉ có đầu ra. Cho biết liệu có đường hẹp cho một đoạn đường nhất định của hình nhiều đường 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 nhiều đường.

PolylinePointIndex

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

Trường
start_index	int32 Chỉ mục bắt đầu của thông tin chi tiết này trong đường nhiều đoạn.
end_index	int32 Chỉ mục cuối của chi tiết này trong đường nhiều đường.

RestrictionInfo

Đóng gói thông tin về nhiều hạn chế dọc theo đường nhiều đoạn.

Trường
restriction_presence	RoadFeatureState Chỉ có đầu ra. Cho biết liệu có quy định hạn chế nào đối với một đoạn đường nhất định của đường đa tuyến hay không.
polyline_point_index	PolylinePointIndex Vị trí của thông tin liên quan đến quy định hạn chế dọc theo đường nhiều đoạn.
Trường nhóm restriction. Đóng gói các loại hạn chế có thể áp dụng cho một đoạn đường nhất định của đường nhiều đoạn. restriction chỉ có thể là một trong những trạng thái sau:
restricted_height_mm	int64 Giới hạn chiều cao, tính bằng milimet. Trường này được điền khi chiều cao bị hạn chế khiến xe không thể đi qua hoặc dẫn đến khoảng sáng gầm xe thấp cho xe được chỉ định.
restricted_weight_kg	int64 Giới hạn trọng lượng, tính bằng ki-lô-gam. Trường này được điền khi giới hạn trọng lượng ngăn chặn việc đi qua hoặc gần với trọng lượng của xe được chỉ định.
hazardous_goods	bool Trường này được đặt thành true khi việc vận chuyển hàng hoá nguy hiểm bị hạn chế.
trucks_prohibited	bool Trường này được đặt thành true khi xe tải bị cấm.

RoadFeatureState

Đóng gói trạng thái của các đối tượng trên đường dọc theo một đoạn đường nhiều đường.

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

SkywayInfo

Đóng gói thông tin về đường đi bộ trên không dọc theo hình nhiều đường.

Trường
skyway_presence	RoadFeatureState Cho biết liệu có đường đi bộ trên cao 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 trên cao dọc theo đường nhiều đoạn.

TunnelInfo

Đóng gói thông tin về các đường hầm dọc theo đường nhiều đường.

Trường
tunnel_presence	RoadFeatureState Cho biết liệu có đường hầm cho một đoạn đường nhất định của đường nhiều đường hay không.
polyline_point_index	PolylinePointIndex Vị trí của thông tin liên quan đến đường hầm dọc theo đường nhiều đoạn.

PolylineEncoding

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

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

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

Trường
route_labels[]	RouteLabel Nhãn cho Route 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 đường khác.
legs[]	RouteLeg Một tập hợp các đoạn đường (đoạn đường giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai via Waypoints không phải là điểm dừng. Ví dụ: một tuyến đường không có điểm tham chiếu trung gian chỉ có một chặng. Một tuyến đường có một điểm via trung gian không phải là điểm đến có hai chặng. Một tuyến đường có một điểm tham chiếu trung gian via sẽ có một chặng. Thứ tự của các chặng trùng khớp với thứ tự của các điểm tham chiếu từ origin đến intermediates rồi đến destination.
distance_meters	int32 Quãng đường di chuyển của tuyến đường, tính bằng mét.
duration	Duration Khoảng thời gian cần thiết để đi theo tuyến đường. Nếu bạn đặt routing_preference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với static_duration. Nếu bạn đặt routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính có tính đến tình trạng giao thông.
static_duration	Duration Thời gian di chuyển trên tuyến đường mà không tính đến tình trạng giao thông.
polyline	Polyline Hình nhiều đường tổng thể của tuyến đường. Đường nhiều đoạn này là đường nhiều đoạn kết hợp của tất cả legs.
description	string Nội dung mô tả về tuyến đường.
warnings[]	string Một mảng các cảnh báo sẽ xuất hiện khi hiển thị tuyến đường.
viewport	Viewport Hộp bao quanh khung nhìn của đường 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, thì 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 sẽ trống. Ví dụ: nếu bạn nhập Điểm xuất phát: Los Angeles; Điểm tham chiếu trung gian: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm tham chiếu trung gian được tối ưu hoá là Phoenix, Dallas, Bangor, 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 tham chiếu 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ột mã thông báo không công khai có thể được truyền đến Navigation SDK để tạo lại 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 tuyến đường được tạo. Hãy coi mã thông báo này là một blob mờ. Đừng so sánh giá trị này giữa các yêu cầu vì giá trị này có thể thay đổi ngay cả khi dịch vụ trả về chính xác cùng một tuyến đường. LƯU Ý: Route.route_token chỉ dùng được cho những 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 Qua.
polyline_details	PolylineDetails Chứa thông tin về các chi tiết dọc theo đường nhiều đoạn.

RouteLocalizedValues

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

Trường
distance	LocalizedText Khoảng cách di chuyển được thể hiện dưới dạng văn bản.
duration	LocalizedText Thời lượng, được biểu thị dưới 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. Tính đến tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin giao thông, thì giá trị này sẽ giống với giá trị static_duration.
static_duration	LocalizedText Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.
transit_fare	LocalizedText Giá vé phương tiện công cộng được thể hiện dưới dạng văn bản.

RouteLabel

Nhãn cho Route 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 đường khác.

Enum
ROUTE_LABEL_UNSPECIFIED	Mặc định – không được 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 lựa chọn thay thế cho tuyến đường "tốt nhất" mặc định. Những 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. Những tuyến đường được gắn nhãn bằng giá trị này được xác định là tuyến đường tối ưu hoá cho các thông số về Môi trường, chẳng hạn như mức tiêu thụ nhiên liệu.
SHORTER_DISTANCE	Tuyến đường có khoảng cách di chuyển ngắn hơn. Đây là tính năng thử nghiệm.

RouteLeg

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

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

RouteLegLocalizedValues

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

Trường
distance	LocalizedText Khoảng cách di chuyển được thể hiện dưới dạng văn bản.
duration	LocalizedText Thời lượng, được biểu thị dưới 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. Tính đến tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin giao thông, thì giá trị này sẽ giống với giá trị static_duration.
static_duration	LocalizedText Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.

StepsOverview

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

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 sẵn nếu RouteLeg không chứa bất kỳ đoạn đường đ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 sẵn nếu RouteLeg không chứa bất kỳ đoạn đường đa phương thức nào trong các bước.

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

RouteLegStep

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

RouteLegStepLocalizedValues

Biểu diễn 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ưới dạng văn bản.
static_duration	LocalizedText Thời lượng không tính đến tình trạng giao thông, được biểu thị dưới dạng văn bản.

RouteLegStepTransitDetails

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

Trường
stop_details	TransitStopDetails Thông tin về các điểm dừng đến và đi của bước này.
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 đường này như được đánh dấu trên xe hoặc tại điểm dừng khởi hành. Hướng đi thường là ga cuối.
headway	Duration Chỉ định thời gian dự kiến dưới dạng 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ị thời gian giữa các chuyến 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ề đườ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 dừng khởi hành đến điểm dừng đế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 đi. Ví dụ: nếu tuyến đường của bạn xuất phát từ Điểm dừng A, đi qua điểm dừng B và C, rồi đến điểm dừng D, thì stop_count sẽ 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 này phải xác định duy nhất một chuyến đi trong một ngày dịch vụ. Ví dụ: "538" là trip_short_text của tàu Amtrak rời 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
arrival_time	LocalizedTime Thời gian ở dạng văn bản được định dạng cùng với múi giờ tương ứng.
departure_time	LocalizedTime Thời gian ở dạng văn bản được định dạng cùng với múi giờ tương ứng.

TransitStopDetails

Thông tin chi tiết về các trạm dừng của phương tiện công cộng 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 cho bước này.
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 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 quy định hạn chế có thể có về khu vực giao thông trên một bước của chặng đường.

Trường
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 đường, chẳng hạn như các quy định hạn chế về khu vực giao thông có thể có.

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 sẵn nếu chúng tôi dự kiến có phí cầu đường trên RouteLeg và TOLLS có trong ComputeRoutesRequest.extra_computations của yêu cầu. Nếu bạn đặt trường này nhưng không điền vào trường phụ estimated_price, thì chúng tôi dự kiến đường có thu phí nhưng chúng tôi không biết giá ước tính. Nếu toll_info không tồn tại, thì RouteLeg sẽ không có phí cầu đường.
speed_reading_intervals[]	SpeedReadingInterval Khoảng thời gian đọc nhanh cho biết mật độ giao thông. Trường này chỉ được điền sẵn cho các yêu cầu khi yêu cầu có giá trị TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference và TRAFFIC_ON_POLYLINE được đưa vào ComputeRoutesRequest.extra_computations. Các khoảng thời gian này bao phủ toàn bộ đường nhiều đoạn của RouteLeg mà không bị trùng lặp. Điểm bắt đầu của một khoảng thời gian cụ thể giống với điểm cuối 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
waypoint	Waypoint Bắt buộc. Điểm tham chiếu trên đường đi

RouteMatrixElement

Chứa thông tin về tuyến đường được tính toán cho một cặp điểm xuất phát/đích đến trong ComputeRouteMatrix API. Proto này có thể được truyền trực tuyến đến ứ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 tuyến đường có được tìm thấy hay không. Không phụ thuộc vào trạng thái.
distance_meters	int32 Quãng đường di chuyển của tuyến đường, tính bằng mét.
duration	Duration Khoảng thời gian cần thiết để đi theo tuyến đường. Nếu bạn đặt routing_preference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với static_duration. Nếu bạn đặt routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính có tính đến tình trạng giao thông.
static_duration	Duration Thời gian di chuyển trên tuyến đường mà không tính đến tình trạng giao thông.
travel_advisory	RouteTravelAdvisory Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về quy định hạn chế và thông tin về phí cầu đường
fallback_info	FallbackInfo Trong một số trường hợp, khi máy chủ không thể tính toán tuyến đường theo các lựa chọn ưu tiên đã cho đối với cặp điểm xuất phát/đích đến cụ thể này, thì máy chủ có thể quay lại sử dụng một chế độ tính toán khác. Khi chế độ dự phòng được dùng, trường này 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 trong yêu cầu (bắt đầu từ 0).
destination_index	int32 Chỉ mục dựa trên 0 của đích đến trong yêu cầu.

LocalizedValues

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

Trường
distance	LocalizedText Khoảng cách di chuyển được thể hiện dưới dạng văn bản.
duration	LocalizedText Thời lượng được biểu thị dưới dạng văn bản, có tính đến tình trạng giao thông. Lưu ý: Nếu bạn không yêu cầu thông tin giao thông, thì giá trị này sẽ giống với giá trị static_duration.
static_duration	LocalizedText Thời lượng được biểu thị dưới dạng văn bản mà không xem xét tình trạng giao thông.
transit_fare	LocalizedText Giá vé phương tiện công cộng được thể hiện dưới 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ỉ dùng khi status của phần tử không phải là OK.
ROUTE_EXISTS	Hệ thống đã 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 về tuyến đường, chẳng hạn như distance_meters hoặc duration, sẽ không được điền sẵn trong phần tử.

RouteMatrixOrigin

Một nguồn duy nhất cho ComputeRouteMatrixRequest

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

RouteModifiers

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

Trường
avoid_tolls	bool Khi được đặt thành true, hệ thống sẽ tránh đường thu phí nếu có thể, ưu tiên những tuyến đường không có đường thu phí. Chỉ áp dụng cho DRIVE và TWO_WHEELER RouteTravelMode.
avoid_highways	bool Khi được đặt thành true, hệ thống sẽ tránh đường cao tốc nếu có thể, ưu tiên những tuyến đường không có đường cao tốc. Chỉ áp dụng cho DRIVE và TWO_WHEELER RouteTravelMode.
avoid_ferries	bool Khi được đặt thành true, hệ thống sẽ tránh phà nếu có thể, ưu tiên những tuyến đường không có phà. Chỉ áp dụng cho DRIVE vàTWO_WHEELER RouteTravelMode.
avoid_indoor	bool Khi được đặt thành true, hệ thống sẽ tránh điều hướng trong nhà nếu có thể, ưu tiên những tuyến đường không có chỉ dẫn đ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 không cung cấp phí cầu đường, API sẽ coi phí cầu đường là không xác định và cố gắng trả về giá tiền mặt. Chỉ áp dụng cho DRIVE và TWO_WHEELER RouteTravelMode.
avoid_tunnels	bool Không bắt buộc. Khi được đặt thành true, hệ thống sẽ tránh các đường hầm nếu có thể, ưu tiên những tuyến đường không có đường hầm. Chỉ áp dụng cho DRIVE và TWO_WHEELER RouteTravelMode. RoutingPreference phải được đặt thành TRAFFIC_AWARE_OPTIMAL. Trường này không được hỗ trợ trong ComputeRouteMatrix.

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ó về 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 sẵn nếu tuyến đường dự kiến có trạm thu phí và TOLLS có trong ComputeRoutesRequest.extra_computations của yêu cầu. Nếu bạn đặt trường này nhưng không điền sẵn trường con estimatedPrice, thì tuyến đường sẽ có trạm thu phí nhưng giá ước tính là không xác định. Nếu bạn không đặt toll_info, thì tuyến đường sẽ không có phí cầu đường.
speed_reading_intervals[]	SpeedReadingInterval Khoảng thời gian đọc nhanh cho biết mật độ giao thông. Trường này chỉ được điền sẵn cho các yêu cầu khi yêu cầu có giá trị TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference và TRAFFIC_ON_POLYLINE được đưa vào ComputeRoutesRequest.extra_computations. Các khoảng thời gian này bao gồm toàn bộ đường nhiều đường của tuyến đường mà không bị trùng lặp. Điểm bắt đầu của một khoảng thời gian cụ thể giống với điểm cuối 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 Lượng nhiên liệu tiêu thụ dự kiến (tính bằng microlit). Trường này chỉ được điền sẵn khi FUEL_CONSUMPTION có trong ComputeRoutesRequest.extra_computations của yêu cầu.
route_restrictions_partially_ignored	bool Tuyến đường được trả về có thể có những hạn chế không phù hợp với chế độ di chuyển hoặc các đối tượng sửa đổi tuyến đường được yêu cầu.
transit_fare	Money Nếu có, thuộc tính này sẽ chứa tổng giá vé hoặc chi phí 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 những tuyến đường có thông tin về giá vé cho tất cả các bước đi phương tiện công cộng.

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 đường WALK, BICYCLE và TWO_WHEELER đang ở giai đoạn thử nghiệm beta 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à xe hai bánh mà bạn hiển thị trong ứng dụng của mình.

Enum
TRAVEL_MODE_UNSPECIFIED	Bạn chưa chỉ định chế độ di chuyển. Giá trị mặc định là DRIVE.
DRIVE	Đi bằng xe chở khách.
BICYCLE	Đi bằng xe đạp.
WALK	Đi bộ.
TWO_WHEELER	Xe có động cơ và có hai bánh. Ví dụ: xe máy. Xin lưu ý rằng chế độ này khác với chế độ di chuyển BICYCLE, bao gồm cả chế độ di chuyển bằng sức người.
TRUCK	Xe tải, có thể phải tuân theo các quy định hạn chế về pháp lý hoặc vật lý. Bạn phải điền sẵn các thuộc tính của xe trong thông báo VehicleInfo.
TRANSIT	Đi bằng các 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 những yếu tố cần cân nhắc khi tính toán tuyến đường.

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

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

Tốc độ

Phân loại tốc độ của 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 dùng.
NORMAL	Tốc độ bình thường, không có trở ngại giao thông.
SLOW	Đã phát hiện tình trạng giảm tốc độ, lượng giao thông ở mức trung bình.
TRAFFIC_JAM	Trở ngại 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à các 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ó trạm thu phí bằng một loại tiền tệ. Đối với các chuyến đi quốc tế, danh sách này có thể chứa nhiều mục để phản ánh phí cầu đường bằng nhiều đơn vị tiền tệ.

TollPass

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

Enum
TOLL_PASS_UNSPECIFIED	Không được sử dụng. Nếu giá trị này được dùng, thì yêu cầu sẽ không thành công.
AU_ETOLL_TAG	Thẻ trả 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ẻ trả 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í cầu đường trên toàn nước Úc. Xem thêm thông tin chi tiết tại https://www.linkt.com.au/.
AR_TELEPASE	Thẻ thu phí cầu đường ở Argentina. Xem thêm thông tin chi tiết tại https://telepase.com.ar
BR_AUTO_EXPRESO	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://www.autoexpreso.com
BR_CONECTCAR	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com.
BR_MOVE_MAIS	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://movemais.com.
BR_PASSA_RAPIDO	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin tại https://pasorapido.gob.do/
BR_SEM_PARAR	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin chi tiết tại https://www.semparar.com.br.
BR_TAGGY	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin tại https://taggy.com.br.
BR_VELOE	Thẻ thu phí cầu đường ở Brazil. Xem thêm thông tin tại https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD	Cửa khẩu từ Canada sang Hoa Kỳ.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD	Cửa khẩu từ Canada sang Hoa Kỳ.
CA_US_BLUE_WATER_EDGE_PASS	Đường biên giới từ Ontario, Canada đến Michigan, Hoa Kỳ.
CA_US_CONNEXION	Đường biên giới từ Ontario, Canada đến Michigan, Hoa Kỳ.
CA_US_NEXUS_CARD	Cửa khẩu từ Canada sang Hoa Kỳ.
ID_E_TOLL	Indonesia. Thẻ điện tử do nhiều ngân hàng cung cấp để thanh toán phí cầu đường. Tất cả thẻ điện tử qua ngân hàng đều được tính phí như nhau, vì vậy bạn chỉ cần một giá trị enum. Ví dụ: – Bank Mandiri https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG	India.
IN_LOCAL_HP_PLATE_EXEMPT	Ấn Độ, biển số xe được miễn thuế ở bang HP.
JP_ETC	ETC Nhật Bản. Hệ thống không dây điện tử để thu phí cầu đường. https://www.go-etc.jp/
JP_ETC2	ETC2.0 của Nhật Bản. Phiên bản mới của ETC với chiết khấu cao hơn và khả năng giao tiếp hai chiều giữa các thiết bị trên xe và ăng-ten trên đường. https://www.go-etc.jp/etc2/index.html
MX_IAVE	Thẻ thu 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 cung cấp thẻ thu phí cầu đường ở Mexico. Một trong nhiều tuyến xe buýt hoạt động ở Mexico City. Xem thêm thông tin tại https://www.televia.com.mx.
MX_TELEVIA	Công ty cung cấp thẻ thu phí cầu đường ở Mexico. Một trong nhiều công ty đang hoạt động ở Thành phố Mexico. https://www.televia.com.mx
MX_VIAPASS	Thẻ thu phí cầu đường ở Mexico. Xem thêm thông tin tại https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS	AL, Hoa Kỳ.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS	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 ngoài giấy đề can Xe không gây ô nhiễm (CAV) do DMV cấp. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL	CO, Hoa Kỳ.
US_CO_GO_PASS	CO, Hoa Kỳ.
US_DE_EZPASSDE	Đức, Hoa Kỳ.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS	FL, Hoa Kỳ.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD	FL, Hoa Kỳ.
US_FL_EPASS	FL, Hoa Kỳ.
US_FL_GIBA_TOLL_PASS	FL, Hoa Kỳ.
US_FL_LEEWAY	FL, Hoa Kỳ.
US_FL_SUNPASS	FL, Hoa Kỳ.
US_FL_SUNPASS_PRO	FL, Hoa Kỳ.
US_IL_EZPASSIL	IL, Hoa Kỳ.
US_IL_IPASS	IL, Hoa Kỳ.
US_IN_EZPASSIN	IN, Hoa Kỳ.
US_KS_BESTPASS_HORIZON	Kansas, Hoa Kỳ.
US_KS_KTAG	Kansas, Hoa Kỳ.
US_KS_NATIONALPASS	Kansas, Hoa Kỳ.
US_KS_PREPASS_ELITEPASS	Kansas, Hoa Kỳ.
US_KY_RIVERLINK	KY, Hoa Kỳ.
US_LA_GEAUXPASS	LA, Hoa Kỳ.
US_LA_TOLL_TAG	LA, Hoa Kỳ.
US_MA_EZPASSMA	MA, Hoa Kỳ.
US_MD_EZPASSMD	MD, Hoa Kỳ.
US_ME_EZPASSME	Maine, Hoa Kỳ.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD	Michigan, Hoa Kỳ.
US_MI_BCPASS	Michigan, Hoa Kỳ.
US_MI_BREAKAWAY	Michigan, Hoa Kỳ.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG	Michigan, Hoa Kỳ.
US_MI_IQ_PROX_CARD	Michigan, Hoa Kỳ. Không dùng nữa vì loại thẻ này không còn tồn tại. Mặt hàng này không còn được dùng nữa!
US_MI_IQ_TAG	Michigan, Hoa Kỳ.
US_MI_MACKINAC_BRIDGE_MAC_PASS	Michigan, Hoa Kỳ.
US_MI_NEXPRESS_TOLL	Michigan, Hoa Kỳ.
US_MN_EZPASSMN	MN, Hoa Kỳ.
US_NC_EZPASSNC	NC, Hoa Kỳ.
US_NC_PEACH_PASS	NC, Hoa Kỳ.
US_NC_QUICK_PASS	NC, Hoa Kỳ.
US_NH_EZPASSNH	New Hampshire, Hoa Kỳ.
US_NJ_DOWNBEACH_EXPRESS_PASS	New Jersey, Hoa Kỳ.
US_NJ_EZPASSNJ	New Jersey, Hoa Kỳ.
US_NY_EXPRESSPASS	New York, Hoa Kỳ.
US_NY_EZPASSNY	New York, Hoa Kỳ.
US_OH_EZPASSOH	Ohio, Hoa Kỳ.
US_PA_EZPASSPA	PA, Hoa Kỳ.
US_RI_EZPASSRI	RI, Hoa Kỳ.
US_SC_PALPASS	SC, Hoa Kỳ.
US_TX_AVI_TAG	Texas, Hoa Kỳ.
US_TX_BANCPASS	Texas, Hoa Kỳ.
US_TX_DEL_RIO_PASS	Texas, Hoa Kỳ.
US_TX_EFAST_PASS	Texas, Hoa Kỳ.
US_TX_EAGLE_PASS_EXPRESS_CARD	Texas, Hoa Kỳ.
US_TX_EPTOLL	Texas, Hoa Kỳ.
US_TX_EZ_CROSS	Texas, Hoa Kỳ.
US_TX_EZTAG	Texas, Hoa Kỳ.
US_TX_FUEGO_TAG	Texas, Hoa Kỳ.
US_TX_LAREDO_TRADE_TAG	Texas, Hoa Kỳ.
US_TX_PLUSPASS	Texas, Hoa Kỳ.
US_TX_TOLLTAG	Texas, Hoa Kỳ.
US_TX_TXTAG	Texas, Hoa Kỳ.
US_TX_XPRESS_CARD	Texas, Hoa Kỳ.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD	UT, Hoa Kỳ.
US_VA_EZPASSVA	VA, Hoa Kỳ.
US_WA_BREEZEBY	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	WV, Hoa Kỳ
US_WV_NEWELL_TOLL_BRIDGE_TICKET	West Virginia, Hoa Kỳ.

TrafficModel

Trường này chỉ định một trong các giả định sau đây để sử dụng khi tính toán thời gian di chuyển trong tình trạng giao thông, được trình bày trong các enum bên dưới. Tuỳ thuộc vào enum được chọn, trường duration của phản hồi TrafficModel sẽ thay đổi. Giá trị này chứa thời gian dự đoán để đến đích trong điều kiện giao thông, dựa trên mức trung bình trong quá khứ. TrafficModel chỉ dành cho những yêu cầu đã đặt RoutingPreference thành TRAFFIC_AWARE_OPTIMAL và RouteTravelMode thành DRIVE.

Enum
TRAFFIC_MODEL_UNSPECIFIED	Không dùng đến. 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ông tin ước tính chính xác nhất về thời gian di chuyển dựa trên những thông tin đã biết về cả tình trạng giao thông trong quá khứ và giao thông theo thời gian thực. Thông tin giao thông theo thời gian thực càng quan trọng hơn khi departure_time càng gần với 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ế trong hầu hết các ngày, mặc dù đôi khi có những ngày 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 rằng thời lượng được 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ù đôi khi có những ngày tình trạng giao thông đặc biệt thuận lợi 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 đường chuyển tuyến.

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 theo ngôn ngữ cụ thể của cơ quan vận tải công cộng.
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 vận tải) vận 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 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 đường chuyển tuyến này. Tên này thường là số hiệu tuyến, 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 đườ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 đường dựa trên TRANSIT ảnh hưởng đến tuyến đường được trả về.

Trường
allowed_travel_modes[]	TransitTravelMode Một nhóm các chế độ di chuyển để sử dụng khi nhận được tuyến đường TRANSIT. Mặc định là tất cả các phương thức di chuyển được hỗ trợ.
routing_preference	TransitRoutingPreference Lựa chọn ưu tiên về định tuyến. Khi được chỉ định, lựa chọn này sẽ ảnh hưởng đến tuyến đường TRANSIT được trả về.

TransitRoutingPreference

Chỉ định lựa chọn ưu tiên về định tuyến cho các tuyến đường dành cho 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 rằng tuyến đường được tính toán nên ưu tiên việc đi bộ trong phạm vi cho phép.
FEWER_TRANSFERS	Cho biết rằng tuyến đường được tính toán nên ưu tiên số lầ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 vận chuyển.

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

TransitStop

Thông tin về một trạm dừng phương tiện công cộng.

Trường
name	string Tên của trạ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 dùng trong các tuyến đường vận chuyển.

Trường
name	LocalizedText Tên của chiếc 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 được 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 báo giao thông tại địa phương.

TransitVehicleType

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

Enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED	Không dùng đến.
BUS	Xe buýt.
CABLE_CAR	Phương tiện hoạt động bằng cáp, thường là 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 loại xe được kéo lên dốc cao bằng cáp. Tàu cáp treo thường có 2 toa, mỗi toa đóng vai trò là đối trọng cho toa còn lại.
GONDOLA_LIFT	Cáp treo trên không.
HEAVY_RAIL	Tàu điện hạng nặng.
HIGH_SPEED_TRAIN	Tàu cao tốc.
INTERCITY_BUS	Xe buýt liên tỉnh.
LONG_DISTANCE_TRAIN	Tàu đường dài.
METRO_RAIL	Hệ thống vận chuyển bằng xe điện.
MONORAIL	Monorail.
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 kỳ đâ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.

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

VehicleEmissionType

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

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED	Bạn chưa chỉ định loại khí thải. Mặc định là GASOLINE.
GASOLINE	Xe chạy bằng xăng/dầu.
ELECTRIC	Xe chạy bằng điện.
HYBRID	Xe sử dụng nhiên liệu kết hợp (chẳng hạn như xăng + điện).
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.
total_height_mm	int64 Chiều cao của xe, bao gồm cả chiều cao của mọi rơ-moóc được gắn vào. Phải được đặt cho xe tải hoặc xe kéo để kích hoạt. Trường này không được hỗ trợ trong ComputeRouteMatrix khi RouteTravelMode là DRIVE.
total_length_mm	int64 Chiều dài của xe, bao gồm cả chiều dài của bất kỳ rơ moóc nào được gắn vào. Phải được đặt cho xe tải hoặc xe kéo để kích hoạt. Trường này không được hỗ trợ trong ComputeRouteMatrix khi RouteTravelMode là DRIVE.
total_width_mm	int64 Chiều rộng của xe, bao gồm cả chiều rộng của mọi rơ moóc được gắn vào xe. Phải được đặt cho xe tải hoặc xe kéo để kích hoạt. Trường này không được hỗ trợ trong ComputeRouteMatrix khi RouteTravelMode là DRIVE.
total_weight_kg	int64 Trọng lượng của xe, bao gồm cả trọng lượng của mọi rơ moóc được gắn vào. Trong trường hợp này, trọng lượng là trọng lượng thực tế chứ không phải trọng lượng định mức. Phải được đặt cho xe tải hoặc xe kéo để kích hoạt. Trường này không được hỗ trợ trong ComputeRouteMatrix khi RouteTravelMode là DRIVE.
trailer_info[]	TrailerInfo Chứa một mục nhập cho mỗi đoạn giới thiệu. Nếu bạn cung cấp thông tin về đoạn giới thiệu, thì bạn phải đặt RoutingPreference thành TRAFFIC_AWARE_OPTIMAL. Trường này không được hỗ trợ trong ComputeRouteMatrix khi RouteTravelMode là DRIVE.
hazardous_goods_types[]	HazardousGoodsType Danh sách vật liệu nguy hiểm được vận chuyển trong xe (nếu có).

HazardousGoodsType

Các loại vật liệu nguy hiểm.

Enum
HAZARDOUS_GOODS_TYPE_UNSPECIFIED	Bạn chưa chỉ định loại hàng hoá nguy hiểm.
EXPLOSIVES	Hàng hoá gây nổ.
GASES	Khí.
FLAMMABLE	Hàng hoá dễ cháy.
COMBUSTIBLE	Hàng hoá dễ cháy.
ORGANIC	Hàng hoá hữu cơ.
POISON	Hàng hoá độc hại.
RADIOACTIVE	Hàng hoá phóng xạ.
CORROSIVE	Hàng hoá ăn mòn.
ASPIRATION_HAZARD	Hàng hoá nguy hiểm gây hít phải.
ENVIRONMENTAL_HAZARD	Hàng hoá nguy hiểm đối với môi trường.
OTHER	Các loại hàng hoá khác.

TrailerInfo

Thông tin về từng rơ moóc được gắn vào xe. Bạn phải cung cấp chiều dài của mọi xe kéo để vận chuyển hàng hoá bằng xe tải. Các thuộc tính khác là không bắt buộc. Tổng số thuộc tính phải bao gồm các thuộc tính của mọi đoạn giới thiệu. Ví dụ: total_height_mm phải luôn lớn hơn hoặc bằng trailer_info.height_mm.

Trường
height_mm	int64 Chiều cao của toa moóc.
length_mm	int64 Độ dài của đoạn giới thiệu.
width_mm	int64 Chiều rộng của đoạn giới thiệu.
weight_kg	int64 Trọng lượng của xe kéo. Trong trường hợp này, trọng lượng là trọng lượng thực tế chứ không phải trọng lượng được phân loại.

Waypoint

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

Trường
via	bool Đánh dấu điểm tham chiếu này là một cột mốc chứ không phải điểm dừng. Đối với mỗi điểm tham chiếu không phải là điểm dừng qua trong yêu cầu, ứng dụng phản hồi sẽ thêm một mục vào mảng legs để cung cấp thông tin chi tiết về các điểm dừng trong chặng đó của chuyến đi. Đặt giá trị này thành true khi bạn muốn tuyến đường đi qua điểm tham chiếu này mà không dừng lại. Các điểm tham chiếu không khiến một mục được thêm vào mảng legs, nhưng chúng sẽ định tuyến hành trình qua điểm tham chiếu. Bạn chỉ có thể đặt giá trị này trên các điểm đánh dấu là điểm trung gian. Yêu cầu sẽ không thành công nếu bạn đặt trường này trên các điểm tham chiếu cuối. Nếu ComputeRoutesRequest.optimize_waypoint_order được đặt thành true thì bạn không thể đặt trường này thành true; nếu không, yêu cầu sẽ không thành công.
vehicle_stopover	bool Cho biết rằng điểm đánh dấu dành cho xe dừng lại, nơi có ý định đón hoặc trả khách. Khi bạn đặt giá trị này, tuyến đường được tính sẽ không bao gồm các điểm đánh dấu không phải via trên những con đường không phù hợp để đón và trả khách. Lựa chọn này chỉ hoạt động cho chế độ di chuyển DRIVE và TWO_WHEELER, cũng như khi location_type là Location.
side_of_road	bool Cho biết rằng vị trí của điểm tham chiếu này có nghĩa là xe nên dừng ở một bên đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí đó để xe có thể dừng ở lề đường mà vị trí đó hướng đến từ giữa đường. Lựa chọn này chỉ hoạt động trên DRIVE và TWO_WHEELER RouteTravelMode.
Trường nhóm location_type. Các cách thể hiện vị trí. location_type chỉ có thể là một trong những trạng thái sau:
location	Location Một điểm được chỉ định bằng toạ độ địa lý, bao gồm cả hướng (không bắt buộc).
place_id	string Mã địa điểm của địa điểm yêu thích được liên kết với điểm tham chiếu.
address	string Địa chỉ mà con người đọc được hoặc plus code. Hãy truy cập vào https://plus.codes để biết thông tin chi tiết.
navigation_point_token	string Mã thông báo xác định NavigationPoint, nhận được từ phương thức SearchDestinations của Geocoding API.