Riferimento rapido per l'API Route Optimization

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 injectedFirstSolutionRoutes o injectedSolutionConstraint.
  • 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

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: errori comuni

  • OptimizeTourstimeout Correzione: imposta l'intestazione X-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 timeout e deadline sono limitati a 1800 secondi. Correzione: imposta allowLargeDeadlineDespiteInterruptionRisk su true per 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 costPerHour o costPerKilometer), 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.