ForHosting KIT · Utilidades de desarrollo

Punto a celda hexagonal

Convierta una coordenada plana en la celda que la contiene dentro de una cuadrícula hexagonal regular.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Indique el punto, el tamaño del hexágono y, si lo necesita, la orientación y el origen de la cuadrícula. El resultado devuelve índices enteros de columna y fila axiales, listos para mapas, juegos, agrupaciones espaciales, diseños procedurales y cálculos de vecindad. La conversión usa redondeo en coordenadas cúbicas, por lo que asigna de forma coherente los puntos próximos a bordes y vértices sin recorrer celdas ni construir polígonos.

Defina la cuadrícula antes de ubicar el punto

Una cuadrícula hexagonal regular necesita tres datos antes de poder asignar un punto a una celda. Primero, introduzca las coordenadas planas x e y en el mismo sistema que emplea la cuadrícula. Después, establezca size como la distancia entre el centro del hexágono y cualquiera de sus vértices. Se trata del circunradio, no de la anchura o altura total, la separación entre lados ni la distancia entre centros. Por último, elija la orientación. Una cuadrícula pointy presenta un vértice arriba y otro abajo, mientras que una cuadrícula flat tiene lados horizontales arriba y abajo. La opción predeterminada es pointy. De forma inicial, la celda axial cero, cero está centrada en la coordenada plana cero, cero. Use origin_x y origin_y cuando la cuadrícula esté desplazada. El origen solo modifica la posición: no altera la escala, la orientación ni los índices. Todas las coordenadas y el tamaño deben compartir una unidad, como píxeles, metros o unidades de un mapa proyectado. Si necesita una cuadrícula realmente plana y coherente en distancias, proyecte antes la longitud y la latitud geográficas.

Interprete el resultado axial y el redondeo

La columna y la fila devueltas son coordenadas axiales, denominadas habitualmente q y r en la documentación sobre cuadrículas hexagonales. Este sistema utiliza dos ejes enteros aunque el desplazamiento por la cuadrícula tenga seis direcciones. La tercera coordenada cúbica, que no se muestra, queda determinada como la suma negativa de las otras dos; gracias a ello, las operaciones de distancia, vecindad, anillos y alcance resultan sencillas. Internamente, el punto se transforma en coordenadas axiales fraccionarias según la orientación elegida. Esas fracciones pasan a coordenadas cúbicas, se redondean manteniendo la restricción cúbica y regresan a un par axial entero. Este paso es esencial: redondear por separado los dos ejes visibles puede seleccionar una celda equivocada cerca de un límite diagonal. Un punto situado exactamente sobre un borde o vértice compartido pertenece geométricamente a varios polígonos cerrados, por lo que toda asignación necesita una regla de desempate. Esta calculadora resuelve esos empates de forma determinista mediante el redondeo numérico de JavaScript y un orden fijo de corrección de componentes. En los puntos interiores devuelve la única celda contenedora; en los límites exactos ofrece una elección canónica y repetible.

Utilice los índices de celda en sistemas espaciales

Cuando un punto ya dispone de columna y fila axiales, una aplicación puede agrupar muchas observaciones sin guardar ni comprobar el polígono de cada hexágono. Un juego puede convertir la posición del puntero en una casilla del tablero; una visualización puede reunir eventos proyectados en celdas; y un generador procedural puede usar el par como clave estable de una pieza. Conserve la definición original de la cuadrícula junto a los índices: una misma columna y fila señala otra región física si cambia el tamaño, la orientación o el origen. Para procesar varios puntos, aplique exactamente los mismos ajustes a cada elemento y agrupe los registros con una clave formada, por ejemplo, por la columna, una coma y la fila. Los índices negativos son normales: representan celdas a la izquierda, arriba o abajo del origen axial según la orientación. La operación consume tiempo constante por punto y no depende de la extensión total de la cuadrícula. Tampoco impone límites artificiales, por lo que sirve tanto para tableros finitos como para cuadrículas conceptualmente infinitas. Para dibujar una celda, calcule su centro o sus vértices mediante las fórmulas axiales a planas correspondientes, sin tratar columna y fila como coordenadas rectangulares de píxeles.

Seleccionar una celda con el puntero

Convierta una posición de ratón, lápiz o toque en la celda axial utilizada por un tablero, editor o juego de estrategia.

Agrupar observaciones de un mapa proyectado

Asigne puntos planos de un mapa a grupos hexagonales estables antes de contarlos, colorearlos o resumirlos.

Crear claves para mundos procedurales

Transforme una posición en índices enteros de columna y fila para consultar terreno generado, cachés o estados de simulación.

¿Qué significa size?

Size es la distancia entre el centro de un hexágono y cualquiera de sus vértices. En un hexágono regular también equivale a la longitud del lado.

¿En qué se diferencian las orientaciones pointy y flat?

Los hexágonos pointy tienen vértices arriba y abajo. Los hexágonos flat presentan lados horizontales arriba y abajo. Cada disposición requiere una conversión distinta.

¿Pueden ser negativos la columna o la fila?

Sí. Las coordenadas axiales se extienden en todas las direcciones desde la celda cero, cero, por lo que los índices negativos son normales.

¿Qué ocurre si el punto está exactamente sobre el límite de una celda?

El redondeo cúbico aplica una regla de desempate determinista y devuelve una de las celdas que comparten ese borde o vértice.

¿Puedo introducir directamente longitud y latitud?

El cálculo acepta números, pero presupone un sistema plano. Proyecte antes las coordenadas geográficas cuando importen la coherencia de distancias y áreas.

¿Cuánto cuesta una solicitud de API?

Cada solicitud de API cuesta $0.002. El mismo cálculo determinista también puede ejecutarse en el navegador.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/geo/hex-grid-cell

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/geo/hex-grid-cell \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"x":18,"y":9,"size":10}'
{
  "x": 18,
  "y": 9,
  "size": 10
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.hex_grid_cell",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →