Questa guida descrive come eseguire la migrazione delle app che utilizzano l'API Directions o l'API Distance Matrix per utilizzare API Routes. Per maggiori dettagli sull'API Routes, consulta Informazioni sul prodotto Panoramica.
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,
Trasmetti le proprietà di configurazione come parametri URL a una richiesta HTTP GET
. Per
esempio per l'API Directions:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Con l'API Routes, passi i parametri nel corpo di una richiesta o nelle intestazioni
nell'ambito di una richiesta HTTP POST
. Per alcuni esempi, vedi:
Convertire le tappe con codifica polilinea in le tappe in località
Specificare i waypoint come polilinee codificate è disponibile in API Directions per adattarsi a grandi di waypoint entro il limite di 16.384 caratteri dell'URL. Questa funzionalità non è necessarie nell'API Routes perché le tappe possono essere trasmesse Corpo della richiesta REST o gRPC come coordinate di latitudine/longitudine. Ad esempio: vedi il Esempio HTTP nel documento Calcola una matrice di percorso oppure Definisci una tappa intermedia nel documento Specifica le tappe intermedie.
Converti parametri
Nella tabella seguente sono elencati i parametri l'API Directions e l'API Distance Matrix che hanno rinominati o modificati oppure parametri non supportati in 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
volta come 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, segmento di un viaggio con la stessa modalità di viaggio (ad esempio, A piedi o trasporto pubblico) è considerato un passo e le singole indicazioni stradali per questa modalità di viaggio è in sottopassi. Al contrario, nel API Routes, i passaggi sono sempre un'istruzione di navigazione per tutti i tipi di viaggi. Ogni istruzione di navigazione è quindi un passaggio. Per più passaggi in una sola modalità di viaggio, l'API Routes fornisce che contengono un riepilogo dei passaggi per quella modalità di viaggio, in `stepsOverview`. Per richiedere questi metadati, utilizza il metodo Maschera del campo "routes.legs.stepsPanoramica". Ulteriori informazioni. |
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 quanto segue 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 segnalati dall'API. Vedi Gestire gli errori delle richieste per ulteriori informazioni. | |
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 |