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.
Cota por rede: por que um escritório compartilhado divide uma única cota
Um escritório de doze pessoas que compartilha uma única conexão de internet parece, visto de fora, um único endereço IP fazendo muitas requisições. É exatamente para essa situação que a nossa cota gratuita por rede foi pensada, e vale a pena explicar por que a contamos dessa forma em vez de contar cada requisição como se viesse de um desconhecido sem relação com os demais.
O nível gratuito oferece 2.500 requisições por dia a partir de qualquer endereço, sem necessidade de chave. Essa cota é contada por rede: todos os endereços IPv4 no mesmo /24 e todos os endereços IPv6 no mesmo /48 compartilham uma única cota, estejam ou não usando uma chave. Um /24 abrange 256 endereços, mais ou menos a faixa em que um escritório ou prédio de pequeno a médio porte pode estar, dependendo de como a rede está configurada. Tratar esse bloco inteiro como uma única cota reflete a realidade de que muito provavelmente se trata de uma organização, e não de 256 usuários separados e sem relação entre si, cada um com direito às próprias 2.500 requisições gratuitas por dia.
Isso também fecha uma brecha óbvia que um nível gratuito contado apenas por endereço deixaria aberta. Sem a contagem por rede, uma organização poderia distribuir requisições por muitos endereços, ou gerar muitas chaves de dentro do mesmo prédio, e na prática multiplicar um nível gratuito pensado para uso individual e modesto em algo muito maior. Contar por rede mantém a cota gratuita significativa e justa, sem exigir que fiscalizemos contas individuais manualmente.
Vale a pena ser preciso sobre o que é compartilhado e o que não é. A cota gratuita da rede é compartilhada entre os endereços e o tráfego sem chave dessa rede. As 2.500 requisições gratuitas por dia próprias de uma chave não são reduzidas por outro tráfego sem chave na mesma rede, e elas acompanham a chave em vez de ficarem presas ao lugar de onde a chave é usada. X-Key-IPs-Used e X-Key-IPs-Limit, presentes em cada resposta, mostram de quantos endereços distintos uma determinada chave foi usada, dando visibilidade também sobre esse lado.
Para uma empresa que opera a partir de uma única rede bem definida, isso geralmente significa que o nível gratuito se comporta exatamente como esperado: 2.500 requisições por dia compartilhadas por todo o prédio, além do que cada chave individual acrescenta separadamente. X-Quota-Network-Used, presente em cada resposta, mostra exatamente quanto desse conjunto compartilhado já foi usado a qualquer momento, então ninguém em uma conexão compartilhada precisa adivinhar o quão perto a equipe está de precisar de crédito pré-pago ou de um pacote Unlimited.
Todos os detalhes sobre como a cota é contada, incluindo os nomes dos cabeçalhos envolvidos, estão documentados em /docs/rate-limits/.