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

Velocità del traffico lungo il percorso dalla tappa precedente a quella corrente.

string

Il percorso che il conducente sta seguendo dalla tappa precedente a quella 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 Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

string

Obbligatorio. ID viaggio univoco. Offerta soggetta alle seguenti limitazioni:

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

Trip

Obbligatorio. Entità viaggio da creare.

Quando crei un viaggio, i seguenti campi sono obbligatori:

• trip_type
• pickup_point

Vengono utilizzati i seguenti campi, se li fornisci:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Tutti gli altri campi Trip vengono ignorati. Ad esempio, tutti i viaggi iniziano con trip_status di NEW anche se superi un trip_status di CANCELED nella richiesta di creazione.

Solo EXCLUSIVE corse supportano intermediate_destinations.

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

Se specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutte le tappe rimanenti delle corse del veicolo, senza tappe aggiuntive. Devi ordinare queste tappe in modo che, per una determinata corsa, il punto di prelievo si trovi prima delle destinazioni intermedie e che tutte le destinazioni intermedie arrivino prima del punto di partenza. Le tappe di un percorso EXCLUSIVE non devono alternarsi con altre corse.

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

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

string

Obbligatorio. ID veicolo univoco. Offerta soggetta alle seguenti limitazioni:

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

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

bool

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

bool

Se il dispositivo è in stato interattivo.

BatteryInfo

Informazioni sullo stato della batteria.

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

TripView

Il sottoinsieme di campi Trip da restituire e la relativa interpretazione.

Timestamp

Indica il timestamp minimo (escluso) per il recupero dei dati di Trip.route o Trip.current_route_segment. Se i dati del percorso non sono stati modificati dopo questo timestamp, il campo del percorso non è impostato nella risposta. Se non viene specificato un numero minimo, i dati del percorso vengono sempre recuperati.

Timestamp

Indica il timestamp minimo (escluso) per il quale vengono recuperati i Trip.remaining_waypoints. Se rimangono invariati rispetto a questo timestamp, remaining_waypoints non viene impostato nella risposta. Se questo campo non viene specificato, viene sempre recuperato remaining_waypoints.

PolylineFormatType

Il formato attuale del percorso 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 (escluso) per il quale viene recuperato Trip.current_route_segment_traffic. Se i dati sul traffico non sono stati modificati 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 On-Demand Rides and Deliveries Solution.

Timestamp

Indica il timestamp minimo (escluso) per il recupero dei dati di Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint. Se i dati non sono stati modificati dopo questo 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 Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

Timestamp

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

Timestamp

Indica il timestamp minimo (escluso) per il quale vengono recuperati i dati di Vehicle.waypoints. Se le tappe non sono state modificate dopo questo timestamp, i dati di vehicle.waypoints non vengono impostati nella risposta. Se questo campo non viene specificato, viene sempre recuperato vehicle.waypoints.

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 Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

int32

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

string

Il valore del valore next_page_token fornito da una precedente chiamata a ListVehicles per consentire l'impaginazione in base ai gruppi di veicoli. Il valore non è definito se i criteri di filtro della richiesta non corrispondono a quelli per la 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 fissi che trasmettono ancora 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 tipo specificate. Non consentito: UNKNOWN.

string

I chiamanti possono formare 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 una lista di liste. La combinazione dei due campi consente di comporre 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 massimo 50 attributi obbligatori. Corrisponde al numero massimo di attributi consentiti su un veicolo. Ogni stringa ripetuta deve avere il formato "chiave:valore".

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

Analogamente a required_one_of_attributes, required_one_of_attribute_sets utilizza un messaggio che consente un elenco di elenchi, consentendo espressioni come questa:

(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. All'interno di ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni operazione VehicleAttributeList e 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 del veicolo.

bool

Restituisci solo i veicoli con le corse in corso.

string

(Facoltativo) Una query di filtro da applicare nella scheda dei veicoli. Vedi http://aip.dev/160 per esempi di sintassi dei filtri.

Questo campo è progettato per sostituire i campi required_attributes, required_one_of_attributes e required_one_of_attributes_sets. Se in questo campo 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 clausola AND con altri vincoli, ad esempio vehicle_state o on_trip_only.

Tieni presente che le uniche query supportate riguardano gli attributi del veicolo (ad es. attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Il numero massimo di restrizioni 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 il confronto con valori numerici o booleani, i valori devono essere tra virgolette in modo esplicito per essere trattati come stringhe (ad esempio, attributes.<key> = "10" o attributes.<key> = "true").

Viewport

(Facoltativo) Un filtro che limita i veicoli restituiti a quelli la cui ultima posizione nota era nell'area rettangolare definita dall'area visibile.

Vehicle

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

string

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

int64

Obbligatorio. Numero totale di veicoli corrispondenti 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 l'account di servizio che effettua questa chiamata è membro.

string

Obbligatorio. Il codice paese di due lettere del paese in cui si svolge il viaggio. Il prezzo è definito in base al codice paese.

BillingPlatformIdentifier

La piattaforma su cui è stata inviata la richiesta.

string

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

SolutionType

Il tipo di soluzione di prodotto GMP (ad esempio 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, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se non viene specificato nulla, la risposta potrebbe essere in qualsiasi lingua, con una preferenza per l'inglese, se questo nome esiste. 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 che chiama, 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 la chiamata. Esempi di valori di campi: 4.4.1, 12.1.

string

Modello del dispositivo su cui è in esecuzione l'SDK per la chiamata. Esempi di valori di campi: iPhone12,1, SM-G920F.

SdkType

Il tipo di SDK che invia la richiesta.

string

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

string

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

Platform

Piattaforma dell'SDK che chiama.

string

Produttore del dispositivo Android dall'SDK di chiamata, applicabile solo per gli SDK Android. Esempio di valore del campo: Samsung.

int32

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

string

ID facoltativo che può essere fornito a scopo di logging al fine di identificare la richiesta.

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

string

Il veicolo associato alle corse nella richiesta. Se non specificati, 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 i viaggi che influenzano il percorso del conducente.

int32

Se non viene configurato, è il server a decidere 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 in SearchTripsRequest per sfogliare i risultati dell'elenco. L'API restituisce un elenco di corse per ogni chiamata e, quando non sono disponibili altri risultati, l'elenco delle corse è vuoto.

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

TerminalLocation

Obbligatorio. Il punto di prelievo vicino a cui cercare.

TerminalLocation

Il punto di consegna previsto dal 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 che si trovano 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 (incluso).

int32

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

TripType

Obbligatorio. Rappresenta il tipo di viaggio proposto. Deve includere esattamente un tipo. Non consentito: UNKNOWN_TRIP_TYPE. Restringe la ricerca solo ai veicoli in grado di supportare quel tipo di viaggio.

Duration

Limita la ricerca ai veicoli che hanno inviato aggiornamenti di posizione a Fleet Engine entro il periodo di tempo specificato. I veicoli fissi che trasmettono ancora la loro posizione non sono considerati inattivi. Se questo campo non viene configurato, 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 tipi di veicoli con categoria UNKNOWN non sono consentiti.

VehicleAttribute

I chiamanti possono formare 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 una lista di liste. La combinazione dei due campi consente di comporre 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 ai veicoli con gli attributi specificati. Questo campo è un'operazione congiunzione/AND. Sono consentiti massimo 50 attributi obbligatori. Corrisponde al numero massimo di attributi consentiti su un veicolo.

VehicleAttributeList

Limita la ricerca ai soli 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 elemento 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 questa:

(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 ai veicoli con tutti gli attributi in un VehicleAttributeList. All'interno di ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni operazione VehicleAttributeList e 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 sola corsa attiva sono idonei per questa ricerca. Questo campo viene utilizzato solo se current_trips_present non è specificato. Se il criterio current_trips_present non è specificato e questo campo è false, i veicoli con corse assegnate vengono esclusi dai risultati di ricerca. Se il criterio current_trips_present non è specificato e questo campo è true, i risultati di ricerca possono includere veicoli con una corsa attiva con stato ENROUTE_TO_DROPOFF. Quando current_trips_present è specificato, questo campo non può essere impostato su true.

Il valore predefinito è false.

string

Indica il viaggio associato a 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

(Facoltativo) Una query di filtro da applicare quando cerchi veicoli. Vedi http://aip.dev/160 per esempi di sintassi dei filtri.

Questo campo è progettato per sostituire i campi required_attributes, required_one_of_attributes e required_one_of_attributes_sets. Se in questo campo 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 clausola AND con altri vincoli, ad esempio minimum_capacity o vehicle_types.

Tieni presente che le uniche query supportate riguardano gli attributi del veicolo (ad es. attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Il numero massimo di restrizioni 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 il confronto con valori numerici o booleani, i valori devono essere tra virgolette in modo esplicito per essere trattati come stringhe (ad esempio, attributes.<key> = "10" o attributes.<key> = "true").

VehicleMatch

Elenco dei 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, se l'indice è 0, il campo sembrerà non popolato.

int32

L'indice finale di questo intervallo nel percorso. In JSON, se l'indice è 0, il campo sembrerà non popolato.

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

LatLng

Obbligatorio. Indica la posizione di una tappa di viaggio.

TerminalPointId

Deprecato: specifica il campo point.

string

Deprecato: specifica il campo point.

string

Deprecato.

WaypointType

Deprecato: Vehicle.waypoint avrà questi dati.

string

Deprecato.

string

Deprecato.

string

Deprecato.

VisualTrafficReportPolylineRendering

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

string

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

string

ID del veicolo che effettua la corsa.

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 di quando e dove il cliente è stato ritirato. Questo campo consente al fornitore di fornire un feedback sulle effettive informazioni sul 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 sull'arrivo al punto di prelievo.

Timestamp

Solo output. L'orario futuro stimato in cui verranno ritirati i passeggeri o l'ora effettiva in cui sono stati prelevati.

TerminalLocation

Fermate intermedie in ordine di richiesta della corsa (oltre a partenza e arrivo). Inizialmente, questa funzionalità non sarà supportata per i viaggi condivisi.

Timestamp

Indica l'ultima volta che intermediate_destinations è stato modificato. Il server deve memorizzare nella cache questo valore e passarlo a UpdateTripRequest quando aggiorna 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 [0..N-1] indica la destinazione intermedia che verrà attraversata dal veicolo. Quando TripStatus è ARRIVED_AT_INTERMEDIATE_DESTINATION, un numero compreso tra [0..N-1] e [0..N-1] 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 in cui arriva il conducente a una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sull'arrivo alle destinazioni intermedie.

StopLocation

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

TerminalLocation

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

StopLocation

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

Timestamp

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

TripWaypoint

Solo output. Il percorso completo dalla posizione corrente al punto di discesa, incluso. Questo percorso potrebbe includere tappe di altre corse.

TripWaypoint

Questo campo supporta l'ordinamento manuale delle tappe della corsa. Contiene tutte le tappe rimanenti per il veicolo assegnato, nonché le tappe di partenza e arrivo 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 durante le chiamate UpdateTrip e CreateTrip, NON per le chiamate GetTrip.

LatLng

Solo output. Percorso previsto per questo viaggio al primo ingresso nei restanti_way. Tieni presente che la prima tappa potrebbe appartenere a una corsa diversa.

string

Solo output. Un percorso codificato alla tappa successiva.

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 waypoint dove finisce current_route_segment.

Int32Value

Solo output. La distanza di guida 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 alla tappa successiva (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 tra il momento in cui i dati del viaggio vengono restituiti all'ora indicata 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 (una tappa è stata aggiunta, rimossa o modificata).

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 a GetTripRequest per garantire che i percorsi e il traffico per remaining_waypoints vengano restituiti solo se aggiornati.

int32

Immutabile. Indica il numero di passeggeri di 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 last_location del veicolo può essere agganciato all'attuale_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 Trip compilati e come devono essere interpretati.

TerminalLocation

La posizione di questa tappa.

string

La corsa associata a questa tappa.

WaypointType

Il ruolo di questa tappa in questa corsa, ad esempio prelievo o ritorno.

LatLng

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

string

Il percorso codificato dalla tappa precedente a quella 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 verso questa tappa. Tieni presente che il traffico è disponibile solo per i clienti di Google Map Platform Rides and Deliveries Solution.

Int32Value

La distanza del percorso dalla tappa precedente a quella corrente. Non definito per il primo waypoint in un elenco.

Timestamp

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

Duration

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

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

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 Trip.vehicle_id per una corsa condivisa, devi fornire l'elenco di Trip.vehicle_waypoints per specificare l'ordine delle tappe rimanenti, altrimenti l'ordine sarà indeterminato.

Se specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutte le tappe rimanenti delle corse del veicolo, senza tappe aggiuntive. Devi ordinare queste tappe in modo che, per una determinata corsa, il punto di prelievo si trovi prima delle destinazioni intermedie e che tutte le destinazioni intermedie arrivino prima del punto di partenza. Le tappe di un percorso EXCLUSIVE non devono alternarsi con altre corse. Vengono utilizzati i campi trip_id, waypoint_type e location, mentre tutti gli altri campi di TripWaypoint in vehicle_waypoints vengono ignorati.

Per evitare una condizione di gara per i viaggi 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 trasmesso deve essere coerente con la versione di Fleet Engine. In caso contrario, la richiesta non va a buon fine.

FieldMask

Obbligatorio. La maschera di campo che indica quali campi di Viaggio aggiornare. update_mask deve contenere almeno un campo.

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

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 del veicolo, inclusi quelli nuovi, alterati e intatti.

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

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 l'account di servizio che effettua questa chiamata è membro.

Vehicle

Obbligatorio. I valori dell'entità Vehicle da applicare. Quando aggiorni un 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 gli attributi 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 di 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 di questo veicolo. Il driver 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 100 attributi e ogni attributo 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 sul calcolo dell'orario di arrivo stimato e dei percorsi.

LicensePlate

Informazioni sulla targa del veicolo.

TerminalLocation

Deprecato: usa invece Vehicle.waypoints.

string

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

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

Timestamp

Solo output. Ora in cui è stata impostata la funzionalità current_route_segment. Può essere archiviato dal client e passato nelle future richieste di GetVehicle per impedire la restituzione di route che non sono state modificate.

TripWaypoint

Il waypoint dove finisce current_route_segment. Può essere fornito dai conducenti nelle chiamate UpdateVehicle come tappa completa, tappa LatLng o come ultima LatLng current_route_segment. Fleet Engine farà del proprio meglio per interpolare fino a una tappa effettiva se non è completamente specificata. 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. Se il campo current_route_segment è vuoto, il valore non è specificato.

Timestamp

L'orario di arrivo stimato della 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. 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

Le tappe rimanenti assegnate a questo veicolo.

Timestamp

Solo output. L'ultima volta che il campo waypoints è stato aggiornato. I client devono memorizzare nella cache questo valore e trasmetterlo a GetVehicleRequest per garantire che il campo waypoints venga restituito solo se viene aggiornato.

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 tipo di stringa.

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

bool

Valore di attributo digitato con valore booleano.

double

Valore attributo 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 una 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: usa invece latlng_accuracy.

DoubleValue

Precisione di location in metri come raggio.

Int32Value

La direzione di spostamento del veicolo in gradi. 0 rappresenta il nord. L'intervallo valido è [0,360).

DoubleValue

Deprecato: usa invece heading_accuracy.

DoubleValue

Precisione di heading in gradi.

DoubleValue

Altitudine in metri sopra WGS84.

DoubleValue

Deprecato: usa invece altitude_accuracy.

DoubleValue

Precisione di altitude in metri.

Int32Value

Velocità del veicolo in chilometri orari. Deprecato: usa invece speed.

DoubleValue

Velocità del veicolo in metri/secondo

DoubleValue

Precisione di speed in metri al secondo.

Timestamp

L'ora in cui il sensore ha segnalato location 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 per la prima volta. Il valore sarà 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 del veicolo grezzo (non elaborata da un esperto di autovelox).

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 di integrazione.

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: usa invece is_road_snapped.

Vehicle

Obbligatorio. Un veicolo che corrisponde alla richiesta.

Timestamp

L'orario di arrivo stimato del veicolo fino al punto di ritiro 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 attuale.

Int32Value

La distanza dalla posizione attuale del Veicolo al punto di prelievo specificato nella richiesta, inclusi eventuali punti di partenza o di arrivo intermedi per le corse esistenti. Questa distanza comprende la distanza calcolata in auto (percorso), più la distanza in linea retta tra il punto di arrivo della navigazione e il punto di prelievo richiesto. In genere, la distanza tra il punto di arrivo della navigazione e il punto di prelievo richiesto è 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 in auto completo del veicolo fino al punto di consegna specificato nella richiesta. L'orario di arrivo stimato include la sosta in qualsiasi tappa 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 di guida (in metri) del veicolo dal punto di prelievo al punto di riconsegna specificato nella richiesta. La distanza si trova solo tra i due punti e non include la posizione del veicolo o qualsiasi altro punto che deve essere visitato prima che il veicolo visiti il punto di prelievo o scarico. Il valore verrà compilato solo quando nella richiesta viene specificato un valore dropoff_point. Un valore vuoto indica un errore nel calcolo della distanza dal punto di ritiro dal punto di consegna specificato nella richiesta.

TripType

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

Waypoint

L'elenco ordinato di tappe utilizzate per calcolare l'orario di arrivo stimato. L'elenco include la posizione del veicolo, i punti di partenza delle corse attive per il veicolo e i punti di ritiro forniti 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 ordinare le corrispondenze dei veicoli.

VehicleMatchOrder

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

RoadStretch

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

In assenza di un tratto stradale, il cliente deve applicare il valore predefinito al percorso.

Style

Obbligatorio. Lo stile da applicare.

int32

Obbligatorio. Lo stile deve essere applicato nell'intervallo [offset_meters, offset_meters + length_meters).

int32

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

LatLng

La posizione di questa tappa.

Timestamp

L'ora stimata di arrivo del veicolo in questa tappa.