Comenzar

La API de Elevation proporciona datos de elevación para todas las ubicaciones en la la superficie terrestre, incluidas las ubicaciones profundas en el fondo marino (que para obtener valores negativos).

Este servicio también está disponible como parte del servicio API de Maps JavaScript, o para uso del servidor con el un cliente de Java, Cliente de Python, cliente de Go y cliente de 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 construidas como una cadena de URL, usando coordenadas de latitud y longitud para identificar las ubicaciones o los vértices de la ruta de acceso. Las solicitudes tienen que incluir tu clave de API.

En el siguiente ejemplo, se solicita la elevación para Denver, Colorado, el "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 puntos de datos desde los que la se interpoló la elevación, en metros).

Consulta la guía para desarrolladores para obtener más información Creación de URLs de solicitud y parámetros disponibles y 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>

Comienza a realizar codificaciones con nuestras bibliotecas de cliente

Las bibliotecas cliente desarrollar con las Web Service API de Google Maps es más fácil al brindar implementaciones nativas de tareas comunes, como la autenticación, y el reintento automático. La API de Elevation está disponible en la Java Client, 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 los permisos credenciales de autenticación. Para obtener más información, consulta Comienza a utilizar Google Maps Platform.

Cuotas y precios

Revisa el uso y la 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 las APIs

Más información

Puedes realizar más acciones con la API de Elevation, como solicitud de datos de elevación desde varias ubicaciones. Consulta el Guía para desarrolladores sobre la API de Elevation para obtener más información ejemplos y otros detalles.

El La guía para desarrolladores sobre la API de Elevation está diseñada para sitios web y desarrolladores de apps para dispositivos móviles que desean usar datos de elevación dentro de mapas proporcionados por uno de los APIs de Google Maps Platform. Proporciona una introducción al uso de la API y referencias material sobre los parámetros disponibles.