Method: providers.vehicles.search

object (RequestHeader)

Standart Fleet Engine istek başlığı.

object (TerminalLocation)

Zorunlu. Yakınında arama yapılacak teslim noktası.

object (TerminalLocation)

Müşterinin teslimat için tercih ettiği konum. tripTypes, TripType.SHARED içeriyorsa alan zorunludur.

integer

Zorunlu. Araç arama yarıçapını, teslim alma noktasının etrafında tanımlar. Yalnızca arama yarıçapı içindeki araçlar döndürülür. Değer 400 ile 10.000 metre (dahil) arasında olmalıdır.

integer

Zorunlu. Döndürülecek maksimum araç sayısını belirtir. Değer 1 ile 50 (başlangıç ve bitiş değerleri dahil) arasında olmalıdır.

integer

Zorunlu. Bir seyahat için dikkate alınan yolcu sayısını belirtir. Değer bir veya daha büyük olmalıdır. Sürücü, kapasite değerinde dikkate alınmaz.

enum (TripType)

Zorunlu. Önerilen seyahatin türünü temsil eder. Tam olarak bir tür içermelidir. UNKNOWN_TRIP_TYPE politikasına izin verilmiyor. Aramayı yalnızca bu seyahat türünü destekleyebilecek araçlarla sınırlandırır.

string (Duration format)

Aramayı yalnızca belirtilen süre içinde Fleet Engine'a konum güncellemesi gönderen araçlarla sınırlandırır. Hareketsiz olan ancak konumlarını hâlâ gönderen araçlar eski kabul edilmez. Bu alan ayarlanmazsa sunucu varsayılan değer olarak beş dakikayı kullanır.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

object (VehicleType)

Zorunlu. Aramayı, belirtilen türlerden birine sahip araçlarla sınırlar. En az bir araç türü belirtilmelidir. UNKNOWN kategorisine sahip VehicleTypes öğelerine 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 listetir; requiredOneOfAttributes, listelerin listesine izin veren bir mesaj kullanır. Bu iki alan birlikte kullanıldığında aşağıdaki ifadenin oluşturulmasına 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 sınırlandırır. Bu alan bir birleşim/VE işlemidir. En fazla 50 requiredAttributes değerine izin verilir. Bu sayı, bir araçta izin verilen maksimum özellik sayısıyla eşleşir.

object (VehicleAttributeList)

Aramayı yalnızca her VehicleAttributeList'te belirtilen özelliklerden en az birine sahip araçlarla sınırlandırır. Her listede bir araç, özelliklerden en az biriyle eşleşmelidir. Bu alan, her VehicleAttributeList öğesinde kapsayıcı bir ayrım/VEYA işlemi ve VehicleAttributeList koleksiyonu genelinde bir birleştirme/VE işlemidir.

object (VehicleAttributeList)

requiredOneOfAttributeSets ek işlevler sağlar.

requiredOneOfAttributes'e 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çinde tüm özelliklere sahip araçlarla sınırlandırır. Her listede bir araç, tüm özelliklerle eşleşmelidir. Bu alan, her VehicleAttributeList öğesinde bir birleşim/VE işlemi ve VehicleAttributeList koleksiyonunda kapsayıcı bir ayrım/VEYA işlemidir.

enum (VehicleMatchOrder)

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

boolean

Tek bir etkin seyahat içeren araçların bu arama için uygun olup olmadığını belirtir. Bu alan yalnızca currentTripsPresent belirtilmediğinde kullanılır. currentTripsPresent belirtilmemişse ve bu alan false ise atanmış seyahatleri olan araçlar arama sonuçlarından hariç tutulur. currentTripsPresent belirtilmemişse ve bu alan true ise arama sonuçları, ENROUTE_TO_DROPOFF durumu olan bir etkin seyahat içeren araçları içerebilir. currentTripsPresent belirtildiğinde bu alan doğru olarak ayarlanamaz.

Varsayılan değer: false.

string

Bu SearchVehicleRequest ile ilişkili geziyi belirtir.

enum (CurrentTripsPresent)

Bu, etkin seyahatleri olan araçların bu arama için uygun olup olmadığını belirtir. tripType, SHARED değerini içeriyorsa bu değer CURRENT_TRIPS_PRESENT_UNSPECIFIED dışında bir değere ayarlanmalıdır.

string

İsteğe bağlı. Araç araması yaparken uygulanacak 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 VE ifadesi olarak işlev görür.

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

Ayrıca tüm özellikler dize olarak depolandığından, özelliklerle ilgili olarak desteklenen tek karşılaştırma dize karşılaştırmasıdır. 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").