Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Elevation es un servicio que devuelve datos de elevación para
una ubicación en la tierra o muestras de datos de elevación a lo largo de rutas.
Por qué usar la API de Elevation
Con la API de Elevation, puedes desarrollar aplicaciones que admitan tus
clientes con actividades sensibles a la elevación, aplicaciones de posicionamiento o encuestas de poca intensidad
aplicaciones que incluyen elevaciones y cambios de elevación a lo largo de las rutas. Por ejemplo:
puedes proporcionar datos de ganancias y pérdidas de elevación para mejorar una aplicación de deportes para actividades como
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 tu
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 una serie de ubicaciones a lo largo de una ruta. Esta solicitud,
por ejemplo, consulta de elevación para el centro de Denver, Colorado, especificando un retorno en formato JSON.
El servicio obtiene la elevación de las coordenadas proporcionadas. También interpola
elevación de una ubicación sin elevación, lo que proporciona un promedio devuelto de los cuatro
las ubicaciones más cercanas que proporcionan datos de elevación. Por último, determina el impacto general
resolución de la ubicación.
Recursos
En la siguiente tabla, se resumen los recursos disponibles mediante las
Elevation API 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 bien como una serie a lo largo de una ruta. Tú
también puede proporcionar coordenadas codificadas. Pasa hasta 512 coordenadas.
La API de Elevation proporciona la elevación en metros relativa,
al nivel medio del mar local (LMSL). La elevación se puede mostrar como positiva.
o negativos, como se indica a continuación:
Los valores positivos indican ubicaciones por encima de SGAL.
incluidas las ubicaciones de la superficie
o el fondo de lagos que están a gran altura.
Los valores negativos indican las ubicaciones que están por debajo del SGA, como
ubicaciones en la superficie o el fondo marino.
La resolución indica la distancia entre el punto de datos y la
elevación, en metros.
Una vez que tengas una clave de API, puedes comenzar a probar la API de Elevation directamente desde
tu navegador. Consulta Solicitudes de muestra
en la guía de introducción para obtener más detalles.
Explora las respuestas de datos de elevación para prepararte para usar los datos de elevación de tu app. Consulta
Respuestas de Elevation
para conocer los detalles.
5
Incorpora datos de elevación en tu propia app.
Puedes usar los datos de elevación para mejorar las apps basadas en la ubicación, como las de deportes.
actividades o datos de encuestas.
Bibliotecas cliente disponibles
Llama a esta API en el lenguaje de
que elijas mediante una de las siguientes bibliotecas cliente:
Los clientes de Java, Python, Go y Node.js para Google Maps
Los servicios son bibliotecas cliente con asistencia de la comunidad, de código abierto en el
Licencia 2.0 de Apache.
Descárgalas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-26 (UTC)"],[[["\u003cp\u003eThe Elevation API provides elevation data for locations on Earth, enabling applications with elevation-sensitive features.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve elevation for single points or calculate elevation differences along paths, useful for activities like hiking or biking.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts latitude/longitude coordinates and returns elevation data in meters relative to local mean sea level, with resolution information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access the Elevation API through various client libraries (Java, Python, Go, Node.js) and integrate it into their applications.\u003c/p\u003e\n"],["\u003cp\u003eTo get started, set up a Google Cloud project, try sample requests, and explore the documentation for detailed usage instructions.\u003c/p\u003e\n"]]],[],null,["The Elevation API is a service that returns elevation data for\na location on the earth, or sampled elevation data along paths.\n\nWhy use the Elevation API\n\nWith the Elevation API, you can develop applications to support your\ncustomers with elevation-sensitive activities, positioning applications, or low-surveying\napplications that include elevations and elevation changes along routes. For example,\nyou can provide elevation gain and loss data to enhance a sports application for activities such\nas hiking, biking, or scuba diving.\n\nWhat you can do with the Elevation API\n\nWith the Elevation API, you can include elevation data in your\napplications or on a map. For example:\n\n- Get the **elevation** for a particular place.\n- Calculate the **differences** in elevation along a route or between two points.\n\nHow the Elevation API works The Elevation API accepts a request as an encoded URL with latitude/longitude coordinates provided as either discrete locations, or as a series of locations along a path. This request, for example, queries elevation for the center of Denver, Colorado, specifying a return in JSON format. \n\n```scdoc\n https://maps.googleapis.com/maps/api/elevation/json\n ?locations=39.7391536%2C-104.9847034\n &key=YOUR_API_KEY\n```\n\nThe service derives the elevation for the provided coordinates. It also interpolates\nelevation for a location without elevation, providing an average returned from the four\nnearest locations that do provide elevation data. Finally, it determines the overall\nresolution for the location.\n\nResources\n\nThe following table summarizes the resources available through the\nElevation API along with the data it returns.\n\n| Data resources | Data returned | Return format |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **Latitude/longitude coordinates** You can provide data as a set of one or more locations, or as a series along a path. You can also provide encoded coordinates. Pass up to 512 coordinates. | The Elevation API provides **elevation in meters** relative to the **local mean sea level** (LMSL). Elevation can be returned as positive or negative values as indicated below: - **Positive values** indicate locations above LMSL, including surface locations or the bottom of high-altitude lakes. - **Negative values** indicate locations that are below LMSL, including locations on the surface or the ocean floor. - **Resolution** indicates the distance between the data point and the elevation, in meters. | - JSON - XML |\n\nHow to use the Elevation API\n\n|---|---------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try an elevation request** | Once you have an API key, you can start testing out the Elevation API directly from your browser. See [Sample requests](/maps/documentation/elevation/start#sample-request) in the *Getting started* guide for details. |\n| 3 | **Compose a more complex request** | Once you are set up with a project, try a request that supplies a location data along a path. See [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths) for details. |\n| 4 | **Understand response basics** | Explore the elevation data responses to prepare to use elevation data for your app. See [Elevation responses](/maps/documentation/elevation/requests-elevation#ElevationResponses) for details. |\n| 5 | **Incorporate elevation data into your own app!** | You can use elevation data to enhance location-based apps, such as apps for sports activities or for survey data. |\n\nAvailable client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n\n- **Start using the Elevation API** : Go to [Set up your\n Google Cloud project](/maps/documentation/elevation/cloud-setup).\n- **Try getting path-based elevation data** : Go to [Specifying paths](/maps/documentation/elevation/requests-elevation#Paths)\n- **Follow best practices** : Go to [Web Service\n Best Practices](/maps/documentation/elevation/web-service-best-practices)."]]
