L'API Routes offre prestazioni migliori per il calcolo di indicazioni stradali, distanza e tempo di percorrenza, pertanto vale la pena sostituire le app che attualmente utilizzano l'API Directions e l'API Distance Matrix. Gran parte delle funzionalità dell'API Routes è compatibile con le versioni precedenti sia con l'API Directions che con l'API Distance Matrix.
Utilizza questa guida per comprendere le principali differenze nell'API Routes rispetto ai prodotti che sostituisce, nonché per capire come gestire le modifiche necessarie. Per maggiori 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 di richieste
| API Routes |
|
| API Distance Matrix |
|
Risposte alle richieste più rapide
La funzionalità di calcolo della matrice delle route offre i seguenti miglioramenti della latenza:
- Ricevi elementi di flusso della risposta prima del calcolo dell'intera matrice.
- Utilizza le maschere dei campi per personalizzare i dettagli della risposta, richiedendo solo i dati necessari, una best practice che aiuta anche a ridurre i costi.
- Calcoli dei percorsi migliorati per il traffico, in modo da trovare un compromesso tra qualità dei dati e tempo di risposta.
Miglioramenti al routing
La funzionalità delle route di computing offre i seguenti miglioramenti per il routing:
- Informazioni sui pedaggi, oltre alla distanza e all'orario di arrivo stimato.
- Percorsi per veicoli a 2 ruote.
- Verifica la sicurezza delle tappe.
- 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 devi specificare quali campi restituire, riducendo i tempi di elaborazione e gli addebiti.
| API Routes | Le richieste devono utilizzare una maschera dei campi per specificare quali campi devono essere restituiti nella risposta. Il mascheramento dei campi evita di richiedere dati non necessari, evitando così tempi di elaborazione e addebiti di fatturazione non necessari.
Per maggiori informazioni, consulta Scegliere i campi da restituire. |
| API Directions API Distance Matrix |
Restituisce un elenco predefinito di campi, anche se l'app non ne ha bisogno. Ciò può comportare tempi di elaborazione e addebiti di fatturazione non necessari. |
Calcoli avanzati delle route 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 la qualità e la latenza.
TRAFFIC_UNAWARE (predefinita) |
Per calcolare il percorso, utilizza i dati sul traffico medi indipendenti dal tempo e non i dati sul traffico in tempo reale, con una 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 notevolmente la latenza.
Questa impostazione è una novità anche per l'API Routes senza
equivalenti nell'API Directions o nell'API
Distance Matrix.
|
TRAFFIC_AWARE_OPTIMAL |
Dati sul traffico completi e di alta qualità. Questa impostazione produce la massima latenza ed equivale all'impostazione departure_time nell'API Directions e nell'API Distance Matrix. Questa preferenza equivale alla modalità utilizzata da maps.google.com e dall'app mobile Google Maps. |
Confronto del calcolo delle route
La tabella seguente mette a confronto le opzioni di routing tra i servizi API Routes e API Directions e API Distance Matrix.
| Opzione Traffico | API Routes | API Directions API Distance Matrix |
Latenza |
|---|---|---|---|
| Assenza di traffico in tempo reale | TRAFFIC_UNAWARE |
Proprietà departure_time non impostata |
Latenza massima delle tre modalità. |
| Condizioni del traffico in tempo reale applicate | TRAFFIC_AWARE |
Nessun equivalente | Nuova modalità aggiunta dall'API Routes. Fornisce una latenza leggermente maggiore rispetto a Ha una latenza molto più bassa rispetto a |
| Dati sul traffico in tempo reale completi e di alta qualità applicati | TRAFFIC_AWARE_OPTIMAL |
departure_time insieme di proprietà |
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 servizio invece di due
| API Routes | Abilita un solo servizio nella console API per consentire alla tua app di utilizzare Compute Routes e Compute Route Matrix.
Per maggiori informazioni, consulta la sezione Configurazione nella console API di Google. |
| API Directions API Distance Matrix |
Abilita due servizi: API Directions e 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 all'interno di una richiesta HTTP POST. Per alcuni esempi, consulta: - Calcola una route - Calcola una matrice di route |
| API Directions API Distance Matrix |
Trasmetti i parametri URL utilizzando una richiesta HTTP GET. |
Differenze nella risposta all'orario di arrivo stimato
L'API Routes restituisce l'orario di arrivo stimato e utilizza la proprietà di risposta duration
in modo diverso rispetto ai servizi API Directions e
Distance Matrix, come mostrato nella tabella di seguito.
| Tipo di orario di arrivo stimato | API Routes | API Directions API Distance Matrix |
|---|---|---|
| Orario di arrivo stimato non consapevole e indipendente dal tempo. | Impostato utilizzando
|
Corrisponde a
|
| Orario di arrivo stimato che tiene conto del traffico in tempo reale. | Impostalo utilizzando
|
Impostato utilizzando
|
Tappe polilinea
Con questo servizio, non è più necessario convertire le coordinate di latitudine/longitudine in waypoint di polilinee. Questo servizio supporta un corpo della richiesta POST e non è più interessato dai limiti delle stringhe di URL. Alcuni utenti dell'API Distance Matrix hanno risolto il problema relativo ai limiti per le richieste convertendo i punti di latitudine/longitudine in tappe delle polilinee.
Indirizzi formattati (codici geografici invertiti)
L'API Routes non ha fornito 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 percorso non specifica una modalità di viaggio. Tuttavia, quando una richiesta specifica una modalità di viaggio per una route, 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 utilizzi la funzionalità, in modo da consentirci di contattarti.
XML come formato di risposta
L'API Routes non fornisce XML come formato di risposta. online puoi trovare una serie di convertitori da JSON a XML adatti ai tuoi scopi.