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, đồ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 đế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 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 phần tử, đ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.
  • Chỉ chọn những trường bạn cần trong công việc sản xuất để đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm 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, từ đó 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), dựa trên 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 đế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 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à đường đa tuyến ở cấp tuyến đường (ví dụ về chế độ thiết lập sản xuất): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google không khuyến khích việc sử dụng mặt nạ cho trường phản hồi có 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.
  • Chỉ chọn những trường bạn cần trong công việc sản xuất để đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm 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, từ đó 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 đến:

  • 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. 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 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ã vùng, được chỉ định dưới dạng 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 ý: 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 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 khi có 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 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 tập hợp các điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), để dừng 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 gây ra 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. 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 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 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 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 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ã vùng, được chỉ định dưới dạng 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. 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 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 ComputeRoutesResponseroutes.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 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 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 toán tuyến đường tham chiếu FUEL_EFFICIENT có tính đến 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 kết quả.
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 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 khi có 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 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 Đường nhiều đoạn có thông tin 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 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 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ố khu vực đô thị ở Ấ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 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ố khu vực đô thị ở Ấn Độ. Tính năng này đang trong giai đoạn thử nghiệm và SKU/phí có thể thay đổi.

ReferenceRoute

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

Enum
REFERENCE_ROUTE_UNSPECIFIED Không được 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ó 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 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 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ỳ phương thức 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ể sử dụng đối tượng 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 sử 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.
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, thì có nghĩa là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ ưu tiên của bạn làm chế độ dự phòng.

Trường
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 khiến phản hồi dự phòng được dù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 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 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à các 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à đ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à 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 điều hướng cần thực hiện cho bước hiện tại (ví dụ: rẽ trái, hợp nhất hoặc đi thẳng).

Enum
MANEUVER_UNSPECIFIED Không được 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ẽ ngoặt sang phải.
UTURN_RIGHT Quay đầu xe sang phải.
TURN_RIGHT Rẽ phải.
STRAIGHT Đi thẳng.
RAMP_LEFT Đi theo đườ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 Dùng để cho biết tên đường đã thay đổi.

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

Trường
maneuver

Maneuver

Đóng gói các 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 của một đường nhiều đoạn. 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
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 nhiều đoạn.

FlyoverInfo

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

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 nhiều đường 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 đường 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 chi tiết đườ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 đường.
end_index

int32

