La API de Elevation proporciona datos de elevación para todas las ubicaciones sobre la superficie de la Tierra, incluidas las ubicaciones en profundidad que se encuentran sobre el fondo marino (para las cuales se muestran valores negativos).
Este servicio también está disponible como parte de la API de Maps JavaScript del cliente , o para su uso del servidor con las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps.
Ejemplo de solicitud y respuesta
Accedes a la API de Elevation a través de una interfaz HTTP, con solicitudes construidas como una cadena de URL, usando coordenadas de latitud y longitud para identificar las ubicaciones o los vértices de la ruta. Las solicitudes tienen que incluir tu clave de API.
En el siguiente ejemplo, se solicita la elevación de Denver, Colorado, la "Ciudad de la Milla de Altura", en formato JSON:
URL
https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEYcURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'
Para probarlo, ingresa la URL en tu navegador web (asegúrate de reemplazar
YOUR_API_KEY con 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 en metros entre los puntos de datos a partir de los cuales se interpoló la elevación).
Consulta la guía para desarrolladores para obtener más información sobre cómo compilar URLs de solicitud y los parámetros disponibles y comprender la respuesta.
A continuación, se muestra una respuesta de ejemplo:
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>
</pre>
Comienza a programar con nuestras bibliotecas cliente
Las bibliotecas cliente facilitan el desarrollo con las APIs de servicios web de Google Maps, ya que proporcionan implementaciones integradas de tareas comunes, como la autenticación, la limitación de solicitudes y el reintento automático. La API de Elevation está disponible en las bibliotecas cliente de Java, Python, Go y 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 habilitarla y obtener las credenciales de autenticación adecuadas. Para obtener más información, consulta Cómo comenzar a utilizar Google Maps Platform.
Cuotas y precios
Revisa la página de 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 la API.
Más información
Hay más cosas que puedes hacer 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 para obtener más ejemplos y otros detalles.
La Guía para desarrolladores de la API de Elevation está destinada a desarrolladores de sitios web y dispositivos móviles que desean usar datos de elevación en mapas proporcionados por una de las APIs de Google Maps Platform. Proporciona una introducción al uso de la API y material de referencia sobre los parámetros disponibles.