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'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

Convertire i parametri URL per utilizzare un corpo della 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, puoi passare i parametri nel corpo della richiesta o nelle intestazioni come parte di una richiesta HTTP POST. Per esempi, consulta:

Converti i waypoint codificati in polilinee in waypoint posizione

La specifica dei waypoint come polilinee codificate è disponibile nell'API Directions per adattarsi a un gran numero di waypoint nel limite di 16384 caratteri dell'URL. Questa funzionalità non è necessaria nell'API Routes perché i waypoint possono essere trasmessi nel corpo della richiesta REST o gRPC come coordinate di latitudine/longitudine. Per esempi, consulta l'esempio HTTP nel documento Calcolo di una matrice di percorsi o Definire un waypoint intermedio nel documento Specificare waypoint intermedi.

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.

Conversioni dei parametri di richiesta

Parametro Indicazioni stradali o Matrice di distanza Parametro dell'API Routes Note
alternatives computeAlternativeRoutes
arrival_time arrivalTime Disponibile solo in modalità TRANSIT e non contemporaneamente con departureTime.
avoid routeModifiers
departure_time departureTime Non può essere utilizzato contemporaneamente con arrivalTime.
language languageCode Supportato solo per le route di calcolo.
mode travelMode

È stato 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, ogni tratto di un viaggio con la stessa modalità di viaggio (ad esempio, A piedi o Trasporto pubblico) è considerato un passaggio e le singole indicazioni per quella modalità di viaggio sono nei passaggi secondari. Al contrario, nell'API Routes, i passaggi sono sempre un'istruzione di navigazione per tutti i tipi di viaggio. Pertanto, ogni istruzione di navigazione è un passaggio. 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 di campo "routes.legs.stepsOverview". Ulteriori informazioni.
transit_routing_preference transitRoutingPreference Scopri di più
units units Scopri di più
waypoints intermediates È stato rimosso il supporto per i polilinee codificati.
optimize=true per i waypoint "optimizeWaypointOrder": "true" Scopri di più

Conversioni dei parametri di risposta

Parametro Indicazioni stradali o Matrice di distanza Parametro dell'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, 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 di richiesta.
geocoded_waypoints geocoding_results Supportato solo per le route di calcolo. Contiene informazioni sulla risposta di geocodifica solo per i waypoint specificati come indirizzi.
bounds viewport
legs.end_address Non disponibile.
legs.start_address Non disponibile.
overview_polyline polilinea
summary description
waypoint_order optimizedIntermediateWaypointIndex