Descripción general de la API de Elevation

La API de Elevation es un servicio que muestra datos de elevación para una ubicación en la Tierra, o datos de elevación muestreados a lo largo de las rutas.

Por qué usar la API de Elevation

Con la API de Elevation, puedes desarrollar aplicaciones para brindar asistencia a tus clientes con actividades sensibles a la elevación, aplicaciones de posicionamiento o aplicaciones de baja escala que incluyan elevaciones y cambios de elevación a lo largo de las rutas. Por ejemplo, puedes proporcionar datos de aumento y pérdida de elevación a fin de mejorar una aplicación de deportes para actividades como senderismo, ciclismo o buceo.

Qué puedes hacer con la API de Elevation

Con la API de Elevation, puedes incluir datos de elevación en tus aplicaciones o en un mapa. Por ejemplo:

  • Obtén la elevación de un lugar en particular.
  • Calcula las diferencias de elevación a lo largo de una ruta o entre dos puntos.

Cómo funciona la API de Elevation

La API de Elevation acepta una solicitud como una URL codificada con coordenadas de latitud y longitud proporcionadas como ubicaciones discretas o como una serie de ubicaciones a lo largo de una ruta. Esta solicitud, por ejemplo, consultas sobre la elevación para el centro de Denver, Colorado, especifica un resultado en formato JSON. 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

El servicio deriva la elevación de las coordenadas proporcionadas. También interpola la elevación de una ubicación sin elevación, lo que proporciona un promedio que se muestra a partir de las cuatro ubicaciones más cercanas que proporcionan datos de elevación. Por último, determina la resolución general de la ubicación.

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de Elevation junto con los datos que muestra.

Recursos de datos Datos mostrados Formato de devolución
Coordenadas de latitud y longitud

Puedes proporcionar datos como un conjunto de una o más ubicaciones, o como una serie a lo largo de una ruta. También puedes proporcionar coordenadas codificadas. Pasa hasta 512 coordenadas.

La API de Elevation proporciona elevación en metros según el nivel medio del mar local (LMSL). La elevación se puede mostrar como valores positivos o negativos, como se indica a continuación:

  • Los valores positivos indican ubicaciones por encima de la LMSL, incluidas las ubicaciones en la superficie o el fondo de lagos a gran altura.
  • Los valores negativos indican ubicaciones por debajo del LMSL, incluidas las ubicaciones en la superficie o el fondo marino.
  • Resolution indica la distancia entre los datos y la elevación, en metros.
  • JSON
  • XML

Cómo usar la API de Elevation

1 Prepárate. Para comenzar, consulta Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación.
2 Cómo probar una solicitud de elevación Una vez que tengas una clave de API, puedes comenzar a probar la API de Elevation directamente desde tu navegador. Consulta Solicitudes de ejemplo en la guía de introducción para obtener más detalles.
3 Cómo redactar una solicitud más compleja Una vez que configures un proyecto, intenta realizar una solicitud que proporcione datos de ubicación a lo largo de una ruta. Consulta Especifica rutas de acceso para obtener más detalles.
4 Comprende los conceptos básicos de las respuestas Explora las respuestas de datos de elevación y prepárate para usar los datos de elevación de tu app. Para obtener más información, consulta las respuestas de elevación.
5 Incorpora datos de elevación a tu propia app Puedes usar los datos de elevación para mejorar las apps basadas en la ubicación, como las de actividades deportivas o los datos de encuestas.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje que prefieras mediante una de las siguientes bibliotecas cliente:

Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas de código abierto basadas en la licencia Apache 2.0 que asisten a la comunidad. Descárgalos desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos