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.
Yêu cầu HTTP
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
parent |
Bắt buộc. Phải ở định dạng |
Tham số truy vấn
Tham số | |
---|---|
header |
Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine. |
pageSize |
Số lượng phương tiện tối đa cần trả lại. Giá trị mặc định: 100. |
pageToken |
Giá trị của |
minimumCapacity |
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ó |
tripTypes[] |
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. |
maximumStaleness |
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ệ. Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng " |
vehicleTypeCategories[] |
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. |
requiredAttributes[] |
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À. Cho phép tối đa 50 requiredAttributes. 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". |
requiredOneOfAttributes[] |
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 |
requiredOneOfAttributeSets[] |
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 |
vehicleState |
Hạn chế phản hồi đối với những xe có trạng thái xe này. |
onTripOnly |
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. |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
vehicles.list
tin nhắn phản hồi.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"vehicles": [
{
object ( |
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 |
nextPageToken |
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. |
totalSize |
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. |
Khung nhìn
Khung nhìn vĩ độ – kinh độ, được biểu thị bằng hai đường chéo đối diện điểm low
và high
. Một khung nhìn được xem là một khu vực đóng, tức là khu vực đó bao gồm cả ranh giới của nó. Giới hạn vĩ độ phải nằm trong khoảng từ -90 đến 90 độ và giới hạn kinh độ phải nằm trong khoảng từ -180 đến 180 độ. Có nhiều trường hợp như sau:
Nếu
low
=high
, khung nhìn chỉ bao gồm một điểm duy nhất đó.Nếu
low.longitude
>high.longitude
, phạm vi kinh độ bị đảo ngược (khung nhìn vượt qua đường kinh độ 180 độ).Nếu
low.longitude
= -180 độ vàhigh.longitude
= 180 độ, khung nhìn sẽ bao gồm tất cả các kinh độ.Nếu
low.longitude
= 180 độ vàhigh.longitude
= -180 độ, thì phạm vi kinh độ trống.Nếu
low.latitude
>high.latitude
, phạm vi vĩ độ bị trống.
Cả low
và high
đều phải được điền và không được để trống ô được thể hiện (như được chỉ định trong các định nghĩa ở trên). Chế độ xem trống sẽ dẫn đến lỗi.
Ví dụ: khung nhìn này bao quanh hoàn toàn Thành phố New York:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Biểu diễn dưới dạng JSON |
---|
{ "low": { object ( |
Trường | |
---|---|
low |
Bắt buộc. Điểm thấp của khung nhìn. |
high |
Bắt buộc. Điểm cao của khung nhìn. |