Method: providers.vehicles.search

Menampilkan daftar kendaraan yang cocok dengan opsi permintaan.

Permintaan HTTP

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

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) 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 pencarian yang akan ditampilkan. Nilai harus antara 400 dan 10.000 meter (inklusif).

count

integer

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

minimumCapacity

integer

Wajib. Menentukan jumlah penumpang yang dipertimbangkan untuk sebuah perjalanan. Nilai harus lebih besar dari atau sama dengan satu. Driver tidak dipertimbangkan dalam nilai kapasitas.

tripTypes[]

enum (TripType)

Wajib. Menampilkan jenis perjalanan yang diusulkan. Harus menyertakan tepat satu jenis. UNKNOWN_TRIP_TYPE tidak diizinkan. Membatasi penelusuran hanya untuk kendaraan yang dapat mendukung jenis perjalanan tersebut.

maximumStaleness

string (Duration format)

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

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

vehicleTypes[]

object (VehicleType)

Wajib. Membatasi penelusuran ke kendaraan dengan salah satu jenis yang ditentukan. Setidaknya 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 daftar. Dalam kombinasi, kedua kolom tersebut memungkinkan komposisi ekspresi ini:

(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. Kolom ini adalah operasi konjungsi/AND. Maksimal 50 atribut wajib yang diizinkan. Jumlah ini sesuai dengan jumlah atribut maksimum yang diizinkan di kendaraan.

requiredOneOfAttributes[]

object (VehicleAttributeList)

Membatasi penelusuran hanya untuk kendaraan yang memiliki setidaknya satu atribut yang ditentukan di setiap VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan setidaknya salah satu atribut. Kolom ini adalah operasi disjungsi/OR inklusif di setiap VehicleAttributeList dan operasi konjungsi/AND di seluruh kumpulan VehicleAttributeList.

requiredOneOfAttributeSets[]

object (VehicleAttributeList)

requiredOneOfAttributeSets menyediakan fungsi tambahan.

Serupa dengan requiredOneOfAttributes, requiredOneOfAttributeSets menggunakan pesan yang mengizinkan daftar daftar, yang 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 yang memiliki semua atribut di VehicleAttributeList. Dalam setiap daftar, kendaraan harus cocok dengan semua atribut. Kolom ini adalah operasi konjungsi/AND 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

Detail 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 berupa 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)

Detail ini menunjukkan apakah kendaraan dengan perjalanan aktif memenuhi syarat untuk penelusuran ini. Nilai ini harus disetel ke sesuatu selain CURRENT_TRIPS_PRESENT_UNSPECIFIED jika tripType mencakup 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 AND dengan batasan lain, seperti minimumCapacity atau vehicleTypes.

Perhatikan bahwa satu-satunya kueri yang didukung adalah di 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

Pesan respons vehicles.search.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
Kolom
matches[]

object (VehicleMatch)

Daftar kendaraan yang cocok dengan kriteria SearchVehiclesRequest, diurutkan menurut kolom SearchVehiclesRequest.order_by.

VehicleAttributeList

Jenis data daftar-daftar untuk atribut kendaraan.

Representasi JSON
{
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ]
}
Kolom
attributes[]

object (VehicleAttribute)

Daftar atribut dalam koleksi ini.

VehicleMatchOrder

Menentukan urutan kecocokan kendaraan dalam respons.

Enum
UNKNOWN_VEHICLE_MATCH_ORDER Default, digunakan untuk pesanan kecocokan kendaraan yang tidak ditentukan atau tidak dikenal.
PICKUP_POINT_ETA Urutan menaik berdasarkan waktu mengemudi kendaraan ke lokasi penjemputan.
PICKUP_POINT_DISTANCE Urutan menaik berdasarkan jarak mengemudi kendaraan ke titik penjemputan.
DROPOFF_POINT_ETA Urutan menaik berdasarkan waktu mengemudi kendaraan ke titik penurunan. Urutan ini hanya dapat digunakan jika titik penurunan ditentukan dalam permintaan.
PICKUP_POINT_STRAIGHT_DISTANCE Urutan menaik dengan jarak garis lurus dari lokasi terakhir kendaraan ke titik penjemputan.
COST Urutan menaik menurut biaya pencocokan yang dikonfigurasi. Biaya kecocokan didefinisikan sebagai penghitungan tertimbang antara jarak garis lurus dan PWT. Bobot ditetapkan dengan nilai default dan dapat diubah per pelanggan. Hubungi dukungan Google jika bobot ini perlu dimodifikasi untuk project Anda.

CurrentTripsPresent

Menentukan jenis pembatasan pada perjalanan kendaraan saat ini.

Enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED Ketersediaan kendaraan dengan perjalanan yang ada diatur oleh kolom includeBackToBack.
NONE Kendaraan yang tidak memiliki perjalanan dapat muncul di hasil penelusuran. Jika nilai ini digunakan, includeBackToBack tidak boleh true.
ANY Kendaraan dengan maksimal 5 perjalanan saat ini dan 10 titik jalan akan disertakan dalam hasil penelusuran. Jika nilai ini digunakan, includeBackToBack tidak boleh true.

VehicleMatch

Berisi kendaraan dan estimasi terkait untuk kendaraan yang cocok dengan titik perjalanan aktif untuk kendaraan SearchVehiclesRequest.

