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

Solo output. Il nome univoco di questo veicolo. Il formato è providers/{provider}/vehicles/{vehicle}.

enum (VehicleState)

Lo stato del veicolo.

enum (TripType)

Tipi di viaggio supportati da questo veicolo.

string

Solo output. Elenco di tripId per le corse attualmente assegnate a questo veicolo.

object (VehicleLocation)

Ultima posizione segnalata del veicolo.

integer

Il numero totale di passeggeri che questo veicolo può trasportare. Il conducente non viene considerato in questo valore. Questo valore deve essere maggiore o uguale a uno.

object (VehicleAttribute)

Elenco degli attributi del veicolo. Un veicolo può avere al massimo 50 attributi, ciascuno dei quali deve avere una chiave univoca.

object (VehicleType)

Obbligatorio. Il tipo di questo veicolo. Può essere utilizzato per filtrare i veicoli nei risultati di vehicles.search. Influisce anche sui calcoli relativi all'orario di arrivo stimato e ai percorsi.

object (LicensePlate)

Informazioni sulla targa del veicolo.

object (TerminalLocation)

Obsoleto: utilizza Vehicle.waypoints.

string

La polilinea che specifica il percorso che l'app del conducente intende per raggiungere il tappa successivo. Questo elenco viene restituito anche in Trip.current_route_segment per tutte le corse attive assegnate al veicolo.

Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK Driver. La decodifica non è ancora supportata.

object (TrafficPolylineData)

Solo input. Fleet Engine utilizza queste informazioni per migliorare la condivisione del percorso. Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK Driver.

string (Timestamp format)

Solo output. Ora in cui è stato impostato currentRouteSegment. Può essere archiviata dal client e trasmessa in future richieste vehicles.get per evitare route di ritorno che non sono cambiate.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Il tappa in cui termina currentRouteSegment. Questo dato può essere fornito dai conducenti nelle chiamate vehicles.update come tappo completo del viaggio, come tappa LatLng o come ultimo LatLng del currentRouteSegment. Fleet Engine farà quindi del suo meglio per interpolare fino a un Waypoint effettivo se questo non è completamente specificato. Questo campo viene ignorato nelle chiamate vehicles.update, a meno che non venga specificato anche currentRouteSegment.

integer

Distanza percorsa rimanente per il currentRouteSegment. Questo valore viene restituito anche in Trip.remaining_distance_meters per tutte le corse attive assegnate al veicolo. Il valore non è specificato se il campo currentRouteSegment è vuoto.

string (Timestamp format)

L'orario di arrivo stimato per la prima voce nel campo waypoints. Il valore non è specificato se il campo waypoints è vuoto o il campo Vehicle.current_route_segment è vuoto.

Quando aggiorni un veicolo, remainingTimeSeconds ha la precedenza su etaToFirstWaypoint nella stessa richiesta.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

integer

Solo input. Il tempo di guida rimanente per il currentRouteSegment. Il valore non è specificato se il campo waypoints è vuoto o il campo Vehicle.current_route_segment è vuoto. Se tutti i gruppi utilizzano lo stesso orologio, questo valore deve corrispondere a etaToFirstWaypoint - current_time.

Quando aggiorni un veicolo, remainingTimeSeconds ha la precedenza su etaToFirstWaypoint nella stessa richiesta.

object (TripWaypoint)

I restanti Waypoint assegnati a questo veicolo.

string (Timestamp format)

Solo output. L'ultima volta che il campo waypoints è stato aggiornato. I client devono memorizzare nella cache questo valore e passarlo in GetVehicleRequest per garantire che il campo waypoints venga restituito solo in caso di aggiornamento.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

boolean

Indica se il conducente accetta corse di andata e ritorno. Se true, vehicles.search potrebbe includere il veicolo anche se è attualmente assegnato a una corsa. Il valore predefinito è false.

enum (NavigationStatus)

Lo stato di navigazione del veicolo.

object (DeviceSettings)

Solo input. Informazioni sulle impostazioni del dispositivo mobile utilizzato dal conducente.

{
  "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

La chiave dell'attributo. Le chiavi non possono contenere i due punti (:).

string

Il valore dell'attributo.

string

Valore dell'attributo con tipo di stringa.

Nota: è identico al campo value, che verrà presto ritirato. Per i metodi di creazione o aggiornamento è possibile utilizzare entrambi i campi, ma è vivamente consigliato usare stringValue. Se sono impostati entrambi, stringValue e value devono essere identici, altrimenti verrà generato un errore. Entrambi i campi vengono compilati nelle risposte.

boolean

Valore dell'attributo con digitazione booleano.

number

Valore dell'attributo con doppia digitazione.

{
  "category": enum (Category)
}

enum (Category)

Categoria del tipo di veicolo

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

string

Obbligatorio. Codice paese/regione CLDR. Ad esempio, US per gli Stati Uniti o IN per l'India.

string

L'ultima cifra della targa o "-1" per indicare che non è presente alcun valore numerico.

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

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

object (VisualTrafficReportPolylineRendering)

Una polilinea che mostra la velocità del traffico per tutte le regioni lungo un tratto del percorso del cliente.

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

object (RoadStretch)

Campo facoltativo. Tratti stradali che devono essere realizzati lungo la polilinea. Non è garantito che gli elementi si sovrappongano e non coprano necessariamente l'intero percorso.

In assenza di un tratto stradale da definire, il cliente deve applicare l'impostazione predefinita per il percorso.

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

enum (Style)

Obbligatorio. Lo stile da applicare.

integer

Obbligatorio. Lo stile deve essere applicato tra [offsetMeters, offsetMeters + lengthMeters).

integer

Obbligatorio. La lunghezza del percorso a cui applicare lo stile.

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

enum (LocationPowerSaveMode)

Come si comportano le funzionalità di geolocalizzazione sul dispositivo quando la modalità di risparmio energetico è attiva.

boolean

Indica se il dispositivo è attualmente in modalità di risparmio energetico.

boolean

Indica se il dispositivo è in stato interattivo.

object (BatteryInfo)

Informazioni sullo stato della batteria.

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

enum (BatteryStatus)

Stato della batteria, se carica o in carica, ecc.

enum (PowerSource)

Stato della fonte di alimentazione della batteria.

number

Percentuale attuale della batteria [0-100].