Une plateforme complète de suivi de flotte dépassait largement les besoins d'une petite entreprise de logistique pour la seule chose précise que réclamait sans cesse son équipe de répartition : une simple notification au moment où un camion de livraison arrivait sur un site client important ou le quittait. Cette notification était utile aux clients qui voulaient être prévenus à l'avance de l'arrivée d'une livraison, et à l'entreprise elle-même pour savoir quand une livraison avait réellement atteint sa destination, sans dépendre du rapport de fin de journée du chauffeur.
Les éléments nécessaires étaient plus simples qu'une plateforme de suivi complète, et l'entreprise recevait déjà en continu les coordonnées GPS de ses véhicules de livraison grâce aux appareils mobiles des chauffeurs. Il lui fallait un moyen de définir un site client comme une limite et de comparer les coordonnées entrantes à celle-ci, ainsi qu'un moyen d'interpréter une coordonnée brute lorsqu'une description lisible par un humain était nécessaire plutôt qu'une paire de nombres.
Pour chaque site client important, l'entreprise a géocodé l'adresse du site via /v1/forward afin d'obtenir une coordonnée de référence fixe, puis a défini autour de ce point un petit rayon représentant la limite d'arrivée du site. Il s'agissait d'une simple vérification de rayon plutôt que d'une limite complexe de forme personnalisée, car un rayon était suffisamment précis pour les sites réels de l'entreprise, principalement des entrepôts et des quais de chargement sans limites inhabituelles ou irrégulières. À mesure que les coordonnées GPS d'un camion arrivaient, le backend de l'entreprise calculait la distance entre chaque camion suivi et le point de référence de chaque site concerné, déclenchant une alerte d'arrivée dès qu'un camion entrait dans le rayon et une alerte de départ dès qu'il en ressortait.
/v1/reverse jouait un rôle d'appui pour la partie humaine de ce système : lorsqu'un répartiteur devait examiner une alerte ou analyser un comportement inattendu, comme un camion qui semblait quitter un site et y revenir aussitôt, disposer de la coordonnée brute traduite en adresse et en description de lieu lisibles rendait l'examen du répartiteur nettement plus rapide que de travailler à partir d'une paire de nombres sur une carte qu'il fallait analyser manuellement pour l'interpréter.
L'entreprise a délibérément gardé le système simple plutôt que de viser une plateforme complète d'optimisation d'itinéraires ou de gestion de flotte, car le problème précis qu'elle résolvait, les alertes d'arrivée et de départ pour une liste définie de sites importants, ne nécessitait pas l'essentiel de ce qu'une plateforme plus vaste aurait offert. Ne construire que le nécessaire a permis de garder le projet assez petit pour être livré rapidement et maintenu sans équipe technique dédiée.
Les clients recevant les alertes d'arrivée ont indiqué que ce préavis leur apportait une réelle valeur, en particulier ceux qui disposaient de peu de personnel sur place et avaient besoin de quelques minutes d'avance pour qu'une personne soit prête à réceptionner la livraison au lieu d'être prise au dépourvu. C'était une petite amélioration opérationnelle pour le client, qui a coûté relativement peu à l'entreprise de logistique.
Le géocodage des sites représentait un coût de mise en place ponctuel, faible vu le petit nombre de sites prioritaires nécessitant ce traitement particulier, et l'usage du géocodage inverse suivait la fréquence à laquelle un répartiteur devait examiner une alerte précise, une charge légère et occasionnelle plutôt que constante. Les deux sont restés confortablement dans le quota quotidien gratuit pour une entreprise de cette taille.
La documentation des deux endpoints se trouve sur /docs/forward-geocoding/ et /docs/reverse-geocoding/.