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 para encontrar trechos de via nas proximidades e retorna um ID de lugar com metadados como o trecho de 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 de chegada ou outros metadados das estradas. Com esta via metadados, é possível aprimorar seus apps de condução com os seguintes recursos:

  • Conecte coordenadas de latitude/longitude a uma estrada ou vias.
  • Encontrar a via 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, é possível mapear coordenadas de GPS para o a geometria da estrada e determinar o limite de velocidade ao longo da estrada segmentos.

  • Snap to Roads: esse serviço retorna a versão mais provável vias percorridas com base no conjunto de coordenadas de GPS fornecido. É possível especificar até 100 Pontos de GPS coletados ao longo de um trajeto. Também é possível solicitar que o serviço interpola pontos adicionais, resultando em um caminho que segue suavemente a geometria da estrada.
  • Estradas mais próximas Este serviço retorna a via mais próxima 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 Este serviço retorna o limite de velocidade para um trecho de via. O serviço Limite de velocidade está disponível para todos clientes com uma licença de rastreamento de recursos. Para o Plano Premium da Plataforma Google Maps clientes que migraram para o pagamento por utilização, o recurso permanece ativos.

Como funciona a API Roads

A API Roads usa três pontos de extremidade que aceitam latitude/longitude coordenadas ou IDs de lugares para fornecer caminhos de vias, trechos ou dados de limite de velocidade. O exemplo a seguir mostra uma solicitação de vias mais próximas com base em um 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 no API Roads com os dados retornados.

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

Retorna uma matriz de até 100 pontos de GPS de uma rota. Inclui coordenadas de longitude/latitude capturadas pela estrada com IDs de lugar. Mais detalhes em Respostas no campo Snap to Roads, guia.
  • JSON
Vias mais próximas

Uma matriz de até 100 coordenadas de latitude/longitude independentes junto com IDs de local da via mais próxima para cada ponto especificado. Os pontos não precisam ser contínuos. Mais detalhes em Respostas nas vias mais próximas guia.
Limites de velocidade

Uma matriz de até 100 elementos de metadados de estrada. Eles contêm dados de velocidade limites e IDs de local, com unidades em KPH ou MPH. Mais detalhes em Respostas. em Limites de velocidade guia.

Como usar a API Roads

1 Teste a demonstração do Snap to Roads Clique na demonstração para criar uma faixa e conferir como o endpoint de Snap to Roads fornece dados fluidos. Consulte Demonstração no guia Ajustar a vias. Você não precisa de uma chave de API.
2 Configuração Comece com a etapa Configurar seu projeto do Google Cloud e siga as instruções de configuração a seguir e depois aprender como usar a chave de API.
3 Fazer uma solicitação do Snap to Roads Use um dos ajustes a exemplos de vias e tente um que seja relevante para seu caso de uso.
4 Ver limites de velocidade para o trajeto Usando os mesmos dados de caminho que você forneceu para a solicitação de Snap to Roads, emitir uma consulta de limite de velocidade. Consulte a Solicitação de exemplo usando um caminho.
5 Saiba como processar caminhos longos Siga as seções Como processar caminhos longos no guia Conceitos avançados.
6 Incorpore dados sobre as vias ao seu app. Consulte a um exemplo de código detalhado da demonstração da via expressa para começar. criando funcionalidade de dados de vias no seu próprio app.

Bibliotecas de clientes disponíveis

Chame essa API no idioma do sua escolha por meio de uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js para Google Maps Os serviços são bibliotecas-cliente com suporte da comunidade, com código aberto de acordo com 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