Package maps.fleetengine.v1

Indice

TripService

Servizio di gestione dei viaggi.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Crea una corsa in Fleet Engine e restituisce la nuova corsa.

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Ricevere informazioni su un singolo viaggio.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Segnala l'utilizzo dei viaggi fatturabili.

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Visualizza tutti i viaggi per un veicolo specifico.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Aggiorna i dati dei percorsi.

VehicleService

Servizio di gestione dei veicoli.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Crea un'istanza per un nuovo veicolo associato a un fornitore di ridesharing o di consegne on demand. Ogni Vehicle deve avere un ID veicolo univoco.

I seguenti campi Vehicle sono obbligatori durante la creazione di un Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

I seguenti campi Vehicle vengono ignorati durante la creazione di un Vehicle:

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

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Restituisce un veicolo da Fleet Engine.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Restituisce un elenco impaginato di veicoli associati a un fornitore che corrisponde alle opzioni di richiesta.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Restituisce un elenco di veicoli che corrispondono alle opzioni della richiesta.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Scrive dati aggiornati del veicolo su Fleet Engine.

Quando aggiorni un Vehicle, i seguenti campi non possono essere aggiornati poiché sono gestiti dal server:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

Inoltre, il veicolo name non può essere aggiornato.

Se il campo attributes viene aggiornato, tutti gli attributi del veicolo vengono sostituiti con gli attributi forniti nella richiesta. Se vuoi aggiornare solo alcuni attributi, consulta il metodo UpdateVehicleAttributes. Allo stesso modo, il campo waypoints può essere aggiornato, ma deve contenere tutte le tappe attualmente sul veicolo e nessun altro.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Aggiorna parzialmente gli attributi di un veicolo. Verranno aggiornati solo gli attributi menzionati nella richiesta, mentre gli altri NON verranno modificati. Nota: questo è diverso per UpdateVehicle, dove l'intero campo attributes verrà sostituito da quello in UpdateVehicleRequest e gli attributi non presenti nella richiesta verranno rimossi.

BatteryInfo

Informazioni sulla batteria del dispositivo.

Campi
battery_status

BatteryStatus

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

power_source

PowerSource

Stato della fonte di alimentazione della batteria.

battery_percentage

float

Percentuale attuale della batteria [0-100].

BatteryStatus

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

Enum
UNKNOWN_BATTERY_STATUS Stato della batteria sconosciuto.
BATTERY_STATUS_CHARGING La batteria è in carica.
BATTERY_STATUS_DISCHARGING La batteria si sta scaricando.
BATTERY_STATUS_FULL Batteria carica.
BATTERY_STATUS_NOT_CHARGING La batteria non si carica.
BATTERY_STATUS_POWER_LOW Il livello della batteria è basso.

BillingPlatformIdentifier

Un insieme di valori che indica la piattaforma su cui è stata inviata la richiesta.

Enum
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Predefinita. Utilizzato per le piattaforme non specificate.
SERVER La piattaforma è un server client.
WEB La piattaforma è un browser web.
ANDROID La piattaforma è un dispositivo mobile Android.
IOS La piattaforma è un dispositivo mobile iOS.
OTHERS Altre piattaforme non elencate in questa enumerazione.

ConsumableTrafficPolyline

Densità del traffico lungo il percorso di un Veicolo.

Campi
speed_reading_interval[]

SpeedReadingInterval

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

encoded_path_to_waypoint

string

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

CreateTripRequest

Messaggio di richiesta CreateTrip.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

parent

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.

trip_id

string

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

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

Trip

Obbligatorio. Entità viaggio da creare.

Quando crei un viaggio, i seguenti campi sono obbligatori:

  • trip_type
  • pickup_point

Vengono utilizzati i seguenti campi, se li fornisci:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

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

Solo EXCLUSIVE corse supportano intermediate_destinations.

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

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

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

CreateVehicleRequest

Messaggio di richiesta di CreateVehicle.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

parent

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.

vehicle_id

string

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

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

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.

DeviceSettings

Informazioni sulle varie impostazioni del dispositivo mobile.

Campi
location_power_save_mode

LocationPowerSaveMode

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

is_power_save_mode

bool

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

is_interactive

bool

Se il dispositivo è in stato interattivo.

battery_info

BatteryInfo

Informazioni sullo stato della batteria.

GetTripRequest

Messaggio di richiesta GetTrip.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

name

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.

view

TripView

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

current_route_segment_version

Timestamp

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

remaining_waypoints_version

Timestamp

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

route_format_type

