OptimizeToursResponse

Risposta dopo aver risolto un problema di ottimizzazione del tour contenente i percorsi seguiti da ciascun veicolo, le spedizioni che sono state saltate e il costo complessivo della soluzione.

Rappresentazione JSON
{
  "routes": [
    {
      object (ShipmentRoute)
    }
  ],
  "requestLabel": string,
  "skippedShipments": [
    {
      object (SkippedShipment)
    }
  ],
  "validationErrors": [
    {
      object (OptimizeToursValidationError)
    }
  ],
  "metrics": {
    object (Metrics)
  }
}
Campi
routes[]

object (ShipmentRoute)

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

requestLabel

string

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

skippedShipments[]

object (SkippedShipment)

L'elenco di tutte le spedizioni saltate.

validationErrors[]

object (OptimizeToursValidationError)

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

metrics

object (Metrics)

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

OptimizeToursValidationError

Descrive un errore o un avviso rilevato durante la convalida di un OptimizeToursRequest.

Rappresentazione JSON
{
  "code": integer,
  "displayName": string,
  "fields": [
    {
      object (FieldReference)
    }
  ],
  "errorMessage": string,
  "offendingValues": string
}
Campi
code

integer

Un errore di convalida è definito dalla coppia (code, displayName) 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 saranno "irreversibili", ovvero interrompono l'intero processo di convalida. Questo è il caso, tra gli altri, di displayName="UNSPECIFIED" errori. Alcuni errori possono causare l'esclusione di altri dalla procedura di convalida.

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

displayName

string

Il nome visualizzato dell'errore.

fields[]

object (FieldReference)

Un contesto di errore può includere 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 nel seguente modo:

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

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

errorMessage

string

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

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

offendingValues

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.

FieldReference

Specifica un contesto per l'errore di convalida. Un FieldReference fa sempre riferimento a un determinato campo in questo file e segue la stessa struttura gerarchica. Ad esempio, possiamo specificare l'elemento n. 2 di startTimeWindows del veicolo n. 5 utilizzando:

name: "vehicles" index: 5 subField { name: "endTimeWindows" index: 2 }

Tuttavia, ometteremo le entità di primo livello come OptimizeToursRequest o ShipmentModel per evitare di appesantire il messaggio.

Rappresentazione JSON
{
  "name": string,
  "subField": {
    object (FieldReference)
  },

  // Union field index_or_key can be only one of the following:
  "index": integer,
  "key": string
  // End of list of possible types for union field index_or_key.
}
Campi
name

string

Nome del campo, ad esempio "vehicles".

subField

object (FieldReference)

Se necessario, sottocampo nidificato in modo ricorsivo.

Campo unione index_or_key.

index_or_key può essere solo uno dei seguenti:

index

integer

Indice del campo se ripetuto.

key

string

Chiave se il campo è una mappa.

Metriche

Metriche complessive, aggregate per tutti i route.

Rappresentazione JSON
{
  "aggregatedRouteMetrics": {
    object (AggregatedMetrics)
  },
  "skippedMandatoryShipmentCount": integer,
  "usedVehicleCount": integer,
  "earliestVehicleStartTime": string,
  "latestVehicleEndTime": string,
  "costs": {
    string: number,
    ...
  },
  "totalCost": number
}
Campi
aggregatedRouteMetrics

object (AggregatedMetrics)

Dati aggregati sulle route. Ogni metrica indica la somma (o il valore massimo per i caricamenti) di tutti i campi ShipmentRoute.metrics con lo stesso nome.

skippedMandatoryShipmentCount

integer

Numero di importazioni obbligatorie saltate.

usedVehicleCount

integer

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

earliestVehicleStartTime

string (Timestamp format)

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

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

latestVehicleEndTime

string (Timestamp format)

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

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

costs

map (key: string, value: number)

Costo della soluzione, suddiviso in base ai campi delle richieste relativi al costo. Le chiavi sono percorsi di protocollo, rispetto all' valore OptimizeToursRequest di input, ad es. "model.shipments.pickups.cost", e i valori sono il costo totale generato dal campo di costo corrispondente, aggregato per l'intera soluzione. In altre parole, costi ["model.shipments.pickups.cost"] è la somma di tutti i costi di ritiro rispetto alla soluzione. Tutti i costi definiti nel modello sono riportati in dettaglio qui, ad eccezione dei costi relativi a TransitionAttributes che sono riportati solo in modo aggregato a partire dal 2022/01.

totalCost

number

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