Perché utilizzare l'API Roads
Con l'API Roads, puoi ottenere limiti di velocità, tempi di arrivo stimati o altri metadati stradali. Con i metadati di queste strade, puoi migliorare le tue app per la guida grazie alle seguenti funzionalità:
- Collega le coordinate di latitudine e longitudine con una o più strade.
- Trovare la strada più vicina a 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 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 che il servizio interpola punti aggiuntivi, creando un percorso che segue senza problemi la geometria della strada.
- Strade più vicine Questo servizio restituisce il tratto 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 Limite di velocità è disponibile per tutti i clienti con licenza per il monitoraggio degli asset. Per i clienti del piano Premium di Google Maps Platform che sono passati al 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 dati su percorsi stradali, tratti o limiti di velocità. L'esempio seguente mostra una richiesta di 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 insieme ai dati che restituisce.
Risorse di dati | Dati restituiti | Formato restituito |
---|---|---|
Allinea sulle strade |
Restituisce un array di fino a 100 punti GPS da un percorso. Include le coordinate di latitudine/longitudine indicate dalla strada insieme agli ID luogo. Visualizza i dettagli in Risposte nella guida Allinea a strade. |
|
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. Visualizza i dettagli nella sezione Risposte della guida Strade più vicine. |
|
Limiti di velocità |
Un array di 100 elementi di metadati stradali. Contengono limiti di velocità e ID luogo, con unità in km/h. Consulta i dettagli in Risposte nella guida sui limiti di velocità. |
Come utilizzare l'API Roads
1 | Prova la demo di agganciamento alle strade | Fai clic sulla demo per creare una traccia e osservare come l'agganciamento alle strade fornisce dati uniformi. Consulta la demo nella guida Allineamento su strade. Non è necessaria una chiave API. |
2 | Configurazione | Inizia con Configura il tuo progetto Google Cloud, completa le istruzioni di configurazione che seguono e poi scopri come utilizzare la chiave API. |
3 | Prova una richiesta di agganciamento alle strade | Usa uno degli esempi di agganciamento alle strade e provane uno pertinente al tuo caso d'uso. |
4 | Visualizzare i limiti di velocità sul percorso stradale | Utilizzando gli stessi dati di percorso che hai fornito per la richiesta di agganciamento alle strade, invia una query sul limite di velocità. Consulta Esempio di richiesta mediante 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. | Guarda l'esempio di codice dettagliato della demo di agganciamento stradale 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:
- Client Java per i servizi Google Maps
- Client Python per i servizi Google Maps
- Go Client per i servizi Google Maps
- Client Node.js per i servizi Google Maps
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 e open source secondo la licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare istruzioni per l'installazione e codice di esempio.
Passaggi successivi
- Prova l'API Roads: vai a Roads Inspector
- Scopri come effettuare richieste API Roads: vai al servizio che ti interessa:
- Informazioni sui concetti avanzati: vai alla sezione Concetti avanzati
- Seguire le best practice: consulta le best practice per i servizi web.