Começar

A Elevation API fornece dados de elevação para todas as localizações na superfície do planeta, incluindo as profundezas 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

A API Elevation é acessada 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, a "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 testar, insira o URL no navegador da Web (substitua YOUR_API_KEY pela sua 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 entre os 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 os parâmetros disponíveis e como entender a resposta.

Veja a seguir 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>
</pre>

Comece a programar com nossas bibliotecas de cliente

As bibliotecas de cliente facilitam o desenvolvimento com as APIs de serviço da Web do Google Maps, oferecendo implementações integradas de tarefas comuns, como autenticação, limitação de solicitações e nova tentativa automática. A API Elevation está disponível nos clientes Java, Python, Go e Node.js para serviços do Google Maps.

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

Autenticação

Para usar a Elevation API, primeiro é necessário ativá-la e receber as credenciais de autenticação adequadas. Para mais informações, consulte Começar a usar a Plataforma Google Maps.

Cotas e preços

Consulte a página de uso e faturamento para saber mais 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

Há mais coisas que você pode fazer com a API Elevation, como solicitar dados de elevação de vários locais. Consulte o guia para desenvolvedores da API Elevation para ver mais exemplos e outros detalhes.

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