mirror of https://gitee.com/antv-l7/antv-l7
189 lines
3.8 KiB
Markdown
189 lines
3.8 KiB
Markdown
---
|
||
title: Source
|
||
order: 0
|
||
---
|
||
|
||
## 概述
|
||
|
||
source 地理数据处理模块，主要包含数据解析（parser)，和数据处理(transform);
|
||
|
||
- data
|
||
- option
|
||
- cluster **boolean** 是否聚合
|
||
- clusterOption 聚合配置项
|
||
- parser 数据解析配置
|
||
- transforms 数据处理配置
|
||
|
||
### parser
|
||
|
||
不同数据类型处理成统一数据格式。矢量数据包括 GeoJON, CSV，Json 等不同数据格式，栅格数据，包括 Raster，Image 数据。将来还会支持瓦片格式数据。
|
||
|
||
空间数据分矢量数据和栅格数据两大类
|
||
|
||
- 矢量数据 支持 csv，geojson，json 三种数据类型
|
||
|
||
- 栅格数据 支持 image，Raster
|
||
|
||
### transform
|
||
|
||
数据转换，数据统计，网格布局，数据聚合等数据操作。
|
||
|
||
## API
|
||
|
||
### cluster `boolean` 可选 可以只设置
|
||
|
||
### clusterOption 可选
|
||
|
||
- radius 聚合半径 **number** default 40
|
||
- minZoom: 最小聚合缩放等级 **number** default 0
|
||
- maxZoom: 最大聚合缩放等级 **number** default 16
|
||
|
||
[聚合图使用案例](../../../examples/point/cluster)
|
||
|
||
### parser
|
||
|
||
**配置项**
|
||
|
||
- type: `csv|json|geojson|image|raster`
|
||
- 其他可选配置项，具体和数据格式相关
|
||
|
||
#### geojson
|
||
|
||
[geojson](https://www.yuque.com/antv/l7/dm2zll) 数据为默认数据格式，可以 不设置 parser 参数
|
||
|
||
```javascript
|
||
layer.source(data);
|
||
```
|
||
|
||
### Source 更新
|
||
|
||
如果数据发生改变，可以需要更新数据
|
||
可以通过调用 layer 的 setData 方法实现数据的更新
|
||
|
||
具体见 [Layer](../layer/layer/#setdata)
|
||
|
||
```javascript
|
||
layer.setData(data);
|
||
```
|
||
|
||
#### JSON
|
||
|
||
[JSON 数据格式解析](./json)
|
||
|
||
#### csv
|
||
|
||
[CSV 数据格式解析](./csv)
|
||
|
||
栅格数据类型
|
||
|
||
#### image
|
||
|
||
[Image 数据格式解析](./image)
|
||
|
||
### transforms
|
||
|
||
tranforms 处理的是的标准化之后的数据
|
||
标准化之后的数据结构包括 coordinates 地理坐标字段，以及其他属性字段。
|
||
|
||
处理完之后返回的也是标准数据
|
||
|
||
```json
|
||
[
|
||
{
|
||
"coordinates": [[]], // 地理坐标字段
|
||
"_id": "122", // 标准化之后新增字段
|
||
"name": "test",
|
||
"value": 1
|
||
// ....
|
||
}
|
||
]
|
||
```
|
||
|
||
目前支持两种热力图使用的数据处理方法 grid，hexagon transform 配置项
|
||
|
||
- type 数据处理类型
|
||
- tansform cfg 数据处理配置项
|
||
|
||
#### grid
|
||
|
||
生成方格网布局，根据数据字段统计，主要在网格热力图中使用
|
||
|
||
- type: 'grid',
|
||
- size: 网格半径
|
||
- field: 数据统计字段
|
||
- method: 聚合方法 count,max,min,sum,mean 5 个统计维度
|
||
|
||
```javascript
|
||
layer.source(data, {
|
||
transforms: [
|
||
{
|
||
type: 'grid',
|
||
size: 15000,
|
||
field: 'v',
|
||
method: 'sum',
|
||
},
|
||
],
|
||
});
|
||
```
|
||
|
||
#### hexagon
|
||
|
||
生成六边形网格布局，根据数据字段统计
|
||
|
||
- type: 'hexagon',
|
||
- size: 网格半径
|
||
- field: 数据统计字段
|
||
- method:聚合方法 count,max,min,sum,mean 5 个统计维度
|
||
|
||
#### join
|
||
|
||
数据连接，业务中跟多情况是地理数据和业务数据分开的两套数据，我们可与通过 join 方法将地理数据和业务数据进行关联。
|
||
|
||
**配置项**
|
||
|
||
- type: join
|
||
- sourceField 需要连接的业务数据字段名称
|
||
- data 需要连接的数据源 仅支持 json 格式
|
||
- targetField 关联的地理数据字段名称
|
||
|
||
```javascript
|
||
const data = {
|
||
type: 'FeatureCollection',
|
||
features: [
|
||
{
|
||
type: 'Feature',
|
||
properties: {
|
||
city: '北京',
|
||
},
|
||
geometry: {},
|
||
},
|
||
],
|
||
};
|
||
|
||
const data2 = [
|
||
{
|
||
name: '北京',
|
||
value: 13,
|
||
},
|
||
{
|
||
name: '天津',
|
||
value: 20,
|
||
},
|
||
];
|
||
// data 是地理数据
|
||
// data2 属性数据或者业务数据
|
||
|
||
// 通过join方法我们就可以将两个数据连接到一起
|
||
|
||
layer
|
||
.source(data, {
|
||
transforms: [
|
||
(type: 'join'),
|
||
(sourceField: 'name'), //data1 对应字段名
|
||
(targetField: 'city'), // data 对应字段名
|
||
(data: data2),
|
||
],
|
||
})
|
||
.color('value'); // 可以采用data1的value字段进行数据到颜色的映射
|
||
```
|