Ajustar una coordenada de latitud y longitud a una cuadrícula

Indique la latitud, la longitud y la separación entre nodos en grados decimales; si lo desea, desplace la cuadrícula mediante un origen personalizado. El resultado incluye la coordenada ajustada, los índices enteros de la cuadrícula y los desplazamientos con signo respecto del punto original. Así podrá agrupar, comparar y almacenar coordenadas en caché, además de utilizarlas como celdas espaciales compactas, sin recurrir a un servicio remoto de geocodificación ni a un sistema de información geográfica complejo.

Elija una cuadrícula adecuada para su índice

Una cuadrícula geográfica regular divide la latitud y la longitud en intervalos reproducibles. Para empezar, indique una coordenada y una separación positiva en grados decimales. Una separación menor crea más nodos y conserva mayor detalle posicional; una mayor reúne una zona más extensa bajo una misma coordenada ajustada. La separación se aplica por separado a ambos ejes, por lo que el resultado es una cuadrícula rectangular expresada en unidades angulares. Este método resulta útil para índices espaciales cuantizados, agregaciones, claves de caché, deduplicación aproximada y reducción de precisión orientada a la privacidad. Recuerde que los grados son unidades angulares: la distancia terrestre representada por un grado de longitud disminuye al acercarse a los polos. Si necesita celdas de tamaño casi constante en metros sobre una región amplia, proyecte primero los datos a un sistema de coordenadas plano adecuado. Para conjuntos locales o deliberadamente basados en grados, el ajuste directo suele ser la opción más sencilla y transparente. El cálculo no infiere la separación ni cambia las unidades de manera silenciosa, de modo que cada resultado puede reproducirse a partir de las entradas declaradas.

Controle la alineación mediante el origen

De manera predeterminada, la cuadrícula se ancla en cero grados de latitud y cero grados de longitud. Cada nodo equivale al origen más un múltiplo entero de la separación elegida en cada eje. Puede indicar origin_lat y origin_lon cuando una teselación existente utilice otra alineación. Esto importa porque dos cuadrículas con igual separación pero orígenes distintos generan celdas diferentes. Los índices devueltos expresan el número con signo de pasos desde el origen y sirven como clave compuesta si se conserva también la definición de la cuadrícula. La latitud y la longitud se ajustan de forma independiente. Cuando el punto está exactamente a mitad de camino, el empate se resuelve alejándose del índice cero, con un resultado estable en coordenadas positivas y negativas. En los límites geográficos, el cálculo escoge el nodo más cercano que pertenece a la cuadrícula declarada y permanece dentro de los rangos válidos. Nunca devuelve una latitud superior a 90 grados ni una longitud superior a 180 grados solo porque un nodo aritmético sin límites esté más cerca.

Interprete la coordenada y los desplazamientos

La respuesta devuelve como resultado principal la latitud y la longitud ajustadas, junto con lat_index y lon_index. También informa de los cambios con signo en grados. Un desplazamiento positivo de latitud significa que el nodo está al norte del punto recibido; un desplazamiento negativo de longitud indica que está al oeste. Estos valores permiten auditar cuánta cuantización se introdujo o rechazar registros cuyo desplazamiento supere una política definida por su aplicación. Los resultados se redondean a doce decimales para eliminar ruido irrelevante de coma flotante binaria sin perder detalle por debajo de la separación mínima aceptada. La operación es determinista, no usa red y no conserva estado; por ello, una misma entrada JSON produce exactamente la misma salida en el navegador y mediante la API. Una solicitud procesa una coordenada y cuesta $0.002 mediante la API. En procesos por lotes, invoque la capacidad para cada elemento y guarde la separación y el origen junto con los índices, de forma que otros usuarios puedan reconstruir la definición exacta sin deducirla de los valores ajustados.