百度地图
简介
L7 地理可视化侧重于地理数据的可视化表达,地图层需要依赖第三方地图,第三方地图通过 Scene 统一创建管理,只需要通过 Scene 传入地图配置项即可。
L7 在内部解决了不同地图底图之间差异,同时 L7 层面统一管理地图的操作方法。
L7 目前支持的百度地图是API GL版本,也是百度地图官方推荐使用版本。
申请token
使用百度地图之前,需要申请百度地图密钥,如何申请百度地图密钥点我查看。
⚠️ L7 内部设置了默认 token,仅供测试使用
import
import { BaiduMap } from '@antv/l7-maps';
实例化
L7 提供 BaiduMap直接实例化地图,也可外部传入方式实例化地图。
新项目推荐 BaiduMap 直接实例化,已有地图项目可外部传入方式,以便快速接入 L7 的能力。
BaiduMap 实例化
import { BaiduMap } from '@antv/l7-maps';
const scene = new Scene({
id: 'map',
map: new BaiduMap({
// 填写百度地图密钥,此为测试token,不可用于生产
token: 'zLhopYPPERGtpGOgimcdKcCimGRyyIsh',
center: [103, 30],
pitch: 4,
zoom: 10,
rotation: 19,
}),
});
外部传入实例化
⚠️ scene id 参数需要与 BMapGL.Map 实例是同个容器。
⚠️ 传入地图实例需要自行引入百度地图的 API
const map = new BMapGL.Map('map', {
zoom: 11, // 初始化地图层级
minZoom: 4,
maxZoom: 23,
enableWheelZoom: true,
});
const scene = new Scene({
id: 'map',
map: new BaiduMap({
mapInstance: map,
}),
});
options
zoom 初始化缩放等级
number
地图初始显示级别 {number} Mapbox (0-24) 高德 (2-19)
center 地图中心
地图初始中心经纬度 {Lnglat}
pitch 地图倾角
地图初始俯仰角度 {number} default 0
bearing 地图偏转角
地图初始旋转角度(相对于正北方向顺时针偏转的度数) {number} default 0
minZoom 最小缩放等级
地图最小缩放等级 {number} default 0 Mapbox 0-24) 高德 (2-19)
maxZoom 最大缩放等级
地图最大缩放等级 {number} default 22 Mapbox(0-24) 高德 (2-19)
minPitch 最小倾角
地图最小俯仰角 {number} default 0
maxPitch 最大倾角
地图最大俯仰角 {number} default 60
rotateEnable 是否允许旋转
地图是否可旋转 {Boolean} default true
interactive 是否允许交互
boolean optional default: true
是否允许地图交互(包括鼠标、触摸、键盘等),设为 false 后地图变为静态展示状态
scrollZoom 是否允许滚轮缩放
boolean optional default: true
是否启用滚轮缩放交互
boxZoom 是否允许框选缩放
boolean optional default: true
是否启用框选缩放交互(按住 Shift 拖拽)
dragRotate 是否允许拖拽旋转
boolean optional default: true
是否启用拖拽旋转交互
dragPan 是否允许拖拽平移
boolean optional default: true
是否启用拖拽平移交互
keyboard 是否允许键盘控制
boolean optional default: true
是否启用键盘快捷键控制地图
doubleClickZoom 是否允许双击缩放
boolean optional default: true
是否启用双击缩放交互
touchZoomRotate 是否允许触摸缩放旋转
boolean optional default: true
是否启用双指捏合缩放旋转交互
renderWorldCopies 是否渲染世界副本
boolean optional default: true
超出 -180 和 180 经度范围时,是否在两侧重复渲染地图
maxBounds 地图最大边界范围
限制地图可视范围在指定的地理范围内
bearingSnap 北向吸附阈值
number optional default: 7
当用户旋转地图接近正北方向时,自动吸附到正北方向的角度阈值(度数)
地图事件
Scene 统一代理,见 Scene 文档
或者
scene.map 直接调用 map 实例方法