Package maps.fleetengine.v1

BatteryStatus

Stato della batteria, se è carica o in carica e così via.

PowerSource

Stato dell'alimentazione a batteria.

float

Percentuale attuale della batteria [0-100].

SpeedReadingInterval

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

string

Il percorso seguito dal conducente dal waypoint precedente a quello attuale. Questo percorso contiene punti di riferimento in modo che i client possano mostrare indicatori di traffico lungo il percorso (vedi speed_reading_interval). La decodifica non è ancora supportata.

RequestHeader

L'intestazione della richiesta di 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 corsa univoco. Fatte salve le seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Sono consentiti massimo 64 caratteri.
• Normalizzato in base al formato di normalizzazione Unicode C.
• Non può contenere nessuno dei seguenti caratteri ASCII: '/', ':', '?', ',' o '#'.

Trip

Obbligatorio. L'entità di viaggio da creare.

Quando crei un viaggio, i seguenti campi sono obbligatori:

• trip_type
• pickup_point

I seguenti campi vengono utilizzati se li fornisci:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Tutti gli altri campi relativi alla corsa vengono ignorati. Ad esempio, tutti i viaggi iniziano con un trip_status di NEW anche se nella richiesta di creazione viene passato un trip_status di CANCELED.

Solo le corse EXCLUSIVE supportano intermediate_destinations.

Quando vehicle_id è impostato per un viaggio condiviso, 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à definito.

Quando specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutti i waypoint rimanenti dei viaggi del veicolo, senza waypoint aggiuntivi. Devi ordinare questi waypoint in modo che, per una determinata corsa, il punto di ritiro sia prima delle destinazioni intermedie e tutte le destinazioni intermedie siano prima del punto di consegna. I waypoint di un viaggio EXCLUSIVE non devono essere interlacciati con quelli di altri viaggi.

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

RequestHeader

L'intestazione della richiesta di 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. Fatte salve le seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Sono consentiti massimo 64 caratteri.
• Normalizzato in base al formato di normalizzazione Unicode 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 è attiva la modalità di 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 di 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 di Trip che devono essere restituiti e la relativa interpretazione.

Timestamp

Indica il timestamp minimo (esclusivo) per cui vengono recuperati i dati Trip.route o Trip.current_route_segment. Se i dati del percorso non sono stati modificati da questo timestamp, il campo route non è impostato nella risposta. Se non è specificato un valore minimo, i dati del percorso vengono sempre recuperati.

Timestamp

Indica il timestamp minimo (esclusivo) per cui vengono recuperati i valori Trip.remaining_waypoints. Se non sono stati modificati da questo timestamp, i valori remaining_waypoints non sono impostati nella risposta. Se questo campo non è specificato, viene sempre recuperato remaining_waypoints.

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 cui viene recuperato Trip.current_route_segment_traffic. Se i dati sul traffico non sono cambiati da questo timestamp, il campo current_route_segment_traffic non è impostato nella risposta. Se non viene specificato un valore minimo, i dati sul traffico vengono sempre recuperati. Tieni presente che il traffico è disponibile solo per i clienti della soluzione Trasporto passeggeri e consegne on demand.

Timestamp

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

RequestHeader

L'intestazione della richiesta di 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 (esclusivo) per cui viene recuperato Vehicle.current_route_segment. Se il percorso non è cambiato da questo timestamp, il campo current_route_segment non è impostato nella risposta. Se non è specificato un valore minimo, current_route_segment viene sempre recuperato.

Timestamp

Indica il timestamp minimo (esclusivo) per cui vengono recuperati i dati Vehicle.waypoints. Se i waypoint non sono stati modificati da questo timestamp, i dati vehicle.waypoints non sono impostati nella risposta. Se questo campo non è 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.

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

RequestHeader

