Una lista de cuarenta direcciones de sucursales ordenada por nombre de ciudad no le sirve a un cliente que quiere saber cuál es la más cercana a su oficina. Un banco regional tuvo exactamente esta lista en su sitio web durante años, y el equipo de soporte atendía un flujo constante de llamadas que, en la práctica, pedían hacer esa ordenación a mano por teléfono.
Solucionarlo requería dos datos de ubicación que el banco no tenía en una forma utilizable: las coordenadas de cada sucursal y una manera de encontrar el punto de partida del propio cliente. Las direcciones de las sucursales se geocodificaron una sola vez, en un único lote enviado a /v1/forward, ya que una solicitud masiva cuenta cada dirección como un elemento facturado. Eso dio a cada sucursal una latitud y una longitud fijas con las que trabajar, algo que la lista anterior, construida solo con direcciones en texto, nunca podría ofrecer.
Para la parte del cálculo correspondiente al cliente, el banco ofrecía dos caminos. Un cliente que permitía que la página detectara su ubicación aproximada la obtenía de /v1/ip, que resuelve la dirección IP del visitante en coordenadas junto con la ciudad y la región, lo que da un punto de partida razonable sin pedir nada. A un cliente que prefería escribir una dirección, algo habitual en alguien que planea ir a una sucursal cerca de su lugar de trabajo y no de su ubicación actual, se le geocodificaba esa dirección mediante la misma llamada a /v1/forward usada para la lista de sucursales, y luego se ordenaba respecto a ella del mismo modo.
Una vez que ambos lados tenían coordenadas, ordenar era un cálculo de distancias sencillo que el propio sitio del banco resolvía sin necesidad de ningún servicio adicional. El resultado visible fue un buscador de sucursales que mostraba primero las cinco más cercanas, cada una con una cifra de distancia sencilla, en lugar de obligar a recorrer cuarenta direcciones agrupadas por ciudad.
Al tratarse de un banco, el equipo tuvo cuidado con el grado de seguridad con que se expresaba la herramienta. La ubicación basada en IP es una aproximación, útil como punto de partida pero no exacta, sobre todo para un cliente en una red móvil o en una VPN corporativa, y el buscador del banco siempre etiquetaba la ubicación detectada como una estimación inicial con una forma fácil de ajustarla, en lugar de presentarla como una certeza. Eso importaba más aquí que en un buscador de tiendas cualquiera, ya que enviar a un cliente a la sucursal equivocada para algo como una cita de legalización de documentos es un inconveniente mayor que enviarlo a la cafetería equivocada.
El tráfico de la herramienta era modesto y predecible, una o dos consultas por sesión de visitante, y se mantenía holgadamente dentro de la cuota diaria gratuita incluida con la clave del banco incluso durante una campaña de marketing que atrajo tráfico adicional al buscador de sucursales. El proyecto también dio al banco unas coordenadas de sucursales limpias y reutilizables que más tarde usó para otras cosas, como dibujar sencillos mapas de radio para el anuncio de la apertura de una nueva sucursal, sin ningún trabajo de geocodificación adicional.
Un localizador de sucursales o de tiendas es uno de los usos más comunes de la geocodificación precisamente porque el beneficio es muy visible: un buscador que ordena por distancia y funciona es algo que los clientes notan a los pocos segundos de usarlo, frente a otro que claramente no lo hace. La documentación de los endpoints correspondientes está en /docs/forward-geocoding/ y /docs/ipv4-lookup/.