antv-l7/docs/api/layer/heatmap_layer/grid.en.md

---
title: GridHeatMapLayer
order: 1
---

将一组点数据按照等大小的正方形网格进行聚合，一个正方形网格代表网格内所有点的统计值。方格热力图特点以方格网布局。

## 使用

```javascript
import { HeatMapLayer } from '@antv/l7';

source

网格数据只支持点数据作为数据源，数据格式支持csv、json、geojson.

设置网格聚合参数

布局方法 通过 source 的 tansforms 属性配置

• type  数据聚合类型 grid
• size  网格半径 单位 米
• field  聚合字段
• method 聚合方法  count,max,min,sum,mean 5个统计维度

layer.source(data, {
      parser: {
        type: 'csv',
        x: 'lng',
        y: 'lat'
      },
      transforms:[
        {
        type: 'grid',
        size: 15000,
        field:'v',
        method:'sum'
        }
      ]
  });

shape

网格热力图虽然是以标准四边形网格进行数据聚合，但是展示效果上可以设置为其形状，形状只支持常量

2d

• circle,
• triangle
• square
• hexagon

layer.shape('circle');

3d

• cylinder
• triangleColumn
• hexagonColumn
• squareColumn,

layer.shape('cylinder');

size

2D shape

不需要设置size方法

3D 图形

size 表示高度, 支持常量和数据映射

layer.size(10);// 常量
layer.size('value', [10,50]);// 根据value 字段映射大小
layer.size('value', (value)=>{})  // 回调函数设置高度

color

同layer color方法

style

• coverage 网格覆盖度 0 - 1
• angle 网格旋转角度 0 - 360
• opacity 透明度 0 - 1.0

  
    layer.style({
      coverage: 0.9,
      angle: 0,
      opacity: 1.0
  });
  

完整实例代码

const layer = new HeatmapLayer({})
      .source(data, {
        parser: {
          type: 'csv',
          x: 'lng',
          y: 'lat'
        },
        transforms: [
          {
            type: 'grid',
            size: 20000,
            field: 'v',
            method: 'sum'
          }
        ]
      })
      .shape('square')
      .style({
        coverage: 1,
        angle: 0
      })
      .color(
        'count',
        [
          '#0B0030',
          '#100243',
          '#100243',
          '#1B048B',
          '#051FB7',
          '#0350C1',
          '#0350C1',
          '#0072C4',
          '#0796D3',
          '#2BA9DF',
          '#30C7C4',
          '#6BD5A0',
          '#A7ECB2',
          '#D0F4CA'
        ]
      );

    scene.addLayer(layer);