La API de Elevation proporciona datos de elevación para todas las ubicaciones sobre la superficie terrestre, incluidas ubicaciones profundas en el lecho marino (que muestran valores negativos).
Este servicio también está disponible como parte de la API de Maps JavaScript del cliente o para el uso del servidor con el Cliente de Java, el cliente de Python, el cliente de Go y el cliente de Node.js para los servicios de Google Maps.
Ejemplo de solicitud y respuesta
Puedes acceder a la API de Elevation mediante una interfaz HTTP, con solicitudes construidas como una string de URL, mediante coordenadas de latitud y longitud para identificar las ubicaciones o los vértices de rutas de acceso. Las solicitudes tienen que incluir tu clave de API.
En el siguiente ejemplo, se solicita la elevación para Denver, Colorado, la “Mile High City”, en 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
Comienza a usarlo
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))
}
Postman
La especificación de OpenAPI también está disponible como una colección de Postman.
Ejecutar en PostmanPara probar esto, ingresa la URL en tu navegador web (asegúrate de reemplazar YOUR_API_KEY por tu clave de API real).
La respuesta incluye la elevación en ese punto, en metros, junto con el valor de resolución (la distancia máxima entre los puntos de datos a partir de los cuales se interpoló la elevación, en metros).
Consulta la guía para desarrolladores a fin de obtener más información sobre cómo compilar las URL de solicitud y los parámetros disponibles, y cómo comprender la respuesta.
A continuación, se muestra un ejemplo de respuesta:
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>
Especificación de OpenAPI
La especificación de OpenAPI se publicó para esta API y está disponible en GitHub.
Obtener especificaciones de OpenAPIColección de carteros
La especificación de OpenAPI también está disponible como una colección de Postman.
Ejecutar en PostmanComienza a realizar codificaciones con nuestras bibliotecas de cliente
Las bibliotecas cliente facilitan el desarrollo con las API del servicio web de Google Maps, ya que proporcionan implementaciones nativas sencillas de tareas comunes, como la autenticación, la limitación de solicitudes y los reintentos automáticos. La API de Elevation está disponible en el Cliente de Java, el cliente de Python, el cliente de Go y el cliente de Node.js para los servicios de Google Maps.
Autenticación, cuotas, precios y políticas
Autenticación
Para usar la API de Elevation, primero debes habilitar la API y obtener las credenciales de autenticación correspondientes. Para obtener más información, consulta Cómo comenzar a utilizar Google Maps Platform.
Cuotas y precios
Consulta la página Uso y facturación para obtener detalles sobre las cuotas y los precios establecidos para la API de Elevation.
Políticas
El uso de la API de Elevation debe cumplir con las políticas de API.
Más información
Puedes realizar más acciones con la API de Elevation, como solicitar datos de elevación de varias ubicaciones. Consulta la Guía para desarrolladores de la API de Elevation a fin de obtener más ejemplos y otros detalles.
La guía para desarrolladores de la API de Elevation está diseñada para desarrolladores de sitios web y dispositivos móviles que deseen usar datos de elevación dentro de los mapas proporcionados por una de las API de Google Maps Platform. Proporciona una introducción al uso de la API y material de referencia sobre los parámetros disponibles.