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 l'API Directions e l'API Distance Matrix. La maggior parte delle funzionalità dell'API Routes è retrocompatibile sia con l'API Directions sia con l'API Distance Matrix.
Utilizza questa guida per comprendere le differenze principali nell'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 alle richieste più rapide
La funzionalità Compute Route Matrix offre i seguenti miglioramenti della latenza:
- Ricevi elementi di 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 del percorso migliorati per il traffico, in modo da poter trovare il giusto compromesso tra qualità dei dati e tempo di risposta.
Miglioramenti dell'indirizzamento
La funzionalità Compute Route offre questi miglioramenti dell'indirizzamento:
- Informazioni sui pedaggi oltre a distanza e orario di arrivo stimato.
- Percorsi per veicoli a due ruote.
- Qualifica i waypoint di sosta 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 richieste devono utilizzare una maschera di campo per specificare i campi che vuoi
restituiti nella risposta. La maschera di campo garantisce che non vengano richiesti
dati non necessari, evitando tempi di elaborazione e addebiti di fatturazione
non necessari.
Per saperne di più, 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 strettamente bisogno. Ciò può comportare tempi di elaborazione e addebiti di fatturazione non necessari. |
Calcoli del percorso migliorati per il traffico
L'API Routes supporta tre preferenze di indirizzamento 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 (predefinita) |
Utilizza i dati sul traffico medi indipendenti dal tempo dati, non i dati sul traffico in tempo reale, per calcolare il percorso, con conseguente latenza di risposta più bassa. 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 significativamente la latenza.
Questa impostazione è nuova anche per l'API Routes e non ha
equivalenti 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 indirizzamento tra l'API Routes e i servizi API Directions e API Distance Matrix.
| Opzione relativa al traffico | API Routes | API Directions API Distance Matrix |
Latenza |
|---|---|---|---|
| Nessun traffico in tempo reale | TRAFFIC_UNAWARE |
Proprietà departure_time non impostata |
Latenza più rapida 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 |
Proprietà departure_time impostata |
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 differenze principali 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 app esistenti.
Chiama un servizio anziché due
| API Routes | Abilita un solo servizio nella console API affinché la tua app
possa utilizzare Compute Routes e Compute Route Matrix.
Per saperne di più, consulta 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 le richieste HTTPS POST
| API Routes | Trasmetti i parametri nel corpo della richiesta o in
intestazioni come parte 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 nella risposta dell'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 orario di arrivo stimato | API Routes | API Directions API Distance Matrix |
|---|---|---|
| Orario di arrivo stimato indipendente dal tempo e dal traffico. | Impostato utilizzando
|
Corrisponde a
|
| Orario di arrivo stimato che tiene conto del traffico in tempo reale. | Impostato utilizzando
|
Impostato utilizzando
|
Waypoint polilinea
Con questo servizio non è più necessario convertire le coordinate di latitudine/longitudine in waypoint polilinea, che supporta un corpo della richiesta POST e quindi non è più influenzato dai 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 waypoint polilinea.
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 la utilizzi, in modo che possiamo seguirti.
XML come formato di risposta
L'API Routes non fornisce XML come formato di risposta. Online puoi trovare diversi convertitori da JSON a XML che dovrebbero soddisfare le tue esigenze.