Migração

Migrando do Open-Elevation

O Open-Elevation é um projeto de código aberto construído em torno de uma ideia simples: enviar um array de pares de latitude e longitude e receber de volta um array de valores de altitude em metros. Ele costuma ser auto-hospedado, seja usando a instância pública de demonstração do projeto para uso leve, seja em infraestrutura privada carregada com um conjunto de dados de altitude escolhido para qualquer uso mais sério. Essa simplicidade no formato da requisição é de fato um dos seus pontos fortes, e qualquer migração que valha a pena deve mantê-la.

A auto-hospedagem traz custos reais de manutenção que são fáceis de subestimar no início: os conjuntos de dados de altitude ocupam um espaço em disco considerável, o servidor precisa ficar no ar e as atualizações dos dados subjacentes são um projeto manual, e não algo que acontece automaticamente. Uma equipe que montou isso no começo da vida de um projeto às vezes descobre, um ou dois anos depois, que o peso da manutenção supera o motivo pelo qual escolheu a auto-hospedagem.

O My Geocode oferece a consulta de altitude como um endpoint totalmente funcional, e não como uma camada de compatibilidade que só reproduz o formato, já que esta é uma das consultas em que resultados reais podem ser mostrados diretamente. Uma requisição para um par de coordenadas retorna a altitude do terreno naquele ponto em metros, obtida a partir dos nossos próprios dados de altitude, sem exigir que você obtenha, carregue e mantenha um conjunto de dados por conta própria. Os detalhes estão em /docs/elevation-lookup/.

Para equipes que migram especificamente do estilo de requisição e resposta baseado em arrays do Open-Elevation, as diferenças práticas são:

  • Autenticação: o Open-Elevation normalmente não exige nenhuma na instância pública, enquanto o My Geocode usa uma chave enviada como cabeçalho X-API-Key, Authorization: Bearer, autenticação HTTP Basic ou parâmetro de consulta (2.500 requisições por dia funcionam sem nenhuma chave)
  • Nenhum servidor para operar, nenhum conjunto de dados para baixar ou atualizar e nenhum espaço em disco para provisionar
  • Uma cota diária previsível e preços claros além dela, em vez do risco de indisponibilidade de uma infraestrutura gerenciada por você

Além das 2.500 requisições gratuitas por dia sem chave, e de outras 2.500 gratuitas por chave por dia, contadas por rede, as consultas de altitude têm o mesmo preço de todos os outros endpoints: crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês.

Para aplicações que chamam a altitude como parte de um fluxo de trabalho maior, como perfis de rotas de trilha ou de ciclismo, planejamento de voos de drone ou ferramentas de levantamento topográfico, o formato da requisição fica próximo o suficiente do que o Open-Elevation já espera para que isso costume ser um trabalho pequeno e contido: troque o endpoint e a autenticação e mantenha o resto.

Se a auto-hospedagem foi escolhida originalmente para evitar totalmente custos recorrentes, e não pelo controle sobre os dados, vale a pena fazer as contas reais do seu volume de chamadas em relação à cota gratuita e ao preço por requisição antes de decidir, já que, na prática, muitas consultas de altitude ficam bem dentro do que o nível gratuito sozinho cobre.