Package google.maps.routing.v2

Chỉ mục

Tuyến đường

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

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

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

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

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

  • Việc chỉ chọn những trường mà bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
  • Việc chỉ chọn những trường mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Trong tương lai, chúng tôi có thể thêm các trường phản hồi khác và các trường mới đó có thể cần thêm thời gian tính toán. Nếu chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm vào sẽ tự động được đưa vào phản hồi.
  • Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

LƯU Ý: Phương thức này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách sử dụng tham số URL $fields hoặc fields hoặc bằng cách sử dụng tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tham số và tiêu đề URL hiện có). Giá trị này là danh sách đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách tạo đường dẫn trường.

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

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

  • Việc chỉ chọn những trường mà bạn cần giúp máy chủ của chúng tôi tiết kiệm được chu kỳ tính toán, cho phép chúng tôi trả về kết quả cho bạn với độ trễ thấp hơn.
  • Việc chỉ chọn những trường mà bạn cần trong công việc sản xuất sẽ đảm bảo hiệu suất độ trễ ổn định. Trong tương lai, chúng tôi có thể thêm các trường phản hồi khác và các trường mới đó có thể cần thêm thời gian tính toán. Nếu chọn tất cả các trường hoặc nếu chọn tất cả các trường ở cấp cao nhất, thì bạn có thể gặp phải tình trạng giảm hiệu suất vì mọi trường mới mà chúng tôi thêm vào sẽ tự động được đưa vào phản hồi.
  • Việc chỉ chọn các trường mà bạn cần sẽ giúp giảm kích thước phản hồi, nhờ đó tăng băng thông mạng.

ComputeRouteMatrixRequest

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

Trường
origins[]

RouteMatrixOrigin

Bắt buộc. Mảng gốc xác định các hàng của ma trận phản hồi. Một số quy định hạn chế về kích thước áp dụng cho số lượng giá trị riêng biệt của nguồn và đích:

  • Tổng số lượng điểm xuất phát + số lượng điểm đến được chỉ định là place_id hoặc address không được lớn hơn 50.
  • Trong mọi trường hợp, tích của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 625.
  • Sản phẩm của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 100 nếu bạn đặt routing_preference thành TRAFFIC_AWARE_OPTIMAL.
  • Hiệu số của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 100 nếu travel_mode được đặt thành TRANSIT.
destinations[]

RouteMatrixDestination

Bắt buộc. Mảng đích xác định các cột của ma trận phản hồi.

travel_mode

RouteTravelMode

Không bắt buộc. Chỉ định phương thức vận chuyển.

routing_preference

RoutingPreference

Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ sẽ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến. Nếu lựa chọn ưu tiên định tuyến dẫn đến lỗi hoặc độ trễ quá lâu, thì hệ thống sẽ trả về lỗi. Bạn chỉ có thể chỉ định tuỳ chọn này khi travel_modeDRIVE hoặc TWO_WHEELER, nếu không yêu cầu sẽ không thành công.

departure_time

Timestamp

Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời điểm bạn đưa ra yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định departure_time trong quá khứ khi RouteTravelMode được đặt thành TRANSIT.

arrival_time

Timestamp

Không bắt buộc. Thời gian đến. LƯU Ý: Bạn chỉ có thể đặt khi RouteTravelMode được đặt thành TRANSIT. Bạn có thể chỉ định departure_time hoặc arrival_time, nhưng không được chỉ định cả hai.

language_code

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem phần Giá trị nhận dạng ngôn ngữ Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên.

region_code

string

Không bắt buộc. Mã vùng, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Để biết thêm thông tin, hãy xem bài viết Miền cấp cao nhất theo mã quốc gia.

units

Units

Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị.

extra_computations[]

ExtraComputation

Không bắt buộc. Danh sách các phép tính bổ sung có thể được dùng để hoàn tất yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trong phản hồi. Bạn cũng phải chỉ định các trường bổ sung này trong mặt nạ trường để được trả về trong phản hồi.

traffic_model

TrafficModel

Không bắt buộc. Chỉ định các giả định cần sử dụng khi tính thời gian trong lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường duration (thời lượng) trong RouteMatrixElement. Trường này chứa thời gian dự đoán trong lưu lượng truy cập dựa trên mức trung bình trong quá khứ. RoutingPreference đến TRAFFIC_AWARE_OPTIMALRouteTravelMode đến DRIVE. Mặc định là BEST_GUESS nếu lưu lượng truy cập được yêu cầu và TrafficModel không được chỉ định.

transit_preferences

TransitPreferences

Không bắt buộc. Chỉ định các tuỳ chọn ưu tiên ảnh hưởng đến tuyến đường được trả về cho các tuyến đường TRANSIT. LƯU Ý: Bạn chỉ có thể chỉ định transit_preferences khi RouteTravelMode được đặt thành TRANSIT.

ExtraComputation

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

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

ComputeRoutesRequest

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

Trường
origin

Waypoint

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

destination

Waypoint

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

intermediates[]

Waypoint

Không bắt buộc. Một tập hợp các điểm trung gian dọc theo tuyến đường (ngoại trừ các điểm cuối), để dừng lại hoặc đi qua. Hỗ trợ tối đa 25 điểm trung gian.

travel_mode

RouteTravelMode

