Package maps.fleetengine.v1

BatteryStatus

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

PowerSource

Stato della fonte di alimentazione della batteria.

float

Percentuale attuale della batteria [0-100].

SpeedReadingInterval

La velocità del traffico lungo il percorso dal Waypoint precedente al Waypoint attuale.

string

Il percorso che il conducente sta seguendo dal Waypoint precedente al Waypoint attuale. Questo percorso contiene punti di riferimento in modo che i clienti possano mostrare indicatori di traffico lungo il percorso (vedi speed_reading_interval). La decodifica non è ancora supportata.

RequestHeader

L'intestazione della richiesta standard di 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 questa chiamata.

string

Obbligatorio. ID viaggio univoco. Soggetti alle seguenti limitazioni:

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

Trip

Obbligatorio. Entità del 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 Trip vengono ignorati. Ad esempio, tutte le corse iniziano con un trip_status pari a NEW anche se superi un valore trip_status di CANCELED nella richiesta di creazione.

Solo le corse EXCLUSIVE supportano intermediate_destinations.

Se l'opzione vehicle_id è impostata per una corsa condivisa, devi fornire l'elenco di Trip.vehicle_waypoints per specificare l'ordine dei tappe rimanenti per il veicolo, altrimenti l'ordine dei tappe sarà indeterminato.

Quando specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutti i tappe rimanenti delle corse del veicolo, senza ulteriori tappe. È necessario ordinare questi tappe in modo che, per una determinata corsa, il punto di partenza si trovi prima delle destinazioni intermedie e tutte le destinazioni intermedie precedono il punto di partenza. I tappe di una corsa EXCLUSIVE non devono interconnettersi 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 di 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 questa chiamata.

string

Obbligatorio. ID veicolo univoco. Soggetti alle seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Lunghezza massima di 64 caratteri.
• Normalizzato 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

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

bool

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

bool

Indica se il dispositivo è in stato interattivo.

BatteryInfo

Informazioni sullo stato della batteria.

RequestHeader

L'intestazione della richiesta standard di 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 questa 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 del percorso non vengono modificati a partire da questo timestamp, il campo del percorso 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 Trip.remaining_waypoints. Se rimangono invariati rispetto a questo timestamp, gli remaining_waypoints non vengono impostati nella risposta. Se questo campo non viene specificato, il campo remaining_waypoints viene sempre recuperato.

PolylineFormatType

Il formato del percorso 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 rimangono invariati dopo questo timestamp, il campo current_route_segment_traffic non è 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.

Timestamp

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati i dati di Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint. Se i dati non vengono modificati dopo il timestamp indicato, 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 di 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 questa 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 punti intermedi non vengono modificati dopo questo 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.

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

RequestHeader

L'intestazione della richiesta standard di 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 questa 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 precedente chiamata 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 loro 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 tipi 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 un elenco di elenchi. 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 congiunzione/AND. Sono consentiti al massimo 50 attributi obbligatori. 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. All'interno di 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 essere nel formato "chiave1:valore1|chiave2:valore2|chiave3:valore3".

string

required_one_of_attribute_sets fornisce funzionalità aggiuntive.

Analogamente 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 di un VehicleAttributeList. In ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni operazione VehicleAttributeList e disgiunzione/OR inclusiva nella raccolta di VehicleAttributeList. Ogni stringa ripetuta deve essere nel 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 si pubblicano schede di veicoli. Vedi http://aip.dev/160 per esempi sulla sintassi dei filtri.

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 riguardano gli attributi dei veicoli (ad esempio, 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 quelli di stringhe. Per eseguire confronti 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 coloro la cui ultima posizione nota era nell'area rettangolare definita dall'area visibile.

Vehicle

Veicoli che soddisfano i 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 questa 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, ID sessione) di operazioni di prenotazione anticipata effettuate 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 la corsa registrata.

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 è specificato alcun valore, la risposta può essere in qualsiasi lingua, con una preferenza per l'inglese se tale nome esiste. Esempio di valore del campo: en-US.

string

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

string

Versione dell'SDK per la chiamata, 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 della chiamata. Esempi di valori del campo: 4.4.1, 12.1.

string

Modello del dispositivo su cui è in esecuzione l'SDK di chiamata. 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 di chiamata, 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 di chiamata.

string

Produttore del dispositivo Android dell'SDK di chiamata; applicabile soltanto per gli SDK Android. Esempio di valore del campo: Samsung.

int32

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

RequestHeader

L'intestazione della richiesta standard di 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 questa 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 impostato, il server decide il numero di risultati da restituire.

string

Impostalo 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 SearchTripsRequest per sfogliare i risultati dell'elenco. L'API restituisce un elenco delle corse per ogni chiamata e quando non rimangono più risultati, l'elenco delle corse è vuoto.

RequestHeader

L'intestazione della richiesta standard di 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 questa chiamata.

TerminalLocation

Obbligatorio. Il punto di partenza per la ricerca nelle vicinanze.

TerminalLocation

Il luogo di ritiro previsto del cliente. Il campo è obbligatorio se trip_types contiene TripType.SHARED.

int32

Obbligatorio. Definisce il raggio di ricerca del veicolo intorno al punto di ritiro. Verranno restituiti solo i veicoli inclusi nel 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 uno. Il conducente non viene considerato nel valore della capacità.

TripType

Obbligatorio. Rappresenta il tipo di viaggio proposto. I veicoli idonei sono quelli che possono supportare almeno uno dei tipi di corsa specificati.

EXCLUSIVE e SHARED potrebbero non essere inclusi insieme. SHARED non è supportato quando current_trips_present è CURRENT_TRIPS_PRESENT_UNSPECIFIED. UNKNOWN_TRIP_TYPE non è consentito.

Duration

Limita la ricerca solo ai veicoli che hanno inviato aggiornamenti di posizione a Fleet Engine nell'intervallo di tempo specificato. I veicoli fermi che continuano a trasmettere la loro posizione non sono considerati inattivi. Se questo campo non viene impostato, il server utilizza cinque minuti come valore predefinito.

VehicleType

Obbligatorio. Limita la ricerca ai veicoli con uno dei tipi specificati. È necessario specificare almeno un tipo di veicolo. I veicoli 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 un elenco di elenchi. 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 congiunzione/AND. Sono consentiti al massimo 50 attributi obbligatori. 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. All'interno di 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.

Analogamente 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 presenti in un VehicleAttributeList. In ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni operazione VehicleAttributeList e disgiunzione/OR inclusiva nella raccolta di VehicleAttributeList.

VehicleMatchOrder

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

bool

Indica se un veicolo con una singola corsa attiva è idoneo per un'altra corrispondenza. Se false, i veicoli a cui sono state assegnate corse sono esclusi dai risultati di ricerca. Se true, i risultati di ricerca includono i veicoli con TripStatus di ENROUTE_TO_DROPOFF.

Questo campo viene considerato solo se viene specificato un singolo trip_type di EXCLUSIVE.

Il valore predefinito è false.

string

Indica la corsa associata a SearchVehicleRequest.

CurrentTripsPresent

Impedisce la visualizzazione dei veicoli nei risultati di ricerca in base alle corse correnti.

Quando current_trips_present è NONE o ANY, trip_types può essere EXCLUSIVE o SHARED, ma non entrambi.

string

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

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 riguardano gli attributi dei veicoli (ad esempio, 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 quelli di stringhe. Per eseguire confronti 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 corrispondono ai 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 sembra non essere compilato.

int32

L'indice finale di questo intervallo nel percorso. In JSON, quando l'indice è pari a 0, il campo sembra non essere compilato.

Speed

Velocità del traffico in questo intervallo.

LatLng

Obbligatorio. Indica la posizione effettiva.

Timestamp

Indica quando si è verificata l'interruzione.

Timestamp

Solo input. Deprecato. Utilizza il campo del timestamp.

LatLng

Obbligatorio. Indica la posizione di un tappe del viaggio.

TerminalPointId

ID del punto di accesso al terminale.

string

Deprecato.

string

Deprecato.

WaypointType

Obsoleto: Vehicle.waypoint disporrà di questi dati.

string

ID univoco del punto di arrivo.

string

Deprecato.

string

Deprecato.

VisualTrafficReportPolylineRendering

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

string

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

string

Documento di identità del veicolo che effettua il viaggio.

TripStatus

Stato attuale della corsa.

TripType

Il tipo di viaggio.

TerminalLocation

Luogo in cui il cliente indica che verrà ritirato.

StopLocation

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

StopLocation

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

Timestamp

Solo output. L'orario futuro stimato in cui verranno prelevati i passeggeri oppure l'ora effettiva in cui questi ultimi sono stati prelevati.

TerminalLocation

Fermate intermedie in modo che la corsa venga richiesta (oltre a prelievo e discesa). 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 durante l'aggiornamento di intermediate_destination_index per garantire che 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 intermediate_destinations non è presente, 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 relative agli arrivi presso destinazioni intermedie.

StopLocation

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

TerminalLocation

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

StopLocation

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

Timestamp

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

TripWaypoint

Solo output. Il percorso completo dalla posizione corrente al punto di uscita, incluso. Questo percorso può includere tappe di altri viaggi.

TripWaypoint

Questo campo supporta l'ordinamento manuale dei tappe per la corsa. Contiene tutti i punti tappe rimanenti per il veicolo assegnato, nonché i punti di partenza e di arrivo della 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 al primo ingresso in remaining_waypoints. Tieni presente che il primo tappe potrebbe appartenere a un'altra corsa.

string

Solo output. Un percorso codificato al tappe successivo.

Nota: questo campo è destinato esclusivamente 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 esclusivamente 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 esclusivamente 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 esclusivamente all'utilizzo da parte dell'SDK Driver e dell'SDK Consumer.

TripWaypoint

Solo output. Il tappa in cui termina current_route_segment.

Int32Value

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

Timestamp

Solo output. L'orario di arrivo stimato per il tappa 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. Il periodo di tempo 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 tappe è stato aggiunto, rimosso o modificato).

Timestamp

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

int32

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

VehicleLocation

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

bool

Solo output. Indica se l'elemento last_location del veicolo può essere agganciato a current_route_segment. Falso se last_location o current_route_segment non esiste. Il calcolo viene eseguito da Fleet Engine. Eventuali aggiornamenti dei client verranno ignorati.

TripView

Il sottoinsieme dei campi Trip che vengono compilati e come devono essere interpretati.

TerminalLocation

La posizione di questo tappa.

string

La corsa associata a questo tappa.

WaypointType

Il ruolo che questo tappa svolge nella corsa, come la salita o la discesa.

LatLng

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

string

Il percorso codificato dal Waypoint precedente al Waypoint corrente.

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

ConsumableTrafficPolyline

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

Int32Value

La distanza del percorso dal Waypoint precedente a quello attuale. Non definito per il primo tappe in un elenco.

Timestamp

L'orario di arrivo previsto a questo tappa. Non definito per il primo tappe in un elenco.

Duration

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

RequestHeader

L'intestazione della richiesta standard di 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 questa chiamata.

Trip

Obbligatorio. Il viaggio associato all'aggiornamento.

I campi seguenti 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 Trip.vehicle_id per un viaggio condiviso, devi fornire l'elenco di Trip.vehicle_waypoints per specificare l'ordine dei tappe rimanenti, altrimenti l'ordine sarà indeterminato.

Quando specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutti i tappe rimanenti delle corse del veicolo, senza ulteriori tappe. È necessario ordinare questi tappe in modo che, per una determinata corsa, il punto di partenza si trovi prima delle destinazioni intermedie e tutte le destinazioni intermedie precedono il punto di partenza. I tappe di una corsa EXCLUSIVE non devono interconnettersi 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 che indica quali campi della corsa aggiornare. update_mask deve contenere almeno un campo.

RequestHeader

L'intestazione della richiesta standard di 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 questa chiamata.

VehicleAttribute

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

VehicleAttribute

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

RequestHeader

L'intestazione della richiesta standard di 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 fa parte l'account di servizio che effettua questa chiamata.

VehicleLocation

Obbligatorio. La posizione più recente del veicolo. I campi secondari 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à alterato.

RequestHeader

L'intestazione della richiesta standard di 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 fa parte l'account di servizio che effettua questa chiamata.

Vehicle

Obbligatorio. I valori dell'entità Vehicle da applicare. Quando aggiorni un Vehicle, i seguenti campi potrebbero non essere aggiornati poiché vengono 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, consulta il metodo UpdateVehicleAttributes.

Allo stesso modo, il campo waypoints può essere aggiornato, ma deve contenere tutte le tappe attualmente sul veicolo e nessun altro.

FieldMask

Obbligatorio. Una maschera di campo che indica quali campi dell'elemento Vehicle aggiornare. Devi 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 viene considerato in questo valore. Questo valore deve essere maggiore o uguale a uno.

VehicleAttribute

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

VehicleType

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

LicensePlate

Informazioni sulla targa del veicolo.

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.

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.

Timestamp

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

TripWaypoint

Il tappa in cui termina current_route_segment. Questo dato può essere fornito dai conducenti nelle chiamate UpdateVehicle come tappo completo del viaggio, come tappa LatLng o come ultimo LatLng del current_route_segment. 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 UpdateVehicle, a meno che non venga specificato anche current_route_segment.

Int32Value

Distanza percorsa 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 è specificato se il campo current_route_segment è vuoto.

Timestamp

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, 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 è 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 eta_to_first_waypoint - current_time.

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

TripWaypoint

I restanti Waypoint assegnati a questo veicolo.

Timestamp

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.

bool

Indica se il conducente accetta corse di andata e ritorno. 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 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 string_value. Se sono impostati entrambi, string_value e value devono essere identici, altrimenti verrà generato un errore. Entrambi i campi vengono compilati nelle risposte.

bool

Valore dell'attributo con digitazione booleano.

double

Valore dell'attributo con doppia digitazione.

VehicleAttribute

Un elenco di attributi in questa raccolta.

LatLng

La posizione del veicolo. Quando viene inviata 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

Obsoleto: utilizza latlng_accuracy.

DoubleValue

Precisione di location metri come raggio.

Int32Value

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

DoubleValue

Obsoleto: utilizza heading_accuracy.

DoubleValue

Precisione di heading in gradi.

DoubleValue

Altitudine in metri sopra WGS84.

DoubleValue

Obsoleto: utilizza altitude_accuracy.

DoubleValue

Precisione di altitude in metri.

Int32Value

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

DoubleValue

Velocità del veicolo in metri al secondo

DoubleValue

Precisione di speed in metri al 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 mobile.

Int32Value

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

Int32Value

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

LatLng

Posizione del veicolo non elaborata (non elaborata da uno sparatutto).

Timestamp

Timestamp associato alla posizione non elaborata.

LocationSensor

Origine della località non elaborata.

DoubleValue

Precisione di raw_location come raggio, in metri.

LatLng

Posizione supplementare fornita dall'app di integrazione.

Timestamp

Timestamp associato alla località supplementare.

LocationSensor

Origine della località supplementare.

DoubleValue

Precisione di supplemental_location come raggio, in metri.

bool

Obsoleto: utilizza is_road_snapped.

Vehicle

Obbligatorio. Un veicolo che corrisponde alla richiesta.

Timestamp

L'orario di arrivo stimato di guida del veicolo fino al punto di partenza 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 in quel momento.

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 percorsa in auto calcolata e la distanza in linea retta tra il punto di arrivo della navigazione e il punto di partenza richiesto. La distanza tra il punto di arrivo della navigazione e il punto di partenza 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 ritiro 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 l'interruzione in qualsiasi tappa prima del dropoff_point specificato nella richiesta. Il valore viene compilato solo quando nella richiesta viene specificato un punto di abbandono. Un valore vuoto indica un errore nel calcolo dell'orario di arrivo stimato.

Int32Value

La distanza di guida del veicolo (in metri) dal punto di partenza al punto di partenza 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 partenza 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 partenza al punto di partenza specificato nella richiesta.

TripType

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

Waypoint

L'elenco ordinato di tappe utilizzato per calcolare l'orario di arrivo stimato. L'elenco include la posizione del veicolo, i punti di ritiro delle corse attive e i punti di ritiro indicati nella richiesta. Un elenco vuoto indica un errore nel calcolo dell'orario di arrivo stimato del veicolo.

VehicleMatchType

Tipo di veicolo corrispondente.

VehicleMatchOrder

L'ordine richiesto per lo smistamento del veicolo corrisponde.

VehicleMatchOrder

L'ordine effettivo utilizzato per questo veicolo. Normalmente questo corrisponderà al campo "order_by" della richiesta; tuttavia, in determinate circostanze, come un errore interno del server, potrebbe essere utilizzato un metodo diverso (ad esempio PICKUP_POINT_STRAIGHT_DISTANCE).

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

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

Timestamp

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