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

Por que usar a API Roads

Com a API Roads, você pode receber limites de velocidade, horários de chegada estimados ou outros metadados de rodovias. Com esses metadados, você pode melhorar seus apps de direção com os seguintes recursos:

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

O que você pode fazer com a API Roads

Com o Roads API, é possível mapear coordenadas de GPS para a geometria da estrada e determinar o limite de velocidade ao longo dos segmentos de estrada.

  • Snap to Roads: esse serviço retorna as vias percorridas mais prováveis com base no conjunto de coordenadas de GPS fornecido. Você pode especificar até 100 pontos de GPS coletados ao longo de uma rota. Opcionalmente, 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.
  • Nearest Roads: esse serviço retorna o segmento de estrada mais próximo para um ponto de 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 divulgado para um determinado trecho da via. O serviço Speed Limit está disponível para todos os clientes com uma licença do Asset Tracking. Para clientes do Plano Premium da Plataforma Google Maps que fizeram a transição para o modelo de pagamento por utilização, o recurso permanece ativo.

Como a API Roads funciona

A API Roads usa três endpoints que aceitam coordenadas de latitude/longitude ou IDs de lugar para fornecer dados de trajetos, segmentos ou 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 na API Roads e os dados que ela retorna.

Recursos de dados Dados retornados Formato da devolução
Ajustar a vias

Retorna uma matriz de até 100 pontos de GPS de uma rota. Inclui coordenadas de latitude/longitude aproximadas por estrada com IDs de lugar. Confira os detalhes em Respostas no guia Ajustar a vias.
  • JSON
Nearest roads

Uma matriz de até 100 coordenadas de latitude/longitude independentes, além de IDs de lugar para a via mais próxima de cada ponto especificado. Os pontos não precisam ser contínuos. Confira os detalhes em Respostas no guia Ruas 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 lugar, com unidades em KPH ou MPH. Confira os detalhes em Respostas no guia Limites de velocidade.

Como usar a API Roads

1 Teste a demonstração de ajuste a vias Clique na demonstração para criar uma faixa e conferir como o endpoint de ajuste às estradas fornece dados suaves. Consulte a demonstração no guia Ajustar às vias. Você não precisa de uma chave de API.
2 Configurar Comece com Configurar seu projeto do Google Cloud, siga as instruções de configuração e aprenda a usar sua chave de API.
3 Tente uma solicitação de ajuste às estradas Use um dos exemplos de ajuste a vias e teste um que seja relevante para seu caso de uso.
4 Conferir os limites de velocidade do seu trajeto Usando os mesmos dados de caminho que você forneceu para sua solicitação de ajuste a vias, faça uma consulta de limite de velocidade. Consulte o Exemplo de solicitação usando um caminho.
5 Saiba como processar caminhos longos Siga as seções sobre Processamento de caminhos longos no guia Conceitos avançados.
6 Incorpore dados de vias ao seu próprio app. Consulte o exemplo de código detalhado da demonstração de vias fixadas para começar a criar a funcionalidade 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 para os serviços do Google Maps são bibliotecas de cliente com suporte da comunidade e código aberto regido pela Licença Apache 2.0. Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e códigos de exemplo.

A seguir