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 per utilizzare API Routes. Per informazioni dettagliate sull'API Routes, consulta la panoramica del prodotto.

Aggiorna gli endpoint dell'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 le API Directions e Distance Matrix, puoi trasmettere 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 nell'ambito di una richiesta HTTP POST. Per esempi, consulta:

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

Nelle seguenti tabelle sono elencati i parametri dell'API Directions e dell'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 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 TWO_WHEELER e TRANSIT.
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, nell'API Routes, i passaggi sono sempre un'istruzione di navigazione per tutti i tipi di viaggio. 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. Quando mostri i risultati agli utenti, devi includere la seguente dichiarazione:

Powered by Google, ©YEAR Google

Ad esempio:

Powered by Google, ©2022 Google
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. 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