Comenzar

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 los clientes de Java, Python, Go y Node.js para los servicios de Google Maps.

Ejemplo de solicitud y respuesta

Puedes acceder a la API de Elevation a través de una interfaz HTTP, con solicitudes construidas como una string de URL, usando coordenadas de latitud y longitud para identificar las ubicaciones o los vértices de rutas. 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'

Para 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 datos desde los que se interpoló la elevación, en metros).

Consulta la guía para desarrolladores si quieres obtener más información sobre cómo compilar URLs de solicitud y los parámetros disponibles y cómo comprender la respuesta.

A continuación, se incluye 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>

Comienza a realizar codificaciones con nuestras bibliotecas de cliente

Las bibliotecas cliente facilitan el desarrollo con las APIs de servicio web de Google Maps, ya que proporcionan implementaciones nativas simples de tareas comunes, como autenticación, regulación de solicitudes y reintento automático. La API de Elevation está disponible en los clientes 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

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 la 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 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.