Indice
DeliveryService
(interfaccia)BatchCreateTasksRequest
(messaggio)BatchCreateTasksResponse
(messaggio)CreateDeliveryVehicleRequest
(messaggio)CreateTaskRequest
(messaggio)DeliveryRequestHeader
(messaggio)DeliveryRequestHeader.Platform
(enum)DeliveryRequestHeader.SdkType
(enum)DeliveryVehicle
(messaggio)DeliveryVehicle.DeliveryVehicleType
(enum)DeliveryVehicleAttribute
(messaggio)DeliveryVehicleLocation
(messaggio)DeliveryVehicleLocationSensor
(enum)DeliveryVehicleNavigationStatus
(enum)GetDeliveryVehicleRequest
(messaggio)GetTaskRequest
(messaggio)GetTaskTrackingInfoRequest
(messaggio)ListDeliveryVehiclesRequest
(messaggio)ListDeliveryVehiclesResponse
(messaggio)ListTasksRequest
(messaggio)ListTasksResponse
(messaggio)LocationInfo
(messaggio)SearchTasksRequest
(messaggio) (deprecato)SearchTasksResponse
(messaggio) (deprecato)Task
(messaggio)Task.JourneySharingInfo
(messaggio)Task.State
(enum)Task.TaskOutcome
(enum)Task.TaskOutcomeLocationSource
(enum)Task.Type
(enum)TaskAttribute
(messaggio)TaskTrackingInfo
(messaggio)TaskTrackingViewConfig
(messaggio)TaskTrackingViewConfig.VisibilityOption
(messaggio)TimeWindow
(messaggio)UpdateDeliveryVehicleRequest
(messaggio)UpdateTaskRequest
(messaggio)VehicleJourneySegment
(messaggio)VehicleStop
(messaggio)VehicleStop.State
(enum)VehicleStop.TaskInfo
(messaggio)
DeliveryService
Il servizio Last Mile Delivery.
BatchCreateTasks |
---|
Crea e restituisce un batch di nuovi oggetti |
CreateDeliveryVehicle |
---|
Crea e restituisce un nuovo |
CreateTask |
---|
Crea e restituisce un nuovo oggetto |
GetDeliveryVehicle |
---|
Restituisce l'istanza |
GetTask |
---|
Recupera informazioni su un |
GetTaskTrackingInfo |
---|
Restituisce l'istanza |
ListDeliveryVehicles |
---|
Recupera tutti i valori |
ListTasks |
---|
Recupera tutti i valori |
SearchTasks |
---|
Deprecato: utilizza |
UpdateDeliveryVehicle |
---|
Scrive dati |
UpdateTask |
---|
Aggiorna i dati di |
BatchCreateTasksRequest
Il messaggio di richiesta BatchCreateTask
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. Nota: se imposti questo campo, il campo dell'intestazione nei messaggi |
parent |
Obbligatoria. La risorsa padre condivisa da tutte le attività. Questo valore deve essere nel formato |
requests[] |
Obbligatoria. Il messaggio di richiesta che specifica le risorse da creare. Nota: puoi creare un massimo di 500 attività in gruppo. |
BatchCreateTasksResponse
Il messaggio di risposta BatchCreateTask
.
Campi | |
---|---|
tasks[] |
Le attività create. |
CreateDeliveryVehicleRequest
Il messaggio di richiesta CreateDeliveryVehicle
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
parent |
Obbligatoria. Deve essere nel formato |
delivery_vehicle_id |
Obbligatoria. L'ID veicolo per la consegna deve essere univoco ed essere soggetto alle seguenti limitazioni:
|
delivery_vehicle |
Obbligatoria. L'entità
Nota: il campo |
CreateTaskRequest
Il messaggio di richiesta CreateTask
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
parent |
Obbligatoria. Deve essere nel formato |
task_id |
Obbligatoria. L'ID attività deve essere univoco, ma non deve essere un ID monitoraggio della spedizione. Per archiviare un ID monitoraggio della spedizione, utilizza il campo
|
task |
Obbligatoria. L'entità Tasks da creare. Quando crei un'attività, i seguenti campi sono obbligatori:
Nota: il campo |
DeliveryRequestHeader
Un'intestazione RequestHeader contiene campi comuni a tutte le richieste RPC di consegna.
Campi | |
---|---|
language_code |
Il codice lingua BCP-47, ad esempio en-US o sr-Latn. Per ulteriori informazioni, vedi http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Se non viene specificato alcun nome, la risposta può essere in qualsiasi lingua, con una preferenza per l'inglese, se esiste un nome di questo tipo. Esempio di valore del campo: |
region_code |
Obbligatoria. Codice regione CLDR della regione in cui ha origine la richiesta. Esempio di valore del campo: |
sdk_version |
Versione dell'SDK per le chiamate, se applicabile. Il formato della versione è "major.minor.patch", ad esempio |
os_version |
Versione del sistema operativo su cui è in esecuzione l'SDK per le chiamate. Esempi di valori del campo: |
device_model |
Modello del dispositivo su cui è in esecuzione l'SDK per le chiamate. Esempi di valori del campo: |
sdk_type |
Il tipo di SDK che invia la richiesta. |
maps_sdk_version |
Versione del MapSDK da cui dipende l'SDK per le chiamate, se applicabile. Il formato della versione è "major.minor.patch", ad esempio |
nav_sdk_version |
Versione del NavSDK da cui dipende l'SDK per le chiamate, se applicabile. Il formato della versione è "major.minor.patch", ad esempio |
platform |
Piattaforma dell'SDK per le chiamate. |
manufacturer |
Produttore del dispositivo Android dall'SDK per le chiamate; applicabile soltanto per gli SDK Android. Esempio di valore del campo: |
android_api_level |
Livello API Android dell'SDK per le chiamate, applicabile solo agli SDK Android. Esempio di valore del campo: |
trace_id |
ID facoltativo che può essere fornito ai fini del logging per identificare la richiesta. |
Piattaforma
La piattaforma dell'SDK per le chiamate.
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 sdk_type viene omesso. |
CONSUMER |
L'SDK per le chiamate è consumer. |
DRIVER |
L'SDK per le chiamate è Driver. |
JAVASCRIPT |
L'SDK per le chiamate è JavaScript. |
DeliveryVehicle
Il messaggio DeliveryVehicle
. Un veicolo per la consegna trasporta le spedizioni da un deposito a un luogo di consegna e da un punto di ritiro al deposito. In alcuni casi, i veicoli per le consegne trasportano anche le spedizioni direttamente dal luogo di ritiro a quello di consegna.
Nota: le API gRPC e REST utilizzano convenzioni di denominazione dei campi diverse. Ad esempio, il campo DeliveryVehicle.current_route_segment
nell'API gRPC e il campo DeliveryVehicle.currentRouteSegment
nell'API REST fanno riferimento allo stesso campo.
Campi | |
---|---|
name |
Il nome univoco di questo veicolo per la consegna. Il formato è |
last_location |
L'ultima posizione segnalata del veicolo per la consegna. |
navigation_status |
Lo stato di navigazione del veicolo per la consegna. |
current_route_segment |
La polilinea codificata che specifica il percorso che la navigazione consiglia per raggiungere il waypoint successivo. L'app del conducente si aggiorna quando viene raggiunta o superata una fermata e quando la navigazione cambia. Questi In alcuni casi, questo campo potrebbe non essere utilizzato per completare
In questi casi, Fleet Engine compila questo campo con un percorso dall'ultimo VehicleStop passato al successivo VehicleStop per garantire che il consumatore di questo campo disponga delle migliori informazioni disponibili sul percorso corrente del veicolo per la consegna. |
current_route_segment_end_point |
La località in cui termina Questo campo viene ignorato nelle chiamate |
remaining_distance_meters |
La distanza in auto rimanente per il Fleet Engine ignora questo campo in |
remaining_duration |
Il tempo di guida rimanente per il Fleet Engine ignora questo campo in |
remaining_vehicle_journey_segments[] |
I segmenti di viaggio assegnati a questo veicolo per la consegna, a partire dall'ultima posizione del veicolo segnalata. Questo campo non verrà compilato nella risposta di |
attributes[] |
Un elenco di attributi personalizzati del veicolo per la consegna. Un veicolo per la consegna può avere al massimo 100 attributi, ognuno dei quali deve avere una chiave univoca. |
type |
Il tipo di questo veicolo per la consegna. Se non viene configurato, il valore predefinito sarà |
DeliveryVehicleType
Il tipo di veicolo per la consegna.
Enum | |
---|---|
DELIVERY_VEHICLE_TYPE_UNSPECIFIED |
Il valore è inutilizzato. |
AUTO |
Un'automobile. |
TWO_WHEELER |
Un motociclo, un ciclomotore o un altro veicolo a due ruote. |
BICYCLE |
Trasporto umano. |
PEDESTRIAN |
Un mezzi di trasporto umano, in genere a piedi o di corsa, lungo percorsi pedonali. |
DeliveryVehicleAttribute
Descrive un attributo di un veicolo come coppia chiave-valore. La lunghezza della stringa "key:value" non può superare i 256 caratteri.
Campi | |
---|---|
key |
La chiave dell'attributo. |
value |
Il valore dell'attributo. |
Campo di unione delivery_vehicle_attribute_value . Il valore dell'attributo può essere di tipo stringa, bool o doppio. delivery_vehicle_attribute_value può essere solo uno dei seguenti: |
|
string_value |
Valore dell'attributo di tipo stringa. Nota: è identico al campo |
bool_value |
Valore dell'attributo con tipo booleano. |
number_value |
Valore dell'attributo con doppio tipo. |
DeliveryVehicleLocation
La posizione, la velocità e la direzione di un veicolo in un determinato momento.
Campi | |
---|---|
location |
La posizione del veicolo. Quando viene inviato a Fleet Engine, la posizione del veicolo è una posizione GPS. Quando la ricevi in risposta, la posizione del veicolo può essere una posizione GPS, una posizione supplementare o un'altra posizione stimata. L'origine è specificata in |
horizontal_accuracy |
Deprecato: utilizza |
latlng_accuracy |
Precisione di |
heading |
Senso di marcia del veicolo in gradi. 0 rappresenta il nord. L'intervallo valido è [0,360). |
bearing_accuracy |
Deprecato: utilizza |
heading_accuracy |
Precisione di |
altitude |
Altitudine in metri sopra WGS84. |
vertical_accuracy |
Deprecato: utilizza |
altitude_accuracy |
Precisione di |
speed_kmph |
Velocità del veicolo in chilometri orari. Deprecato: utilizza |
speed |
Velocità del veicolo in metri/secondo |
speed_accuracy |
Precisione di |
update_time |
L'ora in cui |
server_time |
Solo output. L'ora in cui il server ha ricevuto le informazioni sulla posizione. |
location_sensor |
Fornitore di dati sulla posizione (ad esempio, |
is_road_snapped |
Indica se |
is_gps_sensor_enabled |
Solo input. Indica se il sensore GPS è abilitato sul dispositivo portatile. |
time_since_update |
Solo input. Tempo (in secondi) dall'invio della posizione al server. Questo sarà pari a 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 |
Solo input. Obsoleta: ora vengono utilizzati altri indicatori per determinare se una località è obsoleta. |
raw_location |
Posizione grezza del veicolo (non elaborata da Autosnapper). |
raw_location_time |
Timestamp associato alla località non elaborata. |
raw_location_sensor |
Origine della località non elaborata. Il valore predefinito è |
raw_location_accuracy |
Precisione di |
supplemental_location |
Posizione supplementare fornita dall'app integrata. |
supplemental_location_time |
Timestamp associato alla località supplementare. |
supplemental_location_sensor |
Origine della località supplementare. Il valore predefinito è |
supplemental_location_accuracy |
Precisione di |
road_snapped |
Deprecato: utilizza |
DeliveryVehicleLocationSensor
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 di telefonia mobile o punto di accesso Wi-Fi. |
PASSIVE |
Punto di accesso Wi-Fi o ID ripetitore di telefonia mobile. |
ROAD_SNAPPED_LOCATION_PROVIDER |
Una posizione determinata dal dispositivo mobile come la posizione stradale più probabile. |
CUSTOMER_SUPPLIED_LOCATION |
Una posizione fornita dal cliente da una fonte indipendente. In genere, questo valore viene utilizzato per una posizione fornita da fonti diverse dal dispositivo mobile che esegue l'SDK Driver. Se la fonte originale è descritta da uno degli altri valori di enum, utilizza quel valore. Le sedi contrassegnate con CUSTOMER_SUPPLIED_LOCATION in genere vengono fornite tramite il last_location.supplemental_location_sensor di DeliveryVeicoli. |
FLEET_ENGINE_LOCATION |
Una località calcolata da Fleet Engine in base ai segnali 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 della posizione sui sistemi operativi Apple. |
GetDeliveryVehicleRequest
Il messaggio di richiesta GetDeliveryVehicle
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
name |
Obbligatoria. Deve essere nel formato |
GetTaskRequest
Il messaggio di richiesta GetTask
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
name |
Obbligatoria. Deve essere nel formato |
GetTaskTrackingInfoRequest
Il messaggio di richiesta GetTaskTrackingInfoRequest
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
name |
Obbligatoria. Deve essere nel formato |
ListDeliveryVehiclesRequest
Il messaggio di richiesta ListDeliveryVehicles
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
parent |
Obbligatoria. Deve essere nel formato |
page_size |
Campo facoltativo. Il numero massimo di veicoli da restituire. Il servizio potrebbe restituire un numero inferiore a questo numero. Se non specifichi questo numero, il server determina il numero di risultati da restituire. |
page_token |
Campo facoltativo. Un token di pagina, ricevuto da una chiamata Durante l'impaginazione, tutti gli altri parametri forniti a |
filter |
Campo facoltativo. Una query di filtro da applicare quando elenca i veicoli per la consegna. Vedi http://aip.dev/160 per esempi di sintassi del filtro. Se non specifichi un valore o specifichi una stringa vuota per il filtro, vengono restituiti tutti i veicoli per la consegna. Tieni presente che le uniche query supportate per Il numero massimo di limitazioni consentite in una query di filtro è 50. Una restrizione è una parte della query nel formato |
viewport |
Campo facoltativo. Un filtro che limita i veicoli restituiti a quelli la cui ultima posizione nota si trovava nell'area rettangolare definita dall'area visibile. |
ListDeliveryVehiclesResponse
Il messaggio di risposta ListDeliveryVehicles
.
Campi | |
---|---|
delivery_vehicles[] |
L'insieme di veicoli di pubblicazione che soddisfano i criteri di filtro richiesti. Se non viene specificato alcun filtro, la richiesta restituisce tutti i veicoli per la consegna. Una risposta corretta può anche essere vuota. Una risposta vuota indica che non sono stati trovati veicoli per la consegna che soddisfano i criteri di filtro richiesti. |
next_page_token |
Puoi passare questo token nell' |
total_size |
Il numero totale di veicoli per la consegna che corrispondono ai criteri della richiesta, in tutte le pagine. |
ListTasksRequest
Il messaggio di richiesta ListTasks
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
parent |
Obbligatoria. Deve essere nel formato |
page_size |
Campo facoltativo. Il numero massimo di attività da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specifichi questo valore, il server determina il numero di risultati da restituire. |
page_token |
Campo facoltativo. Un token di pagina ricevuto da una chiamata Durante l'impaginazione, tutti gli altri parametri forniti a |
filter |
Campo facoltativo. Una query di filtro da applicare quando elenca le attività. Vedi http://aip.dev/160 per esempi di sintassi dei filtri. Se non specifichi un valore o se filtri in base a una stringa vuota, vengono restituite tutte le attività. Per informazioni sulle proprietà delle attività in base alle quali puoi filtrare, vedi Elencare le attività. |
ListTasksResponse
La risposta ListTasks
che contiene il set di attività che soddisfano i criteri di filtro in ListTasksRequest
.
Campi | |
---|---|
tasks[] |
L'insieme di attività che soddisfano i criteri di filtro richiesti. Se non viene specificato alcun filtro, la richiesta restituisce tutte le attività. Una risposta corretta può anche essere vuota. Una risposta vuota indica che non sono state trovate attività che soddisfano i criteri di filtro richiesti. |
next_page_token |
Passa questo token nel |
total_size |
Il numero totale di attività che corrispondono ai criteri della richiesta, in tutte le pagine. |
LocationInfo
Una località con eventuali identificatori aggiuntivi.
Campi | |
---|---|
point |
Le coordinate della località. |
SearchTasksRequest
Deprecato: problema di GetTaskTrackingInfoRequest
in GetTaskTrackingInfo
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
parent |
Obbligatoria. Deve essere nel formato |
tracking_id |
Obbligatoria. L'identificatore dell'insieme di attività correlate richieste. Gli ID monitoraggio sono soggetti alle seguenti limitazioni:
|
page_size |
Campo facoltativo. Il numero massimo di attività da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specifichi questo valore, il server determina il numero di risultati da restituire. |
page_token |
Campo facoltativo. Un token di pagina, ricevuto da una chiamata Durante l'impaginazione, tutti gli altri parametri forniti a |
SearchTasksResponse
La risposta SearchTasks
. Contiene il set di attività che soddisfano i criteri di ricerca in SearchTasksRequest
.
Campi | |
---|---|
tasks[] |
Il set di attività per l'elemento |
next_page_token |
Passa questo token nel |
Attività
Un'attività nell'API Delivery rappresenta una singola azione da monitorare. In generale, esiste una distinzione tra Tasks relativo alla spedizione e Tasks interrotto. A una spedizione possono essere associate più attività. Ad esempio, potrebbe esserci un'attività per il ritiro e un'altra per la consegna o il trasferimento. Inoltre, veicoli diversi possono gestire attività diverse per una determinata spedizione. Ad esempio, un veicolo potrebbe gestire il ritiro, facendo in modo che il pacco arriva fino all'hub, mentre un altro può guidare la stessa spedizione dall'hub al punto di consegna.
Nota: le API gRPC e REST utilizzano convenzioni di denominazione dei campi diverse. Ad esempio, il campo Task.journey_sharing_info
nell'API gRPC e il campo Task.journeySharingInfo
nell'API REST fanno riferimento allo stesso campo.
Campi | |
---|---|
name |
Deve essere nel formato |
type |
Obbligatoria. Immutabile. Definisce il tipo di attività. Ad esempio, una pausa o una spedizione. |
state |
Obbligatoria. Lo stato di esecuzione attuale dell'attività. |
task_outcome |
Il risultato dell'attività. |
task_outcome_time |
Il timestamp che indica quando il risultato di |
task_outcome_location |
La località in cui è stato impostato il risultato di |
task_outcome_location_source |
Indica da dove proviene il valore di |
tracking_id |
Immutabile. Questo campo facilita l'archiviazione di un ID per evitare di utilizzare una mappatura complicata. Non puoi impostare
|
delivery_vehicle_id |
Solo output. L'ID del veicolo su cui è in corso questa attività. Gli ID veicolo per la consegna sono soggetti alle seguenti limitazioni:
|
planned_location |
Immutabile. La posizione in cui verrà completata l'attività. Facoltativo per |
task_duration |
Obbligatoria. Immutabile. Il tempo necessario per eseguire un'attività in questa posizione. |
target_time_window |
La finestra temporale durante la quale deve essere completata l'attività. |
journey_sharing_info |
Solo output. Campi specifici della condivisione del percorso. Non compilato quando lo stato è |
task_tracking_view_config |
La configurazione per il monitoraggio delle attività che specifica quali elementi di dati sono visibili agli utenti finali e in quali circostanze. |
attributes[] |
Un elenco di attributi personalizzati delle attività. Ogni attributo deve avere una chiave univoca. |
JourneySharingInfo
Condivisione di campi specifici nel percorso.
Campi | |
---|---|
remaining_vehicle_journey_segments[] |
Informazioni di monitoraggio relative alle fermate che il veicolo assegnato farà prima che completi questa attività. Tieni presente che questo elenco può contenere fermate da altre attività. Il primo segmento, |
last_location |
Indica l'ultima posizione segnalata del veicolo. |
last_location_snappable |
Indica se l'ultima posizione del veicolo può essere agganciata a |
Stato
Lo stato di un'attività. Indica l'avanzamento dell'attività.
Enum | |
---|---|
STATE_UNSPECIFIED |
Predefinita. Utilizzato per uno stato dell'attività non specificato o non riconosciuto. |
OPEN |
L'attività non è stata ancora assegnata a un veicolo per la consegna oppure il veicolo per la consegna non ha ancora superato la fermata del veicolo assegnata a Task . |
CLOSED |
Quando il veicolo supera l'arresto per questa attività. |
TaskOutcome
L'esito del tentativo di eseguire un'attività. Quando TaskState
viene chiuso, TaskOutcome
indica se l'operazione è stata completata correttamente.
Enum | |
---|---|
TASK_OUTCOME_UNSPECIFIED |
Il risultato dell'attività prima che venga impostato il relativo valore. |
SUCCEEDED |
L'attività è stata completata. |
FAILED |
Non è stato possibile completare l'attività oppure è stata annullata. |
TaskOutcomeLocationSource
L'identità dell'origine che ha compilato task_outcome_location
.
Enum | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
Il risultato dell'attività prima che sia impostato. |
PROVIDER |
Il provider ha specificato task_outcome_location . |
LAST_VEHICLE_LOCATION |
Il provider non ha specificato task_outcome_location , quindi Fleet Engine ha utilizzato l'ultima posizione nota del veicolo. |
Tipo
Il tipo di attività.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Impostazione predefinita, il tipo di attività è sconosciuto. |
PICKUP |
Un'attività di ritiro è l'azione intrapresa per ritirare una spedizione da un cliente. I ritiri dei veicoli con feeder o deposito devono essere di tipo SCHEDULED_STOP . |
DELIVERY |
Un'attività di consegna è l'azione intrapresa per consegnare una spedizione a un cliente finale. Le riduzioni dei veicoli per il deposito o la stazione di carico devono essere di tipo SCHEDULED_STOP . |
SCHEDULED_STOP |
Un'attività con interruzione pianificata viene utilizzata a scopo di pianificazione. Ad esempio, potrebbe rappresentare il ritiro o la consegna delle spedizioni dai veicoli con feeder o dai depositi. Non deve essere utilizzato per qualsiasi spedizione ritirata o consegnata da un cliente finale. |
UNAVAILABLE |
Un'attività che indica che il veicolo non è disponibile per il servizio. Ciò può accadere, ad esempio, quando il conducente fa una pausa o quando il veicolo viene rifornito. |
TaskAttribute
Descrive un attributo di un'attività come coppia chiave-valore. La lunghezza della stringa "key:value" non può superare i 256 caratteri.
Campi | |
---|---|
key |
La chiave dell'attributo. Le chiavi non possono contenere i due punti (:). |
Campo di unione task_attribute_value . Il valore dell'attributo può essere di tipo stringa, bool o doppio. Se non viene impostato nessuno, il valore string_value di TaskAttribute verrà memorizzato come stringa vuota "". task_attribute_value può essere solo uno dei seguenti: |
|
string_value |
Valore dell'attributo di tipo stringa. |
bool_value |
Valore dell'attributo con tipo booleano. |
number_value |
Valore dell'attributo con doppio tipo. |
TaskTrackingInfo
Il messaggio TaskTrackingInfo
. Il messaggio contiene informazioni sul monitoraggio delle attività che verranno utilizzate per la visualizzazione. Se un ID monitoraggio è associato a più Tasks, Fleet Engine utilizza un'euristica per decidere quale TaskTrackingInfo dell'attività selezionare.
Campi | |
---|---|
name |
Deve essere nel formato |
tracking_id |
Immutabile. L'ID monitoraggio di un'attività. * Deve essere una stringa Unicode valida. * Limitato a una lunghezza massima di 64 caratteri. * Normalizzata secondo lo standard Unicode Normalization Form C. * Non può contenere nessuno dei seguenti caratteri ASCII: '/', ':', '?', ',' o '#'. |
vehicle_location |
L'ultima posizione del veicolo. |
route_polyline_points[] |
Un elenco di punti che, se collegati, forma una polilinea del percorso previsto dal veicolo verso il luogo in cui si svolge l'attività. |
remaining_stop_count |
Indica il numero di fermate rimanenti del veicolo fino al raggiungimento dell'arresto attività, incluso l'arresto attività. Ad esempio, se la fermata successiva del veicolo è la fermata dell'attività, il valore sarà 1. |
remaining_driving_distance_meters |
La distanza totale rimanente in metri al |
estimated_arrival_time |
Il timestamp che indica l'ora di arrivo prevista alla posizione della fermata. |
estimated_task_completion_time |
Il timestamp che indica il tempo di completamento stimato di un'attività. |
state |
Lo stato di esecuzione attuale dell'attività. |
task_outcome |
L'esito del tentativo di eseguire un'attività. |
task_outcome_time |
Il timestamp che indica quando il risultato dell'attività è stato impostato dal provider. |
planned_location |
Immutabile. La posizione in cui verrà completata l'attività. |
target_time_window |
La finestra temporale durante la quale deve essere completata l'attività. |
attributes[] |
Gli attributi personalizzati impostati nell'attività. |
TaskTrackingViewConfig
Il messaggio di configurazione che definisce quando un elemento di dati di un'attività deve essere visibile agli utenti finali.
Campi | |
---|---|
route_polyline_points_visibility |
Il campo che specifica quando possono essere visibili i punti delle polilinee del percorso. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
estimated_arrival_time_visibility |
Il campo che specifica quando può essere visibile l'ora di arrivo prevista. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
estimated_task_completion_time_visibility |
Il campo che specifica quando può essere visibile il tempo di completamento stimato dell'attività. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
remaining_driving_distance_visibility |
Il campo che specifica la distanza percorsa rimanente in auto può essere visibile. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
remaining_stop_count_visibility |
Il campo che specifica quando il numero di fermate rimanenti può essere visibile. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
vehicle_location_visibility |
Il campo che specifica quando può essere visibile la posizione del veicolo. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
VisibilityOption
Il messaggio di opzione che definisce quando un elemento di dati deve essere visibile agli utenti finali.
Campi | |
---|---|
Campo di unione visibility_option . È stata scelta l'opzione di visibilità specifica. visibility_option può essere solo uno dei seguenti: |
|
remaining_stop_count_threshold |
Questo elemento di dati è visibile agli utenti finali se il numero di fermate rimanenti è <= left_stop_count_threshold. |
duration_until_estimated_arrival_time_threshold |
Questo elemento di dati è visibile agli utenti finali se l'orario di arrivo stimato fino alla fermata è <= lifetime_until_estimated_arrival_time_threshold. |
remaining_driving_distance_meters_threshold |
Questo elemento di dati è visibile agli utenti finali se la distanza di guida rimanente in metri è <= left_driving_distance_meters_threshold. |
always |
Se viene impostato su true, questo elemento di dati è sempre visibile agli utenti finali senza soglie. Questo campo non può essere impostato su false. |
never |
Se viene impostato su true, questo elemento di dati è sempre nascosto agli utenti finali senza soglie. Questo campo non può essere impostato su false. |
TimeWindow
Un intervallo di tempo.
Campi | |
---|---|
start_time |
Obbligatoria. L'ora di inizio della finestra temporale (inclusa). |
end_time |
Obbligatoria. L'ora di fine della finestra temporale (inclusa). |
UpdateDeliveryVehicleRequest
Il messaggio di richiesta UpdateDeliveryVehicle
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
delivery_vehicle |
Obbligatoria. Aggiornamento dell'entità |
update_mask |
Obbligatoria. Una maschera dei campi che indica quali Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: |
UpdateTaskRequest
Il messaggio di richiesta UpdateTask
.
Campi | |
---|---|
header |
Campo facoltativo. L'intestazione della richiesta dell'API Delivery standard. |
task |
Obbligatoria. L'attività associata all'aggiornamento. I seguenti campi sono gestiti da Fleet Engine. Non aggiornarle usando
Nota: non puoi modificare il valore di Se l'attività è stata assegnata a un veicolo per le consegne, non impostarne lo stato su CHIUSA utilizzando |
update_mask |
Obbligatoria. La maschera dei campi che indica quali campi Attività aggiornare. Nota: Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: |
VehicleJourneySegment
Rappresenta il segmento di viaggio di un veicolo, dalla fermata precedente a quella corrente. Se è la prima fermata attiva, significa che si tratta dalla posizione attuale del veicolo a questa fermata.
Campi | |
---|---|
stop |
Specifica la posizione della fermata, insieme ai |
driving_distance_meters |
Solo output. La distanza da percorrere dalla fermata precedente a questa fermata. Se la fermata corrente è la prima fermata nell'elenco dei segmenti del viaggio, il punto di partenza è la posizione del veicolo registrata al momento in cui la fermata è stata aggiunta all'elenco. Questo campo potrebbe non essere presente se questo tratto del percorso fa parte di |
driving_duration |
Solo output. Il tempo di percorrenza dalla fermata precedente a questa fermata. Se la fermata corrente è la prima fermata nell'elenco dei segmenti del viaggio, il punto di partenza è la posizione del veicolo registrata nel momento in cui la fermata è stata aggiunta all'elenco. Se questo campo viene definito nel percorso |
path[] |
Solo output. Il percorso dalla fermata precedente a questa fermata. Se la fermata corrente è la prima fermata nell'elenco dei segmenti del viaggio, questo è il percorso dalla posizione corrente del veicolo a questa fermata nel momento in cui la fermata è stata aggiunta all'elenco. Questo campo potrebbe non essere presente se questo tratto del percorso fa parte di Se questo campo viene definito nel percorso |
VehicleStop
Descrive un punto in cui un veicolo si ferma per eseguire uno o più Task
.
Campi | |
---|---|
planned_location |
Obbligatoria. La posizione della fermata. Tieni presente che le località negli |
tasks[] |
Elenco di |
state |
Lo stato del |
Stato
Lo stato attuale di un oggetto VehicleStop
.
Enum | |
---|---|
STATE_UNSPECIFIED |
Sconosciuto. |
NEW |
L'elemento è stato creato, ma il routing non è attivo. |
ENROUTE |
Assegnati e routing attivo. |
ARRIVED |
Arrivato alla fermata. Presuppone che, quando il veicolo sta passando alla fermata successiva, che tutte le fermate precedenti siano state completate. |
TaskInfo
Informazioni aggiuntive sull'attività eseguita in questa fermata.
Campi | |
---|---|
task_id |
L'ID attività. Questo campo non verrà compilato nella risposta di una chiamata
|
task_duration |
Solo output. Il tempo necessario per eseguire l'attività. |
target_time_window |
Solo output. La finestra temporale durante la quale deve essere completata l'attività. Questo valore è impostato solo nella risposta a |