如何在Java/JFrame中实现可缩放移动的OpenStreetMap及离线截图功能

为什么之前的尝试失败？ #

JEditorPane仅支持老旧的HTML 3.2规范，完全不支持现代JavaScript和复杂CSS，而OpenStreetMap的嵌入页面依赖JS实现缩放、拖拽等核心交互，因此无法通过该组件实现预期功能。JOSM是专业的地图编辑工具，并非用于嵌入Swing应用的轻量组件；截取HTML网页的方式则无法实现实时交互操作。

推荐方案：使用JMapViewer #

JMapViewer是专门为Java Swing设计的轻量级OpenStreetMap集成组件，原生支持缩放、拖拽操作，且截图功能易于实现。

1. 引入依赖 #

若使用Maven，可直接添加以下坐标：

<dependency>
    <groupId>org.openstreetmap.gui.jmapviewer</groupId>
    <artifactId>jmapviewer</artifactId>
    <version>2.16</version>
</dependency>

非Maven项目可直接下载对应jar包引入工程。

2. 完整实现代码 #

import org.openstreetmap.gui.jmapviewer.JMapViewer;
import org.openstreetmap.gui.jmapviewer.tilesources.OsmTileSource;

import javax.imageio.ImageIO;
import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;

public class OSMMapFrame extends JFrame {
    private final JMapViewer mapViewer;

    public OSMMapFrame() {
        setTitle("OpenStreetMap 集成");
        setSize(Var.ScreenWidth, Var.ScreenHeight);
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        setLocationRelativeTo(null);
        setAlwaysOnTop(true);
        setAutoRequestFocus(true);
        setResizable(false);
        setUndecorated(true);

        // 初始化地图组件
        mapViewer = new JMapViewer();
        // 设置OpenStreetMap官方瓦片源（Mapnik样式）
        mapViewer.setTileSource(new OsmTileSource.Mapnik());
        // 启用鼠标拖拽移动地图
        mapViewer.setDragEnabled(true);
        // 显示缩放控制按钮
        mapViewer.setZoomContolsVisible(true);
        // 设置初始显示坐标与缩放级别（可替换为你需要的区域）
        mapViewer.setDisplayPositionByLatLon(52.005778, 8.414712, 17);

        // 添加截图按钮
        JButton screenshotBtn = new JButton("保存离线截图");
        screenshotBtn.addActionListener(e -> saveMapScreenshot());
        screenshotBtn.setPreferredSize(new Dimension(150, 30));

        // 布局配置
        JPanel panel = new JPanel(new BorderLayout());
        panel.add(mapViewer, BorderLayout.CENTER);
        // 将按钮放在右下角
        JPanel btnPanel = new JPanel(new FlowLayout(FlowLayout.RIGHT));
        btnPanel.add(screenshotBtn);
        panel.add(btnPanel, BorderLayout.SOUTH);
        add(panel);
    }

    // 实现地图截图保存功能
    private void saveMapScreenshot() {
        // 创建与地图组件尺寸一致的缓冲图像
        BufferedImage screenshot = new BufferedImage(mapViewer.getWidth(), mapViewer.getHeight(), BufferedImage.TYPE_INT_RGB);
        // 将地图内容绘制到图像中
        mapViewer.paint(screenshot.getGraphics());

        // 选择保存路径
        JFileChooser fileChooser = new JFileChooser();
        fileChooser.setSelectedFile(new File("map_snapshot.png"));
        int result = fileChooser.showSaveDialog(this);
        if (result == JFileChooser.APPROVE_OPTION) {
            File saveFile = fileChooser.getSelectedFile();
            try {
                // 保存为PNG格式（可改为JPG等其他格式）
                ImageIO.write(screenshot, "png", saveFile);
                JOptionPane.showMessageDialog(this, "截图保存成功");
            } catch (IOException ex) {
                JOptionPane.showMessageDialog(this, "保存失败：" + ex.getMessage());
                ex.printStackTrace();
            }
        }
    }

    public static void create() {
        SwingUtilities.invokeLater(() -> new OSMMapFrame().setVisible(true));
    }

    public static void main(String[] args) {
        create();
    }
}

3. 关键功能说明 #

• 缩放与移动：组件默认支持鼠标滚轮缩放，setDragEnabled(true)开启拖拽移动，setZoomContolsVisible(true)显示可视化缩放按钮，满足交互需求。
• 截图保存：通过创建缓冲图像，调用mapViewer.paint()将当前地图绘制到图像，再用ImageIO.write()保存为本地文件，实现离线图片功能。
• 瓦片源切换：可替换OsmTileSource.Mapnik为其他瓦片源，比如OsmTileSource.CycleMap（骑行地图样式）等。

备选方案：GeoTools（进阶GIS需求） #

如果需要更复杂的GIS功能（比如叠加自定义图层、地理数据处理），可使用GeoTools库。但该库配置较复杂，若仅需基础的地图展示与截图，JMapViewer是更轻量的选择。

内容的提问来源于stack exchange，提问作者Marv