Esegui la migrazione dall'API Directions (legacy) o dall'API Distance Matrix (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

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 il tuo utilizzo dell'API è sufficientemente elevato da passare ai prezzi di secondo livello. Quando esegui la migrazione a una versione più recente di un'API, ti viene addebitato anche uno SKU diverso. Per evitare un aumento dei costi 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, raggiungerai i livelli di prezzo mensili più convenienti durante il mese di migrazione. 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

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, passi i parametri in un corpo della richiesta o nelle intestazioni come parte di una richiesta HTTP POST. Per esempi, vedi:

Converti i waypoint codificati in polilinee in waypoint di località

La specifica dei waypoint come polilinee codificate è disponibile nell' API Directions (legacy) per adattare un numero elevato di waypoint al limite 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 l' esempio HTTP nel documento Calcola una matrice di percorsi o Definisci un waypoint intermedio nel documento Specifica i waypoint intermedi.

Converti i 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 di direzione o matrice di distanza Parametro dell'API Routes Note
alternatives computeAlternativeRoutes
arrival_time arrivalTime Disponibile solo in TRANSIT modalità 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

Passato nel computeRoutes o computeRouteMatrix corpo della richiesta JSON POST HTTP utilizzando i RouteTravelMode valori (DRIVE, TWO_WHEELER, WALK, TRANSIT, TRUCK, o BICYCLE per computeRoutes) anziché un parametro di query URL GET. Aggiunto il supporto per TWO_WHEELER, TRANSIT, e TRUCK.
region regionCode
traffic_model trafficModel Scopri di più
transit_mode "travelMode": "TRANSIT" Nell'API Directions (legacy), in un percorso di transito, ogni segmento di un viaggio con la stessa modalità di viaggio (ad esempio, a piedi o in transito) è 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. 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`. Scopri di più.
transit_routing_preference transitRoutingPreference Scopri di più
units units Scopri di più
waypoints intermediates Rimosso il supporto per le polilinee codificate.
optimize=true per i waypoint "optimizeWaypointOrder": "true" Scopri di più

Conversioni dei parametri di risposta

Parametro di direzione o matrice di distanza Parametro dell'API Routes Note
copyrights

Non incluso nella risposta. Devi includere la seguente dichiarazione quando mostri i risultati agli utenti:

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 errori segnalati dall'API. Per saperne di più, consulta 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.

Utilizza gli ID luogo anziché le coordinate per il routing ad alta precisione. Gli ID luogo contengono dati che allineano il percorso ai punti di accesso corretti.

  • Se inizi con un indirizzo: utilizza Place Autocomplete o l'API Geocoding per risolverlo in un ID luogo.
  • Se inizi con le coordinate: valuta la possibilità di utilizzare la ricerca di destinazioni per fornire una località più significativa. La semplice acquisizione di un indirizzo dalle coordinate può essere complessa e portare a un allineamento errato. L'API Routes non esegue la geocodifica inversa delle coordinate in indirizzi.
legs.start_address Non disponibile.
overview_polyline polilinea
summary description
waypoint_order optimizedIntermediateWaypointIndex