O OpenCage conquistou seu público ao tornar a geocodificação acessível: um único parâmetro de chave, uma resposta JSON com um array results e um objeto components que divide um endereço em campos como road, city e country. Ele combina dados de várias fontes abertas em vez de manter um conjunto de dados proprietário, o que é parte do motivo pelo qual desenvolvedores que valorizam transparência sobre a origem dos seus dados de localização tendem a preferi-lo.
Sair de um provedor escolhido em parte pela simplicidade levanta uma pergunta justa: a nova opção mantém as coisas tão simples assim? A resposta honesta depende daquilo com que você compara. Um cadastro de conta genérico com um formulário de cobrança é uma experiência diferente de colocar uma chave em um cabeçalho, e vale a pena verificar qual das duas você está de fato substituindo.
O host compatível com OpenCage do My Geocode reproduz o array results e a divisão em components que o OpenCage retorna, e os textos de copyright, termos e privacidade são a única parte que muda. A referência campo a campo fica em /compatibility/opencage/. Para a maioria das integrações, isso significa atualizar o host da requisição e o valor da chave, enquanto o código que lê results[0].components.city ou results[0].formatted continua funcionando como foi escrito.
A autenticação do nosso lado aceita um cabeçalho X-API-Key, um cabeçalho Authorization: Bearer, autenticação HTTP Basic ou um parâmetro de consulta, então um cliente que já envia a chave do OpenCage como parâmetro de query string geralmente continuará funcionando com um novo valor de chave e nada mais alterado na lógica da requisição.
O nível gratuito é uma parte importante desta comparação para quem escolheu o OpenCage pela acessibilidade para projetos pequenos e paralelos. O My Geocode oferece 2.500 requisições gratuitas por dia a partir de qualquer endereço, sem nenhuma chave, e cada chave também recebe 2.500 requisições gratuitas por dia, contadas por rede e compartilhadas entre o uso com e sem chave a partir dessa mesma rede. Além disso, os preços são crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês, com todos os endpoints, incluindo todos os hosts compatíveis, pelo mesmo preço.
Algo que vale testar diretamente em vez de presumir: as annotations. Se a sua integração com o OpenCage lê campos extras de annotations, como informações de fuso horário ou moeda incluídas na resposta de geocodificação, compare os campos documentados do host compatível com o que o seu código de parsing espera, já que parte desses detalhes pode precisar vir de um endpoint dedicado, como a própria consulta de fuso horário do My Geocode, em vez de estar embutida na resposta de geocodificação.
Para um projeto que começou pequeno e cresceu, a simplicidade que fez do OpenCage uma primeira escolha fácil não precisa ser algo de que você abre mão ao trocar de provedor. Uma chave que funciona em qualquer estilo que o seu cliente já use para enviá-la, uma cota diária gratuita sem necessidade de cadastro para começar a testar e um preço único para todos os endpoints mantêm a experiência de onboarding próxima daquela a que muitos usuários do OpenCage estão acostumados.