Không bắt buộc. Chỉ định phương thức vận chuyển.

routing_preference

RoutingPreference

Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ sẽ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến. Nếu lựa chọn ưu tiên định tuyến dẫn đến lỗi hoặc độ trễ quá dài, thì lỗi sẽ được trả về. Bạn chỉ có thể chỉ định tuỳ chọn này khi travel_modeDRIVE hoặc TWO_WHEELER, nếu không yêu cầu sẽ không thành công.

polyline_quality

PolylineQuality

Không bắt buộc. Chỉ định lựa chọn ưu tiên của bạn về chất lượng của đường đa tuyến.

polyline_encoding

PolylineEncoding

Không bắt buộc. Chỉ định cách mã hoá ưu tiên cho đường đa tuyến.

departure_time

Timestamp

Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời điểm bạn đưa ra yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định departure_time trong quá khứ khi RouteTravelMode được đặt thành TRANSIT. Bạn có thể xem thông tin về các chuyến đi bằng phương tiện công cộng trong tối đa 7 ngày trước hoặc 100 ngày sau.

arrival_time

Timestamp

Không bắt buộc. Thời gian đến. LƯU Ý: Bạn chỉ có thể đặt khi RouteTravelMode được đặt thành TRANSIT. Bạn có thể chỉ định departure_time hoặc arrival_time, nhưng không được chỉ định cả hai. Bạn có thể xem thông tin về các chuyến đi bằng phương tiện công cộng trong tối đa 7 ngày trước đó hoặc 100 ngày sau đó.

compute_alternative_routes

bool

Không bắt buộc. Chỉ định xem có tính các tuyến đường thay thế ngoài tuyến đường hay không. Không có tuyến đường thay thế nào được trả về cho các yêu cầu có điểm trung gian.

route_modifiers

RouteModifiers

Không bắt buộc. Một tập hợp các điều kiện cần đáp ứng ảnh hưởng đến cách tính toán tuyến.

language_code

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem phần Giá trị nhận dạng ngôn ngữ Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của yêu cầu định tuyến.

region_code

string

Không bắt buộc. Mã vùng, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Để biết thêm thông tin, hãy xem bài viết Miền cấp cao nhất theo mã quốc gia.

units

Units

Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. Các trường này bao gồm trường instruction trong NavigationInstruction. Giá trị này không ảnh hưởng đến các đơn vị đo lường được dùng cho tuyến đường, chặng đường, khoảng cách bước và thời lượng. Nếu bạn không cung cấp giá trị này, thì các đơn vị hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên.

optimize_waypoint_order

bool

Không bắt buộc. Nếu bạn đặt thành true, dịch vụ sẽ cố gắng giảm thiểu tổng chi phí của tuyến đường bằng cách sắp xếp lại các điểm trung gian đã chỉ định. Yêu cầu sẽ không thành công nếu có điểm trung gian nào đó là điểm trung gian via. Sử dụng ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index để tìm thứ tự mới. Nếu không yêu cầu ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index trong tiêu đề X-Goog-FieldMask, yêu cầu sẽ không thành công. Nếu bạn đặt optimize_waypoint_order thành false, ComputeRoutesResponse.optimized_intermediate_waypoint_index sẽ trống.

requested_reference_routes[]

ReferenceRoute

Không bắt buộc. Chỉ định các tuyến đường tham chiếu cần tính toán trong yêu cầu ngoài tuyến đường mặc định. Tuyến tham chiếu là tuyến có mục tiêu tính toán tuyến khác với tuyến mặc định. Ví dụ: tính toán tuyến đường tham chiếu FUEL_EFFICIENT sẽ tính đến nhiều tham số để tạo ra tuyến đường tiết kiệm nhiên liệu tối ưu. Khi sử dụng tính năng này, hãy tìm route_labels trên các tuyến đường thu được.

extra_computations[]

ExtraComputation

Không bắt buộc. Danh sách các phép tính bổ sung có thể được dùng để hoàn tất yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trong phản hồi. Bạn cũng phải chỉ định các trường bổ sung này trong mặt nạ trường để được trả về trong phản hồi.

traffic_model

TrafficModel

Không bắt buộc. Chỉ định các giả định cần sử dụng khi tính thời gian trong lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường thời lượng trong RouteRouteLeg. Trường này chứa thời gian dự đoán trong lưu lượng truy cập dựa trên mức trung bình trước đây. TrafficModel chỉ dùng được cho các yêu cầu đã đặt RoutingPreference thành TRAFFIC_AWARE_OPTIMALRouteTravelMode thành DRIVE. Mặc định là BEST_GUESS nếu lưu lượng truy cập được yêu cầu và TrafficModel không được chỉ định.

transit_preferences

TransitPreferences

Không bắt buộc. Chỉ định các tuỳ chọn ưu tiên ảnh hưởng đến tuyến đường được trả về cho các tuyến đường TRANSIT. LƯU Ý: Bạn chỉ có thể chỉ định transit_preferences khi RouteTravelMode được đặt thành TRANSIT.

ExtraComputation

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

