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. |
|
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:
- Java Cliente para serviços do Google Maps
- Python Cliente para serviços do Google Maps
- Cliente Go para serviços do Google Maps
- Node.js Cliente para serviços do Google Maps
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
- Testar a API Roads: acesse o Inspetor de estradas.
- Saiba como fazer solicitações da API Roads: acesse o serviço de seu interesse.
em:
- Snap to Roads (link em inglês)
- Vias mais próximas
- Limites de velocidade
- Noções básicas sobre conceitos avançados: acesse Conceitos avançados
- Siga as práticas recomendadas: acesse Práticas recomendadas para serviços da Web.