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
- Servizio da attivare:
routes.googleapis.com - Autenticazione: chiave API, OAuth 2.0, service account
- Per iniziare: configura l'API Routes
- Riferimento: Riferimento API Routes
- Prezzi: Utilizzo e fatturazione dell'API Routes
- Policy: policy dell'API Routes
- Note di rilascio: note di rilascio dell'API Routes
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: prodotti correlati
- Sostituisce: API Directions, API Distance Matrix
- Spesso utilizzato con: Navigation SDK for Android, Navigation SDK for iOS, API Route Optimization, API Geocoding, API Places (New)
API Routes: errori comuni
- Problema: non esiste un elenco predefinito di campi restituiti; le richieste senza una maschera di campo (intestazione
X-Goog-FieldMasko 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 esempioTOLLS,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 utilizziTRAFFIC_AWARE_OPTIMALo 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.
- Restituisce le indicazioni stradali tra due o più coordinate di latitudine/longitudine come una serie di coordinate per ogni passaggio lungo un percorso.
- Restituisce le indicazioni stradali tra due o più insiemi di coordinate di latitudine/longitudine sotto forma di una serie di descrizioni delle manovre per i passaggi lungo un percorso.
- Restituisce la distanza tra ogni passaggio lungo un percorso tra due o più insiemi di coordinate di latitudine/longitudine.
- Restituisce il tempo di percorrenza tra ogni passaggio lungo un percorso tra due o più insiemi di coordinate di latitudine/longitudine.
- Restituisce una polilinea codificata tra ogni passaggio lungo un percorso tra due o più insiemi di coordinate di latitudine/longitudine.
- Restituisce la distanza di un percorso tra due o più insiemi di coordinate di latitudine/longitudine.
- Restituisce il tempo di percorrenza di un percorso tra due o più insiemi di coordinate di latitudine/longitudine.
- Restituisce una polilinea codificata per un percorso tra due o più insiemi di coordinate di latitudine/longitudine.
- Restituisce informazioni sui pedaggi per un percorso tra due o più insiemi di coordinate di latitudine/longitudine.
- Specifica la modalità di viaggio (auto, trasporto pubblico, a piedi, due ruote) per una richiesta di percorso. Nota: nel servizio web dell'API Routes (computeRoutes), passa travelMode nel corpo JSON HTTP POST utilizzando RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT o TRUCK con routeModifiers.vehicleInfo) e includi l'intestazione X-Goog-FieldMask obbligatoria anziché un parametro di query della modalità GET precedente. Nella libreria Routes dell'API Maps JavaScript, passa travelMode e i campi in ComputeRoutesRequest.
- Specifica un punto di sosta o di passaggio per una richiesta di percorso.
- Specifica come vengono utilizzati i dati sul traffico in una richiesta di percorso.
- Specifica le caratteristiche da evitare, come autostrade o pedaggi, per una richiesta di percorso.
- Imposta i waypoint lungo un percorso.
- Imposta tappe intermedie lungo un percorso.
- Imposta un punto di passaggio per un percorso.
- Specifica la direzione del veicolo e il lato della strada per un percorso.
- Ottimizza l'ordine delle tappe del tuo percorso.
- Specifica il percorso ecosostenibile per una richiesta di percorsi. Anteprima
- Specifica una distanza più breve o un percorso alternativo per una richiesta di percorsi. Nota: nell'API Routes, la richiesta di un percorso di riferimento con una distanza più breve (SHORTER_DISTANCE) è in fase sperimentale, mentre la richiesta di percorsi alternativi (computeAlternativeRoutes) è in disponibilità generale.
- Restituisce le distanze per una matrice di percorsi tra più origini e destinazioni.
- Restituisce i tempi di percorrenza per una matrice di percorsi tra più punti di partenza e di arrivo.
- Restituisci informazioni sui pedaggi per una matrice di percorsi tra più origini e destinazioni.
- Specifica la modalità di viaggio (in auto, con il trasporto pubblico, a piedi, su due ruote) per una richiesta di matrice dei percorsi. Nota: nel servizio web dell'API Routes (computeRouteMatrix), passa travelMode nel corpo JSON HTTP POST utilizzando RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT o TRUCK con origins[].routeModifiers.vehicleInfo; BICYCLE non è supportato per le matrici dei percorsi) e includi l'intestazione X-Goog-FieldMask obbligatoria. Nella libreria Routes dell'API Maps JavaScript, passa travelMode e i campi in ComputeRouteMatrixRequest.