如何在JavaFX中显示并实现Open Street Maps（OSM）交互功能？

嘿，这个问题问到点子上了！JavaFX本身并没有内置OpenStreetMap（OSM）的支持，但好在有几个成熟的第三方库能帮我们轻松搞定地图显示，还能实现你想要的点击取坐标、添加多边形这些交互功能。我给你一步步拆解怎么弄：

1. 选对工具：推荐JMapViewerFX库 #

首推JMapViewerFX，这是专门为JavaFX适配的OSM地图库，API设计得很友好，上手快，基础的地图渲染和交互需求都能满足。如果你的项目用Maven管理，直接在pom.xml里加这个依赖就行：

<dependency>
    <groupId>org.openstreetmap.jmapviewer</groupId>
    <artifactId>jmapviewerfx</artifactId>
    <version>2.17</version>
</dependency>

2. 快速实现OSM地图显示 #

先写个最基础的示例，把OSM地图塞进JavaFX窗口里：

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;
import org.openstreetmap.jmapviewerfx.JMapViewerFX;
import org.openstreetmap.jmapviewerfx.tilesources.OsmTileSource;

public class OSMJavaFXDemo extends Application {
    @Override
    public void start(Stage primaryStage) {
        // 初始化地图组件
        JMapViewerFX mapViewer = new JMapViewerFX();
        // 设置使用OSM的Mapnik瓦片源（默认的开源瓦片）
        mapViewer.setTileSource(new OsmTileSource.Mapnik());
        // 设置初始中心点为伦敦，缩放级别10（数字越大越近）
        mapViewer.setDisplayPositionByLatLon(51.5074, -0.1278, 10);

        // 把地图放进布局，显示窗口
        StackPane root = new StackPane(mapViewer);
        Scene scene = new Scene(root, 800, 600);
        primaryStage.setTitle("JavaFX + OSM Demo");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

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

运行这个代码，你就能看到一个可以拖拽、滚轮缩放的OSM地图窗口了！

3. 实现你要的交互功能 #

3.1 获取点击位置的坐标 #

给地图加个鼠标点击监听器，就能把屏幕点击位置转换成经纬度：

import org.openstreetmap.jmapviewerfx.Coordinate;
import org.openstreetmap.jmapviewerfx.MapMarkerDot;

// 在初始化mapViewer后添加这段代码
mapViewer.addMouseClickedListener(event -> {
    // 监听左键单击
    if (event.getButton().equals(javafx.scene.input.MouseButton.PRIMARY)) {
        // 把屏幕坐标转成经纬度
        Coordinate clickPos = mapViewer.getPosition(event.getX(), event.getY());
        System.out.printf("点击位置：纬度 %.6f，经度 %.6f%n", clickPos.getLat(), clickPos.getLon());
        
        // 顺便加个标记点，直观显示点击位置
        MapMarkerDot marker = new MapMarkerDot(clickPos.getLat(), clickPos.getLon());
        marker.setColor(javafx.scene.paint.Color.RED);
        mapViewer.addMapMarker(marker);
    }
});

3.2 添加多边形 #

JMapViewerFX支持直接添加MapPolygon对象，只需定义好多边形的顶点坐标就行：

import org.openstreetmap.jmapviewerfx.MapPolygon;
import javafx.scene.paint.Color;
import java.util.List;

// 定义多边形的几个顶点（这里是伦敦附近的一个小矩形）
List<Coordinate> polygonPoints = List.of(
    new Coordinate(51.5074, -0.1278),
    new Coordinate(51.5084, -0.1278),
    new Coordinate(51.5084, -0.1268),
    new Coordinate(51.5074, -0.1268)
);

// 创建多边形，设置边框和填充色
MapPolygon polygon = new MapPolygon(polygonPoints);
polygon.setColor(Color.BLUE);
polygon.setFillColor(new Color(0, 0, 1, 0.3)); // 半透明蓝色填充

// 添加到地图上
mapViewer.addMapPolygon(polygon);

3.3 其他实用交互 #

其实JMapViewerFX默认已经支持很多基础交互：

• 滚轮滚动：缩放地图
• 拖拽鼠标：移动地图
• 右键菜单：可以自定义添加“定位到当前位置”“清除标记”之类的功能

4. 一些注意事项 #

• 瓦片加载需要网络，所以要确保应用有网络访问权限
• 如果需要离线使用，可以配置JMapViewerFX的瓦片缓存，把常用区域的瓦片存到本地
• 复杂交互可以结合JavaFX的控件，比如加个输入框让用户输入经纬度直接定位，或者用滑块控制缩放级别

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