Method: providers.vehicles.searchFuzzed

Tidak digunakan lagi: Sebagai gantinya, gunakan vehicles.search.

Permintaan HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles:searchFuzzed

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Harus dalam format providers/{provider}. Penyedia harus berupa Project ID (misalnya, sample-cloud-project) dari Project Google Cloud tempat akun layanan yang melakukan panggilan ini menjadi anggota.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "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
}
Kolom
header

object (RequestHeader)

Header permintaan Fleet Engine standar.
pickupPoint

object (TerminalLocation)

Wajib. Titik penjemputan untuk menelusuri di dekat.
dropoffPoint

object (TerminalLocation)

Lokasi pengantaran yang diinginkan pelanggan. Kolom ini wajib diisi jika tripTypes berisi TripType.SHARED.
pickupRadiusMeters

integer

Wajib. Menentukan radius penelusuran kendaraan di sekitar titik penjemputan. Hanya kendaraan dalam radius penelusuran yang akan ditampilkan. Nilai harus antara 400 dan 10.000 meter (inklusif).
count

integer

Wajib. Menentukan jumlah maksimum kendaraan yang akan ditampilkan. Nilai harus antara 1 dan 50 (inklusif).
minimumCapacity

integer

Wajib. Menentukan jumlah penumpang yang dipertimbangkan untuk perjalanan. Nilai harus lebih besar atau sama dengan satu. Pengemudi tidak dipertimbangkan dalam nilai kapasitas.
tripTypes[]

enum (TripType)

Wajib. Mewakili jenis perjalanan yang diusulkan. Harus menyertakan satu jenis. UNKNOWN_TRIP_TYPE tidak diizinkan. Membatasi penelusuran hanya pada kendaraan yang dapat mendukung jenis perjalanan tersebut.
maximumStaleness

string (Duration format)

Membatasi penelusuran hanya pada kendaraan yang telah mengirimkan pembaruan lokasi ke Fleet Engine dalam durasi yang ditentukan. Kendaraan tidak bergerak yang masih mengirimkan lokasinya tidak dianggap usang. Jika kolom ini tidak disetel, server akan menggunakan lima menit sebagai nilai default.

Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
vehicleTypes[]

object (VehicleType)

Wajib. Membatasi penelusuran pada kendaraan dengan salah satu jenis yang ditentukan. Minimal satu jenis kendaraan harus ditentukan. VehicleType dengan kategori UNKNOWN tidak diizinkan.
requiredAttributes[]

object (VehicleAttribute)

Pemanggil dapat membentuk operasi logika yang kompleks menggunakan kombinasi kolom requiredAttributes, requiredOneOfAttributes, dan requiredOneOfAttributeSets.

requiredAttributes adalah daftar; requiredOneOfAttributes menggunakan pesan yang mengizinkan daftar. Kedua kolom tersebut memungkinkan komposisi ekspresi ini dalam kombinasi:

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

Membatasi penelusuran hanya untuk kendaraan dengan atribut yang ditentukan. Bidang ini merupakan operasi gabungan/DAN. Maksimum 50 requiredAttributes yang diizinkan. Jumlah ini cocok dengan jumlah atribut maksimum yang diizinkan di kendaraan.
requiredOneOfAttributes[]

object (VehicleAttributeList)

Membatasi penelusuran hanya untuk kendaraan tersebut dengan setidaknya satu atribut yang ditentukan di setiap VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan setidaknya salah satu atribut. Kolom ini merupakan operasi disjungsi/OR inklusif di setiap VehicleAttributeList dan operasi gabungan/AND di seluruh kumpulan VehicleAttributeList.
requiredOneOfAttributeSets[]

object (VehicleAttributeList)

requiredOneOfAttributeSets menyediakan fungsi tambahan.

Serupa dengan requiredOneOfAttributes, requiredOneOfAttributeSets menggunakan pesan yang mengizinkan daftar daftar, sehingga memungkinkan ekspresi seperti ini:

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

Membatasi penelusuran hanya untuk kendaraan dengan semua atribut dalam VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan semua atribut. Kolom ini merupakan operasi gabungan/DAN di setiap VehicleAttributeList dan operasi disjungsi/OR inklusif di seluruh kumpulan VehicleAttributeList.
orderBy

enum (VehicleMatchOrder)

Wajib. Menentukan kriteria pengurutan yang diinginkan untuk hasil.
includeBackToBack

boolean

Nilai ini menunjukkan apakah kendaraan dengan satu perjalanan aktif memenuhi syarat untuk penelusuran ini. Kolom ini hanya digunakan jika currentTripsPresent tidak ditentukan. Jika currentTripsPresent tidak ditentukan dan kolom ini adalah false, kendaraan dengan perjalanan yang ditetapkan akan dikecualikan dari hasil penelusuran. Jika currentTripsPresent tidak ditentukan dan kolom ini adalah true, hasil penelusuran dapat menyertakan kendaraan dengan satu perjalanan aktif yang memiliki status ENROUTE_TO_DROPOFF. Jika currentTripsPresent ditentukan, kolom ini tidak dapat ditetapkan ke benar (true).

Nilai default-nya adalah false.
tripId

string

Menunjukkan perjalanan yang terkait dengan SearchVehicleRequest ini.
currentTripsPresent

enum (CurrentTripsPresent)

Nilai ini menunjukkan apakah kendaraan dengan perjalanan aktif memenuhi syarat untuk penelusuran ini. Nilai ini harus ditetapkan ke selain CURRENT_TRIPS_PRESENT_UNSPECIFIED jika tripType menyertakan SHARED.
filter

string

Opsional. Kueri filter yang akan diterapkan saat menelusuri kendaraan. Lihat http://aip.dev/160 untuk mengetahui contoh sintaksis filter.

Kolom ini dirancang untuk menggantikan kolom requiredAttributes, requiredOneOfAttributes, dan required_one_of_attributes_sets. Jika nilai yang tidak kosong ditentukan di sini, kolom berikut harus kosong: requiredAttributes, requiredOneOfAttributes, dan required_one_of_attributes_sets.

Filter ini berfungsi sebagai klausa DAN dengan batasan lainnya, seperti minimumCapacity atau vehicleTypes.

Perhatikan bahwa satu-satunya kueri yang didukung adalah pada atribut kendaraan (misalnya, attributes.<key> = <value> atau attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Jumlah batasan maksimum yang diizinkan dalam kueri filter adalah 50.

Selain itu, semua atribut disimpan sebagai string, sehingga satu-satunya perbandingan yang didukung terhadap atribut adalah perbandingan string. Untuk membandingkan dengan nilai angka atau boolean, nilai harus dikutip secara eksplisit agar diperlakukan sebagai string (misalnya, attributes.<key> = "10" atau attributes.<key> = "true").

Isi respons

Jika berhasil, isi respons akan berisi instance SearchVehiclesResponse.