Method: providers.deliveryVehicles.list

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

Thông số
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.

Tham số truy vấn

Thông số
header

object (DeliveryRequestHeader)

Không bắt buộc. Tiêu đề của yêu cầu API phân phối chuẩn.
pageSize

integer

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

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi deliveryVehicles.list trước đó. Bạn phải cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho deliveryVehicles.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

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 deliveryVehicles.list là về các thuộc tính xe (ví dụ: attributes.<key> = <value> hoặc attributes.<key1> = <value1> AND attributes.<key2> = <value2>). 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ụ: attributes.<key> = "10" hoặc attributes.<key> = "true").

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 attribute.<KEY> <COMPARATOR> <VALUE>, ví dụ: attributes.foo = bar là 1 quy tắc hạn chế.
viewport

object (Viewport)

Không bắt buộc. Bộ lọc giới hạn những xe đượ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 (DeliveryVehicle)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Trường
deliveryVehicles[]

object (DeliveryVehicle)

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

string

Bạn có thể chuyển mã thông báo này vào ListDeliveryVehiclesRequest để tiếp tục liệt kê kết quả. Khi tất cả kết quả được trả về, trường này sẽ không nằm trong phản hồi hoặc sẽ là một chuỗi trống.
totalSize

string (int64 format)

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:

{ "thấp": { "vĩ độ": 40.477398, "kinh độ": -74.259087 }, "cao": { "vĩ độ": 40.91618, "kinh độ": -73.70018 } }

Biểu diễn dưới dạng JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Trường
low

object (LatLng)

Bắt buộc. Điểm thấp của khung nhìn.
high

object (LatLng)

Bắt buộc. Điểm cao của khung nhìn.