Enum
EXTRA_COMPUTATION_UNSPECIFIED Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công.
TOLLS Thông tin về phí cầu đường cho(các) tuyến đường.
FUEL_CONSUMPTION Mức tiêu thụ nhiên liệu ước tính cho(các) tuyến đường.
TRAFFIC_ON_POLYLINE Đường đa tuyến có tính năng nhận biết tình hình giao thông cho(các) tuyến đường.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions được trình bày dưới dạng một chuỗi văn bản HTML được định dạng. Nội dung này được đọc nguyên trạng. Nội dung này chỉ để hiển thị. Không phân tích cú pháp theo phương thức lập trình.
FLYOVER_INFO_ON_POLYLINE Thông tin về đường bay cho(các) tuyến đường. Bạn phải chỉ định mặt nạ trường routes.polyline_details.flyover_info để trả về thông tin này. Dữ liệu này hiện chỉ được điền sẵn cho một số thành phố lớn ở Ấn Độ. Đây là tính năng thử nghiệm và SKU/phí có thể thay đổi.
NARROW_ROAD_INFO_ON_POLYLINE Thông tin về đường hẹp cho(các) tuyến đường. Bạn phải chỉ định mặt nạ trường routes.polyline_details.narrow_road_info để trả về thông tin này. Dữ liệu này hiện chỉ được điền sẵn cho một số thành phố lớn ở Ấn Độ. Đây là tính năng thử nghiệm và SKU/phí có thể thay đổi.

ReferenceRoute

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

Enum
REFERENCE_ROUTE_UNSPECIFIED Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công.
FUEL_EFFICIENT Tuyến đường tiết kiệm nhiên liệu.
SHORTER_DISTANCE

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

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

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

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

ComputeRoutesResponse

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

Trường
routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

FallbackInfo

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

Trường
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

FallbackReason

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

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

FallbackRoutingMode

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

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

GeocodedWaypoint

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

Trường
geocoder_status

Status

Cho biết mã trạng thái do thao tác liên kết địa lý.

type[]

string

(Các) loại kết quả, ở dạng từ 0 thẻ loại trở lên. Các loại được hỗ trợ: Loại địa chỉ và loại thành phần địa chỉ.

partial_match

bool

Cho biết trình dịch địa lý không trả về kết quả khớp chính xác cho yêu cầu ban đầu, mặc dù có thể khớp một phần của địa chỉ được yêu cầu. Bạn nên kiểm tra yêu cầu ban đầu để xem có lỗi chính tả và/hoặc địa chỉ chưa hoàn chỉnh hay không.

place_id

string

Mã địa điểm của kết quả này.

intermediate_waypoint_request_index

int32

Chỉ mục của điểm trung gian tương ứng trong yêu cầu. Chỉ được điền nếu điểm trung gian tương ứng là điểm trung gian.

GeocodingResults

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

Trường
origin

GeocodedWaypoint

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

destination

GeocodedWaypoint

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

intermediates[]

GeocodedWaypoint

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

LocalizedTime

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

Trường
time

LocalizedText

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

time_zone

string

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

Vị trí

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

Trường
lat_lng

LatLng

Toạ độ địa lý của điểm trung gian.

heading

Int32Value

Hướng la bàn liên quan đến hướng của luồng giao thông. Giá trị này chỉ định bên đường để đón và trả khách. Giá trị hướng có thể từ 0 đến 360, trong đó 0 chỉ định hướng chính Bắc, 90 chỉ định hướng chính Đông, v.v. Bạn chỉ có thể sử dụng trường này cho DRIVETWO_WHEELER RouteTravelMode.

Thao tác

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

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

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

Trường
maneuver

Maneuver

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

instructions

string

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

Hình nhiều đường

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

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

string

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

geo_json_linestring

Struct

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

PolylineDetails

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

Trường
flyover_info[]

FlyoverInfo

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

narrow_road_info[]

NarrowRoadInfo

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

FlyoverInfo

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

Trường
flyover_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

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

NarrowRoadInfo

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

Trường
narrow_road_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

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

PolylinePointIndex

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

Trường
start_index

int32

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

end_index

int32

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

RoadFeatureState

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

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

PolylineEncoding

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

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

PolylineQuality

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

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

Tuyến đường

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

Trường
route_labels[]

RouteLabel

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

legs[]

RouteLeg

Tập hợp các chặng (phân đoạn đường dẫn giữa các điểm trung gian) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai Waypoints không phải via. Ví dụ: một tuyến đường không có điểm trung gian chỉ có một chặng. Một tuyến đường có một điểm trung gian không phải via sẽ có hai chặng. Một tuyến đường có một điểm trung gian via sẽ có một chặng. Thứ tự của các chặng khớp với thứ tự của các điểm trung gian từ origin đến intermediates đến destination.

distance_meters

int32

Quãng đường đi của tuyến đường, tính bằng mét.

duration

Duration

Khoảng thời gian cần thiết để đi theo tuyến đường. Nếu bạn đặt routing_preference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với static_duration. Nếu bạn đặt routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán có tính đến điều kiện giao thông.

static_duration

Duration

Thời gian di chuyển qua tuyến đường mà không tính đến tình trạng giao thông.

polyline

Polyline

Hình nhiều đường của tuyến đường tổng thể. Đường đa tuyến này là đường đa tuyến kết hợp của tất cả legs.

description

string

Nội dung mô tả tuyến đường.

warnings[]

string

Một mảng cảnh báo sẽ hiển thị khi hiển thị tuyến đường.

