Package google.maps.routing.v2

Chỉ mục

Tuyến đường

API Tuyến đường.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Nhận danh sách các điểm gốc và đích đến rồi trả về một luồng chứa thông tin tuyến đường cho từng tổ hợp điểm khởi hành và đích đế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 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 các đườ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 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 thể hiện thời lượng tuyến đường, khoảng cách, trạng thái phần tử, điều kiện và chỉ mục phần tử (ví dụ về chế độ thiết lập phiên bản chính thức): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

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

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Trả về tuyến đường chính cùng với các tuyến thay thế không bắt buộc, với một tập hợp các điểm tham chiếu đầu cuối và 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 dùng tham số URL $fields hoặc fields hoặc tiêu đề HTTP/gRPC X-Goog-FieldMask (xem các tiêu đề và tham số URL có sẵn). Giá trị này là một danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Xem tài liệu chi tiết về cách tạo đường dẫn trường.

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

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

ComputeRouteMatrixRequest

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

Trường
origins[]

RouteMatrixOrigin

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

  • Tổng số nguồn gốc + số lượng đích đến được chỉ định là place_id hoặc address không được lớn hơn 50.
  • Tích của số nguồn gốc × số lượng đích đến không được lớn hơn 625 trong mọi trường hợp.
  • Tích của số nguồn gốc × số lượng đích đến không được lớn hơn 100 nếu định tuyến_preference được đặt thành TRAFFIC_AWARE_OPTIMAL.
  • Tích của số điểm khởi hành × số điểm đến không được lớn hơn 100 nếu chế độ đi lại đượ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. Xác định phương thức di chuyển.

routing_preference

RoutingPreference

Không bắt buộc. Chỉ định cách tính toán tuyến. Máy chủ cố gắng sử dụng lựa chọn ưu tiên đị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ễ thêm 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ị mặc định sẽ là thời gian bạn yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định departure_time trong quá khứ khi RouteTravelMode được đặt thành TRANSIT.

arrival_time

Timestamp

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

language_code

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem Mã nhận dạng ngôn ngữ 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 đầu tiên.

region_code

string

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

units

Units

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

extra_computations[]

ExtraComputation

Không bắt buộc. Danh sách các phép tính bổ sung có thể dùng để hoàn tất yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trên 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 tham gia lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường thời lượng trong RouteMatrixElement. Trường này chứa thời gian dự đoán lưu lượng truy cập dựa trên mức trung bình trước đây. RoutingPreference đến TRAFFIC_AWARE_OPTIMALRouteTravelMode đến DRIVE. Giá trị mặc định là BEST_GUESS nếu lưu lượng truy cập được yêu cầu và TrafficModel không được chỉ định.

transit_preferences

TransitPreferences

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

ExtraComputation

Các phép tính bổ sung để 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ực hiện được.
TOLLS Thông tin tính phí cho(các) phần tử ma trận.

ComputeRoutesRequest

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

Trường
origin

Waypoint

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

destination

Waypoint

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

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

Không bắt buộc. Xác định phương thức di chuyển.

routing_preference

RoutingPreference

Không bắt buộc. Chỉ định cách tính toán tuyến. Máy chủ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến đường. Nếu lựa chọn ưu tiên định tuyến gây ra lỗi hoặc độ trễ lâu hơn 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.

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 hình nhiều đường.

polyline_encoding

PolylineEncoding

Không bắt buộc. Chỉ định phương thức mã hoá ưu tiên cho hình nhiều đường.

departure_time

Timestamp

Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này thì giá trị mặc định sẽ là thời gian bạn yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định departure_time trong quá khứ khi RouteTravelMode được đặt thành TRANSIT. 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 trong quá khứ hoặc 100 ngày trong tương lai.

arrival_time

Timestamp

Không bắt buộc. Thời gian đến. LƯU Ý: Chỉ có thể đặt khi RouteTravelMode được đặt thành TRANSIT. Bạn có thể chỉ định departure_time hoặc arrival_time, nhưng không thể chỉ định cả hai. 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 trong quá khứ hoặc 100 ngày trong tương lai.

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

Không bắt buộc. Một tập hợp các điều kiện để đáp ứng điều kiện ảnh hưởng đến cách tính toán các 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 Mã nhận dạng ngôn ngữ 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 tuyến.

