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 istek başlığı.
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum araç sayısı. Hizmet bu sayıdan daha az sonuç döndürebilir. Bu sayıyı belirtmezseniz, döndürülecek sonuç 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ı almak için bunu sağlamanız gerekir.

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

string

İsteğe bağlı. Yayınlama araçlarını listelemede uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 adresine bakın. Bir değer belirtmezseniz veya filtre için boş bir dize belirtirseniz tüm yayın araçları döndürülür.

deliveryVehicles.list için desteklenen sorguların yalnızca araç özelliklerinde (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) bulunduğunu unutmayın. Ayrıca, tüm özellikler dize olarak depolandığından, özelliklerle karşılaştırıldığında yalnızca dize karşılaştırmaları desteklenir. Sayı veya Boole değerleriyle karşılaştırmak için değerlerin dize olarak değerlendirilmesi amacıyla açıkça 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ı. Döndürülen araçları, bilinen son konumu görüntü alanı tarafından tanımlanan dikdörtgen alanda olan araçlarla 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 yayın araçları grubu. Hiçbir filtre belirtilmediğinde istek tüm yayın araçlarını döndürür. Başarılı bir yanıt da boş olabilir. Boş bir yanıt, istenen filtre ölçütlerini karşılayan yayın aracı bulunamadığını gösterir.
nextPageToken

string

Sonuçları listelemeyi sürdürmek için bu jetonu ListDeliveryVehiclesRequest parametresinde 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 toplam yayın aracı sayısı.

Görüntü alanı

Çapraz olarak karşı karşıya iki low ve high noktası olarak gösterilen bir enlem-boylam görüntü alanı. Görüntü alanı kapalı bir bölge olarak kabul edilir. Yani görüntü alanı, sınırını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (dahil) arasında olmalıdır. Çeşitli durumlar şunlardır:

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

  • low.longitude > high.longitude ise boylam aralığı tersine çevrilir (görüntü alanı 180 derece 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ştur.

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

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

Örneğin, bu görüntü alanı New York'u tamamen kapsıyor:

{ "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 alt noktası.
high

object (LatLng)

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