viewport

Viewport

Hộp giới hạn khung nhìn của đường đa tuyến.

travel_advisory

RouteTravelAdvisory

Thông tin bổ sung về tuyến đường.

optimized_intermediate_waypoint_index[]

int32

Nếu bạn đặt optimize_waypoint_order thành true, trường này sẽ chứa thứ tự tối ưu hoá của các điểm trung gian. Nếu không, trường này sẽ trống. Ví dụ: nếu bạn nhập thông tin đầu vào là Điểm xuất phát: LA; Điểm trung gian: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm trung gian được tối ưu hoá là Phoenix, Dallas, Bangor, thì trường này sẽ chứa các giá trị [2, 0, 1]. Chỉ mục bắt đầu bằng 0 cho điểm trung gian đầu tiên được cung cấp trong dữ liệu đầu vào.

localized_values

RouteLocalizedValues

Biểu diễn văn bản của các thuộc tính của Route.

route_token

string

Mã thông báo mờ có thể được truyền đến Navigation SDK để tái tạo tuyến đường trong quá trình điều hướng và trong trường hợp định tuyến lại, hãy tuân thủ ý định ban đầu khi tạo tuyến đường. Xem mã thông báo này là một blob mờ. Đừng so sánh giá trị của thuộc tính này trên các yêu cầu vì giá trị của thuộc tính này có thể thay đổi ngay cả khi dịch vụ trả về cùng một tuyến.

LƯU Ý: Route.route_token chỉ dùng được cho các yêu cầu đã đặt ComputeRoutesRequest.routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL. Route.route_token không được hỗ trợ cho các yêu cầu có điểm trung gian Via.

polyline_details

PolylineDetails

Chứa thông tin về các chi tiết dọc theo đường đa tuyến.

RouteLocalizedValues

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

Trường
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

transit_fare

LocalizedText

Giá vé phương tiện công cộng được thể hiện ở dạng văn bản.

RouteLabel

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

Enum
ROUTE_LABEL_UNSPECIFIED Mặc định – không được sử dụng.
DEFAULT_ROUTE Tuyến đường "tốt nhất" mặc định được trả về cho quá trình tính toán tuyến đường.
DEFAULT_ROUTE_ALTERNATE Một tuyến đường thay thế cho tuyến đường "tốt nhất" mặc định. Các tuyến đường như thế này sẽ được trả về khi bạn chỉ định compute_alternative_routes.
FUEL_EFFICIENT Tuyến đường tiết kiệm nhiên liệu. Các tuyến đường được gắn nhãn bằng giá trị này được xác định là được tối ưu hoá cho các tham số Tiết kiệm, chẳng hạn như mức tiêu thụ nhiên liệu.
SHORTER_DISTANCE Tuyến đường có quãng đường di chuyển ngắn hơn. Đây là tính năng thử nghiệm.

RouteLeg

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

Trường
distance_meters

int32

Khoảng cách di chuyển của chặng đường, tính bằng mét.

duration

Duration

Khoảng thời gian cần thiết để di chuyển chặng bay. 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_preferenceTRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán dựa trên điều kiện giao thông.

static_duration

Duration

Thời gian di chuyển qua chặng, được tính toán mà không tính đến tình trạng giao thông.

polyline

Polyline

Đường đa tuyến tổng thể cho chặng này bao gồm đường đa tuyến của mỗi step.

start_location

Location

Vị trí bắt đầu của chặng này. Vị trí này có thể khác với origin đã cung cấp. Ví dụ: khi origin được cung cấp không ở gần đường, thì đây là một điểm trên đường.

end_location

Location

Vị trí kết thúc của chặng này. Vị trí này có thể khác với destination đã cung cấp. Ví dụ: khi destination được cung cấp không ở gần đường, thì đây là một điểm trên đường.

steps[]

RouteLegStep

Một mảng các bước biểu thị các phân đoạn trong chặng này. Mỗi bước đại diện cho một hướng dẫn điều hướng.

travel_advisory

RouteLegTravelAdvisory

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

localized_values

RouteLegLocalizedValues

Biểu diễn văn bản của các thuộc tính của RouteLeg.

steps_overview

StepsOverview

Thông tin tổng quan về các bước trong RouteLeg này. Trường này chỉ được điền sẵn cho các tuyến PHƯƠNG TIỆN CÔNG CỘNG.

RouteLegLocalizedValues

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

Trường
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

StepsOverview

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

Trường
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

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

Trường
navigation_instruction

NavigationInstruction

NavigationInstruction cho phân đoạn đa phương thức.

travel_mode

RouteTravelMode

Phương tiện đi lại của đoạn đường đa phương thức.

step_start_index

int32

Chỉ mục RouteLegStep tương ứng là điểm bắt đầu của một phân đoạn đa phương thức.

step_end_index

int32

Chỉ mục RouteLegStep tương ứng là phần cuối của một phân đoạn đa phương thức.

RouteLegStep

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

Trường
distance_meters

int32

Quãng đường di chuyển của bước này, tính bằng mét. Trong một số trường hợp, trường này có thể không có giá trị.

static_duration

Duration

Thời gian di chuyển qua bước này mà không tính đến tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị.

polyline

Polyline

Đường đa tuyến liên kết với bước này.