region_code

string

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

units

Units

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

optimize_waypoint_order

bool

Không bắt buộc. Nếu bạn đặt chính sách này thành true, thì dịch vụ sẽ tìm cách giảm thiểu tổng chi phí của tuyến bằng cách sắp xếp lại các điểm tham chiếu trung gian được 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 đơn đặt hàng mới. Nếu không yêu cầu ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index trong tiêu đề X-Goog-FieldMask thì yêu cầu sẽ không thành công. Nếu bạn đặt optimize_waypoint_order thành false, thì ComputeRoutesResponse.optimized_intermediate_waypoint_index sẽ trống.

requested_reference_routes[]

ReferenceRoute

Không bắt buộc. Chỉ định các tuyến tham chiếu cần tính toán trong yêu cầu ngoài tuyến mặc định. Tuyến tham chiếu là một tuyến có mục tiêu tính toán tuyến đường khác với tuyến đường mặc định. Ví dụ: phép tính tuyến đường tham chiếu FUEL_EFFICIENT xét đến nhiều tham số để tạo ra một tuyến đường tiết kiệm nhiên liệu tối ưu.

extra_computations[]

ExtraComputation

Không bắt buộc. Danh sách các phép tính bổ sung có thể dùng để hoàn tất yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trên 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 tham gia 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. Các chế độ này có chứa thời gian dự đoán về lưu lượng truy cập dựa trên các mức trung bình trước đây. TrafficModel chỉ dành cho các yêu cầu đã đặt RoutingPreference thành TRAFFIC_AWARE_OPTIMALRouteTravelMode thành DRIVE. Giá trị mặc định là BEST_GUESS nếu lưu lượng truy cập được yêu cầu và TrafficModel không được chỉ định.

transit_preferences

TransitPreferences

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

ExtraComputation

Các phép tính bổ sung để 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ực hiện được.
TOLLS Thông tin thu phí cầu đường cho(các) tuyến đường.
FUEL_CONSUMPTION Mức tiêu thụ nhiên liệu ước tính cho(các) tuyến đường.
TRAFFIC_ON_POLYLINE Hình nhiều đường có khả năng nhận biết giao thông trên(các) tuyến đường.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions được trình bày dưới dạng chuỗi văn bản HTML được định dạng. Nội dung này cần được đọc nguyên trạng. Nội dung này chỉ nhằm mục đích hiển thị. Đừng phân tích cú pháp tệp theo phương thức lập trình.

ReferenceRoute

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

Enum
REFERENCE_ROUTE_UNSPECIFIED Không được sử dụng. Không thực hiện được các yêu cầu chứa giá trị này.
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à tối ưu hóa cho các thông số như mức tiêu thụ nhiên liệu.

ComputeRoutesResponse

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

Trường
routes[]

Route

Chứa một mảng các tuyến đã tính toán (tối đa 3 tuyến) khi bạn chỉ định compute_alternatives_routes và chỉ chứa một tuyến đường nếu bạn không chỉ định. Khi mảng này chứa nhiều mục nhập, thì tuyến đầu tiên sẽ là tuyến được đề xuất nhiều nhất. Nếu mảng trống thì có nghĩa là không tìm thấy tuyến 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ả tuyến đường với tất cả các lựa chọn ưu tiên đầu vào, thì máy chủ có thể sử dụng một cách tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.

geocoding_results

GeocodingResults

Chứa thông tin phản hồi mã hoá địa lý cho các điểm tham chiếu được chỉ định làm đị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ì điều đó 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 tính năng dự phòng được kích hoạt thì chế độ này có thể khác với lựa chọn ưu tiên định tuyến đã đặt trong yêu cầu ứng dụng ban đầu.

reason

FallbackReason

Lý do tại sao phản hồi dự phòng được sử dụng thay cho phản hồi ban đầu. Trường này chỉ được điền sẵ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ủ trong khi tính toán các tuyến đường bằng chế độ định tuyến ưu tiên của bạn. Tuy nhiên, chúng tôi có thể trả về kết quả được tính bằng chế độ thay thế.
LATENCY_EXCEEDED Chúng tôi không thể hoàn thành phép tính bằng chế độ định tuyến mong muốn của bạn đúng giờ, nhưng chúng tôi có thể trả về kết quả được tính bằng 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 sử dụng làm điểm tham chiếu. Chỉ được điền sẵn cho điểm tham chiếu địa chỉ. Bao gồm 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ý sang.

