- Risorsa: veicolo
- VehicleState
- VehicleAttribute
- VehicleType
- Categoria
- LicensePlate
- TrafficPolylineData
- VisualTrafficReportPolylineRendering
- RoadStretch
- Stile
- NavigationStatus
- DeviceSettings
- LocationPowerSaveMode
- BatteryInfo
- BatteryStatus
- PowerSource
- Metodi
Risorsa: veicolo
Metadati del veicolo.
Rappresentazione JSON |
---|
{ "name": string, "vehicleState": enum ( |
Campi | |
---|---|
name |
Solo output. Il nome univoco di questo veicolo. Il formato è |
vehicleState |
Lo stato del veicolo. |
supportedTripTypes[] |
Tipi di viaggio supportati da questo veicolo. |
currentTrips[] |
Solo output. Elenco di |
lastLocation |
Ultima posizione segnalata del veicolo. |
maximumCapacity |
Il numero totale di passeggeri che questo veicolo può trasportare. Il conducente non è considerato in questo valore. Questo valore deve essere maggiore o uguale a 1. |
attributes[] |
Elenco di attributi del veicolo. Un veicolo può avere al massimo 100 attributi, ognuno dei quali deve avere una chiave univoca. |
vehicleType |
Obbligatoria. Il tipo di questo veicolo. Può essere utilizzato per filtrare i veicoli in |
licensePlate |
Informazioni sulla targa del veicolo. |
route[] |
Deprecato: utilizza |
currentRouteSegment |
La polilinea che specifica il percorso che l'app del conducente intende intraprendere per raggiungere il waypoint successivo. Questo elenco viene restituito in Nota: questo campo è destinato esclusivamente all'uso da parte dell'SDK Driver. La decodifica non è ancora supportata. |
currentRouteSegmentTraffic |
Solo input. Fleet Engine utilizza queste informazioni per migliorare la condivisione del percorso. Nota: questo campo è destinato esclusivamente all'uso da parte dell'SDK Driver. |
currentRouteSegmentVersion |
Solo output. L'ora in cui è stato impostato Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
currentRouteSegmentEndPoint |
Il waypoint in cui termina |
remainingDistanceMeters |
La distanza in auto rimanente per il |
etaToFirstWaypoint |
L'orario di arrivo stimato per la prima voce nel campo Quando aggiorni un veicolo, Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
remainingTimeSeconds |
Solo input. Il tempo di guida rimanente per il Quando aggiorni un veicolo, |
waypoints[] |
I waypoint rimanenti assegnati a questo veicolo. |
waypointsVersion |
Solo output. L'ultima volta che il campo Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
backToBackEnabled |
Indica se il conducente accetta corse consecutive. Se |
navigationStatus |
Lo stato di navigazione del veicolo. |
deviceSettings |
Solo input. Informazioni sulle impostazioni del dispositivo mobile utilizzato dal conducente. |
VehicleState
Lo stato di un elemento Vehicle
.
Enum | |
---|---|
UNKNOWN_VEHICLE_STATE |
Predefinita, utilizzata per stati del veicolo non specificati o non riconosciuti. |
OFFLINE |
Il veicolo non accetta nuovi viaggi. Nota: il veicolo potrebbe continuare a funzionare in questo stato durante il completamento di una corsa assegnata. |
ONLINE |
Il veicolo accetta nuovi viaggi. |
VehicleAttribute
Descrive un attributo di un veicolo come coppia chiave-valore. La lunghezza della stringa "key:value" non può superare i 256 caratteri.
Rappresentazione JSON |
---|
{ "key": string, "value": string, // Union field |
Campi | |
---|---|
key |
La chiave dell'attributo. Le chiavi non possono contenere i due punti (:). |
value |
Il valore dell'attributo. |
Campo di unione vehicle_attribute_value . Il valore dell'attributo può essere di tipo stringa, bool o doppio. vehicle_attribute_value può essere solo uno dei seguenti: |
|
stringValue |
Valore dell'attributo di tipo stringa. Nota: è identico al campo |
boolValue |
Valore dell'attributo con tipo booleano. |
numberValue |
Valore dell'attributo con doppio tipo. |
VehicleType
Il tipo di veicolo.
Rappresentazione JSON |
---|
{
"category": enum ( |
Campi | |
---|---|
category |
Categoria del tipo di veicolo |
Categoria
Categorie dei tipi di veicoli
Enum | |
---|---|
UNKNOWN |
Predefinita, utilizzata per categorie di veicoli non specificate o non riconosciute. |
AUTO |
Un'automobile. |
TAXI |
Qualsiasi veicolo che funge da taxi (solitamente con licenza o regolamentato). |
TRUCK |
In genere, si tratta di un veicolo con uno spazio di archiviazione molto elevato. |
TWO_WHEELER |
Un motociclo, un ciclomotore o un altro veicolo a due ruote. |
BICYCLE |
Trasporto umano. |
PEDESTRIAN |
Un mezzi di trasporto umano, in genere a piedi o di corsa, lungo percorsi pedonali. |
LicensePlate
Le informazioni sulla targa del veicolo. Per evitare di memorizzare informazioni che consentono l'identificazione personale, come parte dell'entità vengono archiviate solo le informazioni minime sulla targa.
Rappresentazione JSON |
---|
{ "countryCode": string, "lastCharacter": string } |
Campi | |
---|---|
countryCode |
Obbligatoria. Codice paese/regione CLDR. Ad esempio, |
lastCharacter |
L'ultima cifra della targa o "-1" per indicare che non è presente alcun valore numerico sulla targa.
|
TrafficPolylineData
Condizioni del traffico lungo il percorso previsto per il veicolo.
Rappresentazione JSON |
---|
{
"trafficRendering": {
object ( |
Campi | |
---|---|
trafficRendering |
Una polilinea che mostra la velocità del traffico per tutte le regioni lungo un tratto di un percorso del cliente. |
VisualTrafficReportPolylineRendering
Descrive come i clienti devono colorare una parte della polilinea lungo il percorso.
Rappresentazione JSON |
---|
{
"roadStretch": [
{
object ( |
Campi | |
---|---|
roadStretch[] |
Campo facoltativo. Tratti stradali che devono essere realizzati lungo la polilinea. È garantito che gli esercizi non si sovrappongano e non coprano necessariamente l'intero percorso. In assenza di un tratto di strada a cui applicare lo stile, il cliente deve applicare il valore predefinito per il percorso. |
RoadStretch
Un tratto di strada che deve essere eseguito.
Rappresentazione JSON |
---|
{
"style": enum ( |
Campi | |
---|---|
style |
Obbligatoria. Lo stile da applicare. |
offsetMeters |
Obbligatoria. Lo stile deve essere applicato tra |
lengthMeters |
Obbligatoria. La lunghezza del percorso a cui applicare lo stile. |
Stile
Lo stile del traffico, che indica la velocità del traffico.
Enum | |
---|---|
STYLE_UNSPECIFIED |
Nessuno stile selezionato. |
SLOWER_TRAFFIC |
Il traffico sta rallentando. |
TRAFFIC_JAM |
C'è un ingorgo. |
DeviceSettings
Informazioni su varie impostazioni sul dispositivo mobile.
Rappresentazione JSON |
---|
{ "locationPowerSaveMode": enum ( |
Campi | |
---|---|
locationPowerSaveMode |
Comportamento delle funzionalità di geolocalizzazione sul dispositivo quando è attivo il risparmio energetico. |
isPowerSaveMode |
Indica se il dispositivo è attualmente in modalità di risparmio energetico. |
isInteractive |
Indica se il dispositivo è in uno stato interattivo. |
batteryInfo |
Informazioni sullo stato della batteria. |
LocationPowerSaveMode
Comportamento delle funzionalità di geolocalizzazione sul dispositivo mobile quando è attiva la funzionalità "Risparmio batteria". (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
Enum | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
Modalità di risparmio energetico non definita |
LOCATION_MODE_NO_CHANGE |
Il risparmio energetico non dovrebbe influire sui fornitori di servizi di localizzazione oppure il risparmio energetico è disattivato. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
Il fornitore di servizi di localizzazione basato sul GPS deve essere disattivato quando il risparmio energetico è attivo e il dispositivo non è interattivo. |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
Tutti i fornitori di servizi di localizzazione devono essere disattivati quando il risparmio energetico è attivo e il dispositivo non è interattivo. |
LOCATION_MODE_FOREGROUND_ONLY |
Tutti i fornitori di posizione rimarranno disponibili, ma le correzioni della posizione dovrebbero essere fornite solo alle app in primo piano. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
La geolocalizzazione non verrà disattivata, ma LocationManager limiterà tutte le richieste ai fornitori quando il dispositivo non è interattivo. |
BatteryInfo
Informazioni sulla batteria del dispositivo.
Rappresentazione JSON |
---|
{ "batteryStatus": enum ( |
Campi | |
---|---|
batteryStatus |
Stato della batteria: carica, ricarica, ecc. |
powerSource |
Stato della fonte di alimentazione della batteria. |
batteryPercentage |
Percentuale attuale della batteria [0-100]. |
BatteryStatus
Stato della batteria: carica, ricarica, ecc.
Enum | |
---|---|
UNKNOWN_BATTERY_STATUS |
Stato della batteria sconosciuto. |
BATTERY_STATUS_CHARGING |
Batteria in carica. |
BATTERY_STATUS_DISCHARGING |
La batteria si sta scaricando. |
BATTERY_STATUS_FULL |
Batteria carica. |
BATTERY_STATUS_NOT_CHARGING |
La batteria non si carica. |
BATTERY_STATUS_POWER_LOW |
La batteria è in esaurimento. |
PowerSource
Tipo di caricabatterie utilizzato per caricare la batteria.
Enum | |
---|---|
UNKNOWN_POWER_SOURCE |
Fonte di alimentazione sconosciuta. |
POWER_SOURCE_AC |
La fonte di alimentazione è un caricabatterie CA. |
POWER_SOURCE_USB |
La fonte di alimentazione è una porta USB. |
POWER_SOURCE_WIRELESS |
La fonte di alimentazione è wireless. |
POWER_SOURCE_UNPLUGGED |
La batteria è scollegata. |
Metodi |
|
---|---|
|
Crea un'istanza per un nuovo veicolo associato a un fornitore di servizi di ridesharing o consegne on demand. |
|
Restituisce un veicolo da Fleet Engine. |
|
Restituisce un elenco impaginato di veicoli associati a un fornitore che corrispondono alle opzioni di richiesta. |
|
Restituisce un elenco di veicoli che corrispondono alle opzioni di richiesta. |
|
Scrive dati aggiornati del veicolo in Fleet Engine. |
|
Aggiorna parzialmente gli attributi di un veicolo. |