Perché eseguire la migrazione all'API Routes?

Sviluppatori dello Spazio economico europeo (SEE)

L'API Routes offre prestazioni migliori per il calcolo di indicazioni stradali, distanza e tempo di percorrenza, il che rende utile sostituire le app che utilizzano l'API Directions e l'API Distance Matrix. La maggior parte delle funzionalità dell'API Routes è compatibile con le versioni precedenti dell'API Directions e dell'API Distance Matrix.

Utilizza questa guida per comprendere le principali differenze tra l'API Routes e i prodotti che sostituisce, nonché come gestire le modifiche necessarie. Per ulteriori dettagli su altre funzionalità dell'API Routes, consulta la panoramica del prodotto.

Miglioramenti principali

Questa sezione illustra alcuni dei miglioramenti che puoi aspettarti quando utilizzi l'API Routes nelle tue app.

Aumento dei limiti delle richieste

API Routes Compute Route Matrix
  • Massimo 625 elementi, a meno che tu non specifichi TRAFFIC_AWARE_OPTIMAL.
  • Massimo 100 elementi con TRAFFIC_AWARE_OPTIMAL. Vedi Preferenze di routing avanzate.
  • Un massimo di 50 waypoint (origini + destinazioni) utilizzando un ID luogo.
API Distance Matrix
  • Massimo 25 origini o 25 destinazioni per richiesta.
  • Massimo 100 elementi (numero di origini × numero di destinazioni) per richiesta lato server.

Risposte più rapide alle richieste

La funzionalità Calcola matrice di itinerari offre i seguenti miglioramenti della latenza:

  • Ricevi gli elementi di streaming della risposta prima che l'intera matrice sia stata calcolata.
  • Utilizza le maschere dei campi per personalizzare i dettagli della risposta, richiedendo solo i dati di cui hai bisogno. Questa best practice ti aiuta anche a ridurre i costi.
  • Calcoli del percorso migliorati per il traffico, in modo da poter trovare il giusto compromesso tra qualità dei dati e tempo di risposta.

Miglioramenti del routing

La funzionalità Calcola percorso offre questi miglioramenti del routing:

  • Informazioni sui pedaggi, oltre a distanza e orario di arrivo stimato.
  • Percorsi per veicoli a 2 ruote.
  • Qualifica i tuoi waypoint di sosta per la sicurezza.
  • Maggiore precisione dell'orario di arrivo stimato impostando la direzione di marcia e il lato della strada per le tappe.

Richiedi solo i dati di cui hai bisogno

Ora puoi specificare i campi da restituire, riducendo i tempi di elaborazione e gli addebiti di fatturazione.

API Routes
Compute Routes
Compute Route Matrix 		Le richieste devono utilizzare una maschera di campo per specificare i campi che vuoi che vengano restituiti nella risposta. Il mascheramento dei campi garantisce di non richiedere dati non necessari, il che evita tempi di elaborazione e addebiti di fatturazione non necessari.
Per ulteriori informazioni, vedi Scegliere i campi da restituire.
API Directions
API Distance Matrix 		Restituisce un elenco predefinito di campi, anche se la tua app non ne ha strettamente bisogno. Ciò può comportare tempi di elaborazione e addebiti di fatturazione non necessari.

Calcoli avanzati del percorso per il traffico

L'API Routes supporta tre preferenze di routing che puoi utilizzare per bilanciare la latenza della risposta e la qualità dei dati quando richiedi informazioni sul traffico.

Per saperne di più, consulta Configurare la qualità rispetto alla latenza.

TRAFFIC_UNAWARE
(predefinito)		 Utilizza dati sul traffico medi indipendenti dal tempo, non dati sul traffico in tempo reale, per calcolare il percorso, con conseguente latenza di risposta più bassa. Questa impostazione equivale a quando il traffico non viene utilizzato nell'API Directions e nell'API Distance Matrix.
TRAFFIC_AWARE
(novità)		 Qualità del traffico in tempo reale ottimizzata per le prestazioni per una latenza ridotta. A differenza di TRAFFIC_AWARE_OPTIMAL, questa impostazione applica ottimizzazioni per ridurre significativamente la latenza. Questa impostazione è nuova anche per l'API Routes e non ha un equivalente nell'API Directions o nell'API Distance Matrix.
TRAFFIC_AWARE_OPTIMAL Dati sul traffico completi e di alta qualità. Questa impostazione produce la latenza più elevata ed è equivalente all'impostazione departure_time nell'API Directions e nell'API Distance Matrix.
Questa preferenza è equivalente alla modalità utilizzata da maps.google.com e dall'app mobile Google Maps.

Confronto del calcolo del percorso

La tabella seguente confronta le opzioni di routing tra l'API Routes e i servizi API Directions e API Distance Matrix.

Opzione di traffico API Routes API Directions
API Distance Matrix		 Latenza
Nessun traffico in tempo reale TRAFFIC_UNAWARE departure_time proprietà non impostata La latenza più bassa delle tre modalità.
Condizioni del traffico in tempo reale applicate TRAFFIC_AWARE Nessun equivalente

Nuova modalità aggiunta dall'API Routes. Offre una latenza leggermente maggiore rispetto a TRAFFIC_UNAWARE con un piccolo costo per la qualità dell'ETA.

Ha una latenza molto inferiore rispetto a TRAFFIC_AWARE_OPTIMAL.
Dati sul traffico in tempo reale completi e di alta qualità applicati TRAFFIC_AWARE_OPTIMAL departure_time insieme di proprietà

Equivalente alla modalità utilizzata da maps.google.com e dall'app mobile Google Maps.

Per Compute Route Matrix, il numero di elementi in una richiesta (numero di origini × numero di destinazioni) non può superare 100.

Differenze principali

Questa sezione illustra le principali differenze tra l'API Routes e i servizi che sostituisce, nonché i modi in cui puoi risolvere queste differenze durante la migrazione da questi servizi nelle tue app esistenti.

Chiamare un solo servizio anziché due

API Routes Attiva un solo servizio nella console API per la tua app per utilizzare Compute Routes e Compute Route Matrix.
Per saperne di più, vedi Configurazione nella console API di Google.
API Directions
API Distance Matrix 		Attiva due servizi: l'API Directions e l'API Distance Matrix come servizi separati nella console API.

Utilizza HTTPS POST richieste

API Routes Passa i parametri nel corpo della richiesta o nelle intestazioni nell'ambito di una richiesta HTTP POST.
Per esempi, vedi:
- Calcolare un percorso
- Calcolare una matrice di percorsi
API Directions
API Distance Matrix 		Trasmetti i parametri URL utilizzando una richiesta HTTP GET.

Differenze nelle risposte al tempo stimato di arrivo

L'API Routes restituisce l'ETA e utilizza la proprietà di risposta duration in modo diverso rispetto ai servizi API Directions e Distance Matrix, come mostrato nella tabella seguente.

Tipo di ATE API Routes API Directions
API Distance Matrix
Orario di arrivo stimato indipendente dal traffico e dal tempo.

Imposta utilizzando TRAFFIC_UNAWARE.

  • L'ETA contenuta nella proprietà di risposta duration.
  • Le proprietà di risposta duration e staticDuration contengono lo stesso valore.

Corrisponde a departure_time non impostato nella richiesta.

  • L'ETA contenuta nella proprietà di risposta duration.
  • La proprietà di risposta duration_in_traffic non viene restituita.
Orario di arrivo stimato che tiene conto del traffico in tempo reale.

Imposta utilizzando TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL.

  • L'ETA che tiene conto del traffico in tempo reale è contenuta nella proprietà di risposta duration.
  • La proprietà di risposta staticDuration contiene la durata del viaggio lungo l'itinerario senza prendere in considerazione le condizioni del traffico.
  • La proprietà duration_in_traffic non viene più restituita.

Imposta l'utilizzo di departure_time nella richiesta.

  • L'ETA che tiene conto del traffico in tempo reale è contenuta nella proprietà di risposta duration_in_traffic.

Tappe della polilinea

Con questo servizio, che supporta un corpo della richiesta POST e quindi non è più soggetto ai limiti delle stringhe URL, non è più necessario convertire le coordinate di latitudine/longitudine in waypoint polilineari. Alcuni utenti dell'API Distance Matrix hanno risolto il problema dei limiti delle richieste convertendo i punti di latitudine/longitudine in waypoint polilineari.

Indirizzi formattati (geocodifica inversa)

L'API Routes non fornisce indirizzi formattati nella risposta. Per ottenere indirizzi formattati, utilizza l'API Geocoding, creata per questo caso d'uso e che fornisce risultati di qualità superiore.

Modalità di viaggio disponibili

Come nel caso dell'API Directions, l'API Routes utilizza DRIVE come modalità predefinita quando una richiesta di itinerario non specifica una modalità di viaggio. Tuttavia, quando una richiesta specifica una modalità di viaggio per un percorso, l'API Routes non restituisce un array di modalità di viaggio disponibili come scelte alternative per la richiesta. Se il tuo caso d'uso si basa su questa funzionalità,segnala un problema descrivendo come la utilizzi, in modo che possiamo approfondire la questione.

XML come formato della risposta

L'API Routes non fornisce XML come formato di risposta. Puoi trovare online diversi convertitori da JSON a XML che dovrebbero fare al caso tuo.