Começar

A API Elevation fornece dados de elevação para todos os locais na superfície da Terra, 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

Você acessa a API Elevation por uma interface HTTP, com solicitações construídas como uma string de URL, usando coordenadas de latitude/longitude para identificar os locais ou vértices do 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. Não se esqueça de substituir YOUR_API_KEY pela chave de API real. A resposta inclui a elevação nesse ponto, em metros, junto com o valor de 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 parâmetros disponíveis e como entender a resposta.

Confira 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>

Começar a codificar com nossas bibliotecas cliente

As bibliotecas de cliente facilitam o desenvolvimento com as APIs do serviço da Web do Google Maps, oferecendo implementações integradas de tarefas comuns, como autenticação, limitação de solicitações e repetição 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 API Elevation, primeiro é necessário ativá-la e obter 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 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

Há mais coisas que você pode fazer com a API Elevation, como solicitar dados de elevação de vários locais. Consulte o guia do desenvolvedor da API Elevation para 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 apresenta o uso da API e material de referência sobre os parâmetros disponíveis.