REST Resource: providers.vehicles

Resource: Kendaraan

Metadata kendaraan.

Representasi JSON 
{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "pastLocations": [
    {
      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)
  }
}
Kolom
name

string

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

enum (VehicleState)

Status kendaraan.
supportedTripTypes[]

enum (TripType)

Jenis perjalanan yang didukung oleh kendaraan ini.
currentTrips[]

string

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

object (VehicleLocation)

Lokasi terakhir yang dilaporkan kendaraan.
pastLocations[]

object (VehicleLocation)

Hanya input. Lokasi yang pernah didatangi kendaraan ini sebelumnya yang belum dilaporkan ke Fleet Engine. Ini digunakan di UpdateVehicleRequest untuk mencatat lokasi yang sebelumnya tidak dapat dikirim ke server. Biasanya hal ini terjadi saat kendaraan tidak memiliki konektivitas internet.
maximumCapacity

integer

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

object (VehicleAttribute)

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

object (VehicleType)

Wajib. Jenis kendaraan ini. Dapat digunakan untuk memfilter kendaraan dalam hasil vehicles.search. Juga memengaruhi perkiraan waktu tiba dan penghitungan rute.
licensePlate

object (LicensePlate)

Informasi pelat nomor untuk kendaraan.
route[]
(deprecated)

object (TerminalLocation)

Tidak digunakan lagi: Gunakan Vehicle.waypoints sebagai gantinya.
currentRouteSegment

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.
currentRouteSegmentTraffic

object (TrafficPolylineData)

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

string (Timestamp format)

Hanya output. Waktu saat currentRouteSegment ditetapkan. Nilai ini dapat disimpan oleh klien dan diteruskan dalam permintaan vehicles.get mendatang untuk mencegah rute yang ditampilkan kembali yang belum berubah.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
currentRouteSegmentEndPoint

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 melakukan interpolasi ke titik jalan yang sebenarnya jika tidak sepenuhnya ditentukan. Kolom ini diabaikan dalam panggilan vehicles.update kecuali jika currentRouteSegment juga ditentukan.
remainingDistanceMeters

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.
etaToFirstWaypoint

string (Timestamp format)

Perkiraan waktu tiba ke entri pertama di kolom waypoints. Nilai tidak ditentukan jika kolom waypoints kosong atau kolom Vehicle.current_route_segment kosong.

Saat memperbarui kendaraan, remainingTimeSeconds lebih diutamakan daripada etaToFirstWaypoint dalam permintaan yang sama.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
remainingTimeSeconds

integer

Hanya input. 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 memperbarui kendaraan, remainingTimeSeconds lebih diutamakan daripada etaToFirstWaypoint dalam permintaan yang sama.
waypoints[]

object (TripWaypoint)

Titik jalan yang tersisa yang ditetapkan ke Kendaraan ini.
waypointsVersion

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.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
backToBackEnabled

boolean

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

enum (NavigationStatus)

Status navigasi kendaraan.
deviceSettings

object (DeviceSettings)

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

VehicleState

Status Vehicle.

Enum
UNKNOWN_VEHICLE_STATE Default, digunakan untuk status kendaraan yang tidak ditentukan atau tidak dikenali.
OFFLINE Kendaraan tidak menerima perjalanan baru. Catatan: kendaraan dapat terus beroperasi dalam status ini saat menyelesaikan perjalanan yang ditetapkan.
ONLINE Kendaraan menerima perjalanan baru.

VehicleAttribute

Menjelaskan atribut kendaraan sebagai key-value pair. Panjang string "key:value" tidak boleh melebihi 256 karakter.

Representasi JSON 
{
  "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.
}
Kolom
key

string

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

string

Nilai atribut.
Kolom union vehicle_attribute_value. Nilai atribut, dapat berupa jenis string, bool, atau double. vehicle_attribute_value hanya dapat berupa salah satu dari berikut:
stringValue

string

Nilai atribut dengan jenis string.

Catatan: Kolom ini sama dengan kolom value yang pada akhirnya tidak akan digunakan lagi. Untuk metode pembuatan atau pembaruan, 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.
boolValue

boolean

Nilai atribut berjenis boolean.
numberValue

number

Nilai atribut berjenis ganda.

VehicleType

Jenis kendaraan.

Representasi JSON 
{
  "category": enum (Category)
}
Kolom
category

enum (Category)

Kategori jenis kendaraan

Kategori

Kategori jenis kendaraan

Enum
UNKNOWN Default, digunakan untuk kategori kendaraan yang tidak ditentukan atau tidak dikenali.
AUTO Mobil.
TAXI Setiap kendaraan yang berfungsi sebagai taksi (biasanya berlisensi atau diatur).
TRUCK Umumnya, kendaraan dengan kapasitas penyimpanan besar.
TWO_WHEELER Sepeda motor, moped, atau kendaraan roda dua lainnya
BICYCLE Transportasi yang digerakkan manusia.
PEDESTRIAN Pengangkut manusia, biasanya berjalan atau berlari, yang melintasi jalur pejalan kaki.

LicensePlate

Informasi pelat nomor Kendaraan. Untuk menghindari penyimpanan informasi identitas pribadi, hanya informasi minimum tentang pelat nomor yang disimpan sebagai bagian dari entitas.

Representasi JSON 
{
  "countryCode": string,
  "lastCharacter": string
}
Kolom
countryCode

string

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

string

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

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

TrafficPolylineData

Kondisi lalu lintas di sepanjang rute kendaraan yang diperkirakan.

Representasi JSON 
{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}
Kolom
trafficRendering

object (VisualTrafficReportPolylineRendering)

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

VisualTrafficReportPolylineRendering

Menjelaskan cara klien mewarnai satu bagian polyline di sepanjang rute.

Representasi JSON 
{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}
Kolom
roadStretch[]

object (RoadStretch)

Opsional. Jalur jalan yang harus dirender di sepanjang polyline. Peregangan dijamin tidak tumpang-tindih, dan tidak harus mencakup rute lengkap.

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

RoadStretch

Satu ruas jalan yang harus dirender.

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

enum (Style)

Wajib. Gaya yang akan diterapkan.
offsetMeters

integer

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

integer

Wajib. Panjang jalur tempat gaya diterapkan.

Gaya

Gaya lalu lintas, yang menunjukkan kecepatan lalu lintas.

Enum
STYLE_UNSPECIFIED Tidak ada gaya yang dipilih.
SLOWER_TRAFFIC Traffic melambat.
TRAFFIC_JAM Ada kemacetan lalu lintas.

DeviceSettings

Informasi tentang berbagai setelan di perangkat seluler.

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

enum (LocationPowerSaveMode)

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

boolean

Apakah perangkat saat ini dalam mode hemat daya.
isInteractive

boolean

Apakah perangkat dalam status interaktif.
batteryInfo

object (BatteryInfo)

Informasi tentang status baterai.

LocationPowerSaveMode

Cara fitur lokasi dikonfigurasi untuk berperilaku di perangkat seluler saat fitur "penghemat baterai" perangkat aktif. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enum
UNKNOWN_LOCATION_POWER_SAVE_MODE LocationPowerSaveMode yang tidak ditentukan
LOCATION_MODE_NO_CHANGE Penyedia lokasi tidak boleh terpengaruh oleh penghemat baterai, atau penghemat baterai dinonaktifkan.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Penyedia lokasi berbasis GPS harus dinonaktifkan saat penghemat baterai aktif dan perangkat tidak interaktif.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Semua penyedia lokasi harus dinonaktifkan saat penghemat baterai aktif dan perangkat non-interaktif.
LOCATION_MODE_FOREGROUND_ONLY Semua penyedia lokasi akan tetap tersedia, tetapi perbaikan lokasi hanya boleh diberikan ke aplikasi latar depan.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Lokasi tidak akan dinonaktifkan, tetapi LocationManager akan membatasi semua permintaan ke penyedia saat perangkat tidak interaktif.

BatteryInfo

Informasi tentang baterai perangkat.

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

enum (BatteryStatus)

Status baterai, baik penuh maupun sedang diisi daya, dll.
powerSource

enum (PowerSource)

Status sumber daya baterai.
batteryPercentage

number

Persentase baterai saat ini [0-100].

BatteryStatus

Status baterai, baik penuh maupun sedang diisi daya, dll.

Enum
UNKNOWN_BATTERY_STATUS Status baterai tidak diketahui.
BATTERY_STATUS_CHARGING Baterai sedang diisi dayanya.
BATTERY_STATUS_DISCHARGING Baterai sedang dikosongkan.
BATTERY_STATUS_FULL Baterai penuh.
BATTERY_STATUS_NOT_CHARGING Baterai tidak mengisi daya.
BATTERY_STATUS_POWER_LOW Daya baterai lemah.

PowerSource

Jenis pengisi daya yang digunakan untuk mengisi daya baterai.

Enum
UNKNOWN_POWER_SOURCE Sumber daya tidak diketahui.
POWER_SOURCE_AC Sumber daya adalah pengisi daya AC.
POWER_SOURCE_USB Sumber daya adalah port USB.
POWER_SOURCE_WIRELESS Sumber daya nirkabel.
POWER_SOURCE_UNPLUGGED Baterai dicabut.

Metode

create

 Membuat instance kendaraan baru yang terkait dengan penyedia layanan transportasi on-demand atau pengiriman.

delete

 Menghapus Kendaraan dari Mesin Flotte.

get

 Menampilkan kendaraan dari Fleet Engine.

list

 Menampilkan daftar kendaraan bernomor halaman yang terkait dengan penyedia yang cocok dengan opsi permintaan.
Menampilkan daftar kendaraan yang cocok dengan opsi permintaan.

update

 Menulis data kendaraan yang diperbarui ke Fleet Engine.

updateAttributes

 Memperbarui atribut kendaraan sebagian.