mirror of https://gitee.com/antv-l7/antv-l7
Merge branch 'master' of https://github.com/antvis/L7
This commit is contained in:
commit
760c55268c
|
@ -15,7 +15,7 @@ const scene = new Scene({
|
||||||
id: 'map',
|
id: 'map',
|
||||||
map: new GaodeMap({
|
map: new GaodeMap({
|
||||||
style: 'dark',
|
style: 'dark',
|
||||||
center: [ 110.770672, 34.159869 ],
|
center: [110.770672, 34.159869],
|
||||||
pitch: 45,
|
pitch: 45,
|
||||||
}),
|
}),
|
||||||
});
|
});
|
||||||
|
@ -25,75 +25,73 @@ const scene = new L7.Scene({
|
||||||
id: 'map',
|
id: 'map',
|
||||||
map: new L7.GaodeMap({
|
map: new L7.GaodeMap({
|
||||||
style: 'dark',
|
style: 'dark',
|
||||||
center: [ 110.770672, 34.159869 ],
|
center: [110.770672, 34.159869],
|
||||||
pitch: 45,
|
pitch: 45,
|
||||||
}),
|
}),
|
||||||
});
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## Map
|
## Map
|
||||||
|
|
||||||
L7 地理可视化侧重于地理数据的可视化表达,地图层需要依赖第三方地图,第三方地图通过Scene 统一创建,创建管理
|
L7 地理可视化侧重于地理数据的可视化表达,地图层需要依赖第三方地图,第三方地图通过 Scene 统一创建,创建管理
|
||||||
只需要通过Scene传入地图配置项即可。
|
只需要通过 Scene 传入地图配置项即可。
|
||||||
|
|
||||||
目前L7 支持两种地图底图
|
目前 L7 支持两种地图底图
|
||||||
|
|
||||||
- 高德地图 国内业务场景 合规中国地图
|
- 高德地图 国内业务场景 合规中国地图
|
||||||
- MapBox 国际业务,或者内网离线部署场景
|
- MapBox 国际业务,或者内网离线部署场景
|
||||||
|
|
||||||
|
### map
|
||||||
|
|
||||||
### map
|
可以通过 scene map 属性获取 map 实例
|
||||||
|
|
||||||
可以通过scene map 属性获取 map实例
|
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const map = scene.map
|
const map = scene.map;
|
||||||
|
|
||||||
```
|
```
|
||||||
为了统一不同底图之前的接口差异 L7 在scene层对map的方法做了统一,因此一些地图的操作方法可以通过scene调用这样,切换不同底图时保证表现一致。
|
|
||||||
|
为了统一不同底图之前的接口差异 L7 在 scene 层对 map 的方法做了统一,因此一些地图的操作方法可以通过 scene 调用这样,切换不同底图时保证表现一致。
|
||||||
|
|
||||||
示例代码
|
示例代码
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const scene =new L7.Scene({
|
const scene = new L7.Scene({
|
||||||
id: 'map',
|
id: 'map',
|
||||||
map: new L7.GaodeMap({
|
map: new L7.GaodeMap({
|
||||||
style: 'dark',
|
style: 'dark',
|
||||||
center: [ 110.770672, 34.159869 ],
|
center: [110.770672, 34.159869],
|
||||||
pitch: 45,
|
pitch: 45,
|
||||||
}),
|
}),
|
||||||
})
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
### 构造函数
|
### 构造函数
|
||||||
|
|
||||||
**Scene**
|
**Scene**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 配置项
|
## 配置项
|
||||||
|
|
||||||
### 地图配置项
|
### 地图配置项
|
||||||
|
|
||||||
### id
|
### id
|
||||||
|
|
||||||
需传入 dom 容器或者容器 id {domObject || string} [必选]
|
需传入 dom 容器或者容器 id {domObject || string} [必选]
|
||||||
|
|
||||||
|
|
||||||
### zoom
|
### zoom
|
||||||
地图初始显示级别 {number} (0-22)
|
|
||||||
|
地图初始显示级别 {number} (0-22)
|
||||||
|
|
||||||
### center
|
### center
|
||||||
|
|
||||||
地图初始中心经纬度 {Lnglat}
|
地图初始中心经纬度 {Lnglat}
|
||||||
|
|
||||||
### pitch
|
### pitch
|
||||||
|
|
||||||
地图初始俯仰角度 {number} default 0
|
地图初始俯仰角度 {number} default 0
|
||||||
|
|
||||||
### style
|
### style
|
||||||
|
|
||||||
简化地图样式设置,L7 内置了三种主题默认样式 高德,mapbox 都可以使用
|
简化地图样式设置,L7 内置了三种主题默认样式 高德,mapbox 都可以使用
|
||||||
|
|
||||||
- dark
|
- dark
|
||||||
- light
|
- light
|
||||||
- normal
|
- normal
|
||||||
|
@ -103,62 +101,69 @@ const scene =new L7.Scene({
|
||||||
比如高德地图
|
比如高德地图
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
{
|
{
|
||||||
style:'amap://styles/2a09079c3daac9420ee53b67307a8006?isPublic=true' // 设置方法和高德地图一致
|
style: 'amap://styles/2a09079c3daac9420ee53b67307a8006?isPublic=true'; // 设置方法和高德地图一致
|
||||||
}
|
}
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
### minZoom
|
### minZoom
|
||||||
地图最小缩放等级 {number} default 0 (0-22)
|
|
||||||
|
地图最小缩放等级 {number} default 0 (0-22)
|
||||||
|
|
||||||
### maxZoom
|
### maxZoom
|
||||||
地图最大缩放等级 {number} default 22 (0-22)
|
|
||||||
|
地图最大缩放等级 {number} default 22 (0-22)
|
||||||
|
|
||||||
### rotateEnable
|
### rotateEnable
|
||||||
|
|
||||||
地图是否可旋转 {Boolean} default true
|
地图是否可旋转 {Boolean} default true
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 方法
|
## 方法
|
||||||
|
|
||||||
### getZoom
|
### getZoom
|
||||||
|
|
||||||
获取当前缩放等级
|
获取当前缩放等级
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getZoom();
|
scene.getZoom();
|
||||||
```
|
```
|
||||||
|
|
||||||
return {float} 当前缩放等级
|
return {float} 当前缩放等级
|
||||||
|
|
||||||
### getLayers()
|
### getLayers()
|
||||||
|
|
||||||
获取所有的地图图层
|
获取所有的地图图层
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getLayers();
|
scene.getLayers();
|
||||||
```
|
```
|
||||||
|
|
||||||
return 图层数组 {Array}
|
return 图层数组 {Array}
|
||||||
|
|
||||||
|
|
||||||
### getCenter()
|
### getCenter()
|
||||||
|
|
||||||
获取地图中心点
|
获取地图中心点
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getCenter()
|
scene.getCenter();
|
||||||
```
|
```
|
||||||
|
|
||||||
return {Lnglat} :地图中心点
|
return {Lnglat} :地图中心点
|
||||||
|
|
||||||
### getSize()
|
### getSize()
|
||||||
|
|
||||||
获取地图容器大小
|
获取地图容器大小
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getSize()
|
scene.getSize();
|
||||||
```
|
```
|
||||||
|
|
||||||
return { Object } 地图容器的 width,height
|
return { Object } 地图容器的 width,height
|
||||||
|
|
||||||
### getPitch()
|
### getPitch()
|
||||||
|
|
||||||
获取地图俯仰角
|
获取地图俯仰角
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getPitch();
|
scene.getPitch();
|
||||||
```
|
```
|
||||||
|
@ -167,9 +172,9 @@ return {number} pitch
|
||||||
|
|
||||||
### setMapStyle
|
### setMapStyle
|
||||||
|
|
||||||
参数:`style` {string} 地图样式 具体样式格式和各底图设置方法一致
|
参数:`style` {string} 地图样式 具体样式格式和各底图设置方法一致
|
||||||
|
|
||||||
L7 内置了三种地图样式,AMAP 和MapBox都适用
|
L7 内置了三种地图样式,AMAP 和 MapBox 都适用
|
||||||
|
|
||||||
- light
|
- light
|
||||||
- dark
|
- dark
|
||||||
|
@ -183,150 +188,153 @@ L7 内置了三种地图样式,AMAP 和MapBox都适用
|
||||||
scene.setMapStyle('light');
|
scene.setMapStyle('light');
|
||||||
|
|
||||||
// mapbox 主题设置
|
// mapbox 主题设置
|
||||||
scene.setMapStyle('mapbox://styles/mapbox/streets-v11')
|
scene.setMapStyle('mapbox://styles/mapbox/streets-v11');
|
||||||
|
|
||||||
// AMap
|
|
||||||
scene.setMapStyle('amap://styles/2a09079c3daac9420ee53b67307a8006?isPublic=true')
|
|
||||||
|
|
||||||
|
// AMap
|
||||||
|
scene.setMapStyle(
|
||||||
|
'amap://styles/2a09079c3daac9420ee53b67307a8006?isPublic=true',
|
||||||
|
);
|
||||||
```
|
```
|
||||||
|
|
||||||
### setCenter()
|
### setCenter()
|
||||||
|
|
||||||
设置地图中心点坐标
|
设置地图中心点坐标
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.setCenter([lng,lat])
|
scene.setCenter([lng, lat]);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数:`center` {LngLat} 地图中心点
|
参数:`center` {LngLat} 地图中心点
|
||||||
|
|
||||||
|
|
||||||
### setZoomAndCenter
|
### setZoomAndCenter
|
||||||
|
|
||||||
设置地图等级和中心
|
设置地图等级和中心
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.setZoomAndCenter(zoom,center)
|
scene.setZoomAndCenter(zoom, center);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数:zoom {number}<br />center {LngLat}
|
参数:zoom {number}<br />center {LngLat}
|
||||||
|
|
||||||
|
|
||||||
### setRotation
|
### setRotation
|
||||||
|
|
||||||
设置地图顺时针旋转角度,旋转原点为地图容器中心点,取值范围 [0-360]
|
设置地图顺时针旋转角度,旋转原点为地图容器中心点,取值范围 [0-360]
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.setRotation(rotation)
|
scene.setRotation(rotation);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数: `rotation` {number}
|
参数: `rotation` {number}
|
||||||
|
|
||||||
### zoomIn
|
### zoomIn
|
||||||
|
|
||||||
地图放大一级
|
地图放大一级
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.zoomIn()
|
scene.zoomIn();
|
||||||
```
|
```
|
||||||
|
|
||||||
### zoomOut
|
### zoomOut
|
||||||
|
|
||||||
地图缩小一级
|
地图缩小一级
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.ZoomOUt()
|
scene.ZoomOUt();
|
||||||
```
|
```
|
||||||
|
|
||||||
### panTo
|
### panTo
|
||||||
|
|
||||||
地图平移到指定的位置
|
地图平移到指定的位置
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.panTo(LngLat)
|
scene.panTo(LngLat);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数:`center` LngLat 中心位置坐标
|
参数:`center` LngLat 中心位置坐标
|
||||||
|
|
||||||
### panBy
|
### panBy
|
||||||
以像素为单位沿X方向和Y方向移动地图
|
|
||||||
```javascript
|
|
||||||
scene.panBy(x,y)
|
|
||||||
```
|
|
||||||
参数:<br />`x` {number} 水平方向移动像素 向右为正方向<br /> `y` {number} 垂直方向移动像素 向下为正方向
|
|
||||||
|
|
||||||
|
以像素为单位沿 X 方向和 Y 方向移动地图
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
scene.panBy(x, y);
|
||||||
|
```
|
||||||
|
|
||||||
|
参数:<br />`x` {number} 水平方向移动像素 向右为正方向<br /> `y` {number} 垂直方向移动像素 向下为正方向
|
||||||
|
|
||||||
### setPitch
|
### setPitch
|
||||||
|
|
||||||
设置地图仰俯角度
|
设置地图仰俯角度
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.setPitch(pitch)
|
scene.setPitch(pitch);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数 :<br /> `pitch` {number}
|
参数 :<br /> `pitch` {number}
|
||||||
|
|
||||||
|
|
||||||
### fitBounds
|
### fitBounds
|
||||||
|
|
||||||
地图缩放到某个范围内<br />参数 :<br /> `extent` { array} 经纬度范围 [minlng,minlat,maxlng,maxlat]
|
地图缩放到某个范围内<br />参数 :<br /> `extent` { array} 经纬度范围 [minlng,minlat,maxlng,maxlat]
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.fitBounds([112,32,114,35]);
|
scene.fitBounds([112, 32, 114, 35]);
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### removeLayer
|
### removeLayer
|
||||||
移除layer
|
|
||||||
|
移除 layer
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.removeLayer(layer)
|
scene.removeLayer(layer);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数 `layer` {Layer}
|
参数 `layer` {Layer}
|
||||||
|
|
||||||
### getLayers
|
|
||||||
获取所有的layer
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
scene.getLayers()
|
|
||||||
```
|
|
||||||
|
|
||||||
return layers {array}
|
|
||||||
|
|
||||||
## 事件
|
## 事件
|
||||||
|
|
||||||
|
|
||||||
### on
|
### on
|
||||||
|
|
||||||
事件监听
|
事件监听
|
||||||
|
|
||||||
#### 参数
|
#### 参数
|
||||||
`eventName` {string} 事件名<br />`hander` {function } 事件回调函数
|
|
||||||
|
|
||||||
|
`eventName` {string} 事件名<br />`hander` {function } 事件回调函数
|
||||||
|
|
||||||
### off
|
### off
|
||||||
移除事件监听<br />`eventName` {string} 事件名<br />`hander` {function } 事件回调函数
|
|
||||||
|
|
||||||
|
移除事件监听<br />`eventName` {string} 事件名<br />`hander` {function } 事件回调函数
|
||||||
|
|
||||||
### 地图事件
|
### 地图事件
|
||||||
```javascript
|
|
||||||
scene.on('loaded',()=>{}) //地图加载完成触发
|
|
||||||
scene.on('mapmove',()=>{}) // 地图平移时触发事件
|
|
||||||
scene.on('movestart',()=>{}) // 地图平移开始时触发
|
|
||||||
scene.on('moveend',()=>{}) // 地图移动结束后触发,包括平移,以及中心点变化的缩放。如地图有拖拽缓动效果,则在缓动结束后触发
|
|
||||||
scene.on('zoomchange',()=>{}) // 地图缩放级别更改后触发
|
|
||||||
scene.on('zoomstart',()=>{}) // 缩放开始时触发
|
|
||||||
scene.on('zoomend',()=>{}) // 缩放停止时触发
|
|
||||||
```
|
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
scene.on('loaded', () => {}); //地图加载完成触发
|
||||||
|
scene.on('mapmove', () => {}); // 地图平移时触发事件
|
||||||
|
scene.on('movestart', () => {}); // 地图平移开始时触发
|
||||||
|
scene.on('moveend', () => {}); // 地图移动结束后触发,包括平移,以及中心点变化的缩放。如地图有拖拽缓动效果,则在缓动结束后触发
|
||||||
|
scene.on('zoomchange', () => {}); // 地图缩放级别更改后触发
|
||||||
|
scene.on('zoomstart', () => {}); // 缩放开始时触发
|
||||||
|
scene.on('zoomend', () => {}); // 缩放停止时触发
|
||||||
|
```
|
||||||
|
|
||||||
### 鼠标事件
|
### 鼠标事件
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.on('click', (ev)=>{}); // 鼠标左键点击事件
|
scene.on('click', (ev) => {}); // 鼠标左键点击事件
|
||||||
scene.on('dblclick', (ev)=>{}); // 鼠标左键双击事件
|
scene.on('dblclick', (ev) => {}); // 鼠标左键双击事件
|
||||||
scene.on('mousemove', (ev)=>{}); // 鼠标在地图上移动时触发
|
scene.on('mousemove', (ev) => {}); // 鼠标在地图上移动时触发
|
||||||
scene.on('mousewheel', (ev)=>{}); // 鼠标滚轮开始缩放地图时触发
|
scene.on('mousewheel', (ev) => {}); // 鼠标滚轮开始缩放地图时触发
|
||||||
scene.on('mouseover', (ev)=>{}); // 鼠标移入地图容器内时触发
|
scene.on('mouseover', (ev) => {}); // 鼠标移入地图容器内时触发
|
||||||
scene.on('mouseout', (ev)=>{}); // 鼠标移出地图容器时触发
|
scene.on('mouseout', (ev) => {}); // 鼠标移出地图容器时触发
|
||||||
scene.on('mouseup', (ev)=>{}); // 鼠标在地图上单击抬起时触发
|
scene.on('mouseup', (ev) => {}); // 鼠标在地图上单击抬起时触发
|
||||||
scene.on('mousedown', (ev)=>{}); // 鼠标在地图上单击按下时触发
|
scene.on('mousedown', (ev) => {}); // 鼠标在地图上单击按下时触发
|
||||||
scene.on('rightclick', (ev)=>{}); // 鼠标右键单击事件
|
scene.on('rightclick', (ev) => {}); // 鼠标右键单击事件
|
||||||
scene.on('dragstart', (ev)=>{}); //开始拖拽地图时触发
|
scene.on('dragstart', (ev) => {}); //开始拖拽地图时触发
|
||||||
scene.on('dragging', (ev)=>{}); // 拖拽地图过程中触发
|
scene.on('dragging', (ev) => {}); // 拖拽地图过程中触发
|
||||||
scene.on('dragend', (ev)=>{}); //停止拖拽地图时触发。如地图有拖拽缓动效果,则在拽停止,缓动开始前触发
|
scene.on('dragend', (ev) => {}); //停止拖拽地图时触发。如地图有拖拽缓动效果,则在拽停止,缓动开始前触发
|
||||||
```
|
```
|
||||||
|
|
||||||
### 其它事件
|
### 其它事件
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.on('resize',()=>{}) // 地图容器大小改变事件
|
scene.on('resize', () => {}); // 地图容器大小改变事件
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -15,7 +15,7 @@ const scene = new Scene({
|
||||||
id: 'map',
|
id: 'map',
|
||||||
map: new GaodeMap({
|
map: new GaodeMap({
|
||||||
style: 'dark',
|
style: 'dark',
|
||||||
center: [ 110.770672, 34.159869 ],
|
center: [110.770672, 34.159869],
|
||||||
pitch: 45,
|
pitch: 45,
|
||||||
}),
|
}),
|
||||||
});
|
});
|
||||||
|
@ -25,75 +25,73 @@ const scene = new L7.Scene({
|
||||||
id: 'map',
|
id: 'map',
|
||||||
map: new L7.GaodeMap({
|
map: new L7.GaodeMap({
|
||||||
style: 'dark',
|
style: 'dark',
|
||||||
center: [ 110.770672, 34.159869 ],
|
center: [110.770672, 34.159869],
|
||||||
pitch: 45,
|
pitch: 45,
|
||||||
}),
|
}),
|
||||||
});
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## Map
|
## Map
|
||||||
|
|
||||||
L7 地理可视化侧重于地理数据的可视化表达,地图层需要依赖第三方地图,第三方地图通过Scene 统一创建,创建管理
|
L7 地理可视化侧重于地理数据的可视化表达,地图层需要依赖第三方地图,第三方地图通过 Scene 统一创建,创建管理
|
||||||
只需要通过Scene传入地图配置项即可。
|
只需要通过 Scene 传入地图配置项即可。
|
||||||
|
|
||||||
目前L7 支持两种地图底图
|
目前 L7 支持两种地图底图
|
||||||
|
|
||||||
- 高德地图 国内业务场景 合规中国地图
|
- 高德地图 国内业务场景 合规中国地图
|
||||||
- MapBox 国际业务,或者内网离线部署场景
|
- MapBox 国际业务,或者内网离线部署场景
|
||||||
|
|
||||||
|
### map
|
||||||
|
|
||||||
### map
|
可以通过 scene map 属性获取 map 实例
|
||||||
|
|
||||||
可以通过scene map 属性获取 map实例
|
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const map = scene.map
|
const map = scene.map;
|
||||||
|
|
||||||
```
|
```
|
||||||
为了统一不同底图之前的接口差异 L7 在scene层对map的方法做了统一,因此一些地图的操作方法可以通过scene调用这样,切换不同底图时保证表现一致。
|
|
||||||
|
为了统一不同底图之前的接口差异 L7 在 scene 层对 map 的方法做了统一,因此一些地图的操作方法可以通过 scene 调用这样,切换不同底图时保证表现一致。
|
||||||
|
|
||||||
示例代码
|
示例代码
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const scene =new L7.Scene({
|
const scene = new L7.Scene({
|
||||||
id: 'map',
|
id: 'map',
|
||||||
map: new L7.GaodeMap({
|
map: new L7.GaodeMap({
|
||||||
style: 'dark',
|
style: 'dark',
|
||||||
center: [ 110.770672, 34.159869 ],
|
center: [110.770672, 34.159869],
|
||||||
pitch: 45,
|
pitch: 45,
|
||||||
}),
|
}),
|
||||||
})
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
### 构造函数
|
### 构造函数
|
||||||
|
|
||||||
**Scene**
|
**Scene**
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 配置项
|
## 配置项
|
||||||
|
|
||||||
### 地图配置项
|
### 地图配置项
|
||||||
|
|
||||||
### id
|
### id
|
||||||
|
|
||||||
需传入 dom 容器或者容器 id {domObject || string} [必选]
|
需传入 dom 容器或者容器 id {domObject || string} [必选]
|
||||||
|
|
||||||
|
|
||||||
### zoom
|
### zoom
|
||||||
地图初始显示级别 {number} (0-22)
|
|
||||||
|
地图初始显示级别 {number} (0-22)
|
||||||
|
|
||||||
### center
|
### center
|
||||||
|
|
||||||
地图初始中心经纬度 {Lnglat}
|
地图初始中心经纬度 {Lnglat}
|
||||||
|
|
||||||
### pitch
|
### pitch
|
||||||
|
|
||||||
地图初始俯仰角度 {number} default 0
|
地图初始俯仰角度 {number} default 0
|
||||||
|
|
||||||
### style
|
### style
|
||||||
|
|
||||||
简化地图样式设置,L7 内置了三种主题默认样式 高德,mapbox 都可以使用
|
简化地图样式设置,L7 内置了三种主题默认样式 高德,mapbox 都可以使用
|
||||||
|
|
||||||
- dark
|
- dark
|
||||||
- light
|
- light
|
||||||
- normal
|
- normal
|
||||||
|
@ -103,62 +101,69 @@ const scene =new L7.Scene({
|
||||||
比如高德地图
|
比如高德地图
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
{
|
{
|
||||||
style:'amap://styles/2a09079c3daac9420ee53b67307a8006?isPublic=true' // 设置方法和高德地图一致
|
style: 'amap://styles/2a09079c3daac9420ee53b67307a8006?isPublic=true'; // 设置方法和高德地图一致
|
||||||
}
|
}
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
### minZoom
|
### minZoom
|
||||||
地图最小缩放等级 {number} default 0 (0-22)
|
|
||||||
|
地图最小缩放等级 {number} default 0 (0-22)
|
||||||
|
|
||||||
### maxZoom
|
### maxZoom
|
||||||
地图最大缩放等级 {number} default 22 (0-22)
|
|
||||||
|
地图最大缩放等级 {number} default 22 (0-22)
|
||||||
|
|
||||||
### rotateEnable
|
### rotateEnable
|
||||||
|
|
||||||
地图是否可旋转 {Boolean} default true
|
地图是否可旋转 {Boolean} default true
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 方法
|
## 方法
|
||||||
|
|
||||||
### getZoom
|
### getZoom
|
||||||
|
|
||||||
获取当前缩放等级
|
获取当前缩放等级
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getZoom();
|
scene.getZoom();
|
||||||
```
|
```
|
||||||
|
|
||||||
return {float} 当前缩放等级
|
return {float} 当前缩放等级
|
||||||
|
|
||||||
### getLayers()
|
### getLayers()
|
||||||
|
|
||||||
获取所有的地图图层
|
获取所有的地图图层
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getLayers();
|
scene.getLayers();
|
||||||
```
|
```
|
||||||
|
|
||||||
return 图层数组 {Array}
|
return 图层数组 {Array}
|
||||||
|
|
||||||
|
|
||||||
### getCenter()
|
### getCenter()
|
||||||
|
|
||||||
获取地图中心点
|
获取地图中心点
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getCenter()
|
scene.getCenter();
|
||||||
```
|
```
|
||||||
|
|
||||||
return {Lnglat} :地图中心点
|
return {Lnglat} :地图中心点
|
||||||
|
|
||||||
### getSize()
|
### getSize()
|
||||||
|
|
||||||
获取地图容器大小
|
获取地图容器大小
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getSize()
|
scene.getSize();
|
||||||
```
|
```
|
||||||
|
|
||||||
return { Object } 地图容器的 width,height
|
return { Object } 地图容器的 width,height
|
||||||
|
|
||||||
### getPitch()
|
### getPitch()
|
||||||
|
|
||||||
获取地图俯仰角
|
获取地图俯仰角
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.getPitch();
|
scene.getPitch();
|
||||||
```
|
```
|
||||||
|
@ -167,9 +172,9 @@ return {number} pitch
|
||||||
|
|
||||||
### setMapStyle
|
### setMapStyle
|
||||||
|
|
||||||
参数:`style` {string} 地图样式 具体样式格式和各底图设置方法一致
|
参数:`style` {string} 地图样式 具体样式格式和各底图设置方法一致
|
||||||
|
|
||||||
L7 内置了三种地图样式,AMAP 和MapBox都适用
|
L7 内置了三种地图样式,AMAP 和 MapBox 都适用
|
||||||
|
|
||||||
- light
|
- light
|
||||||
- dark
|
- dark
|
||||||
|
@ -183,87 +188,103 @@ L7 内置了三种地图样式,AMAP 和MapBox都适用
|
||||||
scene.setMapStyle('light');
|
scene.setMapStyle('light');
|
||||||
|
|
||||||
// mapbox 主题设置
|
// mapbox 主题设置
|
||||||
scene.setMapStyle('mapbox://styles/mapbox/streets-v11')
|
scene.setMapStyle('mapbox://styles/mapbox/streets-v11');
|
||||||
|
|
||||||
// AMap
|
|
||||||
scene.setMapStyle('amap://styles/2a09079c3daac9420ee53b67307a8006?isPublic=true')
|
|
||||||
|
|
||||||
|
// AMap
|
||||||
|
scene.setMapStyle(
|
||||||
|
'amap://styles/2a09079c3daac9420ee53b67307a8006?isPublic=true',
|
||||||
|
);
|
||||||
```
|
```
|
||||||
|
|
||||||
### setCenter()
|
### setCenter()
|
||||||
|
|
||||||
设置地图中心点坐标
|
设置地图中心点坐标
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.setCenter([lng,lat])
|
scene.setCenter([lng, lat]);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数:`center` {LngLat} 地图中心点
|
参数:`center` {LngLat} 地图中心点
|
||||||
|
|
||||||
|
|
||||||
### setZoomAndCenter
|
### setZoomAndCenter
|
||||||
|
|
||||||
设置地图等级和中心
|
设置地图等级和中心
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.setZoomAndCenter(zoom,center)
|
scene.setZoomAndCenter(zoom, center);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数:
|
参数:
|
||||||
|
|
||||||
- zoom {number}
|
- zoom {number}
|
||||||
- center {LngLat}
|
- center {LngLat}
|
||||||
|
|
||||||
|
|
||||||
### setRotation
|
### setRotation
|
||||||
|
|
||||||
设置地图顺时针旋转角度,旋转原点为地图容器中心点,取值范围 [0-360]
|
设置地图顺时针旋转角度,旋转原点为地图容器中心点,取值范围 [0-360]
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.setRotation(rotation)
|
scene.setRotation(rotation);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数: `rotation` {number}
|
参数: `rotation` {number}
|
||||||
|
|
||||||
### zoomIn
|
### zoomIn
|
||||||
|
|
||||||
地图放大一级
|
地图放大一级
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.zoomIn()
|
scene.zoomIn();
|
||||||
```
|
```
|
||||||
|
|
||||||
### zoomOut
|
### zoomOut
|
||||||
|
|
||||||
地图缩小一级
|
地图缩小一级
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.ZoomOUt()
|
scene.ZoomOUt();
|
||||||
```
|
```
|
||||||
|
|
||||||
### panTo
|
### panTo
|
||||||
|
|
||||||
地图平移到指定的位置
|
地图平移到指定的位置
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.panTo(LngLat)
|
scene.panTo(LngLat);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数:
|
参数:
|
||||||
|
|
||||||
- `center` LngLat 中心位置坐标
|
- `center` LngLat 中心位置坐标
|
||||||
|
|
||||||
### panBy
|
### panBy
|
||||||
以像素为单位沿X方向和Y方向移动地图
|
|
||||||
|
以像素为单位沿 X 方向和 Y 方向移动地图
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.panBy(x,y)
|
scene.panBy(x, y);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数:
|
参数:
|
||||||
|
|
||||||
- `x` {number} 水平方向移动像素 向右为正方向
|
- `x` {number} 水平方向移动像素 向右为正方向
|
||||||
|
|
||||||
- `y` {number} 垂直方向移动像素 向下为正方向
|
- `y` {number} 垂直方向移动像素 向下为正方向
|
||||||
|
|
||||||
|
|
||||||
### setPitch
|
### setPitch
|
||||||
|
|
||||||
设置地图仰俯角度
|
设置地图仰俯角度
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.setPitch(pitch)
|
scene.setPitch(pitch);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数 :
|
参数 :
|
||||||
- `pitch` {number}
|
|
||||||
|
|
||||||
|
- `pitch` {number}
|
||||||
|
|
||||||
### fitBounds
|
### fitBounds
|
||||||
|
|
||||||
地图缩放到某个范围内
|
地图缩放到某个范围内
|
||||||
|
|
||||||
参数 :
|
参数 :
|
||||||
|
@ -271,77 +292,66 @@ scene.setPitch(pitch)
|
||||||
- `extent` { array} 经纬度范围 [minlng,minlat,maxlng,maxlat]
|
- `extent` { array} 经纬度范围 [minlng,minlat,maxlng,maxlat]
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.fitBounds([112,32,114,35]);
|
scene.fitBounds([112, 32, 114, 35]);
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### removeLayer
|
### removeLayer
|
||||||
移除layer
|
|
||||||
|
移除 layer
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.removeLayer(layer)
|
scene.removeLayer(layer);
|
||||||
```
|
```
|
||||||
|
|
||||||
参数
|
参数
|
||||||
|
|
||||||
- `layer` {Layer}
|
- `layer` {Layer}
|
||||||
|
|
||||||
### getLayers
|
|
||||||
获取所有的layer
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
scene.getLayers()
|
|
||||||
```
|
|
||||||
|
|
||||||
return layers {array}
|
|
||||||
|
|
||||||
## 事件
|
## 事件
|
||||||
|
|
||||||
|
|
||||||
### on
|
### on
|
||||||
|
|
||||||
事件监听
|
事件监听
|
||||||
|
|
||||||
#### 参数
|
#### 参数
|
||||||
`eventName` {string} 事件名<br />`hander` {function } 事件回调函数
|
|
||||||
|
|
||||||
|
`eventName` {string} 事件名<br />`hander` {function } 事件回调函数
|
||||||
|
|
||||||
### off
|
### off
|
||||||
移除事件监听<br />`eventName` {string} 事件名<br />`hander` {function } 事件回调函数
|
|
||||||
|
|
||||||
|
移除事件监听<br />`eventName` {string} 事件名<br />`hander` {function } 事件回调函数
|
||||||
|
|
||||||
### 地图事件
|
### 地图事件
|
||||||
```javascript
|
|
||||||
scene.on('loaded',()=>{}) //地图加载完成触发
|
|
||||||
scene.on('mapmove',()=>{}) // 地图平移时触发事件
|
|
||||||
scene.on('movestart',()=>{}) // 地图平移开始时触发
|
|
||||||
scene.on('moveend',()=>{}) // 地图移动结束后触发,包括平移,以及中心点变化的缩放。如地图有拖拽缓动效果,则在缓动结束后触发
|
|
||||||
scene.on('zoomchange',()=>{}) // 地图缩放级别更改后触发
|
|
||||||
scene.on('zoomstart',()=>{}) // 缩放开始时触发
|
|
||||||
scene.on('zoomend',()=>{}) // 缩放停止时触发
|
|
||||||
```
|
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
scene.on('loaded', () => {}); //地图加载完成触发
|
||||||
|
scene.on('mapmove', () => {}); // 地图平移时触发事件
|
||||||
|
scene.on('movestart', () => {}); // 地图平移开始时触发
|
||||||
|
scene.on('moveend', () => {}); // 地图移动结束后触发,包括平移,以及中心点变化的缩放。如地图有拖拽缓动效果,则在缓动结束后触发
|
||||||
|
scene.on('zoomchange', () => {}); // 地图缩放级别更改后触发
|
||||||
|
scene.on('zoomstart', () => {}); // 缩放开始时触发
|
||||||
|
scene.on('zoomend', () => {}); // 缩放停止时触发
|
||||||
|
```
|
||||||
|
|
||||||
### 鼠标事件
|
### 鼠标事件
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.on('click', (ev)=>{}); // 鼠标左键点击事件
|
scene.on('click', (ev) => {}); // 鼠标左键点击事件
|
||||||
scene.on('dblclick', (ev)=>{}); // 鼠标左键双击事件
|
scene.on('dblclick', (ev) => {}); // 鼠标左键双击事件
|
||||||
scene.on('mousemove', (ev)=>{}); // 鼠标在地图上移动时触发
|
scene.on('mousemove', (ev) => {}); // 鼠标在地图上移动时触发
|
||||||
scene.on('mousewheel', (ev)=>{}); // 鼠标滚轮开始缩放地图时触发
|
scene.on('mousewheel', (ev) => {}); // 鼠标滚轮开始缩放地图时触发
|
||||||
scene.on('mouseover', (ev)=>{}); // 鼠标移入地图容器内时触发
|
scene.on('mouseover', (ev) => {}); // 鼠标移入地图容器内时触发
|
||||||
scene.on('mouseout', (ev)=>{}); // 鼠标移出地图容器时触发
|
scene.on('mouseout', (ev) => {}); // 鼠标移出地图容器时触发
|
||||||
scene.on('mouseup', (ev)=>{}); // 鼠标在地图上单击抬起时触发
|
scene.on('mouseup', (ev) => {}); // 鼠标在地图上单击抬起时触发
|
||||||
scene.on('mousedown', (ev)=>{}); // 鼠标在地图上单击按下时触发
|
scene.on('mousedown', (ev) => {}); // 鼠标在地图上单击按下时触发
|
||||||
scene.on('rightclick', (ev)=>{}); // 鼠标右键单击事件
|
scene.on('rightclick', (ev) => {}); // 鼠标右键单击事件
|
||||||
scene.on('dragstart', (ev)=>{}); //开始拖拽地图时触发
|
scene.on('dragstart', (ev) => {}); //开始拖拽地图时触发
|
||||||
scene.on('dragging', (ev)=>{}); // 拖拽地图过程中触发
|
scene.on('dragging', (ev) => {}); // 拖拽地图过程中触发
|
||||||
scene.on('dragend', (ev)=>{}); //停止拖拽地图时触发。如地图有拖拽缓动效果,则在拽停止,缓动开始前触发
|
scene.on('dragend', (ev) => {}); //停止拖拽地图时触发。如地图有拖拽缓动效果,则在拽停止,缓动开始前触发
|
||||||
```
|
```
|
||||||
|
|
||||||
### 其它事件
|
### 其它事件
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
scene.on('resize',()=>{}) // 地图容器大小改变事件
|
scene.on('resize', () => {}); // 地图容器大小改变事件
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -3,7 +3,7 @@ title: Image
|
||||||
order: 4
|
order: 4
|
||||||
---
|
---
|
||||||
|
|
||||||
Image 数据主要用于在地图根据经纬度范围添加图图片,不如一幅纸制地图扫描版你要放在地图显示。
|
Image 数据主要用于在地图根据经纬度范围添加图图片,比如一幅纸制地图扫描版你要放在地图显示。
|
||||||
|
|
||||||
## parser
|
## parser
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue