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 segmenti di strade nelle vicinanze e restituisce un ID luogo insieme a metadati come il tratto di strada più vicino e i limiti di velocità.

Perché utilizzare l'API Roads

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

  • Collega le coordinate di latitudine/longitudine a una o più strade.
  • Trova la strada più vicina per visualizzare un insieme di coordinate
  • Visualizzare i 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 della strada.

  • Allinea a strade Questo servizio restituisce le strade percorse più spesso in base al set di coordinate GPS fornito. Puoi specificare fino a 100 punti GPS raccolti lungo un percorso. Facoltativamente, puoi anche richiedere che il servizio interpola punti aggiuntivi, in modo da creare un percorso che segua facilmente la geometria della strada.
  • Strade più vicine: questo servizio restituisce il segmento 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 di limite di velocità è disponibile per tutti i clienti con una licenza per il monitoraggio degli asset. Per i clienti con un piano Google Maps Platform Premium che sono passati al modello di pagamento a consumo, la funzionalità rimane attiva.

Come funziona l'API Roads

L'API Roads utilizza tre endpoint che accettano coordinate di latitudine/longitudine o ID luogo per fornire percorsi, segmenti o dati sui limiti di velocità. L'esempio seguente mostra una richiesta per le strade più vicine in base a una serie 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 seguente tabella riassume le risorse disponibili tramite l'API Roads e i dati che restituisce.

Risorse di dati Dati restituiti Formato di reso
Allinearsi alle strade

Restituisce un array di massimo 100 punti GPS da un percorso. Include le coordinate di longitudine/latitudine agganciate alla strada insieme agli ID luogo. Consulta i dettagli in Risposte nella guida Allinea alla strada.
  • JSON
Strade più vicine

Un array di fino a 100 coordinate di latitudine/longitudine indipendenti, insieme agli ID luogo della strada più vicina per ogni 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 delle strade. Contengono limiti di velocità e ID luogo con unità espresse in km/h o mph. Consulta i dettagli in Risposte nella guida sui limiti di velocità.

Come utilizzare l'API Roads

1 Prova la demo di posizionamento sulla strada Fai clic sulla demo per creare un percorso e vedere come l'endpoint di posizionamento delle strade fornisce dati fluidi. Vedi Demo nella guida Allinea alla strada. Non è necessaria una chiave API.
2 Configurazione Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito, quindi scopri come utilizzare la chiave API.
3 Prova una richiesta di Allineamento alle strade Utilizza uno degli esempi di posizionamento alle strade e provane uno pertinente al tuo caso d'uso.
4 Visualizzare i limiti di velocità del tuo percorso stradale Utilizzando gli stessi dati di percorso che hai fornito per la richiesta di allineamento alle strade, esegui una query sui limiti di velocità. Consulta la sezione Richiesta di esempio che utilizza un percorso.
5 Scopri come elaborare i percorsi lunghi Segui le sezioni su Elaborazione dei percorsi lunghi nella guida Concetti avanzati.
6 Incorpora i dati stradali nella tua app. Guarda l'esempio di codice dettagliato della demo agganciata alla strada per iniziare a creare la 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 secondo la licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche le istruzioni per l'installazione e il codice di esempio.

Passaggi successivi