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.
Como contamos uma requisição em lote: um item, uma unidade
Envie uma chamada de API com cem endereços dentro dela, e essa chamada usa cem requisições, não uma. Contamos individualmente cada item de uma requisição em massa ou em lote. É uma regra simples, mas vale a pena explicá-la com clareza, porque ela define como um job em lote deve ser planejado e orçado.
A lógica é simples quando você pensa no que uma chamada em lote realmente faz. Uma única requisição HTTP que geocodifica cem endereços realiza cem unidades de trabalho do nosso lado: cem consultas, cem respostas, cem linhas na resposta. Cobrar isso como se fosse uma única requisição significaria cobrar uma fração de centavo pelo que, na verdade, são cem informações separadas. Contar por item mantém o preço vinculado ao trabalho realmente feito, e não a quantas vezes você abriu uma conexão.
Isso se aplica da mesma forma, esteja você perto do nível gratuito ou pagando pelo que usa. Se a sua rede ainda tem 400 requisições restantes na cota gratuita diária e você envia um lote de 1.000 endereços, 400 desses itens são cobertos pela cota gratuita e os 600 restantes consomem crédito pré-pago ou um pacote Unlimited. Os cabeçalhos de cota da resposta refletem isso exatamente: X-Quota-Used avança pelo número de itens, e não pelo número de chamadas, e X-Credits-Remaining reflete o que o lote consumiu além da parte gratuita.
Isso também significa que não há incentivo para dividir o trabalho em muitas chamadas pequenas para burlar uma cota, nem penalidade por combinar o trabalho em menos chamadas maiores. Cem chamadas de um item e uma chamada de cem itens custam o mesmo e contam o mesmo. Escolha o formato que for mais fácil de escrever no seu código e de executar na sua infraestrutura. Algumas equipes preferem muitas chamadas pequenas porque é mais simples repetir uma falha. Outras preferem uma chamada grande porque são menos idas e voltas. As duas opções têm preço idêntico.
Para fins de planejamento, isso torna o cálculo de capacidade fácil. Se um job diário precisa processar 50.000 endereços, isso dá 50.000 requisições, ponto final, seja o envio feito em uma chamada, em dez chamadas ou em quinhentas. A € 0,0001 por requisição além da cota gratuita, essa conta leva segundos para ser feita no papel.
Todos os endpoints e todos os hosts de compatibilidade seguem a mesma contagem por item nas operações em lote e em massa. Não existe uma faixa de preço separada e mais barata para lotes, nem uma separada e mais cara. Uma consulta custa o mesmo, chegue ela sozinha ou dentro de uma lista com mil outras.
Se você está criando um job em lote para a My Geocode, planeje o volume de requisições contando os endereços, coordenadas ou IPs que você envia, e não o número de chamadas HTTP que os transportam. Esse número é o que aparece na sua cota e é o que qualquer fatura vai refletir.