Method: providers.deliveryVehicles.list

Belirtilen filtreleme ölçütlerini karşılayan tüm DeliveryVehicle öğelerini alır.

HTTP isteği

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.

Sorgu parametreleri

Parametreler
header

object (DeliveryRequestHeader)

İsteğe bağlı. Standart Delivery API isteği başlığı.
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum araç sayısı. Hizmet bu sayıdan daha azını döndürebilir. Bu sayıyı belirtmezseniz, döndürülecek sonuçların sayısını sunucu belirler.
pageToken

string

İsteğe bağlı. Önceki bir deliveryVehicles.list çağrısından alınan sayfa jetonu. Sonraki sayfayı alabilmek için bu bilgiyi sağlamanız gerekir.

Sayfalara ayırma sırasında deliveryVehicles.list için sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
filter

string

İsteğe bağlı. Teslimat araçları listelenirken uygulanacak bir filtre sorgusudur. Filtre söz dizimi örnekleri için http://aip.dev/160 adresine bakın. Değer belirtmez veya filtre için boş bir dize belirtirseniz tüm teslimat araçları döndürülür.

deliveryVehicles.list için desteklenen sorguların yalnızca araç özellikleri (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) olduğunu unutmayın. Ayrıca, tüm özellikler dize olarak depolanır. Bu nedenle, özelliklere göre yalnızca dize karşılaştırmaları desteklenir. Sayı veya boole değerleriyle karşılaştırmak için değerlerin dize olarak ele alınmak üzere açık bir şekilde tırnak içine alınması gerekir (örneğin, attributes.<key> = "10" veya attributes.<key> = "true").

Bir filtre sorgusunda izin verilen maksimum kısıtlama sayısı 50'dir. Kısıtlama, attribute.<KEY> <COMPARATOR> <VALUE> biçimindeki sorgunun bir parçasıdır. Örneğin attributes.foo = bar, 1 kısıtlamadır.
viewport

object (Viewport)

İsteğe bağlı. Bilinen son konumu görüntü alanı tarafından tanımlanan dikdörtgen alanda bulunan araçların döndürüldüğü araçları sınırlayan bir filtre.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

deliveryVehicles.list yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "deliveryVehicles": [
    {
      object (DeliveryVehicle)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Alanlar
deliveryVehicles[]

object (DeliveryVehicle)

İstenen filtreleme ölçütlerini karşılayan teslimat araçları grubu. Filtre belirtilmediğinde istek, tüm teslimat araçlarını döndürür. Başarılı bir yanıt da boş olabilir. Boş yanıt, istenen filtre ölçütlerini karşılayan teslimat aracının bulunamadığını gösterir.
nextPageToken

string

Sonuçları listelemeye devam etmek için bu jetonu ListDeliveryVehiclesRequest içinde iletebilirsiniz. Tüm sonuçlar döndürüldüğünde bu alan yanıtta yer almaz veya boş bir dize olur.
totalSize

string (int64 format)

Tüm sayfalarda istek ölçütleriyle eşleşen teslimat araçlarının toplam sayısı.

Görüntü alanı

low ve high punto karşısında çapraz olarak iki dikey olarak gösterilen enlem-boylam görüntü alanı. Bir görüntü alanı, kapalı bir bölge olarak kabul edilir, yani sınırlarını içerir. Enlem sınırları -90 ile 90 derece dahil, boylam sınırları ise -180 ila 180 derece (bu değerler dahil) aralığında olmalıdır. Bazı durumlar şunlardır:

  • low = high ise görüntü alanı bu tek noktadan oluşur.

  • low.longitude > high.longitude ise boylam aralığı ters çevrilir (görüntü alanı 180 derecelik boylam çizgisini geçer).

  • low.longitude = -180 derece ve high.longitude = 180 derece ise görüntü alanı tüm boylamları içerir.

  • low.longitude = 180 derece ve high.longitude = -180 derece ise boylam aralığı boş olur.

  • low.latitude > high.latitude ise enlem aralığı boş olur.

Hem low hem de high doldurulmalıdır ve gösterilen kutu boş olamaz (yukarıdaki tanımlarda belirtildiği gibi). Boş görüntü alanı hataya neden olur.

Örneğin, bu görüntü alanı New York City'yi tamamen kapsar:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON gösterimi 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Alanlar
low

object (LatLng)

Zorunlu. Görüntü alanının düşük noktası.
high

object (LatLng)

Zorunlu. Görüntü alanının yüksek noktası.