Chỉ mục
Routes
(giao diện)ComputeRouteMatrixRequest
(thông báo)ComputeRouteMatrixRequest.ExtraComputation
(enum)ComputeRoutesRequest
(thông báo)ComputeRoutesRequest.ExtraComputation
(enum)ComputeRoutesRequest.ReferenceRoute
(enum)ComputeRoutesResponse
(thông báo)FallbackInfo
(thông báo)FallbackReason
(enum)FallbackRoutingMode
(enum)GeocodedWaypoint
(thông báo)GeocodingResults
(thông báo)LocalizedTime
(thông báo)Location
(thông báo)Maneuver
(enum)NavigationInstruction
(thông báo)Polyline
(thông báo)PolylineEncoding
(enum)PolylineQuality
(enum)Route
(thông báo)Route.RouteLocalizedValues
(thông báo)RouteLabel
(enum)RouteLeg
(thông báo)RouteLeg.RouteLegLocalizedValues
(thông báo)RouteLeg.StepsOverview
(thông báo)RouteLeg.StepsOverview.MultiModalSegment
(thông báo)RouteLegStep
(thông báo)RouteLegStep.RouteLegStepLocalizedValues
(thông báo)RouteLegStepTransitDetails
(thông báo)RouteLegStepTransitDetails.TransitDetailsLocalizedValues
(thông báo)RouteLegStepTransitDetails.TransitStopDetails
(thông báo)RouteLegStepTravelAdvisory
(thông báo)RouteLegTravelAdvisory
(thông báo)RouteMatrixDestination
(thông báo)RouteMatrixElement
(thông báo)RouteMatrixElement.LocalizedValues
(thông báo)RouteMatrixElementCondition
(enum)RouteMatrixOrigin
(thông báo)RouteModifiers
(thông báo)RouteTravelAdvisory
(thông báo)RouteTravelMode
(enum)RoutingPreference
(enum)SpeedReadingInterval
(thông báo)SpeedReadingInterval.Speed
(enum)TollInfo
(thông báo)TollPass
(enum)TrafficModel
(enum)TransitAgency
(thông báo)TransitLine
(thông báo)TransitPreferences
(thông báo)TransitPreferences.TransitRoutingPreference
(enum)TransitPreferences.TransitTravelMode
(enum)TransitStop
(thông báo)TransitVehicle
(thông báo)TransitVehicle.TransitVehicleType
(enum)Units
(enum)VehicleEmissionType
(enum)VehicleInfo
(thông báo)Waypoint
(thông báo)
Tuyến đường
API Tuyến đường.
ComputeRouteMatrix |
---|
Lấy danh sách điểm gốc và điểm đến rồi trả về luồng chứa thông tin tuyến đường cho từng tổ hợp điểm gốc và điểm đến. LƯU Ý: Phương pháp này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ cho trường (field mask) bằng cách sử dụng tham số URL Ví dụ: trong phương thức này:
Điều quan trọng là bạn phải thêm
|
ComputeRoutes |
---|
Trả về tuyến chính cùng với các tuyến thay thế không bắt buộc, dựa trên một nhóm các điểm cuối và điểm tham chiếu trung gian. LƯU Ý: Phương pháp này yêu cầu bạn chỉ định mặt nạ trường phản hồi trong dữ liệu đầu vào. Bạn có thể cung cấp mặt nạ trường phản hồi bằng cách sử dụng tham số URL Ví dụ: trong phương thức này:
Google không khuyến khích việc sử dụng mặt nạ cho trường (field mask) của phản hồi ký tự đại diện (
|
ComputeRouteMatrixRequest
Thông báo yêu cầu ComputeRouteMatrix
Trường | |
---|---|
origins[] |
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:
|
destinations[] |
Bắt buộc. Mảng các đích đến xác định các cột của ma trận phản hồi. |
travel_mode |
Không bắt buộc. Chỉ định phương thức di chuyển. |
routing_preference |
Không bắt buộc. Chỉ định cách tính toán tuyến. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ quá dài, thì hệ thống sẽ trả về lỗi. Bạn chỉ có thể chỉ định tuỳ chọn này khi |
departure_time |
Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định theo thời gian bạn thực hiện yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định |
arrival_time |
Không bắt buộc. Thời gian đến. LƯU Ý: Chỉ có thể đặt khi |
language_code |
Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem phần Mã nhận dạng ngôn ngữ Unicode. Xem trang Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên. |
region_code |
Không bắt buộc. Mã vùng được chỉ định ở dạng ccTLD (miền cấp cao nhất) gồm 2 ký tự. Để biết thêm thông tin, hãy xem phần Miền cấp cao nhất của mã quốc gia. |
units |
Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị. |
extra_computations[] |
Không bắt buộc. Danh sách các phép tính bổ sung có thể dùng để hoàn tất yêu cầu. Lưu ý: Những phép tính bổ sung này có thể trả về các trường bổ sung trong câu trả lời. Các trường bổ sung này cũng phải được chỉ định trong mặt nạ trường (field mask) để được trả về trong phản hồi. |
traffic_model |
Không bắt buộc. Nêu các giả định cần sử dụng khi tính thời gian lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường thời lượng trong |
transit_preferences |
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 |
ExtraComputation
Các phép tính bổ sung cần thực hiện trong khi hoàn tất yêu cầu.
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công. |
TOLLS |
Thông tin cước phí cho(các) phần tử ma trận. |
ComputeRoutesRequest
Thông báo yêu cầu ComputeRoutes.
Trường | |
---|---|
origin |
Bắt buộc. Điểm tham chiếu gốc. |
destination |
Bắt buộc. Điểm tham chiếu đích. |
intermediates[] |
Không bắt buộc. Một tập hợp các điểm tham chiếu dọc theo tuyến đường (không bao gồm các điểm cuối), cho phép dừng hoặc đi qua. Hỗ trợ tối đa 25 điểm tham chiếu trung gian. |
travel_mode |
Không bắt buộc. Chỉ định phương thức di chuyển. |
routing_preference |
Không bắt buộc. Chỉ định cách tính toán tuyến. Máy chủ cố gắng sử dụng tuỳ chọn định tuyến đã chọn để tính toán tuyến. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ quá lâu, thì hệ thống sẽ trả về lỗi. Bạn chỉ có thể chỉ định tuỳ chọn này khi |
polyline_quality |
Không bắt buộc. Chỉ định tuỳ chọn của bạn về chất lượng của hình nhiều đường. |
polyline_encoding |
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 |
Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định theo thời gian bạn thực hiện yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định |
arrival_time |
Không bắt buộc. Thời gian đến. LƯU Ý: Chỉ có thể đặt khi |
compute_alternative_routes |
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 |
Không bắt buộc. Một tập hợp các điều kiện cần đáp ứng sẽ ảnh hưởng đến cách tính toán tuyến đường. |
language_code |
Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem phần Mã nhận dạng ngôn ngữ Unicode. Xem trang Hỗ trợ ngôn ngữ để biết danh sách các ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của yêu cầu định tuyến. |
region_code |
Không bắt buộc. Mã vùng được chỉ định ở dạng ccTLD (miền cấp cao nhất) gồm 2 ký tự. Để biết thêm thông tin, hãy xem phần Miền cấp cao nhất của mã quốc gia. |
units |
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 |
optimize_waypoint_order |
Không bắt buộc. Nếu bạn đặt chính sách này thành true (đúng), dịch vụ sẽ cố gắng giảm thiểu tổng chi phí của tuyến bằng cách sắp xếp lại thứ tự các điểm tham chiếu trung gian đã chỉ định. Yêu cầu sẽ không thành công nếu bất kỳ điểm tham chiếu trung gian nào là điểm tham chiếu |
requested_reference_routes[] |
Không bắt buộc. Chỉ định các tuyến tham chiếu cần tính toán trong yêu cầu ngoài tuyến mặc định. Tuyến tham chiếu là một tuyến có mục tiêu tính toán tuyến đường khác với tuyến mặc định. Ví dụ: cách tính toán tuyến tham chiếu |
extra_computations[] |
Không bắt buộc. Danh sách các phép tính bổ sung có thể dùng để hoàn tất yêu cầu. Lưu ý: Những phép tính bổ sung này có thể trả về các trường bổ sung trong câu trả lời. Các trường bổ sung này cũng phải được chỉ định trong mặt nạ trường (field mask) để được trả về trong phản hồi. |
traffic_model |
Không bắt buộc. Nêu các giả định cần sử dụng khi tính thời gian lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường thời lượng trong |
transit_preferences |
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 |
ExtraComputation
Các phép tính bổ sung cần thực hiện trong khi hoàn tất yêu cầu.
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công. |
TOLLS |
Thông tin về phí cầu đường cho(các) tuyến đường. |
FUEL_CONSUMPTION |
Mức tiêu thụ nhiên liệu ước tính cho(các) tuyến đường. |
TRAFFIC_ON_POLYLINE |
Hình nhiều đường nhận biết giao thông cho(các) tuyến đường. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions được trình bày dưới dạng một chuỗi văn bản HTML đã được định dạng. Nội dung này được dùng để đọc nguyên trạng. Nội dung này chỉ dành cho mục đích hiển thị. Đừng phân tích cú pháp cú pháp tìm kiếm theo trình tự. |
ReferenceRoute
Tuyến tham chiếu được hỗ trợ trên ComputeRoutesRequest.
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Không được sử dụng. Các yêu cầu chứa giá trị này sẽ không thành công. |
FUEL_EFFICIENT |
Tuyến đường tiết kiệm nhiên liệu. Những tuyến đường có gắn nhãn giá trị này được xác định là tối ưu hoá cho các tham số như mức tiêu thụ nhiên liệu. |
ComputeRoutesResponse
ComputeRoutes cho thông báo phản hồi.
Trường | |
---|---|
routes[] |
Chứa một mảng các tuyến được tính toán (tối đa 3) khi bạn chỉ định |
fallback_info |
Trong một số trường hợp khi không thể tính toán kết quả định tuyến với tất cả tuỳ chọn đầu vào, máy chủ có thể dự phòng sang sử dụng một cách tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt. |
geocoding_results |
Chứa thông tin phản hồi mã hoá địa lý cho các điểm tham chiếu được chỉ định dưới dạng địa chỉ. |
FallbackInfo
Thông tin liên quan đến cách thức và lý do sử dụng kết quả dự phòng. Nếu bạn đặt trường này thì có nghĩa là máy chủ đã sử dụng một chế độ định tuyến khác với chế độ ưu tiên của bạn làm chế độ dự phòng.
Trường | |
---|---|
routing_mode |
Chế độ định tuyến dùng cho phản hồi. Nếu tính năng dự phòng được kích hoạt, chế độ đó có thể khác với lựa chọn ưu tiên định tuyến được đặt trong yêu cầu ban đầu của ứng dụng. |
reason |
Lý do phản hồi dự phòng được sử dụng thay cho câu trả lời ban đầu. Trường này chỉ được điền khi chế độ dự phòng được kích hoạt và phản hồi dự phòng được trả về. |
FallbackReason
Lý do sử dụng tính năng phản hồi dự phòng.
Enum | |
---|---|
FALLBACK_REASON_UNSPECIFIED |
Chưa chỉ định lý do dự phòng. |
SERVER_ERROR |
Đã xảy ra lỗi máy chủ khi tính toán các tuyến đường với chế độ định tuyến ưa thích của bạn, nhưng chúng tôi đã có thể trả về một kết quả được tính bằng chế độ thay thế. |
LATENCY_EXCEEDED |
Chúng tôi không thể hoàn tất việc tính toán bằng chế độ định tuyến mà bạn ưu tiên đúng giờ, nhưng chúng tôi đã có thể trả về kết quả do chế độ thay thế tính toán. |
FallbackRoutingMode
Chế độ định tuyến thực tế dùng cho phản hồi dự phòng được trả về.
Enum | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
Không được sử dụng. |
FALLBACK_TRAFFIC_UNAWARE |
Cho biết TRAFFIC_UNAWARE được dùng để tính toán phản hồi. |
FALLBACK_TRAFFIC_AWARE |
Cho biết TRAFFIC_AWARE được dùng để tính toán phản hồi. |
GeocodedWaypoint
Thông tin chi tiết về vị trí được dùng làm điểm tham chiếu. Chỉ được điền cho điểm tham chiếu địa chỉ. Bao gồm thông tin chi tiết về kết quả mã hoá địa lý nhằm xác định địa chỉ được mã hoá địa lý đến.
Trường | |
---|---|
geocoder_status |
Cho biết mã trạng thái do thao tác mã hoá địa lý tạo ra. |
type[] |
(Các) loại kết quả, ở dạng 0 hoặc nhiều thẻ loại. Các loại được hỗ trợ: Loại địa chỉ và loại thành phần địa chỉ. |
partial_match |
Cho biết rằng bộ mã hoá địa lý không trả về kết quả khớp chính xác cho yêu cầu ban đầu, mặc dù bộ mã hoá có thể khớp với một phần địa chỉ được yêu cầu. Bạn có thể kiểm tra lỗi chính tả trong yêu cầu ban đầu và/hoặc địa chỉ chưa hoàn chỉnh. |
place_id |
Mã địa điểm cho kết quả này. |
intermediate_waypoint_request_index |
Chỉ mục của điểm tham chiếu trung gian tương ứng trong yêu cầu. Chỉ được điền nếu điểm tham chiếu tương ứng là điểm tham chiếu trung gian. |
GeocodingResults
Chứa
cho điểm gốc, điểm đến và điểm tham chiếu trung gian. Chỉ được điền cho điểm tham chiếu địa chỉ.GeocodedWaypoints
Trường | |
---|---|
origin |
Điểm tham chiếu được mã hoá địa lý tại nguồn gốc. |
destination |
Điểm tham chiếu được mã hoá địa lý cho đích đến. |
intermediates[] |
Danh sách các điểm tham chiếu được mã hoá địa lý trung gian, mỗi điểm chứa một trường chỉ mục tương ứng với vị trí dựa trên 0 của điểm tham chiếu theo thứ tự được chỉ định trong yêu cầu. |
LocalizedTime
Mô tả thời gian đã bản địa hoá.
Trường | |
---|---|
time |
Thời gian được chỉ định dưới dạng chuỗi theo múi giờ đã cho. |
time_zone |
Chứa múi giờ. Giá trị là tên của múi giờ như được xác định trong Cơ sở dữ liệu múi giờ IANA, ví dụ: "America/New_Israel". |
Vị trí
Đóng gói vị trí (điểm địa lý và tiêu đề không bắt buộc).
Trường | |
---|---|
lat_lng |
Toạ độ địa lý của điểm tham chiếu. |
heading |
Hướng la bàn được liên kết với hướng của luồng giao thông. Giá trị này chỉ định lề đường cho đón và trả xe. Giá trị tiêu đề có thể từ 0 đến 360, trong đó 0 chỉ định tiêu đề của phía Bắc, 90 chỉ định tiêu đề của phía Đông, v.v. Bạn chỉ có thể sử dụng trường này cho |
Điều khiển
Tập hợp các giá trị chỉ định thao tác điều hướng cần thực hiện cho bước hiện tại (ví dụ: rẽ trái, hợp nhất hoặc đi thẳng).
Enum | |
---|---|
MANEUVER_UNSPECIFIED |
Không được sử dụng. |
TURN_SLIGHT_LEFT |
Xoay một chút sang trái. |
TURN_SHARP_LEFT |
Xoay mạnh sang trái. |
UTURN_LEFT |
Vòng ngược lại. |
TURN_LEFT |
Quay sang trái. |
TURN_SLIGHT_RIGHT |
Xoay một chút sang phải. |
TURN_SHARP_RIGHT |
Xoay mạnh sang phải. |
UTURN_RIGHT |
Vòng ngược lại. |
TURN_RIGHT |
Hãy rẽ phải. |
STRAIGHT |
Đi thẳng. |
RAMP_LEFT |
Đi theo đoạn đường nối bên trái. |
RAMP_RIGHT |
Đi vào đoạn đường nối bên phải. |
MERGE |
Hợp nhất vào giao thông. |
FORK_LEFT |
Đi theo ngã ba bên trái. |
FORK_RIGHT |
Đi theo ngã ba bên phải. |
FERRY |
Đi phà. |
FERRY_TRAIN |
Đi vào chuyến tàu dẫn lên phà. |
ROUNDABOUT_LEFT |
Rẽ trái tại chỗ đường vòng. |
ROUNDABOUT_RIGHT |
rẽ phải tại chỗ đường vòng. |
DEPART |
Thao tác ban đầu. |
NAME_CHANGE |
Được dùng để biểu thị việc thay đổi tên đường. |
Hình nhiều đường
Đóng gói một hình nhiều đường được mã hoá.
Trường | |
---|---|
Trường hợp polyline_type . Đóng gói loại hình nhiều đường. Giá trị mặc định là encrypted_polyline. polyline_type chỉ có thể là một trong những trạng thái sau: |
|
encoded_polyline |
Mã hoá chuỗi cho hình nhiều đường bằng thuật toán mã hoá nhiều đường |
geo_json_linestring |
Chỉ định một hình nhiều đường bằng cách sử dụng định dạng GeoJSON LineString. |
PolylineEncoding
Chỉ định loại hình nhiều đường ưu tiên sẽ được trả về.
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Chưa chỉ định tùy chọn loại nhiều đường. Giá trị mặc định là ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Chỉ định một hình nhiều dòng được mã hoá bằng thuật toán mã hoá nhiều dòng. |
GEO_JSON_LINESTRING |
Chỉ định một hình nhiều đường bằng cách sử dụng định dạng GeoJSON LineString |
PolylineQuality
Một tập hợp các giá trị chỉ định chất lượng của hình nhiều đường.
Enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Chưa chỉ định lựa chọn chất lượng nhiều đường. Giá trị mặc định là OVERVIEW . |
HIGH_QUALITY |
Chỉ định một hình nhiều đường chất lượng cao – được kết hợp bằng cách sử dụng nhiều điểm hơn OVERVIEW nhưng kích thước phản hồi sẽ tăng. Hãy sử dụng giá trị này khi bạn cần độ chính xác cao hơn. |
OVERVIEW |
Chỉ định một hình nhiều đường tổng quan – được kết hợp bằng một số ít điểm. Sử dụng giá trị này khi hiển thị thông tin tổng quan về tuyến đường. Việc sử dụng lựa chọn này có độ trễ yêu cầu thấp hơn so với việc sử dụng lựa chọn HIGH_QUALITY . |
Tuyến đường
Chứa một tuyến đường bao gồm một loạt các đoạn đường được kết nối với nhau nối với điểm đầu, điểm cuối và điểm trung gian.
Trường | |
---|---|
route_labels[] |
Các nhãn cho |
legs[] |
Một tập hợp các chân (đoạn đường dẫn giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai chặng không phải là |
distance_meters |
Khoảng cách đi lại của tuyến đường, tính bằng mét. |
duration |
Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập |
static_duration |
Thời gian di chuyển qua tuyến đường mà không tính đến tình trạng giao thông. |
polyline |
Hình nhiều đường chung của tuyến đường. Hình nhiều đường này là hình nhiều đường kết hợp của tất cả |
description |
Nội dung mô tả về tuyến đường. |
warnings[] |
Một mảng các cảnh báo sẽ xuất hiện khi cho thấy tuyến đường. |
viewport |
Hộp giới hạn khung nhìn của hình nhiều đường. |
travel_advisory |
Thông tin bổ sung về tuyến đường. |
optimized_intermediate_waypoint_index[] |
Nếu bạn đặt |
localized_values |
Văn bản đại diện cho các thuộc tính của |
route_token |
Mã thông báo tuyến đường được mã hoá base64 an toàn trên web, có thể được truyền đến SDK điều hướng, cho phép SDK điều hướng tạo lại tuyến đường trong khi điều hướng và trong trường hợp định tuyến lại, hãy thực hiện ý định ban đầu khi bạn tạo tuyến đường bằng cách gọi ComputeRoutes. Khách hàng nên coi mã thông báo này là một blob mờ. Tệp này không nhằm mục đích đọc hoặc thay đổi. LƯU Ý: |
RouteLocalizedValues
Phần văn bản đại diện cho một số thuộc tính nhất định.
Trường | |
---|---|
distance |
Quãng đường đi được thể hiện dưới dạng văn bản. |
duration |
Thời lượng có tính đến điều kiện giao thông, được thể hiện dưới dạng văn bản. Lưu ý: Nếu bạn không yêu cầu thông tin lưu lượng truy cập, thì giá trị này sẽ bằng với |
static_duration |
Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản. |
transit_fare |
Giá vé phương tiện công cộng được thể hiện ở dạng văn bản. |
RouteLabel
Các nhãn cho
rất hữu ích trong việc xác định các thuộc tính cụ thể của tuyến đường để so sánh với các tuyến khác.Route
Enum | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Mặc định – không được sử dụng. |
DEFAULT_ROUTE |
Tuyến "tốt nhất" mặc định được trả về để tính toán tuyến đường. |
DEFAULT_ROUTE_ALTERNATE |
Lựa chọn thay thế cho tuyến "tốt nhất" mặc định. Các tuyến như thế này sẽ được trả về khi bạn chỉ định . |
FUEL_EFFICIENT |
Tuyến đường tiết kiệm nhiên liệu. Những tuyến đường có gắn nhãn giá trị này được xác định là tối ưu hoá theo tham số Tiết kiệm nhiên liệu, chẳng hạn như mức tiêu thụ nhiên liệu. |
RouteLeg
Chứa một phân đoạn giữa các điểm tham chiếu không phải là via
.
Trường | |
---|---|
distance_meters |
Khoảng cách di chuyển của chặng tuyến đường, tính bằng mét. |
duration |
Khoảng thời gian cần thiết để di chuyển chân. Nếu bạn đặt |
static_duration |
Thời gian di chuyển qua chân, được tính toán mà không tính đến tình trạng giao thông. |
polyline |
Hình nhiều đường chung cho chân này bao gồm hình nhiều đường của mỗi |
start_location |
Vị trí bắt đầu của chân này. Vị trí này có thể khác với |
end_location |
Vị trí kết thúc của chân này. Vị trí này có thể khác với |
steps[] |
Một mảng các bước biểu thị các phân đoạn trong chân này. Mỗi bước đại diện cho một hướng dẫn di chuyển. |
travel_advisory |
Chứa thông tin bổ sung mà người dùng phải được thông báo, chẳng hạn như các khu vực hạn chế giao thông có thể xảy ra ở một chặng của tuyến đường. |
localized_values |
Văn bản đại diện cho các thuộc tính của |
steps_overview |
Thông tin tổng quan về các bước trong |
RouteLegLocalizedValues
Phần văn bản đại diện cho một số thuộc tính nhất định.
Trường | |
---|---|
distance |
Quãng đường đi được thể hiện dưới dạng văn bản. |
duration |
Thời lượng có tính đến điều kiện giao thông, được thể hiện dưới dạng văn bản. Lưu ý: Nếu bạn không yêu cầu thông tin lưu lượng truy cập, giá trị này sẽ giống với giá trị với static_duration. |
static_duration |
Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản. |
StepsOverview
Cung cấp thông tin tổng quan về danh sách RouteLegStep
.
Trường | |
---|---|
multi_modal_segments[] |
Thông tin tóm tắt về các phân đoạn đa phương thức khác nhau của |
MultiModalSegment
Cung cấp thông tin tóm tắt về các phân đoạn đa phương thức khác nhau của RouteLeg.steps
. Phân đoạn đa phương thức được định nghĩa là một hoặc nhiều RouteLegStep
liền kề có cùng RouteTravelMode
. Trường này sẽ không được điền nếu RouteLeg
không chứa phân đoạn đa phương thức trong các bước.
Trường | |
---|---|
navigation_instruction |
NavigationIn hướng dẫn cho phân đoạn đa phương thức. |
travel_mode |
Phương thức đi lại của đoạn đa phương thức. |
step_start_index |
Chỉ mục |
step_end_index |
Chỉ mục |
RouteLegStep
Chứa một phân đoạn của
. Mỗi bước tương ứng với một hướng dẫn điều hướng. Các chân tuyến đường được tạo thành từ các bước.RouteLeg
Trường | |
---|---|
distance_meters |
Khoảng cách di chuyển của bước này (tính bằng mét). Trong một số trường hợp, trường này có thể không có giá trị. |
static_duration |
Thời gian di chuyển qua bước này mà không tính đến tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị. |
polyline |
Hình nhiều đường liên kết với bước này. |
start_location |
Vị trí bắt đầu của bước này. |
end_location |
Vị trí kết thúc của bước này. |
navigation_instruction |
Hướng dẫn di chuyển. |
travel_advisory |
Chứa thông tin bổ sung mà người dùng cần được thông báo (chẳng hạn như các quy định hạn chế về vùng giao thông có thể xảy ra) ở bước chân. |
localized_values |
Văn bản đại diện cho các thuộc tính của |
transit_details |
Thông tin chi tiết liên quan đến bước này nếu phương tiện đi lại là |
travel_mode |
Phương tiện đi lại dùng cho bước này. |
RouteLegStepLocalizedValues
Phần văn bản đại diện cho một số thuộc tính nhất định.
Trường | |
---|---|
distance |
Quãng đường đi được thể hiện dưới dạng văn bản. |
static_duration |
Thời lượng không tính đến điều kiện giao thông, được thể hiện ở dạng văn bản. |
RouteLegStepTransitDetails
Thông tin bổ sung về RouteLegStep
liên quan đến các tuyến TRANSIT
.
Trường | |
---|---|
stop_details |
Thông tin về điểm dừng đến và đi cho bước này. |
localized_values |
Văn bản đại diện cho các thuộc tính của |
headsign |
Xác định hướng di chuyển trên tuyến đường này (được đánh dấu trên xe hoặc tại điểm khởi hành). Hướng thường là ga cuối. |
headway |
Chỉ định thời gian dự kiến là khoảng thời gian giữa các chuyến khởi hành từ cùng một điểm dừng tại thời điểm này. Ví dụ: với giá trị số giây phía trước là 600, bạn sẽ phải chờ 10 phút nếu lỡ xe buýt. |
transit_line |
Thông tin về đường chuyển tuyến được sử dụng trong bước này. |
stop_count |
Số điểm dừng từ điểm khởi hành đến điểm dừng đến. Con số này bao gồm điểm dừng đến, nhưng không bao gồm điểm khởi hành. Ví dụ: nếu tuyến đường của bạn khởi hành từ Trạm dừng A, đi qua điểm dừng B và C, và đến điểm dừng D, thì trạm dừng D sẽ trả về 3. |
trip_short_text |
Văn bản xuất hiện trong lịch trình và biển hiệu để xác định chuyến đi bằng phương tiện công cộng của hành khách. Văn bản này phải xác định duy nhất một chuyến đi trong một ngày sử dụng dịch vụ. Ví dụ: "538" là |
TransitDetailsLocalizedValues
Mô tả giá trị đã bản địa hoá cho RouteTransitDetails
.
Trường | |
---|---|
arrival_time |
Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng. |
departure_time |
Thời gian ở dạng văn bản biểu diễn với múi giờ tương ứng. |
TransitStopDetails
Thông tin chi tiết về điểm dừng phương tiện công cộng cho RouteLegStep
.
Trường | |
---|---|
arrival_stop |
Thông tin về điểm dừng đến cho bước này. |
arrival_time |
Thời gian đến dự kiến cho bước này. |
departure_stop |
Thông tin về điểm dừng khởi hành cho bước này. |
departure_time |
Thời gian khởi hành dự kiến cho bước này. |
RouteLegStepTravelAdvisory
Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các hạn chế về vùng giao thông có thể xảy ra đối với bước chân.
Trường | |
---|---|
speed_reading_intervals[] |
LƯU Ý: Trường này hiện chưa được điền. |
RouteLegTravelAdvisory
Chứa thông tin bổ sung mà người dùng sẽ được thông báo về bước chân, chẳng hạn như các quy định hạn chế về khu vực giao thông có thể xảy ra.
Trường | |
---|---|
toll_info |
Chứa thông tin về việc thu phí cầu đường cụ thể trên |
speed_reading_intervals[] |
Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn định tuyến ưu tiên của Ví dụ:
|
RouteMatrixDestination
Một đích đến duy nhất cho ComputeRouteMatrixRequest
Trường | |
---|---|
waypoint |
Bắt buộc. Điểm tham chiếu đích |
RouteMatrixElement
Chứa thông tin tuyến đường được tính toán cho cặp nguồn gốc/đích đến trong API ComputeRouteMatrix. Proto này có thể được truyền trực tuyến đến ứng dụng khách.
Trường | |
---|---|
status |
Mã trạng thái lỗi của phần tử này. |
condition |
Cho biết liệu tuyến đường có được tìm thấy hay không. Không phụ thuộc vào trạng thái. |
distance_meters |
Khoảng cách đi lại của tuyến đường, tính bằng mét. |
duration |
Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn thiết lập |
static_duration |
Thời gian di chuyển qua tuyến đường mà không tính đến tình trạng giao thông. |
travel_advisory |
Thông tin bổ sung về tuyến đường. Ví dụ: thông tin về quy định hạn chế và thông tin về phí cầu đường |
fallback_info |
Trong một số trường hợp khi không thể tính toán tuyến với các tuỳ chọn đã cho cho cặp điểm gốc/đích cụ thể này, máy chủ có thể quay lại sử dụng chế độ tính toán khác. Khi sử dụng chế độ dự phòng, trường này chứa thông tin chi tiết về phản hồi dự phòng. Nếu không, trường này sẽ không được đặt. |
localized_values |
Văn bản đại diện cho các thuộc tính của |
origin_index |
Chỉ mục gốc 0 của nguồn gốc trong yêu cầu. |
destination_index |
Chỉ mục dựa trên 0 của đích đến trong yêu cầu. |
LocalizedValues
Phần văn bản đại diện cho một số thuộc tính nhất định.
Trường | |
---|---|
distance |
Quãng đường đi được thể hiện dưới dạng văn bản. |
duration |
Thời lượng được biểu thị ở dạng văn bản có tính đến điều kiện giao thông. Lưu ý: Nếu hệ thống không yêu cầu thông tin lưu lượng truy cập, thì giá trị này giống với static_duration. |
static_duration |
Thời lượng được biểu thị dưới dạng văn bản mà không tính đến điều kiện giao thông. |
transit_fare |
Giá vé phương tiện công cộng được thể hiện ở dạng văn bản. |
RouteMatrixElementCondition
Tình trạng của tuyến được trả về.
Enum | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
Chỉ được dùng khi status của phần tử không ổn. |
ROUTE_EXISTS |
Đã tìm thấy một tuyến và thông tin tương ứng đã được điền cho phần tử. |
ROUTE_NOT_FOUND |
Không tìm thấy tuyến đường nào. Các trường có chứa thông tin tuyến đường, chẳng hạn như distance_meters hoặc duration , sẽ không được điền trong phần tử. |
RouteMatrixOrigin
Một nguồn gốc duy nhất cho ComputeRouteMatrixRequest
Trường | |
---|---|
waypoint |
Bắt buộc. Điểm tham chiếu gốc |
route_modifiers |
Không bắt buộc. Đối tượng sửa đổi cho mọi tuyến đường lấy giá trị này làm điểm gốc |
RouteModifiers
Đóng gói một tập hợp các điều kiện không bắt buộc để đáp ứng khi tính toán tuyến đường.
Trường | |
---|---|
avoid_tolls |
Khi bạn đặt chính sách này thành true (đúng), hãy tránh các đường có thu phí ở mức hợp lý, ưu tiên các tuyến đường không chứa đường có thu phí. Chỉ áp dụng cho |
avoid_highways |
Khi đặt thành đúng, hãy tránh đường cao tốc khi hợp lý, ưu tiên các tuyến đường không chứa đường cao tốc. Chỉ áp dụng cho |
avoid_ferries |
Khi bạn đặt thành true, sẽ tránh phà khi hợp lý, ưu tiên các tuyến đường không chứa phà. Chỉ áp dụng cho |
avoid_indoor |
Khi bạn đặt chính sách này thành true (đúng), hãy tránh điều hướng trong nhà ở vị trí hợp lý, ưu tiên các tuyến đường không chứa tính năng chỉ đường trong nhà. Chỉ áp dụng cho |
vehicle_info |
Chỉ định thông tin về xe. |
toll_passes[] |
Đóng gói thông tin về phí cầu đường. Nếu có cung cấp phí cầu đường, API sẽ cố gắng trả về giá vé. Nếu phí cầu đường không được cung cấp, API sẽ coi phí cầu đường là không xác định và cố gắng trả lại giá tiền mặt. Chỉ áp dụng cho |
RouteTravelAdvisory
Chứa thông tin bổ sung mà người dùng phải được biết, chẳng hạn như các hạn chế về khu vực giao thông có thể xảy ra.
Trường | |
---|---|
toll_info |
Chứa thông tin về phí cầu đường trên tuyến đường. Trường này chỉ được điền nếu phí lưu thông dự kiến trên tuyến đường. Nếu bạn đặt trường này nhưng trường phụ |
speed_reading_intervals[] |
Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp lựa chọn định tuyến ưu tiên của Ví dụ:
|
fuel_consumption_microliters |
Mức tiêu thụ nhiên liệu dự đoán tính bằng microlit. |
route_restrictions_partially_ignored |
Tuyến đường trả về có thể có những hạn chế không phù hợp cho phương tiện đi lại được yêu cầu hoặc đối tượng sửa đổi tuyến đường. |
transit_fare |
Nếu có, hãy chứa tổng giá vé hoặc phí vé của chặng bay này. Cơ sở lưu trú này chỉ được trả về cho các yêu cầu |
RouteTravelMode
Tập hợp các giá trị dùng để chỉ định phương tiện đi lại. LƯU Ý: Các tuyến đường WALK
, BICYCLE
và TWO_WHEELER
đang trong giai đoạn beta và đôi khi có thể thiếu các vỉa hè rõ ràng, đường dành cho người đi bộ hoặc đường dành cho xe đạp. Bạn phải cho người dùng thấy cảnh báo này trên mọi tuyến đường đi bộ, đi xe đạp và đi xe hai bánh mà bạn hiển thị trong ứng dụng của mình.
Enum | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
Chưa chỉ định phương tiện đi lại. Giá trị mặc định là DRIVE . |
DRIVE |
Đi bằng xe ô tô. |
BICYCLE |
Đi bằng xe đạp. |
WALK |
Di chuyển bằng cách đi bộ. |
TWO_WHEELER |
Xe có động cơ hai bánh. Ví dụ: xe mô tô. Xin lưu ý rằng chế độ này khác với chế độ đi lại BICYCLE vốn áp dụng chế độ sử dụng năng lượng của con người. |
TRANSIT |
Di chuyển bằng các tuyến phương tiện công cộng (nếu có). |
RoutingPreference
Một tập hợp giá trị chỉ định các yếu tố cần xem xét khi tính toán tuyến đường.
Enum | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
Chưa chỉ định tùy chọn định tuyến. Mặc định là TRAFFIC_UNAWARE . |
TRAFFIC_UNAWARE |
Tính toán các tuyến đường mà không tính đến tình trạng giao thông trực tiếp. Phù hợp khi điều kiện giao thông không quan trọng hoặc không phù hợp. Việc sử dụng giá trị này sẽ tạo ra độ trễ thấp nhất. Lưu ý: Đối với DRIVE và TWO_WHEELER , tuyến đường và thời lượng được chọn sẽ dựa trên mạng lưới đường và tình trạng giao thông không phụ thuộc vào thời gian trung bình, chứ không phải tình trạng đường hiện tại. Do đó, tuyến đường có thể bao gồm cả những con đường tạm thời bị đóng. Kết quả cho một yêu cầu nhất định có thể thay đổi theo thời gian do những thay đổi về mạng lưới đường, tình trạng giao thông trung bình được cập nhật và tính chất phân bố của dịch vụ. Kết quả cũng có thể khác nhau giữa các tuyến gần tương đương với nhau tại bất kỳ thời điểm hoặc tần suất nào. |
TRAFFIC_AWARE |
Tính toán các tuyến đường có tính đến tình trạng giao thông trực tiếp. Trái ngược với TRAFFIC_AWARE_OPTIMAL , một số tính năng tối ưu hoá được áp dụng để giảm đáng kể độ trễ. |
TRAFFIC_AWARE_OPTIMAL |
Tính toán các tuyến đường có xem xét tình trạng giao thông trực tiếp mà không áp dụng hầu hết các chế độ tối ưu hoá hiệu suất. Việc sử dụng giá trị này sẽ tạo ra độ trễ cao nhất. |
SpeedReadingInterval
Chỉ báo mật độ lưu lượng truy cập trên một đoạn liền kề của một hình nhiều đường hoặc đường dẫn. Cho sẵn một đường dẫn có các điểm P_0, P_1, ... , P_N (chỉ mục dựa trên 0), SpeedReadingInterval
xác định một khoảng thời gian và mô tả lưu lượng truy cập của nó bằng các danh mục sau.
Trường | |
---|---|
start_polyline_point_index |
Chỉ số bắt đầu của khoảng thời gian này trong hình nhiều đường. |
end_polyline_point_index |
Chỉ số kết thúc của khoảng thời gian này trong hình nhiều đường. |
Trường hợp
|
|
speed |
Tốc độ lưu lượng truy cập trong khoảng thời gian này. |
Tốc độ
Phân loại tốc độ hình nhiều đường dựa trên dữ liệu giao thông.
Enum | |
---|---|
SPEED_UNSPECIFIED |
Giá trị mặc định. Giá trị này không được sử dụng. |
NORMAL |
Tốc độ bình thường, không phát hiện thấy va chạm. |
SLOW |
Đã phát hiện thấy ùn tắc, nhưng không có kẹt xe nào hình thành. |
TRAFFIC_JAM |
Đã phát hiện thấy kẹt xe. |
TollInfo
Đóng gói thông tin phí cầu đường trên
hoặc trên Route
.RouteLeg
Trường | |
---|---|
estimated_price[] |
Số tiền phí cầu đường cho |
TollPass
Danh sách các thẻ thu phí cầu đường trên toàn thế giới mà chúng tôi hỗ trợ.
Enum | |
---|---|
TOLL_PASS_UNSPECIFIED |
Không được sử dụng. Nếu giá trị này được sử dụng, thì yêu cầu sẽ không thành công. |
AU_ETOLL_TAG |
Phí cầu đường Sydney. Xem thêm thông tin chi tiết tại https://www.myetoll.com.au. |
AU_EWAY_TAG |
Phí cầu đường Sydney. Xem thêm thông tin tại https://www.tollpay.com.au. |
AU_LINKT |
Phí cầu đường toàn nước Úc. Xem thêm thông tin chi tiết tại https://www.linkt.com.au/. |
AR_TELEPASE |
Phí cầu đường Argentina. Xem thêm thông tin chi tiết tại https://telepase.com.ar |
BR_AUTO_EXPRESO |
Phí cầu đường Brazil. Xem thêm thông tin chi tiết tại https://www.autoexpreso.com |
BR_CONECTCAR |
Phí cầu đường Brazil. Xem thêm thông tin chi tiết tại https://conectcar.com. |
BR_MOVE_MAIS |
Phí cầu đường Brazil. Xem thêm thông tin chi tiết tại https://movemais.com. |
BR_PASSA_RAPIDO |
Phí cầu đường Brazil. Xem thêm thông tin chi tiết tại https://pasorapido.gob.do/ |
BR_SEM_PARAR |
Phí cầu đường Brazil. Xem thêm thông tin chi tiết tại https://www.semparar.com.br. |
BR_TAGGY |
Phí cầu đường Brazil. Xem thêm thông tin chi tiết tại https://taggy.com.br. |
BR_VELOE |
Phí cầu đường Brazil. Xem thêm thông tin chi tiết tại https://veloe.com.br/site/onde-usar. |
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD |
Canada đến cửa khẩu biên giới Hoa Kỳ. |
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD |
Canada đến cửa khẩu biên giới Hoa Kỳ. |
CA_US_BLUE_WATER_EDGE_PASS |
Ontario, Canada đến đường biên giới giữa Hoa Kỳ và Michigan. |
CA_US_CONNEXION |
Ontario, Canada đến đường biên giới giữa Hoa Kỳ và Michigan. |
CA_US_NEXUS_CARD |
Canada đến cửa khẩu biên giới Hoa Kỳ. |
ID_E_TOLL |
Indonesia. Thẻ điện tử do nhiều ngân hàng cung cấp dùng để thanh toán phí cầu đường. Tất cả thẻ điện tử qua ngân hàng đều được tính phí như nhau nên chỉ cần một giá trị enum. Ví dụ: Bank Mandiri https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/id-id/ebanking/tapcash |
IN_FASTAG |
India. |
IN_LOCAL_HP_PLATE_EXEMPT |
Ấn Độ, miễn trừ biển số xe của tiểu bang HP. |
JP_ETC |
Nhật Bản ETC. Hệ thống không dây điện tử thu phí cầu đường. https://www.go-etc.jp/ |
JP_ETC2 |
Nhật Bản ETC2.0. Phiên bản mới của ETC có thêm chiết khấu và hỗ trợ giao tiếp hai chiều giữa các thiết bị trên xe và ăng-ten trên đường. https://www.go-etc.jp/etc2/index.html |
MX_IAVE |
Phí cầu đường Mexico. https://iave.capufe.gob.mx/#/ |
MX_PASE |
Mexico https://www.pase.com.mx |
MX_QUICKPASS |
Mexico https://operadoravial.com/quick-pass/ |
MX_SISTEMA_TELEPEAJE_CHIHUAHUA |
http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf |
MX_TAG_IAVE |
Mexico |
MX_TAG_TELEVIA |
Công ty thu phí cầu đường tại Mexico. Một trong số đó đang hoạt động tại thành phố Mexico. Xem thêm thông tin chi tiết tại https://www.televia.com.mx. |
MX_TELEVIA |
Công ty thu phí cầu đường tại Mexico. Một trong nhiều công ty hoạt động ở Thành phố Mexico. https://www.televia.com.mx |
MX_VIAPASS |
Phí cầu đường Mexico. Xem thêm thông tin chi tiết tại https://www.viapass.com.mx/viapass/web_home.aspx. |
US_AL_FREEDOM_PASS |
AL, Hoa Kỳ. |
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS |
AK, Hoa Kỳ. |
US_CA_FASTRAK |
CA, Hoa Kỳ. |
US_CA_FASTRAK_CAV_STICKER |
Cho biết rằng tài xế có thẻ FasTrak bất kỳ ngoài hình dán Xe khí sạch (CAV) do DMV cấp. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml |
US_CO_EXPRESSTOLL |
CO, Hoa Kỳ. |
US_CO_GO_PASS |
CO, Hoa Kỳ. |
US_DE_EZPASSDE |
Đức, Hoa Kỳ. |
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS |
FL, Hoa Kỳ. |
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD |
FL, Hoa Kỳ. |
US_FL_EPASS |
FL, Hoa Kỳ. |
US_FL_GIBA_TOLL_PASS |
FL, Hoa Kỳ. |
US_FL_LEEWAY |
FL, Hoa Kỳ. |
US_FL_SUNPASS |
FL, Hoa Kỳ. |
US_FL_SUNPASS_PRO |
FL, Hoa Kỳ. |
US_IL_EZPASSIL |
IL, Hoa Kỳ. |
US_IL_IPASS |
IL, Hoa Kỳ. |
US_IN_EZPASSIN |
Ấn Độ, Hoa Kỳ. |
US_KS_BESTPASS_HORIZON |
KS, Hoa Kỳ. |
US_KS_KTAG |
KS, Hoa Kỳ. |
US_KS_NATIONALPASS |
KS, Hoa Kỳ. |
US_KS_PREPASS_ELITEPASS |
KS, Hoa Kỳ. |
US_KY_RIVERLINK |
KY, Hoa Kỳ. |
US_LA_GEAUXPASS |
LA, Hoa Kỳ. |
US_LA_TOLL_TAG |
LA, Hoa Kỳ. |
US_MA_EZPASSMA |
MA, Hoa Kỳ. |
US_MD_EZPASSMD |
MD, Hoa Kỳ. |
US_ME_EZPASSME |
Tôi, Hoa Kỳ. |
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD |
MI, Hoa Kỳ. |
US_MI_BCPASS |
MI, Hoa Kỳ. |
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG |
MI, Hoa Kỳ. |
US_MI_IQ_PROX_CARD |
MI, Hoa Kỳ. Không dùng nữa vì loại thẻ và vé này không còn tồn tại. |
US_MI_IQ_TAG |
MI, Hoa Kỳ. |
US_MI_MACKINAC_BRIDGE_MAC_PASS |
MI, Hoa Kỳ. |
US_MI_NEXPRESS_TOLL |
MI, Hoa Kỳ. |
US_MN_EZPASSMN |
MN, Hoa Kỳ. |
US_NC_EZPASSNC |
NC, Hoa Kỳ. |
US_NC_PEACH_PASS |
NC, Hoa Kỳ. |
US_NC_QUICK_PASS |
NC, Hoa Kỳ. |
US_NH_EZPASSNH |
NH, Hoa Kỳ. |
US_NJ_DOWNBEACH_EXPRESS_PASS |
NJ, Hoa Kỳ. |
US_NJ_EZPASSNJ |
NJ, Hoa Kỳ. |
US_NY_EXPRESSPASS |
New York, Hoa Kỳ. |
US_NY_EZPASSNY |
New York, Hoa Kỳ. |
US_OH_EZPASSOH |
OH, Hoa Kỳ. |
US_PA_EZPASSPA |
PA, Hoa Kỳ. |
US_RI_EZPASSRI |
RI, Hoa Kỳ. |
US_SC_PALPASS |
SC, Hoa Kỳ. |
US_TX_AVI_TAG |
TX, Hoa Kỳ. |
US_TX_BANCPASS |
TX, Hoa Kỳ. |
US_TX_DEL_RIO_PASS |
TX, Hoa Kỳ. |
US_TX_EFAST_PASS |
TX, Hoa Kỳ. |
US_TX_EAGLE_PASS_EXPRESS_CARD |
TX, Hoa Kỳ. |
US_TX_EPTOLL |
TX, Hoa Kỳ. |
US_TX_EZ_CROSS |
TX, Hoa Kỳ. |
US_TX_EZTAG |
TX, Hoa Kỳ. |
US_TX_FUEGO_TAG |
TX, Hoa Kỳ. |
US_TX_LAREDO_TRADE_TAG |
TX, Hoa Kỳ. |
US_TX_PLUSPASS |
TX, Hoa Kỳ. |
US_TX_TOLLTAG |
TX, Hoa Kỳ. |
US_TX_TXTAG |
TX, Hoa Kỳ. |
US_TX_XPRESS_CARD |
TX, Hoa Kỳ. |
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD |
UT, Hoa Kỳ. |
US_VA_EZPASSVA |
VA, Hoa Kỳ. |
US_WA_BREEZEBY |
WA, Hoa Kỳ. |
US_WA_GOOD_TO_GO |
WA, Hoa Kỳ. |
US_WV_EZPASSWV |
WV, Hoa Kỳ. |
US_WV_MEMORIAL_BRIDGE_TICKETS |
WV, Hoa Kỳ. |
US_WV_MOV_PASS |
WV, Hoa Kỳ |
US_WV_NEWELL_TOLL_BRIDGE_TICKET |
WV, Hoa Kỳ. |
TrafficModel
Nêu các giả định cần sử dụng khi tính thời gian lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường duration
trong phản hồi, chứa thời gian dự đoán trong lưu lượng truy cập dựa trên mức trung bình trước đây.
Enum | |
---|---|
TRAFFIC_MODEL_UNSPECIFIED |
Không sử dụng. Nếu được chỉ định, giá trị mặc định sẽ là BEST_GUESS . |
BEST_GUESS |
Cho biết rằng duration được trả về phải là thời gian di chuyển ước tính chính xác nhất, dựa trên những gì đã biết về cả tình trạng giao thông trước đây và giao thông trực tiếp. Giao thông trực tiếp càng quan trọng hơn khi gần đến thời điểm departure_time hơn. |
PESSIMISTIC |
Cho biết rằng thời gian được trả về phải dài hơn thời gian di chuyển thực tế trong hầu hết các ngày, mặc dù thỉnh thoảng những ngày có điều kiện giao thông đặc biệt xấu có thể vượt quá giá trị này. |
OPTIMISTIC |
Cho biết rằng thời gian trả về phải ngắn hơn thời gian di chuyển thực tế trong hầu hết các ngày, mặc dù thỉnh thoảng những ngày có điều kiện giao thông đặc biệt tốt có thể nhanh hơn giá trị này. |
TransitAgency
Công ty vận tải điều hành đường chuyển tuyến.
Trường | |
---|---|
name |
Tên của công ty vận tải này. |
phone_number |
Số điện thoại có định dạng dành riêng cho từng khu vực của công ty vận tải. |
uri |
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[] |
Công ty vận tải (hoặc các công ty quảng cáo) điều hành đường chuyển tuyến này. |
name |
Tên đầy đủ của đường chuyển tuyến này, ví dụ: "8 Avenue Local". |
uri |
URI cho đường chuyển tuyến này do công ty vận tải cung cấp. |
color |
Màu sắc thường được sử dụng trong bảng hiệu cho đường này. Được biểu thị bằng hệ thập lục phân. |
icon_uri |
URI cho biểu tượng liên kết với dòng này. |
name_short |
Tên ngắn của đường chuyển tuyến này. Tên này thường là số dòng, chẳng hạn như "M7" hoặc "355". |
text_color |
Màu sắc thường được sử dụng trong văn bản trên bảng hiệu cho dòng này. Được biểu thị bằng hệ thập lục phân. |
vehicle |
Loại phương tiện hoạt động trên đường chuyển tuyến này. |
TransitPreferences
Lựa chọn ưu tiên cho các tuyến dựa trên TRANSIT
ảnh hưởng đến tuyến được trả về.
Trường | |
---|---|
allowed_travel_modes[] |
Một nhóm các chế độ đi lại để sử dụng khi nhận tuyến đường |
routing_preference |
Một lựa chọn ưu tiên định tuyến (khi được chỉ định) sẽ ảnh hưởng đến tuyến |
TransitRoutingPreference
Chỉ định tuỳ chọn định tuyến cho các tuyến đường chuyển tuyến.
Enum | |
---|---|
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED |
Chưa chỉ định tùy chọn. |
LESS_WALKING |
Cho biết tuyến đường được tính toán nên đi bộ hạn chế. |
FEWER_TRANSFERS |
Cho biết tuyến đường được tính toán nên có số lượng phương tiện hạn chế. |
TransitTravelMode
Tập hợp các giá trị dùng để chỉ định phương thức di chuyển.
Enum | |
---|---|
TRANSIT_TRAVEL_MODE_UNSPECIFIED |
Chưa chỉ định phương tiện công cộng nào. |
BUS |
Di chuyển bằng xe buýt. |
SUBWAY |
Di chuyển bằng tàu điện ngầm. |
TRAIN |
Di chuyển bằng tàu hoả. |
LIGHT_RAIL |
Đi bằng tàu điện hoặc xe điện. |
RAIL |
Di chuyển bằng tàu lửa. Điều này tương đương với việc kết hợp SUBWAY , TRAIN và LIGHT_RAIL . |
TransitStop
Thông tin về điểm dừng phương tiện công cộng.
Trường | |
---|---|
name |
Tên của điểm dừng chuyển tuyến. |
location |
Vị trí của điểm dừng được thể hiện bằng vĩ độ/kinh độ. |
TransitVehicle
Thông tin về một loại xe được sử dụng trên các tuyến đường phương tiện công cộng.
Trường | |
---|---|
name |
Tên của chiếc xe này, được viết hoa. |
type |
Loại phương tiện được sử dụng. |
icon_uri |
URI cho biểu tượng liên kết với loại xe này. |
local_icon_uri |
URI cho biểu tượng liên kết với loại phương tiện này, dựa trên biển hiệu phương tiện giao thông địa phương. |
TransitVehicleType
Loại phương tiện cho các tuyến đường chuyển tuyến.
Enum | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Không sử dụng. |
BUS |
Xe buýt. |
CABLE_CAR |
Phương tiện vận hành bằng cáp, thường ở trên mặt đất. Cáp treo trên không có thể thuộc loại GONDOLA_LIFT . |
COMMUTER_TRAIN |
Tàu chở khách đi làm. |
FERRY |
Phà. |
FUNICULAR |
Một chiếc xe bị cáp kéo lên dốc. Xe lửa có dây kéo thường bao gồm hai toa, mỗi toa đóng vai trò là đối trọng của xe còn lại. |
GONDOLA_LIFT |
Cáp treo trên không. |
HEAVY_RAIL |
Đường sắt nặng. |
HIGH_SPEED_TRAIN |
Tàu cao tốc. |
INTERCITY_BUS |
Xe buýt liên thành phố. |
LONG_DISTANCE_TRAIN |
Chuyến tàu đường dài. |
METRO_RAIL |
Phương tiện công cộng bằng xe điện. |
MONORAIL |
Xe lửa chạy trên đường một ray. |
OTHER |
Tất cả các xe khác. |
RAIL |
Đường sắt. |
SHARE_TAXI |
Taxi đi chung là một loại xe buýt có khả năng trả khách và đón khách ở bất cứ đâu trên tuyến đường. |
SUBWAY |
Tàu điện ngầm. |
TRAM |
Phía trên đường sắt điện trên mặt đất. |
TROLLEYBUS |
Xe điện. |
Đơn vị
Một tập hợp các giá trị chỉ định đơn vị đo lường dùng trong màn hình.
Enum | |
---|---|
UNITS_UNSPECIFIED |
Chưa chỉ định đơn vị đo lường. Giá trị mặc định là đơn vị đo lường suy ra từ yêu cầu. |
METRIC |
Đơn vị đo lường hệ mét. |
IMPERIAL |
Đơn vị đo lường hệ đo lường Anh (hệ Anh). |
VehicleEmissionType
Tập hợp giá trị mô tả loại khí thải của xe. Chỉ áp dụng cho DRIVE
.RouteTravelMode
Enum | |
---|---|
VEHICLE_EMISSION_TYPE_UNSPECIFIED |
Chưa chỉ định loại khí thải. Mặc định là GASOLINE . |
GASOLINE |
Xe chạy bằng xăng/xăng. |
ELECTRIC |
Xe chạy điện. |
HYBRID |
Xe sử dụng nhiên liệu kết hợp (chẳng hạn như xe chạy bằng xăng + xe điện). |
DIESEL |
Xe chạy bằng động cơ diesel. |
VehicleInfo
Chứa thông tin về xe, chẳng hạn như loại khí thải của xe.
Trường | |
---|---|
emission_type |
Mô tả loại khí thải của xe. Chỉ áp dụng cho |
Waypoint
Đóng gói một điểm tham chiếu. Điểm tham chiếu đánh dấu cả điểm bắt đầu và kết thúc của một tuyến đường và bao gồm các điểm dừng trung gian dọc theo tuyến đường.
Trường | |
---|---|
via |
Đánh dấu điểm tham chiếu này là một điểm mốc thay vì một điểm dừng. Đối với mỗi điểm tham chiếu không phải qua trong yêu cầu, phản hồi sẽ thêm một mục nhập vào mảng |
vehicle_stopover |
Cho biết rằng điểm tham chiếu dành cho xe dừng ở nơi bạn muốn nhận xe hoặc trả xe. Khi bạn đặt giá trị này, tuyến đường được tính toán sẽ không bao gồm các điểm tham chiếu không phải là |
side_of_road |
Cho biết vị trí của điểm tham chiếu này nhằm tuỳ chọn cho xe dừng ở một bên đường cụ thể. Khi bạn đặt giá trị này, tuyến đường sẽ đi qua vị trí để xe có thể dừng ở bên đường mà vị trí bị lệch so với giữa đường. Tuỳ chọn này chỉ áp dụng cho |
Trường hợp location_type . Các cách khác nhau để thể hiện một vị trí. location_type chỉ có thể là một trong những trạng thái sau: |
|
location |
Điểm được chỉ định bằng toạ độ địa lý, bao gồm cả tiêu đề tuỳ chọn. |
place_id |
Mã địa điểm POI được liên kết với điểm tham chiếu. |
address |
Địa chỉ mà con người có thể đọc được hoặc một mã cộng. Hãy xem https://plus.codes để biết thông tin chi tiết. |