MapLibre GL JS第73课：飞到指定位置

原创已于 2026-07-02 17:47:46 修改 · 260 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

MapLibre GL JS教程

于 2026-07-02 17:47:22 首次发布

📌 学习目标

掌握飞到位置的实现方法
理解相关API的使用
能够独立完成类似功能开发

🎯 核心概念

飞到指定位置。

💻 完整代码

<!DOCTYPE html>
<html lang="en">
<head>
    <title>Fly to a location</title>
    <meta property="og:description" content="使用 flyTo 在位置之间平滑过渡。" />
    <meta property="og:created" content="2006-06-25" />
    <meta charset='utf-8'>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link rel='stylesheet' href='https://unpkg.com/maplibre-gl@5.24.0/dist/maplibre-gl.css' />
    <script src='https://unpkg.com/maplibre-gl@5.24.0/dist/maplibre-gl.js'></script>
    <style>
        body { margin: 0; padding: 0; }
        html, body, #map { height: 100%; }
    </style>
</head>
<body>
<style>
    #fly {
        display: block;
        position: absolute;
        top: 20px;
        left: 50%;
        transform: translate(-50%);
        width: 50%;
        height: 40px;
        padding: 10px;
        border: none;
        border-radius: 3px;
        font-size: 12px;
        text-align: center;
        color: #fff;
        background: #ee8a65;
    }
</style>
<div id="map"></div>
<br />
<button id="fly">Fly</button>
<script>
    const map = new maplibregl.Map({
        container: 'map',
        style: 'https://tiles.openfreemap.org/styles/bright',
        center: [-74.5, 40],
        zoom: 9
    });

    document.getElementById('fly').addEventListener('click', () => {
        // 通过将点-74.50, 40偏移最多5度
        // 飞到随机位置。
        map.flyTo({
            center: [
                -74.5 + (Math.random() - 0.5) * 10,
                40 + (Math.random() - 0.5) * 10
            ],
            essential: true // 此动画相对于prefers-reduced-motion被认为是必要的
        });
    });
</script>
</body>
</html>

🔍 代码解析

1. 创建地图实例

首先使用 maplibregl.Map() 创建一个地图实例，配置地图容器、样式文件、初始中心点和缩放级别。这里使用了开放街图的明亮风格作为底图。

2. 飞行动画核心

通过 map.flyTo() 方法实现地图的平滑飞行效果。这个方法会在两个视点之间创建自然的动画过渡，而不是简单的瞬间跳转。

3. 随机目标点

每次点击按钮时，通过 Math.random() 生成一个随机的经纬度偏移量，让地图飞到以初始位置为中心、周围5度范围内的任意位置。

4. essential 参数

设置 essential: true 表示这个动画对于用户操作是必要的，应该相对于用户的无障碍偏好（prefers-reduced-motion）进行调整。

⚙️ 参数说明

Map 构造函数参数

参数	类型	必填	说明
container	string	是	地图容器的DOM元素ID
style	string	是	地图样式JSON的URL地址
center	[number, number]	否	初始中心点坐标 [经度, 纬度]，默认 [0, 0]
zoom	number	否	初始缩放级别，默认0