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 il veicolo può trasportare. Il conducente non viene considerato in questo valore. Questo valore deve essere maggiore o uguale a 1.

object (VehicleAttribute)

Elenco degli attributi del veicolo. Un veicolo può avere al massimo 100 attributi e ogni attributo 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 sul calcolo dell'orario di arrivo stimato e dei percorsi.

object (LicensePlate)

Dati della targa del veicolo.

object (TerminalLocation)

Deprecato: usa invece Vehicle.waypoints.

string

La polilinea che specifica il percorso che l'app del conducente intende seguire per raggiungere la tappa successiva. Questo elenco viene restituito anche in Trip.current_route_segment per tutti i viaggi attivi assegnati al veicolo.

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

object (TrafficPolylineData)

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

string (Timestamp format)

Solo output. Ora in cui è stato impostato currentRouteSegment. Può essere archiviato dal client e passato nelle future richieste di vehicles.get per impedire la restituzione di route che non sono state modificate.

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

object (TripWaypoint)

Il waypoint dove finisce currentRouteSegment. Questi possono essere forniti dai conducenti nelle chiamate vehicles.update come tappa completa, tappa LatLng o come ultima tappa (LatLng) delle currentRouteSegment. Fleet Engine farà del suo meglio per eseguire l'interpolazione fino a un punto di passaggio effettivo se non è completamente specificato. Questo campo viene ignorato nelle chiamate vehicles.update a meno che non venga specificato anche currentRouteSegment.

integer

La distanza in auto rimanente per il currentRouteSegment. Questo valore viene restituito anche in Trip.remaining_distance_meters per tutti i viaggi attivi assegnati al veicolo. Se il campo currentRouteSegment è vuoto, il valore non è specificato.

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 nel 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 percorrenza rimanente per currentRouteSegment. Il valore non è specificato se il campo waypoints è vuoto o il campo Vehicle.current_route_segment è vuoto. Questo valore deve corrispondere a etaToFirstWaypoint - current_time se tutte le parti utilizzano lo stesso orologio.

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

object (TripWaypoint)

Le tappe rimanenti assegnate 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 trasmetterlo a GetVehicleRequest per garantire che il campo waypoints venga restituito solo se viene aggiornato.

Un timestamp nel 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 viaggi consecutivi. Se true, vehicles.search può includere il veicolo anche se al momento è assegnato a un viaggio. 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 il carattere due punti (:).

string

Il valore dell'attributo.

string

Valore dell'attributo tipo di stringa.

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

boolean

Valore dell'attributo di tipo booleano.

number

Valore dell'attributo con tipo doppio.

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

Rendering polilinea che indica la velocità del traffico per tutte le regioni lungo un tratto della corsa di un cliente.

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

object (RoadStretch)

(Facoltativo) Tratti della strada che dovrebbero essere visualizzati lungo la polilinea. È garantito che gli tratti non si sovrappongano e non coprono necessariamente l'intero percorso.

In assenza di un tratto di strada da stilizzare, il client deve applicare il valore predefinito 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 in cui applicare lo stile.

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

enum (LocationPowerSaveMode)

Il comportamento delle funzionalità di geolocalizzazione sul dispositivo quando è attivo il risparmio energetico.

boolean

Se il dispositivo è attualmente in modalità di risparmio energetico.

boolean

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