Visão geral da API Elevation

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:

  • Valores positivos indicam locais acima da SGAL, incluindo locais de superfície ou o fundo de lagos de alta altitude.
  • Valores negativos indicam locais que estão abaixo da SGAL, incluindo locais na superfície ou no fundo do oceano.
  • Resolution: indica a distância entre o ponto de dados e a elevação, em metros.
  • JSON
  • XML

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:

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