Visão geral da API Elevation

A Elevation API é um serviço que retorna dados de elevação para um local na Terra ou dados de elevação com amostragem ao longo de caminhos.

Por que usar a API Elevation

Com a API Elevation, você pode desenvolver aplicativos de suporte para suas clientes com atividades sensíveis à elevação, aplicativos de posicionamento ou pesquisas aplicações que incluem elevações e mudanças de elevação ao longo dos trajetos. Por exemplo: você pode fornecer dados de ganho e perda de elevação para aprimorar um aplicativo esportivo para atividades como como caminhada, ciclismo ou mergulho.

O que você pode fazer com a API Elevation

Com a Elevation API, você pode incluir dados de elevação em seu aplicativos ou em um mapa. Exemplo:

  • Descubra a elevação de um lugar específico.
  • Calcular as diferenças de elevação ao longo de um trajeto ou entre dois pontos.

Como a API Elevation funciona

A Elevation API aceita uma solicitação como um URL codificado com coordenadas de latitude/longitude fornecidos como locais discretos ou como uma série de locais ao longo de um caminho. Essa solicitação, por exemplo, consulta elevação para o centro de Denver, 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 para as coordenadas fornecidas. Ela também interpola elevação para um local sem elevação, fornecendo uma média retornada dos quatro locais mais próximos que forneçam dados de elevação. Por fim, determina do local.

Recursos

A tabela a seguir resume os recursos disponíveis no Elevation API junto com os dados retornados.

Recursos de dados Dados retornados Formato de devolução
Coordenadas de latitude/longitude

Você pode fornecer dados como um conjunto de um ou mais locais ou como uma série ao longo de um caminho. Você também podem fornecer coordenadas codificadas. Transmita até 512 coordenadas.

A Elevation API fornece elevação em metros relativa ao nível do mar médio local (LMSL). A elevação pode ser retornada como positiva ou valores negativos, conforme indicado abaixo:

  • Valores positivos indicam locais acima da LMSL, incluindo as localizações da superfície ou o fundo de lagos de alta altitude.
  • Os valores negativos indicam locais abaixo da LMSL, incluindo: locais na superfície ou no fundo do oceano.
  • Resolução indica a distância entre o ponto de dados e o elevação, em metros.
  • JSON
  • XML

Como usar a API Elevation

1 Prepare-se. Comece com a etapa Configurar seu projeto do Google Cloud e conclua a configuração as instruções a seguir.
2 Testar uma solicitação de elevação Quando você tiver uma chave de API, poderá começar a testar a API Elevation diretamente no seu navegador. Consulte Exemplos de solicitações. no guia Vamos começar para mais detalhes.
3 Criar uma solicitação mais complexa Quando um projeto estiver configurado, tente uma solicitação que forneça dados de local junto com uma caminho. Consulte Como especificar caminhos. para mais detalhes.
4 Noções básicas sobre respostas Explore as respostas dos dados de elevação para se preparar para usá-los no seu app. Consulte Respostas do Elevation para mais detalhes.
5 Incorpore dados de elevação ao seu app. Você pode usar dados de elevação para aprimorar apps baseados em localização, como apps de esportes atividades ou para dados de pesquisa.

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