Esegui la migrazione dall'API Directions o dall'API Distance Matrix

Questa guida descrive come eseguire la migrazione delle app che utilizzano l'API Directions o l'API Distance Matrix all'uso dell'API Routes. Per i 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

API From Directions

API Directions https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
API Routes https://routes.googleapis.com/directions/v2:computeRoutes

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 un corpo della richiesta HTTPS

Con l'API Directions e l'API Distance Matrix, passi 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, trasmetti i parametri in un corpo della richiesta o nelle intestazioni nell'ambito di una richiesta HTTP POST. Per alcuni esempi, vedi:

Converti Waypoint rappresentati come polilinee codificate in tappe intermedie

La specifica dei Waypoint come polilinee codificate è disponibile nell'API Directions in modo da consentire l'inserimento di un gran numero di tappe nel limite di 8192 caratteri. Questa funzionalità non è necessaria nell'API Routes perché i tappe possono essere trasmessi nel corpo delle richieste REST o gRPC come tappe intermedie.

Convertire i parametri esistenti in parametri dell'API Routes

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.

Route a matrice o parametro della distanza Parametro API Routes Note
alternatives computeAlternativeRoutes
arrival_time Non disponibile perché la modalità TRANSIT non è disponibile.
avoid routeModifiers
copyrights

Non incluso nella risposta. Quando mostri i risultati agli utenti, devi includere la seguente affermazione:

Powered by Google, ©YEAR Google

Ad esempio:

Powered by Google, ©2022 Google
departure_time departureTime
distance distanceMeters La distanza è disponibile solo in metri.
duration_in_traffic Rimosso nell'API Routes, utilizza duration. Per scoprire di più, consulta la sezione Modifiche alle funzionalità per la nuova API Routes sopra.
language languageCode Supportato solo per le route di calcolo.
mode travelMode

Aggiunto il supporto per TWO_WHEELER.

Modalità TRANSIT non disponibile.
region regionCode

status Non disponibile. Utilizza i codici di risposta HTTP per gli errori segnalati dall'API. Per ulteriori informazioni, consulta la sezione Gestire gli errori di richiesta.
traffic_model Non disponibile.
transit_mode Non disponibile perché la modalità TRANSIT non è disponibile.
transit_routing_preference Non disponibile perché la modalità TRANSIT non è disponibile.
units Non disponibile per la matrice di route.
waypoints intermediates È stato rimosso il supporto per le polilinee codificate.
optimize=true per i tappe Non disponibile.