Visão geral da API Elevation

A API Elevation é um serviço que retorna dados de elevação de um local no planeta ou dados de elevação de amostra ao longo de caminhos.

Por que usar a API Elevation

Com a API Elevation, você pode desenvolver aplicativos para atender aos seus clientes com atividades sensíveis à elevação, aplicativos de posicionamento ou aplicativos de baixa pesquisa que incluam 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 melhorar um aplicativo esportivo para atividades como caminhada, ciclismo ou mergulho.

O que você pode fazer com a API Elevation

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

  • Confira a elevação de um lugar específico.
  • Calcule as diferenças de elevação ao longo de um trajeto 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 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 determina a elevação para as coordenadas fornecidas. Ela também interpola a elevação para um local sem elevação, fornecendo uma média retornada dos quatro locais mais próximos que fornecem dados de elevação. Por fim, determina a resolução geral da localização.

Recursos

A tabela a seguir resume os recursos disponíveis por meio da API Elevation e os dados que ela retorna.

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

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

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

  • Valores positivos indicam locais acima do LMSL, como a superfície ou o fundo de lagos de alta altitude.
  • Os valores negativos indicam locais que estão abaixo do LMSL, 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-se. Comece com Configurar seu 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, poderá testar a API Elevation diretamente no seu navegador. Consulte Exemplos de solicitações no guia Primeiros passos para mais detalhes.
3 Criar uma solicitação mais complexa Quando estiver configurado com um projeto, use uma solicitação que forneça dados de local ao longo de um caminho. Consulte Como especificar caminhos para mais detalhes.
4 Noções básicas sobre respostas Explore as respostas de dados de elevação e se prepare para usar os dados de elevação no seu app. Consulte Respostas de elevação para mais detalhes.
5 Incorpore dados de elevação no seu app. Você pode usar dados de elevação para melhorar apps baseados em localização, como apps de atividades esportivas ou de dados de pesquisa.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem que quiser usando uma destas 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 e que têm código aberto sob a Licença Apache 2.0. Faça o download delas no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.

A seguir