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 l'API Roads

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

  • Collega le coordinate di latitudine/longitudine a una strada o a più strade.
  • Trovare la strada più vicina per un insieme di coordinate
  • Visualizzare i limiti di velocità per i tratti stradali

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 stradali.

  • Allineamento alle strade Questo servizio restituisce le strade percorse più probabili in base all'insieme di coordinate GPS fornito. Puoi specificare fino a 100 punti GPS raccolti lungo un percorso. Se vuoi, puoi anche richiedere al servizio di interpolare punti aggiuntivi, in modo da ottenere un percorso che segua senza problemi la geometria della strada.
  • Strada più vicina 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à registrato per un tratto di strada. Il servizio Limite di velocità è disponibile per tutti gli abbonati con una licenza Asset Tracking. Per i clienti del piano Premium di Google Maps Platform che hanno eseguito la transizione al prezzo di pagamento a consumo, la funzionalità rimane attiva.

Come funziona l'API Roads

L'API Strade utilizza tre endpoint che accettano coordinate di latitudine/longitudine o ID luogo per fornire percorsi stradali, tratti o dati sui 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 l'API Roads e i dati restituiti.

Risorse di dati Dati restituiti Formato di reso
Allineamento alle strade

Restituisce un array di massimo 100 punti GPS da un percorso. Sono incluse le coordinate di longitudine/latitudine con snap alla strada insieme agli ID luogo. Consulta i dettagli in Risposte nella guida Allineamento alle strade.
  • JSON
Strade più vicine

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

Un array di massimo 100 elementi di metadati stradali. Questi contengono limiti di velocità e ID luogo, con unità in km/h o mph. Consulta i dettagli in Risposte nella guida Limiti di velocità.

Come utilizzare l'API Roads

1 Prova la demo di adeguamento alle strade Fai clic sulla demo per creare una traccia e vedere come l'endpoint di adeguamento alle strade fornisce dati uniformi. Consulta la demo nella guida Aggancio alle strade. Non è necessaria una chiave API.
2 Configurazione Per iniziare, consulta la sezione Configurare il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito, quindi scopri come utilizzare la chiave API.
3 Prova a inviare una richiesta di adeguamento alle strade Utilizza uno degli esempi di aggancio alle strade e provane uno pertinente al tuo caso d'uso.
4 Visualizzare i limiti di velocità per il percorso stradale Utilizzando gli stessi dati del percorso che hai fornito per la richiesta di adeguamento alle strade, effettua una query sul limite di velocità. Consulta l'esempio di richiesta che utilizza un percorso.
5 Scopri come elaborare percorsi lunghi Segui le sezioni su 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 scatti stradali per iniziare a integrare la funzionalità dei dati stradali nella tua app.

Librerie client disponibili

Chiama questa API nella lingua di tua scelta 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 ai sensi della licenza Apache 2.0. Scaricali da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice di esempio.

Passaggi successivi