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.
Cabeçalhos de cota em todas as respostas: saiba o seu limite antes de chamar
A maioria das APIs obriga você a adivinhar como está o seu uso até que algo quebre. O My Geocode adota uma abordagem diferente: cada resposta, em todos os endpoints e em todos os hosts de compatibilidade, traz um conjunto completo de cabeçalhos de cota que informam exatamente onde você está.
X-Quota-Limit e X-Quota-Used dão o panorama básico para a chave ou rede que faz a chamada. X-Quota-Free-Remaining mostra quanto resta da cota gratuita diária, e X-Quota-Network-Used indica quanto dessa cota gratuita compartilhada por rede já foi consumido por qualquer endereço ou chave na mesma conexão. X-Credits-Remaining mostra o saldo de crédito pré-pago para quem já passou do nível gratuito e não está em um pacote Unlimited. X-Key-IPs-Used e X-Key-IPs-Limit acompanham de quantos endereços distintos uma determinada chave foi usada, e X-Quota-Reset informa quando os contadores diários são zerados.
O motivo de isso importar é simples: um script que consegue ver a própria cota pode se comportar de forma inteligente em relação a ela. Ele pode desacelerar antes de ser bloqueado, alertar um desenvolvedor quando o crédito estiver acabando ou trocar automaticamente de uma chave gratuita para uma paga, em vez de falhar primeiro e reagir depois. Nada disso exige chamar um endpoint de uso separado ou verificar um painel manualmente. A informação vem junto com a resposta que você já pediu.
Isso vale tanto para os nossos endpoints nativos quanto para qualquer um dos dezessete hosts de compatibilidade. Uma requisição no formato de uma chamada ao Google Maps Platform, ao Bing Maps REST Services ou ao ipstack continua voltando com os nossos cabeçalhos de cota, além do corpo de resposta que corresponde ao formato daquele provedor. Trocar de provedor não significa perder essa visibilidade, significa ganhá-la em lugares que nunca a tiveram.
Cada chave recebe uma cota gratuita diária. Depois dela, as requisições consomem crédito pré-pago ou são cobertas por um pacote Unlimited. Cada resposta informa nos cabeçalhos em que ponto você está, o que é um detalhe pequeno em uma única chamada e algo realmente útil ao longo de um dia movimentado de tráfego.
Para equipes que criam qualquer coisa além de um script avulso, sugerimos registrar esses cabeçalhos junto com os seus próprios logs de requisição desde o início. Uma tendência discreta de X-Quota-Free-Remaining caindo mais rápido do que o esperado é muito mais barata de perceber em um gráfico do que em um chamado de suporte. Os detalhes completos de cada cabeçalho e do que o aciona estão documentados em /docs/rate-limits/, junto com orientações gerais de autenticação em /docs/authentication/.