L'API Routes offre prestazioni migliorate per il calcolo di indicazioni stradali, distanza e tempi di percorrenza, il che rende utile sostituire le app che attualmente utilizzano l'API Directions e l'API Distanza Matrix. Gran parte della funzionalità dell'API Routes è compatibile con le versioni precedenti sia con l'API Directions che con l'API Distanza Matrix.
Utilizza questa guida per comprendere le principali differenze nell'API Routes rispetto ai prodotti che sostituisce e 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.
Limiti delle richieste aumentati
| API Routes |
|
| API Distance Matrix |
|
Risposte alle richieste più rapide
La funzionalità della matrice delle route di calcolo offre i seguenti miglioramenti della latenza:
- Ricevi gli elementi di flusso della risposta prima che venga calcolata l'intera matrice.
- Utilizza le maschere dei campi per personalizzare i dettagli della risposta, richiedendo solo i dati necessari, una best practice che consente anche di ridurre i costi.
- Calcoli delle route migliorati per il traffico, per consentirti di trovare un compromesso tra qualità dei dati e tempi di risposta.
Miglioramenti al routing
La funzionalità delle route di computing offre i seguenti miglioramenti relativi al routing:
- Informazioni sui pedaggi, oltre a distanza e orario di arrivo stimato.
- Percorsi per veicoli a due ruote.
- Qualifica i tuoi punti di sosta per motivi di sicurezza.
- Maggiore precisione dell'orario di arrivo stimato impostando la direzione di viaggio e il lato della strada per i pointpoint.
Richiedere solo i dati di cui hai bisogno
Ora devi specificare quali campi restituire, riducendo i tempi di elaborazione e i costi di fatturazione.
| API Routes | Le tue richieste devono utilizzare una maschera dei campi per specificare quali campi vuoi che vengano restituiti nella risposta. Il mascheramento dei campi garantisce di non richiedere dati non necessari, evitando inutili tempi di elaborazione e addebiti di fatturazione.
Per maggiori informazioni, consulta Scegliere i campi da restituire. |
| API Directions API Distanza Matrix |
Restituisce un elenco predefinito di campi, anche se non sono strettamente necessari all'app. Ciò può comportare tempi di elaborazione e addebiti superflui. |
Calcoli delle route migliorati per il traffico
L'API Routes supporta tre preferenze di routing che puoi utilizzare per bilanciare la latenza di risposta e la qualità dei dati quando richiedi informazioni sul traffico.
Per ulteriori informazioni, consulta Configurare qualità e latenza.
TRAFFIC_UNAWARE (predefinita) |
Per calcolare la route, utilizza dati sul traffico medi indipendenti dal tempo, e non dati sul traffico in tempo reale, con conseguente latenza di risposta più bassa. Questa impostazione equivale a quando il traffico non viene utilizzato nell'API Directions e nell'API Distanza 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 in modo significativo la latenza.
Questa impostazione è nuova anche per l'API Routes, senza
equivalenti nell'API Directions o
nell'API Distanza Matrix.
|
TRAFFIC_AWARE_OPTIMAL |
Dati sul traffico completi e di alta qualità. Questa impostazione produce la massima latenza ed è equivalente all'impostazione departure_time nell'API Directions e nell'API Distanza Matrix. Questa preferenza equivale alla modalità utilizzata da maps.google.com e dall'app mobile Google Maps. |
Confronto calcolo route
La seguente tabella confronta le opzioni di routing tra i servizi dell'API Routes, dell'API Directions e dell'API Distanza Matrice.
| Opzione traffico | API Routes | API Directions API Distanza Matrice |
Latenza |
|---|---|---|---|
| Nessun traffico in tempo reale | TRAFFIC_UNAWARE |
Proprietà departure_time non impostata |
Latenza più veloce tra le 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 Ha una latenza molto inferiore rispetto a |
| Dati sul traffico in tempo reale completi e di alta qualità | TRAFFIC_AWARE_OPTIMAL |
Proprietà departure_time impostata |
Equivale 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 per risolvere queste differenze quando esegui la migrazione da questi servizi nelle tue app esistenti.
Chiama un solo servizio invece di due
| API Routes | Abilita un solo servizio nella console API per la tua app per utilizzare Compute Routes e Compute Route Matrix.
Per ulteriori informazioni, consulta Configurazione nella console API di Google. |
| API Directions API Distanza Matrice |
Abilita due servizi: l'API Directions e l'API Distance Matrix come servizi separati nella console API. |
Utilizza HTTPS POST richieste
| API Routes | Trasmetti parametri nel corpo della richiesta o nelle
intestazioni come parte di una richiesta HTTP POST. Per alcuni esempi, consulta: - Calcolare una route - Calcolare una matrice di route |
| API Directions API Distanza Matrice |
Trasmetti i parametri URL utilizzando una richiesta HTTP GET. |
Differenze nella risposta dell'orario di arrivo stimato
L'API Routes restituisce l'orario di arrivo stimato e utilizza la proprietà della risposta duration in modo diverso rispetto ai servizi dell'API Directions e dell'API Distanza Matrix, come mostrato nella tabella seguente.
| Tipo di orario di arrivo stimato | API Routes | API Directions API Distanza Matrice |
|---|---|---|
| Orario di arrivo stimato indipendente dal traffico. | Imposta tramite
|
Corrisponde al fatto che
|
| L'orario di arrivo stimato che tiene conto del traffico in tempo reale. | Impostalo utilizzando
|
Imposta il valore utilizzando
|
Waypoint della polilinea
Non è più necessario convertire le coordinate di latitudine/longitudine in Waypoint della polilinea con questo servizio, che supporta il corpo di una richiesta POST e, di conseguenza, non è più interessato dai limiti per le stringhe dell'URL. Alcuni utenti dell'API Distanza Matrix hanno risolto il problema dei limiti delle richieste convertendo i punti di latitudine/longitudine in tappe di una polilinea.
Indirizzi formattati (codifica geografica inversa)
L'API Routes non ha fornito indirizzi formattati nella risposta. Per ottenere indirizzi formattati, utilizza l'API Geocoding, creata per questo caso d'uso, che offre 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 percorso non specifica una modalità di viaggio. Tuttavia, quando una richiesta specifica una modalità di viaggio per una rotta, 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 ricontattarti.
XML come formato di risposta
L'API Routes non fornisce XML come formato di risposta. Puoi trovare online una serie di convertitori da JSON a XML adatti alle tue esigenze.