O que lançamos este mês: geocodificação, IP, fuso horário e mais
Um resumo do trabalho recente em toda a API: novos hosts de compatibilidade, consultas de fuso horário e altitude mais rápidas, recursos no painel e mais visibilidade sobre a cota.
Compatibilidade drop-in com o LocationIQ já está no ar
O LocationIQ conquistou espaço em muitas stacks que começaram pequenas e cresceram, muitas vezes porque era fácil de adotar no início. Nosso host compatível é voltado exatamente para esse tipo de integração: uma que funciona bem hoje, nunca foi pensada para ser permanente e simplesmente nunca compensou ser reescrita.
O host reproduz exatamente os parâmetros de requisição e o corpo de resposta do LocationIQ, exceto os textos de direitos autorais, termos e privacidade, que são do próprio My Geocode. Requisições no formato dos endpoints do LocationIQ podem ser enviadas ao nosso host sem alteração, e a resposta retornada é interpretada da mesma forma que o código existente já espera.
Essa exatidão não é fruto do esforço gasto em cada provedor. Todos os hosts compatíveis ficam sobre o mesmo sistema de faturamento, cotas e contas que roda o restante do My Geocode, então construir um novo é principalmente um exercício de mapeamento, fazendo corresponder nomes de campos e formatos de parâmetros ao que os clientes de um determinado provedor já enviam, em vez de montar um backend separado. É por isso que os preços, a autenticação e o controle de cotas se comportam de forma idêntica nos dezessete hosts, em vez de se distanciarem uns dos outros com o tempo.
A autenticação segue o mesmo padrão usado em todos os hosts da plataforma. Envie sua chave como cabeçalho X-API-Key, como cabeçalho Authorization: Bearer, via HTTP Basic auth com a chave como nome de usuário ou como parâmetro de consulta, correspondendo ao que sua integração atual com o LocationIQ já faz. As quatro formas são aceitas aqui sem exceção, então migrar raramente significa mexer no seu cliente HTTP.
Os preços não mudam conforme o host ou endpoint que atende a chamada. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem precisar de chave, contadas por rede, para que a cota corresponda de forma sensata a uma conexão compartilhada, e não a cada dispositivo por trás dela. Uma chave adiciona mais 2.500 requisições gratuitas por dia próprias, controladas separadamente da cota sem chave na mesma rede. Além dessas, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre tudo por € 50 por mês.
Toda resposta traz nosso conjunto completo de cabeçalhos de cota, independentemente do host compatível que a atendeu: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used e X-Credits-Remaining vêm nas respostas deste host exatamente como vêm nos nossos endpoints nativos, então qualquer coisa construída em torno desses cabeçalhos continua funcionando sem mudanças.
Se um projeto precisa de mais do que a resposta compatível oferece, mg_extras=1 na requisição, ou um cabeçalho X-MG-Extras, acrescenta campos extras opcionais por cima, de forma totalmente opcional. Em uma chamada de geocodificação, isso pode incluir a altitude do terreno para as coordenadas retornadas, obtida da mesma fonte que responde diretamente a /v1/elevation. Sem isso, o formato da resposta corresponde com precisão ao do LocationIQ, sem surpresas para a lógica de interpretação existente.
Contas que fazem a troca e veem que ela aguenta tráfego real muitas vezes acabam recomendando-a a quem mais da equipe ainda paga pelo provedor original. O programa de indicação no painel, em /dashboard/referrals, foi feito exatamente para esse tipo de boca a boca.
O host está documentado em /compatibility/locationiq/, e as orientações gerais sobre como trocar de provedor estão em /docs/compatibility/. Uma única chamada de teste com uma chave nova geralmente basta para confirmar que ele se encaixa sem problemas em uma integração existente.