Come descritto brevemente in Panoramica dell'ottimizzazione del percorso, una richiesta di base comprende Modello, Spedizioni e Veicoli come entità obbligatorie:
- Il modello acquisisce impostazioni e vincoli per l'intera richiesta, inclusi
Shipments
eVehicles
. - Le spedizioni rappresentano attività o spedizioni effettive che includono i
VisitRequest
di ritiro e consegna. Le spedizioni hanno impostazioni e vincoli locali. - I veicoli rappresentano veicoli, conducenti o personale. I veicoli hanno anche impostazioni e vincoli locali.
Le proprietà di ogni entità descrivono parte di un problema di ottimizzazione a un determinato livello di granularità. I vincoli a livello di modello si applicano a tutte le spedizioni e a tutti i veicoli, mentre i vincoli e le proprietà specificati sulle spedizioni o sui veicoli sono specifici di una singola spedizione o di un singolo veicolo.
Per la documentazione completa su ciascun tipo di messaggio, consulta la documentazione di riferimento per i messaggi ShipmentModel
(REST, gRPC), Shipment
(REST, gRPC) e Vehicle
(REST, gRPC).
OptimizeToursRequest
strutture
Ecco alcune proprietà di uso comune del messaggio OptimizeToursRequest
di primo livello
(REST, gRPC):
searchMode
indica se restituire la prima soluzione che soddisfa i vincoli specificati o trovare la migliore soluzione possibile entro una scadenza impostata.considerRoadTraffic
determina se il traffico in tempo reale viene utilizzato o meno per il routing e la stima dell'orario di arrivo stimato.populateTransitionPolylines
determina se le polilinee di route vengono restituite nella risposta.
Proprietà del modello
Alcune proprietà di uso comune del messaggio ShipmentModel
(REST,
gRPC) includono:
globalStartTime
rappresenta la prima ora di inizio dei percorsi per tutti i veicoli e le spedizioni. Nessun veicolo può iniziare le prime transizioni e spedizioni prima di questa data.globalEndTime
rappresenta l'ora di fine più recente dei percorsi per tutti i veicoli e le spedizioni. Tutte le spedizioni e le transizioni assegnate devono essere completate prima di questa data.
Proprietà della spedizione
Alcune proprietà di uso comune del messaggio Shipment
(REST, gRPC)
includono:
pickups[]
edeliveries[]
indicano il luogo in cui una spedizione può essere ritirata o consegnata. Le proprietàpickups[]
edeliveries[]
utilizzano entrambi il messaggioVisitRequest
(REST, gRPC).loadDemands
rappresenta il carico necessario a un veicolo per completare una spedizione. La proprietàload_limits
(REST, gRPC) corrispondente dei veicoli rappresenta il carico massimo che un veicolo può sostenere contemporaneamente. Scopri di più sul caricamento in Carica richieste e limiti.penalty_cost
rappresenta il costo sostenuto nel caso in cui una spedizione venga saltata. Per saperne di più sui costi, consulta Parametri del modello di costo.
Proprietà dei veicoli
Alcune proprietà di uso comune del messaggio Vehicle
(REST, gRPC)
includono:
startLocation
rappresenta il punto in cui un veicolo deve iniziare il percorso. Questa proprietà è facoltativa. Se non specificato, il percorso del veicolo inizia dalla località della prima spedizione assegnata.endLocation
rappresenta il punto in cui un veicolo deve terminare il proprio percorso. Questa proprietà è facoltativa. Se non specificato, il percorso del veicolo termina nella località dell'ultima spedizione assegnata.startTimeWindows[]
indica quando un veicolo può iniziare il percorso. Questa proprietà è facoltativa.endTimeWindows[]
indica quando un veicolo può iniziare e terminare il percorso. Entrambe le proprietà sono facoltative.- I
loadLimits
rappresentano la capacità del veicolo disponibile per soddisfare le esigenze di carico delle spedizioni. Scopri di più sulle richieste e sui limiti di carico in Richieste e limiti di caricamento.
Una richiesta di esempio completa in formato JSON ha il seguente aspetto:
{
"model": {
"shipments": [
{
"pickups": [
{
"arrivalLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
}
}
],
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.79581,
"longitude": -122.4218856
}
}
]
}
],
"vehicles": [
{
"startLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"endLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"costPerKilometer": 1.0
}
],
"globalStartTime": "2024-02-13T00:00:00.000Z",
"globalEndTime": "2024-02-14T06:00:00.000Z"
}
}
OptimizeTours
e BatchOptimizeTours
utilizzano entrambi messaggi di richiesta
come nell'esempio sopra, ma in modi diversi. Prima di effettuare una richiesta di ottimizzazione della route, è importante comprendere la differenza tra i due metodi: