Panoramica dell'API Roads

Roads API è un servizio che accetta richieste HTTPS con coordinate di latitudine/longitudine per uno o più punti su una mappa. Utilizza questi punti per trovare tratti di strada nelle vicinanze e restituisce un ID luogo, oltre ai metadati quali il tratto di strada più vicino e i limiti di velocità.

Perché utilizzare l'API Roads

Con l'API Roads, puoi ottenere i limiti di velocità, i tempi di arrivo stimati o altri metadati relativi alle strade. Con questi metadati relativi alle strade, puoi migliorare le tue app per la guida con le seguenti funzionalità:

  • Collega le coordinate di latitudine/longitudine con una strada o delle strade.
  • Trova la strada più vicina per un insieme di coordinate
  • Ottenere limiti di velocità per i tratti di strada

Cosa puoi fare con l'API Roads

Con Roads API puoi mappare le coordinate GPS alla geometria della strada e determinare il limite di velocità lungo i tratti di strada.

  • Allinea a strade Questo servizio restituisce le strade percorse più probabilmente in base all'insieme di coordinate GPS fornite. Puoi specificare fino a 100 punti GPS raccolti lungo un percorso. Se vuoi, puoi anche richiedere che il servizio interpoli punti aggiuntivi, risultando in un percorso che segue con precisione la geometria della strada.
  • Strade più vicine Questo servizio restituisce il tratto di strada più vicino per un punto GPS. Puoi specificare fino a 100 punti GPS. I punti specificati non devono necessariamente far parte di un percorso continuo.
  • Limiti di velocità: questo servizio restituisce il limite di velocità pubblicato per un tratto di strada. Il servizio Limite di velocità è disponibile per tutti i clienti con una licenza Asset Tracking. Per i clienti con piano Premium di Google Maps Platform che hanno effettuato la transizione ai prezzi con pagamento a consumo, la funzionalità rimane attiva.

Come funziona l'API Roads

L'API Roads utilizza tre endpoint che accettano le coordinate di latitudine/longitudine o ID posizione per fornire dati relativi a percorsi, segmenti o limiti di velocità. L'esempio seguente mostra una richiesta di strade più vicine in base a un insieme di coordinate di latitudine/longitudine:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

Risorse

La tabella seguente riepiloga le risorse disponibili tramite l'API Roads e i dati che restituisce.

Risorse di dati Dati restituiti Formato restituito
Allinea alle strade

Restituisce una matrice fino a 100 punti GPS da un percorso. Include le coordinate di longitudine e latitudine definite tramite l'indicazione stradale insieme agli ID dei luoghi. Per ulteriori dettagli, consulta Risposte nella guida Allinea alle strade.

  • JSON
Strade più vicine

Un array di massimo 100 coordinate di latitudine/longitudine indipendenti con ID luogo per la strada più vicina per ciascun punto specificato. I punti non devono essere continui. Visualizza i dettagli in Risposte nella guida Strade più vicine.

Limiti di velocità

Un array di massimo 100 elementi di metadati di strade. Questi contengono limiti di velocità e ID luogo con unità in KPH o MPH. Per informazioni dettagliate, consulta Risposte nella guida sui limiti di velocità.

Come utilizzare l'API Roads

1 Prova la demo da agganciare a strade Fai clic sulla demo per creare una traccia e scoprire in che modo l'endpoint Snap to Road fornisce dati senza problemi. Vedi Demo nella guida Allinea alle strade. Non è necessaria una chiave API.
2 Configurazione Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione che seguono, quindi scopri come utilizzare la chiave API.
3 Prova a inviare una richiesta a scatto Usa uno degli esempi di agganciamento alle strade e provane uno pertinente al tuo caso d'uso.
4 Scopri i limiti di velocità per il tuo percorso stradale Utilizzando gli stessi dati del percorso che hai fornito per la richiesta di agganciamento alle strade, esegui una query sul limite di velocità. Visualizza la Richiesta di esempio che utilizza un percorso.
5 Scopri come elaborare i percorsi lunghi Segui le sezioni sull'elaborazione di percorsi lunghi nella guida sui concetti avanzati.
6 Incorpora i dati relativi alle strade nella tua app. Visualizza l'esempio di codice dettagliato della demo agganciata sulla strada per iniziare a raccogliere le funzionalità dei dati stradali nella tua app.

Librerie client disponibili

Chiama questa API nel linguaggio che preferisci tramite una delle seguenti librerie client:

Il client Java, il client Python, il client Go e il client Node.js per i servizi Google Maps sono librerie client supportate dalla community, open source in base alla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare le istruzioni di installazione e il codice campione.

Passaggi successivi