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 Geocodio já está no ar
O Geocodio construiu sua reputação com uma geocodificação em lote descomplicada, e um bom número de integrações construídas com ele dependem muito desse comportamento em lote. Nosso host compatível reproduz exatamente tanto o formato de requisição de consulta individual quanto o de lote, para que essa dependência não se torne um obstáculo à migração.
O host reproduz com precisão os parâmetros de requisição e o corpo de resposta do Geocodio, exceto os textos de direitos autorais, termos e privacidade, que são do próprio My Geocode. Requisições montadas hoje para os endpoints do Geocodio, individuais ou em lote, podem ser enviadas ao nosso host como estão, com as respostas interpretadas da mesma forma que o código existente já espera.
As requisições em lote são contadas aqui da mesma forma que em toda a plataforma: cada endereço dentro de uma chamada em lote conta como uma requisição, e não a chamada como um todo. Isso mantém o controle da cota preciso, quer a chamada leve um endereço, quer muitos.
Um lote de quinhentos endereços enviado em uma única chamada é medido como quinhentas requisições na cota, e no crédito pré-pago se as cotas gratuitas já tiverem sido usadas, exatamente como seriam quinhentas chamadas separadas. É essa granularidade que permite que X-Quota-Used e X-Credits-Remaining fiquem precisos no momento em que um lote grande termina, em vez de se acertarem alguns minutos depois, quando algum processo em segundo plano alcança os números.
A autenticação usa nossas quatro opções padrão: cabeçalho X-API-Key, cabeçalho Authorization: Bearer, HTTP Basic auth com a chave como nome de usuário ou parâmetro de consulta, correspondendo à forma que sua integração atual com o Geocodio já usa.
Os preços são os mesmos em toda a plataforma. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem precisar de chave, contadas por rede. Uma chave adiciona suas próprias 2.500 requisições gratuitas por dia. 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, com o mesmo valor valendo tanto para consultas individuais quanto para itens de lote.
Os códigos de cupom no painel são uma forma comum de testar uma migração com muito uso de lotes como esta sem comprometer orçamento real primeiro, aplicando um saldo de crédito a uma conta antes de decidir se vale a pena abastecê-la de verdade com crédito pré-pago ou com um pacote Unlimited.
Os cabeçalhos de cota acompanham todas as respostas, em lote ou individuais: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used e X-Credits-Remaining refletem exatamente quantos itens um lote consumiu, oferecendo uma precisão fácil de usar no planejamento.
Se um projeto quiser mais do que a resposta compatível padrão, mg_extras=1 na requisição, ou um cabeçalho X-MG-Extras, acrescenta campos extras opcionais por cima, sem mexer no formato base a menos que isso seja solicitado explicitamente.
O host está documentado em /compatibility/geocodio/, e as orientações gerais sobre como migrar uma integração existente estão em /docs/compatibility/. Testar uma chamada em lote no novo host é uma forma rápida de confirmar que a contagem da cota se comporta exatamente como esperado antes de depender dela para volume real.