Package maps.fleetengine.v1

BatteryStatus

Stato della batteria: carica, ricarica, ecc.

PowerSource

Stato della fonte di alimentazione della batteria.

float

Percentuale attuale della batteria [0-100].

SpeedReadingInterval

Velocità del traffico lungo il percorso dal waypoint precedente a quello attuale.

string

Il percorso seguito dal conducente dal waypoint precedente a quello attuale. Questo percorso contiene punti di riferimento che consentono ai clienti di mostrare indicatori di traffico (vedi speed_reading_interval). La decodifica non è ancora supportata.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

string

Obbligatorio. ID viaggio univoco. Soggetti alle seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Lunghezza massima: 64 caratteri.
• Normalizzata secondo lo standard Unicode Normalization Form C.
• Non può contenere nessuno dei seguenti caratteri ASCII: "/", ":", "?", "," o "#".

Trip

Obbligatorio. Entità di viaggio da creare.

Quando crei un Viaggio, i seguenti campi sono obbligatori:

• trip_type
• pickup_point

Se li fornisci, vengono utilizzati i seguenti campi:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Tutti gli altri campi Viaggio vengono ignorati. Ad esempio, tutte le corse iniziano con un valore trip_status pari a NEW anche se passi in un valore trip_status di CANCELED nella richiesta di creazione.

Solo i viaggi di EXCLUSIVE supportano intermediate_destinations.

Se il criterio vehicle_id è impostato per una corsa condivisa, devi fornire l'elenco di Trip.vehicle_waypoints per specificare l'ordine dei waypoint rimanenti per il veicolo, altrimenti l'ordine dei waypoint non sarà determinato.

Se specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutti i waypoint rimanenti delle corse del veicolo, senza waypoint aggiuntivi. Devi ordinare questi waypoint in modo che, per una determinata corsa, il punto di prelievo sia prima delle destinazioni intermedie e che tutte le destinazioni intermedie siano prima del punto di partenza. I waypoint di una corsa EXCLUSIVE non devono interfogliare con altre corse.

Vengono utilizzati i campi trip_id, waypoint_type e location, mentre tutti gli altri campi TripWaypoint in vehicle_waypoints vengono ignorati.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

string

Obbligatorio. ID veicolo univoco. Soggetti alle seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Lunghezza massima: 64 caratteri.
• Normalizzata secondo lo standard Unicode Normalization Form C.
• Non può contenere nessuno dei seguenti caratteri ASCII: "/", ":", "?", "," o "#".

Vehicle

Obbligatorio. L'entità Veicolo da creare. Quando crei un veicolo, i seguenti campi sono obbligatori:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Quando crei un veicolo, i seguenti campi vengono ignorati:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

Tutti gli altri campi sono facoltativi e vengono utilizzati, se forniti.

LocationPowerSaveMode

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

bool

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

bool

Indica se il dispositivo è in uno stato interattivo.

BatteryInfo

Informazioni sullo stato della batteria.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}/trips/{trip}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

TripView

Il sottoinsieme dei campi Trip che deve essere restituito e la relativa interpretazione.

Timestamp

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati i dati Trip.route o Trip.current_route_segment. Se i dati di route non vengono modificati dopo il timestamp, il campo della route non viene impostato nella risposta. Se non viene specificato un numero minimo, i dati del percorso vengono sempre recuperati.

Timestamp

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati gli elementi Trip.remaining_waypoints. Se non vengono modificati dopo il timestamp, i remaining_waypoints non vengono impostati nella risposta. Se questo campo non viene specificato, il campo remaining_waypoints viene sempre recuperato.

PolylineFormatType

Il formato della route corrente restituito, LAT_LNG_LIST_TYPE (in Trip.route) o ENCODED_POLYLINE_TYPE (in Trip.current_route_segment). Il valore predefinito è LAT_LNG_LIST_TYPE.

Timestamp

Indica il timestamp minimo (esclusivo) per il quale viene recuperato il valore Trip.current_route_segment_traffic. Se i dati sul traffico non vengono modificati dopo il timestamp, il campo current_route_segment_traffic non viene impostato nella risposta. Se non viene specificato un numero minimo, i dati sul traffico vengono sempre recuperati. Tieni presente che il traffico è disponibile solo per i clienti delle soluzioni On-Demand Rides and Deliveries Solution.

Timestamp

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati i dati Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint. Se i dati non sono stati modificati dopo il timestamp, i campi precedenti non vengono impostati nella risposta. Se remaining_waypoints_route_version non è specificato, il traffico e il percorso vengono sempre recuperati.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}/vehicles/{vehicle}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

Timestamp

Indica il timestamp minimo (esclusivo) per il quale viene recuperato il valore Vehicle.current_route_segment. Se la route non è stata modificata dopo il timestamp, il campo current_route_segment non è impostato nella risposta. Se non viene specificato un valore minimo, current_route_segment viene sempre recuperato.

