Panoramica dell'API Roads

Roads API è un servizio che accetta richieste HTTPS con coordinate di latitudine/longitudine di uno o più punti su una mappa. Utilizza questi punta a trovare segmenti di strada nelle vicinanze e restituisce un ID luogo insieme ai metadati come 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à, orari di arrivo o altri metadati relativi alla strada. Con questa strada 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 al la geometria della strada e determina il limite di velocità lungo la strada segmenti.

  • Snap to Roads Questo servizio restituisce i dati strade 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 interpola altri punti, creando così un percorso che segue uniformemente la geometria della strada.
  • Strade più vicine: questo servizio restituisce la strada più vicina. 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 i contenuti pubblicati limite di velocità per un tratto di strada. Il servizio Limiti di velocità è disponibile per tutti i clienti con una licenza per il monitoraggio delle risorse. Per il piano Google Maps Platform Premium per i clienti che sono passati al modello di pagamento a consumo, la funzionalità rimane attivo.

Come funziona l'API Roads

L'API Roads utilizza tre endpoint che accettano latitudine/longitudine coordinate o ID luogo per fornire dati su percorsi, segmenti o limiti di velocità. L'esempio seguente mostra una richiesta per le strade più vicine in base a un insieme delle 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 API Roads insieme ai 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 coordinate di latitudine e longitudine interrotte dalla strada con ID luogo. Vedi i dettagli in Risposte nella sezione Allinea a strade guida.
  • JSON
Strade più vicine

Un array di massimo 100 coordinate di latitudine/longitudine indipendenti insieme agli ID luogo della strada più vicina per ciascun punto specificato. I punti non devono essere continui. Vedi i dettagli in Risposte nelle strade più vicine guida.
Limiti di velocità

Un array di massimo 100 elementi di metadati delle strade. Queste contengono la velocità e ID luogo, con unità in km/h o mph. Visualizza dettagli in Risposte nei limiti di velocità guida.

Come utilizzare l'API Roads

1 Prova la demo di posizionamento sulla strada Fai clic sulla demo per creare un percorso e vedere l'endpoint di posizionamento delle strade fornisce dati fluidi. Consulta Demo nella guida Allinea alla strada. Non è necessaria una chiave API.
2 Configurazione Inizia con l'articolo Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito per poi apprendere come utilizzare la chiave API.
3 Prova una richiesta di Allineamento alle strade Usa uno dei pulsanti di scatto agli esempi di 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, eseguire una query sui limiti di velocità. Consulta le Esempio di richiesta 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. Consulta le esempio di codice dettagliato dalla demo agganciata alla strada per iniziare integrare funzionalità di dati stradali nella tua app.

Librerie client disponibili

Chiama questa API nella lingua di la tua scelta tramite una delle seguenti librerie client:

Client Java, client Python, client Go e client Node.js per Google Maps I servizi sono librerie client supportate dalla community, open source secondo Licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche le istruzioni per l'installazione e il codice di esempio.

Passaggi successivi