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

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;
}

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

  1. 数据流向:

    • 前端页面加载时 → 调用 /api/tourism/provinces 获取所有省份基础信息 → 在地图添加对应标记
    • 用户点击标记 → 前端提取标记绑定的 provinceCode → 调用 /api/tourism/province/{code} 获取该省详情
    • 后端返回包含旅游口号的数据 → 前端动态生成 HTML → 通过 Leaflet 的 bindPopup 方法显示弹出窗
  2. 关键技术点:

    • 标记与省份编码的绑定:通过为 Marker 对象扩展 provinceCode 属性实现
    • 异步数据处理:使用 Fetch API 处理 AJAX 请求,确保弹出窗内容动态加载
    • 弹出窗定位:Leaflet 自动将弹出窗定位在标记上方,无需手动计算坐标

六、扩展场景与优化建议

  1. 批量数据预加载:若省份数量较多,可在页面初始化时一次性加载所有省份的旅游口号,减少点击时的请求次数,提升交互流畅度。

  2. 多边形区域点击:除标记(Marker)外,可结合 GeoJSON 绘制省级行政区多边形,实现 "点击区域弹出信息" 的交互(需引入省级边界 GeoJSON 数据)。

  3. 缓存机制 :对已请求过的省份数据进行本地缓存(如使用 localStorage),避免重复请求。

  4. 响应式适配:调整弹出窗内容样式,确保在移动设备上显示正常。

总结

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

相关推荐
涛涛ing10 分钟前
面试了20个前端,我发现高薪的都不怎么拼“底层原理”
前端
翼帆1 小时前
我用 AI 复刻了 CodeTank,重温代码坦克
前端·javascript·开源·ai编程·游戏开发·codetank
有趣的老凌1 小时前
学习MarkDown笔记
前端
掘金者阿豪1 小时前
数据库选型到底应该看什么?从业务需求到技术架构的实践分析
前端·后端
她的男孩2 小时前
审批人选了「部门主管」,发起却报 Unknown property:Forge Admin 启动时补齐组织变量
spring boot·低代码·工作流引擎
徐小夕2 小时前
万字拆解:零向量库、无模型微调,SAG2 凭什么刷新多跳问答 SOTA
前端·vue.js·github
黑土豆2 小时前
用 drawink 给业务页面加一层画板:从网页批注到无限板书
前端·javascript·github
wno7043 小时前
springboot整合FastDFS
java·spring boot·后端
恋猫de小郭3 小时前
Flutter 3.50.0 Release 的第一个崩溃,修好了,还没 hotfix
android·前端·flutter
一起_java12 小时前
技术文章-基于Dify-Agent的智能问答系统设计与实现
java·spring boot·后端·agent·dify