非连续道路 GeoJSON 生成连续性问题的 Java 实现与修复

前言

在 GIS 开发与交通数据工程中，将互联网道路、路网采集、矢量地图等来源的道路数据转换为标准 GeoJSON 格式，是实现数据可视化、路径分析、地图渲染、业务系统对接的基础且关键环节。尤其在县域、农村、山区等基层地理场景中，道路数据普遍存在分段采集、分段存储、分段发布的特点，一条完整国道或省道往往被拆分为若干条互不关联的短线段。在直接生成 GeoJSON 时，极易出现道路断裂、拓扑不连续、要素分散、渲染异常等问题，严重影响地图展示效果与后续空间分析能力。

本文以 242 国道新晃段为实际案例，聚焦 Java 环境下道路数据转 GeoJSON 过程中最常见的非连续道路不连贯问题，从问题现象、根源分析、代码实现、效果验证到经验思考，完整呈现一套可直接落地的解决方案。文章重点围绕道路连接线断裂、QGIS 展示异常展开分析，并通过实现 MultiLineString 聚合修复，为从事交通 GIS、路网数据处理、Java 后端地图服务开发的技术人员提供可复用的思路与代码。

一、面向非连续道路的典型问题

在实际项目中，从互联网或第三方获取的道路数据，很少是完整的一条线，大多是分段切割后的零散几何对象。直接转换后会暴露出两类非常典型的问题。以高德地图为例，我们在场景中输入 242 国道后，可以在地图中看到以下效果：

1. 道路连接线问题

原始道路数据在采集或切片时，会把一条完整道路拆成多条独立线段。这些线段在空间上邻近，但在数据结构上彼此独立，没有任何拓扑关系与归属关系。在 Java 转换为 GeoJSON 的过程中，如果仍然按照单 LineString 逐条输出，最终生成的结果就是大量碎片化要素：

• 每条线段都是独立 Feature，互不隶属；
• 同一条道路被拆成几十甚至上百个小对象；
• 无法标识'这些线段属于 242 国道'；
• 前端渲染、长度统计、路径规划都会出现逻辑错误；
• 拓扑关系错误。

这就是典型的道路断链问题，也是基层路网数据最常见的痛点。通过之前的生成代码，我们可以使用文本编辑器打开道路信息，如下图所示：

2. QGIS 展示异常

将未处理的 GeoJSON 导入 QGIS 后，最突出的问题会直观暴露出来：

• 242 国道新晃段在地图上呈现为一段段断开的碎线，视觉上不连续；

这种现象在山区道路、县域道路、低级别路网中尤为突出。

二、解决办法

1. 问题分析

根本原因只有一个：数据是离散的，结构是单段 LineString，逻辑上却属于同一条道路。

GeoJSON 规范中：

• LineString：只能表示一条连续线；
• MultiLineString：可以容纳多条线，逻辑上属于同一个地理要素。

所以，解决方案非常明确：在 Java 中，把同一条道路的所有分段线段，打包成一个 MultiLineString，输出为一个 Feature。

2. 使用 MultiLineString 修复

修复思路分为三步：

1. 封装一个 MultiPolyline 对象，用于接收数据转换，核心代码如下：

// MultiPolyline 类，包含多个路线段
public static class MultiPolyline {
    private List<Polyline> polylines = new ArrayList<>();

    public void addPolyline(Polyline polyline) {
        polylines.add(polyline);
    }

    public List<Polyline> getPolylines() {
        return polylines;
    }

    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder("MultiPolyline[\n");
        for (int i = 0; i < polylines.size(); i++) {
            sb.append(" Segment ").append(i + 1).append(": ")
              .append(polylines.get(i)).append("\n");
        }
        sb.append("]");
        return sb.toString();
    }

    // 输出 WKT 格式
    public String toWKT() {
        StringBuilder sb = new StringBuilder("MULTILINESTRING(");
        for (int i = 0; i < polylines.size(); i++) {
            if (i > 0) sb.append(",");
            sb.append("(");
            Polyline polyline = polylines.get(i);
            for (int j = 0; j < polyline.getPoints().size(); j++) {
                if (j > 0) sb.append(",");
                Point p = polyline.getPoints().get(j);
                sb.append(p.getLon()).append(" ").append(p.getLat());
            }
            sb.append(")");
        }
        sb.append(")");
        return sb.toString();
    }
}

