经纬志
首页 / Turf.js / API 文档

hexGrid

先看结论

在范围内铺满六边形单元,单元中心间距一致,没有缝隙。

最后验证 2026-11-03 · Turf.js 7.x · 更新 2026-10-27 · 引用本文
turf.hexGrid(bbox, cellSide, options) → FeatureCollection

参数

参数类型说明
bboxnumber[][西, 南, 东, 北]
cellSidenumber单元尺寸,约为外接圆半径
options.unitsstring默认 kilometers
options.maskPolygon只保留范围内的单元

返回值

Polygon 要素集合,每个要素是六条边的闭合环。

示例

var grid = turf.hexGrid([116.24, 39.80, 116.56, 39.98], 0.8, { units: 'kilometers' });
var cell = grid.features[0];

console.log(grid.features.length);
console.log(turf.area(cell) / 1e6 + ' km²');

尺寸语义

六边形的 cellSide 对应中心到顶点的距离, 实际面积约为方格网格同尺寸单元的 0.65 倍。 同一批数据换用六边形网格,单元数量会变化,统计口径要一起调整。

单元方向

生成的六边形是平顶朝上的朝向,行列错位排布。 需要尖顶朝向时,把结果绕自身中心旋转三十度, 直接改坐标比重新生成更省。

边缘单元不裁剪。落在范围外的部分仍然完整, 视觉上会超出研究区。需要严格贴合边界时,再用 intersect 裁剪一次。

引用本文

经纬志(2026)。《hexGrid》。https://www.jingweizhi.com/turf/api/hex-grid.html(访问日期 2026-11-03)。