![Visão geral da API Elevation](https://developers.google.cn/static/maps/images/landing/maps-api_960.png?authuser=7&hl=pt-br)
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:
|
|
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:
- Java Cliente para serviços do Google Maps
- Python Cliente para serviços do Google Maps
- Cliente Go para serviços do Google Maps
- Node.js Cliente para serviços do Google Maps
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
- Comece a usar a API Elevation: acesse Configure seu projeto do Google Cloud.
- Tente coletar dados de elevação com base no caminho: acesse Como especificar caminhos
- Siga as práticas recomendadas: acesse Serviço da Web Práticas recomendadas.