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 una singola corsa.
ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Segnala l'utilizzo delle corse 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)

Consente di creare un nuovo veicolo associato a un fornitore di servizi di ridesharing o 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 paginato di veicoli associati a un fornitore che corrispondono alle opzioni di richiesta.
SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

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

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Scrive i dati aggiornati del veicolo in Fleet Engine.

Quando aggiorni un Vehicle, i seguenti campi non possono essere aggiornati perché 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 quelli forniti nella richiesta. Se vuoi aggiornare solo alcuni attributi, consulta il metodo UpdateVehicleAttributes. Analogamente, il campo waypoints può essere aggiornato, ma deve contenere tutti i waypoint attualmente sul veicolo e nessun altro waypoint.
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 in 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 e così via.
power_source

PowerSource

Stato dell'alimentazione a batteria.
battery_percentage

float

Percentuale attuale della batteria [0-100].

BatteryStatus

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

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 La batteria è in esaurimento.

BillingPlatformIdentifier

Un insieme di valori che indicano su quale piattaforma è stata emessa la richiesta.

Enum
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Predefinita. Utilizzato per 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 dal waypoint precedente a quello 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 di 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 in base al formato di normalizzazione Unicode C.
  • Non può contenere nessuno dei seguenti caratteri ASCII: "/", ":", "?", "," o "#".
trip

Trip

Obbligatorio. L'entità di viaggio da creare.

Quando crei un viaggio, i seguenti campi sono obbligatori:

  • trip_type
  • pickup_point

I seguenti campi vengono utilizzati se li fornisci:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Tutti gli altri campi 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.

Quando vehicle_id è impostato per una corsa condivisa, devi fornire l'elenco di Trip.vehicle_waypoints per specificare l'ordine dei waypoint rimanenti per il veicolo, altrimenti l'ordine dei waypoint non sarà definito.

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

Vengono utilizzati i campi trip_id, waypoint_type e location, 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 di 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. Fatte salve le seguenti limitazioni:

  • Deve essere una stringa Unicode valida.
  • Sono consentiti massimo 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 è attiva la modalità di 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 di 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 (esclusivo) per cui vengono recuperati i dati Trip.route o Trip.current_route_segment. Se i dati del percorso non sono stati modificati da questo timestamp, il campo route non è impostato nella risposta. Se non è specificato un valore minimo, i dati del percorso vengono sempre recuperati.
remaining_waypoints_version

Timestamp

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

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

Timestamp

Indica il timestamp minimo (esclusivo) per cui 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 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.
remaining_waypoints_route_version

Timestamp

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

GetVehicleRequest

Messaggio di richiesta di GetVehicle.

Campi
header

RequestHeader

L'intestazione della richiesta di 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 numero minimo, viene sempre recuperato current_route_segment.
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 sulla 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.

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

ListVehiclesRequest

Messaggio di richiesta di ListVehicles.

Campi
header

RequestHeader

L'intestazione della richiesta di 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 di next_page_token fornito da una chiamata precedente a ListVehicles per poter eseguire la paginazione dei gruppi di veicoli. Il valore è non definito se i criteri di filtro della richiesta non sono gli stessi della chiamata precedente a ListVehicles.
minimum_capacity

Int32Value

Specifica la capacità minima richiesta del veicolo. Tutti i veicoli restituiti avranno un valore maximum_capacity maggiore o uguale a questo. Se impostato, deve essere maggiore o uguale a 0.
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 della posizione a Fleet Engine entro la durata specificata. 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 è una lista; required_one_of_attributes utilizza un messaggio che consente una lista di liste. In combinazione, i due campi consentono la composizione di questa espressione:

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

Limita la risposta ai veicoli con gli attributi specificati. Questo campo è un'operazione congiunzione/AND. Sono consentiti massimo 50 attributi obbligatori. Corrisponde al numero massimo di attributi consentiti per 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 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".
required_one_of_attribute_sets[]

string

required_one_of_attribute_sets offre funzionalità aggiuntive.

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

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

Limita la risposta ai veicoli che corrispondono a tutti gli attributi in un VehicleAttributeList. All'interno di ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni operazione VehicleAttributeList e di disgiunzione/OR incluse 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.
on_trip_only

bool

Restituire solo i veicoli con i viaggi in corso.
filter

string

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

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

Tieni presente che le uniche query supportate riguardano gli attributi del veicolo (ad es. attributes.<key> = <value> o attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Il numero massimo di limitazioni consentite in una query 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 si trovava nell'area rettangolare definita dall'area visibile.

ListVehiclesResponse

Messaggio di risposta ListVehicles.

Campi
vehicles[]

Vehicle

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

string

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

int64

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

LocationPowerSaveMode

Il modo in cui le funzionalità di geolocalizzazione sono configurate per funzionare sul dispositivo mobile quando è attiva la funzionalità "risparmio energetico" del dispositivo. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enum
UNKNOWN_LOCATION_POWER_SAVE_MODE Undefined LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE I fornitori di servizi di geolocalizzazione non devono essere interessati dal risparmio energetico oppure questa funzionalità deve essere disattivata.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Il fornitore di servizi di geolocalizzazione basato su 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 localizzazione devono essere disattivati quando il risparmio energetico è attivo e il dispositivo non è interattivo.
LOCATION_MODE_FOREGROUND_ONLY Tutti i fornitori di servizi di geolocalizzazione rimarranno disponibili, ma le correzioni della posizione devono essere fornite solo 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 torre cellulare o punto di accesso Wi-Fi.
PASSIVE ID torre cellulare 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 l'origine originale è descritta da uno degli altri valori dell'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 posizione 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 dell'app Driver è passata alla modalità GUIDED_NAV.
OFF_ROUTE Il veicolo ha deviato dal 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 delle polilinee. La decodifica non è ancora supportata.

PowerSource

Tipo di caricabatterie utilizzato per caricare la batteria.

Enum
UNKNOWN_POWER_SOURCE 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 emessa la richiesta.
related_ids[]

string

Gli identificatori direttamente correlati al viaggio segnalato. 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 es. ON_DEMAND_RIDESHARING_AND_DELIVERIES) utilizzata per la corsa segnalata.

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 consegne 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, visita la pagina 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 di 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 chiamante. Esempi di valori di campi: 4.4.1, 12.1.
device_model

string

Modello del dispositivo su cui è in esecuzione l'SDK chiamante. 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 chiamante, se applicabile. Il formato della versione è "major.minor.patch", ad esempio: 2.1.0.
platform

Platform

Piattaforma dell'SDK chiamante.
manufacturer

string

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

int32

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

string

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

Piattaforma

La piattaforma dell'SDK chiamante.

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 chiamante è Driver.
JAVASCRIPT L'SDK chiamante è JavaScript.

SearchTripsRequests

Messaggio di richiesta di SearchTrips.

Campi
header

RequestHeader

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

string

Imposta questo valore 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 delle corse per il veicolo richiesto.
next_page_token

string

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

SearchVehiclesRequest

Messaggio di richiesta di SearchVehicles.

Campi
header

RequestHeader

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

TerminalLocation

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

int32

Obbligatorio. Definisce il raggio di ricerca dei veicoli 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 10000 metri (inclusi).
count

int32

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

int32

Obbligatorio. Specifica il numero di passeggeri presi in considerazione per un viaggio. Il valore deve essere maggiore o uguale a 1. 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. Limita la ricerca solo ai veicoli che supportano quel tipo di viaggio.
maximum_staleness

Duration

Limita la ricerca solo ai veicoli che hanno inviato aggiornamenti sulla posizione a Fleet Engine entro la durata specificata. I veicoli fissi che trasmettono ancora la loro posizione non sono considerati inattivi. Se questo campo non è impostato, 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 un elenco di elenchi. 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 solo 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 offre funzionalità aggiuntive.

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

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

Limita la ricerca solo ai veicoli con tutti gli attributi in un VehicleAttributeList. All'interno di ogni elenco, un veicolo deve corrispondere a tutti gli attributi. Questo campo è un'operazione di congiunzione/AND in ogni VehicleAttributeList e un'operazione di disgiunzione/OR inclusiva 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 singola corsa attiva sono idonei per questa ricerca. Questo campo viene utilizzato solo quando current_trips_present non è specificato. Se il criterio current_trips_present non è specificato e questo campo è false, i veicoli a cui sono state assegnate corse 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 filtro da applicare durante la ricerca di veicoli. Visita la pagina http://aip.dev/160 per esempi di sintassi dei filtri.

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

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

Inoltre, tutti gli attributi vengono archiviati come stringhe, pertanto gli unici confronti supportati per gli attributi sono i confronti di stringhe. Per eseguire il confronto con valori numerici o booleani, i valori devono essere 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 i viaggi attuali 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 l'ordine delle 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 in auto del veicolo dal 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 la distanza in linea retta e l'orario di arrivo stimato. I pesi vengono impostati con valori predefiniti e possono essere modificati in base al cliente. Contatta l'Assistenza Google se questi pesi devono essere modificati per il tuo progetto.

SearchVehiclesResponse

Messaggio di risposta SearchVehicles.

Campi
matches[]

VehicleMatch

Elenco di 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, quando l'indice è 0, il campo sembra non essere compilato.
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à del polilinea 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

