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 vias próximas e retorna um ID de lugar com metadados, como o trecho da via mais próxima e os limites de velocidade.

Por que usar a API Roads

Com a API Roads, você pode conferir limites de velocidade, horários estimados de chegada ou outros metadados das vias. Com esses metadados de vias, é possível aprimorar os apps de condução com os seguintes recursos:

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

O que você pode fazer com a API Roads

Com o Roads API, você pode mapear coordenadas de GPS para a 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 no conjunto de coordenadas de GPS fornecido. Você pode especificar até 100 pontos de GPS coletados ao longo de um trajeto. Se preferir, 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 trecho da via mais próxima para 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 divulgado para um trecho de 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 a API Roads funciona

A API Roads usa três pontos de extremidade que aceitam coordenadas de latitude/longitude ou IDs de lugar para fornecer caminhos de via, trechos 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 pela API Roads com os dados retornados por ela.

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

Retorna uma matriz de até 100 pontos de GPS de uma rota. Inclui coordenadas de longitude/latitude capturadas pela via, além de IDs de lugar. 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 os 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

Matriz de até 100 elementos de metadados de vias. Estes contêm limites de velocidade e IDs de lugares, com unidades em KPH ou MPH. Confira os detalhes em Respostas no guia Limites de velocidade.

Como usar a API Roads

1 Experimente a demonstração do Snap to Roads Clique na demonstração para criar uma rota e conferir como o endpoint do Snap to Roads fornece dados estáveis. Consulte Demonstração no guia Ajustar a vias. Você não precisa de uma chave de API.
2 Configuração Comece com Configurar seu projeto do Google Cloud, conclua as instruções de configuração a seguir. Depois, saiba como usar a chave de API.
3 Tentar solicitar o Snap to Roads Use um dos exemplos de Snap to Roads e tente um que seja relevante para seu caso de uso.
4 Conferir limites de velocidade para a rota Usando os mesmos dados do caminho fornecidos na solicitação de Snap to Roads, faça uma consulta de limite de velocidade. Consulte a seçã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 de vias no seu app. Confira o exemplo de código detalhado na demonstração feita para você para começar a criar a funcionalidade de dados de vias no seu app.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem que preferir usando uma destas bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js para 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 também é possível encontrar instruções de instalação e exemplos de código.

A seguir