Trường
geocoder_status

Status

Cho biết mã trạng thái do thao tác mã hoá địa lý tạo ra.

type[]

string

(Các) loại kết quả, ở dạng không hoặc nhiều thẻ loại. Các loại được hỗ trợ: Loại địa chỉ và loại thành phần địa chỉ.

partial_match

bool

Cho biết bộ mã hoá địa lý không trả về kết quả khớp chính xác cho yêu cầu ban đầu, mặc dù bộ mã hoá có thể khớp một phần đị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 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à điểm tham chiếu trung gian. Chỉ được điền sẵn cho đ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 khởi hành.

destination

GeocodedWaypoint

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

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ự chúng được chỉ định trong yêu cầu.

LocalizedTime

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

Trường
time

LocalizedText

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

time_zone

string

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

Vị trí

Đóng gói vị trí (điểm địa lý và tiêu đề tùy chọn).

Trường
lat_lng

LatLng

Toạ độ địa lý của điểm tham chiếu.

heading

Int32Value

Hướng la bàn liên kết với hướng cho phép lưu thông. Giá trị này chỉ định lề đường dành cho việc nhận xe và trả xe. Các giá trị hướng có thể từ 0 đến 360, trong đó 0 chỉ định hướng đến là hướng Bắc, 90 chỉ định hướng đến là hướng Đô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 thao tác cần thực hiện cho bước hiện tại (ví dụ: rẽ trái, hợp nhất hoặc đi thẳng).

Enum
MANEUVER_UNSPECIFIED Không được sử dụng.
TURN_SLIGHT_LEFT Xoay nhẹ sang trái.
TURN_SHARP_LEFT Rẽ ngoặt sang trái.
UTURN_LEFT Vòng sang trái.
TURN_LEFT Rẽ trái.
TURN_SLIGHT_RIGHT Xoay nhẹ sang phải.
TURN_SHARP_RIGHT Rẽ ngoặt sang phải.
UTURN_RIGHT Vòng sang phải.
TURN_RIGHT Rẽ phải.
STRAIGHT Đi thẳng.
RAMP_LEFT Đi theo đoạn đường nối bên trái.
RAMP_RIGHT Đi theo đoạn đường nối bên phải.
MERGE Hợp nhất vào lưu lượng truy cập.
FORK_LEFT Rẽ trái.
FORK_RIGHT Chọn ngã ba bên phải.
FERRY Đi phà.
FERRY_TRAIN Đi tàu dẫn lên phà.
ROUNDABOUT_LEFT Rẽ trái tại đường vòng.
ROUNDABOUT_RIGHT Rẽ phải tại đường vòng.
DEPART Thao tác ban đầu.
NAME_CHANGE Được dùng để biểu thị việc thay đổi tên đường phố.

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

Trường
maneuver

Maneuver

Trình bày hướng dẫn di chuyển cho chặng 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 thực hiện bước này.

Hình nhiều đường

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

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

string

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

geo_json_linestring

Struct

Chỉ định một hình nhiều đường bằng định dạng GeoJSON LineString.

PolylineEncoding

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

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

Enum
POLYLINE_QUALITY_UNSPECIFIED Chưa chỉ định tùy chọn chất lượng hình nhiều đường. Giá trị mặc định là OVERVIEW.
HIGH_QUALITY Chỉ định một hình nhiều đường chất lượng cao (được tạo bằng cách sử dụng nhiều điểm hơn OVERVIEW), nhưng sẽ 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 hơn.
OVERVIEW Chỉ định một hình nhiều đường 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. Việc sử dụng tuỳ chọn này sẽ có độ trễ yêu cầu thấp hơn so với việc 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 với các điểm tham chiếu đầu, cuối và trung gian.

Trường
route_labels[]

RouteLabel

Nhãn cho Route hữu ích khi 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 chân (đoạn đường đi giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai chặng Waypoints không phải via. Ví dụ: một tuyến đường không có điểm tham chiếu trung gian chỉ có một chặng. Tuyến bao gồm một điểm trung gian không phải via có hai chân. Một tuyến đường bao gồm một điểm trung gian via có một chân. Thứ tự của các chân khớp với thứ tự của các điểm tham chiếu từ origin đến intermediates đến destination.

distance_meters

int32

Khoảng cách đi lại của tuyến đường, tính bằng mét.

duration

Duration

Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn đặ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 trên tuyến đường mà không tính đến tình trạng giao thông.

polyline

Polyline

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

description

string

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

warnings[]

string

Một mảng cảnh báo cần xuất hiện khi hiện tuyến đường.

viewport

Viewport

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

travel_advisory

RouteTravelAdvisory

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

optimized_intermediate_waypoint_index[]

int32

Nếu bạn đặt optimize_waypoint_order thành true, trường này sẽ chứa thứ tự tối ưu 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 giá trị Origin: LA; Điểm trung gian: Dallas, Bangor, Phoenix; Destination: New York; và thứ tự điểm tham chiếu trung gian được tối ưu hóa là Phoenix, Dallas, Bangor, thì trường này chứa các giá trị [2, 0, 1]. Chỉ mục bắt đầu bằng 0 cho điểm tham chiếu trung gian đầu tiên được cung cấp trong đầu vào.

localized_values

RouteLocalizedValues

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

route_token

string

Mã thông báo tuyến đường được mã hoá base64, an toàn trên web có thể được truyền đến SDK điều hướng, cho phép SDK điều hướng xây dựng lại tuyến đường trong khi điều hướng và trong trường hợp định tuyến lại, hãy thực hiện ý định ban đầu khi bạn tạo tuyến bằng cách gọi ComputeRoutes. Khách hàng nên coi mã thông báo này là một blob mờ. Đừng so sánh giá trị của mã giữa các yêu cầu – mã thông báo này có thể thay đổi ngay cả khi hệ thống trả về cùng một tuyến. LƯU Ý: Route.route_token chỉ có sẵn cho các yêu cầu đã đặt ComputeRoutesRequest.routing_preference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL. Route.route_token không được hỗ trợ cho các yêu cầu có điểm tham chiếu.

RouteLocalizedValues

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

Trường
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

Thời lượng mà không tính đến tình trạng giao thông, được trình bày ở dạng văn bản.

transit_fare

LocalizedText

Giá vé đi phương tiện công cộng được trình bày ở dạng văn bản.

RouteLabel

Nhãn cho Route hữu ích khi 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 "tốt nhất" mặc định được trả về để tính toán tuyến đường.
DEFAULT_ROUTE_ALTERNATE Giải pháp thay thế cho tuyến đường "tốt nhất" mặc định. Các tuyến như thế này sẽ được trả về khi compute_alternative_routes được chỉ định.
FUEL_EFFICIENT Tuyến đường tiết kiệm nhiên liệu. Những tuyến đường được gắn nhãn giá trị này được xác định là tối ưu hoá cho các thông số Tiết kiệm năng lượng, chẳng hạn như mức tiêu thụ nhiên liệu.

RouteLeg

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

Trường
distance_meters

int32

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

duration

Duration

Khoảng thời gian cần thiết để di chuyển một chặng. Nếu bạn đặt route_preference thành TRAFFIC_UNAWARE thì giá trị này sẽ giống với static_duration. Nếu route_preferenceTRAFFIC_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 đoạn đường đó, được tính mà không tính đến tình trạng giao thông.

polyline

Polyline

Hình nhiều đường tổng thể cho chặng này bao gồm từng hình nhiều đường của 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 một con đường, thì đây là một điểm trên đường.

end_location

Location

Vị trí kết thúc của chặ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 một con đường, thì đây là một điểm trên đường.

steps[]

RouteLegStep

Một dãy 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 lệnh điều hướng.

travel_advisory

RouteLegTravelAdvisory

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

localized_values

RouteLegLocalizedValues

Biểu diễn văn bản 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 cho các tuyến đường TRANSIT.

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 đi được thể hiện trong dạng văn bản.

duration

LocalizedText

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

static_duration

LocalizedText

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

Trường
navigation_instruction

NavigationInstruction

Hướng dẫn điều hướng cho đoạn đường đ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 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 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 lệnh điều hướng. Chân tuyến đường được tạo thành từ các bước.

Trường
distance_meters

int32

Khoảng cách đi lại 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 thông qua bước này mà không tính đến tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị.

polyline

Polyline

Hình nhiều đường liên kết với bước này.

start_location

Location

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

end_location

Location

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

navigation_instruction

NavigationInstruction

Hướng dẫn đi theo chỉ dẫn.

travel_advisory

RouteLegStepTravelAdvisory

Chứa thông tin bổ sung mà người dùng phải thông báo (chẳng hạn như có thể có các quy định hạn chế về khu vực giao thông) khi đi bằng chân.

localized_values

RouteLegStepLocalizedValues

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

transit_details

RouteLegStepTransitDetails

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

travel_mode

RouteTravelMode

Phương tiện đi lại dùng cho bước này.

RouteLegStepLocalizedValues

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

Trường
distance

LocalizedText

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

static_duration

LocalizedText

Thời lượng mà không tính đến tình trạng giao thông, được trình bày ở 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 dừng đến và điểm khởi hành cho chặng đi.

localized_values

TransitDetailsLocalizedValues

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

headsign

string

Nêu rõ 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 đi thường là trạm 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 vào thời điểm này. Ví dụ: với giá trị giây đi đầu là 600, bạn sẽ phải đợi 10 phút nếu lỡ xe buýt.

transit_line

TransitLine

Thông tin về đường chuyển tuyến được sử dụng trong bước này.

stop_count

int32

Số điểm dừng từ điểm khởi hành đến điểm dừng đến. 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 đường của bạn khởi hành từ Điểm dừng A, đi qua điểm dừng B và C và đến điểm dừng D, thì trạm dừng_count sẽ trả về 3.

trip_short_text

string

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

TransitDetailsLocalizedValues

Nội dung mô tả đã bản địa hoá của các giá trị cho RouteTransitDetails.

Trường
arrival_time

LocalizedTime

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

departure_time

LocalizedTime

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

TransitStopDetails

Thông tin chi tiết về các trạm dừng phương tiện công cộng của RouteLegStep.

Trường
arrival_stop

TransitStop

Thông tin về điểm dừng chân đến của chặng.

arrival_time

Timestamp

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

departure_stop

TransitStop

Thông tin về điểm dừng khởi hành cho chặng này.

departure_time

Timestamp

Thời gian khởi hành dự kiến của bước này.

RouteLegStepTravelAdvisory

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

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 phải biết khi đi bằng chân, chẳng hạn như các quy định hạn chế về khu vực giao thông có thể xảy ra.

Trường
toll_info

TollInfo

Chứa thông tin về lệ 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 sẽ có thu phí trên RouteLeg. Nếu bạn đặt trường này nhưng trường phụ giá_ước_ tính không được điền thì chúng tôi dự kiến 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ì sẽ không có phí trên RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

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

RouteMatrixElement

Chứa thông tin tuyến đường được tính toán cho cặp điểm khởi hành/đích trong API ComputeRouteMatrix. Proto này có thể được truyền trực tuyến đến máy khách.

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

Khoảng cách đi lại của tuyến đường, tính bằng mét.

duration

Duration

Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn đặ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 trên tuyến đường mà không tính đến tình trạng giao thông.

travel_advisory

RouteTravelAdvisory

Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về quy định hạn chế và 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 bằng các lựa chọn ưu tiên đã cho cho cặp điểm đi/đích 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 sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt.

localized_values

LocalizedValues

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

origin_index

int32

Chỉ mục gốc 0 của nguồn gốc trong yêu cầu.

destination_index

int32

Chỉ mục từ 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 đi được thể hiện trong dạng văn bản.

duration

LocalizedText

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

static_duration

LocalizedText

Thời lượng được thể hiện ở dạng văn bản mà không tính đến tình trạng giao thông.

transit_fare

LocalizedText

Giá vé đi phương tiện công cộng được trình bày ở dạng văn bản.

RouteMatrixElementCondition

Điều kiện 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 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 có chứa thông tin tuyến đường, chẳng hạn như distance_meters hoặc duration, sẽ không được điền trong phần tử.

RouteMatrixOrigin

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

Trường
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 lấy tuyến này làm điểm gốc

RouteModifiers

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

Trường
avoid_tolls

bool

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

avoid_highways

bool

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

avoid_ferries

bool

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

avoid_indoor

bool

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

vehicle_info

VehicleInfo

Nêu rõ thông tin về xe.

toll_passes[]

TollPass

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

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ế về khu vực lưu lượng truy cập có thể xảy ra.

Trường
toll_info

TollInfo

Chứa thông tin về lệ phí cầu đường trên tuyến đường. Trường này chỉ được điền sẵn nếu dự kiến sẽ thu phí trên tuyến đường. Nếu bạn đặt trường này nhưng trường phụ estimatedPrice không được điền thì tuyến đường có thu phí cầu đường 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 trên tuyến đường.

speed_reading_intervals[]

SpeedReadingInterval

Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp có lựa chọn ưu tiên về định tuyến TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này bao phủ toàn bộ hình nhiều đường mà không chồng chéo nhau. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng 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 tiện đi lại đã yêu cầu hoặc công cụ sửa đổi tuyến đường.

transit_fare

Money

Nếu có, chứa tổng giá vé hoặc tổng 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ỉ cho những tuyến đường có thông tin về giá vé cho tất cả các bước chuyển tuyến.

RouteTravelMode

Một tập hợp các giá trị được dùng để chỉ định phương thức đi lại. LƯU Ý: Các tuyến đường WALK, BICYCLETWO_WHEELER đang trong giai đoạn thử nghiệm nên đôi khi có thể thiếu vỉa hè rõ ràng, đường dành cho người đi bộ hoặc đường đi xe đạp. 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à hai bánh mà bạn hiển thị trong ứng dụng của mình.

Enum
TRAVEL_MODE_UNSPECIFIED Chưa chỉ định phương tiện đi lại. Giá trị mặc định là DRIVE.
DRIVE Di chuyển bằng xe khách.
BICYCLE Di chuyển bằng xe đạp.
WALK Di chuyển bằng cách đi bộ.
TWO_WHEELER Xe hai bánh, có động cơ. Ví dụ: xe máy. Lưu ý rằng chế độ này khác với chế độ đi lại BICYCLE (bao gồm chế độ sử dụng năng lượng của con người).
TRANSIT Di chuyển bằng tuyến phương tiện công cộng (nếu có).

RoutingPreference

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

Enum
ROUTING_PREFERENCE_UNSPECIFIED Chưa chỉ định tùy chọn định tuyến nào. Giá trị mặc định là TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Tính toán các tuyến đường mà không tính đến điều kiện giao thông trực tiếp. Phù hợp khi tình trạng giao thông không quan trọng hoặc không áp dụng được. 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 gian đã chọn sẽ dựa trên mạng lưới đường và tình trạng giao thông trung bình không phụ thuộc vào thời gian, chứ không phải tình trạng đường hiện tại. Do đó, các tuyến đường có thể bao gồm các đường đang tạm thời bị đóng. Kết quả cho một yêu cầu nhất định có thể thay đổi theo thời gian do những thay đổi về mạng lưới đường bộ, tình trạng giao thông trung bình đã cập nhật và tính chất phân tán của dịch vụ. Kết quả cũng có thể khác nhau giữa các tuyến 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 điều kiện giao thông trực tiếp. Trái ngược 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 giao thông 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 độ lưu lượng truy cập trên đoạn tiếp giáp của hình nhiều đường hoặc lối đi. Cho trước một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên giá trị 0), SpeedReadingInterval xác định một khoảng 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ỉ số bắt đầu của khoảng này trong hình nhiều đường.

