A API Elevation fornece dados de elevação para todos os locais na superfície da Terra, incluindo locais de profundidade 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 no lado do servidor com o Cliente Java, Cliente Python, Cliente Go e Cliente 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 isso, insira o URL no navegador da Web. Substitua
YOUR_API_KEY pela sua chave de API real.
A resposta inclui a elevação nesse ponto, em metros, e o valor da resolução (a distância máxima entre os pontos de dados em que 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 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 do serviço da Web do Google Maps, oferecendo implementações simples e nativas 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 ative a API e receba 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 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
Você pode fazer mais com a API Elevation, como solicitar dados de elevação de vários locais. Consulte o guia para desenvolvedores da API Elevation para 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 em mapas fornecidos por uma das APIs da Plataforma Google Maps. Ela oferece uma introdução ao uso da API e material de referência sobre os parâmetros disponíveis.