地图初始化与视角控制
🎯 引言
学完本文,你能设置地图的初始视角,根据点线面数据自动定位,并为不同交互选择合适的视角切换方法。
🧱 初始化参数决定第一眼看到什么
const map = new mapboxgl.Map({
container: 'map',
style: 'mapbox://styles/mapbox/light-v11',
center: [116.397, 39.909],
zoom: 10,
bearing: 20,
pitch: 45,
})
| 参数 | 表示什么 | 示例值 |
|---|---|---|
container | 承载地图的 DOM 元素或元素 ID | mapContainer.value |
style | 地图样式 URL 或样式对象 | mapbox://styles/mapbox/light-v11 |
center | 地图中心点 | [116.397, 39.909] |
zoom | 缩放级别,值越大看到的范围越小、细节越多 | 10 |
bearing | 顺时针旋转角度,0 表示北方朝上 | 20 |
pitch | 从正上方向斜视的角度,0 表示垂直俯视 | 45 |
Mapbox 坐标数组固定使用 [longitude, latitude],也就是 [经度, 纬度]。顺序写反时,地图可能定位到远离目标的位置,或者因纬度超出范围而报错。
下面的地图使用 bearing: -25 和 pitch: 55,可以直接看到旋转与倾斜共同作用后的视角:
🧭 读取与直接修改视角
const center = map.getCenter()
const zoom = map.getZoom()
const bearing = map.getBearing()
const pitch = map.getPitch()
map.setCenter([121.474, 31.230])
map.setZoom(12)
map.setBearing(0)
map.setPitch(30)
这些 set... 方法立即修改单项视角,适合表单联动或恢复确定状态。读取值时,中心点是 LngLat 对象,可通过 center.lng 和 center.lat 取值。
✨ 三种视角切换方式
map.jumpTo({ center: [121.474, 31.230], zoom: 12 })
map.easeTo({
center: [121.474, 31.230],
zoom: 12,
duration: 800,
})
map.flyTo({
center: [121.474, 31.230],
zoom: 12,
})
| 方法 | 变化方式 | 常见场景 |
|---|---|---|
jumpTo | 立即切换 | 恢复状态、同步筛选结果 |
easeTo | 平滑过渡 | 同一区域内聚焦某个对象 |
flyTo | 带缩放轨迹的飞行动画 | 跨城市、跨区域定位 |
flyTo 的动画时间通常更长,只在需要让用户看清跨区域移动过程时使用;普通定位优先使用 jumpTo 或 easeTo。
下面三个按钮调用同名方法。连续点击并观察地图,可以直接比较立即切换、平滑移动和飞行动画的区别:
📐 根据数据范围定位
接口返回多个位置后,如果仍然使用固定的 center 和 zoom,部分位置可能落在屏幕外。fitBounds 的作用是让地图自动移动和缩放,确保这一组数据完整出现在地图容器中。
例如,搜索结果中包含北京的三个位置。我们不需要手动计算中心点和缩放级别,只要把三个坐标依次加入范围:
const coordinates = [
[116.32, 39.90],
[116.40, 39.92],
[116.48, 39.88],
]
const bounds = new mapboxgl.LngLatBounds()
coordinates.forEach((coordinate) => {
bounds.extend(coordinate)
})
if (!bounds.isEmpty()) {
map.fitBounds(bounds, {
padding: 40,
maxZoom: 15,
duration: 800,
})
}
LngLatBounds 会记录这组坐标的最西、最南、最东和最北位置。fitBounds 再根据地图容器大小计算合适的中心点和缩放级别。
padding: 40:数据与地图四周至少留出 40 像素,避免点贴住边缘。maxZoom: 15:限制自动放大的级别,避免只有一个点或范围很小时贴得太近。duration: 800:用 800 毫秒完成视角过渡。
路线可以把 LineString 的全部坐标加入 bounds,区域可以把 Polygon 的外环坐标加入 bounds。没有数据时,bounds 仍然是空范围,因此要先调用 isEmpty(),再决定是否执行定位。
下面的 A、B、C 是示例中的三个坐标。地图视角由 fitBounds 自动计算,三个点都保留在可视区域内,并与边缘保持间距:
📦 容器变化后调用 resize
侧栏展开、弹窗变宽或标签页从隐藏变为显示时,Canvas 尺寸不会总是自动同步。布局稳定后调用:
map.resize()
可以用 ResizeObserver 观察地图容器,尺寸变化后调用 resize()。Vue 组件中的完整写法会在实战篇讲解。
🧾 小节总结
- 坐标顺序是
[经度, 纬度]。 zoom越大,显示范围越小、地图细节越多。bearing控制旋转,pitch控制倾斜。jumpTo立即切换,easeTo平滑过渡,flyTo适合跨区域定位。fitBounds根据数据范围计算视角,布局变化后使用resize()。
❓ 知识问答
Q1:为什么 fitBounds 后离对象太近?
只有一个点或范围很小时,自动计算的缩放级别可能很大,可设置 maxZoom 限制。
Q2:修改中心点需要重新创建地图吗?
不需要,使用 setCenter 或三种视角切换方法即可。
Q3:pitch 会改变数据坐标吗?
不会。它只改变观察地图的相机角度,不会修改 Source 中的坐标。
🧪 小练习
- 用
easeTo在两个城市之间切换,比较它和jumpTo的视觉差异。 - 为一组点计算
LngLatBounds,并加入padding与maxZoom。
// 请在这里编写代码
🎉 恭喜你已经掌握地图视角控制技能啦!
