Una franquicia con establecimientos repartidos en varias zonas horarias tenía en su sitio web un problema que nadie había pensado en arreglar: la sección central de "horario" de cada página de establecimiento mostraba el mismo horario, escrito una vez por alguien en la sede central y copiado a todas las tiendas, sin importar en qué zona horaria operaba realmente cada tienda. Un establecimiento en el lado oeste del territorio de la franquicia que cerraba a lo que su propio reloj marcaba como las 9 PM parecía, en el sitio web, cerrar tres horas antes de lo que realmente cerraba, porque el horario se había escrito según la hora de la sede central y nunca se había ajustado por establecimiento.
Arreglarlo exigía asociar una zona horaria real a cada establecimiento en lugar de tratar el "horario" como un contenido compartido. Para la dirección de cada establecimiento de la franquicia, la empresa obtuvo las coordenadas con /v1/forward y pasó esas coordenadas a /v1/timezone, que devuelve el nombre de zona horaria IANA de ese punto exacto. Guardar el nombre en lugar de un desfase fijo hizo que el horario mostrado se mantuviera correcto automáticamente con los cambios de horario de verano, sin que nadie en la sede central tuviera que acordarse de actualizar nada dos veces al año.
Con la zona horaria propia de cada establecimiento registrada, el sitio web por fin pudo hacer lo que debería haber hecho desde el principio: mostrar al visitante si un establecimiento concreto estaba abierto en ese momento, calculado correctamente según el reloj de ese establecimiento, no el del visitante ni el de la sede central. Un visitante que navegaba desde el otro extremo del país y miraba la página de una tienda en la costa opuesta veía un "abierto ahora" o un "cerrado, abre a las 8 AM" exacto que reflejaba la hora local real de esa tienda, que es la única versión de esa información que de verdad le sirve a alguien que está a punto de ir en coche.
La empresa añadió encima la propia ubicación del visitante, específicamente para el localizador de establecimientos. /v1/ip obtenía las coordenadas aproximadas de un cliente visitante, que se pasaban a la misma ordenación por distancia usada por otras herramientas de localización, de modo que un cliente que buscaba el establecimiento abierto más cercano obtenía resultados que tenían en cuenta tanto la distancia como si ese establecimiento estaba realmente abierto en el momento de la búsqueda, en lugar de una lista ordenada por distancia que mezclaba varias tiendas cerradas en ese momento con las abiertas.
Fue un arreglo pequeño y casi invisible, en el sentido de que a un visitante del sitio web nunca se le ocurriría atribuir nada a una "gestión correcta de las zonas horarias": simplemente notaría, o más probablemente no notaría, que el horario mostrado coincidía con la realidad. Esa suele ser la señal de un arreglo que vale la pena: nadie lo elogia, pero todos los que se habrían confundido con la versión antigua simplemente ya no se confunden.
La geocodificación se ejecutó una vez por establecimiento como parte de una configuración inicial única, un lote pequeño dado el número de establecimientos que tienen la mayoría de las franquicias, muy dentro de la cuota diaria gratuita. Las consultas de zona horaria para la función de "abierto ahora" de cara al visitante añadieron un volumen continuo ligero ligado al tráfico del localizador, también holgadamente dentro del nivel gratuito para una franquicia de tamaño moderado, con crédito prepago disponible por si una campaña de marketing nacional provocaba un pico inusual de búsquedas de establecimientos.
La documentación de ambos endpoints está en /docs/forward-geocoding/ y /docs/timezone-lookup/.