Chỉ mục cuối của thông tin chi tiết này trong đường nhiều đường.

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 Trạng thái của đối tượng đường không được tính toán (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.

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 Bạn chưa 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 chất lượng cao – được tạo bằng nhiều điểm hơn OVERVIEW, với chi phí là tăng kích thước phản hồi. Hãy sử dụng giá trị này khi bạn cần độ chính xác 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. Khi sử dụng lựa chọn này, độ trễ yêu cầu sẽ thấp hơn so với khi 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 để 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. Ví dụ: một tuyến đường không có điểm tham chiếu trung gian chỉ có một đoạn đườ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 đế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

Đường 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 đến trung gian: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm đến 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 tôn trọng ý đị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 đánh dấu Đường 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

Quãng đường 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, giá trị này sẽ giống với giá trị của 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ạ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 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 đánh dấu không phải là via.

Trường
distance_meters

int32

Quãng đường di chuyển của đoạn đường, tính bằng mét.
duration

Duration

Khoảng thời gian cần thiết để di chuyển trên chặng đườ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 nằm 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 mà bạn cung cấp. Ví dụ: khi destination được cung cấp không nằm 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 đoạn 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 đượ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 đ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 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

Quãng đường 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. Một đoạn đường có nhiều 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 phân đ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 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 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 xét đế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 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 cách đi theo chỉ dẫn.
travel_advisory

RouteLegStepTravelAdvisory

Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các quy định hạn chế có thể có về khu vực giao thông, trong một bước của chặng đườ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.
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ụ: nếu giá trị thời gian giữa các chuyến là 600 giây, thì 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 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 bắt đầu từ Điểm dừng A, đi qua các điểm dừng B và C, rồi đến điểm dừng 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 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 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 ở 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ế về vùng giao thông có thể có đối với một bước trong 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ế 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 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 tốc độ 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 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 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ề 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 sử 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

Quãng đường 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ạ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 vào 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 tập hợp 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, chế độ này sẽ tránh điều hướng trong nhà nếu có thể, ưu tiên những tuyến đường không chứa chỉ dẫn đường đi 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á tiền mặt. Chỉ áp dụng cho DRIVE và TWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các quy định hạn chế có thể có 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 đưa vào 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ó trạm thu phí.
speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc tốc độ 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 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

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 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 chế độ 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 xe đạp.
WALK Đi bộ.
TWO_WHEELER Phương tiện 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.
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 thực tế. 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 lượng đượ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ộ, điều kiện 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ể thay đổi 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 hình giao thông thực tế. 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 hoạt động 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 đoạn.
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 đoạn.
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 đường 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 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 khắp thế giới mà chúng tôi hỗ trợ.

Enum
TOLL_PASS_UNSPECIFIED Không được dùng. Nếu bạn sử dụng giá trị này, 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 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 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í đường cao tốc ở 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 chạy bằng năng lượng sạch (CAV) do DMV cấp. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, Hoa Kỳ.
US_CO_GO_PASS CO, Hoa Kỳ.
US_DE_EZPASSDE Đức, Hoa Kỳ.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, Hoa Kỳ.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, Hoa Kỳ.
US_FL_EPASS FL, Hoa Kỳ.
US_FL_GIBA_TOLL_PASS FL, Hoa Kỳ.
US_FL_LEEWAY FL, Hoa Kỳ.
US_FL_SUNPASS FL, Hoa Kỳ.
US_FL_SUNPASS_PRO FL, Hoa Kỳ.
US_IL_EZPASSIL IL, Hoa Kỳ.
US_IL_IPASS IL, Hoa Kỳ.
US_IN_EZPASSIN Ấn Độ, Hoa Kỳ.
US_KS_BESTPASS_HORIZON KS, Hoa Kỳ.
US_KS_KTAG KS, Hoa Kỳ.
US_KS_NATIONALPASS KS, Hoa Kỳ.
US_KS_PREPASS_ELITEPASS KS, Hoa Kỳ.
US_LA_GEAUXPASS Los Angeles, Hoa Kỳ.
US_LA_TOLL_TAG Los Angeles, 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 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ẻ 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 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 OH, Hoa Kỳ.
US_PA_EZPASSPA PA, Hoa Kỳ.
US_RI_EZPASSRI RI, Hoa Kỳ.
US_SC_PALPASS SC, Hoa Kỳ.
US_TX_AVI_TAG TX, Hoa Kỳ.
US_TX_BANCPASS TX, Hoa Kỳ.
US_TX_DEL_RIO_PASS TX, Hoa Kỳ.
US_TX_EFAST_PASS TX, Hoa Kỳ.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, Hoa Kỳ.
US_TX_EPTOLL TX, Hoa Kỳ.
US_TX_EZ_CROSS TX, Hoa Kỳ.
US_TX_EZTAG TX, Hoa Kỳ.
US_TX_FUEGO_TAG TX, Hoa Kỳ.
US_TX_LAREDO_TRADE_TAG TX, Hoa Kỳ.
US_TX_PLUSPASS TX, Hoa Kỳ.
US_TX_TOLLTAG TX, Hoa Kỳ.
US_TX_TXTAG TX, Hoa Kỳ.
US_TX_XPRESS_CARD TX, Hoa Kỳ.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, Hoa Kỳ.
US_VA_EZPASSVA VA, Hoa Kỳ.
US_WA_BREEZEBY WA, Hoa Kỳ.
US_WA_GOOD_TO_GO WA, Hoa Kỳ.
US_WV_EZPASSWV WV, Hoa Kỳ.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, Hoa Kỳ.
US_WV_MOV_PASS WV, Hoa Kỳ
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Hoa Kỳ.

TrafficModel

Trường này chỉ định một trong những giả định sau đây để sử dụng khi tính toán thời gian di chuyển trong điều kiện 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 sử dụng. Nếu được chỉ định, giá trị mặc định sẽ là BEST_GUESS.
BEST_GUESS Cho biết rằng duration được trả về phải là thô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à tình trạng giao thông trực tiếp. Thông tin giao thông trực tiếp 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 điều kiện giao thông đặc biệt xấu có thể vượt quá giá trị này.
OPTIMISTIC Cho biết rằng thời 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 điều kiện giao thông đặc biệt thuận lợi có thể nhanh hơn giá trị này.

TransitAgency

Công ty vận tải vận hành một tuyến đường của phương tiện công cộng.

Trường
name

string

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

string

Số điện thoại được định dạng 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ề tuyến phương tiện công cộng đượ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 tuyến phương tiện công cộng này.
name

string

Tên đầy đủ của tuyến giao thông công cộng này, ví dụ: "8 Avenue Local".
uri

string

URI của 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 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ố 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 tuyến đường vận chuyể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 nhóm các chế độ di chuyển để sử dụng khi nhận được tuyến đường TRANSIT. Theo mặc định, tất cả các phương tiện đi lại đượ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 một số lượng hạn chế các lượt chuyển phương tiện.

TransitTravelMode

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

Enum
TRANSIT_TRAVEL_MODE_UNSPECIFIED Không chỉ định phương tiện giao thông công cộng.
BUS Đi xe buýt.
SUBWAY Đi tàu điện ngầm.
TRAIN Đi tàu hoả.
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 đ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 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 đị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 sử dụng.
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 Phương tiện đượ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 Đường sắt 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 Xe lửa 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 mình.
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.

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 là điểm dừng. Đối với mỗi điểm dừng 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 là nơi mà 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 đá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 ở bên đường mà vị trí đó hướng đến từ giữa đường. Lựa chọn này chỉ hoạt động cho 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ả tiêu đề không bắt buộc.
place_id

string

Mã địa điểm của điểm đến đượ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 xem https://plus.codes để biết thông tin chi tiết.