REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

Hanya output. Nama unik untuk kendaraan ini. Formatnya adalah providers/{provider}/vehicles/{vehicle}.

enum (VehicleState)

Status kendaraan.

enum (TripType)

Jenis perjalanan yang didukung oleh kendaraan ini.

string

Hanya output. Daftar tripId untuk perjalanan yang saat ini ditetapkan ke kendaraan ini.

object (VehicleLocation)

Lokasi kendaraan yang terakhir dilaporkan.

integer

Jumlah total penumpang yang dapat diangkut kendaraan ini. Driver tidak dipertimbangkan dalam nilai ini. Nilai ini harus lebih besar dari atau sama dengan satu.

object (VehicleAttribute)

Daftar atribut kendaraan. Kendaraan dapat memiliki maksimal 100 atribut, dan setiap atribut harus memiliki kunci yang unik.

object (VehicleType)

Wajib. Jenis kendaraan ini. Dapat digunakan untuk memfilter kendaraan dalam hasil vehicles.search. Juga memengaruhi PWT dan penghitungan rute.

object (LicensePlate)

Informasi pelat nomor untuk kendaraan.

object (TerminalLocation)

Tidak digunakan lagi: Sebagai gantinya, gunakan Vehicle.waypoints.

string

Polyline yang menentukan rute yang ingin diambil aplikasi pengemudi ke titik jalan berikutnya. Daftar ini juga ditampilkan di Trip.current_route_segment untuk semua perjalanan aktif yang ditetapkan ke kendaraan.

Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK. Dekode belum didukung.

object (TrafficPolylineData)

Hanya input. Fleet Engine menggunakan informasi ini untuk meningkatkan kualitas berbagi perjalanan. Catatan: Kolom ini hanya ditujukan untuk digunakan oleh Driver SDK.

string (Timestamp format)

Hanya output. Waktu saat currentRouteSegment disetel. Data ini dapat disimpan oleh klien dan diteruskan dalam permintaan vehicles.get mendatang untuk mencegah rute yang kembali yang tidak berubah.

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

object (TripWaypoint)

Titik jalan tempat currentRouteSegment berakhir. Ini dapat disediakan oleh pengemudi pada panggilan vehicles.update sebagai titik jalan perjalanan lengkap, LatLng titik jalan, atau sebagai LatLng terakhir dari currentRouteSegment. Fleet Engine kemudian akan melakukan yang terbaik untuk berinterpolasi dengan titik jalan sebenarnya jika tidak ditentukan sepenuhnya. Kolom ini diabaikan dalam panggilan vehicles.update kecuali jika currentRouteSegment juga ditentukan.

integer

Jarak mengemudi yang tersisa untuk currentRouteSegment. Nilai ini juga ditampilkan di Trip.remaining_distance_meters untuk semua perjalanan aktif yang ditetapkan ke kendaraan. Nilai tidak ditentukan jika kolom currentRouteSegment kosong.

string (Timestamp format)

PWT ke entri pertama di kolom waypoints. Nilai tidak ditentukan jika kolom waypoints kosong atau kolom Vehicle.current_route_segment kosong.

Saat mengupdate kendaraan, remainingTimeSeconds akan lebih diprioritaskan daripada etaToFirstWaypoint dalam permintaan yang sama.

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

integer

Input saja. Sisa waktu mengemudi untuk currentRouteSegment. Nilai tidak ditentukan jika kolom waypoints kosong atau kolom Vehicle.current_route_segment kosong. Nilai ini harus cocok dengan etaToFirstWaypoint - current_time jika semua pihak menggunakan jam yang sama.

Saat mengupdate kendaraan, remainingTimeSeconds akan lebih diprioritaskan daripada etaToFirstWaypoint dalam permintaan yang sama.

object (TripWaypoint)

Titik jalan yang tersisa yang ditetapkan untuk Kendaraan ini.

string (Timestamp format)

Hanya output. Terakhir kali kolom waypoints diperbarui. Klien harus meng-cache nilai ini dan meneruskannya di GetVehicleRequest untuk memastikan kolom waypoints hanya ditampilkan jika diperbarui.

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

boolean

Menunjukkan apakah pengemudi menerima perjalanan bolak-balik. Jika true, vehicles.search dapat menyertakan kendaraan meskipun saat ini kendaraan tersebut ditetapkan ke perjalanan. Nilai defaultnya adalah false.

enum (NavigationStatus)

Status navigasi kendaraan.

object (DeviceSettings)

Hanya input. Informasi tentang setelan di perangkat seluler yang digunakan oleh pengemudi.

{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}

string

Kunci atribut. Kunci tidak boleh berisi karakter titik dua (:).

string

Nilai atribut.

string

Nilai atribut dengan jenis string.

Catatan: Ini sama dengan kolom value yang pada akhirnya tidak akan digunakan lagi. Untuk metode pembuatan atau update, kedua kolom dapat digunakan, tetapi sangat direkomendasikan untuk menggunakan stringValue. Jika stringValue dan value ditetapkan, keduanya harus identik atau error akan ditampilkan. Kedua kolom diisi dalam respons.

boolean

Nilai atribut yang diketik Boolean.

number

Nilai atribut dengan jenis ganda.

{
  "category": enum (Category)
}

enum (Category)

Kategori jenis kendaraan

{
  "countryCode": string,
  "lastCharacter": string
}

string

Wajib. Kode Negara/Wilayah CLDR. Misalnya, US untuk Amerika Serikat, atau IN untuk India.

string

Digit terakhir pelat nomor atau "-1" untuk menunjukkan tidak ada nilai numerik pada pelat nomor.

• "ABC 1234" -> "4"
• "AB 123 CD" -> "3"
• "ABCDEF" -> "-1"

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

Rendering polyline tentang kecepatan traffic untuk semua wilayah di sepanjang satu rute perjalanan pelanggan.

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

Opsional. Jalan membentang yang harus dirender sepanjang polyline. Peregangan dijamin tidak tumpang-tindih, dan tidak harus mencakup rute lengkap.

Jika tidak ada bentangan jalan untuk gaya, klien harus menerapkan default untuk rute.

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

Wajib. Gaya yang akan diterapkan.

integer

Wajib. Gaya harus diterapkan antara [offsetMeters, offsetMeters + lengthMeters).

integer

Wajib. Panjang jalur tempat gaya diterapkan.

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

Cara fitur lokasi disetel untuk berperilaku di perangkat saat penghemat baterai aktif.

boolean

Apakah perangkat saat ini dalam mode hemat daya.

boolean

Apakah perangkat berada dalam status interaktif.

object (BatteryInfo)

Informasi tentang status baterai.

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

Status baterai, apakah penuh atau mengisi daya, dll.

enum (PowerSource)

Status sumber daya baterai.

number

Persentase baterai saat ini [0-100].