2. 按在线地图的返回数据中包含的分割符进行分割，将坐标点转为 MultiPolyline：

/**
 * 解析高德路线 shape 字符串
 * @param shapeStr 高德路线 shape 字符串
 * @return MultiPolyline 对象
 */
public static MultiPolyline parseAmapShape(String shapeStr) {
    MultiPolyline multiPolyline = new MultiPolyline();
    // 首先按竖线分割不同的路线段
    String[] segments = shapeStr.split("\\|");
    for (String segment : segments) {
        if (segment == null || segment.trim().isEmpty()) {
            continue;
        }
        Polyline polyline = new Polyline();
        // 按分号分割坐标点
        String[] points = segment.split(";");
        for (String pointStr : points) {
            if (pointStr == null || pointStr.trim().isEmpty()) {
                continue;
            }
            // 解析坐标（格式：经度，纬度）
            String[] coords = pointStr.split(",");
            if (coords.length == 2) {
                try {
                    double lon = Double.parseDouble(coords[0].trim());
                    double lat = Double.parseDouble(coords[1].trim());
                    polyline.addPoint(new Point(lon, lat));
                } catch (NumberFormatException e) {
                    System.err.println("解析坐标失败：" + pointStr);
                }
            }
        }
        if (polyline.getPoints().size() > 0) {
            multiPolyline.addPolyline(polyline);
        }
    }
    return multiPolyline;
}

3. 统一属性信息，输出为单个 GeoJSON 要素，核心代码如下：

/**
 * -转换为 GeoJSON 格式
 */
public static String toGeoJSON(MultiPolyline multiPolyline) {
    StringBuilder sb = new StringBuilder();
    sb.append("{\n");
    sb.append(" \"type\": \"MultiLineString\",\n");
    sb.append(" \"coordinates\": [\n");
    for (int i = 0; i < multiPolyline.getPolylines().size(); i++) {
        if (i > 0) sb.append(",\n");
        sb.append(" [");
        Polyline polyline = multiPolyline.getPolylines().get(i);
        for (int j = 0; j < polyline.getPoints().size(); j++) {
            if (j > 0) sb.append(",");
            Point p = polyline.getPoints().get(j);
            sb.append("[").append(p.getLon()).append(", ").append(p.getLat()).append("]");
        }
        sb.append("]");
    }
    sb.append("\n ]\n}");
    return sb.toString();
}

这样处理后，所有分段在逻辑上成为同一条道路，既保留真实几何形状，又解决了不连续问题。最终生成出来的数据示例如下：

三、修复后效果

1. QGIS 展示效果

修复后的 GeoJSON 重新导入 QGIS 后：

• 242 国道新晃段整体显示为一个要素、一条完整道路；
• 可以统一配色、统一线宽、统一高亮，配图效果大幅提升；
• 支持长度统计、属性查询、拓扑检查、空间分析等完整功能；
• 数据结构干净、规范，可直接用于项目交付与系统对接。

通过以上处理，基本能跟在线地图的结果保持一致。

2. 延伸思考

在实际工程落地中，我也有几点思考：

第一，数据预处理远比代码修复更重要。如果源头数据能带上道路 ID、路段号、路线编码，后续聚合会非常简单。反之，如果无标识、无属性，就必须依赖空间距离、方向、走向做智能匹配，难度会大幅上升。

第二，山区、县域道路更要重视拓扑连续性。县域路网弯曲、分叉多、数据质量参差不齐，断链、重复、悬挂点非常普遍。在 Java 转换时，提前做端点距离判断、重复点剔除、短线过滤，能显著提升数据质量。

第三，性能与数据量必须平衡。当处理全省、全国级路网时，一个 MultiLineString 可能包含数万坐标点，会导致解析慢、加载卡顿。建议按区域、按等级分块，控制单个要素大小，兼顾连续性与性能。

四、总结

本文以 242 国道新晃段为实例，解决了 Java 将非连续道路数据转为 GeoJSON 时出现的断裂、不连续问题。核心思路是使用 MultiLineString 统一输出，从结构上修复道路的逻辑连续性。该方案不仅适用于国道、省道，同样可用于高速、县乡道、农村道路等各类分段路网数据的 GeoJSON 标准化处理。在实际 GIS 项目中，数据规范、结构清晰、拓扑合理，才能让后续的地图展示、空间分析、业务功能真正跑得稳、跑得通。