Visão geral da API Elevation
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A Elevation API é um serviço que retorna dados de elevação para
um local na Terra ou dados de elevação com amostragem ao longo de caminhos.
Por que usar a API Elevation
Com a API Elevation, você pode desenvolver aplicativos de suporte para suas
clientes com atividades sensíveis à elevação, aplicativos de posicionamento ou pesquisas
aplicações que incluem elevações e mudanças de elevação ao longo dos trajetos. Por exemplo:
você pode fornecer dados de ganho e perda de elevação para aprimorar um aplicativo esportivo para atividades como
como caminhada, ciclismo ou mergulho.
O que você pode fazer com a API Elevation
Com a Elevation API, você pode incluir dados de elevação em seu
aplicativos ou em um mapa. Exemplo:
- Descubra a elevação de um lugar específico.
- Calcular as diferenças de elevação ao longo de um trajeto ou entre dois
pontos.
Como a API Elevation funciona
A Elevation API aceita uma solicitação como um URL codificado com coordenadas de latitude/longitude
fornecidos como locais discretos ou como uma série de locais ao longo de um caminho. Essa solicitação,
por exemplo, consulta elevação para o centro de Denver, Colorado, especificando um retorno no formato JSON.
https://maps.googleapis.com/maps/api/elevation/json
?locations=39.7391536%2C-104.9847034
&key=YOUR_API_KEY
O serviço deriva a elevação para as coordenadas fornecidas. Ela também interpola
elevação para um local sem elevação, fornecendo uma média retornada dos quatro
locais mais próximos que forneçam dados de elevação. Por fim, determina
do local.
Recursos
A tabela a seguir resume os recursos disponíveis no
Elevation API junto com os dados retornados.
| Recursos de dados |
Dados retornados |
Formato de devolução |
| Coordenadas de latitude/longitude
Você pode fornecer dados como um conjunto de um ou mais locais ou como uma série ao longo de um caminho. Você
também podem fornecer coordenadas codificadas. Transmita até 512 coordenadas.
|
A Elevation API fornece elevação em metros relativa
ao nível do mar médio local (LMSL). A elevação pode ser retornada como positiva
ou valores negativos, conforme indicado abaixo:
- Valores positivos indicam locais acima da LMSL,
incluindo as localizações da superfície ou o fundo de lagos de alta altitude.
- Os valores negativos indicam locais abaixo da LMSL, incluindo:
locais na superfície ou no fundo do oceano.
- Resolução indica a distância entre o ponto de dados e o
elevação, em metros.
|
|
Como usar a API Elevation
| 1 |
Prepare-se. |
Comece com a etapa Configurar seu
projeto do Google Cloud
e conclua a configuração
as instruções a seguir. |
| 2 |
Testar uma solicitação de elevação |
Quando você tiver uma chave de API, poderá começar a testar a API Elevation diretamente no
seu navegador. Consulte Exemplos de solicitações.
no guia Vamos começar para mais detalhes.
|
| 3 |
Criar uma solicitação mais complexa |
Quando um projeto estiver configurado, tente uma solicitação que forneça dados de local junto com uma
caminho. Consulte Como especificar caminhos.
para mais detalhes.
|
| 4 |
Noções básicas sobre respostas |
Explore as respostas dos dados de elevação para se preparar para usá-los no seu app. Consulte
Respostas do Elevation
para mais detalhes.
|
| 5 |
Incorpore dados de elevação ao seu app. |
Você pode usar dados de elevação para aprimorar apps baseados em localização, como apps de esportes
atividades ou para dados de pesquisa.
|
Bibliotecas de clientes disponíveis
Chame essa API no idioma do
sua escolha por meio de uma das seguintes bibliotecas de cliente:
Os clientes Java, Python, Go e Node.js para Google Maps
Os serviços são bibliotecas-cliente com suporte da comunidade, com código aberto de acordo com a
Licença Apache 2.0.
Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 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)."]]
