Comece agora

A API Elevation fornece dados para todos os locais na superfície da Terra, incluindo locais no fundo do oceano, que retornam valores negativos.

Esse serviço também está disponível como parte da API Maps JavaScript do lado do cliente ou para uso do lado do servidor com os clientes Java, Python, Go e Node.js para serviços do Google Maps.

Exemplo de solicitação e resposta

Acesse a API Elevation por uma interface HTTP, com solicitações criadas como uma string de URL, usando coordenadas de latitude/longitude para identificar os locais ou vértices de caminho. As solicitações devem incluir a chave de API.

O exemplo a seguir solicita a elevação de Denver, Colorado, conhecida como "Mile High City", no formato JSON:

URL

https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'

Para fazer um teste, digite o URL no navegador da Web. Lembre-se de substituir YOUR_API_KEY pela chave de API. A resposta inclui a elevação nesse ponto, em metros, junto com o valor da resolução (a distância máxima entre os pontos de dados a partir dos quais a elevação foi interpolada, em metros).

Consulte o Guia para desenvolvedores para mais informações sobre como criar URLs de solicitação e parâmetros disponíveis e como entender a resposta.

Veja abaixo um exemplo de resposta:

JSON

{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}

XML

<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>

Começar a codificar com nossas bibliotecas cliente

As bibliotecas de cliente facilitam o desenvolvimento com as APIs Web Service do Google Maps porque fornecem implementações nativas e simples de tarefas comuns, como autenticação, limitação de solicitações e novas tentativas automáticas. A API Elevation está disponível nos seguintes clientes: Java Client, Python, Go e Node.js para serviços do Google Maps.

Autenticação, cotas, preços e políticas

Autenticação

Para usar a API Elevation, primeiro você precisa ativar a API e conseguir as credenciais de autenticação adequadas. Para mais informações, consulte o artigo Começar a usar a Plataforma Google Maps.

Cotas e preços

Consulte a página de uso e faturamento para ver detalhes sobre as cotas e os preços definidos para a API Elevation.

Políticas

O uso da API Elevation precisa estar de acordo com as políticas da API.

Saiba mais

Você pode fazer mais com a API Elevation, como solicitar dados de elevação de vários locais. Consulte o guia do desenvolvedor da API Elevation para ver mais exemplos e outros detalhes.

O guia para desenvolvedores da API Elevation é destinado a desenvolvedores de sites e dispositivos móveis que querem usar dados de elevação de mapas fornecidos por uma das APIs da Plataforma Google Maps. Ela fornece uma introdução ao uso da API e material de referência sobre os parâmetros disponíveis.