Modello di costo

L'obiettivo principale dell'API Route Optimization è trovare i percorsi con il costo più basso. In quanto tale, il modello di costo è il fattore principale per l'ottimizzazione dei percorsi.

Il modello di costo è un insieme di proprietà che specificano i costi globali, dei veicoli e delle spedizioni.

Le proprietà del modello di costo supportano i seguenti tipi di obiettivi di ottimizzazione:

• Assegnazioni e percorsi dei veicoli efficienti
• Tempi di ritiro e consegna convenienti
• Assegnazione della priorità alle spedizioni critiche

Struttura

Come mostrato nel diagramma, le proprietà del modello di costo sono strutturate come segue:

• Shipment contiene la proprietà penaltyCost.
• Vehicle contiene le seguenti proprietà:
  • fixedCost
  • costPerHour
  • costPerKilometer
  • costPerTraveledHour

Questo documento evidenzia solo i parametri essenziali del modello di costo. Consulta la documentazione di riferimento per l'insieme completo di parametri di costo.

Elenco di controllo di Essentials

Il seguente elenco di controllo descrive le conoscenze essenziali per evitare potenziali errori relativi ai costi. Questo elenco può aiutarti a convalidare la tua richiesta e a risolvere i problemi relativi alla risposta.

I costi sono necessari per l'ottimizzazione. Una richiesta senza costi farà sì che l'API restituisca percorsi senza senso con tempi di transito lunghi.

Devi specificare almeno uno tra costPerHour, costPerKilometer o costPerTraveledHour per veicolo.

Puoi utilizzare più proprietà di costo per richiesta per raggiungere obiettivi di ottimizzazione più sofisticati.

Le proprietà di costo non sono legate a una valuta specifica.

Sei tu a decidere il valore rappresentato da un'unità di costo e questo valore si applica a tutte le proprietà di costo nella richiesta.

Proprietà

La tabella seguente elenca e descrive le proprietà del modello di costo.

Genitore	Nome proprietà	Property type	Costo per	Descrizione della proprietà
Shipment	penaltyCost	numero	Spedizione saltata	Il costo sostenuto per saltare la spedizione. L'API salta una spedizione quando il costo per completarla supera il costo della penalità. L'impostazione penaltyCost dà la priorità alla consegna delle spedizioni con un costo più elevato. Se non imposti un penaltyCost per la spedizione, questa diventa obbligatoria. Se imposti esplicitamente un valore penaltyCost di una spedizione su zero, l'API salta sempre la spedizione, a meno che non sia richiesto da altri vincoli.
Vehicle	fixedCost	numero	Spedizione	Costo fisso applicato se questo veicolo viene utilizzato per gestire una spedizione.
	costPerHour	numero	Ora	Il costo di utilizzo di un veicolo all'ora, inclusi i tempi di transito, attesa, visita e pausa. Man mano che questo costo aumenta, l'ottimizzatore tenta di trovare percorsi più veloci che potrebbero non essere i più brevi. Questa proprietà può essere un costo per veicolo autonomo efficace grazie alla sua semplicità e completezza.
	costPerKilometer	numero	Chilometri	Il costo per chilometro percorso dal veicolo, che può rappresentare i costi del carburante o i costi di manutenzione del veicolo ammortizzati.
	costPerTraveledHour	numero	Ora	Il costo di utilizzo di un veicolo all'ora solo durante il transito, esclusi i tempi di attesa, visita e pausa. In questo modo, viene data la priorità ai percorsi più veloci rispetto a quelli più brevi.

Esempi

Questa sezione illustra tre tipi di esempi:

• Esempi di codice che illustrano la struttura delle proprietà del modello di costo.
• Uno scenario di esempio che mostra un modo per utilizzare le proprietà del modello di costo per raggiungere uno scopo commerciale.
• Un esempio di richiesta che include i valori impostati nello scenario di esempio.

Esempi di codice

Il seguente esempio di codice mostra la struttura delle proprietà del modello di costo in Shipment:

{
  "model": {
    "shipments": [ ...
      {
        "penaltyCost": PENALTY_COST
      }
    ],
    "vehicles": [ ...
    ]
  }
}

Il seguente esempio di codice mostra la struttura delle proprietà del modello di costo in Vehicle:

{
  "model": {
    "shipments": [ ...
    ],
    "vehicles": [ ...
      {
        "fixedCost": FIXED_COST,
        "costPerKilometer": KILOMETER_COST,
        "costPerHour": HOUR_COST,
        "costPerTraveledHour": TRAVELED_HOUR_COST
      }
    ]
  }
}

Scenario di esempio

Questa sezione descrive uno scenario in cui hai un'attività di asilo per cani. Stai ottimizzando un percorso per il furgone che utilizzi per andare a prendere i cani a casa. In questo scenario, vuoi che l'ottimizzatore tenga conto dei costi relativi al ritiro dei cani e alle operazioni del veicolo quando fornisce un percorso.

In questo esempio, un'unità di costo rappresenta 1 dollaro. Ciò significa che i valori delle proprietà del modello di costo nella richiesta sono i seguenti:

Proprietà	Valore	Scenario
penaltyCost	10	Rappresenta la penale che offri ai tuoi clienti per non aver ritirato il cane in un giorno programmato. Ogni volta che non ritiri il cane in un giorno programmato, il cliente riceve uno sconto di 40 $ sul totale del servizio.
fixedCost	30	Rappresenta il costo giornaliero dei pagamenti del prestito per il veicolo, ovvero 30 $ al giorno.
costPerKilometer	0,08	Rappresenta la quantità di benzina consumata dal veicolo per chilometro. Il tuo veicolo ha bisogno di 0, 04 galloni per chilometro per muoversi e il costo per gallone nella tua regione è di 2 dollari.
costPerHour	27	Rappresenta l'importo che paghi a un conducente per guidare il tuo veicolo. Paghi al conducente 27 $ l'ora.
costPerTraveledHour	2,5	Rappresenta l'importo che devi pagare per l'aria condizionata del veicolo all'ora per i cani durante il viaggio. Quando il veicolo è fermo, il conducente può aprire le porte posteriori e spegnere la climatizzazione.

In base ai parametri dei costi, l'ottimizzatore potrebbe fare dei compromessi che non sono ovvi per l'utente, ma che possono essere trovati tramite l'ottimizzazione.

Il seguente diagramma illustra un esempio in cui l'ottimizzatore potrebbe scegliere un percorso più lungo, ma più veloce, attraverso la linea tratteggiata verde per evitare il traffico sulla linea tratteggiata rossa.

In questo scenario, il bilancio dei costi dei due percorsi è il seguente:

• La linea tratteggiata verde ha un valore basso di costPerHour e costPerTraveledHour, poiché si tratta di un percorso veloce che evita il traffico, il che è più conveniente anche quando il valore di costPerKilometer è elevato.

• La linea tratteggiata rossa ha un costPerKilometer basso perché è un percorso diretto, ma costPerHour e costPerTraveledHour sono troppo alti a causa dei tempi di attesa nel traffico, il che lo rende il percorso più costoso.

Oltre a fornire percorsi convenienti, l'ottimizzatore fornisce anche una somma dei costi totali dei percorsi di consegna nelle proprietà della risposta.

Esempio di richiesta

L'esempio seguente mostra la struttura di una richiesta optimizeTours di base che incorpora i valori impostati nello scenario di esempio:

{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.8024,
              "longitude": -122.4058
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.759773,
              "longitude": -122.427063
            }
          }
        ]
        "penaltyCost": 40
      }
    ],
    "vehicles": [
      {
        "startLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "endLocation": {
          "latitude": 37.759773,
          "longitude": -122.427063
        },
        "fixedCost": 30,
        "costPerKilometer": 0.08,
        "costPerHour": 27,
        "costPerTraveledHour": 2.5
      }
    ]
  }
}

Proprietà della risposta

Il messaggio OptimizeToursResponse ha proprietà di costo che descrivono i costi sostenuti nel processo di completamento di un percorso:

• metrics.costs: il costo totale di tutti i percorsi suddiviso per campi di richiesta relativi ai costi.
• metrics.totalCost: il costo totale di tutti i percorsi sommati.