首页 / Turf.js / API 文档
squareGrid
先看结论
按范围与边长生成方格集合，格子从范围西南角开始铺。
turf.squareGrid(bbox, cellSide, options) → FeatureCollection
参数
| 参数 | 类型 | 说明 |
|---|---|---|
bbox | number[] | [西, 南, 东, 北] |
cellSide | number | 格子边长 |
options.units | string | 默认 kilometers |
options.mask | Polygon | 只保留落在范围内的格子 |
返回值
Polygon 要素集合。格子数量由范围与边长推算，不保证整齐整除。
示例
var bbox = [116.24, 39.80, 116.56, 39.98];
var grid = turf.squareGrid(bbox, 1, { units: 'kilometers' });
console.log(grid.features.length);
console.log(turf.area(grid.features[0]) / 1e6 + ' km²');尺寸含义
cellSide 是边长，不是面积，也不是对角线。
在经纬度数据上，网格按中心纬度换算成度，南北向与东西向的
实际边长会有轻微差异。
与 mask 一起用
带 mask 时只保留与遮罩相交的格子，
边缘格子不裁剪，覆盖范围会略微超出遮罩边界。
格子数与数据量要匹配。四千个格子配十万个点，逐格判断会很慢； 格子过粗又看不出分布。先按平均每格几十个点估算尺寸。
经纬志（2026）。《squareGrid》。https://www.jingweizhi.com/turf/api/square-grid.html（访问日期 2026-11-03）。