Crea un messaggio di richiesta

Come descritto brevemente nella Panoramica dell'ottimizzazione dei percorsi, una richiesta di base è costituita da Modello, Spedizioni e Veicoli come entità obbligatorie:

• Il modello acquisisce impostazioni e vincoli per l'intera richiesta, inclusi Shipments e Vehicles.
• Le spedizioni rappresentano attività o spedizioni effettive che includono VisitRequest di ritiro e consegna. Le importazioni 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 vengono applicati a tutte le spedizioni e a tutti i veicoli, mentre i vincoli e le proprietà specificati per le spedizioni o i 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 soluzione migliore 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 e i token di route vengono restituiti o meno nella risposta.

Proprietà del modello

Alcune proprietà di uso comune del messaggio ShipmentModel (REST, gRPC) includono:

• globalStartTime rappresenta la prima ora di partenza dei percorsi per tutti i veicoli e le spedizioni. Nessun veicolo può iniziare le prime transizioni e spedizioni prima di questa data.
• globalEndTime indica l'ora di fine più recente dei percorsi di tutti i veicoli e delle spedizioni. Tutte le spedizioni e le transizioni assegnate devono essere completate prima di questa data.

Proprietà spedizione

Alcune proprietà di uso comune del messaggio Shipment (REST, gRPC) includono:

• pickups[] e deliveries[] indicano dove è possibile ritirare o consegnare una spedizione. Le proprietà pickups[] e deliveries[] utilizzano entrambi il messaggio VisitRequest (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ò trasportare contemporaneamente. Scopri di più sul carico in Carichi e limiti.
• penalty_cost indica il costo sostenuto se una spedizione viene saltata. Scopri di più sui costi in 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 posizione 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à della sua ultima spedizione assegnata.
• startTimeWindows[] indica quando un veicolo può iniziare il suo percorso. Questa proprietà è facoltativa.
• endTimeWindows[] indica quando un veicolo può iniziare e terminare il suo percorso. Entrambe le proprietà sono facoltative.
• loadLimits indica la capacità del veicolo disponibile per soddisfare le richieste di carico delle spedizioni. Scopri di più sulle richieste e sui limiti di carico in Richieste e limiti di caricamento.

Un esempio completo di richiesta in formato JSON è il seguente:

{
  "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 del percorso, è importante comprendere la differenza tra i due metodi:

Confronto tra OptimizeTours e BatchOptimizeTours