Une franchise implantée sur plusieurs fuseaux horaires avait sur son site web un problème que personne n'avait pensé à corriger : la section centrale « horaires » de chaque page d'établissement affichait le même planning, rédigé une fois par quelqu'un au siège et copié pour chaque magasin, quel que soit le fuseau horaire dans lequel ce magasin fonctionnait réellement. Un établissement situé à l'ouest du territoire de la franchise, qui fermait à 9 h du soir selon sa propre horloge, semblait sur le site fermer trois heures plus tôt qu'en réalité, parce que les horaires avaient été rédigés selon l'heure du siège et jamais ajustés établissement par établissement.
Pour corriger cela, il fallait associer un vrai fuseau horaire à chaque établissement plutôt que de traiter les « horaires » comme un seul contenu partagé. Pour l'adresse de chaque établissement de la franchise, l'entreprise a obtenu des coordonnées via /v1/forward et les a transmises à /v1/timezone, qui renvoie le nom de fuseau horaire IANA pour ce point précis. Enregistrer le nom plutôt qu'un décalage fixe permettait à l'affichage des horaires de rester automatiquement correct lors des changements d'heure, sans que personne au siège ait à penser à mettre quoi que ce soit à jour deux fois par an.
Avec le fuseau horaire propre à chaque établissement enregistré, le site pouvait enfin faire ce qu'il aurait dû faire dès le départ : indiquer au visiteur si un établissement donné était ouvert à cet instant, calculé correctement selon l'horloge de cet établissement, et non selon celle du visiteur ni celle du siège. Un visiteur naviguant depuis l'autre bout du pays sur la page d'un magasin situé sur la côte opposée voyait un « ouvert maintenant » ou un « fermé, ouvre à 8 h du matin » exact, reflétant l'heure locale réelle de ce magasin, seule version de cette information réellement utile à quelqu'un qui s'apprête à s'y rendre en voiture.
L'entreprise a ajouté par-dessus la position du visiteur lui-même, spécifiquement pour le localisateur d'établissements. /v1/ip déterminait les coordonnées approximatives d'un client en visite, qui alimentaient le même classement par distance que celui d'autres outils de localisation, de sorte qu'un client cherchant l'établissement ouvert le plus proche obtenait des résultats tenant compte à la fois de la distance et du fait que l'établissement était réellement ouvert au moment de la recherche, plutôt qu'une liste triée par distance mêlant plusieurs magasins fermés à ce moment-là à des magasins ouverts.
C'était une correction modeste et en grande partie invisible, au sens où un visiteur du site ne penserait jamais à saluer une « gestion correcte des fuseaux horaires » : il remarquerait simplement, ou plus probablement ne remarquerait pas, que les horaires affichés correspondaient à la réalité. C'est généralement le signe d'une correction qui vaut la peine d'être faite : personne ne la félicite, mais tous ceux que l'ancienne version aurait induits en erreur ne le sont tout simplement plus.
Le géocodage a été exécuté une fois par établissement lors d'une configuration unique, un petit lot compte tenu du nombre d'établissements de la plupart des franchises, largement dans le quota quotidien gratuit. Les recherches de fuseau horaire pour la fonction « ouvert maintenant » destinée aux visiteurs ajoutaient un léger volume continu lié au trafic du localisateur d'établissements, lui aussi confortablement dans l'offre gratuite pour une franchise de taille moyenne, avec du crédit prépayé disponible si une campagne marketing nationale provoquait un pic inhabituel de recherches d'établissements.
La documentation des deux endpoints se trouve sur /docs/forward-geocoding/ et /docs/timezone-lookup/.