L'API Routes offre prestazioni migliorate per il calcolo di indicazioni stradali, distanza e tempo di percorrenza, il che rende utile sostituire le app che 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 principali differenze dell'API Routes rispetto ai 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.
Limiti di richiesta aumentati
| API Routes Compute Route Matrix |
|
| API Distance Matrix |
|
Risposte più rapide alle richieste
La funzionalità Compute Route Matrix 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 waypoint delle tappe per la sicurezza.
- Maggiore precisione dell'orario di arrivo stimato impostando la direzione di marcia e il lato della strada per i waypoint.
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 tue richieste devono utilizzare una maschera di campo per specificare i campi che vuoi che vengano restituiti nella risposta. Il mascheramento dei campi assicura di non richiedere
dati non necessari, evitando tempi di elaborazione e addebiti
non necessari.
Per saperne di più, 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 dei percorsi
La tabella seguente confronta le opzioni di routing tra i servizi API Routes, API Directions e API Distance Matrix.
| Opzione 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. Fornisce una
latenza leggermente maggiore rispetto a Ha una latenza molto inferiore rispetto 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 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 affrontare queste differenze durante la migrazione da questi servizi nelle tue app esistenti.
Chiama un servizio anziché 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, 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 |
Passa 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 API Distance Matrix, come mostrato nella tabella seguente.
| Tipo di ETA | API Routes | API Directions API Distance Matrix |
|---|---|---|
| Orario di arrivo stimato indipendente dal traffico. | Imposta utilizzando
|
Corrisponde a
|
| Orario di arrivo stimato che tiene conto del traffico in tempo reale. | Imposta utilizzando
|
Imposta utilizzando
|
Waypoint della polilinea
Con questo servizio non è più necessario convertire le coordinate di latitudine/longitudine in waypoint polilineari, in quanto supporta un corpo della richiesta POST e pertanto non è più soggetto ai limiti delle stringhe URL. Alcuni utenti dell'API Distance Matrix hanno risolto il problema dei limiti delle richieste convertendo i punti di latitudine/longitudine in tappe dell'itinerario polilineare.
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 percorso 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 utilizzi la funzionalità, in modo che possiamo dare seguito alla tua richiesta.
XML come formato della risposta
L'API Routes non fornisce XML come formato di risposta. Puoi trovare diversi convertitori da JSON a XML online che dovrebbero essere adatti ai tuoi scopi.