Leaflet 弹出窗实现：Spring Boot 传递省级旅游口号信息的前端展示逻辑

在地理信息可视化场景中，Leaflet 作为轻量级开源地图库，被广泛用于 Web 端地图交互开发。本文将聚焦于如何通过 Spring Boot 后端传递省级旅游口号数据，并结合 Leaflet 实现地图上的弹出窗展示，完整梳理从数据传递到前端交互的全流程逻辑。

一、需求场景与技术栈选型

场景定义

实现一个省级旅游信息地图：在地图上点击各省区域时，弹出包含该省名称及旅游口号的信息窗（如点击 "云南"，弹出 "七彩云南，旅游天堂"）。

技术栈组合

后端：Spring Boot 2.x（负责数据存储、接口提供）
前端：
- Leaflet 1.9.x（地图渲染与交互）
- jQuery（简化 AJAX 请求，可选）
- 原生 JavaScript（处理地图事件与 DOM 操作）

二、后端数据准备与接口设计

1. 数据模型定义

首先创建省级旅游信息实体类，存储省份编码、名称及旅游口号：

java

运行

复制代码

// ProvinceTourism.java
public class ProvinceTourism {
    private String provinceCode; // 省份编码（如110000代表北京）
    private String provinceName; // 省份名称
    private String tourismSlogan; // 旅游口号

    // 构造函数、getter/setter省略
}

2. 模拟数据与接口实现

为简化开发，使用内存数据模拟数据库查询，通过 REST 接口对外提供数据：

java

运行

复制代码

// TourismController.java
@RestController
@RequestMapping("/api/tourism")
public class TourismController {

    // 模拟省级旅游数据
    private static final List<ProvinceTourism> PROVINCE_DATA = Arrays.asList(
        new ProvinceTourism("110000", "北京", "北京欢迎你"),
        new ProvinceTourism("310000", "上海", "上海，精彩每一天"),
        new ProvinceTourism("530000", "云南", "七彩云南，旅游天堂"),
        new ProvinceTourism("440000", "广东", "活力广东，欢乐祥和")
        // 其他省份数据省略
    );

    // 根据省份编码查询旅游信息
    @GetMapping("/province/{code}")
    public ResponseEntity<ProvinceTourism> getProvinceInfo(@PathVariable String code) {
        return PROVINCE_DATA.stream()
                .filter(p -> p.getProvinceCode().equals(code))
                .findFirst()
                .map(ResponseEntity::ok)
                .orElse(ResponseEntity.notFound().build());
    }

    // 获取所有省份信息（用于前端初始化地图标注）
    @GetMapping("/provinces")
    public List<ProvinceTourism> getAllProvinces() {
        return PROVINCE_DATA;
    }
}

三、前端地图初始化与数据加载

1. 基础环境配置

在前端页面引入 Leaflet 依赖（CSS 与 JS）及地图瓦片资源（此处使用 OpenStreetMap）：

html

预览

复制代码

<!-- 引入Leaflet资源 -->
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.9.4/dist/leaflet.css" />
<script src="https://unpkg.com/leaflet@1.9.4/dist/leaflet.js"></script>

<!-- 地图容器 -->
<div id="map" style="width: 100%; height: 600px;"></div>

2. 地图初始化与省份标注

初始化地图并根据后端数据在各省中心位置添加标记（Marker），为后续弹出窗交互做准备：

javascript

运行

复制代码

// 初始化地图（中心定位至中国，缩放级别5）
const map = L.map('map').setView([35.86166, 104.195397], 5);

// 添加地图瓦片层
L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', {
    attribution: '&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors'
}).addTo(map);

// 存储省份中心坐标（简化示例，实际需更精确的经纬度数据）
const provinceCenters = {
    "110000": [39.9042, 116.4074], // 北京
    "310000": [31.2304, 121.4737], // 上海
    "530000": [25.0389, 102.7183], // 云南
    "440000": [23.1291, 113.2644]  // 广东
};

// 从后端加载所有省份数据并添加标记
fetch('/api/tourism/provinces')
    .then(response => response.json())
    .then(provinces => {
        provinces.forEach(province => {
            const center = provinceCenters[province.provinceCode];
            if (center) {
                // 创建标记并添加到地图
                const marker = L.marker(center).addTo(map);
                // 为标记绑定省份编码（用于后续查询）
                marker.bindTooltip(province.provinceName); // 悬停显示省份名
                marker.provinceCode = province.provinceCode;
            }
        });
    });

四、Leaflet 弹出窗核心实现逻辑

1. 绑定点击事件与弹出窗触发

为地图上的标记绑定点击事件，点击时通过省份编码从后端获取详细信息，并动态生成弹出窗内容：

javascript

运行

复制代码

// 为所有标记添加点击事件监听
map.on('click', function(e) {
    // 检查点击目标是否为标记
    if (e.target instanceof L.Marker) {
        const marker = e.target;
        const provinceCode = marker.provinceCode;
        
        // 从后端获取该省份旅游口号
        fetch(`/api/tourism/province/${provinceCode}`)
            .then(response => response.json())
            .then(province => {
                // 构建弹出窗内容
                const popupContent = `
                    <div style="text-align: center;">
                        <h3>${province.provinceName}</h3>
                        <p style="color: #666; font-style: italic;">"${province.tourismSlogan}"</p>
                    </div>
                `;
                // 显示弹出窗（绑定到标记，自动定位）
                marker.bindPopup(popupContent).openPopup();
            });
    }
});

2. 弹出窗样式与交互优化

Leaflet 弹出窗默认样式可通过 CSS 自定义，例如调整边框、背景色和阴影效果：

css

复制代码

/* 自定义弹出窗样式 */
.leaflet-popup-content-wrapper {
    border-radius: 8px;
    box-shadow: 0 3px 14px rgba(0,0,0,0.2);
    border: none;
}

.leaflet-popup-content {
    margin: 12px 16px;
    min-width: 180px;
}

五、前后端数据交互逻辑梳理

数据流向：
- 前端页面加载时 → 调用 /api/tourism/provinces 获取所有省份基础信息 → 在地图添加对应标记
- 用户点击标记 → 前端提取标记绑定的 provinceCode → 调用 /api/tourism/province/{code} 获取该省详情
- 后端返回包含旅游口号的数据 → 前端动态生成 HTML → 通过 Leaflet 的 bindPopup 方法显示弹出窗
关键技术点：
- 标记与省份编码的绑定：通过为 Marker 对象扩展 provinceCode 属性实现
- 异步数据处理：使用 Fetch API 处理 AJAX 请求，确保弹出窗内容动态加载
- 弹出窗定位：Leaflet 自动将弹出窗定位在标记上方，无需手动计算坐标

六、扩展场景与优化建议

批量数据预加载：若省份数量较多，可在页面初始化时一次性加载所有省份的旅游口号，减少点击时的请求次数，提升交互流畅度。
多边形区域点击：除标记（Marker）外，可结合 GeoJSON 绘制省级行政区多边形，实现 "点击区域弹出信息" 的交互（需引入省级边界 GeoJSON 数据）。
缓存机制 ：对已请求过的省份数据进行本地缓存（如使用 localStorage），避免重复请求。
响应式适配：调整弹出窗内容样式，确保在移动设备上显示正常。

总结

本文通过 Spring Boot 后端提供省级旅游口号数据，结合 Leaflet 实现了地图弹出窗的展示逻辑。核心流程包括：后端接口设计与数据提供、前端地图初始化与标记添加、点击事件触发与弹出窗动态生成。这一方案既利用了 Spring Boot 快速开发后端接口的优势，又发挥了 Leaflet 轻量、灵活的地图交互能力，为地理信息关联数据的展示提供了可复用的实现思路。