Method: providers.vehicles.search

{
  "header": {
    object (RequestHeader)
  },
  "pickupPoint": {
    object (TerminalLocation)
  },
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "tripTypes": [
    enum (TripType)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleType)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeList)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeList)
    }
  ],
  "orderBy": enum (VehicleMatchOrder),
  "includeBackToBack": boolean,
  "tripId": string,
  "currentTripsPresent": enum (CurrentTripsPresent),
  "filter": string
}

object (RequestHeader)

Standart Fleet Engine istek başlığı.

object (TerminalLocation)

Zorunlu. Yakınında aranacak teslim noktası.

object (TerminalLocation)

Müşterinin istediği teslim yeri. tripTypes, TripType.SHARED içeriyorsa bu alan gereklidir.

integer

Zorunlu. Teslim alma noktası etrafındaki 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. Döndürülecek maksimum araç sayısını belirtir. Değer 1 ile 50 (dahil) arasında olmalıdır.

integer

Zorunlu. Bir gezi için dikkate alınan yolcu sayısını belirtir. Değer 1'den büyük veya 1'e eşit olmalıdır. Sürücü, kapasite değerinde dikkate alınmaz.

enum (TripType)

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

string (Duration format)

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

"s" ile biten ve en fazla dokuz kesir basamağı olan, saniye cinsinden bir 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 kategorisindeki 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 liste; requiredOneOfAttributes, listelere izin veren bir mesaj kullanır. Kombinasyonu, iki alan şu ifadenin birleştirilmesine 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 requiredFeature'a 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 özelliğinde belirtilen özelliklerden en az birine sahip araçlarla kısıtlar. Her listede, araç özelliklerden en az biriyle eşleşmelidir. Bu alan, her VehicleAttributeList içindeki kapsayıcı bir ayırma/VEYA işlemidir ve VehicleAttributeList koleksiyonu genelindeki bir bağlaç/VE işlemidir.

object (VehicleAttributeList)

requiredOneOfAttributeSets ek işlevler sağlar.

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

(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 araç tüm özelliklerle eşleşmelidir. Bu alan, VehicleAttributeList koleksiyonundaki her bir VehicleAttributeList için bir bağlaç/VE işlemi ve kapsayıcı ayırma/VEYA işlemidir.

enum (VehicleMatchOrder)

Zorunlu. Sonuçlar için istenen sıralama kriterini belirtir.

boolean

Bu, tek bir aktif seyahati olan araçların bu arama için uygun olup olmadığını gösterir. Bu alan yalnızca currentTripsPresent belirtilmediğinde kullanılır. currentTripsPresent belirtilmezse ve bu alan false olarak belirlenmişse, gezi atanmış araçlar arama sonuçlarından hariç tutulur. currentTripsPresent belirtilmemişse ve bu alan true olarak belirlenmişse arama sonuçları, durumu ENROUTE_TO_DROPOFF olan aktif bir geziye sahip araçları içerebilir. currentTripsPresent belirtildiğinde, bu alan doğru olarak ayarlanamaz.

Varsayılan değer: false.

string

Bu SearchVehicleRequest ile ilişkilendirilmiş geziyi gösterir.

enum (CurrentTripsPresent)

Bu sütun, aktif seyahatleri olan araçların bu arama için uygun olup olmadığını gösterir. tripType, SHARED içeriyorsa bu, 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 sayfasına göz atı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 belirtilmişse şu alanlar boş olmalıdır: requiredAttributes, requiredOneOfAttributes ve required_one_of_attributes_sets.

Bu filtre, minimumCapacity veya vehicleTypes gibi başka kısıtlamalarla birlikte bir AND ifadesi olarak çalışır.

Yalnızca araç özellikleri (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) üzerinde sorgu desteklenir. 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şı yalnızca dize karşılaştırmaları desteklenir. Sayı veya boole değerleriyle karşılaştırma yapmak için değerlerin dize olarak ele alınmaları için açık bir şekilde tırnak içine alınması gerekir (örneğin, attributes.<key> = "10" veya attributes.<key> = "true").