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 en rutas de acceso.

Por qué usar la API de Elevation

Con la API de Elevation, puedes desarrollar aplicaciones para ayudar a tus clientes con actividades sensibles a la elevación, aplicaciones de posicionamiento o aplicaciones de encuestas bajas que incluyen elevaciones y cambios de elevación en las rutas. Por ejemplo, puedes proporcionar datos de ganancia y pérdida de elevación para mejorar una aplicación deportiva 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 en 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 en una ruta. Esta solicitud, por ejemplo, consulta la elevación del centro de Denver, Colorado, y especifica un valor que se mostrará 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 para una ubicación sin elevación, lo que proporciona un promedio de las cuatro ubicaciones más cercanas que sí proporcionan datos de elevación. Por último, determina la resolución general de la ubicación.

Recursos

La siguiente tabla resume 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 en una ruta. También puedes proporcionar coordenadas codificadas. Pasa hasta 512 coordenadas.

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

  • Valores positivos: Indican las ubicaciones sobre el SGA, incluidas las ubicaciones de la superficie o la parte inferior de los lagos a gran altitud.
  • Los valores negativos indican las ubicaciones que están por debajo del SGAL, incluidas las ubicaciones en la superficie o el fondo marino.
  • Resolution indica la distancia entre el punto de datos y la elevación, en metros.
  • JSON
  • XML

Cómo usar la API de Elevation

1 Configuración Comienza con Configura tu proyecto de Google Cloud y completa las siguientes instrucciones de configuración.
2 Prueba una solicitud de elevación Una vez que tengas una clave de API, podrás comenzar a probarla directamente desde tu navegador. Consulta las solicitudes de muestra en la guía para comenzar 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 a fin de prepararte para usar datos de elevación para tu app. Consulta Respuestas de elevación para obtener más informació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 apps para actividades deportivas o los datos de encuestas.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje que elijas a través de una de las siguientes bibliotecas cliente:

Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas cliente compatibles con la comunidad y de código abierto bajo la licencia Apache 2.0. Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos