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 percorso o una soluzione.

Duration

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

Duration

Durata totale del ritardo per un percorso o una soluzione.

Duration

La durata totale della pausa per un percorso o una soluzione.

Duration

Durata totale della visita per un percorso o una soluzione.

Duration

La durata totale deve essere uguale alla somma di tutte le durate indicate sopra. 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 percorso o una soluzione.

map<string, VehicleLoad>

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

int32

Numero di spedizioni obbligatorie eseguite.

Sperimentale: il comportamento o l'esistenza di questo campo potrebbero cambiare in futuro.

double

La somma del Shipment.penalty_cost delle spedizioni eseguite.

Sperimentale: il comportamento o l'esistenza di questo campo potrebbero cambiare in futuro.

string

Obbligatorio. Progetto e posizione di destinazione per effettuare una chiamata.

Formato:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

AsyncModelConfig

Obbligatorio. Informazioni di input/output per ogni modello di acquisto, ad esempio percorsi dei file e formati dei 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. Vedi il messaggio BreakRequest.

FrequencyConstraint

Potrebbero essere applicati diversi FrequencyConstraint. Tutte le condizioni devono essere soddisfatte entro il giorno BreakRequest di questo BreakRule. Vedi FrequencyConstraint.

Timestamp

Obbligatorio. Limite inferiore (incluso) all'inizio della pausa.

Timestamp

Obbligatorio. Limite superiore (incluso) dell'inizio della pausa.

Duration

Obbligatorio. Durata minima della pausa. Deve essere positivo.

Duration

Obbligatorio. Durata minima della pausa per questo vincolo. Non negativo. Visualizza la descrizione di FrequencyConstraint.

Duration

Obbligatorio. Durata massima consentita di qualsiasi intervallo di tempo nel percorso che non include almeno parzialmente una pausa di duration >= min_break_duration. Deve essere positivo.

int64

Un limite rigido che vincola la distanza a un massimo di max_meters. Il limite non può essere negativo.

int64

Un limite soft che non impone un limite di distanza massimo, ma che, se violato, comporta un costo che si somma agli altri costi definiti nel modello, con la stessa unità.

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

double

Costo per chilometro sostenuto, in aumento 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 sostenuto se la distanza supera il limite di soft_max_meters. Il costo aggiuntivo è 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 itinerari potrebbero essere omessi dalla soluzione originale. I percorsi e le spedizioni saltate devono soddisfare i presupposti di validità di base elencati per injected_first_solution_routes.

SkippedShipment

Spedizioni saltate della soluzione da inserire. Alcuni potrebbero essere omessi dalla soluzione originale. Visualizza il campo routes.

ConstraintRelaxation

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

Relaxation

Tutti gli allentamenti del vincolo di visita che verranno applicati alle visite sui percorsi con veicoli in vehicle_indices.

int32

Specifica gli indici dei veicoli a cui si applica il vincolo di visita relaxations. Se è vuoto, viene considerato il valore predefinito e relaxations si applica a tutti i veicoli non specificati in altri constraint_relaxations. Può esserci al massimo un valore predefinito, ovvero è consentito al massimo un campo di rilassamento del vincolo 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 commento fields).

Level

Il livello di rilassamento del vincolo che si applica quando le condizioni in corrispondenza o dopo threshold_time E almeno threshold_visit_count sono soddisfatte.

Timestamp

L'ora a partire dalla quale può essere applicata la deroga level.

int32

Il numero di visite a partire dal quale può essere applicata la riduzione level. Se threshold_visit_count è 0 (o non impostato), level potrebbe essere applicato direttamente all'avvio del veicolo.

Se è route.visits_size() + 1, il level può essere applicato solo all'estremità del veicolo. Se è superiore a route.visits_size() + 1, level non viene applicato per questo percorso.

DataFormat

Obbligatorio. Il formato dei dati di input.

GcsSource

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

LatLng

Le coordinate geografiche del waypoint.

int32

L'orientamento della bussola associato alla direzione del flusso del traffico. Questo valore viene utilizzato per specificare il lato della strada da utilizzare per il ritiro e la riconsegna. I valori di direzione possono essere compresi tra 0 e 360, dove 0 specifica una direzione verso nord, 90 specifica una direzione verso est e così via.

string

Obbligatorio. Progetto o posizione di destinazione per effettuare una chiamata.

Formato:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

Duration

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

Per le richieste asincrone, il server genererà una soluzione (se possibile) prima che scada il 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 viene vincolato quando viene creata la prima soluzione. Le spedizioni non eseguite su un percorso vengono saltate implicitamente nella prima soluzione, ma potrebbero essere eseguite nelle soluzioni successive.

La soluzione deve soddisfare alcuni presupposti di validità di base:

• Per tutti i percorsi, vehicle_index deve essere compreso nell'intervallo e non essere duplicato.
• Per tutte le visite, shipment_index e visit_request_index devono essere compresi nell'intervallo.
• una spedizione può essere indicata in un solo percorso.
• il ritiro di una spedizione con ritiro e consegna deve essere eseguito prima della consegna.
• non è possibile eseguire più di un'alternativa di ritiro o di consegna di una spedizione.
• per tutti i percorsi, i tempi aumentano (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 suo vehicle_index è incluso in Shipment.allowed_vehicle_indices.

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

InjectedSolutionConstraint

Vincola l'algoritmo di ottimizzazione a 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 inserita non è fattibile, non viene necessariamente restituito un errore di convalida e potrebbe essere restituito un errore che indica l'impossibilità.

ShipmentRoute

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

A partire da novembre 2020, questo campo viene compilato solo con le polilinee dei percorsi non vuoti e richiede che populate_polylines sia true.

I campi route_polyline delle route trasmesse potrebbero non essere coerenti con la route 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. Le polilinee vengono comunque compilate 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 inserita con i veicoli nella richiesta; riutilizza la mappatura di ShipmentRoute.vehicle_index originale al nuovo ShipmentRoute.vehicle_index per aggiornare ConstraintRelaxation.vehicle_indices se non è vuoto, ma la mappatura deve essere univoca (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 inserita alle spedizioni nella richiesta;
• utilizza SkippedShipment.label anziché SkippedShipment.index per abbinare le spedizioni saltate nella soluzione inserita 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 dei veicoli 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 essere visualizzate 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 inserita (ad eccezione delle coppie di visite di ritiro/consegna, il cui shipment_label deve essere visualizzato due volte).

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

La rimozione di visite di route o di interi itinerari da una soluzione inserita può influire sui vincoli impliciti, il che può comportare modifiche alla soluzione, errori di convalida o impossibilità di trovare una soluzione.

NOTA: il chiamante 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 precedente che ha prodotto OptimizeToursResponse utilizzato nella soluzione inserita e la richiesta attuale che include la soluzione inserita. I controlli di unicità descritti sopra non sono sufficienti a garantire questo requisito.

bool

Prendi in considerazione la stima del traffico nel calcolo dei campi ShipmentRoute Transition.travel_duration, Visit.start_time e vehicle_end_time, nell'impostazione del campo ShipmentRoute.has_traffic_infeasibilities e nel calcolo del campo OptimizeToursResponse.total_cost.

bool

Se è true, le polilinee verranno inserite nelle risposte ShipmentRoute.

bool

Se true, le polilinee e i token di percorso verranno inseriti 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, il termine massimo è di soli 30 minuti. Tieni presente che le richieste di lunga durata hanno un rischio di interruzione significativamente maggiore (ma comunque basso).

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

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 suo valore deve essere almeno pari a 1,0 metri/secondo.

int32

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

ShipmentRoute

Percorsi calcolati per ogni veicolo; l'i-esimo percorso corrisponde all'i-esimo veicolo nel modello.

string

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

SkippedShipment

L'elenco di tutte le spedizioni saltate.

OptimizeToursValidationError

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

OptimizeToursRequest

In alcuni casi, modifichiamo la richiesta in arrivo prima di risolverla, ad esempio aggiungendo costi. Se solving_mode == TRANSFORM_AND_RETURN_REQUEST, la richiesta modificata viene restituita qui.

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request.

Metrics

Metriche di durata, distanza e utilizzo per questa soluzione.

AggregatedMetrics

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

int32

Numero di spedizioni obbligatorie saltate.

int32

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

Timestamp

L'orario di inizio più recente per un veicolo usato, calcolato come il minimo su tutti i veicoli usati di ShipmentRoute.vehicle_start_time.

Timestamp

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

map<string, double>

Costo della soluzione, suddiviso per campi della richiesta correlati ai costi. Le chiavi sono percorsi proto, relativi all'input OptimizeToursRequest, ad es. "model.shipments.pickups.cost", e i valori sono il costo totale generato dal campo di 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 riportati solo in modo aggregato a partire dal 01/01/2022.

double

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

string

Obbligatorio. Progetto o posizione di destinazione per effettuare una chiamata.

Formato:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

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

Uri

Obbligatorio. L'URI dell'oggetto Cloud Storage contenente OptimizeToursRequest.

Uri

Obbligatorio. L'URI dell'oggetto Cloud Storage che conterrà OptimizeToursResponse.

Uri

Facoltativo. L'URI dell'oggetto Cloud Storage contenente OptimizeToursResponse codificato come JSON o textproto. Se l'oggetto è stato codificato come JSON, l'estensione del nome dell'oggetto sarà .json. Se l'oggetto è stato codificato come textproto, l'estensione del nome dell'oggetto sarà .txtpb.

L'crc32_checksum della risorsa può essere utilizzato per verificare che i contenuti della risorsa non siano stati modificati.

int32

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

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

ERRORI MULTIPLI: quando sono presenti più errori, il processo di convalida tenta di restituirne diversi. Come un compilatore, questo è un processo imperfetto. Alcuni errori di convalida sono "gravi", il che significa che interrompono l'intera procedura di convalida. Questo è il caso, tra gli altri, degli errori display_name="UNSPECIFIED". Alcuni errori potrebbero causare l'omissione di altri errori durante la procedura di convalida.

STABILITÀ: code e display_name devono essere molto stabili. Tuttavia, nel tempo potrebbero essere visualizzati nuovi codici e nomi visualizzati, il che potrebbe far sì che una determinata richiesta (non valida) produca una coppia diversa (code, display_name) perché il nuovo errore ha nascosto quello precedente. Ad esempio, vedi "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 primo ritiro del veicolo n. 4 e della spedizione n. 2 può essere indicato 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 (quando code != "UNSPECIFIED").

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

string

Può contenere il valore o i valori dei campi. Questa opzione non è sempre disponibile. Non dovresti assolutamente fare affidamento su questa funzionalità e utilizzarla solo per il debug manuale del modello.

string

Nome del campo, ad esempio "veicoli".

FieldReference

Campo secondario nidificato in modo ricorsivo, se necessario.

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 precedenza ai percorsi che non includono strade a pedaggio. Valido solo per le modalità di trasporto motorizzate.

bool

Specifica se evitare le autostrade, se ragionevole. Verrà data la precedenza ai percorsi che non includono autostrade. Valido solo per le modalità di trasporto motorizzate.

bool

Specifica se evitare i traghetti, se ragionevole. Verrà data la preferenza ai percorsi che non prevedono viaggi in traghetto. Valido solo per le modalità di trasporto motorizzate.

bool

Facoltativo. Specifica se evitare la navigazione al chiuso, ove ragionevole. Verrà data la precedenza ai percorsi che non includono la navigazione indoor. 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

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

VisitRequest

Insieme di alternative di consegna associate alla spedizione. Se non specificato, il veicolo deve visitare solo una località corrispondente ai ritiri.

map<string, Load>

Requisiti 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 includendo anche le unità. Ad esempio: "weight_kg", "volume_gallons", "pallet_count" e così via. Se una determinata chiave non viene visualizzata nella mappa, il carico corrispondente viene considerato nullo.

int32

L'insieme dei veicoli che possono eseguire questa spedizione. Se è vuoto, tutti i veicoli possono eseguirlo. I veicoli sono indicati in base al loro indice nell'elenco vehicles di ShipmentModel.

double

Specifica il costo sostenuto quando questa spedizione viene consegnata da ciascun veicolo. Se specificato, deve avere UNO dei seguenti valori:

• 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 del numero di veicoli nel modello. L'elemento i-esimo 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 suo costo è pari a zero.

Duration

Specifica il tempo massimo di deviazione assoluto 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, sia t il tempo più breve necessario per andare dall'alternativa di ritiro selezionata direttamente all'alternativa di consegna selezionata. Quindi, l'impostazione pickup_to_delivery_absolute_detour_limit impone:

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

Se per la stessa spedizione vengono specificati limiti relativi e assoluti, viene utilizzato il limite più restrittivo per ogni possibile coppia di ritiro/consegna. A partire dal 10/2017, le deviazioni sono supportate solo quando le durate del viaggio 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 valore 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).

Differisce 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 nel shipment_label del ShipmentRoute.Visit corrispondente.

bool

Se il valore è true, ignora questa spedizione, ma non applicare un penalty_cost.

L'ignoramento di una spedizione genera un errore di convalida quando 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 dall'itinerario di esecuzione. precedence_rules che fanno riferimento a spedizioni ignorate verranno ignorati.

double

Se la spedizione non viene completata, questa sanzione 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 correlati ai costi nel modello e deve essere positivo.

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

double

Specifica il tempo di deviazione relativo 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, sia t il tempo più breve necessario per andare dall'alternativa di ritiro selezionata direttamente all'alternativa di consegna selezionata. Quindi, 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 per la stessa spedizione vengono specificati limiti relativi e assoluti, viene utilizzato il limite più restrittivo per ogni possibile coppia di ritiro/consegna. A partire dal 10/2017, le deviazioni sono supportate solo quando le durate del viaggio non dipendono dai veicoli.

int64

L'importo in base al quale varia il carico del veicolo che esegue la visita corrispondente. 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 esegue questa VisitRequest. Se il modello di spedizione ha matrici di distanza e durata, arrival_location non deve essere specificato.

Waypoint

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

LatLng

La posizione geografica da cui parte il veicolo dopo aver completato questo VisitRequest. Può essere omesso se è uguale a arrival_location. Se il modello di spedizione ha matrici di distanza e durata, departure_location non deve essere specificato.

Waypoint

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

string

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

TimeWindow

Finestre temporali che vincolano l'ora di arrivo a una visita. Tieni presente che un veicolo potrebbe partire al di fuori dell'intervallo di tempo di arrivo, ovvero l'orario di arrivo e 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ò eseguire questa visita in qualsiasi momento.

Le finestre temporali devono essere disgiunte, ovvero nessuna finestra temporale deve sovrapporsi a un'altra 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 è presente una singola finestra temporale.

Duration

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

double

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

map<string, Load>

Carica le richieste di questo visitatore. È 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. Può essere utilizzato per allocare il tempo aggiuntivo necessario a un veicolo per completare la 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 segnalata nella risposta come visit_label nel ShipmentRoute.Visit corrispondente.

bool

Specifica se in questa posizione devono essere evitate le inversioni a U nei percorsi in auto. L'evitamento delle inversioni a U è il risultato del massimo impegno e l'evitamento completo non è garantito. Questa è una funzionalità sperimentale e il comportamento è soggetto a modifiche.

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

Shipment

Insieme di spedizioni che devono essere eseguite nel modello.

Vehicle

Il set di veicoli che possono essere utilizzati per eseguire le visite.

Objective

L'insieme di obiettivi per questo modello, che trasformeremo in costi. Se non è vuoto, il modello di input deve essere senza costi. Per ottenere la richiesta modificata, utilizza solving_mode = TRANSFORM_AND_RETURN_REQUEST. Tieni presente che la richiesta non verrà risolta in questo caso. Consulta la documentazione corrispondente.

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request.

Timestamp

Ora di inizio e ora di fine globali del modello: non possono essere considerate valide ore al di fuori di questo intervallo.

L'intervallo di tempo del modello deve essere inferiore a un anno, ovvero global_end_time e global_start_time devono essere distanti tra loro non più di 31536000 secondi.

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

Timestamp

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

double

La "durata globale" del piano complessivo è la differenza tra l'ora di inizio effettiva più recente e l'ora di fine effettiva più recente di tutti i veicoli. Gli utenti possono assegnare un costo orario a questa quantità per cercare di ottimizzare il completamento del lavoro nel più breve tempo possibile, 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 geodetiche, 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 sedi: 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 sede B.

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 sedi: locA, locB e locC.
• 1 veicolo che inizia il percorso in locA e lo termina in locB, utilizzando la matrice "veloce".
• 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 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 il tag duration_distance_matrix_src_tags(j) ad 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, destinazione e matrice di un Vehicle potrebbero essere gli stessi; allo stesso modo, i tag di origine e destinazione di un VisitRequest potrebbero 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, destinazione e matrice di un Vehicle potrebbero essere gli stessi; allo stesso modo, i tag di origine e destinazione di un VisitRequest potrebbero 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

Set di shipment_types non compatibili (vedi ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Set di requisiti shipment_type (vedi ShipmentTypeRequirement).

PrecedenceRule

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

IMPORTANTE: l'utilizzo delle regole di precedenza limita le dimensioni del problema che può essere ottimizzato. Le richieste che utilizzano regole di precedenza che includono molte spedizioni potrebbero essere rifiutate.

int32

Limita il numero massimo di veicoli attivi. Un veicolo è attivo se il suo percorso esegue almeno una spedizione. Può essere utilizzato per limitare il numero di percorsi nel caso in cui ci siano meno autisti che veicoli e che il parco veicoli sia eterogeneo. L'ottimizzazione selezionerà quindi il miglior sottoinsieme 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 avvio del veicolo deve corrispondere esattamente a una matrice, ovvero esattamente uno dei suoi campi start_tags deve corrispondere al campo vehicle_start_tag di una matrice (e solo di 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 tanti elementi quanti sono i durations.

Type

Il tipo di obiettivo.

double

Il peso relativo di questo obiettivo rispetto agli altri. Può essere qualsiasi numero non negativo; la somma dei pesi non deve essere pari a 1. I pesi hanno valore predefinito 1.0.

bool

Indica se il primo evento è una consegna.

bool

Indica se il "secondo" evento è una consegna.

Duration

L'offset tra il "primo" e il "secondo" evento. Può essere negativo.

int32

Indice di spedizione del primo evento. Questo campo deve essere specificato.

int32

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

int32

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

string

Etichetta del veicolo che esegue questa route, uguale a ShipmentModel.vehicles(vehicle_index).label, se specificata.

Timestamp

Ora in cui il veicolo inizia il suo percorso.

Timestamp

Ora in cui il veicolo termina il percorso.

Visit

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

Transition

Elenco ordinato delle transizioni per l'itinerario.

bool

Quando OptimizeToursRequest.consider_road_traffic è impostato su true, questo campo indica che le incoerenze nei tempi del percorso vengono previste utilizzando le stime della durata del viaggio basate sul traffico. Potrebbe non esserci tempo sufficiente per completare il viaggio con traffico aggiustato, i ritardi e le pause tra le visite, prima della prima visita o dopo l'ultima visita, soddisfacendo comunque le finestre temporali di visita e del veicolo. 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) dovuto al traffico. Inoltre, una pausa potrebbe essere forzata a sovrapporsi a una visita a causa di un aumento delle stime del tempo di viaggio e delle limitazioni delle finestre temporali di visita o pausa.

EncodedPolyline

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

Break

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

AggregatedMetrics

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

VehicleFullness

Campo VehicleFullness per calcolare quanto le metriche con limite si avvicinano ai rispettivi limiti del veicolo. I suoi campi sono i rapporti tra un campo metrico con limite (ad es. AggregatedMetrics.travel_distance_meters) e il limite del veicolo correlato (ad es. Vehicle.route_distance_limit).

Sperimentale: il comportamento o l'esistenza di questo campo potrebbero cambiare in futuro.

map<string, double>

Costo dell'itinerario, suddiviso per campi della richiesta correlati al costo. Le chiavi sono i percorsi proto, relativi all'input OptimizeToursRequest, ad esempio "model.shipments.pickups.cost", e i valori sono il costo totale generato dal campo di costo corrispondente, aggregato sull'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 dal 01/01/2022.

double

Costo totale dell'itinerario. La somma di tutti i costi nella mappa dei costi.

Timestamp

Ora di inizio di una pausa.

Duration

Durata di una pausa.

string

Stringa che rappresenta i punti codificati della 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 le informazioni sul traffico non possono essere recuperate per un Transition, questo valore booleano è impostato su true. Potrebbe trattarsi di un problema temporaneo (un raro inconveniente nei server del traffico in tempo reale) o permanente (nessun dato per questa località).

Duration

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

Duration

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

Duration

Tempo trascorso in attesa durante questa transizione. La durata dell'attesa corrisponde al tempo di inattività e non include il tempo di pausa. Tieni inoltre presente che questo tempo di attesa potrebbe essere suddiviso in diversi intervalli non contigui.

Duration

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

• visita successiva start_time (o vehicle_end_time se si tratta dell'ultima transizione) - start_time di questa transizione;
• se ShipmentRoute.has_traffic_infeasibilities è false, vale anche quanto segue: `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Ora di inizio di questa transizione.

EncodedPolyline

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

string

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

map<string, VehicleLoad>

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

I carichi durante la prima transizione sono i carichi iniziali dell'itinerario del veicolo. Poi, dopo ogni visita, i load_demands della visita 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. L'unità di carico è in genere indicata dal tipo. Leggi i Transition.vehicle_loads.

int32

Indice del campo shipments nell'origine ShipmentModel.

bool

Se il valore è true, la visita corrisponde al ritiro di un Shipment. In caso contrario, corrisponde a una consegna.

int32

Indice di VisitRequest nel campo del ritiro o della consegna di Shipment (vedi is_pickup).

Timestamp

L'ora in cui inizia la visita. Tieni presente che il veicolo potrebbe arrivare prima di questo orario nella posizione della visita. Gli orari sono conformi al ShipmentModel.

map<string, Load>

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

Duration

Tempo di deviazione aggiuntivo dovuto alle spedizioni visitate sul percorso prima della visita e al potenziale tempo di attesa indotto dalle finestre temporali. Se la visita è una consegna, la deviazione viene calcolata 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.

int32

Un token opaco che rappresenta le informazioni su un luogo visitato.

Questo campo può essere compilato nelle visite degli itinerari dei risultati quando VisitRequest.avoid_u_turns è stato impostato su true per questa visita o se ShipmentModel.avoid_u_turns è stato impostato su true nella richiesta OptimizeToursRequest.

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request.

string

Elenco dei 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 da dependent_shipment_types.

string

Tutte le spedizioni con un tipo nel campo dependent_shipment_types richiedono che almeno una spedizione di tipo required_shipment_type_alternatives venga visitata sullo 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 precedente Reason. Se non riusciamo a capire perché una spedizione è stata saltata, i motivi non verranno impostati.

double

Si tratta di una copia del Shipment.penalty_cost, inclusa qui per facilitare la visualizzazione della gravità di una spedizione saltata.

Sperimentale: il comportamento o l'esistenza di questo campo potrebbero cambiare in futuro.

double

Rapporto stimato di veicoli che non possono eseguire questa spedizione per almeno uno dei motivi riportati di seguito. Nota: questo campo viene compilato solo quando i motivi riguardano un veicolo.

Sperimentale: il comportamento o l'esistenza di questo campo potrebbero cambiare in futuro.

Code

Fai riferimento ai commenti del codice.

int32

Come example_vehicle_index, tranne per il fatto che forniamo l'elenco di più veicoli identificati. Questo elenco non è necessariamente esaustivo. Questo campo viene compilato solo se [fill_example_vehicle_indices_in_skipped_reasons][] è true.

Sperimentale: il comportamento o l'esistenza di questo campo potrebbero cambiare in futuro.

string

Se il codice motivo è DEMAND_EXCEEDS_VEHICLE_CAPACITY, i documenti indicano 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 della finestra temporale rigida. Se non specificato, il valore predefinito è ShipmentModel.global_start_time.

Timestamp

L'ora di fine della finestra temporale rigida. Se non specificato, il valore predefinito è ShipmentModel.global_end_time.

Timestamp

L'ora di inizio soft dell'intervallo di tempo.

Timestamp

L'ora di fine flessibile della finestra temporale.

double

Un costo orario aggiunto ad altri costi nel modello se l'evento si verifica prima di soft_start_time, calcolato come:

   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 orario aggiunto agli altri costi del modello se l'evento si verifica dopo le ore soft_end_time, calcolato come:

   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 all'origine o l'avvio del veicolo corrisponde se il relativo 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 tra src_tag e excluded_src_tag deve essere non vuoto.

string

Una visita a una destinazione o un viaggio termina se il relativo 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 tra dst_tag e excluded_dst_tag deve essere non vuoto.

double

Specifica un costo per l'esecuzione di questa transizione. Questa unità è la stessa di tutti gli altri costi nel modello e non deve essere negativa. Viene applicata in aggiunta a tutti gli altri costi esistenti.

double

Specifica un costo per chilometro applicato alla distanza percorsa durante l'esecuzione di questa transizione. Si aggiunge 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 soft.

Duration

Specifica un ritardo che si verifica durante l'esecuzione di questa transizione.

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

string

L'URI della risorsa. La risorsa potrebbe non esistere ancora.

I contenuti della risorsa sono codificati come JSON o textproto. Sono supportate solo le risorse Google Cloud Storage. Se la risorsa è codificata come JSON, il nome della risorsa deve avere il suffisso .json. Se la risorsa è codificata come textproto, il nome della risorsa deve avere il suffisso .txtpb. Ad esempio, un URI Google Cloud Storage a un file codificato in formato JSON potrebbe essere simile a: gs://bucket/path/input/object.json.

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

LatLng

Posizione geografica in cui il veicolo inizia il percorso prima di ritirare le spedizioni. Se non specificato, il veicolo inizia dal primo ritiro. Se il modello di spedizione contiene matrici di durata e distanza, start_location non deve essere specificato.

Waypoint

Waypoint che rappresenta una posizione geografica in cui il veicolo inizia il percorso prima di ritirare le spedizioni. Se non vengono specificati né start_waypoint né start_location, il veicolo inizia dal primo ritiro. Se il modello di spedizione contiene matrici di durata e distanza, start_waypoint non deve essere specificato.

LatLng

Posizione geografica in cui si trova il veicolo al termine dell'ultimo VisitRequest. Se non specificato, il ShipmentRoute del veicolo termina immediatamente al termine dell'ultimo VisitRequest. Se il modello di spedizione contiene 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'ultimo 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 contiene matrici di durata e distanza, end_waypoint non deve essere specificato.

string

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

Non sono consentite stringhe vuote o duplicate.

string

Specifica i tag allegati alla fine del percorso del veicolo.

Non sono consentite stringhe vuote o duplicate.

TimeWindow

Intervalli di tempo durante i quali il veicolo può partire dalla posizione iniziale. Devono rispettare i limiti di tempo globali (vedi i campi ShipmentModel.global_*). Se non specificato, non ci sono limitazioni oltre a quelle dei 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 è presente una singola finestra temporale.

TimeWindow

Intervalli di tempo durante i quali il veicolo potrebbe arrivare alla destinazione finale. Devono rispettare i limiti di tempo globali (vedi i campi ShipmentModel.global_*). Se non specificato, non ci sono limitazioni oltre a quelle dei 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 è presente una singola finestra temporale.

UnloadingPolicy

Policy di scarico applicata al veicolo.

map<string, LoadLimit>

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

double

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

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

double

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

double

Costo per chilometro dell'itinerario del veicolo. Questo costo viene applicato alla distanza indicata in ShipmentRoute.transitions e non si applica a nessuna distanza percorsa implicitamente da arrival_location a departure_location di un singolo VisitRequest.

double

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

bool

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

Se è true, il veicolo va dalla posizione iniziale a quella finale anche se non serve spedizioni e vengono presi in considerazione i costi di tempo e distanza derivanti dal viaggio dalla posizione iniziale a quella finale.

In caso contrario, non si sposta dalla posizione di partenza a quella di arrivo e non sono previsti break_rule o ritardi (a partire da TransitionAttributes) per questo veicolo. In questo caso, ShipmentRoute del veicolo non contiene informazioni, 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 il suo vehicle_end_time e il suo 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 a VisitRequest.duration da dedicare alle visite con il visit_types specificato. Questa durata aggiuntiva della visita comporta un costo se è specificato cost_per_hour. Le chiavi (ad es. visit_types) non possono essere stringhe vuote.

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

BreakRule

Descrive il programma delle pause da applicare a questo veicolo. Se è vuoto, non verranno programmate pause per questo veicolo.

string

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

bool

Se è 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 ignorata 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 ignorato nella risposta. Se una spedizione ha un campo allowed_vehicle_indices non vuoto e tutti i veicoli consentiti vengono ignorati, la spedizione viene ignorata 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, significa che questo veicolo è più lento e ha tempi di percorrenza doppi rispetto a quelli dei veicoli standard. Questo moltiplicatore non influisce sulla durata delle visite. Influisce sui costi se vengono specificati cost_per_hour o cost_per_traveled_hour. Deve essere compreso nell'intervallo [0,001, 1000,0]. Se non è impostato, il veicolo è standard e questo multiplo è considerato 1.0.

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

Vedi anche extra_visit_duration_for_visit_type di seguito.

Duration

Un limite rigido che vincola la durata a un massimo di max_duration.

Duration

Un limite soft che non impone un limite di durata massima, ma che, se violato, comporta un costo per l'itinerario. Questo costo si somma agli altri costi definiti nel modello, con la stessa unità.

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

Duration

Un limite soft che non impone 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à.

Se definito, quadratic_soft_max_duration non deve essere un valore 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 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 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 (solo una volta per veicolo): (carico - soft_max_load) * cost_per_unit_above_soft_max. Tutti i costi si sommano e devono essere espressi nella stessa unità di misura di Shipment.penalty_cost. I limiti soft possono essere definiti solo per i tipi che si applicano solo ai ritiri o solo alle consegne in tutto il modello.

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

Il carico massimo accettabile.

LoadCost

Costo dello spostamento di un'unità di carico per un chilometro per questo veicolo. Può essere utilizzato come proxy per il consumo di carburante: se il carico è un peso (in newton), allora carico*chilometro ha la dimensione di un'energia.

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

LoadCost

Costo del viaggio con un'unità di carico durante un'ora per questo veicolo.

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request.

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.

int64

Quantità di carico al di sopra della quale il costo di spostamento di un'unità di carico cambia da cost_per_unit_below_threshold a cost_per_unit_above_threshold. Deve essere >= 0.

double

Costo dello spostamento di un'unità di carico, per ogni unità compresa tra 0 e la soglia. Deve essere un valore finito e maggiore o uguale a 0.

double

Costo dello spostamento di un'unità di carico, per ogni unità superiore alla soglia. Nel caso speciale in cui la soglia è pari a 0, si tratta di un costo fisso per unità. Deve essere un valore finito e maggiore o uguale a 0.

double

Il valore massimo di tutti gli altri campi di questo messaggio.

double

Il rapporto tra AggregatedMetrics.travel_distance_meters e Vehicle.route_distance_limit. Se Vehicle.route_distance_limit non è impostato, questo campo non verrà impostato.

double

Il rapporto tra [AggregatedMetrics.travel_duration_seconds][] e Vehicle.travel_duration_limit. Se Vehicle.travel_duration_limit non è impostato, questo campo non verrà impostato.

double

Il rapporto tra [AggregatedMetrics.total_duration_seconds][] e Vehicle.route_duration_limit. Se Vehicle.route_duration_limit non è impostato, questo campo non verrà impostato.

double

Il rapporto massimo tra tutti i tipi di [AggregatedMetrics.max_load][] e i rispettivi Vehicle.load_limits. Se tutti i campi Vehicle.load_limits non sono impostati, questo campo non verrà impostato.

double

Il rapporto (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) per un determinato veicolo. Se il denominatore non è presente, viene utilizzato (ShipmentModel.global_end_time - ShipmentModel.global_start_time).

bool

Facoltativo. Indica che la posizione di questa tappa deve avere una preferenza per il veicolo per fermarsi su un lato particolare della strada. Quando imposti questo valore, il percorso passerà per la posizione in modo che il veicolo possa fermarsi sul lato della strada verso cui la posizione è orientata dal centro della strada. Questa opzione non funziona per la modalità di viaggio "A PIEDI".

bool

Indica che la tappa è destinata ai veicoli per fermarsi, con l'intenzione di prendere o lasciare qualcuno. Questa opzione funziona solo per la modalità di viaggio "DRIVING" e quando "location_type" è "location".

Sperimentale: il comportamento o l'esistenza di questo campo potrebbero cambiare in futuro.

Location

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

string

L'ID luogo POI associato al waypoint.

Quando utilizzi un ID luogo per specificare la posizione di arrivo o partenza di una VisitRequest, utilizza un ID luogo sufficientemente specifico per determinare una posizione LatLng per la navigazione verso il luogo. Ad esempio, un ID luogo che rappresenta un edificio è adatto, ma un ID luogo che rappresenta una strada è sconsigliato.