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 Geoapify já está no ar
O Geoapify combina geocodificação com um conjunto mais amplo de ferramentas de localização, o que significa que as integrações construídas com ele às vezes tocam mais partes do código do que uma única chamada de API sugeriria. Nosso host compatível se concentra estritamente no formato de requisição e resposta de geocodificação, reproduzido com exatidão, para que essa parte possa migrar sem mexer em tudo o que está ao redor.
O host reproduz com precisão os parâmetros de requisição e o corpo de resposta do Geoapify, exceto os textos de direitos autorais, termos e privacidade, que são nossos e não do provedor original. Uma requisição montada hoje para os endpoints de geocodificação do Geoapify pode ser enviada ao nosso host como está, e o JSON retornado é interpretado da mesma forma que o código existente já espera.
Restringir o escopo dessa forma é proposital. A plataforma do próprio Geoapify cobre roteamento, isócronas e busca de locais além da geocodificação, e tentar reproduzir tudo isso em um único host compatível amarraria seu cronograma de lançamentos a recursos muito além da geocodificação em si. Limitar o host aos endpoints de geocodificação o mantém simples de verificar em relação ao serviço original e fácil de manter alinhado à medida que o My Geocode adiciona recursos próprios.
Migrar significa trocar um nome de host e uma chave, nada mais. Essa chave se autentica da mesma forma flexível que em todos os hosts que operamos: 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. Seja qual for a forma que seu cliente atual envia, ela também é aceita aqui.
Os preços por trás não mudam em relação ao restante da plataforma. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem chave nenhuma, contadas por rede. Uma chave adiciona suas próprias 2.500 requisições gratuitas por dia além disso. Além das duas cotas, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre tudo por € 50 por mês, com o mesmo valor valendo quer a chamada tenha ido para este host, quer diretamente para /v1/forward.
Os cabeçalhos de cota acompanham todas as respostas aqui também: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit e X-Quota-Reset aparecem todos, oferecendo uma visibilidade que uma integração direta com o Geoapify não traz por conta própria.
Migrar uma integração de geocodificação para um novo provedor também é um momento razoável para reforçar a segurança da conta de modo geral. A configuração de autenticação de dois fatores do painel fica ao lado das chaves de API e do faturamento, então ativá-la em uma conta que agora tem uma nova chave exige uma etapa a mais, e não um projeto separado.
Para qualquer coisa além da resposta compatível padrão, adicionar mg_extras=1 a uma requisição, ou um cabeçalho X-MG-Extras, acrescenta campos opcionais por cima, sem alterar o formato base a menos que isso seja solicitado explicitamente.
A documentação completa do host está em /compatibility/geoapify/, e a referência de compatibilidade mais ampla, que cobre todos os dezessete hosts, está em /docs/compatibility/. Se o Geoapify já está por trás de parte da sua stack, esta é uma forma de pouco esforço para compará-lo com o nosso.