Timestamp

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati i dati di Vehicle.waypoints. Se i waypoint non vengono modificati dopo il timestamp, i dati vehicle.waypoints non vengono impostati nella risposta. Se questo campo non viene specificato, il campo vehicle.waypoints viene sempre recuperato.

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 sulla targa.

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

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

int32

Il numero massimo di veicoli da restituire. Valore predefinito: 100.

string

Il valore dell'attributo next_page_token fornito da una chiamata precedente a ListVehicles per consentirti di impaginare i gruppi di veicoli. Il valore non è definito se i criteri di filtro della richiesta non corrispondono a quelli della chiamata precedente a ListVehicles.

Int32Value

Specifica la capacità minima richiesta del veicolo. Tutti i veicoli restituiti avranno un valore maximum_capacity maggiore o uguale a questo valore. Se impostato, deve essere maggiore o uguale a 0.

TripType

Limita la risposta ai veicoli che supportano almeno uno dei tipi di corsa specificati.

Duration

Limita la risposta ai veicoli che hanno inviato aggiornamenti di posizione a Fleet Engine entro il periodo di tempo specificato. I veicoli fermi che continuano a trasmettere la propria posizione non sono considerati inattivi. Se presente, deve essere una durata positiva valida.

Category

Obbligatorio. Limita la risposta ai veicoli con una delle categorie di tipo specificate. Non consentito: UNKNOWN.

string

I chiamanti possono creare operazioni logiche complesse utilizzando qualsiasi combinazione dei campi required_attributes, required_one_of_attributes e required_one_of_attribute_sets.

required_attributes è un elenco; required_one_of_attributes utilizza un messaggio che consente di creare un elenco di liste. In combinazione, i due campi consentono la composizione di questa espressione:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Limita la risposta ai veicoli con gli attributi specificati. Questo campo è un'operazione di congiunzione/AND. Sono consentiti massimo 50 obbligatorio_attributes. Corrisponde al numero massimo di attributi consentiti su un veicolo. Ogni stringa ripetuta deve essere nel formato "key:value".

string

Limita la risposta ai veicoli con almeno uno degli attributi specificati in ogni VehicleAttributeList. In ogni elenco, un veicolo deve corrispondere ad almeno uno degli attributi. Questo campo è un'operazione di disgiunzione/OR inclusiva in ogni VehicleAttributeList e un'operazione di congiunzione/AND nella raccolta di VehicleAttributeList. Ogni stringa ripetuta deve avere il formato "chiave1:valore1|chiave2:valore2|chiave3:valore3".

string

required_one_of_attribute_sets fornisce funzionalità aggiuntive.

Simile a required_one_of_attributes, required_one_of_attribute_sets utilizza un messaggio che consente un elenco di elenchi, consentendo espressioni come la seguente:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Limita la risposta ai veicoli che corrispondono a tutti gli attributi in un VehicleAttributeList. In ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni VehicleAttributeList e un'operazione di disgiunzione/OR inclusiva nella raccolta di VehicleAttributeList. Ogni stringa ripetuta deve avere il formato "chiave1:valore1|chiave2:valore2|chiave3:valore3".

VehicleState

Limita la risposta ai veicoli con questo stato.

bool

Restituisci solo i veicoli con i viaggi attuali.

string

Campo facoltativo. Una query di filtro da applicare quando elenchi veicoli. Vedi http://aip.dev/160 per esempi di sintassi del filtro.

Questo campo è progettato per sostituire i campi required_attributes, required_one_of_attributes e required_one_of_attributes_sets. Se qui viene specificato un valore non vuoto, i seguenti campi devono essere vuoti: required_attributes, required_one_of_attributes e required_one_of_attributes_sets.

Questo filtro funziona come una clausola AND con altri vincoli, come vehicle_state o on_trip_only.

Tieni presente che le uniche query supportate sono relative agli attributi dei veicoli (ad es. attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Il numero massimo di limitazioni consentite in una query di filtro è 50.

Inoltre, tutti gli attributi vengono memorizzati come stringhe, pertanto gli unici confronti supportati con gli attributi sono i confronti di stringhe. Per eseguire un confronto con valori numerici o booleani, i valori devono essere racchiusi esplicitamente tra virgolette per essere trattati come stringhe (ad esempio attributes.<key> = "10" o attributes.<key> = "true").

Viewport

Campo facoltativo. Un filtro che limita i veicoli restituiti a quelli la cui ultima posizione nota si trovava nell'area rettangolare definita dall'area visibile.

Vehicle

Veicoli che corrispondono ai criteri nella richiesta. Il numero massimo di veicoli restituiti è determinato dal campo page_size nella richiesta.

string

Token per recuperare la pagina successiva di veicoli o vuoto se non ci sono altri veicoli che soddisfano i criteri della richiesta.

int64

Obbligatorio. Numero totale di veicoli che corrispondono ai criteri della richiesta in tutte le pagine.

string

Obbligatorio. Deve essere nel formato providers/{provider}/billableTrips/{billable_trip}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

string

Obbligatorio. Il codice paese di due lettere del paese in cui si svolge la corsa. Il prezzo viene definito in base al codice paese.

BillingPlatformIdentifier

La piattaforma su cui è stata emessa la richiesta.

string

Gli identificatori direttamente correlati alla corsa segnalata. In genere si tratta di ID (ad esempio gli ID sessione) di operazioni di prenotazione anticipata eseguite prima che l'ID viaggio sia disponibile. Il numero di related_ids è limitato a 50.

SolutionType

Il tipo di soluzione di prodotto GMP (ad es. ON_DEMAND_RIDESHARING_AND_DELIVERIES) utilizzato per il viaggio registrato.

string

Il codice lingua BCP-47, ad esempio en-US o sr-Latn. Per ulteriori informazioni, vedi http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se non viene specificato alcun nome, la risposta può essere in qualsiasi lingua, con una preferenza per l'inglese, se esiste un nome di questo tipo. Esempio di valore del campo: en-US.

string

Obbligatorio. Codice regione CLDR della regione in cui ha origine la richiesta. Esempio di valore del campo: US.

string

Versione dell'SDK per le chiamate, se applicabile. Il formato della versione è "major.minor.patch", ad esempio 1.1.2.

string

Versione del sistema operativo su cui è in esecuzione l'SDK per le chiamate. Esempi di valori del campo: 4.4.1, 12.1.

string

Modello del dispositivo su cui è in esecuzione l'SDK per le chiamate. Esempi di valori del campo: iPhone12,1, SM-G920F.

SdkType

Il tipo di SDK che invia la richiesta.

string

Versione del MapSDK da cui dipende l'SDK per le chiamate, se applicabile. Il formato della versione è "major.minor.patch", ad esempio 5.2.1.

string

Versione del NavSDK da cui dipende l'SDK per le chiamate, se applicabile. Il formato della versione è "major.minor.patch", ad esempio 2.1.0.

Platform

Piattaforma dell'SDK per le chiamate.

string

Produttore del dispositivo Android dall'SDK per le chiamate; applicabile soltanto per gli SDK Android. Esempio di valore del campo: Samsung.

int32

Livello API Android dell'SDK per le chiamate, applicabile solo agli SDK Android. Esempio di valore del campo: 23.

string

ID facoltativo che può essere fornito ai fini del logging per identificare la richiesta.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

string

Il veicolo associato alle corse nella richiesta. Se non specificate, le corse restituite non contengono:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Se impostato su true, la risposta include le corse che influenzano il percorso di un conducente.

int32

Se non viene configurato, il server decide il numero di risultati da restituire.

string

Imposta questo valore su un valore restituito in precedenza in SearchTripsResponse per continuare dai risultati precedenti.

Duration

Se specificato, restituisce le corse che non sono state aggiornate dopo l'ora (current - minimum_staleness).

Trip

L'elenco di corse per il veicolo richiesto.

string

Passa questo token nella richiesta SearchTripsRequest per sfogliare i risultati dell'elenco. L'API restituisce un elenco di corse per ogni chiamata e, quando non rimangono più risultati, l'elenco delle corse è vuoto.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

TerminalLocation

Obbligatorio. Il punto di prelievo da cercare nelle vicinanze.

TerminalLocation

La località di consegna prevista del cliente. Il campo è obbligatorio se trip_types contiene TripType.SHARED.

int32

Obbligatorio. Definisce il raggio di ricerca del veicolo intorno al punto di prelievo. Verranno restituiti solo i veicoli all'interno del raggio di ricerca. Il valore deve essere compreso tra 400 e 10.000 metri (inclusi).

int32

Obbligatorio. Specifica il numero massimo di veicoli da restituire. Il valore deve essere compreso tra 1 e 50 (inclusi).

int32

Obbligatorio. Specifica il numero di passeggeri presi in considerazione per una corsa. Il valore deve essere maggiore o uguale a 1. Il conducente non è considerato nel valore della capacità.

TripType

Obbligatorio. Rappresenta il tipo di viaggio proposto. Deve includere esattamente un tipo. Non consentito: UNKNOWN_TRIP_TYPE. Limita la ricerca solo ai veicoli che possono supportare quel tipo di corsa.

Duration

Limita la ricerca solo ai veicoli che hanno inviato aggiornamenti di posizione a Fleet Engine entro il periodo di tempo specificato. I veicoli fermi che continuano a trasmettere la propria posizione non sono considerati inattivi. Se questo campo non viene configurato, il server utilizza il valore predefinito di cinque minuti.

VehicleType

Obbligatorio. Limita la ricerca ai veicoli con uno dei tipi specificati. È necessario specificare almeno un tipo di veicolo. I VehicleType con una categoria di UNKNOWN non sono consentiti.

VehicleAttribute

I chiamanti possono creare operazioni logiche complesse utilizzando qualsiasi combinazione dei campi required_attributes, required_one_of_attributes e required_one_of_attribute_sets.

required_attributes è un elenco; required_one_of_attributes utilizza un messaggio che consente di creare un elenco di liste. In combinazione, i due campi consentono la composizione di questa espressione:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Limita la ricerca solo ai veicoli con gli attributi specificati. Questo campo è un'operazione di congiunzione/AND. Sono consentiti massimo 50 obbligatorio_attributes. Corrisponde al numero massimo di attributi consentiti su un veicolo.

VehicleAttributeList

Limita la ricerca solo ai veicoli con almeno uno degli attributi specificati in ogni VehicleAttributeList. In ogni elenco, un veicolo deve corrispondere ad almeno uno degli attributi. Questo campo è un'operazione di disgiunzione/OR inclusiva in ogni VehicleAttributeList e un'operazione di congiunzione/AND nella raccolta di VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets fornisce funzionalità aggiuntive.

Simile a required_one_of_attributes, required_one_of_attribute_sets utilizza un messaggio che consente un elenco di elenchi, consentendo espressioni come la seguente:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Limita la ricerca solo ai veicoli con tutti gli attributi in un VehicleAttributeList. In ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni VehicleAttributeList e un'operazione di disgiunzione/OR inclusiva nella raccolta di VehicleAttributeList.

VehicleMatchOrder

Obbligatorio. Specifica il criterio di ordinamento desiderato per i risultati.

bool

Indica se i veicoli con una singola corsa attiva sono idonei per questa ricerca. Questo campo viene utilizzato solo quando current_trips_present non è specificato. Se current_trips_present non viene specificato e questo campo è false, i veicoli con corse assegnate vengono esclusi dai risultati di ricerca. Se current_trips_present non è specificato e questo campo è true, i risultati di ricerca possono includere i veicoli con una corsa attiva con stato ENROUTE_TO_DROPOFF. Se current_trips_present è specificato, questo campo non può essere impostato su true.

Il valore predefinito è false.

string

Indica la corsa associata a questo SearchVehicleRequest.

CurrentTripsPresent

Indica se i veicoli con corse attive sono idonei per questa ricerca. Deve essere impostato su un valore diverso da CURRENT_TRIPS_PRESENT_UNSPECIFIED se trip_type include SHARED.

string

Campo facoltativo. Una query di filtro da applicare per la ricerca di veicoli. Vedi http://aip.dev/160 per esempi di sintassi del filtro.

Questo campo è progettato per sostituire i campi required_attributes, required_one_of_attributes e required_one_of_attributes_sets. Se qui viene specificato un valore non vuoto, i seguenti campi devono essere vuoti: required_attributes, required_one_of_attributes e required_one_of_attributes_sets.

Questo filtro funziona come una clausola AND con altri vincoli, come minimum_capacity o vehicle_types.

Tieni presente che le uniche query supportate sono relative agli attributi dei veicoli (ad es. attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Il numero massimo di limitazioni consentite in una query di filtro è 50.

Inoltre, tutti gli attributi vengono memorizzati come stringhe, pertanto gli unici confronti supportati con gli attributi sono i confronti di stringhe. Per eseguire un confronto con valori numerici o booleani, i valori devono essere racchiusi esplicitamente tra virgolette per essere trattati come stringhe (ad esempio attributes.<key> = "10" o attributes.<key> = "true").

VehicleMatch

Elenco di veicoli che soddisfano i criteri SearchVehiclesRequest, ordinati in base al campo SearchVehiclesRequest.order_by.

int32

L'indice iniziale di questo intervallo nel percorso. In JSON, quando l'indice è pari a 0, il campo apparirà non popolato.

int32

L'indice finale di questo intervallo nel percorso. In JSON, quando l'indice è pari a 0, il campo apparirà non popolato.

Speed

Velocità del traffico in questo intervallo.

LatLng

Obbligatorio. Indica la posizione effettiva.

Timestamp

Indica quando si è verificata la fermata.

Timestamp

Solo input. Deprecato. Utilizza il campo del timestamp.

LatLng

Obbligatorio. Indica la posizione di un waypoint di viaggio.

TerminalPointId

ID del punto di accesso.

string

Deprecato.

string

Deprecato.

WaypointType

Deprecato: Vehicle.waypoint avrà questi dati.

string

ID univoco del punto di accesso.

string

Deprecato.

string

Deprecato.

VisualTrafficReportPolylineRendering

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

string

Solo output. Nel formato "providers/{provider}/trips/{trip}"

string

ID del veicolo che effettua il viaggio.

TripStatus

Stato attuale della corsa.

TripType

Il tipo di viaggio.

TerminalLocation

Località in cui il cliente indica che verrà ritirato.

StopLocation

Solo input. Il luogo effettivo in cui e dove è stato preso il cliente. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive di ritiro.

StopLocation

Solo input. L'ora e il luogo effettivi dell'arrivo del conducente al punto di prelievo. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive dell'arrivo al punto di prelievo.

Timestamp

Solo output. L'ora futura stimata in cui i passeggeri verranno prelevati o l'ora effettiva in cui sono stati prelevati.

TerminalLocation

Fermate intermedie in modo che la corsa venga richiesta (oltre a prelievo e consegna). Inizialmente non sarà supportato per i viaggi condivisi.

Timestamp

Indica l'ultima volta che intermediate_destinations è stato modificato. Il server deve memorizzare nella cache questo valore e passarlo in UpdateTripRequest quando viene eseguito l'aggiornamento intermediate_destination_index per garantire che il valore intermediate_destinations non venga modificato.

int32

Quando TripStatus è ENROUTE_TO_INTERMEDIATE_DESTINATION, un numero compreso tra [0..N-1] e indica la destinazione intermedia che il veicolo attraverserà. Quando TripStatus è ARRIVED_AT_INTERMEDIATE_DESTINATION, un numero compreso tra [0..N-1] e indica la destinazione intermedia in cui si trova il veicolo. Il provider imposta questo valore. Se non sono presenti intermediate_destinations, questo campo viene ignorato.

StopLocation

Solo input. L'ora e il luogo effettivi dell'arrivo del conducente a una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sugli arrivi presso destinazioni intermedie.

StopLocation

Solo input. L'ora e il luogo effettivi in cui e dove il cliente è stato preso da una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni sul ritiro effettivo presso destinazioni intermedie.

TerminalLocation

Località in cui il cliente indica che andrà a buon fine.

StopLocation

Solo input. L'ora e il luogo effettivi in cui e dove il cliente è stato consegnato. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive di consegna.

Timestamp

Solo output. L'orario futuro stimato in cui i passeggeri verranno consegnati alla destinazione finale o l'ora effettiva in cui sono stati consegnati.

TripWaypoint

Solo output. Il percorso completo dalla posizione corrente al punto di consegna, incluso. Questo percorso potrebbe includere tappe di altri viaggi.

TripWaypoint

Questo campo supporta l'ordinamento manuale dei waypoint per la corsa. Contiene tutti i waypoint rimanenti per il veicolo assegnato, nonché i waypoint di prelievo e di discesa per questa corsa. Se la corsa non è stata assegnata a un veicolo, Fleet Engine ignora questo campo. Per motivi di privacy, questo campo viene compilato dal server solo nelle chiamate UpdateTrip e CreateTrip, NON nelle chiamate GetTrip.

LatLng

Solo output. Percorso previsto per questo viaggio per la prima entrata in restricted_waypoints. Tieni presente che il primo waypoint potrebbe appartenere a un'altra corsa.

string

Solo output. Un percorso codificato al waypoint successivo.

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

Timestamp

Solo output. Indica l'ultima volta che il percorso è stato modificato.

Nota: questo campo è destinato solo all'utilizzo da parte dell'SDK Driver e dell'SDK consumer.

ConsumableTrafficPolyline

Solo output. Indica le condizioni del traffico lungo il current_route_segment quando sono disponibili.

Nota: questo campo è destinato solo all'utilizzo da parte dell'SDK Driver e dell'SDK consumer.

Timestamp

Solo output. Indica l'ultima volta che current_route_segment_traffic è stato modificato.

Nota: questo campo è destinato solo all'utilizzo da parte dell'SDK Driver e dell'SDK consumer.

TripWaypoint

Solo output. Il waypoint in cui termina current_route_segment.

Int32Value

Solo output. La distanza in auto rimanente nel campo current_route_segment. Il valore non viene specificato se la corsa non è assegnata a un veicolo o se la corsa è completata o annullata.

Timestamp

Solo output. L'orario di arrivo stimato al waypoint successivo (la prima voce nel campo remaining_waypoints). Il valore non è specificato se la corsa non è assegnata a un veicolo o se la corsa non è attiva (completata o annullata).

Duration

Solo output. La durata dal momento in cui i dati del viaggio vengono restituiti al momento in Trip.eta_to_first_waypoint. Il valore non è specificato se la corsa non è assegnata a un veicolo o se la corsa non è attiva (completata o annullata).

Timestamp

Solo output. Indica l'ultima volta che remaining_waypoints è stato modificato (un waypoint è stato aggiunto, rimosso o modificato).

Timestamp

Solo output. Indica l'ultima volta che sono stati modificati remaining_waypoints.path_to_waypoint e remaining_waypoints.traffic_to_waypoint. L'app client deve memorizzare nella cache questo valore e passarlo in GetTripRequest per garantire che i percorsi e il traffico per remaining_waypoints vengano restituiti solo se aggiornati.

int32

Immutabile. Indica il numero di passeggeri su questa corsa e non include il conducente. Un veicolo deve avere capacità disponibile per essere restituito in una risposta SearchVehicles.

VehicleLocation

Solo output. Indica l'ultima posizione segnalata del veicolo lungo il percorso.

bool

Solo output. Indica se il valore last_location del veicolo può essere agganciato al valore current_route_segment. Falso se last_location o current_route_segment non esiste. Viene calcolato da Fleet Engine. Eventuali aggiornamenti dei client verranno ignorati.

TripView

Il sottoinsieme di campi Viaggio completati e come devono essere interpretati.

TerminalLocation

La posizione di questo waypoint.

string

La corsa associata a questo waypoint.

WaypointType

Il ruolo svolto da questo waypoint in questa corsa, ad esempio prelievo o discesa.

LatLng

Il percorso dal waypoint precedente a quello corrente. Non definito per il primo waypoint in un elenco. Questo campo viene compilato solo quando richiesto.

string

Il percorso codificato dal waypoint precedente al waypoint corrente.

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

ConsumableTrafficPolyline

Le condizioni del traffico lungo il percorso verso questo waypoint. Tieni presente che il traffico è disponibile solo per i clienti della soluzione Google Map Platform Rides and Deliveries Solution.

Int32Value

La distanza del percorso dal waypoint precedente al waypoint corrente. Non definito per il primo waypoint in un elenco.

Timestamp

L'ora di arrivo prevista a questo waypoint. Non definito per il primo waypoint in un elenco.

Duration

Il tempo di percorrenza dal waypoint precedente a questo punto. Non definito per il primo waypoint in un elenco.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}/trips/{trip}. Il provider deve essere l'ID progetto (ad esempio sample-consumer-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

Trip

Obbligatorio. Il viaggio associato all'aggiornamento.

I seguenti campi sono gestiti da Fleet Engine. Non aggiornarli utilizzando Trip.update.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

Quando aggiorni il Trip.vehicle_id per un viaggio condiviso, devi fornire l'elenco di Trip.vehicle_waypoints per specificare l'ordine dei waypoint rimanenti, altrimenti l'ordine non sarà determinato.

Se specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutti i waypoint rimanenti delle corse del veicolo, senza waypoint aggiuntivi. Devi ordinare questi waypoint in modo che, per una determinata corsa, il punto di prelievo sia prima delle destinazioni intermedie e che tutte le destinazioni intermedie siano prima del punto di partenza. I waypoint di una corsa EXCLUSIVE non devono interfogliare con altre corse. Vengono utilizzati i campi trip_id, waypoint_type e location, mentre tutti gli altri campi TripWaypoint in vehicle_waypoints vengono ignorati.

Per evitare una condizione di gara per corse con più destinazioni, devi fornire Trip.intermediate_destinations_version quando aggiorni lo stato della corsa in ENROUTE_TO_INTERMEDIATE_DESTINATION. Il valore Trip.intermediate_destinations_version passato deve essere coerente con la versione di Fleet Engine. In caso contrario, la richiesta non va a buon fine.

FieldMask

Obbligatorio. La maschera dei campi da aggiornare in Viaggio. update_mask deve contenere almeno un campo.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}/vehicles/{vehicle}. Il provider deve essere l'ID progetto (ad esempio sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

