Codificador de geohash

Un geohash convierte un par de coordenadas geográficas en una cadena corta en base32 que identifica una celda rectangular sobre la Tierra. Los puntos cercanos comparten prefijos comunes largos, lo que hace que esta codificación resulte útil para búsquedas de proximidad, claves de teselas, particiones de caché y tokens de ubicación legibles por personas. Esta capacidad toma la latitud, la longitud y una longitud de precisión, y luego devuelve la cadena geohash junto con el recuadro delimitador de la celda. El algoritmo es aritmética pura: sin llamadas de red, sin muestreo aleatorio y sin reloj. Una precisión no válida o unas coordenadas fuera de rango se rechazan con un error de entrada claro en lugar de una celda equivocada en silencio.

Qué representa realmente un geohash

Geohash es un esquema de codificación público que intercala los bits de la longitud y la latitud, y luego agrupa esos bits de cinco en cinco en un alfabeto de 32 caracteres que omite deliberadamente las letras ambiguas. Cada carácter que añade divide la celda aproximadamente a la mitad, primero en una dimensión y luego en la otra, de modo que las cadenas más largas describen rectángulos más pequeños.

Un hash de un solo carácter cubre una franja enorme del planeta; nueve o diez caracteres suelen bastar para una manzana o la huella de un edificio, según la latitud. Como los prefijos se anidan, dos ubicaciones que comparten los siete primeros caracteres caen dentro de la misma celda gruesa, que es justo lo que hace prácticas las consultas por prefijo y la agrupación en mapas.

La cadena no es un hash criptográfico: puntos distintos pueden compartir un prefijo a propósito, y la misma precisión siempre produce la misma cadena para las mismas coordenadas. Úselo cuando necesite una clave compacta y segura para URL de un lugar en lugar de un par completo de coma flotante en cada línea de registro o fila de base de datos.

Cómo elegir la precisión y enviar las coordenadas

Envíe grados decimales sobre el globo WGS84: la latitud de menos noventa a noventa, la longitud de menos ciento ochenta a ciento ochenta. La precisión es el número de caracteres base32 que desea recibir, de uno a doce. Los valores bajos convienen a cubos de país o región; los medios, a ciudades y barrios; los altos, a celdas de escala interior o de seguimiento de vehículos.

La respuesta repite las entradas que envió, el geohash resultante y los límites de latitud y longitud de la celda que denota esa cadena. Esos límites son los intervalos con los que terminó el codificador tras el último bit, así que puede verificar la cobertura sin decodificar por separado. Los campos faltantes y los valores no numéricos fallan del mismo modo.

Prefiera números decimales estables en lugar de cadenas con unidades o letras cardinales; convierta las referencias DMS o de cuadrícula antes de llamar.

Dónde encajan las celdas codificadas en flujos reales

Los equipos usan los geohash como claves de partición en almacenes de series temporales, como identificadores de teselas de mapa para cachés de cliente, como prefijos compartidos para filtros de puntos cercanos y como tokens cortos en URL o cargas QR cuando un par completo de lat/lon resulta incómodo. Como la transformación es determinista y sin efectos secundarios, puede regenerar la misma clave en el navegador, en un worker o en un trabajo por lotes y esperar resultados idénticos byte a byte para las mismas entradas.

Eso importa para las pruebas de referencia, las réplicas multirregión y las herramientas sin conexión que no deben desviarse. Recuerde que las celdas geohash son rectángulos en el espacio de grados, no círculos perfectos de igual área: cerca de los polos, una celda larga es mucho más estrecha en metros de este a oeste que la misma longitud cerca del ecuador. Para una búsqueda estricta por radio, calcule la distancia sobre los puntos originales; use el hash para agrupar y recuperar candidatos, y luego refine.