My Geocode

Migração

Saindo de uma integração de altitude do Bing Maps

· 2 min de leitura · My Geocode · #bing-maps#elevation#migration#api

O Bing Maps oferece dados de altitude por meio da sua Elevations API, que retorna valores de altitude do terreno para um ou mais pontos de coordenadas, normalmente em metros, como parte da mesma conta mais ampla do Bing Maps Dev Center usada para geocodificação e outros serviços de localização. Como a maioria das dependências de altitude, ela costuma ser chamada a partir de uma parte restrita da aplicação: um gráfico de perfil de rota, uma sobreposição de relevo ou uma ferramenta de planejamento de voo, e não algo espalhado por todo o código.

Esse escopo restrito ajuda de verdade em uma migração. As chamadas de altitude geralmente ficam isoladas atrás de um pequeno serviço ou módulo utilitário, e a resposta em si traz pouco além de uma coordenada e um número, o que limita a quantidade de lógica de parsing que precisa ser revisada em comparação com uma migração de geocodificação.

A consulta de altitude do My Geocode é um endpoint independente e totalmente funcional, documentado em /docs/elevation-lookup/, sem ligação com nenhum host compatível de geocodificação. Uma requisição para uma coordenada retorna diretamente a altitude do terreno e, como esta é uma das consultas em que resultados reais podem ser descritos e testados de forma concreta, verificar a migração com alguns pontos de referência de altitude conhecidos é uma forma prática e rápida de ganhar confiança.

O que vale verificar especificamente ao sair do serviço de altitude do Bing:

  • Se a sua aplicação solicita altitude em lotes (várias coordenadas por chamada) e, nesse caso, testar o novo endpoint com o tamanho de lote habitual antes de presumir uma vazão idêntica
  • Se as convenções de unidade importam em algum ponto posterior, já que valores de altitude em metros são o padrão, mas qualquer código que converta para pés na exibição deve ser verificado com a saída bruta do novo endpoint
  • Se as chamadas de altitude acontecem de forma síncrona, como parte de uma requisição voltada ao usuário, ou de forma assíncrona, como parte de um processamento em segundo plano, já que isso afeta quanta tolerância à latência você realmente precisa testar

A autenticação do novo endpoint aceita uma chave como X-API-Key, Authorization: Bearer, autenticação HTTP Basic ou parâmetro de consulta. Os preços seguem a mesma estrutura fixa de todos os outros endpoints: 2.500 requisições gratuitas por dia sem chave, mais 2.500 gratuitas por chave por dia, contadas por rede, e depois crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês.

Se a altitude foi originalmente incluída em uma conta mais ampla do Bing Maps mais por conveniência do que por necessidade, retirá-la primeiro, antes de uma migração de geocodificação, reduz o que ainda depende da conta original e oferece um teste de baixo risco do processo de migração antes de encarar algo maior.

Mais em Migração