Representasi JSON
{
  "vehicle": {
    object (Vehicle)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripType),
  "vehicleTripsWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "vehicleMatchType": enum (VehicleMatchType),
  "requestedOrderedBy": enum (VehicleMatchOrder),
  "orderedBy": enum (VehicleMatchOrder)
}
Kolom
vehicle

object (Vehicle)

Wajib. Kendaraan yang sesuai dengan permintaan.

vehiclePickupEta

string (Timestamp format)

PWT mengemudi kendaraan ke lokasi penjemputan yang ditentukan dalam permintaan. Nilai kosong menunjukkan kegagalan dalam menghitung PWT untuk kendaraan. Jika SearchVehiclesRequest.include_back_to_back adalah true dan kendaraan ini memiliki perjalanan yang aktif, vehiclePickupEta menyertakan waktu yang diperlukan untuk menyelesaikan perjalanan yang aktif saat ini.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

vehiclePickupDistanceMeters

integer

Jarak dari lokasi Kendaraan saat ini ke titik penjemputan yang ditentukan dalam permintaan, termasuk titik penjemputan atau pengantaran perantara untuk perjalanan yang ada. Jarak ini mencakup jarak mengemudi (rute) yang dihitung, ditambah jarak garis lurus antara titik akhir navigasi dan titik penjemputan yang diminta. (Jarak antara titik akhir navigasi dan titik pengambilan yang diminta biasanya kecil.) Nilai kosong menunjukkan error saat menghitung jarak.

vehiclePickupStraightLineDistanceMeters

integer

Wajib. Jarak garis lurus antara kendaraan dan titik penjemputan yang ditentukan dalam permintaan.

vehicleDropoffEta

string (Timestamp format)

PWT mengemudi kendaraan lengkap ke titik penurunan yang ditentukan dalam permintaan. PWT mencakup perhentian di setiap titik jalan sebelum dropoffPoint yang ditentukan dalam permintaan. Nilai hanya akan diisi jika titik penurunan ditentukan dalam permintaan. Nilai kosong menunjukkan error saat menghitung PWT.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

vehiclePickupToDropoffDistanceMeters

integer

Jarak mengemudi kendaraan (dalam meter) dari titik penjemputan ke titik penurunan yang ditentukan dalam permintaan. Jarak tersebut hanya antara dua titik dan tidak termasuk lokasi kendaraan atau titik lain yang harus dikunjungi sebelum kendaraan mengunjungi titik penjemputan atau titik penurunan. Nilai hanya akan diisi saat dropoffPoint ditentukan dalam permintaan. Nilai kosong menunjukkan kegagalan dalam menghitung jarak dari titik penjemputan ke titik penurunan yang ditentukan dalam permintaan.

tripType

enum (TripType)

Wajib. Jenis perjalanan permintaan yang digunakan untuk menghitung PWT ke lokasi penjemputan.

vehicleTripsWaypoints[]

object (Waypoint)

Daftar titik jalan yang diurutkan yang digunakan untuk menghitung PWT. Daftar tersebut mencakup lokasi kendaraan, titik penjemputan dari perjalanan aktif untuk kendaraan, dan titik penjemputan yang diberikan dalam permintaan. Daftar kosong menunjukkan kegagalan dalam menghitung PWT untuk kendaraan.

vehicleMatchType

enum (VehicleMatchType)

Kecocokan jenis kendaraan.

requestedOrderedBy

enum (VehicleMatchOrder)

Pesanan yang diminta untuk mengurutkan kecocokan kendaraan.

orderedBy

enum (VehicleMatchOrder)

Pesanan sebenarnya yang digunakan untuk kendaraan ini. Biasanya ini akan cocok dengan 'orderBy' bidang dari permintaan; Namun, dalam keadaan tertentu seperti error server internal, metode yang berbeda dapat digunakan (seperti PICKUP_POINT_STRAIGHT_DISTANCE).

Waypoint

Menjelaskan titik perantara di sepanjang rute untuk VehicleMatch dalam SearchVehiclesResponse. Konsep ini direpresentasikan sebagai TripWaypoint di semua endpoint lainnya.

Representasi JSON
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
Kolom
latLng

object (LatLng)

Lokasi titik jalan ini.

eta

string (Timestamp format)

Perkiraan waktu kendaraan akan tiba di titik jalan ini.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

VehicleMatchType

Kecocokan jenis kendaraan.

Enum
UNKNOWN Jenis pencocokan kendaraan tidak diketahui
EXCLUSIVE Kendaraan saat ini belum ditetapkan untuk perjalanan dan dapat melanjutkan ke titik penjemputan.
BACK_TO_BACK Kendaraan saat ini ditetapkan untuk perjalanan, tetapi dapat melanjutkan ke titik penjemputan setelah menyelesaikan perjalanan yang sedang berlangsung. Penghitungan PWT dan jarak memperhitungkan perjalanan yang ada.
CARPOOL Kendaraan memiliki kapasitas yang cukup untuk perjalanan bersama.
CARPOOL_BACK_TO_BACK Kendaraan akan menyelesaikan perjalanan aktif saat ini sebelum melanjutkan ke titik penjemputan. Penghitungan PWT dan jarak memperhitungkan perjalanan yang ada.