Lấy tất cả DeliveryVehicle
đáp ứng tiêu chí lọc đã chỉ định.
Yêu cầu HTTP
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles
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 |
Không bắt buộc. Tiêu đề của yêu cầu API phân phối chuẩn. |
pageSize |
Không bắt buộc. Số lượng phương tiện tối đa cần trả lại. Dịch vụ có thể trả về ít hơn con số này. Nếu bạn không chỉ định số này, thì máy chủ sẽ xác định số lượng kết quả cần trả về. |
pageToken |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
filter |
Không bắt buộc. Cụm từ tìm kiếm để áp dụng khi đăng thông tin về xe giao hàng. Hãy xem http://aip.dev/160 để biết ví dụ về cú pháp bộ lọc. Nếu bạn không chỉ định giá trị hoặc nếu bạn chỉ định một chuỗi trống cho bộ lọc, thì tất cả xe giao hàng đều sẽ bị trả về. Xin lưu ý rằng các truy vấn duy nhất được hỗ trợ cho Số lượng giới hạn tối đa được phép trong một truy vấn bộ lọc là 50. Quy định hạn chế là một phần trong truy vấn của biểu mẫu |
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
Tin nhắn phản hồi của deliveryVehicles.list
.
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 |
---|
{
"deliveryVehicles": [
{
object ( |
Trường | |
---|---|
deliveryVehicles[] |
Nhóm phương tiện giao hàng đáp ứng các tiêu chí lọc được yêu cầu. Khi bạn không chỉ định bộ lọc, yêu cầu sẽ trả về tất cả xe giao hàng. Bạn cũng có thể để trống một phản hồi thành công. Phản hồi trống cho biết không tìm thấy xe giao hàng nào đáp ứng tiêu chí bộ lọc được yêu cầu. |
nextPageToken |
Bạn có thể chuyển mã thông báo này vào |
totalSize |
Tổng số xe giao hàng đáp ứng 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. |