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.
Best practice di fatturazione per la migrazione
Queste indicazioni si applicano se l'utilizzo dell'API è sufficientemente elevato da passare al prezzo di secondo livello. Quando esegui la migrazione a una versione più recente di un'API, ti viene addebitato anche un SKU diverso. Per evitare costi maggiori durante il mese di transizione, ti consigliamo di passare alle nuove API in produzione il più vicino possibile all'inizio del mese. In questo modo, durante il mese della migrazione raggiungerai i livelli di prezzo mensili più convenienti. Per informazioni sui livelli di prezzo, consulta la pagina dei prezzi e le domande frequenti sui prezzi.
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 l'API Directions e l'API Distance Matrix, trasmetti 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 alcuni esempi, vedi:
Convertire i waypoint codificati in polilinea in waypoint di località
La specifica dei waypoint come polilinee codificate è disponibile nell'API Directions (legacy) per adattarsi a un numero elevato di waypoint nel limite di URL di 16.384 caratteri. 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 la sezione Esempio HTTP nel documento Calcolare una matrice di itinerari o Definire un waypoint intermedio nel documento Specificare waypoint intermedi.
Converti parametri
Le tabelle seguenti elencano 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 Distance Matrix | 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 |
Supportato solo per Compute Routes. |
mode |
travelMode |
È stato aggiunto il supporto per |
region |
regionCode |
|
traffic_model |
trafficModel |
Scopri di più |
transit_mode |
"travelMode": "TRANSIT" |
Nell'API Directions (legacy), in un itinerario del trasporto pubblico, ogni segmento di un viaggio con la stessa modalità di trasporto (ad esempio, a piedi o con i mezzi pubblici) è considerato un passaggio e le singole indicazioni per quella modalità di trasporto si trovano nei passaggi secondari. Al contrario, nell'API Routes, i passaggi sono sempre un'istruzione di navigazione per tutti i tipi di viaggio. Quindi, 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 del 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 le polilinee codificate. |
optimize=true per le tappe |
"optimizeWaypointOrder": "true" |
Scopri di più |
Conversioni dei parametri di risposta
| Parametro Indicazioni stradali o Distance Matrix | Parametro API Routes | Note |
|---|---|---|
copyrights |
Non incluso nella risposta. Quando mostri i risultati agli utenti, devi includere la seguente dichiarazione:
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 |
Supportato solo per Compute Routes. 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 |