地图初始化与视角控制

掌握中心点、缩放、旋转、倾斜和范围适配,并正确选择视角切换方法。

🎯 引言

学完本文,你能设置地图的初始视角,根据点线面数据自动定位,并为不同交互选择合适的视角切换方法。


🧱 初始化参数决定第一眼看到什么

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 元素或元素 IDmapContainer.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 中的坐标。


🧪 小练习

  1. 用 easeTo 在两个城市之间切换,比较它和 jumpTo 的视觉差异。
  2. 为一组点计算 LngLatBounds,并加入 padding 与 maxZoom。
// 请在这里编写代码

🎉 恭喜你已经掌握地图视角控制技能啦!