La posizione effettiva in cui si è verificato un arresto (prelievo/ritorno).

Campi
point

LatLng

Obbligatorio. Indica la posizione effettiva.
timestamp

Timestamp

Indica quando si è verificato l'arresto.
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

Ritiro: specifica invece il campo point.
access_point_id
(deprecated)

string

Ritiro: specifica invece il campo point.
trip_id
(deprecated)

string

Deprecato.
terminal_location_type
(deprecated)

WaypointType

Ritiro: 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

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

TripStatus

Stato attuale della corsa.
trip_type

TripType

Il tipo di viaggio.
pickup_point

TerminalLocation

Località in cui il cliente indica di essere disponibile per il ritiro.
actual_pickup_point

StopLocation

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

StopLocation

Solo input. L'ora e il luogo effettivi dell'arrivo del conducente al punto di prelievo. Questo campo è destinato al fornitore per fornire feedback sulle informazioni sull'arrivo effettivo al punto di ritiro.
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 richieste per la corsa (oltre a quelle di partenza e di 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 in UpdateTripRequest quando aggiorna intermediate_destination_index per assicurarsi 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. Questo valore viene impostato dal fornitore. 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 nelle destinazioni intermedie.
dropoff_point

TerminalLocation

Località in cui il cliente indica di essere disponibile per il ritiro.
actual_dropoff_point

StopLocation

Solo input. L'ora e la posizione effettive in cui il cliente è stato scaricato. Questo campo consente al fornitore di fornire un feedback sulle informazioni effettive sul ritiro.
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 waypoint di altri viaggi.
vehicle_waypoints[]

TripWaypoint

Questo campo supporta l'ordinamento manuale dei waypoint per il viaggio. 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 per le chiamate UpdateTrip e CreateTrip, NON per le chiamate GetTrip.
route[]

LatLng

Solo output. Percorso previsto per questo viaggio al primo ingresso nei punti restanti. Tieni presente che il primo waypoint potrebbe appartenere a un viaggio diverso.
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 in cui termina 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 o se è 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 è inattiva (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 (è stato aggiunto, rimosso o modificato un waypoint).
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 passarlo in GetTripRequest per assicurarsi 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. False 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 ne indica l'avanzamento.

Enum
UNKNOWN_TRIP_STATUS Valore predefinito, utilizzato per lo stato di viaggio 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 Il conducente è arrivato al punto di ritiro.
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 lasciato a destinazione e la corsa è stata completata.
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 altre corse.
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 relativi alle corse vengono compilati per il caso d'uso 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 del viaggio di un veicolo.

Campi
location

TerminalLocation

La posizione di questo waypoint.
trip_id

string

La corsa associata a questa tappa.
waypoint_type

WaypointType

Il ruolo di questo waypoint in questo viaggio, ad esempio ritiro o consegna.
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 se richiesto.
encoded_path_to_waypoint

string

Il percorso codificato dal waypoint precedente a quello corrente.

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

ConsumableTrafficPolyline

Le condizioni del traffico lungo il percorso verso questa tappa. Tieni presente che il traffico è disponibile solo per i clienti della soluzione per corse e consegne di Google Maps Platform.
distance_meters

Int32Value

La distanza del percorso dal waypoint precedente a quello 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 dal waypoint 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 di 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.

Quando specifichi Trip.vehicle_waypoints, l'elenco deve contenere tutti i waypoint rimanenti dei viaggi del veicolo, senza waypoint aggiuntivi. 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 siano prima del punto di partenza. I waypoint di un viaggio EXCLUSIVE non devono essere interlacciati con quelli di altri viaggi. Vengono utilizzati i campi trip_id, waypoint_type e location e tutti gli altri campi TripWaypoint in vehicle_waypoints vengono ignorati.

Per evitare una condizione di gara per i viaggi con più destinazioni, devi fornire Trip.intermediate_destinations_version quando aggiorni lo stato del viaggio su ENROUTE_TO_INTERMEDIATE_DESTINATION. Il valore Trip.intermediate_destinations_version 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 dei campi 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 di 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 alterati o rimossi.

UpdateVehicleAttributesResponse

Messaggio di risposta UpdateVehicleAttributes.

Campi
attributes[]

VehicleAttribute

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

UpdateVehicleRequest

Messaggio di richiesta UpdateVehicle.

Campi
header

RequestHeader

L'intestazione della richiesta di 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 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 gli attributi forniti nella richiesta. Se vuoi aggiornare solo alcuni attributi, consulta il metodo UpdateVehicleAttributes.

Analogamente, il campo waypoints può essere aggiornato, ma deve contenere tutti i waypoint attualmente sul veicolo e nessun altro waypoint.
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 viaggi 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 conducente 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 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 fino al waypoint successivo. Questo elenco viene restituito anche in Trip.current_route_segment per tutte le corse attive assegnate al veicolo.

Nota: questo campo è destinato esclusivamente all'utilizzo da parte dell'SDK 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'uso da parte dell'SDK 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 in cui termina current_route_segment. Questo valore può essere fornito dai conducenti durante le chiamate UpdateVehicle come waypoint per l'intero viaggio, come waypoint LatLng o come ultimo LatLng del current_route_segment. Fleet Engine farà del suo meglio per eseguire l'interpolazione fino a un punto di passaggio effettivo se non è completamente specificato. Questo campo viene ignorato nelle chiamate a UpdateVehicle, a meno che non venga specificato anche current_route_segment.
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. Il valore non è specificato se il campo current_route_segment è vuoto.
eta_to_first_waypoint

Timestamp

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

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

Int32Value

Solo input. Il tempo di percorrenza rimanente per 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

I waypoint rimanenti assegnati 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 può includere il veicolo anche se al momento è assegnato a un viaggio. 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 dei 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 autorizzato o regolamentato).
TRUCK In genere, un veicolo con una grande capacità di carico.
TWO_WHEELER Una motocicletta, un motorino o un altro veicolo a due ruote
BICYCLE Trasporto a propulsione umana.
PEDESTRIAN Un mezzo di trasporto umano, in genere a piedi o in corsa, che si sposta lungo percorsi pedonali.

VehicleAttribute

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

Campi
key

string

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

string

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

string

Valore dell'attributo di tipo 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 dell'attributo di tipo booleano.
number_value

double

Valore attributo doppio tipo.

VehicleAttributeList

Un tipo di dati elenco di elenchi per gli attributi del veicolo.

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

DoubleValue

Precisione di heading gradi.
altitude

DoubleValue

Altitudine in metri sopra WGS84.
vertical_accuracy
(deprecated)

DoubleValue

Deprecato: utilizza altitude_accuracy.
altitude_accuracy

DoubleValue

Precisione di altitude in metri.
speed_kmph
(deprecated)

Int32Value

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

DoubleValue

Velocità del veicolo in metri/secondo
speed_accuracy

DoubleValue

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

Int32Value

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

LatLng

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

Timestamp

Timestamp associato alla posizione non elaborata.
raw_location_sensor

LocationSensor

Origine della posizione 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 stazione di ricarica 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 al punto di ritiro specificato nella richiesta. Un valore vuoto indica un errore nel calcolo dell'orario di arrivo stimato del veicolo. Se SearchVehiclesRequest.include_back_to_back era true e questo veicolo ha una corsa attiva, vehicle_pickup_eta include il tempo necessario per completare la corsa attiva corrente.
vehicle_pickup_distance_meters

Int32Value

La distanza dalla posizione attuale del veicolo al punto di ritiro specificato nella richiesta, inclusi eventuali punti di ritiro o di consegna intermedi per i viaggi esistenti. Questa distanza comprende la distanza calcolata in auto (percorso), più la distanza in linea retta tra il punto di arrivo della navigazione e il punto di prelievo richiesto. La distanza tra il punto di arrivo della navigazione e il punto di ritiro richiesto è in genere ridotta. Un valore vuoto indica un errore nel calcolo della distanza.
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 in auto (in metri) del veicolo dal punto di ritiro al punto di consegna 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 partenza del ritiro 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 ritiro dei viaggi attivi per il veicolo e i punti di ritiro forniti nella richiesta. Un elenco vuoto indica un errore nel calcolo dell'orario di arrivo stimato del veicolo.
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. Normalmente corrisponde al campo "order_by" della richiesta. Tuttavia, in determinate circostanze, ad esempio in caso di 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 al veicolo non è stato assegnato alcun viaggio e può procedere al punto di ritiro.
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 ETA e distanza tengono conto del viaggio esistente.
CARPOOL Il veicolo ha una capacità sufficiente per una corsa condivisa.
CARPOOL_BACK_TO_BACK Il veicolo completerà la corsa attiva in corso prima di procedere al punto di ritiro. I calcoli di ETA e distanza tengono conto del viaggio 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 nuovi viaggi. Nota: il veicolo potrebbe 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 stradali che devono essere visualizzati lungo la polilinea. È garantito che i tratti non si sovrappongono e non coprono necessariamente l'intero percorso.

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

RoadStretch

Un tratto di strada da visualizzare.

Campi
style

Style

Obbligatorio. Lo stile da applicare.
offset_meters

int32

Obbligatorio. Lo stile deve essere applicato tra [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 in cui il veicolo arriverà a questo waypoint.

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.