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.
Um novo endpoint em lote para listas de endereços
Processar uma lista de endereços um de cada vez, uma chamada HTTP após a outra, funciona bem para volumes pequenos e fica cansativo rapidamente em qualquer escala real. Agora aceitamos o envio de uma lista inteira de endereços em uma única chamada em lote, reduzindo as idas e voltas necessárias para processar uma lista grande, sem mudar nada na forma de cobrança.
A regra de contagem aqui é exatamente a mesma que aplicamos em todo o restante da plataforma: cada endereço dentro de uma chamada em lote conta como uma requisição, e não a chamada como um todo. Envie uma lista de quinhentos endereços em uma única chamada em lote e isso consumirá quinhentas requisições da cota que se aplicar, seja a cota diária gratuita, o crédito pré-pago a € 0,0001 por requisição ou a cobertura de um pacote Unlimited. Não há desconto nem penalidade por reunir o trabalho em uma única chamada em vez de enviá-lo em várias chamadas menores.
Os cabeçalhos de cota também refletem a chamada em lote com precisão. X-Quota-Used, X-Quota-Free-Remaining e X-Credits-Remaining mudam de acordo com o número de endereços realmente processados na chamada, então uma requisição em lote grande atualiza sua cota visível da mesma forma que quinhentas chamadas individuais atualizariam, só que em uma única ida e volta, e não em quinhentas.
Isso é pensado exatamente para o tipo de carga de trabalho que antes significava escrever um loop em torno de chamadas de endereço único: importar uma lista de clientes que precisa de geocodificação, limpar um banco de dados de endereços ou preparar uma grande tarefa em lote que roda de forma agendada, e não em resposta a uma única ação do usuário. Enviar essa lista em uma única chamada em lote reduz o trabalho de gerenciar muitas conexões HTTP separadas, o que é especialmente útil para tarefas que rodam em uma infraestrutura com suas próprias restrições de conexão ou de taxa, além das nossas.
A autenticação e o comportamento geral não mudaram: os mesmos quatro métodos de chave funcionam, as mesmas regras de cota se aplicam e a mesma cota gratuita cobre testes significativos antes de haver qualquer custo real. Como em qualquer consulta baseada em endereço, os resultados de geocodificação direta e reversa ainda fazem parte do nosso backend em desenvolvimento para resultados reais preenchidos, por isso este recurso em lote está documentado especificamente em torno do formato da requisição e do comportamento de contagem.
A documentação completa para enviar requisições em lote, incluindo a formatação da requisição, está disponível em /docs/forward-geocoding/ e /docs/reverse-geocoding/. Se o seu fluxo de trabalho hoje faz um loop sobre chamadas de endereço único, vale a pena conferir isso para qualquer processo que trate mais do que um punhado de endereços de uma vez.