VehicleAttribute

Obbligatorio. Gli attributi del veicolo da aggiornare. Gli attributi non menzionati non vengono modificati o rimossi.

VehicleAttribute

Obbligatorio. L'elenco completo aggiornato degli attributi dei veicoli, inclusi quelli nuovi, modificati e non modificati.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}/vehicles/{vehicle}. {provider} deve essere l'ID progetto (ad esempio, sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

VehicleLocation

Obbligatorio. La posizione più recente del veicolo. I sottocampi location e update_time sono obbligatori.

VehicleState

Imposta lo stato del veicolo su ONLINE o OFFLINE. Se impostato su UNKNOWN_VEHICLE_STATE, lo stato del veicolo non verrà modificato.

RequestHeader

L'intestazione della richiesta standard Fleet Engine.

string

Obbligatorio. Deve essere nel formato providers/{provider}/vehicles/{vehicle}. {provider} deve essere l'ID progetto (ad esempio, sample-cloud-project) del progetto Google Cloud di cui è membro l'account di servizio che effettua la chiamata.

Vehicle

Obbligatorio. I valori dell'entità Vehicle da applicare. Quando aggiorni un elemento Vehicle, i seguenti campi potrebbero non essere aggiornati poiché sono gestiti dal server.

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

Se il campo attributes viene aggiornato, tutti gli attributi del veicolo vengono sostituiti con quelli forniti nella richiesta. Se vuoi aggiornare solo alcuni attributi, vedi il metodo UpdateVehicleAttributes.

Allo stesso modo, il campo waypoints può essere aggiornato, ma deve contenere tutti i waypoint attualmente sul veicolo e nessun altro.

FieldMask

Obbligatorio. Una maschera dei campi che indica i campi dell'Vehicle da aggiornare. È necessario specificare almeno un nome di campo.

string

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

VehicleState

Lo stato del veicolo.

TripType

Tipi di viaggio supportati da questo veicolo.

string

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

VehicleLocation

Ultima posizione segnalata del veicolo.

int32

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.

VehicleAttribute

Elenco di attributi del veicolo. Un veicolo può avere al massimo 100 attributi, ognuno dei quali deve avere una chiave univoca.

VehicleType

Obbligatorio. Il tipo di questo veicolo. Può essere utilizzato per filtrare i veicoli in SearchVehicles risultati. Influisce anche sull'orario di arrivo stimato e sui calcoli dei percorsi.

LicensePlate

Informazioni sulla targa del veicolo.

TerminalLocation

Deprecato: utilizza Vehicle.waypoints.

string

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

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

TrafficPolylineData

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.

Timestamp

Solo output. L'ora in cui è stato impostato current_route_segment. Può essere archiviata dal client e trasmessa nelle future richieste GetVehicle per impedire la restituzione di route che non sono cambiate.

TripWaypoint

Il waypoint in cui termina current_route_segment. Può essere fornito dai conducenti nelle chiamate UpdateVehicle come waypoint completo del viaggio, waypoint LatLng o come ultimo LatLng del current_route_segment. Fleet Engine farà quindi del suo meglio per interpolare a un waypoint effettivo se non è completamente specificato. Questo campo viene ignorato nelle chiamate UpdateVehicle, a meno che non venga specificato anche current_route_segment.

Int32Value

La distanza in auto rimanente per il current_route_segment. Questo valore viene restituito anche in Trip.remaining_distance_meters per tutte le corse attive assegnate al veicolo. Il valore non viene specificato se il campo current_route_segment è vuoto.

Timestamp

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

Quando aggiorni un veicolo, remaining_time_seconds ha la precedenza su eta_to_first_waypoint nella stessa richiesta.

Int32Value

Solo input. Il tempo di guida rimanente per il current_route_segment. Il valore non viene specificato se il campo waypoints è vuoto o il campo Vehicle.current_route_segment è vuoto. Questo valore deve corrispondere a eta_to_first_waypoint - current_time se tutte le parti utilizzano lo stesso orologio.

Quando aggiorni un veicolo, remaining_time_seconds ha la precedenza su eta_to_first_waypoint nella stessa richiesta.

TripWaypoint

I waypoint rimanenti assegnati a questo veicolo.

Timestamp

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

bool

Indica se il conducente accetta corse consecutive. Se true, SearchVehicles potrebbe includere il veicolo anche se è attualmente assegnato a una corsa. Il valore predefinito è false.

NavigationStatus

Lo stato di navigazione del veicolo.

DeviceSettings

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

Category

Categoria del tipo di veicolo

string

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

string

Il valore dell'attributo.

string

Valore dell'attributo di tipo stringa.

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

bool

Valore dell'attributo con tipo booleano.

double

Valore dell'attributo con doppio tipo.

VehicleAttribute

Un elenco di attributi in questa raccolta.

LatLng

La posizione del veicolo. Quando viene inviato a Fleet Engine, la posizione del veicolo è una posizione GPS. Quando la ricevi in risposta, la posizione del veicolo può essere una posizione GPS, una posizione supplementare o un'altra posizione stimata. L'origine è specificata in location_sensor.

DoubleValue

Deprecato: utilizza latlng_accuracy.

DoubleValue

Precisione di location in metri come raggio.

Int32Value

Senso di marcia del veicolo in gradi. 0 rappresenta il nord. L'intervallo valido è [0,360).

DoubleValue

Deprecato: utilizza heading_accuracy.

DoubleValue

Precisione di heading in gradi.

DoubleValue

Altitudine in metri sopra WGS84.

DoubleValue

Deprecato: utilizza altitude_accuracy.

DoubleValue

Precisione di altitude in metri.

Int32Value

Velocità del veicolo in chilometri orari. Deprecato: utilizza speed.

DoubleValue

Velocità del veicolo in metri/secondo

DoubleValue

Precisione di speed in metri/secondo.

Timestamp

L'ora in cui location è stato segnalato dal sensore in base all'orologio del sensore.

Timestamp

Solo output. L'ora in cui il server ha ricevuto le informazioni sulla posizione.

LocationSensor

Fornitore di dati sulla posizione (ad esempio, GPS).

BoolValue

Indica se location è agganciato a una strada.

BoolValue

Solo input. Indica se il sensore GPS è abilitato sul dispositivo portatile.

Int32Value

Solo input. Tempo (in secondi) dall'invio della posizione al server. Questo sarà pari a zero per il primo aggiornamento. Se l'ora non è nota (ad esempio, al riavvio dell'app), questo valore viene reimpostato su zero.

Int32Value

Solo input. Obsoleta: ora vengono utilizzati altri indicatori per determinare se una località è obsoleta.

LatLng

Posizione grezza del veicolo (non elaborata da Autosnapper).

Timestamp

Timestamp associato alla località non elaborata.

LocationSensor

Origine della località non elaborata. Il valore predefinito è GPS.

DoubleValue

Precisione di raw_location come raggio, in metri.

LatLng

Posizione supplementare fornita dall'app integrata.

Timestamp

Timestamp associato alla località supplementare.

LocationSensor

Origine della località supplementare. Il valore predefinito è CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Precisione di supplemental_location come raggio, in metri.

bool

Deprecato: utilizza is_road_snapped.

Vehicle

Obbligatorio. Un veicolo che soddisfa la richiesta.

Timestamp

L'orario di arrivo stimato del veicolo fino al punto di prelievo specificato nella richiesta. Un valore vuoto indica un errore nel calcolo dell'orario di arrivo stimato per il veicolo. Se SearchVehiclesRequest.include_back_to_back era true e questo veicolo ha una corsa attiva, vehicle_pickup_eta include il tempo necessario per completare la corsa attiva attuale.

Int32Value

La distanza dalla posizione attuale del veicolo al punto di prelievo specificato nella richiesta, inclusi eventuali punti di prelievo o di discesa intermedi per le corse esistenti. Questa distanza comprende la distanza calcolata in auto (percorso) e la distanza in linea retta tra il punto di arrivo della navigazione e il punto di prelievo richiesto. (La distanza tra il punto di arrivo della navigazione e il punto di prelievo richiesto è in genere ridotta.) Un valore vuoto indica un errore nel calcolo della distanza.

Int32Value

Obbligatorio. La distanza in linea retta tra il veicolo e il punto di prelievo specificato nella richiesta.

Timestamp

L'orario di arrivo stimato di guida del veicolo completo fino al punto di consegna specificato nella richiesta. L'orario di arrivo stimato include la sosta in qualsiasi waypoint prima del giorno dropoff_point specificato nella richiesta. Il valore verrà compilato solo quando nella richiesta viene specificato un punto di consegna. Un valore vuoto indica un errore nel calcolo dell'orario di arrivo stimato.

Int32Value

La distanza percorsa dal veicolo (in metri) dal punto di prelievo al punto di consegna specificato nella richiesta. La distanza è solo tra i due punti e non include la posizione del veicolo o altri punti che devono essere visitati prima che il veicolo visiti il punto di prelievo o di discesa. Il valore verrà compilato solo quando nella richiesta viene specificato un dropoff_point. Un valore vuoto indica un errore nel calcolo della distanza dal punto di prelievo al punto di partenza specificato nella richiesta.

TripType

Obbligatorio. Il tipo di corsa della richiesta utilizzata per calcolare l'orario di arrivo stimato al punto di prelievo.

Waypoint

L'elenco ordinato di waypoint utilizzati per calcolare l'orario di arrivo stimato. L'elenco include la posizione del veicolo, i punti di prelievo delle corse attive per il veicolo e i punti di prelievo forniti nella richiesta. Un elenco vuoto indica un errore nel calcolo dell'orario di arrivo stimato per il veicolo.

VehicleMatchType

Tipo di corrispondenza del veicolo.

VehicleMatchOrder

L'ordine richiesto per ordinare le corrispondenze dei veicoli.

VehicleMatchOrder

L'ordine effettivo utilizzato per questo veicolo. Normalmente corrisponde al campo "order_by" della richiesta; tuttavia, in determinate circostanze, ad esempio in un errore interno del server, è possibile utilizzare un metodo diverso (ad esempio PICKUP_POINT_STRAIGHT_DISTANCE).

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.

Style

Obbligatorio. Lo stile da applicare.

int32

Obbligatorio. Lo stile deve essere applicato tra [offset_meters, offset_meters + length_meters).

int32

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

LatLng

La posizione di questo waypoint.

Timestamp

L'ora stimata di arrivo del veicolo a questo waypoint.