Visão geral da API Roads

A Roads API é um serviço que aceita solicitações HTTPS com coordenadas de latitude/longitude para um ou mais pontos em um mapa. Ela 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 a Roads API, você pode conferir limites de velocidade, horários estimados de chegada ou outros metadados de vias. Com esses metadados, você pode aprimorar 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 de via

O que você pode fazer com o Roads API

Com a Roads API, é possível mapear coordenadas de GPS para a geometria da via e determinar o limite de velocidade em trechos dela.

  • Ajuste de trajeto: esse serviço retorna as vias mais prováveis percorridas com base no conjunto de coordenadas de GPS fornecido. É possível especificar até 100 pontos de GPS coletados ao longo de um trajeto. Se quiser, você também pode solicitar que o serviço interpole outros pontos, resultando em um trajeto que segue suavemente a geometria da via.
  • Nearest Roads: esse serviço retorna o trecho 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 trajeto contínuo.
  • Limites de velocidade: esse serviço retorna o limite de velocidade indicado 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 migraram para o pagamento por uso, o recurso permanece ativo.

Como o Roads API funciona

A Roads API usa três endpoints que aceitam coordenadas de latitude/longitude ou IDs de lugar para fornecer dados de trajetos, segmentos ou limites de velocidade. O exemplo a seguir mostra uma solicitação de estradas 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 Roads API, além dos dados que ela retorna.

Recursos de dados Dados retornados Formato de retorno
Ajuste de trajeto

Retorna uma matriz de até 100 pontos de GPS de um trajeto. Inclui coordenadas de longitude/latitude ajustadas à via e IDs de lugar. Veja os detalhes em Respostas no guia Ajuste de trajeto.
  • JSON
Vias mais próximas

Uma matriz de até 100 coordenadas independentes de latitude/longitude, além dos 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 Nearest Roads.
Limites de velocidade

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

Como usar o Roads API

1 Teste a demonstração do ajuste de trajeto Clique na demonstração para criar um trajeto e ver como o endpoint de ajuste de trajeto fornece dados sem problemas. Consulte Demonstração no guia Ajustar às estradas. 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 saiba como usar sua chave de API.
3 Testar uma solicitação de ajuste de trajeto Use um dos exemplos de ajuste de trajeto e teste um que seja relevante para seu caso de uso.
4 Receber limites de velocidade para seu trajeto Usando os mesmos dados de trajeto que você forneceu para a solicitação de ajuste de trajeto, 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 Como processar caminhos longos no guia Conceitos avançados.
6 Incorpore dados de vias ao seu app. Confira o exemplo de código detalhado da demonstração de ajuste à estrada para começar a criar uma funcionalidade de dados de estradas 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 que têm código aberto sob a Licença Apache 2.0. Faça o download delas no GitHub, onde você também encontra instruções de instalação e exemplos de código.

A seguir