end_polyline_point_index

int32

Chỉ số kết thúc của khoảng này trong hình nhiều đường.

Trường kết hợp speed_type.

speed_type chỉ có thể là một trong những trạng thái sau đây:

speed

Speed

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

Tốc độ

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

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

TollInfo

Đóng gói thông tin thu 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 từng loại tiền tệ dự kiến sẽ được các trạm thu phí thu phí. Thông thường, danh sách này chỉ chứa một mục cho các tuyến đường có thu phí bằng một đơn vị tiền tệ. Đối với các chuyến đi quốc tế, danh sách này có thể chứa nhiều mục để thể hiện phí cầu đường bằng các đơn vị tiền tệ khác nhau.

TollPass

Danh sách các khoản phí cầu đường trên thế giới mà chúng tôi hỗ trợ.

Enum
TOLL_PASS_UNSPECIFIED Không được sử dụng. Nếu bạn dùng giá trị này thì yêu cầu sẽ không thành công.
AU_ETOLL_TAG Phí cầu đường Sydney. Xem thêm thông tin chi tiết tại https://www.myetoll.com.au.
AU_EWAY_TAG Phí cầu đường Sydney. Xem thêm thông tin tại https://www.tollpay.com.au.
AU_LINKT Phí cầu đường trên toàn Úc. Xem thêm thông tin chi tiết tại https://www.linkt.com.au/.
AR_TELEPASE 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 Phí cầu đường tại Brazil. Xem thêm thông tin tại https://www.autoexpreso.com
BR_CONECTCAR Phí cầu đường tại Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com.
BR_MOVE_MAIS Phí cầu đường tại Brazil. Xem thêm thông tin chi tiết tại https://movemais.com.
BR_PASSA_RAPIDO Phí cầu đường tại Brazil. Xem thêm thông tin chi tiết tại https://pasorapido.gob.do/
BR_SEM_PARAR Phí cầu đường tại Brazil. Xem thêm thông tin tại https://www.semparar.com.br.
BR_TAGGY Phí cầu đường tại Brazil. Xem thêm thông tin chi tiết tại https://taggy.com.br.
BR_VELOE Phí cầu đường tại Brazil. Xem thêm chi tiết tại https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD biên giới giữa Canada và Hoa Kỳ.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD biên giới giữa Canada và Hoa Kỳ.
CA_US_BLUE_WATER_EDGE_PASS Cửa khẩu từ Ontario, Canada đến Michigan, Hoa Kỳ.
CA_US_CONNEXION Cửa khẩu từ Ontario, Canada đến Michigan, Hoa Kỳ.
CA_US_NEXUS_CARD biên giới giữa Canada và 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ụ: Ngân hàng 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 Miễn trừ biển số tiểu bang của Ấn Độ, HP.
JP_ETC Nhật Bản. 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 giảm giá nhiều hơn và khả năng giao tiếp hai chiều giữa thiết bị trên xe và ăng-ten trên đường. https://www.go-etc.jp/etc2/index.html
MX_IAVE Phí cầu đường Mexico. https://iave.capufe.gob.mx/#/
MX_PASE Mexico https://www.pase.com.mx
MX_QUICKPASS Mexico https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Mexico
MX_TAG_TELEVIA Công ty thu phí cầu đường Mexico. Một trong nhiều cơ sở lưu trú hoạt động tại Thành phố Mexico. Xem thêm thông tin chi tiết tại https://www.televia.com.mx.
MX_TELEVIA Công ty thu phí cầu đường Mexico. Một trong số nhiều cơ sở hoạt động tại Thành phố Mexico. https://www.televia.com.mx
MX_VIAPASS 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 AK, Hoa Kỳ.
US_CA_FASTRAK CA, Hoa Kỳ.
US_CA_FASTRAK_CAV_STICKER Cho biết người lái xe có thẻ FasTrak bất kỳ ngoài nhãn dán Xe 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 LA, Hoa Kỳ.
US_LA_TOLL_TAG LA, Hoa Kỳ.
US_MA_EZPASSMA MA, Hoa Kỳ.
US_MD_EZPASSMD MD, Hoa Kỳ.
US_ME_EZPASSME ME, 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é 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 NH, Hoa Kỳ.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Hoa Kỳ.
US_NJ_EZPASSNJ NJ, Hoa Kỳ.
US_NY_EXPRESSPASS NY, Hoa Kỳ.
US_NY_EZPASSNY NY, 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

