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,mean5 个统计维度

```javascript

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 

```javascript

layer.shape(circle);

```

### 3d

- cylinder
- triangleColumn
- hexagonColumn
- squareColumn,

```javascript
layer.shape(cylinder);

```

## size

### 2D shape 

 不需要设置size方法

### 3D 图形 

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

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

```
### color

同layer [color方法](../layer/#color)

### style

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

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

## 完整实例代码

```javascript
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'
        ].reverse()
      );

    scene.addLayer(layer);
```