start_location

Location

Vị trí bắt đầu của bước này.

end_location

Location

Vị trí kết thúc của bước này.

navigation_instruction

NavigationInstruction

Hướng dẫn điều hướng.

travel_advisory

RouteLegStepTravelAdvisory

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

localized_values

RouteLegStepLocalizedValues

Biểu diễn văn bản của các thuộc tính của RouteLegStep.

transit_details

RouteLegStepTransitDetails

Thông tin chi tiết liên quan đến bước này nếu chế độ đi lại là TRANSIT.

travel_mode

RouteTravelMode

Phương thức di chuyển được sử dụng cho bước này.

RouteLegStepLocalizedValues

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

Trường
distance

LocalizedText

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

static_duration

LocalizedText

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

RouteLegStepTransitDetails

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

Trường
stop_details

TransitStopDetails

Thông tin về điểm đến và điểm khởi hành của bước.

localized_values

TransitDetailsLocalizedValues

Biểu diễn văn bản của các thuộc tính của RouteLegStepTransitDetails.

headsign

string

Chỉ định hướng di chuyển trên tuyến này như được đánh dấu trên xe hoặc tại điểm dừng khởi hành. Hướng thường là ga cuối.

headway

Duration

Chỉ định thời gian dự kiến dưới dạng thời lượng giữa các chuyến khởi hành từ cùng một điểm dừng tại thời điểm này. Ví dụ: với giá trị khoảng thời gian giữa các chuyến xe là 600 giây, bạn sẽ phải chờ 10 phút nếu lỡ chuyến xe buýt.

transit_line

TransitLine

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

stop_count

int32

Số điểm dừng từ điểm khởi hành đến điểm đến. Số lượng này bao gồm điểm dừng đến nhưng không bao gồm điểm dừng khởi hành. Ví dụ: nếu tuyến xe buýt của bạn khởi hành từ Bến A, đi qua Bến B và C rồi đến Bến D,

stop_count

trả về 3.

trip_short_text

string

Văn bản xuất hiện trong lịch trình và bảng hiệu để xác định chuyến đi bằng phương tiện công cộng cho hành khách. Văn bản phải xác định một chuyến đi trong một ngày hoạt động. Ví dụ: "538" là trip_short_text của chuyến tàu Amtrak khởi hành từ San Jose, California lúc 15:10 vào các ngày trong tuần đến Sacramento, California.

TransitDetailsLocalizedValues

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

Trường
arrival_time

LocalizedTime

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

departure_time

LocalizedTime

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

TransitStopDetails

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

Trường
arrival_stop

TransitStop

Thông tin về điểm dừng đến của bước.

arrival_time

Timestamp

Thời gian đến dự kiến của bước.

departure_stop

TransitStop

Thông tin về điểm dừng khởi hành của bước.

departure_time

Timestamp

Thời gian khởi hành ước tính cho bước này.

RouteLegStepTravelAdvisory

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

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

Trường
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

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

Ví dụ:

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

RouteMatrixDestination

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

Trường
waypoint

Waypoint

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

RouteMatrixElement

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

Trường
status

Status

Mã trạng thái lỗi cho phần tử này.

condition

RouteMatrixElementCondition

Cho biết liệu có tìm thấy tuyến đường hay không. Không phụ thuộc vào trạng thái.

distance_meters

int32

Quãng đường đi của tuyến đường, tính bằng mét.

duration

Duration

Khoảng thời gian cần thiết để đi theo tuyến đường. Nếu bạn đặt routing_preference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với static_duration. Nếu bạn đặt routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán có tính đến điều kiện giao thông.

static_duration

Duration

Thời gian di chuyển qua tuyến đường mà không tính đến tình trạng giao thông.

travel_advisory

RouteTravelAdvisory

Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về quy định hạn chế và thông tin về phí cầu đường

fallback_info

FallbackInfo

Trong một số trường hợp, khi không thể tính toán tuyến đường bằng các lựa chọn ưu tiên đã cho cho cặp điểm xuất phát/điểm đến cụ thể này, máy chủ có thể quay lại sử dụng một chế độ tính toán khác. Khi chế độ dự phòng được sử dụng, trường này sẽ chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.

localized_values

LocalizedValues

Biểu diễn văn bản của các thuộc tính của RouteMatrixElement.

origin_index

int32

Chỉ mục gốc dựa trên 0 trong yêu cầu.

destination_index

int32

Chỉ mục dựa trên số 0 của đích đến trong yêu cầu.

LocalizedValues

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

Trường
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

transit_fare

LocalizedText

Giá vé phương tiện công cộng được thể hiện ở dạng văn bản.

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

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

Trường
waypoint

Waypoint

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

route_modifiers

RouteModifiers

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

RouteModifiers

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

Trường
avoid_tolls

bool

Khi được đặt thành true, tính năng này sẽ tránh các đường có thu phí khi hợp lý, ưu tiên các tuyến không chứa đường có thu phí. Chỉ áp dụng cho DRIVETWO_WHEELER RouteTravelMode.

avoid_highways

bool

Khi được đặt thành true, chế độ này sẽ tránh đường cao tốc khi hợp lý, ưu tiên các tuyến không chứa đường cao tốc. Chỉ áp dụng cho DRIVETWO_WHEELER RouteTravelMode.

