
A API Elevation é um serviço que retorna dados de elevação para um local na Terra ou dados de elevação de amostragem ao longo de caminhos.
Por que usar a API Elevation
Com a API Elevation, é possível desenvolver aplicativos para oferecer suporte aos seus clientes com atividades de elevação, posicionamento ou aplicativos de baixa pesquisa, que incluem elevações e mudanças de elevação ao longo dos trajetos. Por exemplo, é possível fornecer dados de ganho e perda de elevação para aprimorar um aplicativo esportivo para atividades como caminhadas, ciclismo ou mergulho.
O que você pode fazer com a API Elevation
Com a API Elevation, é possível incluir dados de elevação nos seus aplicativos ou em um mapa. Exemplo:
- Veja a elevação de um lugar específico.
- Calcule as diferenças na elevação ao longo de uma rota ou entre dois pontos.
Como a API Elevation funciona
A API Elevation aceita uma solicitação como um URL codificado com coordenadas de latitude/longitude fornecidas como locais discretos ou como uma série de locais ao longo de um caminho. Essa solicitação, por exemplo, consulta a elevação do centro de Denver, no Colorado, especificando um retorno no formato JSON.https://maps.googleapis.com/maps/api/elevation/json ?locations=39.7391536%2C-104.9847034 &key=YOUR_API_KEY
O serviço deriva a elevação das coordenadas fornecidas. Ele também interpola a elevação de um local sem elevação, fornecendo uma média retornada dos quatro locais mais próximos que fornecem dados de elevação. Por fim, ele determina a resolução geral do local.
Recursos
A tabela a seguir resume os recursos disponíveis na API Elevation e os dados retornados por ela.
Recursos de dados | Dados retornados | Formato da devolução |
---|---|---|
Coordenadas de latitude/longitude
É possível fornecer dados como um conjunto de um ou mais locais ou como uma série ao longo de um caminho. Também é possível fornecer coordenadas codificadas. Transmita até 512 coordenadas. |
A API Elevation fornece elevação em metros em relação ao nível médio do mar (LMSL, na sigla em inglês). A elevação pode ser retornada como valores positivos ou negativos, conforme indicado abaixo:
|
|
Como usar a API Elevation
1 | Prepare o dispositivo. | Comece com Configurar o projeto do Google Cloud e siga as instruções de configuração a seguir. |
2 | Testar uma solicitação de elevação | Quando você tiver uma chave de API, vai poder começar a testar a API Elevation diretamente no seu navegador. Para mais detalhes, consulte Solicitações de amostra no guia Primeiros passos. |
3 | Criar uma solicitação mais complexa | Depois de configurar um projeto, faça uma solicitação que forneça dados de local ao longo de um caminho. Consulte Como especificar caminhos para saber mais. |
4 | Noções básicas sobre respostas | Explore as respostas de dados de elevação para se preparar para usar os dados de elevação do app. Consulte Respostas de elevação para ver mais detalhes. |
5 | Incorpore dados de elevação ao seu app. | Você pode usar dados de elevação para melhorar apps com base na localização, como apps de atividades esportivas ou de pesquisas. |
Bibliotecas de clientes disponíveis
Chame essa API na linguagem de sua escolha usando uma das seguintes bibliotecas de cliente:
- Cliente Java para serviços do Google Maps (em inglês)
- Cliente Python para serviços do Google Maps (em inglês)
- Cliente Go para serviços do Google Maps (em inglês)
- Cliente Node.js para serviços do Google Maps (em inglês)
Os clientes Java, Python, Go e Node.js dos serviços do Google Maps são bibliotecas de cliente apoiadas pela comunidade, com código aberto sob a Licença Apache 2.0. Faça o download no GitHub, que também inclui instruções de instalação e amostras de código.
A seguir
- Comece a usar a API Elevation: acesse Configurar seu projeto do Google Cloud.
- Tente receber dados de elevação com base em caminho: acesse Especificar caminhos.
- Siga as práticas recomendadas: acesse Práticas recomendadas para serviços da Web.