Notícias

Um endpoint de altitude mais rápido para rotas longas

Um perfil de altitude de uma trilha ou de uma rota de carro raramente é uma única coordenada. São dezenas, às vezes centenas, de pontos ao longo de um percurso, cada um precisando de um valor de altitude para montar um gráfico de subida ou estimar o esforço pelo caminho. Esse padrão de uso, muitas coordenadas a serviço de uma rota contínua, é exatamente o que otimizamos em uma revisão recente do /v1/elevation.

O formato de requisição e de resposta do endpoint não mudou, e tudo o que está documentado em /docs/elevation-lookup/ continua valendo exatamente como está escrito. O que mudou foi a eficiência com que um grande lote de coordenadas ao longo de uma rota é processado internamente, com o objetivo de reduzir o tempo necessário para receber o perfil de altitude de um percurso longo, e não de um único ponto isolado.

Como uma requisição em lote conta cada coordenada como um item, exatamente como sempre contou, essa melhoria afeta a velocidade, não o preço nem o comportamento da cota. Uma rota com duzentos pontos de coordenadas continua contando como duzentas requisições na cota que se aplicar, seja a cota diária gratuita, o crédito pré-pago a € 0,0001 por requisição ou a cobertura de um pacote Unlimited. O que muda é o tempo que a resposta leva para voltar, o que importa diretamente para qualquer coisa que monte um perfil de rota de forma interativa, e não como uma tarefa em segundo plano.

Essa mesma melhoria vale para o nosso host de compatibilidade Open-Elevation em /compatibility/open-elevation/, já que ele usa o mesmo endpoint de altitude por trás. Tudo o que já envia lotes do tamanho de uma rota por esse host se beneficia do processamento mais rápido, sem nenhuma alteração necessária do lado da integração.

Aplicativos de rotas e de trilhas costumam ser exatamente onde esse tipo de melhoria é sentido de forma mais direta, já que um perfil de altitude que demora visivelmente mais para carregar do que a própria rota cria um atraso perceptível para o usuário que espera diante de um mapa. Uma resposta mais rápida para esses lotes mais longos, em formato de rota, elimina essa diferença.

Se a sua aplicação solicita a altitude de rotas compostas por muitas coordenadas, seja para trilhas, ciclismo ou rotas de carro, você deve perceber isso como uma melhoria discreta na rapidez com que um perfil completo volta, sem que nada mais na integração precise mudar. A documentação completa do endpoint continua em /docs/elevation-lookup/.