- 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 è |
vehicle |
Lo stato del veicolo. |
supported |
Tipi di viaggio supportati da questo veicolo. |
current |
Solo output. Elenco di |
last |
Ultima posizione segnalata del veicolo. |
maximum |
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. |
attributes[] |
Elenco degli attributi del veicolo. Un veicolo può avere al massimo 100 attributi e ogni attributo deve avere una chiave univoca. |
vehicle |
Obbligatorio. Il tipo di questo veicolo. Può essere utilizzato per filtrare i veicoli nei risultati di |
license |
Dati della targa del veicolo. |
route[] |
Deprecato: usa invece |
current |
La polilinea che specifica il percorso che l'app del conducente intende seguire per raggiungere la tappa successiva. Questo elenco viene restituito anche in Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK del driver. La decodifica non è ancora supportata. |
current |
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. |
current |
Solo output. Ora in cui è stato impostato Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: |
current |
Il waypoint dove finisce |
remaining |
La distanza in auto rimanente per il |
eta |
L'orario di arrivo stimato per la prima voce nel campo Quando aggiorni un veicolo, Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
remaining |
Solo input. Il tempo di percorrenza rimanente per Quando aggiorni un veicolo, |
waypoints[] |
Le tappe rimanenti assegnate a questo veicolo. |
waypoints |
Solo output. L'ultima volta che il campo Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
back |
Indica se il conducente accetta viaggi consecutivi. Se |
navigation |
Lo stato di navigazione del veicolo. |
device |
Solo input. Informazioni sulle impostazioni del dispositivo mobile utilizzato dal conducente. |
VehicleState
Lo stato di un Vehicle
.
Enum | |
---|---|
UNKNOWN_VEHICLE_STATE |
Valore predefinito, utilizzato per gli 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 nuove corse. |
VehicleAttribute
Descrive un attributo del veicolo come coppia chiave-valore. La lunghezza della stringa "chiave:valore" 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 il carattere due punti (:). |
value |
Il valore dell'attributo. |
Campo 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: |
|
string |
Valore dell'attributo tipo di stringa. Nota: è identico al campo |
bool |
Valore dell'attributo di tipo booleano. |
number |
Valore dell'attributo con tipo doppio. |
VehicleType
Il tipo di veicolo.
Rappresentazione JSON |
---|
{
"category": enum ( |
Campi | |
---|---|
category |
Categoria del tipo di veicolo |
Categoria
Categorie di tipo di veicolo
Enum | |
---|---|
UNKNOWN |
Valore predefinito, utilizzato per le categorie di veicoli non specificate o non riconosciute. |
AUTO |
Un'automobile. |
TAXI |
Qualsiasi veicolo che funge da taxi (in genere autorizzato o regolamentato). |
TRUCK |
In genere, un veicolo con una grande capacità di archiviazione. |
TWO_WHEELER |
Una motocicletta, un ciclomotore o un altro veicolo a due ruote |
BICYCLE |
Trasporto a spinta umana. |
PEDESTRIAN |
Un mezzo di trasporto umano, in genere a piedi o in corsa, che si sposta lungo percorsi pedonali. |
LicensePlate
Le informazioni sulla targa del veicolo. Per evitare di memorizzare informazioni che consentono l'identificazione personale, nell'entità vengono memorizzate solo le informazioni minime sulla targa.
Rappresentazione JSON |
---|
{ "countryCode": string, "lastCharacter": string } |
Campi | |
---|---|
country |
Obbligatorio. Codice paese/regione CLDR. Ad esempio, |
last |
L'ultima cifra della targa o "-1" per indicare che non è presente alcun valore numerico.
|
TrafficPolylineData
Condizioni del traffico lungo il percorso previsto del veicolo.
Rappresentazione JSON |
---|
{
"trafficRendering": {
object ( |
Campi | |
---|---|
traffic |
Rendering polilinea che indica la velocità del traffico per tutte le regioni lungo un tratto della corsa di un cliente. |
VisualTrafficReportPolylineRendering
Descrive in che modo i client devono colorare una parte del polilinea lungo il percorso.
Rappresentazione JSON |
---|
{
"roadStretch": [
{
object ( |
Campi | |
---|---|
road |
(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. |
RoadStretch
Un tratto di strada da visualizzare.
Rappresentazione JSON |
---|
{
"style": enum ( |
Campi | |
---|---|
style |
Obbligatorio. Lo stile da applicare. |
offset |
Obbligatorio. Lo stile deve essere applicato tra |
length |
Obbligatorio. La lunghezza del percorso in 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 sulle varie impostazioni del dispositivo mobile.
Rappresentazione JSON |
---|
{ "locationPowerSaveMode": enum ( |
Campi | |
---|---|
location |
Il comportamento delle funzionalità di geolocalizzazione sul dispositivo quando è attivo il risparmio energetico. |
is |
Se il dispositivo è attualmente in modalità di risparmio energetico. |
is |
Se il dispositivo è in stato interattivo. |
battery |
Informazioni sullo stato della batteria. |
LocationPowerSaveMode
Il modo in cui le funzionalità di geolocalizzazione sono configurate per funzionare sul dispositivo mobile quando è attiva la funzionalità "risparmio energetico" del dispositivo. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
Enum | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
Undefined LocationPowerSaveMode |
LOCATION_MODE_NO_CHANGE |
I fornitori di servizi di geolocalizzazione non devono essere interessati dal risparmio energetico oppure questa funzionalità deve essere disattivata. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
Il fornitore della posizione 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 geolocalizzazione 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 soltanto alle app in primo piano. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
La posizione non verrà disattivata, ma LocationManager ridurrà tutte le richieste ai fornitori quando il dispositivo non è interattivo. |
BatteryInfo
Informazioni sulla batteria del dispositivo.
Rappresentazione JSON |
---|
{ "batteryStatus": enum ( |
Campi | |
---|---|
battery |
Stato della batteria, se carica o in carica, ecc. |
power |
Stato della fonte di alimentazione della batteria. |
battery |
Percentuale attuale della batteria [0-100]. |
BatteryStatus
Stato della batteria, se è carica o in carica e così via.
Enum | |
---|---|
UNKNOWN_BATTERY_STATUS |
Stato della batteria sconosciuto. |
BATTERY_STATUS_CHARGING |
La 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 |
Il livello della batteria è basso. |
PowerSource
Tipo di caricabatterie utilizzato per caricare la batteria.
Enum | |
---|---|
UNKNOWN_POWER_SOURCE |
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 |
L'alimentazione è wireless. |
POWER_SOURCE_UNPLUGGED |
La batteria è scollegata. |
Metodi |
|
---|---|
|
Crea un'istanza per un nuovo veicolo associato a un fornitore di ridesharing o di consegne on demand. |
|
Restituisce un veicolo da Fleet Engine. |
|
Restituisce un elenco paginato di veicoli associati a un fornitore che corrispondono alle opzioni di richiesta. |
|
Restituisce un elenco di veicoli corrispondenti alle opzioni di richiesta. |
|
Scrive i dati aggiornati del veicolo in Fleet Engine. |
|
Aggiorna parzialmente gli attributi di un veicolo. |