Chỉ định các giả định cần sử dụng khi tính toán thời gian tham gia 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, có chứa thời gian dự đoán về lưu lượng truy cập dựa trên mức trung bình trước đây.

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

TransitAgency

Một công ty vận tải điều hành một tuyến 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 địa phương của công ty vận tải.

uri

string

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

TransitLine

Chứa thông tin về đường chuyển tuyến được dùng trong bước này.

Trường
agencies[]

TransitAgency

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

name

string

Tên đầy đủ của đường chuyển tuyến này, ví dụ: "8 Avenue Local".

uri

string

URI cho đường chuyển tuyến này do công ty vận tải cung cấp.

color

string

Màu thường dùng trong biển hiệu cho dòng này. Được biểu thị bằng hệ thập lục phân.

icon_uri

string

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

name_short

string

Tên ngắn của đường chuyển tuyến này. Tên này thường sẽ là một 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 hiệu cho dòng này. Được biểu thị bằng hệ thập lục phân.

vehicle

TransitVehicle

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

TransitPreferences

Các lựa chọn ưu tiên cho các tuyến 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 phương thức đi lại để sử dụng khi nhận tuyến đường TRANSIT. Giá trị mặc định là tất cả các phương thức di chuyển được hỗ trợ.

routing_preference

TransitRoutingPreference

