Esegui la migrazione dalla versione di anteprima

L'API Routes è stata rilasciata come Anteprima pubblica (pre-GA) a settembre 2022. Le Offerte pre-GA sono regolate dai Termini di servizio specifici per 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 versione GA aggiunge le seguenti nuove funzionalità che non sono state incluse nell'anteprima:

  • Oltre agli ID luogo e alle coordinate di latitudine/longitudine, ora puoi specificare una località nella versione 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 geocodificare internamente la stringa dell'indirizzo per convertirla in coordinate di latitudine/longitudine prima di poter calcolare un percorso.

      È stato inoltre aggiunto il supporto per il parametro di richiesta regionCode, che ti consente di specificare di restituire risultati geocodificati per una determinata regione geografica.

    • Plus Code

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

  • La risposta delle route di calcolo ora contiene l'array geocodingResults. Per ogni località nella richiesta (origine, destinazione o tappa intermedia) specificata come stringa indirizzo o Plus Code, l'API esegue una ricerca 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 coordinate di latitudine/longitudine vengono ignorate.

Modifiche alle funzionalità in anteprima esistenti

Ora devi abilitare esplicitamente le seguenti funzionalità in GA aggiungendo alla richiesta il nuovo campo extraComputations dell'array:

Nella versione di anteprima, utilizzavi una maschera di campo per specificare di restituire informazioni per queste funzionalità nella risposta. A questo punto, dovete:

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

Cosa devo sapere?

I seguenti campi non saranno più inclusi nelle risposte ComputeRouteMatrix, a meno che non vengano abilitati esplicitamente impostando extraComputations:

  • travelAdvisory.tollInfo (informazioni a pagamento)

I seguenti campi non saranno più inclusi nelle risposte ComputeRoutes, a meno che non vengano abilitati esplicitamente tramite l'impostazione extraComputations:

  • routes.legs.travelAdvisory.tollInfo(Info pedaggi)
  • routes.travelAdvisory.tollInfo(Info 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 richieste, extraComputations, in modo da includere uno o più dei seguenti valori: