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 nas proximidades e retorna um ID de lugar com metadados, como as vias mais próximas e os limites de velocidade.

Por que usar a API Roads

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

  • Conecte coordenadas de latitude/longitude a uma ou mais estradas.
  • Encontrar a estrada 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 mapear coordenadas de GPS à geometria da estrada e determinar o limite de velocidade em trechos de estrada.

  • 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. Opcionalmente, você também pode solicitar que o serviço interpole pontos adicionais, resultando em um caminho que segue a geometria da estrada de maneira uniforme.
  • Estradas mais próximas: este serviço retorna o segmento da estrada mais próximo de um ponto 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: este serviço retorna o limite de velocidade divulgado para um segmento de estrada. 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 modelo de 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 de caminhos de estrada, 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 por meio da API Roads com os dados retornados.

Recursos de dados Dados retornados Formato de retorno
Alinhar a vias

Retorna uma matriz de até 100 pontos de GPS de um trajeto. Inclui coordenadas de longitude/latitude alinhadas com os IDs de local. Consulte os detalhes em Respostas, no guia Alinhar a vias.

  • JSON
Vias mais próximas

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

Como usar a API Roads

1 Teste a demonstração de alinhamento com vias Clique na demonstração para criar uma trilha e ver como o endpoint de direcionamento para vias fornece dados estáveis. Consulte Demonstração no guia Alinhar a 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 a seguir. Em seguida, aprenda como usar sua chave de API.
3 Fazer uma solicitação de alinhamento com a via Use um dos exemplos de "Snap to Roads" e tente um que seja relevante para seu caso de uso.
4 Ver limites de velocidade no seu caminho Usando os mesmos dados de caminho fornecidos na solicitação de "Snap to Roads", emita uma consulta de limite de velocidade. Veja 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 app. Veja o exemplo de código detalhado da demonstração de uso da via para começar a criar funcionalidades de dados sobre vias no seu próprio app.

Bibliotecas de clientes disponíveis

Chame essa API no idioma de sua escolha por meio de 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 com suporte da comunidade e código aberto sob a Licença Apache 2.0 (em inglês). Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e códigos de amostra.

A seguir