A API Elevation fornece dados de elevação para todos os locais na superfície terrestre, incluindo locais em 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 do lado do servidor com o cliente Java, cliente Python, cliente Go e cliente Node.js para os 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 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, no Colorado, no estado de "quot;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'
JavaScript
var axios = require('axios'); var config = { method: 'get', url: 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY', headers: { } }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); });
Python
import requests url = "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY" payload={} headers = {} response = requests.request("GET", url, headers=headers, data=payload) print(response.text)
Java
OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("text/plain"); RequestBody body = RequestBody.create(mediaType, ""); Request request = new Request.Builder() .url("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY") .method("GET", body) .build(); Response response = client.newCall(request).execute();
Ruby
require "uri" require "net/http" url = URI("https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY") https = Net::HTTP.new(url.host, url.port) https.use_ssl = true request = Net::HTTP::Get.new(url) response = https.request(request) puts response.read_body
Go
package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY" method := "GET" client := &http.Client { } req, err := http.NewRequest(method, url, nil) if err != nil { fmt.Println(err) return } res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) }
Correio
A especificação da OpenAPI também está disponível como uma coleção Postman.
Executar no PostmanPara testar isso, insira o URL no seu navegador da Web. Lembre-se de
substituir YOUR_API_KEY
pela chave de API real.
A resposta inclui a elevação nesse ponto, em metros, além do valor de resolução, que é a distância máxima entre os pontos de dados em que a elevação foi interpolada, em metros.
Consulte o guia do desenvolvedor para mais informações sobre como criar URLs de solicitação e 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>
Especificação da OpenAPI
A especificação OpenAPI é publicada para essa API e está disponível no GitHub (em inglês).
Acessar especificação da OpenAPIColeção de cartas
A especificação da OpenAPI também está disponível como uma coleção Postman.
Executar no PostmanComeçar a codificar com nossas bibliotecas cliente
As bibliotecas de cliente facilitam o desenvolvimento com as APIs de serviços da Web do Google Maps ao fornecer implementações simples e nativas de tarefas comuns, como autenticação, limitação de solicitações e nova tentativa automática. A API Elevation está disponível no cliente Java, cliente Python, cliente Go e cliente Node.js para os serviços do Google Maps.
Autenticação, cotas, preços e políticas
Autenticação
Para usar a API Elevation, é necessário primeiro ativar a API e receber as credenciais de autenticação adequadas. Para mais detalhes, consulte o artigo Como 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 em conformidade com as políticas da API.
Saiba mais
Você pode fazer mais coisas com a API Elevation, como a solicitação de dados de elevação de vários locais. Consulte o guia do desenvolvedor 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. Ele fornece uma introdução ao uso da API e a materiais de referência sobre os parâmetros disponíveis.