Method: providers.trips.search

Dapatkan semua perjalanan untuk kendaraan tertentu.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib diisi. 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)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
Kolom
header

object (RequestHeader)

Header permintaan Fleet Engine standar.

vehicleId

string

Kendaraan yang terkait dengan perjalanan dalam permintaan. Jika tidak ditentukan, perjalanan yang ditampilkan tidak berisi:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Jika ditetapkan ke benar (true), respons akan menyertakan Perjalanan yang memengaruhi rute pengemudi.

pageSize

integer

Jika tidak disetel, server akan menentukan jumlah hasil yang akan ditampilkan.

pageToken

string

Setel ini ke nilai yang sebelumnya ditampilkan di SearchTripsResponse untuk melanjutkan dari hasil sebelumnya.

minimumStaleness

string (Duration format)

Jika ditentukan, menampilkan perjalanan yang belum diperbarui setelah waktu (current - minimumStaleness).

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

Isi respons

pesan respons trips.search.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
Kolom
trips[]

object (Trip)

Daftar perjalanan untuk kendaraan yang diminta.

nextPageToken

string

Teruskan token ini di SearchTripsRequest ke halaman melalui hasil daftar. API menampilkan daftar perjalanan pada setiap panggilan, dan jika tidak ada hasil lagi, daftar perjalanan tetap kosong.