Method: providers.vehicles.search

object (RequestHeader)

Standart Fleet Engine istek başlığı.

object (TerminalLocation)

Zorunlu. Yakında aranacak teslim noktası.

object (TerminalLocation)

Müşterinin planladığı ayrılma konumu. tripTypes, TripType.SHARED değerini içeriyorsa bu alan gereklidir.

integer

Zorunlu. Teslim alma noktasının çevresindeki araç arama yarıçapını tanımlar. Yalnızca arama yarıçapındaki araçlar döndürülür. Değer 400 ile 10.000 metre (dahil) arasında olmalıdır.

integer

Zorunlu. Geri dönülecek maksimum araç sayısını belirtir. Değer 1 ile 50 (her ikisi de dahil) arasında olmalıdır.

integer

Zorunlu. Seyahat için değerlendirilen yolcu sayısını belirtir. Değer birden büyük veya bire eşit olmalıdır. Sürücü, kapasite değerinde dikkate alınmaz.

enum (TripType)

Zorunlu. Önerilen seyahat türünü gösterir. Tam olarak bir tür içermelidir. UNKNOWN_TRIP_TYPE politikasına izin verilmiyor. Aramayı yalnızca söz konusu gezi türünü destekleyebilen araçlarla kısıtlar.

string (Duration format)

Aramayı yalnızca belirtilen süre içinde Fleet Engine'e konum güncellemeleri gönderen araçlarla kısıtlar. Hareket halindeyken konumlarını aktarmaya devam eden sabit araçlar eski olarak kabul edilmez. Bu alan ayarlanmazsa sunucu, varsayılan değer olarak beş dakikayı kullanır.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

object (VehicleType)

Zorunlu. Aramayı, belirtilen türlerden birine sahip araçlarla kısıtlar. En az bir araç türü belirtilmelidir. UNKNOWN kategorisi olan VehicleType'lara izin verilmez.

object (VehicleAttribute)

Arayanlar requiredAttributes, requiredOneOfAttributes ve requiredOneOfAttributeSets alanlarının herhangi bir kombinasyonunu kullanarak karmaşık mantıksal işlemler oluşturabilir.

requiredAttributes bir listedir; requiredOneOfAttributes, liste listesine izin veren bir mesaj kullanıyor. Bu iki alan, birlikte bu ifadenin bileşimine olanak tanır:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

Aramayı yalnızca belirtilen özelliklere sahip araçlarla kısıtlar. Bu alan bir bağlaç/VE işlemidir. En fazla 50 requiredAttributes özelliğine izin verilir. Bu değer, bir araçta izin verilen maksimum özellik sayısıyla eşleşir.

object (VehicleAttributeList)

Aramayı yalnızca her VehicleAttributeList içinde belirtilen özelliklerden en az birine sahip araçlarla kısıtlar. Her listede, aracın özelliklerden en az biriyle eşleşmesi gerekir. Bu alan, her VehicleAttributeList içindeki kapsayıcı bir ayırma/VEYA işlemidir ve VehicleAttributeList koleksiyonundaki bir bağlantı/VE işlemidir.

object (VehicleAttributeList)

requiredOneOfAttributeSets ek işlevler sunar.

requiredOneOfAttributes işlevine benzer şekilde requiredOneOfAttributeSets, liste listesine izin veren bir mesaj kullanır ve aşağıdaki gibi ifadelere izin verir:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

Aramayı yalnızca VehicleAttributeList içindeki tüm özelliklere sahip araçlarla kısıtlar. Her listede bir aracın tüm özelliklerle eşleşmesi gerekir. Bu alan, her VehicleAttributeList içindeki bir bağlaç/VE işlemidir ve VehicleAttributeList koleksiyonundaki kapsayıcı ayırma/VEYA işlemidir.

enum (VehicleMatchOrder)

Zorunlu. Sonuçlar için istenen sıralama ölçütünü belirtir.

boolean

Bu özellik, tek bir etkin yolculuğu olan araçların bu arama için uygun olup olmadığını gösterir. Bu alan yalnızca currentTripsPresent belirtilmediyse kullanılır. currentTripsPresent belirtilmediğinde ve bu alan false olduğunda, atanmış gezilere sahip araçlar arama sonuçlarından hariç tutulur. currentTripsPresent belirtilmemişse ve bu alan true olduğunda arama sonuçları, ENROUTE_TO_DROPOFF durumundaki bir etkin yolculuğu olan araçları içerebilir. currentTripsPresent belirtildiğinde bu alan doğru olarak ayarlanamaz.

Varsayılan değer: false.

string

Bu SearchVehicleRequest ile ilişkili seyahati gösterir.

enum (CurrentTripsPresent)

Bu sütun, etkin gezileri olan araçların bu arama için uygun olup olmadığını gösterir. tripType, SHARED içeriyorsa bu değer CURRENT_TRIPS_PRESENT_UNSPECIFIED dışında bir değere ayarlanmalıdır.

string

İsteğe bağlı. Araç ararken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 adresine bakın.

Bu alan requiredAttributes, requiredOneOfAttributes ve required_one_of_attributes_sets alanlarının yerini alacak şekilde tasarlanmıştır. Burada boş olmayan bir değer belirtilirse şu alanlar boş olmalıdır: requiredAttributes, requiredOneOfAttributes ve required_one_of_attributes_sets.

Bu filtre, minimumCapacity veya vehicleTypes gibi diğer kısıtlamalarla birlikte bir AND yan tümcesi işlevi görür.

Yalnızca araç özelliklerinde (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) desteklenen sorguların desteklendiğini unutmayın. Bir filtre sorgusunda izin verilen maksimum kısıtlama sayısı 50'dir.

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").