p90524618
/
antv-l7
mirror of https://gitee.com/antv-l7/antv-l7
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
antv-l7/docs/api/district/baselayer.zh.md

231 lines
4.3 KiB
Markdown
Raw Normal View History

fix(district): event spell mistake
2020-05-19 16:43:34 +08:00
---
docs(api): 更新api
2020-11-21 03:51:18 +08:00
title: 基础地图
fix(district): event spell mistake
2020-05-19 16:43:34 +08:00
---
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
docs: 文档升级
2020-11-16 15:19:41 +08:00
`markdown:docs/common/style.md`
docs: 文档
2020-11-17 10:59:32 +08:00
docs(api): 更新api
2020-11-21 03:51:18 +08:00
地图行政区划组件，支持世界地图，中国地图省市县三级，支持中国地图省市县上钻下取。
## 使用
**using modules**
```javascript
import { WorldLayer } from '@antv/l7-district';
```
**CDN 版本引用**
```html
<head>
<! --引入最新版的L7-District -->
<script src="https://unpkg.com/@antv/l7-district"></script>
</head>
```
## 简介
District 支持下面几种图
fix(layer): 行政区划新增 visible属性,修复arc pickbuuffer 参数
2020-06-10 18:17:39 +08:00
- WorldLayer 世界地图
- CountryLayer 国家地图，目前只支持中国
- ProvinceLayer 省级地图
- CityLayer 市级地图
- CountyLayer 县级地图
docs(api): 更新api
2020-11-21 03:51:18 +08:00
## 配置项
fix(district): event spell mistake
2020-05-19 16:43:34 +08:00
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
### zIndex
图层绘制顺序
### data `Array`
属性数据用于可视化渲染
### visible
地图是否可见
### joinBy
数据关联，属性数据如何内部空间数据关联绑定 目前支持 NAME_CHN,adcode 字段连接
对照表 `Array [string, string]` 第一个值为空间数据字段，第二个为传入数据字段名
### showBorder `boolean`
是否显示国界线，默认显示，不建议不显示
### simplifyTolerance
数据抽稀容差,默认不抽稀 `boolean | number` 单位为度，一度约 111km，数字越大精度越低。参考设置数据 0.01
### depth
数据显示层级 0：国家级，1:省级，2: 市级，3：县级
### stroke 填充描边颜色
`ProvinceLayer, CityLayer, CountyLayer`
### strokeWidth 填充描边宽度
`ProvinceLayer, CityLayer, CountyLayer`
### autoFit
是否自动缩放到图层范围 `boolean`
### chinaNationalStroke
中国国界线颜色 `CountryLayer`
### chinaNationalWidth
中国国界线宽度 `CountryLayer`
### coastlineStroke
海岸线颜色 `CountryLayer`
### coastlineWidth
海岸线宽度 `WorldLayer` `CountryLayer`
### nationalWidth
国界线 `WorldLayer` `CountryLayer`
### nationalStroke
docs(api): 更新api
2020-11-21 03:51:18 +08:00
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
国界线 `WorldLayer` `CountryLayer`
### provinceStroke
省界颜色 `CountryLayer depth= 0，1，2时生效`
### provinceStrokeWidth
省界宽度 `CountryLayer depth = 0，1，2时生效`
### cityStroke 市级边界颜色
`CountryLayer depth =1，2时生效`
### cityStrokeWidth 市级边界宽度
`CountryLayer depth =1，2 时生效`
### countyStroke
县级边界颜色 `CountryLayer depth =2时生效`
### countyStrokeWidth
县级边界宽度 `CountryLayer depth =2时生效`
docs(api): 更新api
2020-11-21 03:51:18 +08:00
`markdown:docs/common/district/label.zh.md`
`markdown:docs/common/district/fill.zh.md`
`markdown:docs/common/district/popup.zh.md`
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
`markdown:docs/common/district/bubble.zh.md`
docs(api): 更新api
2020-11-21 03:51:18 +08:00
## 数据
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
District 提供 polygon 数据需要跟用户的属性数据，通过关系字段进行连接
- [国家名称对照表](https://gw.alipayobjects.com/os/bmw-prod/b6fcd072-72a7-4875-8e05-9652ffc977d9.csv)
- [省级行政名称*adcode*对照表.csv](https://gw.alipayobjects.com/os/bmw-prod/2aa6fb7b-3694-4df3-b601-6f6f9adac496.csv)
- [市级行政区划及编码](https://gw.alipayobjects.com/os/bmw-prod/d2aefd78-f5df-486f-9310-7449cc7f5569.csv)
- [县级行政区名称级编码](https://gw.alipayobjects.com/os/bmw-prod/fafd299e-0e1e-4fa2-a8ac-10a984c6e983.csv)
docs(api): 更新api
2020-11-21 03:51:18 +08:00
## 方法
### updateLayerAttribute
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
更新图层渲染样式
docs(api): 更新api
2020-11-21 03:51:18 +08:00
参数
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
- layerName
'fill' | 'line' | 'label' | 'bubble' = 'fill',
- type: 'color' | 'size' | 'shape' | 'filter',
- attr: AttributeType | undefined,
```js
const layer = new CountryLayer();
layer.updateLayerAttribute('fill', 'color', 'red');
```
docs(api): 更新api
2020-11-21 03:51:18 +08:00
### updateDistrict
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
根据 adcode 更新 行政区块
docs(api): 更新api
2020-11-21 03:51:18 +08:00
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
参数
- adcode 行政区划编码
- data 数据
- joinByField 绑定字段
docs(api): 更新api
2020-11-21 03:51:18 +08:00
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
```javascript
citylayer.updateDistrict(['330100', '340100']);
docs(api): 更新api
2020-11-21 03:51:18 +08:00
```
### updateData(data, joinBy)
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
fix(district): event spell mistake
2020-05-19 16:43:34 +08:00
更新显示数据，
参数：
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
fix(district): event spell mistake
2020-05-19 16:43:34 +08:00
- data 需要更新的数据
- joinBy 关联字段 可选，如果不设置保持和初始化一致。
fix(layer): 修复线图绘制优先级问题&行政区块增加border显示属性
2020-07-02 12:02:52 +08:00
### getFillData
获取填充数据，可用于绘制独立的边界线
docs(api): 更新api
2020-11-21 03:51:18 +08:00
### show
fix(district): event spell mistake
2020-05-19 16:43:34 +08:00
显示图层
docs(api): 更新api
2020-11-21 03:51:18 +08:00
### hide
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
fix(district): event spell mistake
2020-05-19 16:43:34 +08:00
图层隐藏不显示
docs(api): 更新api
2020-11-21 03:51:18 +08:00
### destroy
fix(district): event spell mistake
2020-05-19 16:43:34 +08:00
移除并销毁图层
docs(api): 更新api
2020-11-21 03:51:18 +08:00
## 事件
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
 行政区划图事件监听默认添加在 fillLayer 上，你点击填充的色块才能接收到事件响应。
docs(api): 更新api
2020-11-21 03:51:18 +08:00
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
支持的事件类型同
docs(api): 更新api
2020-11-21 03:51:18 +08:00
### on 添加事件
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
参数
- type
- handle
- layerType 可选 `'fill' | 'line' | 'label' | 'bubble'` 默认值 `fill`
docs(api): 更新api
2020-11-21 03:51:18 +08:00
```javascript
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
const layer = new CountryLayer();
layer.on('click', (e) => {
console.log(e);
});
docs(api): 更新api
2020-11-21 03:51:18 +08:00
```
### off 移除事件
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
参数
docs(api): 更新api
2020-11-21 03:51:18 +08:00
docs(docs): 更新docs
2020-11-21 14:05:59 +08:00
- type
- handle
- layerType 可选 `'fill' | 'line' | 'label' | 'bubble'` 默认值 `fill`