Package maps.fleetengine.v1

BatteryStatus

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

PowerSource

Stato della fonte di alimentazione della batteria.

float

Percentuale attuale della batteria [0-100].

SpeedReadingInterval

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

string

Il percorso che l'autista sta seguendo 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 Fleet Engine standard.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il fornitore 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.

string

Obbligatorio. ID viaggio univoco. Soggetto alle seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Limitato a una lunghezza massima di 64 caratteri.
• Normalizzato in base al modulo di normalizzazione Unicode C.
• Non può contenere i seguenti caratteri ASCII: '/', ':', '?', ',' o '#'.

Trip

Obbligatorio. Entità del 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 del viaggio vengono ignorati. Ad esempio, tutti i viaggi iniziano con un trip_status di NEW anche se nella richiesta di creazione viene specificato un trip_status di CANCELED.

Solo i viaggi 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à determinato.

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 un determinato viaggio, il punto di partenza sia precedente alle destinazioni intermedie e tutte le destinazioni intermedie precedano il punto di arrivo. I waypoint di un viaggio EXCLUSIVE non devono essere intervallati da 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 Fleet Engine standard.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il fornitore 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.

string

Obbligatorio. ID veicolo univoco. Soggetto alle seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Limitato a una lunghezza massima di 64 caratteri.
• Normalizzato in base al modulo di normalizzazione Unicode C.
• Non può contenere i seguenti caratteri ASCII: '/', ':', '?', ',' o '#'.

Vehicle

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

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

RequestHeader

(Facoltativo) L'intestazione della richiesta Fleet Engine standard.

string

Obbligatorio. Deve essere nel formato providers/{provider}/trips/{trip}. Il fornitore 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.

RequestHeader

(Facoltativo) 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 fa parte l'account di servizio che effettua questa chiamata.

LocationPowerSaveMode

Come si comportano le funzionalità di localizzazione sul dispositivo quando è attiva la funzionalità 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 Fleet Engine standard.

string

Obbligatorio. Deve essere nel formato providers/{provider}/trips/{trip}. Il fornitore 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.

TripView

Il sottoinsieme di campi di Trip da restituire 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 sono invariati da questo timestamp, il campo del percorso non viene impostato nella risposta. Se non viene specificato un minimo, i dati dell'itinerario vengono sempre recuperati.

Timestamp

Deprecato: Trip.remaining_waypoints vengono sempre recuperati. Utilizza remaining_waypoints_route_version per controllare quando vengono recuperati i dati di Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint.

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 sono invariati rispetto a questo timestamp, il campo current_route_segment_traffic non viene 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 il quale vengono recuperati i dati Trip.remaining_waypoints.traffic_to_waypoint e Trip.remaining_waypoints.path_to_waypoint. Se i dati non sono stati modificati da 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 fornitore 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.

Timestamp

Indica il timestamp minimo (esclusivo) per cui viene recuperato Vehicle.current_route_segment. Se il percorso è rimasto invariato da questo timestamp, il campo current_route_segment non viene impostato nella risposta. Se non viene specificato un valore minimo, viene sempre recuperato il valore current_route_segment.

Timestamp

Indica il timestamp minimo (esclusivo) per il quale vengono recuperati i dati Vehicle.waypoints. Se i waypoint sono invariati rispetto a questo timestamp, i dati vehicle.waypoints non vengono 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 nella targa non è presente alcun valore numerico.

• "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 fornitore 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.

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 in modo da poter scorrere le pagine dei gruppi di veicoli. Il valore non è definito se i criteri di filtro della richiesta non sono gli stessi dei criteri di filtro della chiamata precedente a ListVehicles.

Int32Value

Specifica la capacità minima richiesta del veicolo. Tutti i veicoli restituiti avranno un 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 viaggio specificati.

Duration

