Esegui la migrazione dalla versione di anteprima

Sviluppatori dello Spazio economico europeo (SEE)

L'API Routes è stata rilasciata come anteprima pubblica (pre-GA) nel settembre 2022. Le offerte pre-GA sono coperte dai Termini specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa sezione descrive come eseguire la migrazione di un'app dalla release di anteprima alla release GA.

Nuove funzionalità aggiunte alla release GA

La release GA aggiunge le seguenti nuove funzionalità non incluse nell'anteprima:

  • Oltre agli ID luogo e alle coordinate di latitudine/longitudine, ora puoi specificare una località nella release GA utilizzando:

    • Stringhe di indirizzo ("Chicago, IL" o "Darwin, NT, Australia")

      Le stringhe di indirizzo sono spesso il modo in cui un utente inserisce un indirizzo. Tuttavia, {product_name} deve prima eseguire il geocoding della stringa di indirizzo internamente per convertirla in coordinate di latitudine/longitudine prima di poter calcolare un percorso.

      Inoltre, è stato aggiunto il supporto per il parametro di richiesta regionCode, che consente di specificare di restituire i risultati del geocoding per una regione geografica specifica.

    • Plus Code

      I Plus Code sono come gli indirizzi per le persone o i luoghi che non hanno un indirizzo effettivo. Anziché indirizzi con nomi e numeri di vie, i Plus Code sono basati su latitudine e longitudine e vengono visualizzati come numeri e lettere.

  • La risposta di calcolo dei percorsi ora contiene l' geocodingResults array. Per ogni località nella richiesta (origine, destinazione o waypoint intermedio) specificata come stringa di indirizzo o come Plus Code, l'API esegue una ricerca dell'ID luogo. Ogni elemento di questo array contiene l'ID luogo corrispondente a una località insieme a metadati aggiuntivi sulla località. Le località nella richiesta specificate come ID luogo o come coordinate di latitudine/longitudine vengono ignorate.

Modifiche alle funzionalità di anteprima esistenti

Ora devi attivare esplicitamente le seguenti funzionalità nella release GA aggiungendo il nuovo campo dell'array extraComputations alla richiesta:

Nella release di anteprima, hai utilizzato una maschera di campo per specificare di restituire le informazioni per queste funzionalità nella risposta. Ora devi:

  • Impostare il nuovo parametro di richiesta dell'array extraComputations per attivare queste funzionalità.
  • Impostare una maschera di campo per specificare di restituire le informazioni nella risposta.

Che cosa devo sapere?

I seguenti campi non saranno più inclusi nelle risposte di computeRouteMatrix a meno che non siano attivati esplicitamente impostando extraComputations:

  • travelAdvisory.tollInfo (Informazioni sui pedaggi)

I seguenti campi non saranno più inclusi nelle risposte di computeRoutes a meno che non siano attivati esplicitamente impostando extraComputations:

  • routes.legs.travelAdvisory.tollInfo(Informazioni sui pedaggi)
  • routes.travelAdvisory.tollInfo(Informazioni sui pedaggi)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Consumo di carburante)
  • routes.travelAdvisory.speedReadingIntervals(Traffico su una polilinea)
  • routes.legs.travelAdvisory.speedReadingIntervals(Traffico su una polilinea)

Cosa devo fare?

Per ricevere i campi di risposta per le informazioni sui pedaggi, il consumo di carburante o il traffico su una polilinea, devi impostare il nuovo campo dell'array di richiesta, extraComputations, in modo che includa uno o più dei seguenti valori: