Chỉ mục
TripService
(giao diện)VehicleService
(giao diện)BatteryInfo
(thông báo)BatteryStatus
(enum)BillingPlatformIdentifier
(enum)ConsumableTrafficPolyline
(thông báo)CreateTripRequest
(thông báo)CreateVehicleRequest
(thông báo)DeviceSettings
(thông báo)GetTripRequest
(thông báo)GetVehicleRequest
(thông báo)LicensePlate
(thông báo)ListVehiclesRequest
(thông báo)ListVehiclesResponse
(thông báo)LocationPowerSaveMode
(enum)LocationSensor
(enum)NavigationStatus
(enum)PolylineFormatType
(enum)PowerSource
(enum)ReportBillableTripRequest
(thông báo)ReportBillableTripRequest.SolutionType
(enum)RequestHeader
(thông báo)RequestHeader.Platform
(enum)RequestHeader.SdkType
(enum)SearchTripsRequest
(thông báo)SearchTripsResponse
(thông báo)SearchVehiclesRequest
(thông báo)SearchVehiclesRequest.CurrentTripsPresent
(enum)SearchVehiclesRequest.VehicleMatchOrder
(enum)SearchVehiclesResponse
(thông báo)SpeedReadingInterval
(thông báo)SpeedReadingInterval.Speed
(enum)StopLocation
(thông báo)TerminalLocation
(thông báo)TerminalPointId
(tin nhắn) (không dùng nữa)TrafficPolylineData
(thông báo)Trip
(thông báo)TripStatus
(enum)TripType
(enum)TripView
(enum)TripWaypoint
(thông báo)UpdateTripRequest
(thông báo)UpdateVehicleAttributesRequest
(thông báo)UpdateVehicleAttributesResponse
(thông báo)UpdateVehicleRequest
(thông báo)Vehicle
(thông báo)Vehicle.VehicleType
(thông báo)Vehicle.VehicleType.Category
(enum)VehicleAttribute
(thông báo)VehicleAttributeList
(thông báo)VehicleLocation
(thông báo)VehicleMatch
(thông báo)VehicleMatch.VehicleMatchType
(enum)VehicleState
(enum)VisualTrafficReportPolylineRendering
(thông báo)VisualTrafficReportPolylineRendering.RoadStretch
(thông báo)VisualTrafficReportPolylineRendering.RoadStretch.Style
(enum)Waypoint
(thông báo)WaypointType
(enum)
TripService
Dịch vụ quản lý chuyến đi.
CreateTrip |
---|
Tạo một chuyến đi trong Fleet Engine và trả về chuyến đi mới. |
GetTrip |
---|
Nhận thông tin về một chuyến đi. |
ReportBillableTrip |
---|
Báo cáo mức sử dụng chuyến đi có tính phí. |
SearchTrips |
---|
Xem tất cả các chuyến đi của một loại xe cụ thể. |
UpdateTrip |
---|
Cập nhật dữ liệu chuyến đi. |
VehicleService
Dịch vụ quản lý xe.
CreateVehicle |
---|
Tạo thực thể cho một loại xe mới liên kết với một nhà cung cấp dịch vụ đi chung xe hoặc giao hàng theo yêu cầu. Mỗi Bạn bắt buộc phải điền các trường
Các trường
Tất cả các trường khác là không bắt buộc và được sử dụng nếu được cung cấp. |
GetVehicle |
---|
Trả lại xe từ Fleet Engine. |
ListVehicles |
---|
Trả về danh sách xe được phân trang liên kết với một nhà cung cấp khớp với các lựa chọn cho yêu cầu. |
SearchVehicles |
---|
Trả về danh sách xe phù hợp với các lựa chọn của yêu cầu. |
UpdateVehicle |
---|
Ghi dữ liệu xe đã cập nhật vào Fleet Engine. Khi cập nhật một
Cũng không cập nhật được xe Nếu bạn cập nhật trường |
UpdateVehicleAttributes |
---|
Cập nhật một phần các thuộc tính của xe. Chỉ các thuộc tính được đề cập trong yêu cầu mới được cập nhật, các thuộc tính khác sẽ KHÔNG được thay đổi. Lưu ý: điều này khác trong |
BatteryInfo
Thông tin về pin của thiết bị.
Trường | |
---|---|
battery_status |
Trạng thái của pin, cho dù là đầy hay đang sạc, v.v. |
power_source |
Trạng thái của nguồn pin. |
battery_percentage |
Tỷ lệ phần trăm pin hiện tại [0-100]. |
BatteryStatus
Trạng thái của pin, cho dù là đầy hay đang sạc, v.v.
Enum | |
---|---|
UNKNOWN_BATTERY_STATUS |
Trạng thái pin không xác định. |
BATTERY_STATUS_CHARGING |
Pin đang được sạc. |
BATTERY_STATUS_DISCHARGING |
Pin đang hết. |
BATTERY_STATUS_FULL |
Pin đã đầy. |
BATTERY_STATUS_NOT_CHARGING |
Không sạc pin. |
BATTERY_STATUS_POWER_LOW |
Pin yếu. |
BillingPlatformIdentifier
Một tập hợp các giá trị cho biết yêu cầu được đưa ra trên nền tảng nào.
Enum | |
---|---|
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED |
Mặc định. Dùng cho các nền tảng không xác định. |
SERVER |
Nền tảng này là một máy chủ ứng dụng. |
WEB |
Nền tảng này là một trình duyệt web. |
ANDROID |
Nền tảng này là một thiết bị di động Android. |
IOS |
Nền tảng này là một thiết bị di động iOS. |
OTHERS |
Các nền tảng khác không có trong bản liệt kê này. |
ConsumableTrafficPolyline
Mật độ giao thông dọc theo đường của xe.
Trường | |
---|---|
speed_reading_interval[] |
Tốc độ lưu thông dọc theo đường dẫn từ điểm tham chiếu trước đó đến điểm tham chiếu hiện tại. |
encoded_path_to_waypoint |
Đường đi của người lái xe từ điểm tham chiếu trước đến điểm tham chiếu hiện tại. Đường dẫn này có các điểm mốc để ứng dụng có thể hiển thị các điểm đánh dấu giao thông dọc theo đường dẫn (xem |
CreateTripRequest
Thông báo yêu cầu CreateTrip.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
parent |
Bắt buộc. Phải ở định dạng |
trip_id |
Bắt buộc. Mã chuyến đi duy nhất. Tuân theo các hạn chế sau:
|
trip |
Bắt buộc. Thực thể chuyến đi để tạo. Khi tạo Chuyến đi, các trường sau đây là bắt buộc:
Các trường sau đây sẽ được sử dụng nếu bạn cung cấp các trường đó:
Tất cả các trường Chuyến đi khác đều bị bỏ qua. Ví dụ: tất cả các chuyến đi đều bắt đầu bằng Chỉ có các chuyến đi Khi đặt Khi bạn chỉ định Các trường |
CreateVehicleRequest
Tin nhắn yêu cầu CreateVehicle
.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
parent |
Bắt buộc. Phải ở định dạng |
vehicle_id |
Bắt buộc. Mã xe duy nhất. Tuân theo các hạn chế sau:
|
vehicle |
Bắt buộc. Thực thể Xe cần tạo. Khi tạo xe, bạn phải cung cấp các trường sau:
Khi tạo xe, các trường sau sẽ bị bỏ qua:
Tất cả các trường khác là không bắt buộc và được sử dụng nếu được cung cấp. |
DeviceSettings
Thông tin về các chế độ cài đặt trên thiết bị di động.
Trường | |
---|---|
location_power_save_mode |
Cách các tính năng vị trí được thiết lập để hoạt động trên thiết bị khi trình tiết kiệm pin đang bật. |
is_power_save_mode |
Liệu thiết bị có đang ở chế độ tiết kiệm điện hay không. |
is_interactive |
Xem thiết bị có ở trạng thái tương tác hay không. |
battery_info |
Thông tin về tình trạng pin. |
GetTripRequest
Thông báo yêu cầu GetTrip.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
name |
Bắt buộc. Phải ở định dạng |
view |
Tập hợp con các trường Chuyến đi sẽ được trả về và cách diễn giải của các trường đó. |
current_route_segment_version |
Cho biết dấu thời gian tối thiểu (không bao gồm) dữ liệu |
remaining_waypoints_version |
Cho biết dấu thời gian tối thiểu (không bao gồm) mà |
route_format_type |
Định dạng tuyến được trả về hiện tại, |
current_route_segment_traffic_version |
Cho biết dấu thời gian tối thiểu (không bao gồm) mà |
remaining_waypoints_route_version |
Cho biết dấu thời gian tối thiểu (không bao gồm) dữ liệu |
GetVehicleRequest
Tin nhắn yêu cầu GetVehicle
.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
name |
Bắt buộc. Phải ở định dạng |
current_route_segment_version |
Cho biết dấu thời gian tối thiểu (không bao gồm) mà |
waypoints_version |
Cho biết dấu thời gian tối thiểu (không bao gồm) dữ liệu |
LicensePlate
Thông tin biển số xe của xe. Để tránh việc lưu trữ thông tin nhận dạng cá nhân, chỉ thông tin tối thiểu về biển số xe được lưu trữ như một phần của thực thể.
Trường | |
---|---|
country_code |
Bắt buộc. Mã quốc gia/khu vực CLDR. Ví dụ: |
last_character |
Chữ số cuối cùng của biển số xe hoặc "-1" để biểu thị không có giá trị số nào trên biển số đó.
|
ListVehiclesRequest
Tin nhắn yêu cầu ListVehicles
.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
parent |
Bắt buộc. Phải ở định dạng |
page_size |
Số lượng xe tối đa có thể trả về. Giá trị mặc định: 100. |
page_token |
Giá trị của |
minimum_capacity |
Nêu rõ sức chứa tối thiểu bắt buộc của xe. Tất cả xe được trả lại sẽ có |
trip_types[] |
Giới hạn phản hồi đối với các xe hỗ trợ ít nhất một trong các loại chuyến đi đã chỉ định. |
maximum_staleness |
Hạn chế phản hồi những xe đã gửi thông tin cập nhật vị trí cho Fleet Engine trong khoảng thời gian quy định. Những phương tiện cố định vẫn đang truyền vị trí của chúng không bị coi là lỗi thời. Nếu có, thì thời lượng này phải là một giá trị dương hợp lệ. |
vehicle_type_categories[] |
Bắt buộc. Chỉ phản hồi những xe thuộc một trong các danh mục loại được chỉ định. |
required_attributes[] |
Phương thức gọi có thể tạo các phép toán logic phức tạp bằng cách sử dụng bất kỳ tổ hợp nào từ các trường
Chỉ phản hồi những xe có các thuộc tính đã chỉ định. Trường này là toán tử liên kết/AND. Chỉ được phép có tối đa 50 thuộc tính bắt buộc. Thuộc tính này khớp với số lượng thuộc tính tối đa được phép trên xe. Mỗi chuỗi lặp lại phải ở định dạng "key:value". |
required_one_of_attributes[] |
Giới hạn phản hồi cho các phương tiện có ít nhất một trong các thuộc tính được chỉ định trong mỗi |
required_one_of_attribute_sets[] |
Tương tự như
Giới hạn phản hồi cho những phương tiện khớp với mọi thuộc tính trong |
vehicle_state |
Hạn chế phản hồi những xe có trạng thái xe này. |
on_trip_only |
Chỉ trả lại những xe có(các) chuyến đi hiện tại. |
filter |
Không bắt buộc. Một cụm từ tìm kiếm để áp dụng bộ lọc khi đăng thông tin về xe. Hãy truy cập vào http://aip.dev/160 để xem các ví dụ về cú pháp bộ lọc. Trường này được thiết kế để thay thế các trường Bộ lọc này hoạt động dưới dạng mệnh đề AND với các quy tắc ràng buộc khác, chẳng hạn như Xin lưu ý rằng những cụm từ tìm kiếm duy nhất được hỗ trợ là về thuộc tính xe (ví dụ: Ngoài ra, tất cả thuộc tính đều được lưu trữ dưới dạng chuỗi, do đó, phép so sánh duy nhất được hỗ trợ so với các thuộc tính là so sánh chuỗi. Để so sánh với các giá trị số hoặc boolean, các giá trị phải được trích dẫn rõ ràng để được coi là chuỗi (ví dụ: |
viewport |
Không bắt buộc. Một bộ lọc giới hạn số xe được trả về cho những xe có vị trí xác định gần đây nhất là trong khu vực hình chữ nhật được xác định theo khung nhìn. |
ListVehiclesResponse
ListVehicles
tin nhắn phản hồi.
Trường | |
---|---|
vehicles[] |
Xe phù hợp với các tiêu chí trong yêu cầu. Số lượng xe tối đa được trả lại được xác định bằng trường |
next_page_token |
Mã thông báo để truy xuất trang tiếp theo về xe, hoặc để trống nếu không còn xe nào đáp ứng tiêu chí yêu cầu. |
total_size |
Bắt buộc. Tổng số xe đáp ứng các tiêu chí của yêu cầu trên tất cả các trang. |
LocationPowerSaveMode
Cách các tính năng vị trí được định cấu hình để hoạt động trên thiết bị di động khi tính năng "tiết kiệm pin" của thiết bị được bật. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
Enum | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
LocationPowerSaveMode không xác định |
LOCATION_MODE_NO_CHANGE |
Trình tiết kiệm pin sẽ không ảnh hưởng đến nhà cung cấp vị trí hoặc trình tiết kiệm pin đang tắt. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
Bạn nên tắt trình cung cấp vị trí dựa trên GPS khi trình tiết kiệm pin đang bật và thiết bị không tương tác. |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
Bạn phải tắt tất cả các trình cung cấp vị trí khi trình tiết kiệm pin đang bật và thiết bị không tương tác. |
LOCATION_MODE_FOREGROUND_ONLY |
Tất cả các nhà cung cấp dịch vụ vị trí sẽ được giữ nguyên, nhưng bản sửa lỗi vị trí chỉ nên được cung cấp cho ứng dụng trên nền trước. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
Dịch vụ vị trí sẽ không bị tắt, nhưng LocationManager sẽ điều tiết mọi yêu cầu đến nhà cung cấp khi thiết bị không có tính tương tác. |
LocationSensor
Cảm biến hoặc phương pháp dùng để xác định vị trí.
Enum | |
---|---|
UNKNOWN_SENSOR |
Cảm biến chưa được xác định hoặc không xác định. |
GPS |
GPS (Hệ thống định vị toàn cầu) hoặc GPS được hỗ trợ. |
NETWORK |
GPS được hỗ trợ, mã trạm phát sóng hoặc điểm truy cập Wi-Fi. |
PASSIVE |
Mã nhận dạng trạm phát sóng hoặc điểm truy cập Wi-Fi. |
ROAD_SNAPPED_LOCATION_PROVIDER |
Vị trí được thiết bị di động xác định là vị trí có nhiều khả năng nhất trên đường. |
CUSTOMER_SUPPLIED_LOCATION |
Vị trí do khách hàng cung cấp từ một nguồn độc lập. Thông thường, giá trị này được dùng cho vị trí do các nguồn không phải thiết bị di động chạy SDK trình điều khiển cung cấp. Nếu nguồn ban đầu được mô tả bằng một trong các giá trị enum khác, hãy sử dụng giá trị đó. Các vị trí có đánh dấu CUSTOMER_ khoPLIED_LOCATION thường được cung cấp qua last_location.supplemental_location_sensor của xe. |
FLEET_ENGINE_LOCATION |
Vị trí do Fleet Engine tính toán dựa trên tín hiệu có sẵn. Chỉ có đầu ra. Giá trị này sẽ bị từ chối nếu nhận được trong yêu cầu. |
FUSED_LOCATION_PROVIDER |
Trình cung cấp vị trí kết hợp của Android. |
CORE_LOCATION |
Nhà cung cấp dịch vụ vị trí trên các hệ điều hành của Apple. |
PolylineFormatType
Loại định dạng nhiều đường.
Enum | |
---|---|
UNKNOWN_FORMAT_TYPE |
Định dạng không được chỉ định hoặc không xác định. |
LAT_LNG_LIST_TYPE |
Danh sách google.type.LatLng . |
ENCODED_POLYLINE_TYPE |
Hình nhiều đường được mã hoá bằng thuật toán nén nhiều đường. Chưa hỗ trợ tính năng giải mã. |
PowerSource
Loại bộ sạc được dùng để sạc pin.
Enum | |
---|---|
UNKNOWN_POWER_SOURCE |
Không rõ nguồn điện. |
POWER_SOURCE_AC |
Nguồn điện là bộ sạc AC. |
POWER_SOURCE_USB |
Nguồn điện là một cổng USB. |
POWER_SOURCE_WIRELESS |
Nguồn điện là không dây. |
POWER_SOURCE_UNPLUGGED |
Đã rút pin ra khỏi nguồn điện. |
ReportBillableTripRequest
Thông báo yêu cầu ReportBillableTrip.
Trường | |
---|---|
name |
Bắt buộc. Phải ở định dạng |
country_code |
Bắt buộc. Mã quốc gia gồm hai chữ cái của quốc gia nơi chuyến đi diễn ra. Giá được xác định theo mã quốc gia. |
platform |
Nền tảng đưa ra yêu cầu. |
related_ids[] |
Giá trị nhận dạng có liên quan trực tiếp đến chuyến đi được báo cáo. Đây thường là các mã (ví dụ: mã phiên) của các hoạt động đặt trước được thực hiện trước khi có mã chuyến đi. Số lượng |
solution_type |
Loại giải pháp sản phẩm GMP (ví dụ: |
SolutionType
Bộ chọn cho các loại giải pháp khác nhau của một chuyến đi được báo cáo.
Enum | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
Giá trị mặc định. Để đảm bảo khả năng tương thích ngược, API sẽ sử dụng ON_DEMAND_RIDESHARING_AND_DELIVERIES theo mặc định, đây là loại giải pháp đầu tiên được hỗ trợ. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
Giải pháp này dành cho dịch vụ đi chung xe và giao hàng theo yêu cầu. |
RequestHeader
RequestHeader chứa các trường chung cho tất cả các yêu cầu RPC của Fleet Engine.
Trường | |
---|---|
language_code |
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 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu bạn không nêu rõ câu trả lời, thì câu trả lời có thể bằng ngôn ngữ bất kỳ và sẽ ưu tiên tiếng Anh nếu có tên như vậy. Ví dụ về giá trị trường: |
region_code |
Bắt buộc. Mã vùng CLDR của vùng nơi yêu cầu bắt nguồn. Ví dụ về giá trị trường: |
sdk_version |
Phiên bản của SDK gọi (nếu có). Định dạng phiên bản là "major.minor.patch", ví dụ: |
os_version |
Phiên bản của hệ điều hành mà SDK gọi đang chạy. Ví dụ về giá trị trường: |
device_model |
Kiểu thiết bị mà SDK gọi đang chạy. Ví dụ về giá trị trường: |
sdk_type |
Loại SDK gửi yêu cầu. |
maps_sdk_version |
Phiên bản của MapSDK mà SDK gọi phụ thuộc vào, nếu có. Định dạng phiên bản là "major.minor.patch", ví dụ: |
nav_sdk_version |
Phiên bản của NavSDK mà SDK gọi phụ thuộc vào, nếu có. Định dạng phiên bản là "major.minor.patch", ví dụ: |
platform |
Nền tảng của SDK gọi. |
manufacturer |
Nhà sản xuất thiết bị Android từ SDK gọi, chỉ áp dụng cho SDK Android. Ví dụ về giá trị trường: |
android_api_level |
Cấp độ API Android của SDK gọi, chỉ áp dụng cho các SDK Android. Ví dụ về giá trị trường: |
trace_id |
Mã nhận dạng không bắt buộc có thể được cung cấp cho mục đích ghi nhật ký để xác định yêu cầu. |
Nền tảng
Nền tảng của SDK gọi.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Giá trị mặc định. Giá trị này được sử dụng nếu nền tảng bị bỏ qua. |
ANDROID |
Yêu cầu này đến từ Android. |
IOS |
Yêu cầu này đến từ iOS. |
WEB |
Yêu cầu này đến từ web. |
SdkType
Các loại SDK có thể có.
Enum | |
---|---|
SDK_TYPE_UNSPECIFIED |
Giá trị mặc định. Giá trị này được dùng nếu bạn bỏ qua sdk_type . |
CONSUMER |
SDK gọi là Người tiêu dùng. |
DRIVER |
SDK gọi là Driver. |
JAVASCRIPT |
SDK gọi là JavaScript. |
SearchTripsRequest
Tin nhắn yêu cầu SearchTrips.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
parent |
Bắt buộc. Phải ở định dạng |
vehicle_id |
Xe liên kết với các chuyến đi trong yêu cầu. Nếu bạn chưa chỉ định, các chuyến đi được trả về sẽ không chứa:
|
active_trips_only |
Nếu bạn đặt chính sách này thành true, thì phản hồi sẽ bao gồm những Chuyến đi ảnh hưởng đến tuyến đường của người lái xe. |
page_size |
Nếu bạn không đặt chính sách này, máy chủ sẽ quyết định số lượng kết quả cần trả về. |
page_token |
Đặt giá trị này thành một giá trị trước đó được trả về trong |
minimum_staleness |
Nếu được chỉ định, hàm sẽ trả về các chuyến đi chưa được cập nhật sau thời gian |
SearchTripsResponse
Tin nhắn phản hồi của SearchTrips.
Trường | |
---|---|
trips[] |
Danh sách các chuyến đi của xe yêu cầu. |
next_page_token |
Chuyển mã thông báo này trong SearchTripsRequest đến trang thông qua kết quả trong danh sách. API sẽ trả về danh sách chuyến đi trên mỗi lệnh gọi và khi không có kết quả nào khác thì danh sách chuyến đi vẫn trống. |
SearchVehiclesRequest
Tin nhắn yêu cầu SearchVehicles
.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
parent |
Bắt buộc. Phải ở định dạng |
pickup_point |
Bắt buộc. Điểm đón khách để tìm kiếm gần. |
dropoff_point |
Vị trí trả xe dự kiến của khách hàng. Đây là trường bắt buộc nếu |
pickup_radius_meters |
Bắt buộc. Xác định bán kính tìm kiếm xe xung quanh điểm đón khách. Hệ thống sẽ chỉ trả lại những xe trong phạm vi bán kính tìm kiếm. Giá trị phải nằm trong khoảng từ 400 đến 10.000 mét (bao gồm). |
count |
Bắt buộc. Chỉ định số lượng xe tối đa cần trả lại. Giá trị phải nằm trong khoảng từ 1 đến 50 (bao gồm). |
minimum_capacity |
Bắt buộc. Xác định số lượng hành khách được cân nhắc cho một chuyến đi. Giá trị phải lớn hơn hoặc bằng 1. Trình điều khiển không được xem xét trong giá trị sức chứa. |
trip_types[] |
Bắt buộc. Đại diện cho loại chuyến đi đề xuất. Phải bao gồm chính xác một loại. |
maximum_staleness |
Giới hạn tìm kiếm ở những xe đã gửi thông tin cập nhật vị trí cho Fleet Engine trong khoảng thời gian quy định. Những phương tiện cố định vẫn đang truyền vị trí của chúng không bị coi là lỗi thời. Nếu bạn không đặt trường này, máy chủ sẽ sử dụng giá trị mặc định là 5 phút. |
vehicle_types[] |
Bắt buộc. Giới hạn tìm kiếm trong những xe thuộc một trong các loại đã chỉ định. Bạn phải chỉ định ít nhất một loại xe. Không được phép sử dụng các loại xe có danh mục |
required_attributes[] |
Phương thức gọi có thể tạo các phép toán logic phức tạp bằng cách sử dụng bất kỳ tổ hợp nào từ các trường
Chỉ tìm kiếm những chiếc xe có các thuộc tính đã chỉ định. Trường này là toán tử liên kết/AND. Chỉ được phép có tối đa 50 thuộc tính bắt buộc. Thuộc tính này khớp với số lượng thuộc tính tối đa được phép trên xe. |
required_one_of_attributes[] |
Chỉ tìm kiếm những xe có ít nhất một trong các thuộc tính được chỉ định trong mỗi |
required_one_of_attribute_sets[] |
Tương tự như
Chỉ tìm kiếm những xe có tất cả các thuộc tính trong một |
order_by |
Bắt buộc. Chỉ định tiêu chí sắp xếp mong muốn cho kết quả. |
include_back_to_back |
Cột này cho biết những phương tiện có một chuyến đi đang hoạt động có đủ điều kiện cho nội dung tìm kiếm này hay không. Trường này chỉ được dùng khi chưa chỉ định Giá trị mặc định là |
trip_id |
Cho biết chuyến đi được liên kết với |
current_trips_present |
Cột này cho biết những phương tiện có chuyến đi đang hoạt động có đủ điều kiện xuất hiện trong nội dung tìm kiếm này hay không. Thuộc tính này phải được thiết lập thành giá trị khác |
filter |
Không bắt buộc. Một cụm từ tìm kiếm để áp dụng bộ lọc khi tìm kiếm xe. Hãy truy cập vào http://aip.dev/160 để xem các ví dụ về cú pháp bộ lọc. Trường này được thiết kế để thay thế các trường Bộ lọc này hoạt động dưới dạng mệnh đề AND với các quy tắc ràng buộc khác, chẳng hạn như Xin lưu ý rằng những cụm từ tìm kiếm duy nhất được hỗ trợ là về thuộc tính xe (ví dụ: Ngoài ra, tất cả thuộc tính đều được lưu trữ dưới dạng chuỗi, do đó, phép so sánh duy nhất được hỗ trợ so với các thuộc tính là so sánh chuỗi. Để so sánh với các giá trị số hoặc boolean, các giá trị phải được trích dẫn rõ ràng để được coi là chuỗi (ví dụ: |
CurrentTripsPresent
Xác định các loại quy định hạn chế đối với các chuyến đi hiện tại của xe.
Enum | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
Phạm vi cung cấp phương tiện có các chuyến đi hiện tại chịu sự điều chỉnh của trường include_back_to_back . |
NONE |
Những chiếc xe không có chuyến đi có thể xuất hiện trong kết quả tìm kiếm. Khi dùng giá trị này, include_back_to_back không được là true . |
ANY |
Các xe có tối đa 5 chuyến đi hiện tại và 10 điểm tham chiếu được đưa vào kết quả tìm kiếm. Khi dùng giá trị này, include_back_to_back không được là true . |
VehicleMatchOrder
Chỉ định thứ tự của xe trùng khớp trong phản hồi.
Enum | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER |
Mặc định, dùng cho đơn đặt hàng khớp xe không xác định hoặc không nhận dạng được. |
PICKUP_POINT_ETA |
Đơn đặt hàng tăng dần theo thời gian lái xe đến điểm đón. |
PICKUP_POINT_DISTANCE |
Thứ tự tăng dần theo khoảng cách lái xe đến điểm đón. |
DROPOFF_POINT_ETA |
Tăng dần thứ tự theo thời gian lái xe đến điểm trả xe. Đơn đặt hàng này chỉ có thể được sử dụng nếu điểm bỏ ngang được chỉ định trong yêu cầu. |
PICKUP_POINT_STRAIGHT_DISTANCE |
Đơn đặt hàng tăng dần theo khoảng cách theo đường thẳng từ vị trí được báo cáo gần đây nhất của xe đến điểm đón. |
COST |
Thứ tự tăng dần theo chi phí so khớp đã thiết lập. Chi phí phù hợp được định nghĩa là phép tính có trọng số giữa khoảng cách đường thẳng và ETA. Trọng số được đặt với giá trị mặc định và có thể sửa đổi theo từng khách hàng. Vui lòng liên hệ với Nhóm hỗ trợ Google nếu bạn cần sửa đổi các trọng số này cho dự án của mình. |
SearchVehiclesResponse
SearchVehicles
tin nhắn phản hồi.
Trường | |
---|---|
matches[] |
Danh sách xe đáp ứng các tiêu chí của |
SpeedReadingInterval
Chỉ báo mật độ lưu lượng truy cập trên một đoạn liền kề của đường dẫn. Cho sẵn một đường dẫn với các điểm P_0, P_1, ... , P_N (chỉ số 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ách sử dụng các danh mục sau.
Trường | |
---|---|
start_polyline_point_index |
Chỉ mục bắt đầu của khoảng thời gian này trong đường dẫn. Trong JSON, khi chỉ mục bằng 0, trường này sẽ có vẻ như không được điền. |
end_polyline_point_index |
Chỉ mục kết thúc của khoảng thời gian này trong đường dẫn. Trong JSON, khi chỉ mục bằng 0, trường này sẽ có vẻ như không được điền. |
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. |
StopLocation
Vị trí thực tế mà bạn dừng xe (đến lấy hàng/trả khách).
Trường | |
---|---|
point |
Bắt buộc. Mô tả vị trí thực tế. |
timestamp |
Cho biết thời điểm dừng xảy ra. |
stop_time |
Chỉ nhập. Không dùng nữa. Sử dụng trường dấu thời gian. |
TerminalLocation
Mô tả vị trí của một điểm tham chiếu.
Trường | |
---|---|
point |
Bắt buộc. Biểu thị vị trí của điểm tham chiếu chuyến đi. |
terminal_point_id |
Không dùng nữa: Chỉ định trường |
access_point_id |
Không dùng nữa: Chỉ định trường |
trip_id |
Không dùng nữa. |
terminal_location_type |
Không dùng nữa: |
TerminalPointId
Ngừng sử dụng: TerminalPoint không còn được hỗ trợ trong Fleet Engine. Thay vào đó, hãy sử dụng TerminalLocation.point
.
Trường | |
---|---|
value |
Không dùng nữa. |
Trường hợp Id . Không dùng nữa. Id chỉ có thể là một trong những trạng thái sau: |
|
place_id |
Không dùng nữa. |
generated_id |
Không dùng nữa. |
TrafficPolylineData
Tình trạng giao thông dọc theo tuyến đường dự kiến của xe.
Trường | |
---|---|
traffic_rendering |
Hình nhiều đường hiển thị tốc độ truy cập của lưu lượng truy cập ở tất cả các khu vực dọc theo một đoạn đường trong chuyến đi của khách hàng. |
Chuyến đi
Siêu dữ liệu về chuyến đi.
Trường | |
---|---|
name |
Chỉ có đầu ra. Ở định dạng "providers/{provider}/trips/{trip}" |
vehicle_id |
Mã của chiếc xe trong chuyến đi này. |
trip_status |
Trạng thái hiện tại của chuyến đi. |
trip_type |
Loại chuyến đi. |
pickup_point |
Vị trí mà khách hàng cho biết họ sẽ đến lấy hàng. |
actual_pickup_point |
Chỉ nhập. Địa điểm thực tế, thời điểm và địa điểm đón khách. Trường này dành cho nhà cung cấp đưa ra ý kiến phản hồi về thông tin thực tế đến lấy hàng. |
actual_pickup_arrival_point |
Chỉ nhập. Thời gian và vị trí thực tế mà tài xế sẽ đến tại điểm đón khách. Trường này dành cho nhà cung cấp để cung cấp ý kiến phản hồi về thông tin thực tế đến tại điểm đón. |
pickup_time |
Chỉ có đầu ra. Thời gian ước tính trong tương lai khi(những) người lái xe sẽ được đón hoặc thời gian thực tế khi họ được đón. |
intermediate_destinations[] |
Điểm dừng trung gian theo thứ tự chuyến đi yêu cầu (ngoài việc đến lấy hàng và trả xe). Ban đầu, tính năng này sẽ không được hỗ trợ cho các chuyến đi chung. |
intermediate_destinations_version |
Cho biết lần gần đây nhất |
intermediate_destination_index |
Khi |
actual_intermediate_destination_arrival_points[] |
Chỉ nhập. Thời gian thực tế và vị trí mà người lái xe sẽ đến một điểm đến trung gian. Trường này dành cho nhà cung cấp để cung cấp ý kiến phản hồi về thông tin thực tế đến tại các điểm đến trung gian. |
actual_intermediate_destinations[] |
Chỉ nhập. Thời gian và vị trí thực tế, thời điểm và địa điểm đón khách hàng từ một điểm đến trung gian. Trường này dành cho nhà cung cấp để cung cấp ý kiến phản hồi về thông tin thực tế đến lấy hàng tại các điểm đến trung gian. |
dropoff_point |
Vị trí mà khách hàng cho biết họ sẽ được trả hàng. |
actual_dropoff_point |
Chỉ nhập. Thời gian và địa điểm thực tế, thời điểm và địa điểm khách hàng bỏ ngang. Trường này là để nhà cung cấp đưa ra ý kiến phản hồi về thông tin thực tế bỏ ngang. |
dropoff_time |
Chỉ có đầu ra. Thời gian dự kiến trong tương lai khi(những) người lái xe sẽ trả khách ở điểm đến cuối cùng hoặc thời gian thực tế khi họ xuống xe. |
remaining_waypoints[] |
Chỉ có đầu ra. Đường dẫn đầy đủ từ vị trí hiện tại đến điểm trả xe (bao gồm cả vị trí đó). Đường dẫn này có thể bao gồm các điểm tham chiếu từ các chuyến đi khác. |
vehicle_waypoints[] |
Trường này hỗ trợ sắp xếp các điểm tham chiếu theo cách thủ công cho chuyến đi. Dữ liệu này chứa tất cả các điểm tham chiếu còn lại của xe được chỉ định, cũng như điểm đón và trả xe cho chuyến đi này. Nếu chuyến đi chưa được chỉ định cho một xe nào, thì Fleet Engine sẽ bỏ qua trường này. Vì lý do liên quan đến quyền riêng tư, trường này chỉ được máy chủ điền sẵn trong các lệnh gọi |
route[] |
Chỉ có đầu ra. Tuyến đường dự kiến cho chuyến đi này đến mục nhập đầu tiên trong còn_waypoints. Lưu ý rằng điểm tham chiếu đầu tiên có thể thuộc về một chuyến đi khác. |
current_route_segment |
Chỉ có đầu ra. Một đường dẫn được mã hoá đến điểm tham chiếu tiếp theo. Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. Chưa hỗ trợ tính năng giải mã. |
current_route_segment_version |
Chỉ có đầu ra. Cho biết lần gần đây nhất tuyến đường được sửa đổi. Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. |
current_route_segment_traffic |
Chỉ có đầu ra. Cho biết tình trạng giao thông dọc theo Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. |
current_route_segment_traffic_version |
Chỉ có đầu ra. Cho biết lần gần đây nhất Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. |
current_route_segment_end_point |
Chỉ có đầu ra. Điểm tham chiếu nơi |
remaining_distance_meters |
Chỉ có đầu ra. Quãng đường lái xe còn lại trong trường |
eta_to_first_waypoint |
Chỉ có đầu ra. ETA cho điểm tham chiếu tiếp theo (mục nhập đầu tiên trong trường |
remaining_time_to_first_waypoint |
Chỉ có đầu ra. Khoảng thời gian kể từ khi dữ liệu Chuyến đi được trả về cho thời gian trong |
remaining_waypoints_version |
Chỉ có đầu ra. Cho biết lần gần đây nhất |
remaining_waypoints_route_version |
Chỉ có đầu ra. Cho biết lần sửa đổi gần đây nhất |
number_of_passengers |
Không thể thay đổi. Cho biết số lượng hành khách của chuyến đi này và không bao gồm người lái xe. Xe phải còn hạn mức để có thể trả lại trong phản hồi |
last_location |
Chỉ có đầu ra. Cho biết vị trí được báo cáo lần gần đây nhất của xe dọc theo tuyến đường. |
last_location_snappable |
Chỉ có đầu ra. Cho biết liệu |
view |
Tập hợp con các trường Chuyến đi được điền sẵn và cách các trường đó được diễn giải. |
TripStatus
Trạng thái của chuyến đi cho biết tiến trình của chuyến đi.
Enum | |
---|---|
UNKNOWN_TRIP_STATUS |
Mặc định, dùng cho trạng thái chuyến đi không xác định hoặc không xác định. |
NEW |
Chuyến đi mới tạo. |
ENROUTE_TO_PICKUP |
Tài xế đang trên đường đến điểm đón. |
ARRIVED_AT_PICKUP |
Tài xế đã đến điểm đón. |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
Tài xế đã đến một điểm đến trung gian và đang chờ người lái. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Tài xế đang trên đường đến một điểm đến trung gian (không phải điểm trả xe). |
ENROUTE_TO_DROPOFF |
Người lái xe đã đón người lái và đang trên đường đến điểm đến tiếp theo. |
COMPLETE |
Người lái xe đã bị trả lại và chuyến đi đã kết thúc. |
CANCELED |
Chuyến đi đã bị huỷ trước khi người lái xe, người lái xe hoặc nhà cung cấp dịch vụ đi chung xe đến lấy hàng. |
TripType
Loại chuyến đi.
Enum | |
---|---|
UNKNOWN_TRIP_TYPE |
Mặc định, dùng cho các loại chuyến đi không xác định hoặc không được nhận dạng. |
SHARED |
Chuyến đi có thể chung xe với các chuyến đi khác. |
EXCLUSIVE |
Chuyến đi chỉ dành riêng cho một phương tiện di chuyển. |
TripView
Bộ chọn cho các tập hợp trường Chuyến đi khác nhau trong một phản hồi GetTrip
. Hãy xem AIP-157 để biết thêm thông tin. Bạn có thể thêm các chế độ xem khác.
Enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Giá trị mặc định. Để đảm bảo khả năng tương thích ngược, API sẽ mặc định ở chế độ xem SDK. Để đảm bảo độ ổn định và khả năng hỗ trợ, khách hàng nên chọn TripView thay vì SDK . |
SDK |
Bao gồm các trường có thể không diễn giải được hoặc không hỗ trợ được khi sử dụng các thư viện công khai. |
JOURNEY_SHARING_V1S |
Các trường chuyến đi được điền sẵn cho trường hợp sử dụng Chia sẻ hành trình. Chế độ xem này dành cho hoạt động giao tiếp giữa các máy chủ. |
TripWaypoint
Mô tả điểm dừng trên tuyến đường của xe hoặc điểm kết thúc trong chuyến đi của xe.
Trường | |
---|---|
location |
Vị trí của điểm tham chiếu này. |
trip_id |
Chuyến đi liên quan đến điểm tham chiếu này. |
waypoint_type |
Vai trò của điểm tham chiếu này trong chuyến đi này, chẳng hạn như đón khách hoặc trả xe. |
path_to_waypoint[] |
Đường dẫn từ điểm tham chiếu trước đó đến điểm tham chiếu hiện tại. Không xác định được điểm tham chiếu đầu tiên trong danh sách. Trường này chỉ được điền khi có yêu cầu. |
encoded_path_to_waypoint |
Đường dẫn được mã hoá từ điểm tham chiếu trước đó đến điểm tham chiếu hiện tại. Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người dùng. Chưa hỗ trợ tính năng giải mã. |
traffic_to_waypoint |
Tình trạng giao thông dọc theo đường dẫn đến điểm tham chiếu này. Xin lưu ý rằng chỉ những khách hàng sử dụng Giải pháp gọi xe và giao hàng trên Nền tảng Google Maps mới có thể xem lưu lượng truy cập. |
distance_meters |
Khoảng cách trong đường dẫn từ điểm tham chiếu trước đó đến điểm tham chiếu hiện tại. Không xác định được điểm tham chiếu đầu tiên trong danh sách. |
eta |
Thời gian dự kiến đến điểm tham chiếu này. Không xác định được điểm tham chiếu đầu tiên trong danh sách. |
duration |
Thời gian di chuyển từ điểm tham chiếu trước đó đến thời điểm này. Không xác định được điểm tham chiếu đầu tiên trong danh sách. |
UpdateTripRequest
Thông báo yêu cầu Cập nhật Chuyến đi.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
name |
Bắt buộc. Phải ở định dạng |
trip |
Bắt buộc. Chuyến đi được liên kết với nội dung cập nhật. Các trường sau đây do Fleet Engine duy trì. Đừng cập nhật các thông tin này bằng Trip.update.
Khi cập nhật Khi bạn chỉ định Để tránh tình trạng tương tranh cho các chuyến đi có nhiều điểm đến, bạn nên cung cấp |
update_mask |
Bắt buộc. Mặt nạ cho trường (field mask) cho biết những trường cần cập nhật trong Chuyến đi. |
UpdateVehicleAttributesRequest
Tin nhắn yêu cầu UpdateVehicleAttributes
.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
name |
Bắt buộc. Phải ở định dạng |
attributes[] |
Bắt buộc. Các thuộc tính xe cần cập nhật. Những thuộc tính chưa được đề cập sẽ không bị thay đổi hoặc xoá bỏ. |
UpdateVehicleAttributesResponse
UpdateVehicleAttributes
tin nhắn phản hồi.
Trường | |
---|---|
attributes[] |
Bắt buộc. Danh sách đầy đủ được cập nhật về các thuộc tính xe, bao gồm cả các thuộc tính mới, đã được thay đổi và chưa được sửa đổi. |
UpdateVehicleRequest
"Cập nhật thông báo yêu cầu về phương tiện.
Trường | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
name |
Bắt buộc. Phải ở định dạng |
vehicle |
Bắt buộc. Giá trị của thực thể
Nếu bạn cập nhật trường Tương tự, trường |
update_mask |
Bắt buộc. Mặt nạ trường (field mask) cho biết những trường của |
Loại xe
Siêu dữ liệu về xe.
Trường | |
---|---|
name |
Chỉ có đầu ra. Tên riêng biệt của xe này. Định dạng là |
vehicle_state |
Trạng thái xe. |
supported_trip_types[] |
Các loại chuyến đi được xe này hỗ trợ. |
current_trips[] |
Chỉ có đầu ra. Danh sách của |
last_location |
Vị trí được báo cáo gần đây nhất của chiếc xe. |
maximum_capacity |
Tổng số người mà chiếc xe này có thể chở. Trình điều khiển không được xem xét trong giá trị này. Giá trị này phải lớn hơn hoặc bằng 1. |
attributes[] |
Danh sách các thuộc tính của xe. Xe có thể có tối đa 100 thuộc tính và mỗi thuộc tính phải có một chìa khoá duy nhất. |
vehicle_type |
Bắt buộc. Loại xe này. Có thể dùng để lọc xe trong kết quả |
license_plate |
Thông tin biển số xe của xe. |
route[] |
Không dùng nữa: Thay vào đó, hãy dùng |
current_route_segment |
Hình nhiều đường chỉ định tuyến đường mà ứng dụng trình điều khiển dự định đi tới điểm tham chiếu tiếp theo. Danh sách này cũng được trả về trong Lưu ý: Trường này chỉ dành cho SDK trình điều khiển. Chưa hỗ trợ tính năng giải mã. |
current_route_segment_traffic |
Chỉ nhập. Fleet Engine sử dụng thông tin này để cải thiện hoạt động chia sẻ hành trình. Lưu ý: Trường này chỉ dành cho SDK trình điều khiển. |
current_route_segment_version |
Chỉ có đầu ra. Thời điểm đặt |
current_route_segment_end_point |
Điểm tham chiếu nơi |
remaining_distance_meters |
Quãng đường lái xe còn lại của |
eta_to_first_waypoint |
ETA cho mục nhập đầu tiên trong trường Khi cập nhật một xe, |
remaining_time_seconds |
Chỉ nhập. Thời gian lái xe còn lại của Khi cập nhật xe, |
waypoints[] |
Các điểm tham chiếu còn lại được chỉ định cho Xe này. |
waypoints_version |
Chỉ có đầu ra. Lần gần đây nhất trường |
back_to_back_enabled |
Cho biết liệu tài xế có chấp nhận các chuyến đi ngược chiều hay không. Nếu giá trị là |
navigation_status |
Trạng thái chỉ đường của xe. |
device_settings |
Chỉ nhập. Thông tin về các chế độ cài đặt trong thiết bị di động mà người lái xe sử dụng. |
VehicleType
Loại phương tiện.
Trường | |
---|---|
category |
Danh mục loại xe |
Danh mục
Danh mục loại xe
Enum | |
---|---|
UNKNOWN |
Giá trị mặc định, dùng cho các danh mục xe không xác định hoặc không nhận dạng được. |
AUTO |
Ô tô. |
TAXI |
Bất kỳ loại xe nào hoạt động như taxi (thường được cấp phép hoặc quản lý). |
TRUCK |
Thường là loại xe có dung lượng chứa lớn. |
TWO_WHEELER |
Xe mô tô, xe đạp gắn máy hoặc xe hai bánh khác |
BICYCLE |
Phương tiện vận tải sử dụng con người. |
PEDESTRIAN |
Phương tiện vận chuyển người, thường là đi bộ hoặc chạy, đi dọc theo các đường dành cho người đi bộ. |
VehicleAttribute
Mô tả thuộc tính xe dưới dạng một cặp khoá-giá trị. Chuỗi "key:value" không được vượt quá 256 ký tự.
Trường | |
---|---|
key |
Khoá của thuộc tính. Khoá không được chứa ký tự dấu hai chấm (:). |
value |
Giá trị của thuộc tính. |
Trường hợp vehicle_attribute_value . Giá trị của thuộc tính có thể ở dạng chuỗi, bool hoặc kiểu kép. vehicle_attribute_value chỉ có thể là một trong những trạng thái sau: |
|
string_value |
Giá trị thuộc tính đã nhập chuỗi. Lưu ý: Trường này giống với trường |
bool_value |
Giá trị thuộc tính đã nhập Boolean. |
number_value |
Giá trị thuộc tính đã nhập 2 lần. |
VehicleAttributeList
Loại dữ liệu trong danh sách cho các thuộc tính của xe.
Trường | |
---|---|
attributes[] |
Danh sách các thuộc tính trong bộ sưu tập này. |
VehicleLocation
Vị trí, tốc độ và hướng đi của xe tại một thời điểm.
Trường | |
---|---|
location |
Vị trí của xe. Khi được gửi đến Fleet Engine, thông tin vị trí của xe sẽ là vị trí GPS. Khi bạn nhận được thông tin phản hồi, vị trí của xe có thể là vị trí GPS, vị trí bổ sung hoặc vị trí ước đoán khác. Nguồn này được chỉ định trong |
horizontal_accuracy |
Không dùng nữa: Thay vào đó, hãy dùng |
latlng_accuracy |
Độ chính xác của bán kính là |
heading |
Hướng xe đang di chuyển theo độ. 0 đại diện cho phía Bắc. Phạm vi hợp lệ là [0,360). |
bearing_accuracy |
Không dùng nữa: Thay vào đó, hãy dùng |
heading_accuracy |
Độ chính xác của |
altitude |
Độ cao tính bằng mét trên WGS84. |
vertical_accuracy |
Không dùng nữa: Thay vào đó, hãy dùng |
altitude_accuracy |
Độ chính xác của |
speed_kmph |
Tốc độ của xe tính bằng km/giờ. Không dùng nữa: Thay vào đó, hãy dùng |
speed |
Tốc độ của xe tính bằng mét/giây |
speed_accuracy |
Độ chính xác: |
update_time |
Thời điểm |
server_time |
Chỉ có đầu ra. Thời điểm máy chủ nhận được thông tin vị trí. |
location_sensor |
Nhà cung cấp dữ liệu vị trí (ví dụ: |
is_road_snapped |
Liệu |
is_gps_sensor_enabled |
Chỉ nhập. Cho biết liệu cảm biến GPS có được bật trên thiết bị di động hay không. |
time_since_update |
Chỉ nhập. Thời gian (tính bằng giây) kể từ khi vị trí này được gửi lần đầu đến máy chủ. Giá trị này sẽ bằng 0 trong lần cập nhật đầu tiên. Nếu không xác định được thời gian (ví dụ: khi ứng dụng khởi động lại), thì giá trị này sẽ được đặt lại về 0. |
num_stale_updates |
Chỉ nhập. Không dùng nữa: Các tín hiệu khác hiện được dùng để xác định xem một vị trí có lỗi thời hay không. |
raw_location |
Vị trí thô của xe (chưa được giao dịch viên đường bộ xử lý). |
raw_location_time |
Dấu thời gian liên kết với vị trí thô. |
raw_location_sensor |
Nguồn vị trí thô. Giá trị mặc định là |
raw_location_accuracy |
Độ chính xác của |
supplemental_location |
Vị trí bổ sung do ứng dụng tích hợp cung cấp. |
supplemental_location_time |
Dấu thời gian liên kết với vị trí bổ sung. |
supplemental_location_sensor |
Nguồn của vị trí bổ sung. Giá trị mặc định là |
supplemental_location_accuracy |
Độ chính xác của |
road_snapped |
Không dùng nữa: Thay vào đó, hãy dùng |
VehicleMatch
Chứa thông tin về xe và các thông tin ước tính liên quan cho một chiếc xe phù hợp với các điểm của các chuyến đi đang hoạt động của chiếc xe SearchVehiclesRequest
.
Trường | |
---|---|
vehicle |
Bắt buộc. Một chiếc xe phù hợp với yêu cầu. |
vehicle_pickup_eta |
Thời gian đến dự kiến của xe tới điểm đón được chỉ định trong yêu cầu. Giá trị trống cho biết xe không tính được thời gian đến dự kiến. Nếu giá trị |
vehicle_pickup_distance_meters |
Khoảng cách từ vị trí hiện tại của xe đến điểm đón được chỉ định trong yêu cầu, bao gồm cả các điểm đón khách hoặc trả khách trung gian đối với các chuyến đi hiện tại. Khoảng cách này bao gồm quãng đường lái xe (tuyến đường) đã tính toán, cùng với khoảng cách theo đường thẳng giữa điểm cuối của lộ trình và điểm đón được yêu cầu. (Khoảng cách giữa điểm cuối điều hướng và điểm đón được yêu cầu thường nhỏ.) Giá trị trống cho biết có lỗi khi tính khoảng cách. |
vehicle_pickup_straight_line_distance_meters |
Bắt buộc. Khoảng cách theo đường thẳng giữa xe và điểm đón được chỉ định trong yêu cầu. |
vehicle_dropoff_eta |
Thời gian dự kiến lái xe hoàn chỉnh của xe đến điểm trả khách được chỉ định trong yêu cầu. ETA bao gồm việc dừng tại bất kỳ điểm tham chiếu nào trước |
vehicle_pickup_to_dropoff_distance_meters |
Quãng đường lái xe của xe (tính bằng mét) từ điểm đón đến điểm trả xe được chỉ định trong yêu cầu. Khoảng cách chỉ giữa hai điểm và không bao gồm vị trí của xe hoặc bất kỳ điểm nào khác mà bạn phải ghé thăm trước khi xe đến điểm đón hoặc điểm trả xe. Giá trị này sẽ chỉ được điền khi |
trip_type |
Bắt buộc. Loại chuyến đi của yêu cầu dùng để tính thời gian đến dự kiến tới điểm đón khách. |
vehicle_trips_waypoints[] |
Danh sách các điểm tham chiếu theo thứ tự dùng để tính toán ETA. Danh sách này bao gồm vị trí của xe, điểm đón của các chuyến đi đang hoạt động của xe và điểm đón được cung cấp trong yêu cầu. Danh sách trống cho biết xe không tính được thời gian đến dự kiến. |
vehicle_match_type |
Loại kết quả trùng khớp với xe. |
requested_ordered_by |
Đơn đặt hàng đã yêu cầu để sắp xếp các kết quả trùng khớp với xe. |
ordered_by |
Đơn đặt hàng thực tế được dùng cho xe này. Thông thường, giá trị này sẽ khớp với trường "order_by" trong yêu cầu; tuy nhiên, trong một số trường hợp như lỗi máy chủ nội bộ, có thể sử dụng một phương thức khác (chẳng hạn như |
VehicleMatchType
Loại xe trùng khớp.
Enum | |
---|---|
UNKNOWN |
Kiểu khớp xe không xác định |
EXCLUSIVE |
Xe này hiện chưa được chỉ định chuyến đi và có thể đi tới điểm đón. |
BACK_TO_BACK |
Xe hiện được chỉ định cho một chuyến đi, nhưng có thể tiếp tục đến điểm đón sau khi hoàn tất chuyến đi đang diễn ra. Việc tính toán thời gian đến dự kiến và khoảng cách sẽ có tính đến chuyến đi hiện tại. |
CARPOOL |
Xe có đủ chỗ cho một chuyến đi chung. |
CARPOOL_BACK_TO_BACK |
Xe sẽ kết thúc chuyến đi hiện tại, đang hoạt động trước khi đi đến điểm đón. Việc tính toán thời gian đến dự kiến và khoảng cách sẽ có tính đến chuyến đi hiện tại. |
VehicleState
Trạng thái của Vehicle
.
Enum | |
---|---|
UNKNOWN_VEHICLE_STATE |
Giá trị mặc định, dùng cho trạng thái xe không xác định hoặc không nhận dạng được. |
OFFLINE |
Xe này không nhận các chuyến đi mới. Lưu ý: xe có thể tiếp tục hoạt động ở trạng thái này trong khi hoàn thành chuyến đi được chỉ định cho xe. |
ONLINE |
Xe này đang chấp nhận các chuyến đi mới. |
VisualTrafficReportPolylineRendering
Mô tả cách ứng dụng khách sẽ tô màu một phần của hình nhiều đường dọc theo tuyến đường.
Trường | |
---|---|
road_stretch[] |
Không bắt buộc. Đường kéo dài sẽ được hiển thị dọc theo hình nhiều đường. Các đoạn đường được đảm bảo sẽ không chồng chéo nhau, và không nhất thiết phải trải dài trên toàn bộ tuyến đường. Trong trường hợp không có đường kéo dài để tạo kiểu, ứng dụng khách phải áp dụng giá trị mặc định cho tuyến đường. |
RoadStretch
Một đoạn đường kéo dài sẽ được kết xuất.
Trường | |
---|---|
style |
Bắt buộc. Kiểu sẽ áp dụng. |
offset_meters |
Bắt buộc. Kiểu nên được áp dụng trong khoảng |
length_meters |
Bắt buộc. Độ dài của đường dẫn nơi áp dụng kiểu. |
Phong cách
Kiểu giao thông, cho biết tốc độ giao thông.
Enum | |
---|---|
STYLE_UNSPECIFIED |
Chưa chọn kiểu nào. |
SLOWER_TRAFFIC |
Giao thông đang chậm lại. |
TRAFFIC_JAM |
Có ách tắc giao thông. |
Waypoint
Mô tả các điểm trung gian dọc theo một tuyến cho VehicleMatch
trong SearchVehiclesResponse
. Khái niệm này được biểu thị dưới dạng TripWaypoint
trong tất cả các điểm cuối khác.
Trường | |
---|---|
lat_lng |
Vị trí của điểm tham chiếu này. |
eta |
Thời gian dự kiến mà xe sẽ đến điểm tham chiếu này. |
WaypointType
Loại điểm tham chiếu.
Enum | |
---|---|
UNKNOWN_WAYPOINT_TYPE |
Loại điểm tham chiếu không xác định hoặc chưa được chỉ định. |
PICKUP_WAYPOINT_TYPE |
Điểm tham chiếu để đón khách hoặc vật phẩm. |
DROP_OFF_WAYPOINT_TYPE |
Điểm tham chiếu để trả khách hoặc vật phẩm. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
Điểm tham chiếu cho các điểm đến trung gian trong một chuyến đi nhiều điểm đến. |