Package google.maps.routeoptimization.v1

int32

Numero di spedizioni eseguite. Tieni presente che una coppia di ritiro e consegna viene conteggiata una sola volta.

Duration

Durata totale del viaggio per un itinerario o una soluzione.

Duration

La durata totale dell'attesa per un itinerario o una soluzione.

Duration

Durata totale del ritardo per un itinerario o una soluzione.

Duration

La durata totale dell'interruzione per un percorso o una soluzione.

Duration

Durata totale della visita per un itinerario o una soluzione.

Duration

La durata totale deve essere uguale alla somma di tutte le durate sopra indicate. Per i percorsi, corrisponde anche a:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Distanza totale percorsa per un itinerario o una soluzione.

map<string, VehicleLoad>

Carico massimo raggiunto nell'intero percorso (risp. nella soluzione), per ciascuna delle quantità su questo percorso (risp. nella soluzione), calcolato come il massimo su tutti i Transition.vehicle_loads (risp. ShipmentRoute.metrics.max_loads.

string

Obbligatorio. Progetto e località di destinazione per effettuare una chiamata.

Formato: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Se non viene specificata alcuna località, verrà scelta automaticamente una regione.

AsyncModelConfig

Obbligatorio. Informazioni di input/output di ciascun modello di acquisto, ad esempio percorsi file e formati di dati.

string

Facoltativo. Nome del modello definito dall'utente, che può essere utilizzato come alias dagli utenti per tenere traccia dei modelli.

InputConfig

Obbligatorio. Informazioni sul modello di input.

OutputConfig

Obbligatorio. Le informazioni sulla posizione di output desiderata.

BreakRequest

Sequenza di interruzioni. Visualizza il messaggio BreakRequest.

FrequencyConstraint

Potrebbero essere applicati diversi FrequencyConstraint. Devono essere soddisfatte tutte le BreakRequest di questo BreakRule. Consulta FrequencyConstraint.

Timestamp

Obbligatorio. Limite inferiore (incluso) all'inizio dell'interruzione.

Timestamp

Obbligatorio. Limite superiore (incluso) all'inizio dell'interruzione.

Duration

Obbligatorio. Durata minima dell'interruzione. Il valore deve essere positivo.

Duration

Obbligatorio. Durata minima dell'interruzione per questo vincolo. Non negativo. Leggi la descrizione di FrequencyConstraint.

Duration

Obbligatorio. Periodo massimo consentito di qualsiasi intervallo di tempo nel percorso che non include almeno parzialmente un'interruzione di duration >= min_break_duration. Il valore deve essere positivo.

int64

Un limite massimo che impone che la distanza non superi max_meters. Il limite deve essere non negativo.

int64

Un limite flessibile che non applica un limite di distanza massima, ma che, se violato, genera un costo che si somma agli altri costi definiti nel modello, con la stessa unità di misura.

Se definito, soft_max_meters deve essere inferiore a max_meters e non deve essere negativo.

double

Costo per chilometro sostenuto, che aumenta fino a soft_max_meters, con la formula:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Questo costo non è supportato in route_distance_limit.

double

Costo per chilometro addebitato se la distanza supera il limite di soft_max_meters. Il costo aggiuntivo è pari a 0 se la distanza è inferiore al limite, altrimenti la formula utilizzata per calcolare il costo è la seguente:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Il costo deve essere non negativo.

string

Obbligatorio. URI Google Cloud Storage.

string

Obbligatorio. URI di un oggetto Google Cloud Storage con il formato gs://bucket/path/to/object.

ShipmentRoute

Percorsi della soluzione da iniettare. Alcuni percorsi potrebbero essere omessi dalla soluzione originale. I percorsi e le spedizioni saltate devono soddisfare le ipotesi di validità di base elencate per injected_first_solution_routes.

SkippedShipment

Caricamenti della soluzione da inserire ignorati. Alcuni potrebbero essere omessi dalla soluzione originale. Consulta il campo routes.

ConstraintRelaxation

Per zero o più gruppi di veicoli, specifica quando e in che misura allentare i vincoli. Se questo campo è vuoto, tutti i percorsi dei veicoli non vuoti sono completamente vincolati.

Relaxation

Tutti gli allentamento dei vincoli di visita che verranno applicati alle visite sui percorsi con veicoli in vehicle_indices.

int32

Specifica gli indici dei veicoli a cui si applica la limitazione di visita relaxations. Se è vuoto, viene considerato predefinito e relaxations si applica a tutti i veicoli non specificati in altri constraint_relaxations. Può essere presente al massimo un valore predefinito, ovvero è consentito un solo campo di rilassamento dei vincoli vuoto vehicle_indices. Un indice del veicolo può essere elencato una sola volta, anche all'interno di più constraint_relaxations.

Un indice del veicolo viene mappato come ShipmentRoute.vehicle_index, se interpret_injected_solutions_using_labels è true (vedi il commento fields).

Level

Il livello di rilassamento delle limitazioni che si applica quando le condizioni a partire da threshold_time E almeno threshold_visit_count sono soddisfatte.

Timestamp

L'ora a partire dalla quale è possibile applicare il rilassamento level.

int32

Il numero di visite a partire dal quale è possibile applicare il rilassamento level. Se threshold_visit_count è 0 (o non impostato), level può essere applicato direttamente all'avvio del veicolo.

Se è route.visits_size() + 1, il level può essere applicato solo al veicolo. Se è superiore a route.visits_size() + 1, level non viene applicato per quel percorso.

DataFormat

Obbligatorio. Il formato dei dati di input.

GcsSource

Una posizione di Google Cloud Storage. Deve essere un singolo oggetto (file).

LatLng

Le coordinate geografiche del waypoint.

int32

La direzione della bussola associata alla direzione del flusso del traffico. Questo valore viene utilizzato per specificare il lato della strada da utilizzare per il ritiro e il reso. I valori di rotta possono variare da 0 a 360, dove 0 indica una rotta a nord, 90 indica una rotta a est e così via.

string

Obbligatorio. Progetto o località di destinazione per effettuare una chiamata.

Formato: * projects/{project-id} * projects/{project-id}/locations/{location-id}

Se non viene specificata alcuna località, verrà scelta automaticamente una regione.

Duration

Se questo timeout è impostato, il server restituisce una risposta prima che sia trascorso il periodo di timeout o che venga raggiunta la scadenza del server per le richieste sincrone, a seconda del caso.

Per le richieste asincrone, il server genererà una soluzione (se possibile) prima del timeout.

ShipmentModel

Modello di spedizione da risolvere.

SolvingMode

Per impostazione predefinita, la modalità di risoluzione è DEFAULT_SOLVE (0).

SearchMode

Modalità di ricerca utilizzata per risolvere la richiesta.

ShipmentRoute

Guida l'algoritmo di ottimizzazione a trovare una prima soluzione simile a una precedente.

Il modello è vincolato quando viene creata la prima soluzione. Eventuali spedizioni non eseguite su un percorso vengono ignorate implicitamente nella prima soluzione, ma possono essere eseguite nelle soluzioni successive.

La soluzione deve soddisfare alcune ipotesi di validità di base:

• Per tutti i percorsi, vehicle_index deve essere compreso nell'intervallo e non deve essere duplicato.
• Per tutte le visite, shipment_index e visit_request_index devono essere compresi nell'intervallo.
• È possibile fare riferimento a una spedizione in un solo percorso.
• il ritiro di una spedizione con ritiro e consegna deve essere eseguito prima della consegna.
• non può essere eseguita più di un'alternativa di ritiro o consegna di una spedizione.
• per tutti i percorsi, i tempi sono in aumento (ad es. vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• una spedizione può essere eseguita solo su un veicolo consentito. Un veicolo è consentito se Shipment.allowed_vehicle_indices è vuoto o se il relativo vehicle_index è incluso in Shipment.allowed_vehicle_indices.

Se la soluzione iniettata non è fattibile, non viene necessariamente restituito un errore di convalida, ma potrebbe essere restituito un errore che indica l'impossibilità di applicazione.

InjectedSolutionConstraint

Limita l'algoritmo di ottimizzazione per trovare una soluzione finale simile a una precedente. Ad esempio, può essere utilizzato per bloccare parti di percorsi già completati o da completare, ma che non devono essere modificati.

Se la soluzione iniettata non è fattibile, non viene necessariamente restituito un errore di convalida, ma potrebbe essere restituito un errore che indica l'impossibilità di applicazione.

ShipmentRoute

Se non è vuoto, i percorsi specificati verranno aggiornati, senza modificare la sequenza di visite o i tempi di percorrenza sottostanti: verranno aggiornati solo gli altri dettagli. Questo non risolve il problema del modello.

A partire da novembre 2020, vengono compilati solo i polilinei dei percorsi non vuoti e populate_polylines deve essere impostato su true.

I campi route_polyline dei percorsi passati potrebbero non essere coerenti con il percorso transitions.

Questo campo non deve essere utilizzato insieme a injected_first_solution_routes o injected_solution_constraint.

Shipment.ignore e Vehicle.ignore non hanno alcun effetto sul comportamento. I polilinee vengono comunque compilati tra tutte le visite in tutti i percorsi non vuoti, indipendentemente dal fatto che le spedizioni o i veicoli correlati vengano ignorati.

bool

Se true:

• utilizza ShipmentRoute.vehicle_label anziché vehicle_index per abbinare i percorsi in una soluzione iniettata ai veicoli nella richiesta; riutilizza la mappatura dell'ShipmentRoute.vehicle_index originale al nuovo ShipmentRoute.vehicle_index per aggiornare ConstraintRelaxation.vehicle_indices se non vuoto, ma la mappatura deve essere non ambigua (ovvero più ShipmentRoute non devono condividere lo stesso vehicle_index originale).
• utilizza ShipmentRoute.Visit.shipment_label anziché shipment_index per abbinare le visite in una soluzione iniettata alle spedizioni nella richiesta.
• utilizza SkippedShipment.label anziché SkippedShipment.index per abbinare le spedizioni saltate nella soluzione iniettata alle spedizioni richieste.

Questa interpretazione si applica ai campi injected_first_solution_routes, injected_solution_constraint e refresh_details_routes. Può essere utilizzato quando gli indici di spedizione o veicolo nella richiesta sono cambiati dalla creazione della soluzione, ad esempio perché le spedizioni o i veicoli sono stati rimossi dalla richiesta o aggiunti.

Se true, le etichette nelle seguenti categorie devono apparire al massimo una volta nella rispettiva categoria:

• Vehicle.label nella richiesta.
• Shipment.label nella richiesta.
• ShipmentRoute.vehicle_label nella soluzione iniettata;
• SkippedShipment.label e ShipmentRoute.Visit.shipment_label nella soluzione iniettata (tranne le coppie di visite di ritiro/consegna, il cui shipment_label deve apparire due volte).

Se un vehicle_label nella soluzione iniettata non corrisponde a un veicolo richiesto, il percorso corrispondente viene rimosso dalla soluzione insieme alle relative visite. Se un shipment_label nella soluzione iniettata non corrisponde a un invio di richieste, la visita corrispondente viene rimossa dalla soluzione. Se un SkippedShipment.label nella soluzione iniettata non corrisponde a una spedizione richiesta, il SkippedShipment viene rimosso dalla soluzione.

La rimozione di visite ai percorsi o di interi percorsi da una soluzione iniettata può influire sui vincoli impliciti, il che può comportare la modifica della soluzione, errori di convalida o l'impossibilità di applicazione.

NOTA: l'utente che chiama deve assicurarsi che ogni Vehicle.label (risp. Shipment.label) identifica in modo univoco un'entità veicolo (risp. spedizione) utilizzata nelle due richieste pertinenti: la richiesta passata che ha prodotto il OptimizeToursResponse utilizzato nella soluzione iniettata e la richiesta corrente che include la soluzione iniettata. I controlli di unicità descritti sopra non sono sufficienti per garantire questo requisito.

bool

Tieni conto della stima del traffico per calcolare i campi ShipmentRoute Transition.travel_duration, Visit.start_time e vehicle_end_time, per impostare il campo ShipmentRoute.has_traffic_infeasibilities e per calcolare il campo OptimizeToursResponse.total_cost.

bool

Se true, i polilinee verranno compilati nelle ShipmentRoute di risposta.

bool

Se true, i polilinee e i token di percorso verranno compilati nella risposta ShipmentRoute.transitions.

bool

Se questo valore è impostato, la richiesta può avere una scadenza (vedi https://grpc.io/blog/deadlines) fino a 60 minuti. In caso contrario, la scadenza massima è di soli 30 minuti. Tieni presente che le richieste a lungo termine presentano un rischio di interruzione notevolmente maggiore (ma comunque ridotto).

bool

Se true, le distanze di viaggio verranno calcolate utilizzando le distanze geodetiche anziché quelle di Google Maps e i tempi di viaggio verranno calcolati utilizzando le distanze geodetiche con una velocità definita da geodesic_meters_per_second.

string

L'etichetta che può essere utilizzata per identificare questa richiesta, riportata in OptimizeToursResponse.request_label.

double

Quando use_geodesic_distances è true, questo campo deve essere impostato e definisce la velocità applicata per calcolare i tempi di percorrenza. Il valore deve essere almeno pari a 1,0 metri/secondi.

int32

Tronca il numero di errori di convalida restituiti. Questi errori sono in genere associati al payload dell'errore INVALID_ARGUMENT come dettaglio dell'errore BadRequest (https://cloud.google.com/apis/design/errors#error_details), a meno che solving_mode=VALIDATE_ONLY: consulta il campo OptimizeToursResponse.validation_errors. Il valore predefinito è 100 e il limite è 10.000.

ShipmentRoute

Percorsi calcolati per ogni veicolo; il percorso i-esimo corrisponde al veicolo i-esimo nel modello.

string

Copia del OptimizeToursRequest.label, se nella richiesta è stata specificata un'etichetta.

SkippedShipment

L'elenco di tutte le spedizioni ignorate.

OptimizeToursValidationError

Elenco di tutti gli errori di convalida che siamo riusciti a rilevare in modo indipendente. Consulta la spiegazione "ERRORI MULTIPLI" per il messaggio OptimizeToursValidationError. Invece di errori, verranno inclusi avvisi nel caso in cui solving_mode sia DEFAULT_SOLVE.

Metrics

Metriche relative a durata, distanza e utilizzo per questa soluzione.

AggregatedMetrics

Aggregato per i percorsi. Ogni metrica è la somma (o il valore massimo, per i caricamenti) di tutti i campi ShipmentRoute.metrics dello stesso nome.

int32

Numero di importazioni obbligatorie ignorate.

int32

Numero di veicoli utilizzati. Nota: se il percorso di un veicolo è vuoto e Vehicle.used_if_route_is_empty è true, il veicolo è considerato usato.

Timestamp

L'ora di inizio più antica per un veicolo usato, calcolata come valore minimo di ShipmentRoute.vehicle_start_time per tutti i veicoli usati.

Timestamp

L'ora di fine più recente per un veicolo usato, calcolata come valore massimo di ShipmentRoute.vehicle_end_time per tutti i veicoli usati.

map<string, double>

Costo della soluzione, suddiviso in base ai campi delle richieste relativi ai costi. Le chiavi sono percorsi proto, relativi all'input OptimizeToursRequest, ad esempio "model.shipments.pickups.cost", e i valori sono il costo totale generato dal campo del costo corrispondente, aggregato nell'intera soluzione. In altre parole, costs["model.shipments.pickups.cost"] è la somma di tutti i costi di ritiro della soluzione. Tutti i costi definiti nel modello sono riportati in dettaglio qui, ad eccezione dei costi relativi a TransitionAttributes, che vengono registrati solo in modo aggregato a partire da gennaio 2022.

double

Costo totale della soluzione. La somma di tutti i valori nella mappa dei costi.

int32

Un errore di convalida è definito dalla coppia (code, display_name) che è sempre presente.

I campi che seguono questa sezione forniscono ulteriori informazioni sull'errore.

ERRORI MULTIPLI: quando sono presenti più errori, la procedura di convalida tenta di generarne diversi. Come per un compilatore, si tratta di un processo imperfetto. Alcuni errori di convalida sono "fatali", il che significa che interrompono l'intera procedura di convalida. È il caso, ad esempio, degli errori display_name="UNSPECIFIED". Alcuni errori possono causare il salto di altri errori durante la procedura di convalida.

STABILITÀ: code e display_name devono essere molto stabili. Tuttavia, nel tempo potrebbero apparire nuovi codici e nomi visualizzati, il che potrebbe causare la generazione di una coppia (code, display_name) diversa per una determinata richiesta (non valida) perché il nuovo errore ha nascosto quello precedente. Ad esempio, consulta "ERRORI MULTIPLI".

string

Il nome visualizzato dell'errore.

FieldReference

Un contesto di errore può coinvolgere 0, 1 (la maggior parte delle volte) o più campi. Ad esempio, il riferimento al primo ritiro del veicolo 4 e della spedizione 2 può essere effettuato come segue:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

Tieni presente, tuttavia, che la cardinalità di fields non deve cambiare per un determinato codice di errore.

string

Stringa leggibile che descrive l'errore. Esiste una mappatura 1:1 tra code e error_message (se il codice != "UNSPECIFIED").

STABILITÀ: non stabile: il messaggio di errore associato a un determinato code potrebbe cambiare (si spera per chiarirlo) nel tempo. Utilizza invece display_name e code.

string

Può contenere i valori dei campi. Questa opzione non è sempre disponibile. Non devi assolutamente fare affidamento su questo valore e devi utilizzarlo solo per il debug manuale del modello.

string

Nome del campo, ad esempio "vehicles".

FieldReference

Se necessario, sottocampo nidificato in modo ricorsivo.

int32

Indice del campo se ripetuto.

string

Chiave se il campo è una mappa.

DataFormat

Obbligatorio. Il formato dei dati di output.

GcsDestination

La posizione di Google Cloud Storage in cui scrivere l'output.

bool

Specifica se evitare le strade a pedaggio, ove ragionevole. Verrà data la preferenza ai percorsi che non includono strade a pedaggio. Si applica solo alle modalità di viaggio motorizzate.

bool

Specifica se evitare le autostrade, ove possibile. Verrà data la preferenza ai percorsi che non contengono autostrade. Si applica solo alle modalità di viaggio motorizzate.

bool

Specifica se evitare i traghetti, ove ragionevole. Verrà data la preferenza ai percorsi che non includono viaggi in traghetto. Si applica solo alle modalità di viaggio motorizzate.

bool

Facoltativo. Specifica se evitare di navigare all'interno, ove ragionevole. Verrà data la preferenza ai percorsi che non contengono la navigazione al chiuso. Si applica solo alla modalità di viaggio WALKING.

string

Il nome visualizzato della spedizione definito dall'utente. Può contenere fino a 63 caratteri e può utilizzare caratteri UTF-8.

VisitRequest

Set di alternative di ritiro associate alla spedizione. Se non specificato, il veicolo deve visitare solo una località corrispondente alle consegne.

VisitRequest

Serie di alternative di consegna associate alla spedizione. Se non specificato, il veicolo deve visitare solo una stazione di ricarica corrispondente ai punti di ritiro.

map<string, Load>

Le richieste di carico della spedizione (ad esempio peso, volume, numero di pallet e così via). Le chiavi nella mappa devono essere identificatori che descrivono il tipo di carico corrispondente, idealmente incluse anche le unità di misura. Ad esempio: "weight_kg", "volume_gallons", "pallet_count" e così via. Se una determinata chiave non compare nella mappa, il carico corrispondente viene considerato nullo.

int32

L'insieme di veicoli che possono effettuare questa spedizione. Se è vuoto, tutti i veicoli possono eseguirlo. I veicoli sono indicati dal relativo indice nell'elenco vehicles di ShipmentModel.

double

Specifica il costo sostenuto quando la spedizione viene consegnata da ciascun veicolo. Se specificato, deve avere OPPURE:

• lo stesso numero di elementi di costs_per_vehicle_indices. costs_per_vehicle[i] corrisponde al veicolo costs_per_vehicle_indices[i] del modello.
• lo stesso numero di elementi dei veicoli nel modello. L'elemento i corrisponde al veicolo n. i del modello.

Questi costi devono essere nella stessa unità di penalty_cost e non devono essere negativi. Lascia vuoto questo campo se non sono previsti costi di questo tipo.

int32

Indici dei veicoli a cui si applica costs_per_vehicle. Se non è vuoto, deve contenere lo stesso numero di elementi di costs_per_vehicle. Un indice del veicolo non può essere specificato più di una volta. Se un veicolo è escluso da costs_per_vehicle_indices, il relativo costo è pari a zero.

Duration

Specifica il tempo di deviazione assoluto massimo rispetto al percorso più breve dal ritiro alla consegna. Se specificato, deve essere non negativo e la spedizione deve contenere almeno un ritiro e una consegna.

Ad esempio, supponiamo che t sia il tempo più breve necessario per passare dall'opzione di ritiro selezionata direttamente all'opzione di consegna selezionata. L'impostazione pickup_to_delivery_absolute_detour_limit impone:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

Se nella stessa spedizione vengono specificati sia i limiti relativi che quelli assoluti, viene utilizzato il limite più restrittivo per ogni possibile coppia di ritiro/consegna. A partire da ottobre 2017, i percorsi alternativi sono supportati solo quando le durate dei viaggi non dipendono dai veicoli.

Duration

Specifica la durata massima dall'inizio del ritiro all'inizio della consegna di una spedizione. Se specificato, deve essere non negativo e la spedizione deve contenere almeno un ritiro e una consegna. Ciò non dipende dalle alternative selezionate per il ritiro e la consegna né dalla velocità del veicolo. Questo può essere specificato insieme ai vincoli di deviazione massima: la soluzione rispetterà entrambe le specifiche.

string

Stringa non vuota che specifica un "tipo" per questa spedizione. Questa funzionalità può essere utilizzata per definire incompatibilità o requisiti tra shipment_types (vedi shipment_type_incompatibilities e shipment_type_requirements in ShipmentModel).

È diverso da visit_types, che viene specificato per una singola visita: tutti i ritiri/le consegne appartenenti alla stessa spedizione condividono lo stesso shipment_type.

string

Specifica un'etichetta per questa spedizione. Questa etichetta viene riportata nella risposta in shipment_label del ShipmentRoute.Visit corrispondente.

bool

Se il valore è true, salta questa spedizione, ma non applica un penalty_cost.

Se ignori una spedizione, si verifica un errore di convalida se nel modello sono presenti shipment_type_requirements.

È consentito ignorare una spedizione eseguita in injected_first_solution_routes o injected_solution_constraint; il risolutore rimuove le visite di ritiro/consegna correlate dal percorso di esecuzione. precedence_rules che fanno riferimento alle spedizioni ignorate verranno ignorati.

double

Se la spedizione non viene completata, questa penale viene aggiunta al costo complessivo dei percorsi. Una spedizione è considerata completata se viene visitata una delle alternative di ritiro e consegna. Il costo può essere espresso nella stessa unità utilizzata per tutti gli altri campi relativi ai costi del modello e deve essere positivo.

IMPORTANTE: se questa penale non è specificata, è considerata infinita, ovvero la spedizione deve essere completata.

double

Specifica il tempo di deviazione massimo rispetto al percorso più breve dal ritiro alla consegna. Se specificato, deve essere non negativo e la spedizione deve contenere almeno un ritiro e una consegna.

Ad esempio, supponiamo che t sia il tempo più breve necessario per passare dall'opzione di ritiro selezionata direttamente all'opzione di consegna selezionata. L'impostazione pickup_to_delivery_relative_detour_limit impone:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

Se nella stessa spedizione vengono specificati sia i limiti relativi che quelli assoluti, viene utilizzato il limite più restrittivo per ogni possibile coppia di ritiro/consegna. A partire da ottobre 2017, i percorsi alternativi sono supportati solo quando le durate dei viaggi non dipendono dai veicoli.

int64

L'entità del carico del veicolo che esegue la visita corrispondente varierà. Poiché si tratta di un numero intero, consigliamo agli utenti di scegliere un'unità appropriata per evitare la perdita di precisione. Deve essere ≥ 0.

LatLng

La posizione geografica in cui arriva il veicolo quando esegui questa VisitRequest. Se il modello di spedizione contiene matrici di distanza e durata, arrival_location non deve essere specificato.

Waypoint

Il waypoint in cui arriva il veicolo quando esegue questa VisitRequest. Se il modello di spedizione contiene matrici di distanza e durata, arrival_waypoint non deve essere specificato.

LatLng

La geolocalizzazione da cui parte il veicolo al termine di questo VisitRequest. Può essere omesso se è uguale a arrival_location. Se il modello di spedizione contiene matrici di distanza e durata, departure_location non deve essere specificato.

Waypoint

Il waypoint da cui il veicolo parte dopo aver completato questa VisitRequest. Può essere omesso se è uguale a arrival_waypoint. Se il modello di spedizione contiene matrici di distanza e durata, departure_waypoint non deve essere specificato.

string

Specifica i tag associati alla richiesta di visita. Non sono consentite stringhe vuote o duplicate.

TimeWindow

Finestre temporali che limitano l'ora di arrivo in una visita. Tieni presente che un veicolo può partire al di fuori dell'intervallo di tempo di arrivo, ovvero l'ora di arrivo + la durata non devono rientrare in un intervallo di tempo. Ciò può comportare tempi di attesa se il veicolo arriva prima delle TimeWindow.start_time.

L'assenza di TimeWindow indica che il veicolo può effettuare questa visita in qualsiasi momento.

Le finestre temporali devono essere disgiunte, ovvero nessuna finestra temporale deve sovrapporsi o essere adiacente a un'altra, e devono essere in ordine crescente.

cost_per_hour_after_soft_end_time e soft_end_time possono essere impostati solo se esiste una singola finestra temporale.

Duration

Durata della visita, ovvero il tempo trascorso dal veicolo tra l'arrivo e la partenza (da aggiungere al possibile tempo di attesa; vedi time_windows).

double

Costo per soddisfare questa richiesta di visita su un percorso del veicolo. Questo può essere utilizzato per pagare costi diversi per ogni ritiro o consegna alternativa di una spedizione. Questo costo deve essere nella stessa unità di Shipment.penalty_cost e non deve essere negativo.

map<string, Load>

Carica le richieste di questa visita. È come il campo Shipment.load_demands, tranne per il fatto che si applica solo a questo VisitRequest anziché all'intero Shipment. Le richieste elencate qui vengono aggiunte a quelle elencate in Shipment.load_demands.

string

Specifica i tipi di visita. Questo può essere utilizzato per allocare il tempo aggiuntivo necessario a un veicolo per completare questa visita (vedi Vehicle.extra_visit_duration_for_visit_type).

Un tipo può essere visualizzato una sola volta.

string

Specifica un'etichetta per questo VisitRequest. Questa etichetta viene riportata nella risposta come visit_label in ShipmentRoute.Visit corrispondente.

Shipment

Set di importazioni da eseguire nel modello.

Vehicle

Set di veicoli che possono essere utilizzati per effettuare visite.

Timestamp

Ora di inizio e di fine globale del modello: nessuna ora al di fuori di questo intervallo può essere considerata valida.

L'intervallo di tempo del modello deve essere inferiore a un anno, ovvero global_end_time e global_start_time devono trovarsi a una distanza massima di 31536000 secondi l'uno dall'altro.

Quando utilizzi i campi cost_per_*hour, ti consigliamo di impostare questa finestra su un intervallo più breve per aumentare il rendimento (ad es. se modelli un solo giorno, devi impostare i limiti di tempo globali su quel giorno). Se non viene impostato, viene utilizzato il valore predefinito 00:00:00 UTC del 1° gennaio 1970 (ovvero secondi: 0, nano: 0).

Timestamp

Se non viene impostato, viene utilizzato il valore predefinito 00:00:00 UTC, 1° gennaio 1971 (ovvero secondi: 31536000, nano: 0).

double

La "durata globale" del piano complessivo è la differenza tra l'ora di inizio effettiva più antica e l'ora di fine effettiva più recente di tutti i veicoli. Gli utenti possono assegnare un costo per ora a questa quantità per provare a ottimizzare per il completamento più rapido del job, ad esempio. Questo costo deve essere espresso nella stessa unità di Shipment.penalty_cost.

DurationDistanceMatrix

Specifica le matrici di durata e distanza utilizzate nel modello. Se questo campo è vuoto, verranno utilizzate le distanze di Google Maps o geodesiche, a seconda del valore del campo use_geodesic_distances. Se non è vuoto, use_geodesic_distances non può essere vero e né duration_distance_matrix_src_tags né duration_distance_matrix_dst_tags possono essere vuoti.

Esempi di utilizzo:

• Esistono due località: locA e locB.
• 1 veicolo che inizia il percorso in locA e lo termina in locA.
• 1 richiesta di visita per il ritiro presso la locB.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• Esistono tre località: locA, locB e locC.
• 1 veicolo che inizia il percorso in locA e lo termina in locB, utilizzando la matrice "fast".
• 1 veicolo che inizia il percorso in locB e lo termina in locB, utilizzando la matrice "lenta".
• 1 veicolo che inizia il percorso in locB e lo termina in locB, utilizzando la matrice "fast".
• 1 richiesta di visita per il ritiro presso la locC.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

Tag che definiscono le origini delle matrici di durata e distanza; duration_distance_matrices(i).rows(j) definisce le durate e le distanze dalle visite con tag duration_distance_matrix_src_tags(j) alle altre visite nella matrice i.

I tag corrispondono a VisitRequest.tags o Vehicle.start_tags. Un determinato VisitRequest o Vehicle deve corrispondere esattamente a un tag in questo campo. Tieni presente che i tag di origine, di destinazione e della matrice di un Vehicle possono essere gli stessi; analogamente, i tag di origine e di destinazione di un VisitRequest possono essere gli stessi. Tutti i tag devono essere diversi e non possono essere stringhe vuote. Se questo campo non è vuoto, duration_distance_matrices non deve essere vuoto.

string

Tag che definiscono le destinazioni delle matrici di durata e distanza; duration_distance_matrices(i).rows(j).durations(k) (risp. duration_distance_matrices(i).rows(j).meters(k)) definisce la durata (rispettivamente la distanza) del viaggio dalle visite con il tag duration_distance_matrix_src_tags(j) alle visite con il tag duration_distance_matrix_dst_tags(k) nella matrice i.

I tag corrispondono a VisitRequest.tags o Vehicle.start_tags. Un determinato VisitRequest o Vehicle deve corrispondere esattamente a un tag in questo campo. Tieni presente che i tag di origine, di destinazione e della matrice di un Vehicle possono essere gli stessi; analogamente, i tag di origine e di destinazione di un VisitRequest possono essere gli stessi. Tutti i tag devono essere diversi e non possono essere stringhe vuote. Se questo campo non è vuoto, duration_distance_matrices non deve essere vuoto.

TransitionAttributes

Attributi di transizione aggiunti al modello.

ShipmentTypeIncompatibility

Insiemi di tipi di spedizione incompatibili (vedi ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Insiemi di requisiti shipment_type (vedi ShipmentTypeRequirement).

PrecedenceRule

Set di regole di precedenza che devono essere applicate nel modello.

int32

Limita il numero massimo di veicoli attivi. Un veicolo è attivo se il suo percorso prevede almeno una spedizione. Questo può essere utilizzato per limitare il numero di percorsi nel caso in cui i conducenti siano inferiori ai veicoli e il parco veicoli sia eterogeneo. L'ottimizzazione selezionerà quindi il sottoinsieme migliore di veicoli da utilizzare. Deve essere strettamente positivo.

Row

Specifica le righe della matrice di durata e distanza. Deve contenere lo stesso numero di elementi di ShipmentModel.duration_distance_matrix_src_tags.

string

Tag che definisce a quali veicoli si applica questa matrice di durata e distanza. Se è vuoto, si applica a tutti i veicoli e può essere presente una sola matrice.

Ogni inizio del viaggio del veicolo deve corrispondere esattamente a una matrice, ovvero esattamente uno dei suoi campi start_tags deve corrispondere al vehicle_start_tag di una matrice (e solo a quella matrice).

Tutte le matrici devono avere un vehicle_start_tag diverso.

Duration

Valori di durata per una determinata riga. Deve contenere lo stesso numero di elementi di ShipmentModel.duration_distance_matrix_dst_tags.

double

Valori di distanza per una determinata riga. Se nel modello non sono presenti costi o vincoli che fanno riferimento alle distanze, questo campo può essere lasciato vuoto; in caso contrario, deve contenere lo stesso numero di elementi di durations.

bool

Indica se l'evento "primo" è una pubblicazione.

bool

Indica se l'evento "secondo" è una pubblicazione.

Duration

Lo sfasamento tra l'evento "first" e l'evento "second". Può essere negativo.

int32

Indice di spedizione dell'evento "primo". Questo campo deve essere specificato.

int32

Indice di spedizione dell'evento "secondo". Questo campo deve essere specificato.

int32

Veicolo che esegue il percorso, identificato dal relativo indice nell'origine ShipmentModel.

string

Etichetta del veicolo che esegue questo percorso, uguale a ShipmentModel.vehicles(vehicle_index).label, se specificato.

Timestamp

Ora in cui il veicolo inizia il percorso.

Timestamp

Ora in cui il veicolo termina il percorso.

Visit

Sequenza ordinata di visite che rappresenta un percorso. visits[i] è la i-esima visita nel percorso. Se questo campo è vuoto, il veicolo è considerato inutilizzato.

Transition

Elenco ordinato delle transizioni per il percorso.

bool

Quando OptimizeToursRequest.consider_road_traffic è impostato su true, questo campo indica che le incongruenze nei tempi di percorrenza del percorso vengono previste utilizzando le stime della durata del viaggio in base al traffico. Il tempo potrebbe non essere sufficiente per completare i viaggi, i ritardi e le interruzioni tra le visite, prima della prima visita o dopo l'ultima visita, tenendo conto del traffico, pur rispettando le finestre di tempo per le visite e i veicoli. Ad esempio,

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

L'arrivo a next_visit avverrà probabilmente più tardi rispetto all'attuale finestra temporale a causa dell'aumento della stima del tempo di percorrenza travel_duration(previous_visit, next_visit) a causa del traffico. Inoltre, una pausa potrebbe sovrapporsi a una visita a causa di un aumento delle stime dei tempi di percorrenza e delle limitazioni relative alle finestre di tempo per le visite o le pause.

EncodedPolyline

La rappresentazione polilinea codificata del percorso. Questo campo viene compilato solo se OptimizeToursRequest.populate_polylines è impostato su true.

Break

Soste programmate per il veicolo che esegue questo percorso. La sequenza breaks rappresenta intervalli di tempo, ognuno dei quali inizia al start_time corrispondente e dura duration secondi.

AggregatedMetrics

Metriche relative a durata, distanza e carico per questo percorso. I campi di AggregatedMetrics vengono sommati su tutti i ShipmentRoute.transitions o ShipmentRoute.visits, a seconda del contesto.

map<string, double>

Costo del percorso, suddiviso per campi di richiesta relativi al costo. Le chiavi sono percorsi proto, relativi all'input OptimizeToursRequest, ad esempio "model.shipments.pickups.cost", e i valori sono il costo totale generato dal campo del costo corrispondente, aggregato nell'intero percorso. In altre parole, costs["model.shipments.pickups.cost"] è la somma di tutti i costi di ritiro lungo il percorso. Tutti i costi definiti nel modello sono riportati in dettaglio qui, ad eccezione dei costi relativi a TransitionAttributes, che vengono riportati solo in modo aggregato a partire da gennaio 2022.

double

Costo totale del percorso. La somma di tutti i costi nella mappa dei costi.

Timestamp

Ora di inizio di un'interruzione.

Duration

Durata di una pausa.

string

Stringa che rappresenta i punti codificati del polilinea.

Duration

Durata del viaggio durante questa transizione.

double

Distanza percorsa durante la transizione.

bool

Quando il traffico viene richiesto tramite OptimizeToursRequest.consider_road_traffic e non è stato possibile recuperare le informazioni sul traffico per un Transition, questo valore booleano viene impostato su true. Potrebbe trattarsi di un problema temporaneo (un raro problema nei server del traffico in tempo reale) o permanente (nessun dato per questa località).

Duration

Somma delle durate dei ritardi applicati a questa transizione. Se presente, il ritardo inizia esattamente delay_duration secondi prima dell'evento successivo (fine della visita o del veicolo). Leggi i TransitionAttributes.delay.

Duration

Somma della durata delle interruzioni, se presenti, che si verificano durante questa transizione. I dettagli sull'ora di inizio e sulla durata di ogni pausa vengono memorizzati in ShipmentRoute.breaks.

Duration

Tempo di attesa durante questa transizione. La durata dell'attesa corrisponde al tempo di inattività e non include la pausa. Tieni inoltre presente che questo tempo di attesa può essere suddiviso in più intervalli non contigui.

Duration

Durata totale della transizione, fornita per praticità. È uguale a:

• prossima visita start_time (o vehicle_end_time se si tratta dell'ultima transizione) - start_time di questa transizione;
• if ShipmentRoute.has_traffic_infeasibilities is false, the following additionally holds: `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Ora di inizio di questa transizione.

EncodedPolyline

La rappresentazione polilinea codificata del percorso seguito durante la transizione. Questo campo viene compilato solo se populate_transition_polylines è impostato su true.

string

Solo output. Un token opaco che può essere passato all'SDK Navigation per ricostruire il percorso durante la navigazione e, in caso di deviazione, rispettare l'intenzione originale al momento della creazione del percorso. Tratta questo token come un blob opaco. Non confrontare il valore tra le richieste, in quanto potrebbe cambiare anche se il servizio restituisce lo stesso percorso esatto. Questo campo viene compilato solo se populate_transition_polylines è impostato su true.

map<string, VehicleLoad>

Carichi del veicolo durante questa transizione, per ogni tipo che compare in Vehicle.load_limits di questo veicolo o che ha Shipment.load_demands diverso da zero in alcune spedizioni eseguite su questo percorso.

I carichi durante la prima transizione sono i carichi iniziali del percorso del veicolo. Dopo ogni visita, i valori load_demands vengono aggiunti o sottratti per ottenere i carichi della transizione successiva, a seconda che la visita sia stata un ritiro o una consegna.

int64

La quantità di carico sul veicolo, per il tipo specificato. La unità di carico è in genere indicata dal tipo. Leggi i Transition.vehicle_loads.

int32

Indice del campo shipments nell'origine ShipmentModel.

bool

Se true, la visita corrisponde al ritiro di un Shipment. In caso contrario, corrisponde a un caricamento.

int32

Indice di VisitRequest nel campo Ritiro o Consegna del Shipment (vedi is_pickup).

Timestamp

Ora di inizio della visita. Tieni presente che il veicolo potrebbe arrivare prima di questa data e ora presso la sede della visita. Gli orari sono in linea con le ShipmentModel.

map<string, Load>

Domanda di carico delle visite totale come somma della spedizione e della richiesta di visita load_demands. I valori sono negativi se la visita è una pubblicazione. Le richieste vengono registrate per gli stessi tipi di Transition.loads (vedi questo campo).

Duration

Tempo aggiuntivo per i giri a vuoto dovuti alle spedizioni visitate sul percorso prima della visita e al potenziale tempo di attesa indotto dalle finestre temporali. Se la visita è una consegna, il percorso alternativo viene calcolato dalla visita di ritiro corrispondente ed è uguale a:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

In caso contrario, viene calcolato dal veicolo start_location ed è uguale a:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Copia del Shipment.label corrispondente, se specificato nel Shipment.

string

Copia del VisitRequest.label corrispondente, se specificato nel VisitRequest.

string

Elenco di tipi incompatibili. Due spedizioni con shipment_types diversi tra quelli elencati sono "incompatibili".

IncompatibilityMode

Modalità applicata all'incompatibilità.

string

Elenco dei tipi di spedizione alternativi richiesti dal dependent_shipment_types.

string

Tutte le spedizioni con un tipo nel campo dependent_shipment_types richiedono che venga visitata almeno una spedizione di tipo required_shipment_type_alternatives nello stesso percorso.

NOTA: non sono consentite catene di requisiti in cui un shipment_type dipende da sé stesso.

RequirementMode

Modalità applicata al requisito.

int32

L'indice corrisponde all'indice della spedizione nell'origine ShipmentModel.

string

Copia del Shipment.label corrispondente, se specificato nel Shipment.

Reason

Un elenco di motivi che spiegano perché la spedizione è stata ignorata. Vedi il commento sopra Reason. Se non riusciamo a capire il motivo per cui una spedizione è stata saltata, i motivi non verranno impostati.

Code

Fai riferimento ai commenti del codice.

string

Se il codice del motivo è DEMAND_EXCEEDS_VEHICLE_CAPACITY, indica un tipo di capacità superato.

int32

Se il motivo è correlato a un'incompatibilità tra spedizione e veicolo, questo campo fornisce l'indice di un veicolo pertinente.

Timestamp

L'ora di inizio dell'intervallo di tempo obbligatorio. Se non specificato, verrà impostato su ShipmentModel.global_start_time.

Timestamp

L'ora di fine dell'intervallo di tempo obbligatorio. Se non specificato, verrà impostato su ShipmentModel.global_end_time.

Timestamp

L'ora di inizio graduale della finestra temporale.

Timestamp

L'ora di fine flessibile dell'intervallo di tempo.

double

Un costo per ora aggiunto agli altri costi nel modello se l'evento si verifica prima di soft_start_time, calcolato come segue:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

Questo costo deve essere positivo e il campo può essere impostato solo se è stato impostato soft_start_time.

double

Un costo per ora aggiunto agli altri costi del modello se l'evento si verifica dopo soft_end_time, calcolato come segue:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

Questo costo deve essere positivo e il campo può essere impostato solo se è stato impostato soft_end_time.

string

Tag che definiscono l'insieme di transizioni (src->dst) a cui si applicano questi attributi.

Una visita o un inizio del viaggio dell'origine corrisponde se e solo se VisitRequest.tags o Vehicle.start_tags contiene src_tag o non contiene excluded_src_tag (a seconda di quale di questi due campi non è vuoto).

string

Leggi i src_tag. Esattamente uno di src_tag e excluded_src_tag deve essere diverso da vuoto.

string

Una visita alla destinazione o una fine del viaggio corrisponde se e solo se VisitRequest.tags o Vehicle.end_tags contiene dst_tag o non contiene excluded_dst_tag (a seconda di quale di questi due campi non è vuoto).

string

Leggi i dst_tag. Esattamente uno di dst_tag e excluded_dst_tag deve essere diverso da vuoto.

double

Specifica un costo per l'esecuzione di questa transizione. Si tratta della stessa unità di misura di tutti gli altri costi del modello e non deve essere negativo. Viene applicato a tutti gli altri costi esistenti.

double

Specifica un costo per chilometro applicato alla distanza percorsa durante l'esecuzione di questa transizione. Si somma a qualsiasi Vehicle.cost_per_kilometer specificato sui veicoli.

DistanceLimit

Specifica un limite alla distanza percorsa durante l'esecuzione di questa transizione.

A partire da giugno 2021, sono supportati solo i limiti flessibili.

Duration

Specifica un ritardo durante l'esecuzione di questa transizione.

Questo ritardo si verifica sempre dopo il completamento della visita di origine e prima dell'inizio della visita di destinazione.

string

Il nome visualizzato del veicolo definito dall'utente. Può contenere fino a 63 caratteri e può utilizzare caratteri UTF-8.

TravelMode

La modalità di viaggio che influisce sulle strade utilizzabili dal veicolo e sulla sua velocità. Vedi anche travel_duration_multiple.

RouteModifiers

Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi per il veicolo in questione.

LatLng

Posizione geografica in cui il veicolo parte prima di ritirare le spedizioni. Se non specificato, il veicolo si avvia al primo ritiro. Se il modello di spedizione ha matrici di durata e distanza, start_location non deve essere specificato.

Waypoint

Waypoint che rappresenta una posizione geografica in cui il veicolo parte prima di ritirare le spedizioni. Se non viene specificato né start_waypoint né start_location, il veicolo si avvia al primo ritiro. Se il modello di spedizione ha matrici di durata e distanza, start_waypoint non deve essere specificato.

LatLng

Posizione geografica in cui termina il viaggio del veicolo dopo aver completato l'ultima VisitRequest. Se non specificato, il ShipmentRoute del veicolo termina immediatamente al termine dell'ultimo VisitRequest. Se il modello di spedizione ha matrici di durata e distanza, end_location non deve essere specificato.

Waypoint

Waypoint che rappresenta una posizione geografica in cui il veicolo termina dopo aver completato l'ultima VisitRequest. Se non vengono specificati né end_waypoint né end_location, il ShipmentRoute del veicolo termina immediatamente al termine dell'ultimo VisitRequest. Se il modello di spedizione ha matrici di durata e distanza, end_waypoint non deve essere specificato.

string

Specifica i tag collegati all'inizio del percorso del veicolo.

Non sono consentite stringhe vuote o duplicate.

string

Specifica i tag collegati alla fine del percorso del veicolo.

Non sono consentite stringhe vuote o duplicate.

TimeWindow

Fasce orarie durante le quali il veicolo può partire dalla stazione di partenza. Devono rispettare i limiti di tempo globali (vedi campi ShipmentModel.global_*). Se non specificato, non ci sono limitazioni oltre a questi limiti di tempo globali.

Le finestre temporali appartenenti allo stesso campo ripetuto devono essere disgiunte, ovvero nessuna finestra temporale può sovrapporsi o essere adiacente a un'altra e devono essere in ordine cronologico.

cost_per_hour_after_soft_end_time e soft_end_time possono essere impostati solo se esiste una singola finestra temporale.

TimeWindow

Fasce orarie durante le quali il veicolo potrebbe arrivare alla sua destinazione finale. Devono rispettare i limiti di tempo globali (vedi campi ShipmentModel.global_*). Se non specificato, non ci sono limitazioni oltre a questi limiti di tempo globali.

Le finestre temporali appartenenti allo stesso campo ripetuto devono essere disgiunte, ovvero nessuna finestra temporale può sovrapporsi o essere adiacente a un'altra e devono essere in ordine cronologico.

cost_per_hour_after_soft_end_time e soft_end_time possono essere impostati solo se esiste una singola finestra temporale.

UnloadingPolicy

Criterio di scarico applicato al veicolo.

map<string, LoadLimit>

Capacità del veicolo (ad es. peso, volume, numero di pallet). Le chiavi nella mappa sono gli identificatori del tipo di caricamento, in linea con le chiavi del campo Shipment.load_demands. Se una determinata chiave non è presente in questa mappa, la capacità corrispondente è considerata illimitata.

double

Costi del veicolo: tutti i costi si sommano e devono essere nella stessa unità di Shipment.penalty_cost.

Costo per ora del percorso del veicolo. Questo costo viene applicato al tempo totale impiegato per il percorso e include il tempo di percorrenza, il tempo di attesa e il tempo di visita. L'utilizzo di cost_per_hour anziché solo cost_per_traveled_hour potrebbe comportare una latenza aggiuntiva.

double

Costo per ora di percorrenza del percorso del veicolo. Questo costo viene applicato solo al tempo di percorrenza del percorso (ovvero quello indicato in ShipmentRoute.transitions) ed esclude il tempo di attesa e il tempo di visita.

double

Costo per chilometro del percorso del veicolo. Questo costo si applica alla distanza indicata nel ShipmentRoute.transitions e non si applica a nessuna distanza percorsa implicitamente dal arrival_location al departure_location di un singolo VisitRequest.

double

Costo fisso applicato se questo veicolo viene utilizzato per gestire una spedizione.

bool

Questo campo si applica ai veicoli solo quando il loro percorso non serve spedizioni. Indica se in questo caso il veicolo deve essere considerato usato o meno.

Se true, il veicolo si sposta dalla posizione di partenza a quella di destinazione anche se non effettua consegne e vengono presi in considerazione i costi di tempo e distanza derivanti dal viaggio da inizio a fine.

In caso contrario, non si sposta dalla stazione di partenza a quella di arrivo e non sono programmati break_rule o ritardi (da TransitionAttributes) per questo veicolo. In questo caso, il ShipmentRoute del veicolo non contiene alcuna informazione, ad eccezione dell'indice e dell'etichetta del veicolo.

DurationLimit

Limite applicato alla durata totale del percorso del veicolo. In un determinato OptimizeToursResponse, la durata del percorso di un veicolo è la differenza tra vehicle_end_time e vehicle_start_time.

DurationLimit

Limite applicato alla durata del viaggio del percorso del veicolo. In un determinato OptimizeToursResponse, la durata del viaggio dell'itinerario è la somma di tutti i suoi transitions.travel_duration.

DistanceLimit

Limite applicato alla distanza totale del percorso del veicolo. In un determinato OptimizeToursResponse, la distanza del percorso è la somma di tutti i suoi transitions.travel_distance_meters.

map<string, Duration>

Specifica una mappa dalle stringhe visit_types alle durate. La durata è il tempo aggiuntivo di VisitRequest.duration da prendere in considerazione per le visite con il visit_types specificato. Questa durata della visita aggiuntiva comporta un costo se viene specificato cost_per_hour. Le chiavi (ad es. visit_types) non possono essere stringhe vuote.

Se una richiesta di visita ha più tipi, nella mappa verrà aggiunta una durata per ogni tipo.

BreakRule

Descrive la programmazione delle interruzioni da applicare a questo veicolo. Se è vuoto, non verranno pianificate interruzioni per questo veicolo.

string

Specifica un'etichetta per questo veicolo. Questa etichetta viene riportata nella risposta come vehicle_label del ShipmentRoute corrispondente.

bool

Se il valore è true, used_if_route_is_empty deve essere false e questo veicolo rimarrà inutilizzato.

Se una spedizione viene eseguita da un veicolo ignorato in injected_first_solution_routes, viene saltata nella prima soluzione, ma può essere eseguita nella risposta.

Se una spedizione viene eseguita da un veicolo ignorato in injected_solution_constraint e qualsiasi ritiro/consegna correlato è vincolato a rimanere sul veicolo (ovvero non è rilassato al livello RELAX_ALL_AFTER_THRESHOLD), viene saltato nella risposta. Se una spedizione ha un campo allowed_vehicle_indices non vuoto e tutti i veicoli consentiti vengono ignorati, viene saltata nella risposta.

double

Specifica un fattore moltiplicativo che può essere utilizzato per aumentare o diminuire i tempi di percorrenza di questo veicolo. Ad esempio, se imposti questo valore su 2,0, il veicolo è più lento e i tempi di percorrenza sono il doppio di quelli dei veicoli standard. Questo moltiplicatore non influisce sulle durate delle visite. Influisce sul costo se vengono specificati cost_per_hour o cost_per_traveled_hour. Deve essere compreso nell'intervallo [0,001, 1000,0]. Se non viene impostato, il veicolo è standard e questo moltiplicatore è considerato pari a 1, 0.

AVVERTENZA: i tempi di percorrenza verranno arrotondati al secondo più vicino dopo l'applicazione di questo moltiplicatore, ma prima di eseguire qualsiasi operazione numerica. Pertanto, un piccolo moltiplicatore potrebbe comportare una perdita di precisione.

Vedi anche extra_visit_duration_for_visit_type di seguito.

Duration

Un limite massimo che impone che la durata non superi max_duration.

Duration

Un limite flessibile che non applica un limite di durata massima, ma che, se violato, fa sì che il percorso comporti un costo. Questo costo si somma agli altri costi definiti nel modello, con la stessa unità di misura.

Se definito, soft_max_duration non deve essere un valore negativo. Se è definito anche max_duration, soft_max_duration deve essere inferiore a max_duration.

Duration

Un limite flessibile che non applica un limite di durata massima, ma che, se violato, fa sì che il percorso comporti un costo quadratico in base alla durata. Questo costo si somma agli altri costi definiti nel modello, con la stessa unità di misura.

Se definito, quadratic_soft_max_duration deve essere un valore non negativo. Se è definito anche max_duration, quadratic_soft_max_duration deve essere inferiore a max_duration e la differenza non deve essere superiore a un giorno:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Costo orario sostenuto se viene violata la soglia soft_max_duration. Il costo aggiuntivo è pari a 0 se la durata è inferiore alla soglia, altrimenti il costo dipende dalla durata come segue:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Il costo deve essere non negativo.

double

Costo per ora quadrata sostenuto se viene violata la soglia quadratic_soft_max_duration.

Il costo aggiuntivo è pari a 0 se la durata è inferiore alla soglia, altrimenti il costo dipende dalla durata come segue:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Il costo deve essere non negativo.

int64

Un limite flessibile del carico. Leggi i cost_per_unit_above_soft_max.

double

Se il carico supera soft_max_load lungo il percorso del veicolo, si applica la seguente penalità di costo (una sola volta per veicolo): (carico - soft_max_load) * cost_per_unit_above_soft_max. Tutti i costi si sommano e devono essere nella stessa unità di Shipment.penalty_cost.

Interval

L'intervallo di carico accettabile del veicolo all'inizio del percorso.

Interval

L'intervallo di carico accettabile del veicolo alla fine del percorso.

int64

La quantità massima di carico accettabile.

int64

Un carico minimo accettabile. Deve essere ≥ 0. Se sono specificati entrambi, min deve essere ≤ max.

int64

Un carico massimo accettabile. Deve essere ≥ 0. Se non specificato, il carico massimo non è limitato da questo messaggio. Se sono specificati entrambi, min deve essere ≤ max.

bool

Facoltativo. Indica che la posizione di questo waypoint è destinata a avere una preferenza per la fermata del veicolo su un determinato lato della strada. Quando imposti questo valore, il percorso passerà attraverso la località in modo che il veicolo possa fermarsi sul lato della strada verso cui è inclinata la località rispetto al centro della strada. Questa opzione non funziona per la modalità di viaggio "A PIEDI".

Location

Un punto specificato utilizzando le coordinate geografiche, inclusa un'intestazione facoltativa.

string

L'ID luogo PDI associato al waypoint.