Lựa chọn ưu tiên định tuyến mà khi được chỉ định, sẽ ảnh hưởng đến tuyến TRANSIT được trả về.

TransitRoutingPreference

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

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

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 Chưa chỉ định phương tiện đi lại bằng phương tiện công cộng.
BUS Đi bằng xe buýt.
SUBWAY Di chuyển bằng tàu điện ngầm.
TRAIN Di chuyển bằng tàu hoả.
LIGHT_RAIL Đi bằng tàu điện hoặc xe điện.
RAIL Du lịch bằng đường sắt. Điều này tương đương với việc sử dụng kết hợp SUBWAY, TRAINLIGHT_RAIL.

TransitStop

Thông tin về một trạm 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 điểm dừng được biểu thị bằng toạ độ vĩ độ/kinh độ.

TransitVehicle

Thông tin về xe dùng trên các tuyến đường dành cho phương tiện công cộng.

Trường
name

LocalizedText

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

type

TransitVehicleType

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

icon_uri

string

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

local_icon_uri

string

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

TransitVehicleType

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

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

Đơn vị

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

Enum
UNITS_UNSPECIFIED Đơn vị đo lường chưa được chỉ định. Giá trị mặc định là đơn vị đo lường suy ra từ yêu cầu.
METRIC Đơn vị đo lường hệ mét.
IMPERIAL Đơn vị đo lường hệ Anh (tiế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 Chưa xác định loại khí thải. Giá trị mặc định là GASOLINE.
GASOLINE Xe chạy bằng xăng/xăng.
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 động cơ diesel.

VehicleInfo

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

Trường
emission_type

VehicleEmissionType

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

Waypoint

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

Trường
via

bool

Đánh dấu điểm tham chiếu này là một mốc quan trọng thay vì điểm dừng. Đối với mỗi điểm tham chiếu không qua trong yêu cầu, phản hồi sẽ thêm một mục nhập vào mảng legs để cung cấp thông tin chi tiết về các điểm dừng 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 tham chiếu này mà không cần dừng lại. Các điểm tham chiếu không khiến mục nhập đượ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 tham chiếu là trung gian. Yêu cầu không thành công nếu bạn đặt trường này trên các điểm tham chiếu của thiết bị đầu cuối. Nếu bạn đặt ComputeRoutesRequest.optimize_waypoint_order thành true (đúng) thì không thể đặt trường này thành true; nếu không, yêu cầu sẽ không thành công.

vehicle_stopover

bool

Cho biết rằng điểm tham chiếu dành cho các phương tiện dừng lại khi bạn muốn nhận xe hoặc trả xe. Khi bạn đặt giá trị này, tuyến đường đã tính toán sẽ không bao gồm các điểm tham chiếu không thuộc via trên những con đường không phù hợp để đón và trả khách. Lựa chọn này chỉ áp dụng cho phương tiện đi lại DRIVETWO_WHEELER và khi location_typeLocation.

side_of_road

bool

Cho biết rằng vị trí của điểm tham chiếu này được dành cho xe cộ ưu tiê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í này để xe có thể dừng ở bên đường mà vị trí lệch về phía giữa đường. Tuỳ chọn này chỉ hoạt động với DRIVETWO_WHEELER RouteTravelMode.

Trường kết hợp location_type. Các cách khác nhau để thể hiện một vị trí. location_type chỉ có thể là một trong những trạng thái sau đây:
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 tham chiếu.

address

string

Địa chỉ mà con người có thể đọc được hoặc mã cộng. Xem https://plus.codes để biết chi tiết.