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
(thông báo) (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 phải trả phí. |
SearchTrips |
---|
Xem tất 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 chiếc xe mới được liên kết với nhà cung cấp dịch vụ đi chung xe hoặc giao hàng theo yêu cầu. Mỗi 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à sử dụng nếu được cung cấp. |
GetVehicle |
---|
Trả về phương tiện từ Fleet Engine. |
ListVehicles |
---|
Trả về danh sách xe được phân trang có liên kết với một nhà cung cấp phù hợp với các lựa chọn trong yêu cầu. |
SearchVehicles |
---|
Trả về danh sách xe phù hợp với các lựa chọn trong yêu cầu. |
UpdateVehicle |
---|
Ghi dữ liệu mới về phương tiện vào Fleet Engine. Khi cập nhật
Bạn cũng không thể cập nhật 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 với |
BatteryInfo
Thông tin về pin của thiết bị.
Trường | |
---|---|
battery_status |
Trạng thái pin, pin đầy hay đang sạc, v.v. |
power_source |
Trạng thái của nguồn pin. |
battery_percentage |
Phần trăm pin hiện tại [0-100]. |
BatteryStatus
Trạng thái pin, pin đầy hay đang sạc, v.v.
Enum | |
---|---|
UNKNOWN_BATTERY_STATUS |
Không rõ tình trạng pin. |
BATTERY_STATUS_CHARGING |
Pin đang được sạc. |
BATTERY_STATUS_DISCHARGING |
Pin đang sạc. |
BATTERY_STATUS_FULL |
Pin đã đầy. |
BATTERY_STATUS_NOT_CHARGING |
Pin đang không sạc. |
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 gửi 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ủ máy khách. |
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 đi của phương tiện.
Trường | |
---|---|
speed_reading_interval[] |
Tốc độ giao thông dọc theo đường từ điểm tham chiếu trước đó đến điểm tham chiếu hiện tại. |
encoded_path_to_waypoint |
Lộ trình mà người lái xe đang đi 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 địa danh để ứng dụng có thể hiển thị đ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 đề tiêu chuẩn của yêu cầu Fleet Engine. |
parent |
Bắt buộc. Phải ở định dạng |
trip_id |
Bắt buộc. Mã chuyến đi duy nhất. Phải tuân theo các quy định hạn chế sau:
|
trip |
Bắt buộc. Mục chuyến đi cần tạo. Khi tạo Chuyến đi, bạn cần điền vào các trường sau:
Sau đây là các trường sẽ được sử dụng nếu bạn cung cấp các trường này:
Tất cả các trường Chuyến đi khác sẽ bị bỏ qua. Ví dụ: mọi chuyến đi đều bắt đầu bằng Chỉ có Khi Khi bạn chỉ định Các trường |
CreateVehicleRequest
Tin nhắn yêu cầu CreateVehicle
.
Trường | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
parent |
Bắt buộc. Phải ở định dạng |
vehicle_id |
Bắt buộc. Mã xe duy nhất. Phải tuân theo các quy định hạn chế sau:
|
vehicle |
Bắt buộc. Mục Xe cần tạo. Khi tạo xe, bạn phải điền vào các trường sau:
Khi tạo Xe, các trường sau đây sẽ bị bỏ qua:
Tất cả các trường khác là không bắt buộc và sử dụng nếu được cung cấp. |
DeviceSettings
Thông tin về nhiều 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í 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ị hiện có đang ở chế độ tiết kiệm điện năng hay không. |
is_interactive |
Xem thiết bị có đang ở trạng thái tương tác hay không. |
battery_info |
Thông tin về trạng thái pin. |
GetTripRequest
Thông báo yêu cầu GetTrip.
Trường | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
name |
Bắt buộc. Phải ở định dạng |
view |
Tập hợp con của các trường Chuyến đi cần được trả về và phần diễn giải các trường đó. |
current_route_segment_version |
Cho biết dấu thời gian tối thiểu (dành riêng) cho dữ liệu |
remaining_waypoints_version |
Cho biết dấu thời gian tối thiểu (dành riêng) mà |
route_format_type |
Định dạng tuyến hiện tại được trả về, |
current_route_segment_traffic_version |
Cho biết dấu thời gian tối thiểu (dành riêng) mà |
remaining_waypoints_route_version |
Cho biết dấu thời gian tối thiểu (dành riêng) cho dữ liệu |
GetVehicleRequest
Tin nhắn yêu cầu GetVehicle
.
Trường | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
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 (dành riêng) mà |
waypoints_version |
Cho biết dấu thời gian tối thiểu (dành riêng) cho dữ liệu |
LicensePlate
Thông tin về biển số xe của xe. Để tránh 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ố xe.
|
ListVehiclesRequest
Tin nhắn yêu cầu ListVehicles
.
Trường | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
parent |
Bắt buộc. Phải ở định dạng |
page_size |
Số lượng phương tiện tối đa cần trả lại. Giá trị mặc định: 100. |
page_token |
Giá trị của |
minimum_capacity |
Cho biết sức chứa tối thiểu bắt buộc của xe. Tất cả phương tiện được trả về sẽ có |
trip_types[] |
Hạn chế nội dung phản hồi cho những phương tiện 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 đối với những phương tiện đã gửi thông tin cập nhật vị trí cho Fleet Engine trong khoảng thời gian cụ thể. Các phương tiện tại chỗ vẫn truyền dữ liệu vị trí của chúng không bị coi là lỗi thời. Nếu có, phải là một thời lượng dương hợp lệ. |
vehicle_type_categories[] |
Bắt buộc. Hạn chế phản hồi đối với những phương tiện có một trong các danh mục loại đã chỉ định. |
required_attributes[] |
Phương thức gọi có thể tạo thành 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 của các trường
Hạn chế phản hồi đối với những xe có các thuộc tính được chỉ định. Trường này là phép toán kết hợp/VÀ. Bạn chỉ được thêm tối đa 50 thuộc tính bắt buộc. Giá trị này khớp với số lượng thuộc tính tối đa được phép trên một chiếc xe. Mỗi chuỗi lặp lại phải có định dạng "key:value". |
required_one_of_attributes[] |
Hạn chế phản hồi cho những 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ư
Hạn chế phản hồi cho các phương tiện khớp với mọi thuộc tính trong |
vehicle_state |
Hạn chế phản hồi đối với những xe có trạng thái xe này. |
on_trip_only |
Chỉ trả xe cùng(các) chuyến đi hiện tại. |
filter |
Không bắt buộc. Cụm từ tìm kiếm để áp dụng khi đăng thông tin về xe. Hãy xem http://aip.dev/160 để biết 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 cùng với các điều kiện ràng buộc khác, chẳng hạn như Xin lưu ý rằng các truy vấn duy nhất được hỗ trợ là về các thuộc tính xe (ví dụ: Ngoài ra, mọi 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 giá trị số hoặc giá trị boolean, các giá trị phải được trích dẫn rõ ràng để được xử lý dưới dạng chuỗi (ví dụ: |
viewport |
Không bắt buộc. Bộ lọc giới hạn những phương tiện được đưa về là những xe có vị trí xác định gần đây nhất nằm trong khu vực hình chữ nhật mà khung nhìn xác định. |
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ả về được xác định bằng trường |
next_page_token |
Mã thông báo để truy xuất trang tiếp theo của 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 các thiết bị đó "trình tiết kiệm pin" đã bật. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
Enum | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
Vị trí PowerSaveMode không xác định |
LOCATION_MODE_NO_CHANGE |
Trình tiết kiệm pin sẽ không bị ảnh hưởng bởi trình tiết kiệm pin hoặc trình tiết kiệm pin sẽ 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 bật trình tiết kiệm pin 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 |
Mọi trình cung cấp vị trí sẽ được cung cấp, nhưng chỉ nên cung cấp bản sửa lỗi vị trí cho các ứ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 tất cả các yêu cầu cho nhà cung cấp khi thiết bị không 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 hoặc Hệ thống định vị toàn cầu được hỗ trợ. |
NETWORK |
Có hỗ trợ GPS, mã trạm phát sóng hoặc điểm truy cập Wi-Fi. |
PASSIVE |
Mã 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í đường có nhiều khả năng nhất. |
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í được cung cấp từ các nguồn không phải là thiết bị di động chạy SDK trình điều khiển. 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ị đó. Vị trí được đánh dấu là CUSTOMER_supPLIED_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 các tín hiệu có sẵn. Chỉ có đầu ra. Giá trị này sẽ bị từ chối nếu được nhận 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 vị trí trên hệ điều hành của Apple. |
PolylineFormatType
Loại định dạng hình nhiều đường.
Enum | |
---|---|
UNKNOWN_FORMAT_TYPE |
Định dạng không được xác định hoặc không xác định. |
LAT_LNG_LIST_TYPE |
Danh sách google.type.LatLng . |
ENCODED_POLYLINE_TYPE |
Một hình nhiều đường được mã hoá bằng thuật toán nén hình nhiều đường. Tính năng giải mã chưa được hỗ trợ. |
PowerSource
Loại bộ sạc đang được sử dụng để sạc pin.
Enum | |
---|---|
UNKNOWN_POWER_SOURCE |
Nguồn điện không xác định. |
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 |
Chưa cắm pin. |
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 đang được báo cáo. Đây thường là các mã (ví dụ: mã phiên) của những hoạt động đặt phòng 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 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, theo mặc định, API sẽ sử dụng ON_DEMAND_RIDESHARING_AND_DELIVERIES là loại giải pháp đầu tiên được hỗ trợ. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
Giải pháp là một chuyến đ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ả 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 truy cập vào http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu bạn không chỉ định ngôn ngữ nào, thì câu trả lời có thể bằng bất kỳ ngôn ngữ nào, với lựa chọn ưu tiên là 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 khu vực bắt nguồn yêu cầu. 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 hệ điều hành mà SDK gọi đang chạy. Ví dụ về giá trị trường: |
device_model |
Kiểu máy của 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 thông qua SDK gọi, chỉ áp dụng đối với 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 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 từ Android. |
IOS |
Yêu cầu đến từ iOS. |
WEB |
Yêu cầu này đến từ trên web. |
SdkType
Các loại SDK có thể có.
Enum | |
---|---|
SDK_TYPE_UNSPECIFIED |
Giá trị mặc định. Giá trị này được sử dụng nếu sdk_type bị bỏ qua. |
CONSUMER |
SDK gọi là Người tiêu dùng. |
DRIVER |
SDK gọi là Trình điều khiển. |
JAVASCRIPT |
SDK gọi là JavaScript. |
SearchTripsRequest
Thông báo yêu cầu SearchTrips.
Trường | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
parent |
Bắt buộc. Phải ở định dạng |
vehicle_id |
Xe được 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 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ả trả về. |
page_token |
Hãy thiết lập thành một giá trị được trả về trước đó 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
Thông báo phản hồi của SearchTrips.
Trường | |
---|---|
trips[] |
Danh sách các chuyến đi của xe được yêu cầu. |
next_page_token |
Chuyển mã thông báo này vào SearchTripsRequest đến trang thông qua kết quả của 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òn kết quả nào nữa, danh sách chuyến đi sẽ bị trống. |
SearchVehiclesRequest
Tin nhắn yêu cầu SearchVehicles
.
Trường | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
parent |
Bắt buộc. Phải ở định dạng |
pickup_point |
Bắt buộc. Điểm đón để 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 nhận hàng. Chúng tôi chỉ trả lại những phương tiện 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. Cho biết số lượng xe tối đa cần trả về. 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 xem xét cho một chuyến đi. Giá trị này phải lớn hơn hoặc bằng 1. Người lái xe không được xem xét trong giá trị hạn mức. |
trip_types[] |
Bắt buộc. Đại diện cho loại chuyến đi đề xuất. Phải bao gồm đúng một loại. |
maximum_staleness |
Chỉ 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 nhất định. Các phương tiện tại chỗ vẫn truyền dữ liệu 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, thì máy chủ sẽ sử dụng năm phút làm giá trị mặc định. |
vehicle_types[] |
Bắt buộc. Giới hạn tìm kiếm 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 thành 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 của các trường
Giới hạn tìm kiếm chỉ cho những xe có các thuộc tính được chỉ định. Trường này là phép toán kết hợp/VÀ. Bạn chỉ được thêm tối đa 50 thuộc tính bắt buộc. Giá trị này khớp với số lượng thuộc tính tối đa được phép trên một chiếc xe. |
required_one_of_attributes[] |
Giới hạn tìm kiếm chỉ cho 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ư
Giới hạn tìm kiếm chỉ cho những xe có tất cả các thuộc tính trong |
order_by |
Bắt buộc. Chỉ định tiêu chí thứ tự mong muốn cho các kết quả. |
include_back_to_back |
Thuộc tính này cho biết liệu những phương tiện có một chuyến đi đang hoạt động có đủ điều kiện cho lượt tìm kiếm này hay không. Trường này chỉ được dùng khi bạn không 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 |
Thuộc tính này cho biết liệu phương tiện có 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. Giá trị này phải được đặt thành giá trị khác với |
filter |
Không bắt buộc. Cụm từ tìm kiếm để áp dụng khi tìm kiếm xe. Hãy xem http://aip.dev/160 để biết 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 cùng với các điều kiện ràng buộc khác, chẳng hạn như Xin lưu ý rằng các truy vấn duy nhất được hỗ trợ là về các thuộc tính xe (ví dụ: Ngoài ra, mọi 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 giá trị số hoặc giá trị boolean, các giá trị phải được trích dẫn rõ ràng để được xử lý dưới dạng chuỗi (ví dụ: |
CurrentTripsPresent
Cho biết các loại quy định hạn chế đối với chuyến đi hiện tại của một xe.
Enum | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
Tình trạng xe có cung cấp chuyến đ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 |
Những xe có tối đa 5 chuyến đi hiện tại và 10 điểm tham chiếu sẽ đượ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 trùng khớp xe không xác định hoặc không nhận dạng được. |
PICKUP_POINT_ETA |
Thứ tự 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 quãng đường lái xe đến điểm đón. |
DROPOFF_POINT_ETA |
Thứ tự tăng dần theo thời gian lái xe đến điểm trả khách. Bạn chỉ có thể sử dụng đơn đặt hàng này nếu điểm trả khách được chỉ định trong yêu cầu. |
PICKUP_POINT_STRAIGHT_DISTANCE |
Thứ tự 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í trùng khớp đã định cấu hình. Chi phí trùng khớp được định nghĩa là phép tính có trọng số giữa khoảng cách theo đường thẳng và giờ đến dự kiến. Trọng lượng được đặt theo 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 cần sửa đổi các trọng số này cho dự án của bạn. |
SearchVehiclesResponse
SearchVehicles
tin nhắn phản hồi.
Trường | |
---|---|
matches[] |
Danh sách xe đáp ứng tiêu chí |
SpeedReadingInterval
Chỉ báo mật độ lưu lượng truy cập trên đoạn tiếp giáp của con đường. 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ị không), SpeedReadingInterval xác định 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ỉ mục bắt đầu của khoảng này trong đường dẫn. Trong JSON, khi chỉ mục là 0, trường sẽ dường như không được điền. |
end_polyline_point_index |
Chỉ mục kết thúc của khoảng này trong đường dẫn. Trong JSON, khi chỉ mục là 0, trường sẽ dường như không được điền. |
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. |
StopLocation
Vị trí thực tế nơi dừng (nhận/trả xe).
Trường | |
---|---|
point |
Bắt buộc. Mô tả vị trí thực tế. |
timestamp |
Cho biết thời điểm dừng. |
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 một điểm tham chiếu chuyến đi. |
terminal_point_id |
Không dùng nữa: Thay vào đó, hãy chỉ định trường |
access_point_id |
Không dùng nữa: Thay vào đó, hãy chỉ định trường |
trip_id |
Không dùng nữa. |
terminal_location_type |
Không dùng nữa: |
TerminalPointId
Không dùng nữa: TerminalPoint không còn được hỗ trợ trong Fleet Engine nữa. Thay vào đó, hãy sử dụng TerminalLocation.point
.
Trường | |
---|---|
value |
Không dùng nữa. |
Trường kết hợp Id . Không dùng nữa. Id chỉ có thể là một trong những trạng thái sau đây: |
|
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 thể hiện tốc độ giao thông cho tất cả các khu vực trên một đoạn đường của khách hàng. |
Chuyến đi
Siêu dữ liệu của chuyến đi.
Trường | |
---|---|
name |
Chỉ có đầu ra. Ở định dạng "providers/{provider}/trips/{trips}" |
vehicle_id |
Mã của xe thực hiện 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 sẽ đến lấy hàng. |
actual_pickup_point |
Chỉ nhập. Vị trí thực tế, thời điểm và địa điểm đón khách hàng. Trường này là để 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ế của tài xế đến điểm đón. Trường này dùng để nhà cung cấp cung cấp ý kiến phản hồi về thông tin thực tế về thời gian đến tại điểm đến lấy hàng. |
pickup_time |
Chỉ có đầu ra. Thời gian dự kiến trong tương lai khi(các) tài xế sẽ được đón hoặc thời gian thực tế khi xe đó được đón. |
intermediate_destinations[] |
Các điểm dừng trung gian để đáp ứng yêu cầu của chuyến đi (ngoài đón và trả khách). 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 cuối cùng |
intermediate_destination_index |
Khi |
actual_intermediate_destination_arrival_points[] |
Chỉ nhập. Thời gian và vị trí thực tế lúc tài xế đến một điểm đến trung gian. Trường này dùng để nhà cung cấp cung cấp 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à địa điểm 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ùng để nhà cung cấp đưa ra ý kiến phản hồi về thông tin đến lấy hàng thực tế tại các điểm đến trung gian. |
dropoff_point |
Vị trí mà khách hàng cho biết họ sẽ trả xe. |
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ỏ xe. Trường này là để nhà cung cấp đưa ra ý kiến phản hồi về thông tin thực tế về việc bỏ ngang. |
dropoff_time |
Chỉ có đầu ra. Thời gian dự kiến trong tương lai khi(các) tài xế sẽ xuất phát tại điểm đến cuối cùng hoặc thời gian thực tế khi họ trả xe. |
remaining_waypoints[] |
Chỉ có đầu ra. Toàn bộ đường đi từ vị trí hiện tại đến điểm trả xe, tính toàn bộ. Lộ trình 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ợ việc sắp xếp các điểm tham chiếu theo cách thủ công cho chuyến đi. Tệp 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ả khách cho chuyến đi này. Nếu chuyến đi chưa được chỉ định cho một xe, 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 lối vào đầu tiên tạicòn lại_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 đã 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 tiêu dùng sử dụng. Tính năng giải mã chưa được hỗ trợ. |
current_route_segment_version |
Chỉ có đầu ra. Cho biết lần cuối cùng 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 tiêu dùng sử 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 tiêu dùng sử dụng. |
current_route_segment_traffic_version |
Chỉ có đầu ra. Cho biết lần cuối cùng Lưu ý: Trường này chỉ dành cho SDK trình điều khiển và SDK người tiêu dùng sử dụng. |
current_route_segment_end_point |
Chỉ có đầu ra. Điểm tham chiếu kết thúc |
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 đến đ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 từ khi dữ liệu Chuyến đi được trả về thời gian tại |
remaining_waypoints_version |
Chỉ có đầu ra. Cho biết lần gần nhất |
remaining_waypoints_route_version |
Chỉ có đầu ra. Cho biết lần cuối cùng |
number_of_passengers |
Bất biến. Cho biết số lượng hành khách trong chuyến đi này và không bao gồm tài xế. Xe phải còn trống chỗ để được trả lại trong phản hồi |
last_location |
Chỉ có đầu ra. Cho biết vị trí được báo cáo 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ủa các trường Chuyến đi được điền sẵn và cách thức diễn giải các trường này. |
TripStatus
Trạng thái của một 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 |
Người lái xe đã đến một điểm đến trung gian và đang chờ người lái. |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
Người lái xe đang trên đường đến một điểm đến trung gian (không phải điểm trả khách). |
ENROUTE_TO_DROPOFF |
Tài xế đã đón người lái và đang trên đường đến điểm đến tiếp theo. |
COMPLETE |
Tài xế đã được xuống xe và chuyến đi đã hoàn tất. |
CANCELED |
Tài xế, người đi xe hoặc nhà cung cấp dịch vụ đi chung xe đã huỷ chuyến đi trước khi bạn đến đón. |
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 nhận dạng được. |
SHARED |
Chuyến đi này có thể đi chung một phương tiện với các chuyến đi khác. |
EXCLUSIVE |
Chuyến đi chỉ dành riêng cho xe. |
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 ngữ cảnh. Chúng tôi có thể sẽ bổ sung 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ẽ đặt mặc định thành chế độ xem SDK. Để đảm bảo độ ổn định và được hỗ trợ, khách hàng nên chọn một TripView thay vì SDK . |
SDK |
Bao gồm các trường có thể không hiểu được hoặc không hỗ trợ được khi sử dụng 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 từ máy chủ đến máy chủ. |
TripWaypoint
Mô tả một điểm dừng trên tuyến đường của xe hoặc một điểm cuối 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 được liên kết với đ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 đi từ điểm tham chiếu trước đó đến điểm tham chiếu hiện tại. Không xác định cho điểm tham chiếu đầu tiên trong danh sách. Trường này chỉ được điền sẵn khi có yêu cầu. |
encoded_path_to_waypoint |
Đường dẫn đã 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 tiêu dùng sử dụng. Tính năng giải mã chưa được hỗ trợ. |
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 lưu lượng truy cập chỉ áp dụng cho khách hàng sử dụng Giải pháp gọi xe và giao hàng trên Nền tảng bản đồ của Google. |
distance_meters |
Khoảng cách từ điểm tham chiếu trước đó đến điểm tham chiếu hiện tại. Không xác định cho điểm tham chiếu đầu tiên trong danh sách. |
eta |
Thời gian đến dự kiến tại điểm tham chiếu này. Không xác định cho điểm tham chiếu đầu tiên trong danh sách. |
duration |
Thời gian đi từ điểm tham chiếu trước đó đến điểm này. Không xác định cho đ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 đề tiêu chuẩn của yêu cầu Fleet Engine. |
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 địa điểm này bằng cách sử dụ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ạ trường cho biết những trường nào trong Chuyến đi cần cập nhật. |
UpdateVehicleAttributesRequest
Tin nhắn yêu cầu UpdateVehicleAttributes
.
Trường | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
name |
Bắt buộc. Phải ở định dạng |
attributes[] |
Bắt buộc. Các thuộc tính của xe cần cập nhật. Những thuộc tính không được đề cập sẽ không được thay đổi hay xoá bỏ. |
UpdateVehicleAttributesResponse
UpdateVehicleAttributes
tin nhắn phản hồi.
Trường | |
---|---|
attributes[] |
Bắt buộc. Danh sách đầy đủ và cập nhật về các đặc điểm của xe, bao gồm cả các thuộc tính mới, đã thay đổi và chưa được chỉnh sửa. |
UpdateVehicleRequest
"Tin nhắn yêu cầu Cập nhật xe.
Trường | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
name |
Bắt buộc. Phải ở định dạng |
vehicle |
Bắt buộc. Các giá trị thực thể
Nếu bạn cập nhật trường Tương tự, bạn có thể cập nhật trường |
update_mask |
Bắt buộc. Một mặt nạ trường cho biết những trường nào 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 chiếc xe này. Định dạng là |
vehicle_state |
Trạng thái của 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 |
last_location |
Vị trí được báo cáo gần đây nhất của chiếc xe. |
maximum_capacity |
Tổng số hành khách trên xe này. 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. Một chiếc xe có thể có tối đa 100 thuộc tính và mỗi thuộc tính phải có một khoá duy nhất. |
vehicle_type |
Bắt buộc. Loại xe này. Có thể dùng để lọc phương tiện trong |
license_plate |
Thông tin về biển số xe của xe. |
route[] |
Không dùng nữa: Chuyển sang 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 định đi đến đ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 sử dụng. Tính năng giải mã chưa được hỗ trợ. |
current_route_segment_traffic |
Chỉ nhập. Fleet Engine sử dụng thông tin này để cải thiện tính năng chia sẻ hành trình. Lưu ý: Trường này chỉ dành cho SDK trình điều khiển sử dụng. |
current_route_segment_version |
Chỉ có đầu ra. Thời điểm đặt |
current_route_segment_end_point |
Điểm tham chiếu kết thúc |
remaining_distance_meters |
Quãng đường lái xe còn lại của |
eta_to_first_waypoint |
Giờ đến dự kiến cho mục đầu tiên trong trường Khi cập nhật một chiếc xe, |
remaining_time_seconds |
Chỉ nhập. Thời gian lái xe còn lại cho Khi cập nhật một chiếc 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 tài xế có chấp nhận các chuyến đi khứ hồi hay không. Nếu là |
navigation_status |
Trạng thái đi theo chỉ dẫn 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 xe.
Trường | |
---|---|
category |
Danh mục loại xe |
Danh mục
Danh mục loại xe
Enum | |
---|---|
UNKNOWN |
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 |
Một chiếc ô tô. |
TAXI |
Bất kỳ phương tiện nào hoạt động như taxi (thường được cấp phép hoặc thuộc diện quản lý). |
TRUCK |
Thông thường là xe có dung tích chứa lớn. |
TWO_WHEELER |
Xe mô tô, xe máy hoặc các phương tiện 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 chuyên chở người, thường đi bộ hoặc chạy dọc theo đườ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ị. "key:value" độ dài chuỗi 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 kết 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 đây: |
|
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 được nhập bằng Boolean. |
number_value |
Giá trị thuộc tính được nhập hai lần. |
VehicleAttributeList
Loại dữ liệu danh sách danh sách cho các thuộc tính xe.
Trường | |
---|---|
attributes[] |
Danh sách các thuộc tính trong tập hợp này. |
VehicleLocation
Vị trí, tốc độ và hướng 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, vị trí của xe là vị trí GPS. Khi bạn nhận được thông tin đó trong phản hồi, vị trí của xe có thể là vị trí GPS, vị trí bổ sung hoặc một số vị trí ước đoán khác. Nguồn được chỉ định trong |
horizontal_accuracy |
Không dùng nữa: Chuyển sang dùng |
latlng_accuracy |
Độ chính xác theo bán kính là |
heading |
Hướng xe đang di chuyển theo độ. 0 biểu thị Bắc. Phạm vi hợp lệ là [0.360). |
bearing_accuracy |
Không dùng nữa: Chuyển sang dùng |
heading_accuracy |
Độ chính xác của |
altitude |
Cao độ tính bằng mét so với WGS84. |
vertical_accuracy |
Không dùng nữa: Chuyển sang dùng |
altitude_accuracy |
Độ chính xác là |
speed_kmph |
Tốc độ của xe tính bằng kilomet mỗi giờ. Không dùng nữa: Chuyển sang dùng |
speed |
Tốc độ của xe tính bằng mét/giây |
speed_accuracy |
Độ chính xác là |
update_time |
Thời điểm cảm biến báo cáo |
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 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ừ lần đầu tiên vị trí này được gửi đến máy chủ. Giá trị này sẽ bằng 0 cho 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í đã lỗi thời hay chưa. |
raw_location |
Vị trí thô của xe (chưa được xử lý bằng camera chụp ảnh trên đường). |
raw_location_time |
Dấu thời gian được liên kết với vị trí thô. |
raw_location_sensor |
Nguồn của 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: Chuyển sang dùng |
VehicleMatch
Chứa thông tin về xe và thông tin ước tính có liên quan cho một chiếc xe khớp với điểm của 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 đến điểm đón được chỉ định trong yêu cầu. Giá trị trống cho biết không tính toán thời gian đến dự kiến cho xe. Nếu |
vehicle_pickup_distance_meters |
Khoảng cách từ vị trí hiện tại của xe đến điểm đón khách được chỉ định trong yêu cầu, bao gồm cả mọi điểm đón hoặc trả xe trung gian cho những chuyến đi hiện có. Khoảng cách này bao gồm quãng đường lái xe (tuyến đường) được tính toán, cộng với khoảng cách đường thẳng giữa điểm cuối điều hướng 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 nhậ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 khách được chỉ định trong yêu cầu. |
vehicle_dropoff_eta |
Giờ đến dự kiến của toàn bộ xe đến điểm trả khách được chỉ định trong yêu cầu. Giờ đến dự kiến 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ả khách được chỉ định trong yêu cầu. Khoảng cách này chỉ nằm 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à khách hàng phải ghé thăm trước khi xe ghé thăm điểm đón hoặc điểm trả xe. Giá trị sẽ chỉ được điền khi |
trip_type |
Bắt buộc. Loại chuyến đi trong yêu cầu được dùng để tính giờ đến dự kiến cho đến điểm đón. |
vehicle_trips_waypoints[] |
Danh sách các điểm tham chiếu theo thứ tự dùng để tính toán thời gian đến dự kiến. Danh sách này bao gồm vị trí của xe, điểm đón của những chuyến đi đang hoạt động của chiếc xe đó và điểm đến lấy hàng được cung cấp trong yêu cầu. Danh sách trống cho biết không tính toán được thời gian đến dự kiến cho xe. |
vehicle_match_type |
Loại xe trùng khớp. |
requested_ordered_by |
Thứ tự yêu cầu sắp xếp xe trùng khớp. |
ordered_by |
Đơn đặt hàng thực tế được sử dụng cho xe này. Thông thường, giá trị này sẽ khớp với thuộc tính "order_by" khỏi yêu cầu; tuy nhiên, trong một số trường hợp nhất định (chẳng hạn như lỗi máy chủ nội bộ), bạn 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 xe không xác định |
EXCLUSIVE |
Chiếc xe này hiện chưa được chỉ định chuyến đi nào và có thể đi đến điểm đón. |
BACK_TO_BACK |
Xe hiện được chỉ định cho một chuyến đi nhưng có thể đi đến điểm đón sau khi bạn hoàn tất chuyến đi đang diễn ra. Giờ đến dự kiến và các phép tính khoảng cách có tính đến chuyến đi hiện tại. |
CARPOOL |
Xe có đủ sức chứa 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 diễn ra trước khi đến điểm đón. Giờ đến dự kiến và các phép tính khoảng cách có tính đến chuyến đi hiện tại. |
VehicleState
Trạng thái của Vehicle
.
Enum | |
---|---|
UNKNOWN_VEHICLE_STATE |
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 chấp nhận 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. |
ONLINE |
Xe đang chấp nhận các chuyến đi mới. |
VisualTrafficReportPolylineRendering
Mô tả cách khách hàng nên 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. Đoạn đường sẽ được hiển thị dọc theo hình nhiều đường. Các đoạn kéo dài được đảm bảo không chồng chéo và không nhất thiết phải kéo dài 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 nên áp dụng giá trị mặc định cho tuyến đường. |
RoadStretch
Một đoạn đường cần được hiển thị.
Trường | |
---|---|
style |
Bắt buộc. Kiểu nên áp dụng. |
offset_meters |
Bắt buộc. Kiểu phải được áp dụng trong khoảng thời gian |
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 |
Lưu lượng truy cập đang chậm lại. |
TRAFFIC_JAM |
Có tắc đường. |
Waypoint
Mô tả các điểm trung gian dọc theo một tuyến đường của 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 ước tính 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 không xác định. |
PICKUP_WAYPOINT_TYPE |
Điểm tham chiếu để nhận người lái hoặc vật phẩm. |
DROP_OFF_WAYPOINT_TYPE |
Các điểm tham chiếu để bỏ tay lái hoặc vật dụng. |
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. |