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. Ela usa esses pontos para encontrar segmentos de vias 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 receber limites de velocidade, horários de chegada estimados ou outros metadados de vias. Com esses metadados, é possível melhorar seus apps de direção com os seguintes recursos:

  • Conectar 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 segmentos de vias.

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 ao longo de segmentos de vias.

  • Ajuste de trajeto : esse serviço retorna as vias mais prováveis com base no conjunto de coordenadas de GPS fornecido. É possível especificar até 100 pontos de GPS coletados ao longo de um trajeto. Como opção, também é possível solicitar que o serviço interpole pontos adicionais, resultando em um caminho que segue a geometria da via.
  • Nearest Roads : esse serviço retorna o segmento 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 caminho contínuo.
  • Limites de velocidade Este serviço retorna o limite de velocidade determinado para um segmento 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 os clientes do Plano Premium da Plataforma Google Maps que fizeram a transição para o preço de 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 caminhos de vias, segmentos 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 na Roads API e os dados que ela retorna.

Recursos de dados Dados retornados Formato de retorno
Snap to Roads

Retorna uma matriz de até 100 pontos de GPS de um trajeto. Inclui coordenadas de longitude/latitude alinhadas à via e IDs de lugar. Confira os detalhes em Respostas no guia Snap to Roads.
  • JSON
Nearest Roads

Uma matriz de até 100 coordenadas de latitude/longitude independentes com 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 Nearest Roads.
Speed limits

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

Como usar a Roads API

1 Teste a demonstração do Snap to Roads Clique na demonstração para criar uma faixa e ver como o endpoint Snap to Roads fornece dados suaves. Consulte Demonstração no guia Snap to Roads. Não é necessário ter uma chave de API.
2 Faça a configuração Comece com Configurar seu projeto na nuvem do Google Cloud e siga as instruções de configuração. Em seguida, saiba como usar sua chave de API.
3 Teste uma solicitação do Snap to Roads Use um dos exemplos do Snap to Roads e teste um relevante para seu caso de uso.
4 Receba limites de velocidade para seu caminho de via Usando os mesmos dados de caminho fornecidos para sua solicitação do Snap to Roads, emita 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 próprio app Consulte o exemplo de código detalhado da demonstração do Snap to Roads 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 preferência 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 também é possível encontrar instruções de instalação e exemplos de código.

A seguir