L'API Routes offre prestazioni migliorate per il calcolo di indicazioni stradali, distanza e tempo di percorrenza, quindi vale la pena sostituire le app che attualmente utilizzano le API Directions e Distance Matrix. La maggior parte delle funzionalità dell'API Routes è compatibile con le versioni precedenti sia dell'API Directions sia dell'API Distance Matrix.
Utilizza questa guida per comprendere le differenze principali dell'API Routes rispetto ai prodotti che sostituisce, nonché per sapere 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 di richiesta
| API Routes |
|
| API Distance Matrix |
|
Risposte alle richieste più rapide
La funzionalità della matrice di route di calcolo offre i seguenti miglioramenti della latenza:
- Ricevere gli elementi in streaming della risposta prima che l'intera matrice sia stata calcolata.
- Utilizza le maschere di campo per personalizzare i dettagli della risposta, richiedendo solo i dati di cui hai bisogno, una best practice che contribuisce anche a ridurre i costi.
- Calcoli avanzati dei percorsi per il traffico, in modo da poter scegliere tra la qualità dei dati e il tempo di risposta.
Miglioramenti al routing
La funzionalità di route di calcolo offre i seguenti miglioramenti al routing:
- Informazioni sui pedaggi, oltre a distanza e orario di arrivo stimato.
- Percorsi per veicoli a 2 ruote.
- Qualifica i tuoi punti di passaggio 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 il tempo di elaborazione e gli addebiti per la fatturazione.
| API Routes | Le richieste devono utilizzare una maschera di campi per specificare i campi che vuoi
che vengano restituiti nella risposta. La maschera dei campi ti consente di non richiedere
dati non necessari, evitando tempi di elaborazione e costi di fatturazione
non necessari.
Per ulteriori informazioni, consulta Scegliere i campi da restituire. |
| API Directions API Distance Matrix |
Restituisce un elenco predefinito di campi, anche se la tua app non ne ha bisogno obbligatoriamente. Ciò può comportare tempi di elaborazione e costi di fatturazione non necessari. |
Calcoli avanzati dei percorsi per il traffico
L'API Routes supporta tre preferenze di routing che puoi utilizzare per trovare il giusto equilibrio tra la latenza della risposta e la qualità dei dati quando richiedi informazioni sul traffico.
Per ulteriori informazioni, consulta Configurare la qualità rispetto alla latenza.
TRAFFIC_UNAWARE (valore predefinito) |
Utilizza dati di traffico medi indipendenti dal tempo, non dati sul traffico in tempo reale, per calcolare il percorso, con una latenza di risposta minima. Questa impostazione è equivalente 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 è nuova anche per l'API Routes e non ha un corrispondente 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 mette a confronto 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 |
Proprietà departure_time 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. Fornisce una
latenza leggermente superiore rispetto a Ha una latenza molto inferiore a |
| Dati sul traffico in tempo reale completi e di alta qualità applicati | TRAFFIC_AWARE_OPTIMAL |
departure_time set di proprietà |
Equivalente alla modalità utilizzata da maps.google.com e dall'app mobile Google Maps. Per Calcola matrice percorso, il numero di elementi in una richiesta (numero di origini × numero di destinazioni) non può superare 100. |
Differenze principali
Questa sezione illustra le differenze principali tra l'API Routes e i servizi che sostituisce, nonché i modi in cui puoi gestire queste differenze durante la migrazione da questi servizi nelle tue app esistenti.
Chiamare un servizio anziché due
| API Routes | Attiva un solo servizio nella console API per consentire alla tua app di utilizzare Compute Routes e Compute Route Matrix.
Per ulteriori informazioni, vedi Configurazione nella console API di Google. |
| API Directions API Distance Matrix |
Attiva 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 come parte di una richiesta HTTP POST. Per esempi, consulta: - Calcolo di un percorso - Calcolo di una matrice di percorsi |
| API Directions API Distance Matrix |
Passa i parametri URL utilizzando una richiesta HTTP GET. |
Differenze nella risposta relativa al tempo di arrivo stimato
L'API Routes restituisce l'orario di arrivo stimato e utilizza la proprietà di risposta duration diversamente dall'API Directions e dai servizi dell'API Distance Matrix, come mostrato nella tabella seguente.
| Tipo di orario di arrivo stimato | API Routes | API Directions API Distance Matrix |
|---|---|---|
| Orario di arrivo stimato indipendente dal traffico. | Imposta utilizzando
|
Corrisponde a
|
| Orario di arrivo stimato che prende in considerazione il traffico in tempo reale. | Imposta utilizzando
|
Imposta l'utilizzo di
|
Waypoint di polilinee
Con questo servizio, che supporta un corpo della richiesta POST e quindi non è più interessato dai limiti di stringa dell'URL, non è più necessario convertire le coordinate di latitudine/longitudine in waypoint di polyline. Alcuni utenti dell'API Distance Matrix hanno risolto il problema dei limiti di richiesta convertendo i punti di latitudine/longitudine in waypoint polilinea.
Indirizzi formattati (geocodifica inversa)
L'API Routes non fornisce indirizzi formattati nella risposta. Per ottenere indirizzi formattati, utilizza l'API Geocoding, progettata per questo caso d'uso e che fornisce risultati di qualità superiore.
Modalità di viaggio disponibili
Come per l'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 un mezzo di trasporto per un percorso, l'API Routes non restituisce un array di mezzi di trasporto disponibili come scelte alternative per la richiesta. Se il tuo caso d'uso si basa su questa funzionalità,registra un problema descrivendo come la utilizzi, in modo che possiamo contattarti.
XML come formato di risposta
L'API Routes non fornisce XML come formato di risposta. Puoi trovare online diversi convertitori da JSON a XML adatti alle tue esigenze.