ForHosting KIT · Utilidades de desarrollo

Índice H3 aproximado: coordenadas a celda hexagonal

Esta herramienta de índice hexagonal H3 aproximado asigna una coordenada de latitud y longitud a una celda estable de una cuadrícula hexagonal global con vértice superior.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Elija una resolución de 0 a 15 para pasar de regiones amplias a celdas cada vez más finas. El resultado incluye un identificador legible, coordenadas axiales, un centro estimado y una longitud de arista aproximada. Está pensada para agrupación, segmentación, caché y demostraciones ligeras donde importan más las celdas deterministas que la interoperabilidad exacta con H3 oficial.

Elija una resolución adecuada para la agrupación

La resolución controla la escala de la cuadrícula. La resolución 0 genera celdas muy amplias y cada nivel superior reduce a la mitad la arista en unidades angulares. Así, la progresión es predecible: puntos cercanos separados en un nivel pueden compartir celda en otro más grueso, mientras que una resolución mayor crea grupos más detallados. Comience con valores bajos para resumir actividad en regiones extensas y auméntelos para agrupaciones de barrio o visualizaciones densas. La longitud aproximada de arista orienta sobre la escala, pero no constituye una garantía geodésica. Como la cuadrícula usa una proyección equirectangular sencilla, las distancias terrestres este-oeste disminuyen hacia los polos aunque la geometría angular se mantenga regular. Pruebe coordenadas representativas del área que analizará y no elija el nivel solo por la estimación de arista. Guarde siempre la resolución junto al índice: celdas de resoluciones distintas no representan la misma superficie.

Comprenda cómo se genera el índice aproximado

El algoritmo coloca la longitud en un eje horizontal y la latitud en uno vertical, superpone una retícula hexagonal con vértice superior, convierte el punto en coordenadas axiales fraccionarias y las redondea mediante coordenadas cúbicas. Ese redondeo conserva la relación entre los tres ejes de una cuadrícula hexagonal y asigna cada entrada válida a una única celda determinista. El identificador contiene el prefijo ah3, la resolución seleccionada y códigos base-36 con signo para q y r. Por ello, una entrada idéntica produce siempre la misma salida sin red, estado almacenado, azar ni datos temporales. El centro se obtiene transformando de nuevo la posición axial redondeada a latitud y longitud; sirve para etiquetas, depuración y marcadores representativos. En los límites, una variación mínima puede seleccionar una celda vecina, como ocurre en cualquier índice espacial. Use la precisión completa de las coordenadas originales cuando necesite repetibilidad cerca de los bordes.

Sepa cuándo usar esta cuadrícula y cuándo usar H3 oficial

Esta capacidad reproduce deliberadamente el flujo de trabajo de H3 sin afirmar compatibilidad binaria, textual, geométrica ni jerárquica con sus índices. Es una cuadrícula analítica compacta para obtener grupos espaciales reproducibles sin cargar una biblioteca geoespacial especializada. Resulta útil para agrupar ubicaciones de muestra, dividir claves de caché, generar recuentos generales de densidad, enseñar coordenadas axiales y crear pruebas estables. El campo compatible_with_h3 siempre es false para evitar que otros sistemas confundan el resultado con una dirección H3 oficial. Use la biblioteca H3 oficial si debe intercambiar índices, recorrer padres e hijos reales, obtener límites canónicos, tratar pentágonos o utilizar el modelo terrestre icosaédrico de H3. Recuerde además que esta aproximación emplea latitud y longitud planas: el área terrestre se distorsiona con la latitud y las celdas no enlazan a través del antimeridiano. Considérela un sistema determinista de agrupación, no un sustituto del análisis geodésico.

Agrupar eventos cartográficos

Asigne coordenadas entrantes a grupos espaciales estables antes de contar o resumir eventos.

Crear claves de caché por ubicación

Use la cadena determinista de la celda en claves de caché para resultados basados aproximadamente en la ubicación.

Crear un prototipo de mapa hexagonal

Explore resoluciones y coordenadas axiales antes de adoptar una biblioteca geoespacial completa.

¿La celda devuelta es un índice H3 válido?

No. Es un identificador aproximado e independiente y se marca expresamente como incompatible con H3.

¿Qué significa la resolución?

Selecciona el detalle entre 0 y 15. Cada incremento reduce a la mitad la arista angular y crea grupos más finos.

¿Por qué varía el tamaño de la celda sobre el terreno?

El cálculo usa un plano equirectangular, por lo que un mismo intervalo de longitud cubre menos terreno hacia los polos.

¿El resultado es determinista?

Sí. Valores idénticos de latitud, longitud y resolución siempre generan el mismo resultado.

¿Cuánto cuesta una solicitud?

Una solicitud API cuesta $0.002. La versión del navegador ejecuta localmente el mismo cálculo puro.

¿Puedo usar el centro como centroide geográfico exacto?

No. Es el centro plano de la celda aproximada y debe tratarse como coordenada representativa.

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/h3-cell-approx

¿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/h3-cell-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":37.7749,"lon":-122.4194}'
{
  "lat": 37.7749,
  "lon": -122.4194
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.h3_cell_approx",
  "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 →