- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
Invia un oggetto OptimizeToursRequest
contenente un ShipmentModel
e restituisce un OptimizeToursResponse
contenente ShipmentRoute
, che sono un insieme di percorsi che devono essere eseguiti dai veicoli riducendo al minimo il costo complessivo.
Un modello ShipmentModel
è costituito principalmente da Shipment
da eseguire e da Vehicle
da utilizzare per trasportare gli Shipment
. I ShipmentRoute
assegnano Shipment
ai Vehicle
. Più precisamente, assegnano una serie di Visit
a ciascun veicolo, dove un Visit
corrisponde a un VisitRequest
, ovvero un ritiro o una consegna a domicilio di un Shipment
.
L'obiettivo è assegnare un valore di ShipmentRoute
a Vehicle
che riduca al minimo il costo totale se il costo ha molti componenti definiti nel ShipmentModel
.
Richiesta HTTP
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:optimizeTours
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
obbligatorio. Scegli come target un progetto o una località per effettuare una chiamata. Formato: * Se non viene specificata alcuna località, viene scelta automaticamente una regione. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "timeout": string, "model": { object ( |
Campi | |
---|---|
timeout |
Se questo timeout è impostato, il server restituisce una risposta prima che sia trascorso il periodo di timeout o prima che venga raggiunta la scadenza del server per le richieste sincrone, a seconda dell'evento che si verifica per primo. Per le richieste asincrone, il server genera una soluzione (se possibile) prima che il timeout sia trascorso. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
model |
Modello di spedizione da risolvere. |
solvingMode |
Per impostazione predefinita, la modalità di risoluzione è |
searchMode |
Modalità di ricerca utilizzata per risolvere la richiesta. |
injectedFirstSolutionRoutes[] |
Aiuta l'algoritmo di ottimizzazione a trovare una prima soluzione simile a una precedente. Il modello è vincolato quando viene creata la prima soluzione. Eventuali spedizioni non eseguite su un itinerario vengono implicitamente ignorate nella prima soluzione, ma possono essere eseguite in soluzioni successive. La soluzione deve soddisfare alcune ipotesi di base sulla validità:
Se la soluzione inserita non è fattibile, non viene necessariamente restituito un errore di convalida, ma potrebbe essere restituito un errore che indica l'infattibilità. |
injectedSolutionConstraint |
Vincola l'algoritmo di ottimizzazione per trovare una soluzione finale simile a una soluzione precedente. Ad esempio, può essere utilizzato per bloccare parti di route che sono già state completate o che devono essere completate ma che non devono essere modificate. Se la soluzione inserita non è fattibile, non viene necessariamente restituito un errore di convalida, ma potrebbe essere restituito un errore che indica l'infattibilità. |
refreshDetailsRoutes[] |
Se il campo non è vuoto, i percorsi specificati verranno aggiornati, senza modificare la sequenza sottostante di visite o tempi di percorrenza: verranno aggiornati solo gli altri dettagli. Questa operazione non risolve il modello. A partire dal 2020/11, questo metodo compila solo le polilinee delle route non vuote e richiede che I campi Questo campo non deve essere utilizzato insieme a
|
interpretInjectedSolutionsUsingLabels |
Se vero:
Questa interpretazione si applica ai campi Se il valore è true, le etichette delle seguenti categorie devono apparire al massimo una volta nella categoria:
Se un La rimozione di visite al percorso o di interi percorsi da una soluzione inserita può avere un effetto sui vincoli impliciti, che possono portare a cambiamenti nella soluzione, errori di convalida o fattibilità. NOTA: il chiamante deve assicurarsi che ogni |
considerRoadTraffic |
Considera la stima del traffico nel calcolo dei campi |
populatePolylines |
Se il valore è true, le polilinee verranno compilate nella risposta |
populateTransitionPolylines |
Se il valore è true, le polilinee verranno compilate nella risposta |
allowLargeDeadlineDespiteInterruptionRisk |
Se questo criterio è impostato, la richiesta può avere una scadenza (vedi la pagina https://grpc.io/blog/deadlines) di massimo 60 minuti. In caso contrario, la scadenza massima è di soli 30 minuti. Tieni presente che le richieste di lunga durata presentano un rischio di interruzione significativamente maggiore (ma ancora ridotto). |
useGeodesicDistances |
Se il valore è true, le distanze da percorrere verranno calcolate utilizzando le distanze geodetiche anziché quelle di Google Maps, mentre i tempi di percorrenza verranno calcolati utilizzando le distanze geodetiche con una velocità definita da |
label |
Etichetta che potrebbe essere utilizzata per identificare questa richiesta, riportata nel |
geodesicMetersPerSecond |
Se |
maxValidationErrors |
Tronca il numero di errori di convalida restituiti. In genere, questi errori sono associati a un payload di errore INVALID_ARGUMENT come dettaglio di errore BadRequest (https://cloud.google.com/apis/design/errors#error_details), a meno che solvingMode=VALIDATE_ONLY: vedi il campo |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di OptimizeToursResponse
.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform