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.
Sugestões de preenchimento automático adicionadas aos hosts compatíveis
O preenchimento automático de endereços é um tipo de requisição diferente de uma consulta de geocodificação direta: ele precisa responder a uma entrada parcial e em mudança, e não a um único endereço finalizado, geralmente enquanto alguém digita em um formulário. Estendemos os nossos hosts de compatibilidade para aceitar também esse padrão, seguindo o formato de requisição de preenchimento automático dos provedores que o oferecem.
Isso funciona ao lado do nosso endpoint nativo /v1/autocomplete, documentado em /docs/address-autocomplete/, que trata diretamente o mesmo tipo de requisição de endereço parcial. Sempre que o provedor original de um host de compatibilidade também oferece preenchimento automático, esse mesmo formato de requisição agora é aceito no nosso host equivalente, exceto pelos textos de direitos autorais, termos e privacidade, que são nossos.
A autenticação e os preços das requisições de preenchimento automático seguem exatamente as mesmas regras de todos os outros tipos de requisição da plataforma. Uma chave se autentica como cabeçalho X-API-Key, cabeçalho Authorization: Bearer, autenticação HTTP Basic ou parâmetro de consulta, e o uso é descontado da mesma cota diária gratuita, venha essa cota da rede que faz a chamada ou da própria chave. Além da cota gratuita, as requisições de preenchimento automático consomem crédito pré-pago a € 0,0001 por requisição ou são cobertas por um pacote Unlimited, exatamente como qualquer outro endpoint.
O tráfego de preenchimento automático costuma ter um ritmo diferente de uma consulta de geocodificação típica, muitas vezes disparando a cada tecla enquanto alguém digita um endereço em um formulário, em vez de uma vez por envio finalizado. Isso torna a visibilidade da cota especialmente útil aqui: os mesmos cabeçalhos de cota anexados a cada resposta, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining e os demais, permitem que uma integração acompanhe o consumo em tempo real e ajuste o comportamento, por exemplo aplicando um debounce mais agressivo às requisições, se o uso estiver acima do esperado.
Para equipes que já usam um host de compatibilidade para geocodificação e tratam o preenchimento automático separadamente por outro provedor ou por uma segunda integração, esta atualização significa que o preenchimento automático agora pode passar para o mesmo host e a mesma chave, consolidando os dois tipos de requisição em uma única conta em vez de dividi-los entre duas.
Quais hosts de compatibilidade aceitam preenchimento automático depende de o provedor original aceitar ou não, e os detalhes de cada um estão documentados na página do próprio host, acessível pela lista completa em /compatibility/. Testar o preenchimento automático em um host compatível não custa nada, graças à cota gratuita disponível para qualquer chave nova.