2019-11-14 20:52:43 +08:00
|
|
|
|
# 使用方法
|
|
|
|
|
|
|
|
|
|
|
|
L7 提供三种使用方式：CDN、Submodule 以及 React 组件。
|
|
|
|
|
|
|
|
|
|
|
|
## 通过 CDN 使用
|
|
|
|
|
|
|
2019-11-25 15:27:56 +08:00
|
|
|
|
首先在 `<head>` 中引入 L7 CDN 版本的 JS 文件：
|
2019-11-14 20:52:43 +08:00
|
|
|
|
```html
|
|
|
|
|
|
<head>
|
|
|
|
|
|
<script src='https://api.l7/v2.0.0-beta/l7.js'></script>
|
|
|
|
|
|
</head>
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
如果使用 Mapbox，还需要额外引入 Mapbox 的 JS 和 CSS 文件，这一步可以参考 [Mapbox 文档](https://docs.mapbox.com/mapbox-gl-js/overview/#quickstart)：
|
|
|
|
|
|
```html
|
|
|
|
|
|
<head>
|
|
|
|
|
|
<script src='https://api.tiles.mapbox.com/mapbox-gl-js/v1.5.0/mapbox-gl.js'></script>
|
|
|
|
|
|
<link href='https://api.tiles.mapbox.com/mapbox-gl-js/v1.5.0/mapbox-gl.css' rel='stylesheet' />
|
|
|
|
|
|
<!-- 上一步引入的 L7 JS 和 CSS -->
|
|
|
|
|
|
</head>
|
|
|
|
|
|
```
|
|
|
|
|
|
⚠️高德采用异步加载，因此不需要引入任何额外静态文件。
|
|
|
|
|
|
|
|
|
|
|
|
然后在 `<body>` 中定义一个容器并设置一个 `id`。通过全局 `L7` 这个命名空间可以获取场景 `L7.Scene` 和图层 `L7.PolygonLayer`：
|
|
|
|
|
|
```html
|
|
|
|
|
|
<body>
|
|
|
|
|
|
<div
|
|
|
|
|
|
id="map"
|
|
|
|
|
|
style="position: absolute;top: 0;left: 0;right: 0;bottom: 0;"
|
|
|
|
|
|
></div>
|
|
|
|
|
|
<script>
|
|
|
|
|
|
(async function() {
|
|
|
|
|
|
// 获取数据
|
|
|
|
|
|
const response = await fetch(
|
|
|
|
|
|
'https://gw.alipayobjects.com/os/basement_prod/d2e0e930-fd44-4fca-8872-c1037b0fee7b.json',
|
|
|
|
|
|
);
|
|
|
|
|
|
const data = await response.json();
|
|
|
|
|
|
|
|
|
|
|
|
// 创建场景
|
|
|
|
|
|
const scene = new L7.Scene({
|
|
|
|
|
|
id: 'map', // 容器 id
|
2019-11-26 17:51:29 +08:00
|
|
|
|
map: new L7.Mapbox({ // 高德地图为 L7.AMap
|
|
|
|
|
|
style: 'mapbox://styles/mapbox/streets-v9',
|
|
|
|
|
|
center: [110.19382669582967, 50.258134],
|
|
|
|
|
|
pitch: 0,
|
|
|
|
|
|
zoom: 3,
|
|
|
|
|
|
token: 'pg.xxx', // 高德或者 Mapbox 的 token
|
|
|
|
|
|
}),
|
2019-11-14 20:52:43 +08:00
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
// 创建图层
|
|
|
|
|
|
const layer = new L7.PolygonLayer({
|
|
|
|
|
|
enablePicking: true,
|
|
|
|
|
|
enableHighlight: true,
|
|
|
|
|
|
passes: [
|
|
|
|
|
|
[
|
|
|
|
|
|
'colorHalftone',
|
|
|
|
|
|
{
|
|
|
|
|
|
size: 8,
|
|
|
|
|
|
},
|
|
|
|
|
|
],
|
|
|
|
|
|
],
|
|
|
|
|
|
});
|
|
|
|
|
|
layer
|
|
|
|
|
|
.source(data)
|
|
|
|
|
|
.size('name', [0, 10000, 50000, 30000, 100000])
|
|
|
|
|
|
.color('name', [
|
|
|
|
|
|
'#2E8AE6',
|
|
|
|
|
|
'#69D1AB',
|
|
|
|
|
|
'#DAF291',
|
|
|
|
|
|
'#FFD591',
|
|
|
|
|
|
'#FF7A45',
|
|
|
|
|
|
'#CF1D49',
|
|
|
|
|
|
])
|
|
|
|
|
|
.shape('fill')
|
|
|
|
|
|
.style({
|
|
|
|
|
|
opacity: 0.8,
|
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
// 添加图层到场景中
|
|
|
|
|
|
scene.addLayer(layer);
|
|
|
|
|
|
})();
|
|
|
|
|
|
</script>
|
|
|
|
|
|
</body>
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
⚠️需要获取高德或者 Mapbox 的使用 token 并传入 `L7.Scene` 的构造函数，获取方式如下：
|
|
|
|
|
|
* 高德地图开发者 Key [申请方法](https://lbs.amap.com/dev/key/)
|
|
|
|
|
|
* [Mapbox Access Tokens](https://docs.mapbox.com/help/how-mapbox-works/access-tokens/#creating-and-managing-access-tokens)
|
|
|
|
|
|
|
|
|
|
|
|
## 通过 Submodule 使用
|
|
|
|
|
|
|
2019-11-26 17:51:29 +08:00
|
|
|
|
首先通过 `npm/yarn` 安装 `@antv/l7@beta`：
|
2019-11-14 20:52:43 +08:00
|
|
|
|
```bash
|
2019-11-26 17:51:29 +08:00
|
|
|
|
npm install --save @antv/l7@beta
|
2019-11-14 20:52:43 +08:00
|
|
|
|
// or
|
2019-11-26 17:51:29 +08:00
|
|
|
|
yarn add @antv/l7@beta
|
2019-11-14 20:52:43 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
然后就可以使用其中包含的场景和各类图层：
|
|
|
|
|
|
```typescript
|
2019-11-25 15:27:56 +08:00
|
|
|
|
import { Scene, PolygonLayer } from '@antv/l7';
|
2019-11-26 17:51:29 +08:00
|
|
|
|
import { AMap } from '@antv/l7-maps';
|
2019-11-14 20:52:43 +08:00
|
|
|
|
|
|
|
|
|
|
(async function() {
|
|
|
|
|
|
// 获取数据
|
|
|
|
|
|
const response = await fetch(
|
|
|
|
|
|
'https://gw.alipayobjects.com/os/basement_prod/d2e0e930-fd44-4fca-8872-c1037b0fee7b.json',
|
|
|
|
|
|
);
|
|
|
|
|
|
const data = await response.json();
|
|
|
|
|
|
|
|
|
|
|
|
// 创建场景
|
|
|
|
|
|
const scene = new Scene({
|
|
|
|
|
|
id: 'map',
|
2019-11-26 17:51:29 +08:00
|
|
|
|
map: new AMap({
|
|
|
|
|
|
center: [110.19382669582967, 50.258134],
|
|
|
|
|
|
pitch: 0,
|
|
|
|
|
|
style: 'dark',
|
|
|
|
|
|
zoom: 3,
|
|
|
|
|
|
token: 'pg.xxx', // 高德或者 Mapbox 的 token
|
|
|
|
|
|
}),
|
2019-11-14 20:52:43 +08:00
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
// 创建图层
|
|
|
|
|
|
const layer = new PolygonLayer({});
|
|
|
|
|
|
layer
|
|
|
|
|
|
.source(data)
|
|
|
|
|
|
.size('name', [0, 10000, 50000, 30000, 100000])
|
|
|
|
|
|
.color('name', [
|
|
|
|
|
|
'#2E8AE6',
|
|
|
|
|
|
'#69D1AB',
|
|
|
|
|
|
'#DAF291',
|
|
|
|
|
|
'#FFD591',
|
|
|
|
|
|
'#FF7A45',
|
|
|
|
|
|
'#CF1D49',
|
|
|
|
|
|
])
|
|
|
|
|
|
.shape('fill')
|
|
|
|
|
|
.style({
|
|
|
|
|
|
opacity: 0.8,
|
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
|
|
// 添加图层到场景中
|
|
|
|
|
|
scene.addLayer(layer);
|
|
|
|
|
|
})();
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
L7 目前的文档都通过这种方式使用，可以参考项目中的 stories：
|
|
|
|
|
|
* [高德地图](https://github.com/antvis/L7/blob/next/stories/MapAdaptor/components/AMap.tsx)
|
|
|
|
|
|
* [Mapbox](https://github.com/antvis/L7/blob/next/stories/MapAdaptor/components/Mapbox.tsx)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## [WIP] React
|
|
|
|
|
|
|
|
|
|
|
|
React 组件待开发，目前可以暂时以 Submodule 方式使用：
|
|
|
|
|
|
```tsx
|
2019-11-25 15:27:56 +08:00
|
|
|
|
import { Scene, PolygonLayer } from '@antv/l7';
|
2019-11-26 17:51:29 +08:00
|
|
|
|
import { AMap } from '@antv/l7-maps';
|
2019-11-14 20:52:43 +08:00
|
|
|
|
import * as React from 'react';
|
|
|
|
|
|
|
2019-11-26 17:51:29 +08:00
|
|
|
|
export default class AMapExample extends React.Component {
|
2019-11-14 20:52:43 +08:00
|
|
|
|
private scene: Scene;
|
|
|
|
|
|
|
|
|
|
|
|
public componentWillUnmount() {
|
|
|
|
|
|
this.scene.destroy();
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
public async componentDidMount() {
|
|
|
|
|
|
const response = await fetch(
|
|
|
|
|
|
'https://gw.alipayobjects.com/os/basement_prod/d2e0e930-fd44-4fca-8872-c1037b0fee7b.json',
|
|
|
|
|
|
);
|
|
|
|
|
|
const scene = new Scene({
|
|
|
|
|
|
id: 'map',
|
2019-11-26 17:51:29 +08:00
|
|
|
|
map: new AMap({
|
|
|
|
|
|
center: [110.19382669582967, 50.258134],
|
|
|
|
|
|
pitch: 0,
|
|
|
|
|
|
style: 'dark',
|
|
|
|
|
|
zoom: 3,
|
|
|
|
|
|
token: 'pg.xxx', // 高德或者 Mapbox 的 token
|
|
|
|
|
|
}),
|
2019-11-14 20:52:43 +08:00
|
|
|
|
});
|
|
|
|
|
|
const layer = new PolygonLayer({});
|
|
|
|
|
|
|
|
|
|
|
|
layer
|
|
|
|
|
|
.source(await response.json())
|
|
|
|
|
|
.size('name', [0, 10000, 50000, 30000, 100000])
|
|
|
|
|
|
.color('name', [
|
|
|
|
|
|
'#2E8AE6',
|
|
|
|
|
|
'#69D1AB',
|
|
|
|
|
|
'#DAF291',
|
|
|
|
|
|
'#FFD591',
|
|
|
|
|
|
'#FF7A45',
|
|
|
|
|
|
'#CF1D49',
|
|
|
|
|
|
])
|
|
|
|
|
|
.shape('fill')
|
|
|
|
|
|
.style({
|
|
|
|
|
|
opacity: 0.8,
|
|
|
|
|
|
});
|
|
|
|
|
|
scene.addLayer(layer);
|
|
|
|
|
|
this.scene = scene;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
public render() {
|
|
|
|
|
|
return (
|
|
|
|
|
|
<div
|
|
|
|
|
|
id="map"
|
|
|
|
|
|
style={{
|
|
|
|
|
|
position: 'absolute',
|
|
|
|
|
|
top: 0,
|
|
|
|
|
|
left: 0,
|
|
|
|
|
|
right: 0,
|
|
|
|
|
|
bottom: 0,
|
|
|
|
|
|
}}
|
|
|
|
|
|
/>
|
|
|
|
|
|
);
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
⚠️组件 Unmount 时需要通过 `scene.destroy()` 手动销毁场景。
|