L'intestazione della richiesta di 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 di next_page_token fornito da una chiamata precedente a ListVehicles per poter eseguire la paginazione dei gruppi di veicoli. Il valore è non definito se i criteri di filtro della richiesta non sono gli stessi 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. 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 della posizione a Fleet Engine entro la durata specificata. 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 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 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 di congiunzione/AND. È consentito un massimo di 50 attributi obbligatori. Corrisponde al numero massimo di attributi consentiti per 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 inclusiva/OR 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 offre 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 VehicleAttributeList e un'operazione di disgiunzione/OR inclusiva nell'intera 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

Restituire solo i veicoli con i viaggi in corso.

string

Facoltativo. Una query di filtro da applicare quando vengono elencati i veicoli. Visita la pagina 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 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, 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 limitazioni consentite in una query filtro è 50.

Inoltre, tutti gli attributi vengono archiviati come stringhe, pertanto gli unici confronti supportati per gli attributi sono i confronti di stringhe. Per eseguire il confronto con valori numerici o booleani, i valori devono essere racchiusi tra virgolette esplicite 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 si trovava nell'area rettangolare definita dall'area visibile.

Vehicle

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

string

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

int64

Obbligatorio. Numero totale di veicoli corrispondenti ai criteri di 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. 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 emessa la richiesta.

string

Gli identificatori direttamente correlati al viaggio segnalato. In genere si tratta di ID (ad es. ID sessione) di operazioni di prenotazione 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) utilizzata per la corsa segnalata.

string

Il codice lingua BCP-47, ad esempio en-US o sr-Latn. Per ulteriori informazioni, visita la pagina 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 da cui ha avuto origine la richiesta. Esempio di valore del campo: US.

string

Versione dell'SDK chiamante, 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 chiamante. Esempi di valori di campo: 4.4.1, 12.1.

string

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

SdkType

Il tipo di SDK che invia la richiesta.

string

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

string

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

Platform

Piattaforma dell'SDK chiamante.

string

Produttore del dispositivo Android dall'SDK chiamante, applicabile solo agli SDK Android. Esempio di valore di campo: Samsung.

int32

Il livello API Android dell'SDK chiamante, applicabile solo agli SDK Android. Esempio di valore del campo: 23.

string

ID facoltativo che può essere fornito a fini di registrazione per identificare la richiesta.

RequestHeader

L'intestazione della richiesta di 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 ai viaggi nella richiesta. Se non specificato, i percorsi restituiti 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 influiscono sul percorso di un conducente.

int32

Se non è impostato, 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 dei viaggi per il veicolo richiesto.

string

Passa questo token in SearchTripsRequest per visualizzare i risultati dell'elenco. L'API restituisce un elenco di corse a ogni chiamata e, quando non ci sono più risultati, l'elenco è vuoto.

RequestHeader

L'intestazione della richiesta di 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 ritiro nelle vicinanze in cui effettuare la ricerca.

TerminalLocation

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

int32

Obbligatorio. Definisce il raggio di ricerca dei veicoli intorno al punto di ritiro. Verranno restituiti solo i veicoli all'interno del raggio di ricerca. Il valore deve essere compreso tra 400 e 10000 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 un viaggio. Il valore deve essere maggiore o uguale a 1. Il conducente 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. Limita la ricerca solo ai veicoli che supportano quel tipo di viaggio.

Duration

Limita la ricerca solo ai veicoli che hanno inviato aggiornamenti sulla posizione a Fleet Engine entro la durata specificata. I veicoli fermi che continuano a trasmettere la propria posizione non sono considerati inattivi. Se questo campo non è 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 tipi di veicoli con una 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 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 di congiunzione/AND. È consentito un massimo di 50 attributi obbligatori. Corrisponde al numero massimo di attributi consentiti per 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 inclusiva/OR in ogni VehicleAttributeList e un'operazione di congiunzione/AND nella raccolta di VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets offre 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 solo 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 VehicleAttributeList e un'operazione di disgiunzione/OR inclusiva nell'intera 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. Quando current_trips_present non è specificato e questo campo è false, i veicoli con corse assegnate vengono esclusi dai risultati di ricerca. Quando current_trips_present non è specificato e questo campo è true, i risultati di ricerca possono includere veicoli con un viaggio attivo con stato ENROUTE_TO_DROPOFF. Quando viene specificato current_trips_present, questo campo non può essere impostato su true.

Il valore predefinito è false.

string

Indica il viaggio associato a questo SearchVehicleRequest.

CurrentTripsPresent

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

string

Facoltativo. Una query filtro da applicare durante la ricerca dei veicoli. Visita la pagina 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 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, 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 limitazioni consentite in una query filtro è 50.

Inoltre, tutti gli attributi vengono archiviati come stringhe, pertanto gli unici confronti supportati per gli attributi sono i confronti di stringhe. Per il confronto con valori numerici o booleani, i valori devono essere racchiusi tra virgolette esplicite per essere trattati come stringhe (ad es. 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 è 0, il campo sembra non essere compilato.

int32

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

Speed

Velocità del traffico in questo intervallo.

LatLng

Obbligatorio. Indica la posizione effettiva.

Timestamp

Indica quando si è verificato l'arresto.

Timestamp

Solo input. Deprecato. Utilizza il campo timestamp.

LatLng

Obbligatorio. Indica la posizione di un punto di passaggio della corsa.

TerminalPointId

Ritiro: specifica invece il campo point.

string

Ritiro: specifica invece il campo point.

string

Deprecato.

WaypointType

Ritiro: Vehicle.waypoint avrà questi dati.

string

Deprecato.

string

Deprecato.

string

Deprecato.

VisualTrafficReportPolylineRendering

Un rendering di polilinee che mostra la velocità del traffico per tutte le regioni lungo un tratto del tragitto di un 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 di essere disponibile per il ritiro.

StopLocation

Solo input. La posizione effettiva in cui e quando il cliente è stato ritirato. Questo campo è destinato al fornitore per fornire un feedback sulle informazioni effettive sul ritiro.

StopLocation

Solo input. L'ora e la posizione effettive dell'arrivo del conducente al punto di ritiro. Questo campo è destinato al fornitore per fornire feedback sulle informazioni sull'arrivo effettivo al punto di ritiro.

Timestamp

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

TerminalLocation

Fermate intermedie richieste per la corsa (oltre a quelle di partenza e di 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 in UpdateTripRequest quando aggiorna intermediate_destination_index per assicurarsi che intermediate_destinations non venga modificato.

int32

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

StopLocation

Solo input. L'ora e la posizione effettive dell'arrivo del conducente a una destinazione intermedia. Questo campo consente al fornitore di fornire feedback sulle informazioni effettive sull'arrivo alle destinazioni intermedie.

StopLocation

Solo input. L'ora e la posizione effettive in cui e quando il cliente è stato ritirato da una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sul ritiro nelle destinazioni intermedie.

TerminalLocation

Località in cui il cliente indica di essere in attesa.

StopLocation

Solo input. L'ora e la posizione effettive in cui il cliente è stato scaricato. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sul ritiro.

Timestamp

Solo output. L'ora futura stimata in cui i passeggeri verranno lasciati alla destinazione finale o l'ora effettiva in cui sono stati lasciati.

TripWaypoint

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

TripWaypoint

Questo campo supporta l'ordinamento manuale dei waypoint per il viaggio. Contiene tutti i waypoint rimanenti per il veicolo assegnato, nonché i waypoint di ritiro e riconsegna per questo viaggio. 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 per le chiamate UpdateTrip e CreateTrip, NON per le chiamate GetTrip.

LatLng

Solo output. Percorso previsto per questo viaggio fino alla prima voce in remaining_waypoints. Tieni presente che il primo waypoint potrebbe appartenere a un viaggio diverso.

string

Solo output. Un percorso codificato per il waypoint 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 la current_route_segment, se 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 in cui termina 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 o se è 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 è inattiva (completata o annullata).

Duration

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

Timestamp

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

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

int32

Immutabile. Indica il numero di passeggeri di questo viaggio e non include il conducente. Un veicolo deve avere una 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 a current_route_segment. False se last_location o current_route_segment non esiste. Viene calcolato da Fleet Engine. Eventuali aggiornamenti dei clienti verranno ignorati.

TripView

Il sottoinsieme di campi relativi alla corsa che vengono compilati e come devono essere interpretati.

TerminalLocation

La posizione di questo waypoint.

string

Il viaggio associato a questo waypoint.

WaypointType

Il ruolo di questo waypoint in questo viaggio, ad esempio ritiro o consegna.

LatLng

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

string

Il percorso codificato dal waypoint precedente a quello 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 fino a questo waypoint. Tieni presente che il traffico è disponibile solo per i clienti della soluzione per corse e consegne di Google Maps Platform.

Int32Value

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

Timestamp

L'orario di arrivo stimato in 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 di 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. La corsa associata 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 sarà indeterminato.

Quando specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutti i waypoint rimanenti dei viaggi del veicolo, senza waypoint aggiuntivi. Devi ordinare questi waypoint in modo che, per una determinata corsa, il punto di ritiro sia prima delle destinazioni intermedie e tutte le destinazioni intermedie siano prima del punto di consegna. I waypoint di un viaggio EXCLUSIVE non devono essere interlacciati con quelli di altri viaggi. Vengono utilizzati i campi trip_id, waypoint_type e location e tutti gli altri campi 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 del viaggio su 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 di Viaggio aggiornare. update_mask deve contenere almeno un campo.

RequestHeader

L'intestazione della richiesta di 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 alterati o rimossi.

VehicleAttribute

Obbligatorio. L'elenco completo aggiornato degli attributi del veicolo, inclusi quelli nuovi, modificati e invariati.

RequestHeader

L'intestazione della richiesta di 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 perché 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, consulta il metodo UpdateVehicleAttributes.

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

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 del veicolo. Il formato è providers/{provider}/vehicles/{vehicle}.

VehicleState

Lo stato del veicolo.

TripType

Tipi di viaggi supportati da questo veicolo.

string

Solo output. Elenco di trip_id per i viaggi attualmente assegnati a questo veicolo.

VehicleLocation

Ultima posizione segnalata del veicolo.

int32

Il numero totale di passeggeri che il veicolo può trasportare. Il conducente non viene considerato in questo valore. Questo valore deve essere maggiore o uguale a 1.

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 veicolo. Può essere utilizzato per filtrare i veicoli nei risultati di SearchVehicles. Influisce anche sui calcoli dell'orario di arrivo stimato e del percorso.

LicensePlate

Dati della targa del veicolo.

TerminalLocation

Deprecato: utilizza Vehicle.waypoints.

string

La polilinea che specifica il percorso che l'app del conducente intende seguire fino al waypoint successivo. Questo elenco viene restituito anche in Trip.current_route_segment per tutti i viaggi attivi assegnati 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 dei percorsi. Nota: questo campo è destinato esclusivamente all'uso da parte dell'SDK Driver.

Timestamp

Solo output. Ora in cui è stato impostato current_route_segment. Può essere memorizzato dal client e trasmesso in richieste GetVehicle future per impedire il ritorno a percorsi che non sono stati modificati.

TripWaypoint

Il waypoint in cui termina current_route_segment. Questo valore può essere fornito dai conducenti durante le chiamate UpdateVehicle come waypoint per l'intero viaggio, come waypoint LatLng o come ultimo LatLng del current_route_segment. Fleet Engine farà del suo meglio per eseguire l'interpolazione fino a un punto di passaggio effettivo se non è completamente specificato. Questo campo viene ignorato nelle chiamate a UpdateVehicle, a meno che non venga specificato anche current_route_segment.

Int32Value

La distanza in auto rimanente per current_route_segment. Questo valore viene restituito anche in Trip.remaining_distance_meters per tutti i viaggi attivi assegnati 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 se 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 current_route_segment. Il valore non è specificato se il campo waypoints è vuoto o se 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. Data dell'ultimo aggiornamento del campo waypoints. I client devono memorizzare nella cache questo valore e passarlo in GetVehicleRequest per assicurarsi che il campo waypoints venga restituito solo se aggiornato.

bool

Indica se il conducente accetta viaggi consecutivi. Se true, SearchVehicles può includere il veicolo anche se al momento è assegnato a un viaggio. 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 il carattere due punti (:).

string

Il valore dell'attributo.

string

Valore dell'attributo di tipo stringa.

Nota: questo campo è identico al campo value, che verrà ritirato in futuro. Per i metodi di creazione o aggiornamento, puoi utilizzare uno dei due campi, ma ti consigliamo vivamente di utilizzare string_value. Se sono impostati sia string_value sia value, questi devono essere identici, altrimenti verrà generato un errore. Entrambi i campi vengono compilati nelle risposte.

bool

Valore dell'attributo di tipo booleano.

double

Valore dell'attributo con tipo doppio.

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 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: utilizza latlng_accuracy.

DoubleValue

Precisione di location metri come raggio.

Int32Value

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

DoubleValue

Deprecato: utilizza heading_accuracy.

DoubleValue

Precisione di heading gradi.

DoubleValue

Altitudine in metri sopra WGS84.

DoubleValue

Deprecato: utilizza altitude_accuracy.

DoubleValue

Precisione di altitude metri.

Int32Value

Velocità del veicolo in chilometri all'ora. Deprecato: utilizza speed.

DoubleValue

Velocità del veicolo in metri/secondo

DoubleValue

Precisione di speed metri/secondo.

Timestamp

L'ora in cui location è stato registrato 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 iniziale di questa posizione al server. Sarà pari a zero per il primo aggiornamento. Se l'ora è sconosciuta (ad esempio quando l'app si riavvia), questo valore viene reimpostato su zero.

Int32Value

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

LatLng

Posizione non elaborata del veicolo (non elaborata da RoadSnapper).

Timestamp

Timestamp associato alla posizione non elaborata.

LocationSensor

Origine della posizione 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 stazione di ricarica 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 corrisponde alla richiesta.

Timestamp

L'orario di arrivo stimato del veicolo al punto di ritiro specificato nella richiesta. Un valore vuoto indica un errore nel calcolo dell'orario di arrivo stimato del 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 corrente.

Int32Value

La distanza dalla posizione attuale del veicolo al punto di ritiro specificato nella richiesta, inclusi eventuali punti di ritiro o di consegna intermedi per i viaggi 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 ritiro richiesto. La distanza tra il punto di arrivo della navigazione e il punto di ritiro 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 del veicolo al punto di consegna specificato nella richiesta. L'orario di arrivo stimato include le soste presso eventuali waypoint prima del dropoff_point specificato nella richiesta. Il valore verrà inserito 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 in auto (in metri) del veicolo dal punto di ritiro 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 ritiro o quello di consegna. Il valore verrà inserito solo quando nella richiesta viene specificato un dropoff_point. Un valore vuoto indica un errore nel calcolo della distanza dal punto di ritiro al punto di consegna specificato nella richiesta.

TripType

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

Waypoint

L'elenco ordinato di waypoint utilizzati per calcolare l'orario di arrivo stimato. L'elenco include la posizione del veicolo, i punti di ritiro dei viaggi attivi 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 corrispondenza del veicolo.

VehicleMatchOrder

L'ordine richiesto per l'ordinamento delle corrispondenze dei veicoli. Equivalente a ordered_by.

VehicleMatchOrder

L'ordine richiesto per l'ordinamento delle corrispondenze dei veicoli. Equivalente a requested_ordered_by.

RoadStretch

Facoltativo. Tratti stradali che devono essere visualizzati lungo la polilinea. È garantito che i tratti non si sovrappongono e non coprono necessariamente l'intero percorso.

In assenza di un tratto di strada da stilizzare, il client deve applicare il valore predefinito per il percorso.

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 in cui applicare lo stile.

LatLng

La posizione di questo waypoint.

Timestamp

L'ora stimata in cui il veicolo arriverà a questo waypoint.