L'API Route Optimization assegna attività e percorsi a un parco veicoli, ottimizzandoli in base agli obiettivi e ai vincoli forniti, come finestre temporali, capacità dei veicoli, ore di guida e costi. Puoi chiamarla tramite REST, gRPC o librerie client e restituisce sequenze di visite, assegnazioni di spedizioni, tempi stimati e metriche dei percorsi.
API Route Optimization: informazioni chiave
- Prodotto: API Route Optimization
- Noto anche come: GMPRO
- Categoria: Percorsi
- Piattaforma: servizio web (REST)
- Esecuzione su: server (codice di backend)
- Fase di lancio: GA
- Ciclo di vita: Attivo
- Panoramica: Panoramica dell'API Route Optimization
API Route Optimization: quando utilizzarla
Utilizza l'API Route Optimization quando:
- Devi assegnare spedizioni o attività a diversi veicoli rispettando le finestre temporali, la capacità dei veicoli, gli orari dei conducenti e i costi.
- Hai bisogno della migliore sequenza di fermate per un veicolo con diversi ritiri, consegne o appuntamenti.
- Devi riottimizzare i percorsi attivi per i nuovi ordini (ad esempio, l'invio on demand) utilizzando
injectedFirstSolutionRoutesoinjectedSolutionConstraint. - Per ogni tappa di un piano ottimizzato, devi passare i token di percorso all'SDK Navigation.
Non utilizzare l'API Route Optimization quando:
- Hai bisogno di un monitoraggio in tempo reale di come i conducenti eseguono il piano; l'API restituisce polilinee pianificate, non percorsi dei veicoli in tempo reale. Utilizza invece il servizio Fleet Engine.
- Hai bisogno di indicazioni stradali passo passo in-app per i conducenti lungo il percorso ottimizzato. Utilizza invece l'SDK Navigation per Android.
- Hai bisogno di indicazioni stradali passo passo in-app per i conducenti su iOS lungo il percorso ottimizzato. Utilizza invece l'SDK Navigation per iOS.
API Route Optimization: configurazione
- Servizio da attivare:
routeoptimization.googleapis.com - Autenticazione: OAuth 2.0, service account
- Inizia: configura l'API Route Optimization
- Riferimento: Riferimento API Route Optimization
- Prezzi: Utilizzo e fatturazione dell'API Route Optimization
- Policy: policy dell'API Route Optimization
- Note di rilascio: Note di rilascio dell'API Route Optimization
Pacchetti ufficiali dell'API Route Optimization:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
API Route Optimization: prodotti correlati
- Spesso utilizzato con: Navigation SDK for Android, Navigation SDK for iOS, servizio Fleet Engine, API Maps JavaScript
API Route Optimization: errori comuni
OptimizeTourstimeoutCorrezione: imposta l'intestazioneX-Server-Timeout(secondi, senza il suffisso "s") per estendere la scadenza. Le librerie client e gRPC hanno un valore predefinito di 3600 secondi. Consulta /maps/documentation/route-optimization/timeouts.- Problema: i valori
timeoute deadline sono limitati a 1800 secondi. Correzione: impostaallowLargeDeadlineDespiteInterruptionRisksutrueper consentire fino a 3600 secondi, accettando un rischio maggiore di errori di interruzione. Consulta /maps/documentation/route-optimization/timeouts. - Problema: senza parametri di costo (ad esempio
costPerHourocostPerKilometer), l'ottimizzatore tratta tutte le soluzioni allo stesso modo. Correzione: definisci i parametri di costo dei veicoli in modo che riflettano i costi della tua attività. Consulta /maps/documentation/route-optimization/make-first-request. - Problema: le richieste autenticate con una chiave API non vanno a buon fine; ogni richiesta richiede un token OAuth. Correzione: utilizza un token OAuth con l'ambito
https://www.googleapis.com/auth/cloud-platform, ad esempio tramite Credenziali predefinite dell'applicazione o un service account. Consulta /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.
Che cosa puoi fare con l'API Route Optimization
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
- Restituisce un piano di consegna con più tappe, ottimizzato in base ai vincoli specificati relativi a percorso, costi, spedizione e veicolo.
- Restituisci gli orari di inizio e di fine di ogni fermata di un piano di consegna ottimizzato.
- Restituisce le durate di viaggio, ritardo, pausa e attesa tra ogni fermata di un piano di consegna ottimizzato.
- Restituisci le informazioni sul carico del veicolo a ogni fermata di un piano di consegna ottimizzato.
- Restituisce informazioni sui costi per ogni spedizione in un piano di consegna ottimizzato.
- Restituisce una polilinea codificata per il percorso tra ogni fermata di un piano di consegna ottimizzato.
- Restituisci un token del percorso di navigazione per il percorso tra ogni fermata di un piano di consegna ottimizzato.
- Restituisce metriche aggregate relative a spedizioni, veicoli e costi per un piano di consegna ottimizzato.
- Specifica la finestra temporale di inizio e fine per un piano di consegna con più fermate.
- Specifica gli orari di inizio e di fine della disponibilità e le località per ogni veicolo in un piano di consegna con più fermate.
- Specifica i costi di tempo per ogni veicolo in un piano di consegna con più fermate.
- Specifica i parametri del modello di costo per un piano di consegna con più tappe.
- Specifica i vincoli di tempo per il ritiro e la consegna per ogni spedizione in un piano di consegna con più fermate.
- Specifica le assegnazioni dei veicoli per un piano di consegna con più fermate.
- Specifica i limiti di carico per ogni veicolo in un piano di consegna con più fermate.
- Specifica se considerare le informazioni sul traffico in tempo reale per un piano di consegna con più fermate.
- Elabora in batch una richiesta di ottimizzazione del piano di consegna con più fermate e scrivi la risposta in Google Cloud Storage.
- Riserva del tempo per il parcheggio prima di effettuare le consegne.
- Dai la priorità alle visite nelle vicinanze da effettuare una dopo l'altra.
- Evita di fare inversioni a U in un percorso del veicolo con più fermate. Sperimentale Nota: funzionalità sperimentale; soggetta ai termini e alle limitazioni pre-GA.
- Ottimizza per obiettivi predefiniti. Sperimentale Nota: funzionalità sperimentale; soggetta ai termini e alle limitazioni pre-GA.
- Consegna prima le spedizioni più pesanti. Sperimentale Nota: funzionalità sperimentale; soggetta ai termini e alle limitazioni pre-GA.