PolylineFormatType

Il formato attuale del percorso restituito, LAT_LNG_LIST_TYPE (in Trip.route) o ENCODED_POLYLINE_TYPE (in Trip.current_route_segment). Il valore predefinito è LAT_LNG_LIST_TYPE.

current_route_segment_traffic_version

Timestamp

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

remaining_waypoints_route_version

Timestamp

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

GetVehicleRequest

Messaggio di richiesta di GetVehicle.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

name

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.

current_route_segment_version

Timestamp

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

waypoints_version

Timestamp

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

LicensePlate

Le informazioni della targa del Veicolo. Per evitare di memorizzare informazioni che consentono l'identificazione personale, nell'entità vengono memorizzate solo le informazioni minime sulla targa.

Campi
country_code

string

Obbligatorio. Codice paese/regione CLDR. Ad esempio, US per gli Stati Uniti o IN per l'India.

last_character

string

L'ultima cifra della targa o "-1" per indicare che non è presente alcun valore numerico sulla targa.

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

ListVehiclesRequest

Messaggio di richiesta di ListVehicles.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

parent

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.

page_size

int32

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

page_token

string

Il valore del valore next_page_token fornito da una precedente chiamata a ListVehicles per consentire l'impaginazione in base ai gruppi di veicoli. Il valore non è definito se i criteri di filtro della richiesta non corrispondono a quelli per la chiamata precedente a ListVehicles.

minimum_capacity

Int32Value

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

trip_types[]

TripType

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

maximum_staleness

Duration

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

vehicle_type_categories[]

Category

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

required_attributes[]

string

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

required_attributes è un elenco; required_one_of_attributes utilizza un messaggio che consente di creare una lista di liste. La combinazione dei due campi consente di comporre questa espressione:

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

Limita la risposta ai veicoli con gli attributi specificati. Questo campo è un'operazione congiunzione/AND. Sono consentiti massimo 50 attributi obbligatori. Corrisponde al numero massimo di attributi consentiti su un veicolo. Ogni stringa ripetuta deve avere il formato "chiave:valore".

required_one_of_attributes[]

string

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

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets fornisce funzionalità aggiuntive.

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

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

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

vehicle_state

VehicleState

Limita la risposta ai veicoli con questo stato del veicolo.

on_trip_only

bool

Restituisci solo i veicoli con le corse in corso.

filter

string

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

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

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

Tieni presente che le uniche query supportate riguardano gli attributi del veicolo (ad es. attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Il numero massimo di restrizioni consentite in una query di filtro è 50.

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

viewport

Viewport

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

ListVehiclesResponse

Messaggio di risposta di ListVehicles.

Campi
vehicles[]

Vehicle

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

next_page_token

string

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

total_size

int64

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

LocationPowerSaveMode

Comportamento delle funzionalità di geolocalizzazione sul dispositivo mobile quando viene attivato "risparmio energetico" sia attiva. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enum
UNKNOWN_LOCATION_POWER_SAVE_MODE LocationPowerSaveMode non definita
LOCATION_MODE_NO_CHANGE Il fornitore della posizione non dovrebbe essere interessato dal risparmio energetico oppure il risparmio energetico è disattivato.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Il fornitore della posizione basato sul GPS deve essere disattivato quando il risparmio energetico è attivo e il dispositivo non è interattivo.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Tutti i provider di posizione devono essere disattivati quando il risparmio energetico è attivo e il dispositivo non è interattivo.
LOCATION_MODE_FOREGROUND_ONLY Tutti i fornitori di posizione rimarranno disponibili, ma le correzioni della posizione dovrebbero essere fornite soltanto alle app in primo piano.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF La posizione non verrà disattivata, ma LocationManager limiterà tutte le richieste ai provider quando il dispositivo non è interattivo.

LocationSensor

Il sensore o la metodologia utilizzati per determinare la posizione.

Enum
UNKNOWN_SENSOR Il sensore non è specificato o è sconosciuto.
GPS GPS o GPS assistito.
NETWORK GPS assistito, ID ripetitore cellulare o punto di accesso Wi-Fi.
PASSIVE ID del ripetitore di telefonia mobile o punto di accesso Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Una posizione determinata dal dispositivo mobile come la posizione più probabile sulla strada.
CUSTOMER_SUPPLIED_LOCATION Una località fornita dal cliente da una fonte indipendente. In genere, questo valore viene utilizzato per una posizione fornita da fonti diverse dal dispositivo mobile su cui è in esecuzione l'SDK Driver. Se la fonte originale è descritta da uno degli altri valori enum, utilizza quel valore. Le località contrassegnate come CUSTOMER_SUPPLIED_LOCATION vengono in genere fornite tramite l'elemento last_location.supplemental_location_sensor di un veicolo.
FLEET_ENGINE_LOCATION Una località calcolata da Fleet Engine in base agli indicatori a sua disposizione. Solo output. Questo valore verrà rifiutato se viene ricevuto in una richiesta.
FUSED_LOCATION_PROVIDER Fused Location Provider di Android.
CORE_LOCATION Il fornitore di posizione sui sistemi operativi Apple.

Lo stato di navigazione del veicolo.

Enum
UNKNOWN_NAVIGATION_STATUS Stato di navigazione non specificato.
NO_GUIDANCE La navigazione dell'app Driver è in modalità FREE_NAV.
ENROUTE_TO_DESTINATION La navigazione passo passo è disponibile e la navigazione nell'app Driver è attivata in modalità GUIDED_NAV.
OFF_ROUTE Il veicolo ha abbandonato il percorso suggerito.
ARRIVED_AT_DESTINATION Il veicolo si trova a una distanza di circa 50 m dalla destinazione.

PolylineFormatType

Il tipo di formato della polilinea.

Enum
UNKNOWN_FORMAT_TYPE Il formato non è specificato o sconosciuto.
LAT_LNG_LIST_TYPE Un elenco di google.type.LatLng.
ENCODED_POLYLINE_TYPE Una polilinea codificata con un algoritmo di compressione di polilinee. La decodifica non è ancora supportata.

PowerSource

Tipo di caricabatterie utilizzato per caricare la batteria.

Enum
UNKNOWN_POWER_SOURCE Fonte di alimentazione sconosciuta.
POWER_SOURCE_AC La fonte di alimentazione è un caricabatterie CA.
POWER_SOURCE_USB La fonte di alimentazione è una porta USB.
POWER_SOURCE_WIRELESS La fonte di alimentazione è wireless.
POWER_SOURCE_UNPLUGGED La batteria è scollegata.

ReportBillableTripRequest

Messaggio di richiesta ReportBillableTrip.

Campi
name

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.

country_code

string

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

platform

BillingPlatformIdentifier

La piattaforma su cui è stata inviata la richiesta.

related_ids[]

string

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

solution_type

SolutionType

Il tipo di soluzione di prodotto GMP (ad esempio ON_DEMAND_RIDESHARING_AND_DELIVERIES) utilizzato per la corsa registrata.

SolutionType

Selettore per i diversi tipi di soluzioni di una corsa segnalata.

Enum
SOLUTION_TYPE_UNSPECIFIED Il valore predefinito. Per garantire la compatibilità con le versioni precedenti, l'API utilizzerà per impostazione predefinita ON_DEMAND_RIDESHARING_AND_DELIVERIES, che è il primo tipo di soluzione supportato.
ON_DEMAND_RIDESHARING_AND_DELIVERIES La soluzione è un viaggio di ridesharing e di consegna on demand.

RequestHeader

Una RequestHeader contiene campi comuni a tutte le richieste RPC di Fleet Engine.

Campi
language_code

string

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

region_code

string

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

sdk_version

string

Versione dell'SDK che chiama, se applicabile. Il formato della versione è "major.minor.patch", ad esempio: 1.1.2.

os_version

string

Versione del sistema operativo su cui è in esecuzione l'SDK per la chiamata. Esempi di valori di campi: 4.4.1, 12.1.

device_model

string

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

sdk_type

SdkType

Il tipo di SDK che invia la richiesta.

maps_sdk_version

string

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

nav_sdk_version

string

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

platform

Platform

Piattaforma dell'SDK che chiama.

manufacturer

string

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

android_api_level

int32

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

trace_id

string

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

Piattaforma

La piattaforma dell'SDK di chiamata.

Enum
PLATFORM_UNSPECIFIED Il valore predefinito. Questo valore viene utilizzato se la piattaforma viene omessa.
ANDROID La richiesta proviene da Android.
IOS La richiesta proviene da iOS.
WEB La richiesta proviene dal web.

SdkType

Possibili tipi di SDK.

Enum
SDK_TYPE_UNSPECIFIED Il valore predefinito. Questo valore viene utilizzato se l'attributo sdk_type viene omesso.
CONSUMER L'SDK che chiama è consumer.
DRIVER L'SDK di chiamata è il driver.
JAVASCRIPT L'SDK di chiamata è JavaScript.

SearchTripsRequest

Messaggio di richiesta SearchTrips.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

parent

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.

vehicle_id

string

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

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

Se impostato su true, la risposta include i viaggi che influenzano il percorso del conducente.

page_size

int32

Se non viene configurato, è il server a decidere il numero di risultati da restituire.

page_token

string

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

minimum_staleness

Duration

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

SearchTripsResponse

Messaggio di risposta di SearchTrips.

Campi
trips[]

Trip

L'elenco di corse per il veicolo richiesto.

next_page_token

string

Passa questo token in SearchTripsRequest per sfogliare i risultati dell'elenco. L'API restituisce un elenco di corse per ogni chiamata e, quando non sono disponibili altri risultati, l'elenco delle corse è vuoto.

SearchVehiclesRequest

Messaggio di richiesta di SearchVehicles.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

parent

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.

pickup_point

TerminalLocation

Obbligatorio. Il punto di prelievo vicino a cui cercare.

dropoff_point

TerminalLocation

Il punto di consegna previsto dal cliente. Il campo è obbligatorio se trip_types contiene TripType.SHARED.

pickup_radius_meters

int32

Obbligatorio. Definisce il raggio di ricerca del veicolo intorno al punto di ritiro. Verranno restituiti solo i veicoli che si trovano nel raggio di ricerca. Il valore deve essere compreso tra 400 e 10.000 metri (inclusi).

count

int32

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

minimum_capacity

int32

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

trip_types[]

TripType

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

maximum_staleness

Duration

Limita la ricerca ai veicoli che hanno inviato aggiornamenti di posizione a Fleet Engine entro il periodo di tempo specificato. I veicoli fissi che trasmettono ancora la loro posizione non sono considerati inattivi. Se questo campo non viene configurato, il server utilizza cinque minuti come valore predefinito.

vehicle_types[]

VehicleType

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

required_attributes[]

VehicleAttribute

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

required_attributes è un elenco; required_one_of_attributes utilizza un messaggio che consente di creare una lista di liste. La combinazione dei due campi consente di comporre questa espressione:

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

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

required_one_of_attributes[]

VehicleAttributeList

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

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets fornisce funzionalità aggiuntive.

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

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

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

order_by

VehicleMatchOrder

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

include_back_to_back

bool

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

Il valore predefinito è false.

trip_id

string

Indica il viaggio associato a SearchVehicleRequest.

current_trips_present

CurrentTripsPresent

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

filter

string

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

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

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

Tieni presente che le uniche query supportate riguardano gli attributi del veicolo (ad es. attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Il numero massimo di restrizioni consentite in una query di filtro è 50.

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

CurrentTripsPresent

Specifica i tipi di limitazioni per le corse in corso di un veicolo.

Enum
CURRENT_TRIPS_PRESENT_UNSPECIFIED La disponibilità dei veicoli con corse presenti è regolata dal campo include_back_to_back.
NONE I veicoli senza corse possono essere visualizzati nei risultati di ricerca. Quando viene utilizzato questo valore, include_back_to_back non può essere true.
ANY I veicoli con al massimo 5 corse attuali e 10 tappe sono inclusi nei risultati di ricerca. Quando viene utilizzato questo valore, include_back_to_back non può essere true.

VehicleMatchOrder

Specifica l'ordine delle corrispondenze del veicolo nella risposta.

Enum
UNKNOWN_VEHICLE_MATCH_ORDER Valore predefinito, utilizzato per ordini di corrispondenze dei veicoli non specificati o non riconosciuti.
PICKUP_POINT_ETA Ordine crescente in base al tempo di guida del veicolo fino al punto di ritiro.
PICKUP_POINT_DISTANCE Ordine crescente in base alla distanza di guida del veicolo al punto di ritiro.
DROPOFF_POINT_ETA Ordine crescente in base al tempo di guida del veicolo fino al punto di consegna. Questo ordine può essere utilizzato solo se il punto di consegna è specificato nella richiesta.
PICKUP_POINT_STRAIGHT_DISTANCE Ordine crescente per distanza in linea retta dall'ultima posizione segnalata del veicolo al punto di ritiro.
COST Ordine crescente in base al costo di corrispondenza configurato. Il costo di corrispondenza è un calcolo ponderato tra distanza in linea retta e orario di arrivo stimato. Le ponderazioni vengono impostate con valori predefiniti e possono essere modificate in base al cliente. Contatta l'Assistenza Google se devi modificare questi pesi per il tuo progetto.

SearchVehiclesResponse

Messaggio di risposta di SearchVehicles.

Campi
matches[]

VehicleMatch

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

SpeedReadingInterval

Indicatore di densità del traffico su un segmento contiguo di un percorso. Dato un percorso con punti P_0, P_1, ... , P_N (indice in base zero), SpeedReadingInterval definisce un intervallo e descrive il relativo traffico utilizzando le seguenti categorie.

Campi
start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

speed

Speed

Velocità del traffico in questo intervallo.

Velocità

La classificazione della velocità delle polilinee in base ai dati sul traffico.

Enum
SPEED_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
NORMAL Velocità normale, nessun rallentamento rilevato.
SLOW È stato rilevato un rallentamento, ma non si è formato un ingorgo.
TRAFFIC_JAM Ingorgo stradale rilevato.

StopLocation

Il luogo effettivo in cui si è verificata una fermata (ritiro/consegna).

Campi
point

LatLng

Obbligatorio. Indica la posizione effettiva.

timestamp

Timestamp

Indica quando si è verificata l'interruzione.

stop_time
(deprecated)

Timestamp

Solo input. Deprecato. Utilizza il campo timestamp.

TerminalLocation

Descrive la posizione di una tappa.

Campi
point

LatLng

Obbligatorio. Indica la posizione di una tappa di viaggio.

terminal_point_id
(deprecated)

TerminalPointId

Deprecato: specifica il campo point.

access_point_id
(deprecated)

string

Deprecato: specifica il campo point.

trip_id
(deprecated)

string

Deprecato.

terminal_location_type
(deprecated)

WaypointType

Deprecato: Vehicle.waypoint avrà questi dati.

TerminalPointId

Deprecato: i TerminalPoint non sono più supportati in Fleet Engine. Usa invece il criterio TerminalLocation.point.

Campi
value
(deprecated)

string

Deprecato.

Campo unione Id. Deprecato. Id può essere solo uno dei seguenti:
place_id
(deprecated)

string

Deprecato.

generated_id
(deprecated)

string

Deprecato.

TrafficPolylineData

Condizioni del traffico lungo il percorso previsto per i veicoli.

Campi
traffic_rendering

VisualTrafficReportPolylineRendering

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

Corsa

Metadati dei viaggi.

Campi
name

string

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

vehicle_id

string

ID del veicolo che effettua la corsa.

trip_status

TripStatus

Stato attuale della corsa.

trip_type

TripType

Il tipo di viaggio.

pickup_point

TerminalLocation

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

actual_pickup_point

StopLocation

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

actual_pickup_arrival_point

StopLocation

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

pickup_time

Timestamp

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

intermediate_destinations[]

TerminalLocation

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

intermediate_destinations_version

Timestamp

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

intermediate_destination_index

int32

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

actual_intermediate_destination_arrival_points[]

StopLocation

Solo input. L'ora e il luogo effettivi in cui arriva il conducente a una destinazione intermedia. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sull'arrivo alle destinazioni intermedie.

actual_intermediate_destinations[]

StopLocation

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

dropoff_point

TerminalLocation

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

actual_dropoff_point

StopLocation

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

dropoff_time

Timestamp

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

remaining_waypoints[]

TripWaypoint

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

vehicle_waypoints[]

TripWaypoint

Questo campo supporta l'ordinamento manuale delle tappe della corsa. Contiene tutte le tappe rimanenti per il veicolo assegnato, nonché le tappe di partenza e arrivo per questa corsa. Se la corsa non è stata assegnata a un veicolo, Fleet Engine ignora questo campo. Per motivi di privacy, questo campo viene compilato dal server solo durante le chiamate UpdateTrip e CreateTrip, NON per le chiamate GetTrip.

route[]

LatLng

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

current_route_segment

string

Solo output. Un percorso codificato alla tappa successiva.

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

current_route_segment_version

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.

current_route_segment_traffic

ConsumableTrafficPolyline

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

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

current_route_segment_traffic_version

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.

current_route_segment_end_point

TripWaypoint

Solo output. Il waypoint dove finisce current_route_segment.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

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

remaining_time_to_first_waypoint

Duration

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

remaining_waypoints_version

Timestamp

Solo output. Indica l'ultima volta che remaining_waypoints è stato modificato (una tappa è stata aggiunta, rimossa o modificata).

remaining_waypoints_route_version

Timestamp

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

number_of_passengers

int32

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

last_location

VehicleLocation

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

last_location_snappable

bool

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

view

TripView

Il sottoinsieme di campi Trip compilati e come devono essere interpretati.

TripStatus

Lo stato di una corsa che indica l'avanzamento.

Enum
UNKNOWN_TRIP_STATUS Valore predefinito, utilizzato per lo stato della corsa non specificato o non riconosciuto.
NEW Viaggio appena creato.
ENROUTE_TO_PICKUP L'autista si sta dirigendo verso il punto di prelievo.
ARRIVED_AT_PICKUP L'autista è arrivato al punto di prelievo.
ARRIVED_AT_INTERMEDIATE_DESTINATION L'autista è arrivato a una destinazione intermedia e sta aspettando il corridore.
ENROUTE_TO_INTERMEDIATE_DESTINATION Il conducente si sta dirigendo verso una destinazione intermedia (non il punto di consegna).
ENROUTE_TO_DROPOFF L'autista ha preso il passeggero ed è in viaggio verso la prossima destinazione.
COMPLETE Il passeggero è stato consegnato e la corsa è terminata.
CANCELED La corsa è stata annullata prima del ritiro da parte dell'autista, del passeggero o del fornitore di ridesharing.

TripType

Il tipo di viaggio.

Enum
UNKNOWN_TRIP_TYPE Valore predefinito, utilizzato per tipi di corse non specificati o non riconosciuti.
SHARED La corsa potrebbe condividere un veicolo con altri viaggi.
EXCLUSIVE La corsa è riservata esclusivamente a un veicolo.

TripView

Selettore per diversi insiemi di campi Viaggio in una risposta GetTrip. Per ulteriori informazioni, vedi AIP-157. È probabile che verranno aggiunte altre visualizzazioni.

Enum
TRIP_VIEW_UNSPECIFIED Il valore predefinito. Per la compatibilità con le versioni precedenti, l'API utilizzerà per impostazione predefinita una vista SDK. Per garantire stabilità e assistenza, consigliamo ai clienti di selezionare un TripView diverso da SDK.
SDK Sono inclusi i campi che potrebbero non essere interpretabili o supportate dalle librerie disponibili pubblicamente.
JOURNEY_SHARING_V1S I campi dei viaggi sono compilati per il caso d'uso della condivisione del percorso. Questa visualizzazione è pensata per le comunicazioni server-server.

TripWaypoint

Descrive un punto di sosta sul percorso di un veicolo o un punto di arrivo della corsa di un veicolo.

Campi
location

TerminalLocation

La posizione di questa tappa.

trip_id

string

La corsa associata a questa tappa.

waypoint_type

WaypointType

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

path_to_waypoint[]

LatLng

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

encoded_path_to_waypoint

string

Il percorso codificato dalla tappa precedente a quella corrente.

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

traffic_to_waypoint

ConsumableTrafficPolyline

Le condizioni del traffico lungo il percorso verso questa tappa. Tieni presente che il traffico è disponibile solo per i clienti di Google Map Platform Rides and Deliveries Solution.

distance_meters

Int32Value

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

eta

Timestamp

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

duration

Duration

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

UpdateTripRequest

Messaggio di richiesta UpdateTrip.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

name

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

Trip

Obbligatorio. Il viaggio associato all'aggiornamento.

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

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

Quando aggiorni Trip.vehicle_id per una corsa condivisa, devi fornire l'elenco di Trip.vehicle_waypoints per specificare l'ordine delle tappe rimanenti, altrimenti l'ordine sarà indeterminato.

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

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

update_mask

FieldMask

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

UpdateVehicleAttributesRequest

Messaggio di richiesta di UpdateVehicleAttributes.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

name

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.

attributes[]

VehicleAttribute

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

UpdateVehicleAttributesResponse

Messaggio di risposta di UpdateVehicleAttributes.

Campi
attributes[]

VehicleAttribute

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

UpdateVehicleRequest

"Messaggio di richiesta UpdateVeicoli.

Campi
header

RequestHeader

L'intestazione della richiesta Fleet Engine standard.

name

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

Vehicle

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

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

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

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

update_mask

FieldMask

Obbligatorio. Una maschera di campo che indica quali campi di Vehicle aggiornare. Devi specificare almeno un nome di campo.

Veicolo

Metadati del veicolo.

Campi
name

string

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

vehicle_state

VehicleState

Lo stato del veicolo.

supported_trip_types[]

TripType

Tipi di viaggio supportati da questo veicolo.

current_trips[]

string

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

last_location

VehicleLocation

Ultima posizione segnalata del veicolo.

maximum_capacity

int32

Il numero totale di passeggeri di questo veicolo. Il driver non viene considerato in questo valore. Questo valore deve essere maggiore o uguale a uno.

attributes[]

VehicleAttribute

Elenco degli attributi del veicolo. Un veicolo può avere al massimo 100 attributi e ogni attributo deve avere una chiave univoca.

vehicle_type

VehicleType

Obbligatorio. Il tipo di questo veicolo. Può essere utilizzato per filtrare i veicoli nei risultati di SearchVehicles. Influisce anche sul calcolo dell'orario di arrivo stimato e dei percorsi.

license_plate

LicensePlate

Informazioni sulla targa del veicolo.

route[]
(deprecated)

TerminalLocation

Deprecato: usa invece Vehicle.waypoints.

current_route_segment

string

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

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

current_route_segment_traffic

TrafficPolylineData

Solo input. Fleet Engine utilizza queste informazioni per migliorare la condivisione del percorso. Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK del driver.

current_route_segment_version

Timestamp

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

current_route_segment_end_point

TripWaypoint

Il waypoint dove finisce current_route_segment. Può essere fornito dai conducenti nelle chiamate UpdateVehicle come tappa completa, tappa LatLng o come ultima LatLng current_route_segment. Fleet Engine farà del proprio meglio per interpolare fino a una tappa effettiva se non è completamente specificata. Questo campo viene ignorato nelle chiamate UpdateVehicle a meno che non venga specificato anche current_route_segment.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

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

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

remaining_time_seconds

Int32Value

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

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

waypoints[]

TripWaypoint

Le tappe rimanenti assegnate a questo veicolo.

waypoints_version

Timestamp

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

back_to_back_enabled

bool

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

navigation_status

NavigationStatus

Lo stato di navigazione del veicolo.

device_settings

DeviceSettings

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

VehicleType

Il tipo di veicolo.

Campi
category

Category

Categoria del tipo di veicolo

Categoria

Categorie di tipi di veicoli

Enum
UNKNOWN Valore predefinito, utilizzato per le categorie di veicoli non specificate o non riconosciute.
AUTO Un'automobile.
TAXI Qualsiasi veicolo che funge da taxi (in genere con licenza o regolamentato).
TRUCK In genere, un veicolo con una grande capacità di archiviazione.
TWO_WHEELER Una motocicletta, un ciclomotore o un altro veicolo a due ruote
BICYCLE Trasporto a energia umana.
PEDESTRIAN Un trasportatore, di solito cammina o corre, che percorre percorsi pedonali.

VehicleAttribute

Descrive un attributo del veicolo come coppia chiave-valore. La colonna "key:value" la lunghezza della stringa non può superare i 256 caratteri.

Campi
key

string

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

value

string

Il valore dell'attributo.

Campo unione vehicle_attribute_value. Il valore dell'attributo può essere di tipo stringa, bool o doppio. vehicle_attribute_value può essere solo uno dei seguenti:
string_value

string

Valore dell'attributo tipo di stringa.

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

bool_value

bool

Valore di attributo digitato con valore booleano.

number_value

double

Valore attributo doppio tipo.

VehicleAttributeList

Un tipo di dati con elenco di elenchi per gli attributi dei veicoli.

Campi
attributes[]

VehicleAttribute

Un elenco di attributi in questa raccolta.

VehicleLocation

La posizione, la velocità e la direzione di un veicolo in un determinato momento.

Campi
location

LatLng

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

horizontal_accuracy
(deprecated)

DoubleValue

Deprecato: usa invece latlng_accuracy.

latlng_accuracy

DoubleValue

Precisione di location in metri come raggio.

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

Deprecato: usa invece heading_accuracy.

heading_accuracy

DoubleValue

Precisione di heading in gradi.

altitude

DoubleValue

Altitudine in metri sopra WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Deprecato: usa invece altitude_accuracy.

altitude_accuracy

DoubleValue

Precisione di altitude in metri.

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

Velocità del veicolo in metri/secondo

speed_accuracy

DoubleValue

Precisione di speed in metri al secondo.

update_time

Timestamp

L'ora in cui il sensore ha segnalato location in base all'orologio del sensore.

server_time

Timestamp

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

location_sensor

LocationSensor

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

is_road_snapped

BoolValue

Indica se location è agganciato a una strada.

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

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

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

Posizione del veicolo grezzo (non elaborata da un esperto di autovelox).

raw_location_time

Timestamp

Timestamp associato alla località non elaborata.

raw_location_sensor

LocationSensor

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

raw_location_accuracy

DoubleValue

Precisione di raw_location come raggio, in metri.

supplemental_location

LatLng

Posizione supplementare fornita dall'app di integrazione.

supplemental_location_time

Timestamp

Timestamp associato alla località supplementare.

supplemental_location_sensor

LocationSensor

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

supplemental_location_accuracy

DoubleValue

Precisione di supplemental_location come raggio, in metri.

road_snapped
(deprecated)

bool

Deprecato: usa invece is_road_snapped.

VehicleMatch

Contiene il veicolo e le relative stime per un veicolo che corrisponde ai punti delle corse attive per il veicolo SearchVehiclesRequest.

Campi
vehicle

Vehicle

Obbligatorio. Un veicolo che corrisponde alla richiesta.

vehicle_pickup_eta

Timestamp

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

vehicle_pickup_distance_meters

Int32Value

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

vehicle_pickup_straight_line_distance_meters

Int32Value

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

vehicle_dropoff_eta

Timestamp

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

vehicle_pickup_to_dropoff_distance_meters

Int32Value

La distanza di guida (in metri) del veicolo dal punto di prelievo al punto di riconsegna specificato nella richiesta. La distanza si trova solo tra i due punti e non include la posizione del veicolo o qualsiasi altro punto che deve essere visitato prima che il veicolo visiti il punto di prelievo o scarico. Il valore verrà compilato solo quando nella richiesta viene specificato un valore dropoff_point. Un valore vuoto indica un errore nel calcolo della distanza dal punto di ritiro dal punto di consegna specificato nella richiesta.

trip_type

TripType

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

vehicle_trips_waypoints[]

Waypoint

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

vehicle_match_type

VehicleMatchType

Tipo di veicolo corrispondente.

requested_ordered_by

VehicleMatchOrder

L'ordine richiesto per ordinare le corrispondenze dei veicoli.

ordered_by

VehicleMatchOrder

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

VehicleMatchType

Tipo di veicolo corrispondente.

Enum
UNKNOWN Tipo di corrispondenza veicolo sconosciuto
EXCLUSIVE Al momento non è assegnata alcuna corsa al veicolo e può procedere fino al punto di prelievo.
BACK_TO_BACK Il veicolo è attualmente assegnato a una corsa, ma può procedere verso il punto di prelievo dopo aver completato la corsa in corso. I calcoli di orario di arrivo stimato e distanza tengono conto della corsa esistente.
CARPOOL Il veicolo ha una capacità sufficiente per una corsa condivisa.
CARPOOL_BACK_TO_BACK Il veicolo terminerà il percorso attuale e attivo prima di procedere verso il punto di prelievo. I calcoli di orario di arrivo stimato e distanza tengono conto della corsa esistente.

VehicleState

Lo stato di un Vehicle.

Enum
UNKNOWN_VEHICLE_STATE Valore predefinito, utilizzato per gli stati del veicolo non specificati o non riconosciuti.
OFFLINE Il veicolo non accetta nuove corse. Nota: il veicolo può continuare a funzionare in questo stato durante il completamento di una corsa assegnata.
ONLINE Il veicolo accetta nuove corse.

VisualTrafficReportPolylineRendering

Descrive come i clienti devono colorare una parte della polilinea lungo il percorso.

Campi
road_stretch[]

RoadStretch

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

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

RoadStretch

Un tratto di strada che dovrebbe essere visualizzato.

Campi
style

Style

Obbligatorio. Lo stile da applicare.

offset_meters

int32

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

length_meters

int32

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

Stile

Lo stile del traffico, che indica la velocità del traffico.

Enum
STYLE_UNSPECIFIED Nessuno stile selezionato.
SLOWER_TRAFFIC Il traffico sta rallentando.
TRAFFIC_JAM C'è un ingorgo.

Waypoint

Descrive i punti intermedi lungo un percorso per un VehicleMatch in un SearchVehiclesResponse. Questo concetto è rappresentato come un TripWaypoint in tutti gli altri endpoint.

Campi
lat_lng

LatLng

La posizione di questa tappa.

eta

Timestamp

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

WaypointType

Il tipo di tappa.

Enum
UNKNOWN_WAYPOINT_TYPE Tipo di waypoint sconosciuto o non specificato.
PICKUP_WAYPOINT_TYPE Tappe per avanzare passeggeri o oggetti.
DROP_OFF_WAYPOINT_TYPE Tappe per consegnare passeggeri o oggetti.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Waypoint per destinazioni intermedie in un viaggio con più destinazioni.