Chaque printemps, le service des inscriptions d'un district scolaire recevait sans cesse la même question de la part de familles qui venaient de déménager, envisageaient de le faire ou n'étaient tout simplement pas sûres : de quelle école dépend mon adresse ? Y répondre à la main obligeait un agent à rechercher l'adresse dans un ensemble de limites de secteurs scolaires tenues à jour sous forme de cartes et de listes, un processus qui prenait quelques minutes par famille et passait mal à l'échelle pendant les semaines précédant les dates limites d'inscription, lorsque le volume de questions atteignait son pic.
Le district a créé un outil de vérification en libre-service pour traiter directement le cas le plus courant. Une famille saisissait son adresse, que l'outil envoyait à /v1/forward pour obtenir une correspondance de lieu avec des coordonnées, car les limites des secteurs scolaires du district étaient tenues à jour sous forme de zones géographiques nécessitant une coordonnée à tester, et non une adresse textuelle impossible à comparer directement à la forme d'une limite. Une fois l'adresse résolue en coordonnée, déterminer quel secteur contenait ce point relevait d'un simple test géométrique effectué par le système du district, qui comparait le point à chaque polygone de limite enregistré.
Pour les adresses résolues avec un niveau de confiance élevé et situées clairement à l'intérieur d'une limite, l'outil donnait une réponse immédiate en indiquant directement l'école de rattachement. Pour les adresses résolues avec un niveau de confiance plus faible ou situées très près d'une limite, cas fréquent pour les lotissements récents ou les adresses en bordure de deux secteurs, l'outil signalait que le résultat devait être confirmé par le service des inscriptions plutôt que d'annoncer un nom d'école avec plus de certitude que la correspondance ne le permettait réellement. En effet, une mauvaise réponse sur un sujet aussi lourd de conséquences que l'affectation scolaire posait un problème bien plus grave qu'un message occasionnel « contactez-nous pour confirmation ».
Cette distinction comptait suffisamment pour que le district l'intègre délibérément plutôt qu'après coup. Une correspondance de géocodage reflète le degré de confiance avec lequel une adresse a été résolue, et traiter toutes les correspondances comme également certaines aurait produit des réponses fausses mais affirmées précisément pour les adresses les plus susceptibles d'être réellement ambiguës, celles situées pile au bord d'une limite, où une erreur perturbait le plus une famille qui se fiait à la réponse.
L'outil a considérablement réduit le volume d'appels au service des inscriptions pendant les semaines où cela comptait le plus, ce qui a permis aux agents de consacrer leur temps aux cas plus difficiles, adresses en bordure de secteur ou familles dans des situations particulières, au lieu de répéter des centaines de fois la même recherche élémentaire. Le district a aussi utilisé ce même géocodage pour auditer de temps en temps ses propres cartes de secteurs, en vérifiant si des adresses proches d'une limite, contestées par des familles, étaient bien affectées correctement selon les données officielles de limites du district, ce qui a permis de repérer au passage un petit nombre de véritables erreurs de cartographie.
L'utilisation était saisonnière et concentrée, avec un fort pic dans les semaines précédant les dates limites d'inscription et un calme le reste de l'année, un profil que le quota quotidien gratuit gérait bien pendant les périodes calmes, le crédit prépayé couvrant le pic de la saison des inscriptions sans que le district ait besoin de s'engager toute l'année sur une offre dimensionnée pour ses semaines les plus chargées.
La documentation des deux endpoints se trouve sur /docs/forward-geocoding/ et /docs/postal-code-lookup/.