Visão geral da API Roads
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O
Roads API é um serviço que aceita solicitações HTTPS com coordenadas de latitude/longitude para um ou mais pontos em um mapa. Ele usa esses pontos para encontrar segmentos de via próximos e retorna um ID de lugar com metadados, como o segmento de via mais próximo e os limites de velocidade.
Por que usar o Roads API
Com o Roads API, é possível receber limites de velocidade, horários de chegada estimados ou outros metadados da via. Com esses metadados de via, é possível melhorar seus apps de navegação com os seguintes recursos:
- Conecte coordenadas de latitude/longitude a uma ou mais vias.
- Encontrar a via mais próxima para um conjunto de coordenadas
- Receber limites de velocidade para trechos da via
O que você pode fazer com o Roads API
Com o Roads API, é possível mapear coordenadas de GPS para a geometria da via e determinar o limite de velocidade ao longo dos segmentos da via.
- Ajustar a vias: esse serviço retorna as vias mais prováveis percorridas com base no conjunto de coordenadas GPS fornecido. É possível especificar até 100 pontos de GPS coletados ao longo de um trajeto. Como opção, você também pode pedir que o serviço interpole pontos adicionais, resultando em um caminho que segue suavemente a geometria da via.
- Nearest Roads: esse serviço retorna o segmento de via mais próximo de um ponto de GPS. É possível especificar até 100 pontos de GPS. Os pontos especificados não precisam fazer parte de um caminho contínuo.
- Limites de velocidade: esse serviço retorna o limite de velocidade determinado para um trecho da via. O serviço de limite de velocidade está disponível para todos os clientes com uma licença de rastreamento de recursos. Para clientes do Plano Premium da Plataforma Google Maps que fizeram a transição para o pagamento por utilização, o recurso continua ativo.
Como o Roads API funciona
O Roads API usa três endpoints que aceitam coordenadas de latitude/longitude ou IDs de lugar para fornecer caminhos, segmentos ou dados de limite de velocidade.
O exemplo a seguir mostra uma solicitação de vias mais próximas com base em um conjunto de coordenadas de latitude/longitude:
https://roads.googleapis.com/v1/nearestRoads
?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
&key=YOUR_API_KEY
Recursos
A tabela a seguir resume os recursos disponíveis no
Roads API e os dados que ele retorna.
| Recursos de dados |
Dados retornados |
Formato de retorno |
| Ajuste de trajeto
|
Retorna uma matriz de até 100 pontos de GPS de uma rota. Inclui coordenadas de longitude/latitude ajustadas à via e IDs de lugar. Confira detalhes em
Respostas
no guia Ajustar a vias.
|
|
| Vias mais próximas
|
Uma matriz de até 100 coordenadas independentes de latitude/longitude, além de IDs de lugar da via mais próxima de cada ponto especificado.
Os pontos não precisam ser contínuos. Confira detalhes em
Respostas
no guia Ruas mais próximas.
|
| Limites de velocidade
|
Uma matriz de até 100 elementos de metadados de vias. Eles contêm limites de velocidade e IDs de lugar, com unidades em KPH ou MPH. Confira detalhes em Respostas no guia Limites de velocidade.
|
Como usar o Roads API
| 1 |
Teste a demonstração de ajuste a vias |
Clique na demonstração para criar uma faixa e ver como o endpoint de ajuste a vias
fornece dados sem problemas. Consulte a demonstração no guia Ajustar às vias. Você não precisa de uma chave de API.
|
| 2 |
Começar a configurar |
Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração abaixo. Depois, saiba como usar sua chave de API.
|
| 3 |
Teste uma solicitação de ajuste a vias |
Use um dos exemplos de ajuste a vias e teste um relevante para seu caso de uso.
|
| 4 |
Receber limites de velocidade para seu trajeto |
Usando os mesmos dados de caminho fornecidos para sua solicitação de ajuste a vias,
emita uma consulta de limite de velocidade. Consulte o
Exemplo de solicitação usando um caminho.
|
| 5 |
Aprenda a processar caminhos longos |
Siga as seções sobre
Processamento de caminhos longos
no guia Conceitos avançados.
|
| 6 |
Incorpore dados de vias no seu próprio app! |
Consulte o exemplo de código detalhado da demonstração de ajuste de vias para começar a criar funcionalidades de dados de vias no seu próprio app.
|
Bibliotecas de clientes disponíveis
Chame essa API no idioma de sua escolha usando uma das seguintes bibliotecas de cliente:
Os clientes Java, Python, Go e Node.js dos serviços do Google Maps são bibliotecas de cliente apoiadas pela comunidade e que têm código aberto sob a Licença Apache 2.0.
Faça o download deles no GitHub, onde você também encontra instruções de instalação e exemplos de código.
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThe Roads API enhances maps applications by connecting coordinates with roads, finding nearby roads, and providing speed limit data.\u003c/p\u003e\n"],["\u003cp\u003eIt offers three core functionalities: snapping GPS points to roads, identifying nearest roads, and retrieving speed limits.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage client libraries for Java, Python, Go, and Node.js to integrate the Roads API.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts latitude/longitude coordinates and returns data like Place IDs, road segments, and speed limits in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eYou can get started by exploring the documentation, trying the demo, setting up a Google Cloud project, and experimenting with code examples.\u003c/p\u003e\n"]]],["The Roads API processes HTTPS requests with latitude/longitude coordinates to identify nearby road segments. It offers three main services: Snap to Roads, which maps up to 100 GPS points to road geometry; Nearest Roads, which identifies the closest road segment for up to 100 independent GPS points; and Speed Limits, which returns posted speed limits and place IDs for road segments. Users can integrate these functionalities using client libraries or by making direct requests with an API key.\n"],null,["# Roads API overview\n\nThe Roads API is a service that accepts HTTPS requests with latitude/longitude coordinates for one or more points on a map. It uses these points to find nearby road segments and returns a Place ID along with metadata such as the nearest road segment and speed limits.\n\nWhy use the Roads API\n---------------------\n\nWith the Roads API, you can get speed limits, estimated\narrival times, or other road metadata. With this road\nmetadata, you can enhance your driving apps with the follow capabilities:\n\n- Connect latitude/longitude coordinates with a road or roads.\n- Find the nearest road for a set of coordinates\n- Get speed limits for road segments\n\nWhat you can do with the Roads API\n----------------------------------\n\nWith the Roads API, you can map GPS coordinates to the\ngeometry of the road, and determine the speed limit along road\nsegments.\n\n- **[Snap to Roads](/maps/documentation/roads/snap)** This service returns the most likely roads traveled based on the provided set of GPS coordinates. You can specify up to 100 GPS points collected along a route. Optionally, you can also request that the service interpolates additional points, resulting in a path that smoothly follows the geometry of the road.\n- **[Nearest Roads](/maps/documentation/roads/nearest)** This service returns the nearest road segment for a GPS point. You can specify up to 100 GPS points. The points you specify don't need to be part of a continuous path.\n- **[Speed limits](/maps/documentation/roads/speed-limits)** This service returns the posted speed limit for a road segment. The Speed Limit service is available to all customers with an Asset Tracking license. For [Google Maps Platform Premium Plan](/maps/premium) customers who transitioned to pay-as-you-go pricing, the feature remains active.\n\nHow the Roads API works\n-----------------------\n\nThe Roads API uses three endpoints which accept latitude/longitude\ncoordinates or place IDs to provide road paths, segments, or speed limit data.\nThe following example shows a request for nearest roads based on a set\nof latitude/longitude coordinates: \n\n```scdoc\nhttps://roads.googleapis.com/v1/nearestRoads\n ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796\n &key=YOUR_API_KEY\n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoads API along with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **[Snap to roads](/maps/documentation/roads/snap)** | Returns an array of up to 100 GPS points from a route. Includes road-snapped longitude/latitude coordinates along with place IDs. See details in [Responses](/maps/documentation/roads/snap#responses) in the Snap to roads guide. | - JSON |\n| **[Nearest roads](/maps/documentation/roads/nearest)** | An array of up to 100 independent latitude/longitude coordinates along with place IDs for the nearest road for each specified point. Points do not need to be continuous. See details in [Responses](/maps/documentation/roads/nearest#responses) in the Nearest roads guide. | - JSON |\n| **[Speed limits](/maps/documentation/roads/speed-limits)** | An array of up to 100 road metadata elements. These contain speed limits and place IDs, with units either in KPH or MPH. See details in [Responses](/maps/documentation/roads/nearest#responses) in the Speed limits guide. | - JSON |\n\n\u003cbr /\u003e\n\nHow to use the Roads API\n------------------------\n\n|---|----------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Try the snap to roads demo** | Click the demo to create a track and see how the snap to roads endpoint provides smooth data. See [Demo](/maps/documentation/roads/snap#demo) in the **Snap to roads** guide. You don't need an API key. |\n| 2 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/roads/cloud-setup) and complete the setup instructions that follow and then learn [how to use your API key](/maps/documentation/roads/get-api-key). |\n| 3 | **Try a snap to roads request** | [Use one of the snap to roads examples](/maps/documentation/roads/snap#examples) and try one relevant to your use case. |\n| 4 | **Get speed limits for your road path** | Using the same path data you provided for your snap to roads request, issue a speed limit query. See the [Example request using a path](/maps/documentation/roads/speed-limits#example_request_using_a_path). |\n| 5 | **Learn how to process long paths** | Follow the sections on [Processing long paths](/maps/documentation/roads/advanced#processing_long_paths) in the **Advanced concepts** guide. |\n| 6 | **Incorporate road data into your own app!** | See the [detailed code example](/maps/documentation/roads/snap#javascript-+-html) from the road snapped demo to start building road data functionality into your own app. |\n\n### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Try out the Roads API** : Go to [Roads Inspector](/maps/documentation/roads/inspector)\n- **Learn how to make Roads API requests** : Go to the service you're interested in:\n - [Snap to roads](/maps/documentation/roads/snap)\n - [Nearest roads](/maps/documentation/roads/nearest)\n - [Speed limits](/maps/documentation/roads/speed-limits)\n- **Understand Advanced Concepts** : Go to [Advanced Concepts](/maps/documentation/roads/advanced)\n- **Follow best practices** : Go to [Web Services Best Practices](/maps/documentation/roads/web-service-best-practices)"]]
