Questa guida descrive come eseguire la migrazione di app che utilizzano l'API Directions o l'API Distance Matrix per utilizzare l'API Routes. Per maggiori dettagli sull'API Routes, vedi 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 |
API From 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 un corpo della richiesta HTTPS
Con l'API Directions e l'API Distanza 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, passi i parametri nel corpo di una richiesta o nelle intestazioni come parte di una richiesta HTTP POST
. Per alcuni esempi, vedi:
Converti i pointpoint codificati con la polilinea in tappe della posizione
La specifica dei pointpoint come polilinee codificate è disponibile nell'API Directions per adattarsi a un numero elevato di tappe nel limite dell'URL di 16.384 caratteri. Questa funzionalità non è necessaria nell'API Routes perché i punti di percorso possono essere trasmessi nel corpo della richiesta REST o gRPC come coordinate di latitudine/longitudine. Ad esempio, consulta l'esempio di HTTP nel documento Calcola una matrice di route o Definisci un tappa intermedi nel documento Specificare i punti intermedi.
Converti parametri
Le seguenti tabelle elencano i parametri nelle API Directions e nell'API Distanza Matrix che sono stati rinominati o modificati oppure i parametri non supportati nella release GA. Aggiorna il codice se utilizzi uno di questi parametri.
Conversioni dei parametri di richiesta
Indicazioni stradali o parametro della matrice delle distanze | 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 |
Opzione supportata solo per le route Compute. |
mode |
travelMode |
Aggiunto il supporto per |
region |
regionCode |
|
traffic_model |
trafficModel |
Scopri di più |
transit_mode |
"travelMode": "TRANSIT" |
Nell'API Directions, in un percorso con il trasporto pubblico, ogni segmento di una corsa con la stessa modalità di viaggio (ad esempio A piedi o Trasporto pubblico) è considerato un passaggio, mentre le singole indicazioni stradali per questa modalità di viaggio sono nei passaggi secondari. Al contrario, nell'API Routes, i passi sono una sola istruzione di navigazione per tutti i tipi di viaggio. Ogni istruzione di navigazione è un passo. Per più passaggi in una modalità di viaggio, l'API Routes fornisce metadati che contengono un riepilogo dei passaggi per quella modalità di viaggio, in "stepsOverview". Per richiedere questi metadati, utilizza la maschera del campo "routes.legs.stepsOverview". Scopri di più. |
transit_routing_preference |
transitRoutingPreference |
Scopri di più |
units |
Non disponibile per la matrice delle route. | |
waypoints |
intermediates |
Rimosso il supporto per le polilinee codificate. |
optimize=true per i tappe |
"optimizeWaypointOrder": "true" |
Scopri di più |
Conversioni parametro di risposta
Indicazioni stradali o parametro della matrice delle distanze | 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 |
Rimossa nell'API Routes, utilizza duration . |
status |
Non disponibile. Utilizza i codici di risposta HTTP per gli errori segnalati dall'API. Per ulteriori informazioni, consulta la sezione Gestire gli errori delle richieste. | |
geocoded_waypoints |
geocoding_results |
Opzione supportata solo per le route Compute. Contiene informazioni di risposta di geocodifica solo per i punti intermedi specificati come indirizzi. |
bounds |
viewport |
|
legs.end_address |
Non disponibile. | |
legs.start_address |
Non disponibile. | |
overview_polyline |
polilinea | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |