Trả về danh sách các xe đã 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.
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
Các tham số | |
---|---|
parent |
Bắt buộc. Phải ở định dạng |
Tham số truy vấn
Các tham số | |
---|---|
header |
Tiêu đề của yêu cầu Fleet Engine tiêu chuẩn. |
pageSize |
Số lượng xe tối đa có thể trả lại. Giá trị mặc định: 100. |
pageToken |
Giá trị của |
minimumCapacity |
Xác định dung tích tối thiểu bắt buộc của xe. Tất cả xe được trả lại sẽ có |
tripTypes[] |
Hạn chế phản hồi cho những xe hỗ trợ ít nhất một trong các loại chuyến đi đã chỉ định. |
maximumStaleness |
Giới hạn phản hồi đối với những xe đã gửi thông tin cập nhật vị trí cho Fleet Engine trong khoảng thời gian đã chỉ định. Những xe đứng yên vẫn đang truyền thông tin vị trí không bị coi là lỗi thời. Nếu có, phải là một khoảng thời gian dương hợp lệ. Thời lượng tính bằng giây có 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 cho các phương tiện thuộc một trong các danh mục loại được chỉ định. |
requiredAttributes[] |
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 của các trường
Hạn chế phản hồi cho các xe có các thuộc tính đã chỉ định. Trường này là một phép toán cộng/AND. Chỉ cho phép tối đa 50 thuộc tính requiredAttributes. Số lượng 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 có định dạng "key:value". |
requiredOneOfAttributes[] |
Hạn chế 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 |
requiredOneOfAttributeSets[] |
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 |
vehicleState |
Hạn chế phản hồi những phương tiện có trạng thái xe này. |
onTripOnly |
Chỉ trả lại những phương tiện 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 bộ lọc để áp dụng khi đăng thông tin xe. Hãy xem http://aip.dev/160 để xem 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 điều kiện ràng buộc khác, chẳng hạn như Xin lưu ý rằng chỉ những cụm từ tìm kiếm được hỗ trợ 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 đó, chỉ hỗ trợ so sánh 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. Bộ lọc giới hạn số xe được trả về cho những người 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 trong khung nhìn. |
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 ( |
Các trường | |
---|---|
vehicles[] |
Những xe đáp ứng 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 theo trường |
nextPageToken |
Mã thông báo để truy xuất trang xe tiếp theo, 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 tiêu chí yêu cầu trên tất cả các trang. |
Khung nhìn
Một khung nhìn kinh độ – vĩ độ, được biểu thị bằng hai điểm chéo đối diện low
và high
. Một khung nhìn được coi là một khu vực đóng, tức là khung nhìn bao gồm 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ó một số trường hợp như sau:
Nếu
low
=high
, khung nhìn bao gồm điểm duy nhất đó.Nếu
low.longitude
>high.longitude
, thì phạm vi kinh độ sẽ bị đảo ngược (khung nhìn cắt đường kinh độ 180 độ).Nếu
low.longitude
= -180 độ vàhigh.longitude
= 180 độ, thì 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 độ sẽ trống.Nếu
low.latitude
>high.latitude
, phạm vi vĩ độ trống.
Cả low
và high
đều phải được điền và không được để trống hộp được đại diện (như được chỉ định trong các định nghĩa ở trên). Nếu một khung nhìn trống sẽ gây ra lỗi.
Ví dụ: khung nhìn này bao quanh đầy đủ 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 ( |
Các 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. |