Questa guida descrive come eseguire la migrazione delle app che utilizzano l'API Directions o l'API Distance Matrix all'API Routes. Per maggiori dettagli sull'API Routes, consulta la panoramica del prodotto.
Aggiorna gli endpoint API REST
Aggiorna il codice per utilizzare i nuovi endpoint dell'API Routes
Dall'API Directions
| API Directions | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
| API Routes | https://routes.googleapis.com/directions/v2:computeRoutes |
Dall'API Distance Matrix
| API Distance Matrix | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
| API Routes | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
Converti i parametri URL per utilizzare il corpo di una richiesta HTTPS
Con l'API Directions e l'API Distance Matrix, puoi
passare le proprietà di configurazione come parametri URL a una richiesta HTTP GET. Ad
esempio, per l'API Directions:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Con l'API Routes, puoi passare i parametri nel corpo di una richiesta o nelle intestazioni
come parte di una richiesta HTTP POST. Per alcuni esempi, vedi:
Convertire le tappe con codifica polilinea in le tappe in località
La specifica delle tappe come polilinee codificate è disponibile nell'API Directions per soddisfare un numero elevato di tappe entro il limite di 16.384 caratteri dell'URL. Questa funzionalità non è necessaria nell'API Routes perché le tappe possono essere trasmesse nel corpo della richiesta REST o gRPC come coordinate di latitudine/longitudine. Per alcuni esempi, consulta l'Esempio HTTP nel documento Calcola una matrice di route o Definisci una tappa intermedia nel documento Specifica le tappe intermedie.
Converti parametri
Nella tabella seguente sono elencati i parametri nell'API Directions e nell'API Distance Matrix che sono stati rinominati o modificati oppure i parametri non supportati nella release GA. Aggiorna il codice se utilizzi uno di questi parametri.
Richiedi conversioni dei parametri
| Directions o parametro Distance matrix | Parametro API Routes | Note |
|---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Disponibile solo in modalità TRANSIT e non contemporaneamente
a departureTime. |
avoid |
routeModifiers |
|
departure_time |
departureTime |
Non può essere utilizzato contemporaneamente a arrivalTime. |
language |
languageCode |
Supportata solo per Compute Routes. |
mode |
travelMode |
Aggiunto il supporto per |
region |
regionCode |
|
traffic_model |
trafficModel |
Scopri di più |
transit_mode |
"travelMode": "TRANSIT" |
Nell'API Directions, in un percorso di trasporto pubblico, ogni tratto di una corsa con la stessa modalità di viaggio (ad esempio, A piedi o Trasporto pubblico) viene considerato come un unico passaggio e le singole indicazioni stradali per quella modalità di trasporto sono in sottopassaggi. Al contrario, nell'API Routes, i passaggi sono costantemente un'istruzione di navigazione per tutti i tipi di viaggi. Ogni istruzione di navigazione è quindi un passaggio. Per più passaggi in una modalità di viaggio, l'API Routes fornisce metadati contenenti un riepilogo dei passaggi per quella modalità di viaggio, in "stepsPanoramica". Per richiedere questi metadati, utilizza la maschera del campo "routes.legs.stepsPanoramica". Scopri di più. |
transit_routing_preference |
transitRoutingPreference |
Scopri di più |
units |
Non disponibile per la matrice del percorso. | |
waypoints |
intermediates |
Rimosso il supporto per le polilinee codificate. |
optimize=true per le tappe |
"optimizeWaypointOrder": "true" |
Scopri di più |
Conversioni dei parametri di risposta
| Directions o parametro Distance matrix | Parametro API Routes | Note |
|---|---|---|
copyrights |
Non incluso nella risposta. Devi includere la seguente dichiarazione quando mostri i risultati agli utenti:
Ad esempio:
|
|
distance |
distanceMeters |
La distanza è disponibile solo in metri. |
duration_in_traffic |
duration |
Rimosso nell'API Routes, usa duration. |
status |
Non disponibile. Utilizza i codici di risposta HTTP per gli errori segnalati dall'API. Per ulteriori informazioni, consulta Gestire gli errori delle richieste. | |
geocoded_waypoints |
geocoding_results |
Supportata solo per Compute Routes. Contiene informazioni sulle risposte di geocodifica solo per le tappe specificate come indirizzi. |
bounds |
viewport |
|
legs.end_address |
Non disponibile. | |
legs.start_address |
Non disponibile. | |
overview_polyline |
polilinea | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |