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 i tratti stradali nelle vicinanze e restituisce un ID luogo insieme ai metadati, come il tratto stradale più vicino e i limiti di velocità.

Perché utilizzare Roads API

Con l'Roads API, puoi ottenere limiti di velocità, orari di arrivo stimati o altri metadati stradali. Con questi metadati stradali, puoi migliorare le tue app di guida con le seguenti funzionalità:

  • Collegare le coordinate di latitudine/longitudine a una o più strade.
  • Trova la strada più vicina per un insieme di coordinate
  • Ottieni i limiti di velocità per i tratti di strada

Cosa puoi fare con Roads API

Con l'Roads API, puoi mappare le coordinate GPS alla geometria della strada e determinare il limite di velocità lungo i segmenti stradali.

  • Posizionamento su strada Questo servizio restituisce le strade più probabili percorse in base all'insieme di coordinate GPS fornite. Puoi specificare fino a 100 punti GPS raccolti lungo un percorso. Facoltativamente, puoi anche richiedere che il servizio interpoli punti aggiuntivi, ottenendo un percorso che segue agevolmente la geometria della strada.
  • Nearest Roads Questo servizio restituisce il segmento stradale 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 stradale. Il servizio Limite di velocità è disponibile per tutti i clienti con una licenza Asset Tracking. Per i clienti del piano Premium di Google Maps Platform che sono passati ai prezzi con pagamento a consumo, la funzionalità rimane attiva.

Come funziona Roads API

L'Roads API utilizza tre endpoint che accettano coordinate di latitudine/longitudine o ID luogo per fornire dati su percorsi stradali, segmenti o limiti di velocità. L'esempio seguente mostra una richiesta per le 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 riassume le risorse disponibili tramite Roads API insieme ai dati restituiti.

Risorse di dati Dati restituiti Formato di reso
Posizionamento su strada

Restituisce un array di un massimo di 100 punti GPS di un percorso. Include le coordinate di longitudine/latitudine agganciate alla strada insieme agli ID luogo. Per maggiori dettagli, consulta Risposte nella guida Posizionamento su strada.
  • JSON
Nearest Roads

Un array di un massimo di 100 coordinate di latitudine/longitudine indipendenti, insieme agli ID luogo della strada più vicina per ogni punto specificato. I punti non devono essere continui. Per maggiori dettagli, consulta Risposte nella guida Strade più vicine.
Limiti di velocità

Un array di massimo 100 elementi di metadati stradali. Questi contengono i limiti di velocità e gli ID luogo, con unità di misura in km/h o mph. Per i dettagli, consulta la sezione Risposte della guida Limiti di velocità.

Come utilizzare Roads API

1 Prova la demo di posizionamento su strada Fai clic sulla demo per creare un percorso e vedere in che modo l'endpoint di posizionamento su strada fornisce dati fluidi. Consulta la demo nella guida Posizionamento su strada. Non è necessaria una chiave API.
2 Configurazione Inizia con Configura il progetto cloud Google e completa le istruzioni di configurazione riportate di seguito, quindi scopri come utilizzare la chiave API.
3 Prova una richiesta di posizionamento su strada Utilizza uno degli esempi di posizionamento su strada e prova quello pertinente al tuo caso d'uso.
4 Ottieni i limiti di velocità per il tuo percorso stradale Utilizzando gli stessi dati del percorso forniti per la richiesta di posizionamento su strada, invia una query sui limiti di velocità. Consulta la richiesta di esempio che utilizza un percorso.
5 Scopri come elaborare i percorsi lunghi Segui le sezioni relative all'elaborazione di percorsi lunghi nella guida Concetti avanzati.
6 Incorpora i dati stradali nella tua app. Consulta l'esempio di codice dettagliato della demo di aggancio alla strada per iniziare a integrare la funzionalità dei dati stradali nella tua app.

Librerie client disponibili

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

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

Passaggi successivi