avoid_ferries

bool

Khi được đặt thành true, tính năng này sẽ tránh các chuyến phà khi hợp lý, ưu tiên các tuyến không chứa phà. Chỉ áp dụng cho DRIVETWO_WHEELER RouteTravelMode.

avoid_indoor

bool

Khi được đặt thành đúng, tính năng này sẽ tránh điều hướng trong nhà khi hợp lý, ưu tiên các tuyến không chứa tính năng điều hướng trong nhà. Chỉ áp dụng cho WALK RouteTravelMode.

vehicle_info

VehicleInfo

Chỉ định thông tin về xe.

toll_passes[]

TollPass

Bao gồm thông tin về thẻ thu phí. Nếu bạn cung cấp thẻ thu phí, API sẽ cố gắng trả về giá của thẻ đó. Nếu bạn không cung cấp thẻ thu phí, API sẽ coi thẻ thu phí là không xác định và cố gắng trả về giá bằng tiền mặt. Chỉ áp dụng cho DRIVETWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

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

Trường
toll_info

TollInfo

Chứa thông tin về phí cầu đường trên tuyến đường. Trường này chỉ được điền nếu có thu phí trên tuyến đường. Nếu bạn đặt trường này nhưng không điền trường con estimatedPrice, thì tuyến đường sẽ có trạm thu phí nhưng không xác định được giá ước tính. Nếu bạn không đặt trường này, thì sẽ không có phí cầu đường nào trên tuyến đường.

speed_reading_intervals[]

SpeedReadingInterval

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

Ví dụ:

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

int64

Mức tiêu thụ nhiên liệu dự đoán tính bằng microlit.

route_restrictions_partially_ignored

bool

Tuyến đường được trả về có thể có các quy định hạn chế không phù hợp với phương thức di chuyển hoặc đối tượng sửa đổi tuyến đường được yêu cầu.

transit_fare

Money

Nếu có, chứa tổng chi phí vé hoặc giá vé trên tuyến đường này. Thuộc tính này chỉ được trả về cho các yêu cầu TRANSIT và chỉ dành cho các tuyến đường có thông tin về giá vé cho tất cả các bước đi 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 WALK, BICYCLETWO_WHEELER đang trong giai đoạn thử nghiệm và đôi khi có thể thiếu vỉa hè, đường dành cho người đi bộ hoặc đường dành cho xe đạp rõ ràng. Bạn phải hiển thị cảnh báo này cho người dùng đối với tất cả các tuyến đường đi bộ, đi xe đạp và đi xe hai bánh mà bạn hiển thị trong ứng dụng.

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

RoutingPreference

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

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

SpeedReadingInterval

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

Trường
start_polyline_point_index

int32

Chỉ mục bắt đầu của khoảng thời gian này trong đường đa tuyến.

end_polyline_point_index

int32

Chỉ mục kết thúc của khoảng thời gian này trong đa tuyến.

Trường hợp hợp nhất speed_type.

speed_type chỉ có thể là một trong những loại sau:

speed

Speed

Tốc độ giao thông trong khoảng thời gian này.

Tốc độ

Phân loại tốc độ của đường đa tuyến dựa trên dữ liệu lưu lượng truy cập.

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

TollInfo

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

Trường
estimated_price[]

Money

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

TollPass

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

Enum
TOLL_PASS_UNSPECIFIED Không được sử dụng. Nếu bạn sử dụng giá trị này, yêu cầu sẽ không thành công.
AU_ETOLL_TAG Thẻ thu phí cầu đường Sydney. Xem thêm thông tin chi tiết tại https://www.myetoll.com.au.
AU_EWAY_TAG Thẻ thu phí cầu đường Sydney. Xem thêm thông tin chi tiết tại https://www.tollpay.com.au.
AU_LINKT Thẻ thu phí trên toàn Úc. Xem thêm thông tin chi tiết tại https://www.linkt.com.au/.
AR_TELEPASE Thẻ thu phí cầu đường của Argentina. Xem thêm thông tin chi tiết tại https://telepase.com.ar
BR_AUTO_EXPRESO Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://www.autoexpreso.com
BR_CONECTCAR Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com.
BR_MOVE_MAIS Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://movemais.com.
BR_PASSA_RAPIDO Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://pasorapido.gob.do/
BR_SEM_PARAR Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://www.semparar.com.br.
BR_TAGGY Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://taggy.com.br.
BR_VELOE Thẻ thu phí cầu đường của Brazil. Xem thêm thông tin chi tiết tại https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Cửa khẩu Canada đến Hoa Kỳ.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Cửa khẩu Canada đến Hoa Kỳ.
CA_US_BLUE_WATER_EDGE_PASS Cửa khẩu biên giới từ Ontario, Canada đến Michigan, Hoa Kỳ.
CA_US_CONNEXION Cửa khẩu biên giới từ Ontario, Canada đến Michigan, Hoa Kỳ.
CA_US_NEXUS_CARD Cửa khẩu Canada đến Hoa Kỳ.
ID_E_TOLL Indonesia. Thẻ điện tử do nhiều ngân hàng cung cấp, dùng để thanh toán phí cầu đường. Tất cả thẻ điện tử qua ngân hàng đều được tính phí như nhau nên bạn chỉ cần một giá trị enum. Ví dụ: – Bank Mandiri https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT Ấn Độ, miễn trừ biển số tiểu bang HP.
JP_ETC Nhật Bản ETC. Hệ thống không dây điện tử để thu phí. https://www.go-etc.jp/
JP_ETC2 Nhật Bản ETC2.0. Phiên bản ETC mới có mức chiết khấu cao hơn và khả năng giao tiếp hai chiều giữa các thiết bị trên xe và ăng-ten trên đường. https://www.go-etc.jp/etc2/index.html
MX_IAVE Thẻ thu phí đường bộ ở Mexico. https://iave.capufe.gob.mx/#/
MX_PASE Mexico https://www.pase.com.mx
MX_QUICKPASS Mexico https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Mexico
MX_TAG_TELEVIA Công ty thu phí cầu đường ở Mexico. Một trong nhiều công ty hoạt động ở Mexico City. Xem thêm thông tin tại https://www.televia.com.mx.
MX_TELEVIA Công ty thu phí cầu đường ở Mexico. Một trong nhiều đài truyền hình hoạt động ở Thành phố Mexico. https://www.televia.com.mx
MX_VIAPASS Thẻ thu phí đường bộ của Mexico. Xem thêm thông tin chi tiết tại https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, Hoa Kỳ.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Alaska, Hoa Kỳ.
US_CA_FASTRAK Canada, Hoa Kỳ.
US_CA_FASTRAK_CAV_STICKER Cho biết người lái xe có thẻ FasTrak nào đó ngoài hình dán Xe chạy bằng không khí sạch (CAV) do DMV phát hành. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, Hoa Kỳ.
US_CO_GO_PASS CO, Hoa Kỳ.
US_DE_EZPASSDE Đức, Hoa Kỳ.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Florida, Hoa Kỳ.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Florida, Hoa Kỳ.
US_FL_EPASS Florida, Hoa Kỳ.
US_FL_GIBA_TOLL_PASS Florida, Hoa Kỳ.
US_FL_LEEWAY Florida, Hoa Kỳ.
US_FL_SUNPASS Florida, Hoa Kỳ.
US_FL_SUNPASS_PRO Florida, Hoa Kỳ.
US_IL_EZPASSIL IL, Hoa Kỳ.
US_IL_IPASS IL, Hoa Kỳ.
US_IN_EZPASSIN Ấn Độ, Hoa Kỳ.
US_KS_BESTPASS_HORIZON KS, Hoa Kỳ.
US_KS_KTAG KS, Hoa Kỳ.
US_KS_NATIONALPASS KS, Hoa Kỳ.
US_KS_PREPASS_ELITEPASS KS, Hoa Kỳ.
US_LA_GEAUXPASS Los Angeles, Hoa Kỳ.
US_LA_TOLL_TAG Los Angeles, Hoa Kỳ.
US_MA_EZPASSMA MA, Hoa Kỳ.
US_MD_EZPASSMD Maryland, Hoa Kỳ.
US_ME_EZPASSME Maine, Hoa Kỳ.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, Hoa Kỳ.
US_MI_BCPASS MI, Hoa Kỳ.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, Hoa Kỳ.
US_MI_IQ_PROX_CARD

MI, Hoa Kỳ. Không dùng nữa vì loại thẻ và vé này không còn tồn tại.

US_MI_IQ_TAG MI, Hoa Kỳ.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, Hoa Kỳ.
US_MI_NEXPRESS_TOLL MI, Hoa Kỳ.
US_MN_EZPASSMN MN, Hoa Kỳ.
US_NC_EZPASSNC Bắc Carolina, Hoa Kỳ.
US_NC_PEACH_PASS Bắc Carolina, Hoa Kỳ.
US_NC_QUICK_PASS Bắc Carolina, Hoa Kỳ.
US_NH_EZPASSNH NH, Hoa Kỳ.
US_NJ_DOWNBEACH_EXPRESS_PASS New Jersey, Hoa Kỳ.
US_NJ_EZPASSNJ New Jersey, Hoa Kỳ.
US_NY_EXPRESSPASS New York, Hoa Kỳ.
US_NY_EZPASSNY New York, Hoa Kỳ.
US_OH_EZPASSOH Ohio, Hoa Kỳ.
US_PA_EZPASSPA Pennsylvania, Hoa Kỳ.
US_RI_EZPASSRI RI, Hoa Kỳ.
US_SC_PALPASS SC, Hoa Kỳ.
US_TX_AVI_TAG TX, Hoa Kỳ.
US_TX_BANCPASS TX, Hoa Kỳ.
US_TX_DEL_RIO_PASS TX, Hoa Kỳ.
US_TX_EFAST_PASS TX, Hoa Kỳ.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, Hoa Kỳ.
US_TX_EPTOLL TX, Hoa Kỳ.
US_TX_EZ_CROSS TX, Hoa Kỳ.
US_TX_EZTAG TX, Hoa Kỳ.
US_TX_FUEGO_TAG TX, Hoa Kỳ.
US_TX_LAREDO_TRADE_TAG TX, Hoa Kỳ.
US_TX_PLUSPASS TX, Hoa Kỳ.
US_TX_TOLLTAG TX, Hoa Kỳ.
US_TX_TXTAG TX, Hoa Kỳ.
US_TX_XPRESS_CARD TX, Hoa Kỳ.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, Hoa Kỳ.
US_VA_EZPASSVA Virginia, Hoa Kỳ.
US_WA_BREEZEBY WA, Hoa Kỳ.
US_WA_GOOD_TO_GO WA, Hoa Kỳ.
US_WV_EZPASSWV West Virginia, Hoa Kỳ.
US_WV_MEMORIAL_BRIDGE_TICKETS West Virginia, Hoa Kỳ.
US_WV_MOV_PASS West Virginia, Hoa Kỳ
US_WV_NEWELL_TOLL_BRIDGE_TICKET West Virginia, Hoa Kỳ.

TrafficModel

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

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

TransitAgency

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

Trường
name

string

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

phone_number

string

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

uri

string

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

TransitLine

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

Trường
agencies[]

TransitAgency

Công ty vận tải (hoặc các công ty vận tải) vận hành tuyến phương tiện công cộng này.

name

string

Tên đầy đủ của tuyến phương tiện công cộng này. Ví dụ: "8 Avenue Local".

uri

string

URI cho tuyến phương tiện công cộng này do công ty vận tải cung cấp.

color

string

Màu sắc thường dùng trong biển báo cho tuyến đường này. Được biểu thị bằng hệ thập lục phân.

icon_uri

string

URI cho biểu tượng liên kết với dòng này.

name_short

string

Tên ngắn của tuyến phương tiện công cộng này. Tên này thường là số dòng, chẳng hạn như "M7" hoặc "355".

text_color

string

Màu thường dùng trong văn bản trên biển báo cho tuyến này. Được biểu thị bằng hệ thập lục phân.

vehicle

TransitVehicle

Loại phương tiện hoạt động trên tuyến phương tiện công cộng này.

TransitPreferences

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

Trường
allowed_travel_modes[]

TransitTravelMode

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

routing_preference

TransitRoutingPreference

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

TransitRoutingPreference

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

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

TransitTravelMode

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

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

TransitStop

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

Trường
name

string

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

location

Location

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

TransitVehicle

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

Trường
name

LocalizedText

Tên của xe này, viết hoa.

type

TransitVehicleType

Loại xe được sử dụng.

icon_uri

string

URI cho một biểu tượng liên kết với loại xe này.

local_icon_uri

string

URI cho biểu tượng liên kết với loại xe này, dựa trên biển báo phương tiện giao thông địa phương.

TransitVehicleType

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

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

Đơn vị

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

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

VehicleEmissionType

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

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Chưa chỉ định loại khí thải. Giá trị mặc định là GASOLINE.
GASOLINE Xe chạy bằng xăng.
ELECTRIC Xe chạy bằng điện.
HYBRID Xe chạy bằng nhiên liệu kết hợp (chẳng hạn như xăng + điện).
DIESEL Xe chạy bằng dầu diesel.

VehicleInfo

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

Trường
emission_type

VehicleEmissionType

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

Waypoint

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

Trường
via

bool

Đánh dấu điểm trung gian này là mốc quan trọng thay vì điểm dừng. Đối với mỗi điểm trung gian không phải là điểm trung gian trong yêu cầu, phản hồi sẽ thêm một mục vào mảng legs để cung cấp thông tin chi tiết về điểm dừng chân trên chặng đó của chuyến đi. Đặt giá trị này thành true khi bạn muốn tuyến đường đi qua điểm trung gian này mà không dừng lại. Điểm trung gian không làm cho một mục nhập được thêm vào mảng legs, nhưng các điểm trung gian này sẽ định tuyến hành trình thông qua điểm trung gian. Bạn chỉ có thể đặt giá trị này trên các điểm trung gian. Yêu cầu sẽ không thành công nếu bạn đặt trường này trên các điểm trung gian cuối cùng. Nếu ComputeRoutesRequest.optimize_waypoint_order được đặt thành true thì bạn không thể đặt trường này thành true; nếu không, yêu cầu sẽ không thành công.

vehicle_stopover

bool

Cho biết điểm trung gian là nơi xe dừng lại để đón hoặc trả khách. Khi bạn đặt giá trị này, tuyến đường được tính toán sẽ không bao gồm các điểm trung gian không phải via trên những con đường không phù hợp để đón và trả khách. Tuỳ chọn này chỉ hoạt động đối với các chế độ di chuyển DRIVETWO_WHEELER, cũng như khi location_typeLocation.

side_of_road

bool

Cho biết vị trí của điểm trung gian này là để ưu tiên xe dừng ở một bên đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí đó để xe có thể dừng ở bên đường mà vị trí đó nghiêng về phía trung tâm đường. Tuỳ chọn này chỉ hoạt động với DRIVETWO_WHEELER RouteTravelMode.

Trường hợp hợp nhất location_type. Các cách khác nhau để biểu thị một vị trí. location_type chỉ có thể là một trong những loại sau:
location

Location

Một điểm được chỉ định bằng toạ độ địa lý, bao gồm cả tiêu đề không bắt buộc.

place_id

string

Mã địa điểm POI được liên kết với điểm trung gian.

address

string

Địa chỉ mà con người đọc được hoặc plus code. Hãy xem https://plus.codes để biết thông tin chi tiết.