Riferimento rapido all'API Routes

L'API Routes è un servizio web con due metodi: Compute Routes restituisce un percorso tra due località con tappe intermedie facoltative, mentre Compute Route Matrix restituisce la distanza e il tempo di percorrenza per combinazioni di origini e destinazioni (fino a 625 elementi della matrice dei percorsi).

API Routes: informazioni chiave

  • Prodotto: API Routes
  • Nota anche come: API Routes v2, Compute Routes, Compute matrice dei percorsi
  • Categoria: Percorsi
  • Piattaforma: servizio web (REST)
  • Esecuzione su: server (codice di backend)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica dell'API Routes
  • Disponibilità regionale: ovunque. Il percorso per le due ruote, i percorsi ecosostenibili e il calcolo dei pedaggi sono limitati ai paesi e alle città supportati, mentre i territori dipendenti con il proprio codice CLDR non sono supportati, a meno che non siano elencati. Per gli indirizzi di fatturazione dello Spazio economico europeo (SEE), i termini del SEE all'indirizzo https://developers.google.com/maps/comms/eea/routes vietano l'utilizzo di descrizioni o passaggi dei percorsi con qualsiasi mappa. (dettagli sulla copertura)

API Routes: quando utilizzarla

Utilizza l'API Routes quando:

  • Hai bisogno di un percorso tra un'origine e una destinazione, con waypoint intermedi facoltativi, per spostamenti in auto, a piedi, in bicicletta, su due ruote o con il trasporto pubblico.
  • Hai bisogno di distanze e tempi di percorrenza per molte coppie di origine e destinazione in un'unica richiesta (fino a 625 elementi).
  • Hai bisogno di stime dei pedaggi (città selezionate), percorsi ecosostenibili (regioni selezionate), polilinee che tengono conto del traffico o routing per veicoli di grandi dimensioni (disponibilità limitata).
  • Stai eseguendo la migrazione di un'app server dall'API Directions o dall'API Distance Matrix legacy.

Non utilizzare l'API Routes quando:

  • Devi ottimizzare le assegnazioni dei carichi e l'ordine delle fermate per un'intera flotta di veicoli. Utilizza invece l'API Route Optimization.
  • Hai bisogno di una navigazione passo passo in-app su Android che segua un percorso calcolato. Utilizza invece l'SDK Navigation per Android.
  • Hai bisogno di una navigazione passo passo in-app su iOS che segua un percorso calcolato. Utilizza invece l'SDK Navigation per iOS.

API Routes: configurazione

Pacchetti ufficiali dell'API Routes:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

API Routes: errori comuni

  • Problema: non esiste un elenco predefinito di campi restituiti; le richieste senza una maschera di campo (intestazione X-Goog-FieldMask o parametro $fields) restituiscono un errore. Correzione: invia sempre una maschera di campo che elenchi i campi di risposta di cui hai bisogno. Consulta /maps/documentation/routes/choose_fields.
  • Problema: l'utilizzo della maschera di campo con caratteri jolly (*) in produzione aumenta i costi e la latenza, inoltre i costi possono aumentare in modo imprevisto man mano che vengono aggiunte nuove funzionalità avanzate alla risposta. Correzione: utilizza * solo durante lo sviluppo; in produzione, richiedi solo i campi di cui hai bisogno. Consulta /maps/documentation/routes/choose_fields.
  • Problema: le informazioni sui pedaggi e sul consumo di carburante non vengono restituite semplicemente aggiungendole alla maschera di campo; dalla GA devono essere attivate esplicitamente. Correzione: aggiungi l'array extraComputations (ad esempio TOLLS, FUEL_CONSUMPTION) alla richiesta oltre alla maschera di campo. Consulta /maps/documentation/routes/migrate-routes-preview.
  • Problema: Compute Route Matrix consente 625 elementi, ma solo 100 elementi quando routingPreference è TRAFFIC_AWARE_OPTIMAL. Correzione: mantieni il numero di origini x destinazioni pari o inferiore a 100 quando utilizzi TRAFFIC_AWARE_OPTIMAL o suddividi la richiesta. Consulta /maps/documentation/routes/compute_route_matrix.

Cosa puoi fare con l'API Routes

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.