Primeiros passos

A Elevation API fornece dados de elevação para todos os locais da superfície da Terra, incluindo localizações profundas no fundo do oceano (que retornar valores negativos).

Exemplo de solicitação e resposta

É possível acessar a API Elevation por meio de uma interface HTTP, com 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 para Denver, Colorado, a "Mile High City", no formato JSON:

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

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

Para testar isso, insira o URL em seu 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 da resolução (a distância máxima entre pontos de dados a partir dos quais o elevação foi interpolada, em metros).

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

Confira abaixo um exemplo de resposta:

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

<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 desenvolver com as APIs de serviços da web do Google Maps fornecendo recursos implementações nativas de tarefas comuns, como autenticação, solicitação limitação e nova tentativa automática. A API Elevation está disponível no cliente Java, Cliente Python, Cliente Go e Cliente Node.js para serviços do Google Maps.

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

Autenticação

Para usar a Elevation API, você deve primeiro ativar a API e obter as credenciais de autenticação. Para mais informações, consulte Comece a usar a Plataforma Google Maps.

Cotas e preços

Revise o uso e o 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 a Políticas de API.

Saiba mais

Você pode fazer mais com a Elevation API, como solicitando dados de elevação de vários locais. Consulte a Guia do desenvolvedor da API Elevation para mais informações exemplos e outros detalhes.

O guia do desenvolvedor da API Elevation é destinado a sites e desenvolvedores para celular que desejam usar dados de elevação em mapas fornecidos por um dos APIs da Plataforma Google Maps. Ele fornece uma introdução ao uso da API e referências material sobre os parâmetros disponíveis.