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. 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 ditampilkan akan memiliki |
tripTypes[] |
Membatasi respons untuk kendaraan yang mendukung setidaknya salah satu jenis perjalanan yang ditentukan. |
maximumStaleness |
Membatasi respons terhadap kendaraan yang telah mengirimkan pembaruan lokasi ke Fleet Engine dalam durasi yang ditentukan. Kendaraan tidak bergerak yang masih mengirimkan lokasinya tidak dianggap usang. Jika ada, harus berupa durasi positif yang valid. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
vehicleTypeCategories[] |
Wajib. Membatasi respons terhadap 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. Bidang ini merupakan operasi gabungan/DAN. Maksimum 50 requiredAttributes yang diizinkan. Jumlah ini cocok dengan jumlah atribut maksimum yang diizinkan di kendaraan. Setiap string berulang harus memiliki format "key:value". |
requiredOneOfAttributes[] |
Membatasi respons ke kendaraan dengan setidaknya satu atribut yang ditentukan di setiap |
requiredOneOfAttributeSets[] |
Serupa dengan
Membatasi respons ke kendaraan yang cocok dengan semua atribut dalam |
vehicleState |
Membatasi respons untuk 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 DAN dengan batasan lainnya, seperti Perhatikan bahwa satu-satunya kueri yang didukung adalah pada 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 kendaraan yang ditampilkan ke kendaraan 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. Jumlah total kendaraan yang cocok dengan kriteria permintaan di semua halaman. |
Area Tampilan
Area pandang lintang dan bujur, yang ditampilkan sebagai dua titik low
dan high
yang berlawanan secara diagonal. 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 satu titik tersebut.Jika
low.longitude
>high.longitude
, rentang bujur akan dibalik (area pandang melintasi garis bujur 180 derajat).Jika
low.longitude
= -180 derajat danhigh.longitude
= 180 derajat, area pandang akan menyertakan semua garis bujur.Jika
low.longitude
= 180 derajat danhigh.longitude
= -180 derajat, rentang bujur tersebut akan kosong.Jika
low.latitude
>high.latitude
, rentang lintang akan kosong.
low
dan high
harus diisi, dan kotak yang diwakili 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. Titik rendah area pandang. |
high |
Wajib. Titik tinggi area pandang. |