Começar

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 Postman

Para 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 OpenAPI

Coleção de cartas

A especificação da OpenAPI também está disponível como uma coleção Postman.

Executar no Postman

Começ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.