Toda primavera, o setor de matrículas de uma secretaria de educação recebia a mesma pergunta repetidas vezes de famílias que tinham acabado de se mudar, estavam pensando em se mudar ou simplesmente não tinham certeza: a qual escola o meu endereço pertence. Responder manualmente significava um funcionário procurar um endereço em um conjunto de limites de zonas escolares mantidos como mapas e listas, um processo que levava alguns minutos por família e não escalava bem nas semanas que antecediam os prazos de matrícula, quando o volume de perguntas mais aumentava.
A secretaria criou um verificador de autoatendimento para resolver diretamente o caso comum. A família digitava o seu endereço, que a ferramenta enviava ao /v1/forward para obter uma correspondência de local com coordenadas, já que os limites das zonas escolares eram mantidos como áreas geográficas que precisavam de uma coordenada para o teste, e não de um endereço em texto, que não podia ser comparado diretamente com o formato de um limite. Depois que um endereço era resolvido em uma coordenada, verificar qual zona continha aquele ponto era um teste geométrico simples feito pelo próprio sistema da secretaria, comparando o ponto com cada polígono de limite cadastrado.
Para endereços resolvidos com alta confiança e que caíam claramente dentro de um limite, a ferramenta dava uma resposta imediata, informando diretamente a escola designada. Para endereços resolvidos com confiança menor ou que ficavam muito perto de uma linha de limite, algo comum em loteamentos mais novos ou em endereços na borda entre duas zonas, a ferramenta sinalizava o resultado como dependente de confirmação do setor de matrículas, em vez de informar o nome de uma escola com mais certeza do que a correspondência subjacente realmente permitia, já que uma resposta errada sobre algo tão importante quanto a designação escolar era um problema muito maior do que uma mensagem ocasional de "entre em contato conosco para confirmar".
Essa distinção importava tanto que a secretaria a incorporou de forma deliberada, e não como algo secundário. Uma correspondência de geocodificação reflete o grau de confiança com que um endereço foi resolvido, e tratar todas as correspondências como igualmente certas teria produzido respostas erradas e cheias de certeza justamente para os endereços com mais chance de serem de fato ambíguos, aqueles bem na borda de um limite, onde um erro causava mais transtorno para uma família que dependia da resposta.
A ferramenta reduziu bastante o volume de ligações para o setor de matrículas nas semanas em que isso mais importava, liberando os funcionários para se dedicarem aos casos mais difíceis, endereços na borda de limites e famílias com circunstâncias incomuns, em vez de repetir a mesma consulta básica centenas de vezes. A secretaria também usou a mesma geocodificação subjacente para auditar de vez em quando os seus próprios mapas de zonas, verificando se endereços próximos a um limite que as famílias haviam contestado estavam de fato designados corretamente de acordo com os dados oficiais de limites da própria secretaria, o que revelou um pequeno número de erros reais de mapeamento no processo.
O uso era sazonal e concentrado, com picos fortes nas semanas anteriores aos prazos de matrícula e tranquilo no resto do ano, um padrão que a cota diária gratuita atendia bem nos períodos calmos, com o crédito pré-pago cobrindo o pico da temporada de matrículas sem que a secretaria precisasse se comprometer com um plano dimensionado para as suas semanas mais movimentadas durante o ano todo.
A documentação dos dois endpoints está em /docs/forward-geocoding/ e /docs/postal-code-lookup/.