Visão geral da API Roads

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 trechos de via nas proximidades e retorna um ID de lugar com metadados, como o trecho de via mais próximo e os limites de velocidade.

Por que usar a API Roads

Com ela, é possível saber limites de velocidade, horários estimados de chegada ou outros metadados das vias. Com esses metadados de vias, é possível aprimorar seus apps de condução com os seguintes recursos:

  • Conecte coordenadas de latitude/longitude a uma estrada ou vias.
  • Encontrar a via mais próxima para um conjunto de coordenadas
  • Ver limites de velocidade para trechos de via

O que você pode fazer com a API Roads

Com o Roads API, você pode associar as coordenadas de GPS à geometria da via e determinar o limite de velocidade em trechos da via.

  • Snap to Roads: esse serviço retorna as vias mais prováveis percorridas com base nas coordenadas de GPS fornecidas. Você pode especificar até 100 pontos de GPS coletados ao longo de um trajeto. Você também pode solicitar que o serviço interpole pontos adicionais, resultando em um caminho que segue a geometria da via de maneira uniforme.
  • Estradas mais próximas: este serviço retorna o trecho de via mais próximo para um ponto do GPS. Você pode 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 estabelecido para um trecho de via. Esse serviço 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 funciona a API Roads

A API Roads usa três endpoints que aceitam coordenadas de latitude/longitude ou IDs de lugar para fornecer dados sobre caminhos, segmentos ou limites de velocidade das vias. 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 pela API Roads e os dados retornados por ela.

Recursos de dados Dados retornados Formato de devolução
Snap to Roads

Retorna uma matriz de até 100 pontos de GPS de uma rota. Inclui coordenadas de longitude/latitude ajustadas na via, além de IDs de lugares. Confira os detalhes em Respostas no guia Snap to Roads.
  • JSON
Vias mais próximas

Uma matriz de até 100 coordenadas de latitude/longitude independentes com IDs de lugar da via mais próxima de cada ponto especificado. Os pontos não precisam ser contínuos. Confira os detalhes em Respostas no guia Vias mais próximas.
Limites de velocidade

Uma matriz de até 100 elementos de metadados de estrada. Eles contêm limites de velocidade e IDs de lugares, com unidades em KPH ou MPH. Veja os detalhes em Respostas no guia Limites de velocidade.

Como usar a API Roads

1 Teste a demonstração do Snap to Roads Clique na demonstração para criar uma faixa e conferir como o endpoint de Snap to Roads fornece dados simples. Consulte Demonstração no guia Ajustar a vias. Você não precisa de uma chave de API.
2 Configuração Comece em Configurar seu projeto do Google Cloud, conclua as instruções de configuração a seguir e aprenda como usar sua chave de API.
3 Fazer uma solicitação do Snap to Roads Use um dos exemplos de Snap to Roads e tente um que seja relevante para seu caso de uso.
4 Ver limites de velocidade para o trajeto Usando os mesmos dados de caminho que você forneceu para a solicitação de Snap to Roads, faça uma consulta sobre o limite de velocidade. Consulte o Exemplo de solicitação usando um caminho.
5 Saiba como processar caminhos longos Siga as seções em Como processar caminhos longos no guia Conceitos avançados.
6 Incorpore dados sobre as vias ao seu app. Confira o exemplo de código detalhado da demonstração da estrada para começar a criar a funcionalidade de dados de vias no seu app.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem 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 com código aberto sob a Licença Apache 2.0. Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.

A seguir