Limita la risposta ai veicoli che hanno inviato aggiornamenti della posizione a Fleet Engine entro la durata specificata. I veicoli fermi che trasmettono ancora la loro posizione non vengono 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. Insieme, 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 required_attributes. 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 di 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 inclusiva/OR nella raccolta di VehicleAttributeList. Ogni stringa ripetuta deve avere il formato "chiave1:valore1|chiave2:valore2|chiave3:valore3".

VehicleState

Limita la risposta ai veicoli con questo stato.

bool

Restituisci solo i veicoli con viaggi in corso.

string

(Facoltativo) Una query di filtro da applicare quando vengono elencati i veicoli. Consulta la pagina http://aip.dev/160 per esempi della sintassi del filtro.

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

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

Tieni presente che le uniche query supportate riguardano gli attributi del veicolo (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 archiviati come stringhe, pertanto gli unici confronti supportati con gli attributi sono i confronti tra stringhe. Per eseguire il confronto con valori numerici o booleani, i valori devono essere esplicitamente tra virgolette 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 che corrispondono 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 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 fornitore 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.

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. Si tratta in genere di ID (ad esempio, ID sessione) di operazioni di pre-prenotazione eseguite prima che l'ID viaggio sia disponibile. Il numero di related_ids è limitato a 50.

SolutionType

Il tipo di soluzione di prodotto GMP (ad esempio ON_DEMAND_RIDESHARING_AND_DELIVERIES) utilizzata per il viaggio segnalato.

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

string

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

string

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

string

La versione del sistema operativo su cui è in esecuzione l'SDK di chiamata. Esempi di valori dei campi: 4.4.1, 12.1.

string

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

SdkType

Il tipo di SDK che invia la richiesta.

string

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

string

Versione dell'SDK di navigazione 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 del campo: Samsung.

int32

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 scopo di registrazione per identificare la richiesta.

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il fornitore 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.

string

Il veicolo associato ai viaggi nella richiesta. Se non specificato, i viaggi 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 influenzano il percorso di un autista.

int32

Se non è impostato, il server decide il numero di risultati da restituire.

string

Imposta questo valore su un valore restituito in precedenza nel campo 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 scorrere i risultati dell'elenco. L'API restituisce un elenco di viaggi a ogni chiamata e, quando non rimangono più risultati, l'elenco di viaggi è vuoto.

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

string

Obbligatorio. Deve essere nel formato providers/{provider}. Il fornitore 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.

TerminalLocation

Obbligatorio. Il punto di ritiro da cercare nelle vicinanze.

TerminalLocation

La destinazione prevista 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 all'interno del raggio di ricerca. Il valore deve essere compreso tra 400 e 10.000 metri (inclusi).

int32

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

int32

Obbligatorio. Specifica il numero di passeggeri da considerare per un viaggio. Il valore deve essere maggiore o uguale a uno. Il conducente non viene preso in considerazione nel valore della capacità.

TripType

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

Duration

Limita la ricerca ai soli veicoli che hanno inviato aggiornamenti della posizione a Fleet Engine entro la durata specificata. I veicoli fermi che trasmettono ancora la loro posizione non vengono 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. VehicleTypes con una categoria di 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. Insieme, 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 required_attributes. 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 inclusiva/OR nella raccolta di VehicleAttributeList.

VehicleMatchOrder

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

bool

Indica se i veicoli con una singola corsa attiva sono idonei per questa ricerca. Questo campo viene utilizzato solo quando current_trips_present non è specificato. Quando current_trips_present non è specificato e questo campo è false, i veicoli con viaggi assegnati 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. Se trip_type include SHARED, questo valore deve essere impostato su un valore diverso da CURRENT_TRIPS_PRESENT_UNSPECIFIED.

string

(Facoltativo) Una query di filtro da applicare durante la ricerca dei veicoli. Consulta la pagina http://aip.dev/160 per esempi della sintassi del filtro.

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

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

Tieni presente che le uniche query supportate riguardano gli attributi del veicolo (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 archiviati come stringhe, pertanto gli unici confronti supportati con gli attributi sono i confronti tra stringhe. Per eseguire il confronto con valori numerici o booleani, i valori devono essere esplicitamente tra virgolette per essere trattati come stringhe (ad esempio, attributes.<key> = "10" o attributes.<key> = "true").

VehicleMatch

Elenco dei 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 è 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 è verificata la fermata.

Timestamp

Solo input. Deprecato. Utilizza il campo timestamp.

LatLng

Indica l'LatLng esatto della tappa. È necessario specificare point o place come input. Se vengono specificati entrambi, point verrà utilizzato per il routing e place per i metadati. Se viene specificato solo place come input, point verrà calcolato a partire da place e incluso nell'output.

string

Il nome della risorsa del luogo che rappresenta questa posizione. Il formato è places/{place_id}. È necessario specificare point o place come input. Se vengono specificati entrambi, point verrà utilizzato per il routing e place per i metadati. place è incluso nell'output solo se era incluso nell'input, il che significa che non viene eseguita alcuna ricerca di place da LatLng.

Questa è una funzione sperimentale.

PointSource

Solo output. L'origine del campo point.

TerminalPointId

Obsoleto: specifica invece il campo place.

string

Obsoleto: specifica invece il campo place.

string

Deprecato.

WaypointType

Ritirato: Vehicle.waypoint avrà questi dati.

string

Deprecato.

string

Deprecato.

string

Deprecato.

VisualTrafficReportPolylineRendering

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

string

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

string

ID del veicolo che effettua questo viaggio.

TripStatus

Stato attuale del viaggio.

TripType

Il tipo di viaggio.

TerminalLocation

La località in cui il cliente indica che verrà prelevato.

StopLocation

Solo input. La posizione effettiva in cui il cliente è stato prelevato. Questo campo consente al fornitore di fornire un feedback sulle informazioni di ritiro effettive.

StopLocation

Solo input. L'ora e il luogo effettivi di arrivo dell'autista al punto di partenza. Questo campo consente al fornitore di fornire feedback sulle informazioni sull'arrivo effettivo al punto di ritiro.

Timestamp

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

TerminalLocation

Le fermate intermedie nell'ordine in cui sono state richieste (oltre al punto di partenza e alla destinazione). Inizialmente, questa funzionalità non sarà supportata per i viaggi condivisi.

Timestamp

Indica l'ultima volta che è stato modificato il intermediate_destinations. 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] 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. Il fornitore imposta questo valore. Se non sono presenti intermediate_destinations, questo campo viene ignorato.

StopLocation

Solo input. L'ora e il luogo effettivi dell'arrivo del conducente in una destinazione intermedia. Questo campo consente al fornitore di fornire feedback sulle informazioni sull'arrivo effettivo nelle 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 feedback sulle informazioni di ritiro effettive presso le destinazioni intermedie.

TerminalLocation

La località in cui il cliente indica che verrà accompagnato.

StopLocation

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

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 del viaggio. Contiene tutti i waypoint rimanenti per il veicolo assegnato, nonché i waypoint di ritiro e riconsegna per questo viaggio. Se il viaggio non è stato assegnato 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 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 al waypoint successivo.

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

Timestamp

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

Nota: questo campo è destinato esclusivamente all'uso da parte di Driver SDK e Consumer SDK.

ConsumableTrafficPolyline

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

Nota: questo campo è destinato esclusivamente all'uso da parte di Driver SDK e Consumer SDK.

Timestamp

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

Nota: questo campo è destinato esclusivamente all'uso da parte di Driver SDK e Consumer SDK.

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 il viaggio non è assegnato a un veicolo oppure se è stato completato o annullato.

Timestamp

Solo output. L'ETA al waypoint successivo (la prima voce nel campo remaining_waypoints). Il valore non è specificato se il viaggio non è assegnato a un veicolo o se il viaggio è inattivo (completato o annullato).

Duration

Solo output. La durata dal momento in cui i dati del viaggio vengono restituiti all'ora in Trip.eta_to_first_waypoint. Il valore non è specificato se il viaggio non è assegnato a un veicolo o se il viaggio è inattivo (completato o annullato).

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 sono stati modificati remaining_waypoints.path_to_waypoint e remaining_waypoints.traffic_to_waypoint. L'app client deve memorizzare nella cache questo valore e passarlo in GetTripRequest per garantire che i percorsi e il traffico per remaining_waypoints vengano restituiti solo se aggiornati.

int32

Immutabile. Indica il numero di passeggeri di questo viaggio 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 al current_route_segment. False se last_location o current_route_segment non esiste. Viene calcolato da Fleet Engine. Qualsiasi aggiornamento da parte dei client verrà ignorato.

TripView

Il sottoinsieme di campi del viaggio compilati e il modo in cui devono essere interpretati.

TripAttribute

Un elenco di attributi di viaggio personalizzati. Ogni attributo deve avere una chiave univoca.

string

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

string

Valore dell'attributo di tipo stringa.

bool

Valore dell'attributo di tipo booleano.

double

Valore dell'attributo di tipo double.

TerminalLocation

La posizione di questo waypoint.

string

Il viaggio associato a questo waypoint.

WaypointType

Il ruolo che svolge questo waypoint nel viaggio, ad esempio ritiro o consegna.

LatLng

Il percorso dal waypoint precedente a quello attuale. Se si tratta del primo waypoint, il percorso va dalla posizione attuale del veicolo al waypoint. Questo campo viene compilato solo su richiesta.

string

Il percorso codificato dal waypoint precedente a quello attuale.

Nota: questo campo è destinato esclusivamente all'uso da parte di Driver SDK e Consumer SDK. 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 Rides and Deliveries di Google Maps Platform.

Int32Value

La distanza del percorso dal waypoint precedente a quello attuale. Se questo è il primo waypoint, la distanza del percorso è dalla posizione attuale del veicolo al waypoint.

Timestamp

L'orario di arrivo stimato a questo waypoint.

Duration

Il tempo di viaggio dal waypoint precedente a questo waypoint. Se si tratta del primo waypoint, il tempo di percorrenza è dalla posizione attuale del veicolo al waypoint.

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

string

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

Trip

Obbligatorio. La corsa associata all'aggiornamento.

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

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 un determinato viaggio, il punto di partenza sia precedente alle destinazioni intermedie e tutte le destinazioni intermedie precedano il punto di arrivo. I waypoint di un viaggio EXCLUSIVE non devono essere intervallati da 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 race condition per i viaggi con più destinazioni, devi fornire Trip.intermediate_destinations_version quando aggiorni lo stato del viaggio a ENROUTE_TO_INTERMEDIATE_DESTINATION. Il Trip.intermediate_destinations_version superato 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 del 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 fornitore 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.

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, modificati e invariati.

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

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

FieldMask

Obbligatorio. Una maschera di campo che indica quali campi di Vehicle aggiornare. Specifica 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 viaggi supportati da questo veicolo.

string

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

VehicleLocation

Ultima posizione segnalata del veicolo.

VehicleLocation

Solo input. Luoghi in cui si trovava questo veicolo in passato e che non sono ancora stati segnalati a Fleet Engine. Questo valore viene utilizzato in UpdateVehicleRequest per registrare le posizioni che in precedenza non era possibile inviare al server. In genere, questo accade quando il veicolo non ha connettività a internet.

int32

Il numero totale di passeggeri che questo veicolo può trasportare. Il conducente non è incluso 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 ciascun 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'ETA e del percorso.

LicensePlate

Informazioni sulla targa del veicolo.

TerminalLocation

Deprecato: utilizza Vehicle.waypoints.

string

La polilinea che specifica il percorso che l'app per i conducenti 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 del viaggio. 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 nelle richieste GetVehicle future per evitare di restituire percorsi che non sono cambiati.

TripWaypoint

Il waypoint in cui termina current_route_segment. Queste informazioni possono essere fornite dai conducenti durante le chiamate al numero UpdateVehicle come waypoint completo della corsa, come waypoint LatLng o come ultimo LatLng del current_route_segment. Fleet Engine farà del suo meglio per interpolare un waypoint effettivo se non è completamente specificato. Questo campo viene ignorato nelle chiamate UpdateVehicle, a meno che non venga specificato anche current_route_segment.

Int32Value

La distanza rimanente da percorrere 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'ETA 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 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 se viene aggiornato.

bool

Indica se l'autista accetta corse consecutive. 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. Per i metodi di creazione o aggiornamento, è possibile utilizzare uno dei due campi, ma è vivamente consigliato di utilizzare string_value. Se sono impostati sia string_value sia value, 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 di tipo double.

VehicleAttribute

Un elenco degli attributi in questa raccolta.

LatLng

La posizione del veicolo. Quando viene inviata a Fleet Engine, la posizione del veicolo è una posizione GPS. Quando lo 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 movimento 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 il 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 in metri/secondo.

Timestamp

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

Timestamp

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

LocationSensor

Fornitore dei 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) trascorso da quando questa posizione è stata inviata per la prima volta al server. Questo 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. Obsoleto: ora vengono utilizzati altri indicatori per determinare se una posizione è obsoleta.

LatLng

Posizione grezza del veicolo (non elaborata da road-snapper).

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

La posizione fornita da Fused Location Provider di Android.

Timestamp

Aggiorna il timestamp di flp_location

DoubleValue

Precisione di flp_location metri come raggio.

Int32Value

Direzione di movimento del veicolo in gradi, determinata dal Fused Location Provider. 0 rappresenta il nord. L'intervallo valido è [0,360).

LatLng

Posizione supplementare fornita dall'app di integrazione.

Timestamp

Timestamp associato alla posizione supplementare.

LocationSensor

Origine della posizione supplementare. Il valore predefinito è CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Precisione di supplemental_location come raggio, in metri.

bool

Deprecato: utilizza is_road_snapped.

Vehicle

Obbligatorio. Un veicolo che soddisfa la richiesta.

Timestamp

L'ETA di guida 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 un viaggio attivo, vehicle_pickup_eta include il tempo necessario per completare il viaggio attivo corrente.

Int32Value

La distanza dalla posizione attuale del veicolo al punto di ritiro specificato nella richiesta, inclusi eventuali punti di ritiro o arrivo intermedi per i viaggi esistenti. Questa distanza comprende la distanza di guida (percorso) calcolata, più 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 prelievo richiesto è in genere breve. 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'ETA di guida completa del veicolo fino al punto di riconsegna specificato nella richiesta. L'ETA include le soste in tutti i waypoint prima di dropoff_point specificato nella richiesta. Il valore verrà compilato solo quando viene specificato un punto di riconsegna nella richiesta. Un valore vuoto indica un errore nel calcolo dell'ETA.

Int32Value

La distanza di guida del veicolo (in metri) dal punto di partenza al punto di arrivo 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 raggiunga il punto di ritiro o di riconsegna. 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 ritiro a quello di riconsegna specificato nella richiesta.

TripType

Obbligatorio. Il tipo di viaggio della richiesta utilizzato per calcolare l'ETA al punto di ritiro.

Waypoint

L'elenco ordinato dei waypoint utilizzati per calcolare l'orario di arrivo stimato. L'elenco include la posizione del veicolo, i punti di ritiro delle corse attive per il veicolo e i punti di ritiro forniti nella richiesta. Un elenco vuoto indica un errore nel calcolo dell'ETA per il 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 di strada da visualizzare lungo la polilinea. I tratti sono garantiti per non sovrapporsi e non coprono necessariamente l'intero percorso.

In assenza di un tratto di strada da stilizzare, il client deve applicare lo stile 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'orario stimato di arrivo del veicolo a questo waypoint.