Esegui la migrazione dalla versione di anteprima

L'API Routes è stata rilasciata in anteprima pubblica (pre-release) a 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 Preview alla release GA.

Nuove funzionalità aggiunte alla release GA

La release GA aggiunge le seguenti nuove funzionalità non incluse nella versione Preview:

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

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

      Le stringhe di indirizzi sono spesso il modo in cui un utente inserisce un indirizzo. Tuttavia, {product_name} deve prima geocodificare internamente la stringa dell'indirizzo per convertirla in coordinate di latitudine/longitudine prima di poter calcolare un itinerario.

      Inoltre, è stato aggiunto il supporto per il parametro di richiesta regionCode, che consente di specificare la restituzione di risultati geocodificati per una specifica regione geografica.

    • Plus Code

      I plus code sono come gli indirizzi stradali per persone o luoghi che non hanno un indirizzo reale. I plus code si basano su latitudine e longitudine e vengono visualizzati come numeri e lettere, anziché come indirizzi con nomi e numeri di strade.

  • La risposta di calcolo dei percorsi ora contiene l'array geocodingResults. 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à in GA aggiungendo il nuovo campo array extraComputations alla richiesta:

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

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

Che cosa devo sapere?

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

  • travelAdvisory.tollInfo (informazioni sui pedaggi)

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

  • routes.legs.travelAdvisory.tollInfo(Informazioni pedaggio)
  • routes.travelAdvisory.tollInfo(Informazioni pedaggio)
  • routes.travelAdvisory.fuelConsumptionMicroliters(consumo di carburante)
  • routes.travelAdvisory.speedReadingIntervals(Traffico su un polilinea)
  • routes.legs.travelAdvisory.speedReadingIntervals(Traffico su un polilinea)

Che cosa devo fare?

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