Panoramica dell'API Roads

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

Perché utilizzare il Roads API

Con Roads API puoi ottenere limiti di velocità, tempi di arrivo stimati o altri metadati stradali. 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 un insieme di coordinate.
  • Ottieni i limiti di velocità per i segmenti di strada.

Cosa puoi fare con l'Roads API

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

  • Posizionamento su strada Questo servizio restituisce le strade più probabili percorse 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, ottenendo un percorso che segue senza problemi 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 far parte di un percorso continuo.
  • Limiti di velocità Questo servizio restituisce il limite di velocità registrato per un segmento di strada. Il servizio Limite di velocità è disponibile per tutti i clienti con una licenza di monitoraggio degli asset. Per i clienti del piano Premium di Google Maps Platform che hanno eseguito la transizione alla tariffazione con pagamento a consumo, la funzionalità rimane attiva.

Come funziona Roads API

The 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 di strade più vicine basata su 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' Roads API e i dati che restituisce.

Risorse dati Dati restituiti Formato restituito
Snap to Roads

Restituisce un array di massimo 100 punti GPS da un percorso. Include coordinate di longitudine/latitudine allineate alla strada e ID luogo. Per maggiori dettagli, consulta la sezione Risposte nella guida Snap to Roads.
  • JSON
Nearest Roads

Un array di massimo 100 coordinate di latitudine/longitudine indipendenti insieme agli ID luogo per la strada più vicina a ogni punto specificato. I punti non devono essere continui. Per maggiori dettagli, consulta la sezione Risposte nella guida Nearest Roads.
Speed limits

Un array di massimo 100 elementi di metadati stradali. Questi contengono limiti di velocità e ID luogo, con unità in km/h o mph. Per maggiori dettagli, consulta la sezione Risposte nella guida Speed limits.

Come utilizzare Roads API

1 Prova la demo di Snap to Roads Fai clic sulla demo per creare una traccia e vedere in che modo l'endpoint Snap to Roads fornisce dati senza problemi. Consulta la sezione Demo nella guida Snap to Roads. Non è necessaria una chiave API.
2 Configurazione Inizia con Configura il progetto cloud Google e completa le istruzioni di configurazione riportate di seguito e quindi scopri come utilizzare la chiave API.
3 Prova una richiesta di Snap to Roads Utilizza uno degli esempi di Snap to Roads e provalo in base 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 Snap to Roads, invia una query sul limite di velocità. Consulta la sezione Richiesta di esempio che utilizza un percorso.
5 Scopri come elaborare 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 Snap to Roads per iniziare a creare funzionalità di dati stradali nella tua app.

Librerie client disponibili

Chiama questa API nella lingua 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. Scaricale da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice campione.

Passaggi successivi