Method: providers.deliveryVehicles.list

Belirtilen filtreleme ölçütlerini karşılayan tüm DeliveryVehicle'leri 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ı. Geri dönülecek maksimum araç sayısı. Hizmet, bu sayıdan daha az değer döndürebilir. Bu sayıyı belirtmezseniz, döndürülecek sonuç sayısını sunucu belirler.

pageToken

string

İsteğe bağlı. Önceki deliveryVehicles.list çağrısından alınan bir 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ı. Teslimat araçları listelenirken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 adresine bakın. Değer belirtmezseniz 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ç özelliklerinde (ö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 karşı desteklenen karşılaştırmalar yalnızca dize karşılaştırmalarıdır. Sayı veya boole değerleriyle karşılaştırma yapabilmek için değerlerin dize olarak değerlendirilmeleri için açıkça tırnak içine alınması gerekir (ör. 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ı. Geri gelen araçları, bilinen son konumu görüntü alanının tanımladığı 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 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ş bir yanıt, istenen filtre ölçütlerini karşılayan hiçbir teslimat aracının bulunamadığını gösterir.

nextPageToken

string

Sonuçları listelemeye devam etmek için bu jetonu ListDeliveryVehiclesRequest uygulamasında aktarabilirsiniz. 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 yayınlama araçlarının toplam sayısı.

Görüntü alanı

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

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

  • Eğer low.longitude > high.longitude ise, boylam aralığı tersine ç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.

  • Eğer low.latitude > high.latitude, enlem aralığı boş.

Hem low hem de high doldurulmalı ve gösterilen kutu (yukarıdaki tanımlarda belirtildiği gibi) boş bırakılamaz. Boş görüntü alanı hatayla sonuçlanır.

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

{ &quot;low&quot;: { &quot;latitude&quot;: 40.477398, &quot;longitude&quot;: -74.259087 }, &quot;high&quot;: { &quot;latitude&quot;: 40.91618, &quot;longitude&quot;: -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ı.