Menampilkan daftar kendaraan bernomor halaman yang terkait dengan penyedia yang cocok dengan opsi permintaan.
Permintaan HTTP
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
parent |
Wajib diisi. Harus dalam format |
Parameter kueri
Parameter | |
---|---|
header |
Header permintaan Fleet Engine standar. |
pageSize |
Jumlah maksimum kendaraan yang akan dikembalikan. Nilai default: 100. |
pageToken |
Nilai |
minimumCapacity |
Menentukan kapasitas minimum kendaraan yang diperlukan. Semua kendaraan yang dikembalikan akan memiliki |
tripTypes[] |
Membatasi respons untuk kendaraan yang mendukung setidaknya salah satu jenis perjalanan yang ditentukan. |
maximumStaleness |
Membatasi respons terhadap kendaraan yang telah mengirim pembaruan lokasi ke Fleet Engine dalam durasi yang ditentukan. Kendaraan statis yang masih mengirimkan lokasinya tidak dianggap usang. Jika ada, harus berupa durasi positif yang valid. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
vehicleTypeCategories[] |
Wajib diisi. Membatasi respons untuk kendaraan dengan salah satu kategori jenis yang ditentukan. |
requiredAttributes[] |
Pemanggil dapat membentuk operasi logika yang kompleks menggunakan kombinasi kolom
Membatasi respons ke kendaraan dengan atribut yang ditentukan. Kolom ini adalah operasi konjungsi/AND. Jumlah atribut wajib yang diizinkan adalah maksimum 50. Jumlah ini sesuai dengan jumlah atribut maksimum yang diizinkan di kendaraan. Setiap string berulang harus memiliki format "key:value". |
requiredOneOfAttributes[] |
Membatasi respons untuk kendaraan dengan setidaknya satu atribut yang ditentukan di setiap |
requiredOneOfAttributeSets[] |
Serupa dengan
Membatasi respons ke kendaraan yang cocok dengan semua atribut di |
vehicleState |
Membatasi respons terhadap kendaraan yang memiliki status kendaraan ini. |
onTripOnly |
Hanya kembalikan kendaraan dengan perjalanan saat ini. |
filter |
Opsional. Kueri filter yang akan diterapkan saat mencantumkan kendaraan. Lihat http://aip.dev/160 untuk mengetahui contoh sintaksis filter. Kolom ini dirancang untuk menggantikan kolom Filter ini berfungsi sebagai klausa AND dengan batasan lain, seperti Perhatikan bahwa satu-satunya kueri yang didukung adalah di atribut kendaraan (misalnya, 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, |
viewport |
Opsional. Filter yang membatasi pengembalian kendaraan ke mobil yang lokasi terakhirnya diketahui berada di area persegi panjang yang ditentukan oleh area pandang. |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons vehicles.list
.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"vehicles": [
{
object ( |
Kolom | |
---|---|
vehicles[] |
Kendaraan yang cocok dengan kriteria dalam permintaan. Jumlah maksimum kendaraan yang ditampilkan ditentukan oleh kolom |
nextPageToken |
Token untuk mengambil halaman kendaraan berikutnya, atau kosong jika tidak ada lagi kendaraan yang memenuhi kriteria permintaan. |
totalSize |
Wajib diisi. Total jumlah kendaraan yang cocok dengan kriteria permintaan di semua halaman. |
Area Pandang
Area tampilan lintang-bujur, direpresentasikan sebagai dua titik yang berlawanan secara diagonal dengan low
dan high
. Area pandang dianggap sebagai wilayah tertutup, yaitu menyertakan batasnya. Batas lintang harus berkisar antara -90 hingga 90 derajat inklusif, dan batas bujur harus berkisar antara -180 hingga 180 derajat inklusif. Berbagai kasus meliputi:
Jika
low
=high
, area pandang terdiri dari titik tunggal tersebut.Jika
low.longitude
>high.longitude
, rentang bujur dibalik (area pandang melintasi garis bujur 180 derajat).Jika
low.longitude
= -180 derajat danhigh.longitude
= 180 derajat, area pandang akan menyertakan semua bujur.Jika
low.longitude
= 180 derajat danhigh.longitude
= -180 derajat, rentang bujur kosong.Jika
low.latitude
>high.latitude
, rentang lintang kosong.
low
dan high
harus diisi, dan kotak yang direpresentasikan tidak boleh kosong (seperti yang ditentukan oleh definisi di atas). Area pandang kosong akan menghasilkan error.
Misalnya, area pandang ini sepenuhnya mencakup New York City:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Representasi JSON |
---|
{ "low": { object ( |
Kolom | |
---|---|
low |
Wajib diisi. Titik rendah area pandang. |
high |
Wajib diisi. Titik tinggi area pandang. |