Django项目中parallel_offset函数失效导致双向道路可视化异常问题排查求助

看起来你遇到的核心问题是：在Jupyter Notebook中正常工作的parallel_offset偏移逻辑，迁移到Django项目后，虽然几何偏移操作已执行，但Folium无法呈现双向道路的双线效果。结合你的代码和场景，我整理了几个最可能的原因和对应的解决办法：

1. 双向道路的偏移逻辑错误（最关键原因） #

你的当前代码中，对于非单向道路（not x['oneway']）仅做了单次左侧偏移，然后直接用偏移后的几何替换了原几何。但双向道路的双线效果需要同时显示两条偏移线（左偏移+右偏移），而不是只保留偏移后的单条线——这就是为什么你看不到双线的核心原因。

修复方案： #

修改偏移部分的代码，为双向道路生成两条独立的几何记录：

# 拆分单向/双向道路
oneway_edges = edges_gdf[edges_gdf['oneway']].copy()
twoway_edges = edges_gdf[~edges_gdf['oneway']].copy()

# 为双向道路分别生成左、右偏移的几何
twoway_edges_left = twoway_edges.copy()
twoway_edges_left['_offset_geometry_'] = twoway_edges_left['geometry'].parallel_offset(distance_offset, 'left')

twoway_edges_right = twoway_edges.copy()
twoway_edges_right['_offset_geometry_'] = twoway_edges_right['geometry'].parallel_offset(distance_offset, 'right')

# 合并所有道路数据：单向道路 + 双向道路的左右偏移线
edges_gdf = pd.concat([oneway_edges, twoway_edges_left, twoway_edges_right], ignore_index=True)

# 替换几何列并转换CRS
edges_gdf.drop('geometry', axis=1, inplace=True)
edges_gdf.set_geometry('_offset_geometry_', inplace=True)
edges_gdf.to_crs(crs=CRS84, inplace=True)

这样双向道路会生成两条独立的偏移线，Folium渲染时就能显示出双线效果了。

2. 双向道路的oneway判断逻辑可能不准确 #

你通过检查是否存在反向边来生成oneway字段，这个逻辑存在潜在漏洞：

• 如果同一路段存在多条重复边（比如不同车道的记录），会误判为双向道路；
• 反向边的属性不一致时，判断结果可能出错。

优化方案： #

如果你的Edge模型本身带有oneway字段，直接在序列化时包含该字段，不要自行生成：

# 修改serialize语句，加入oneway字段
edges = serialize('geojson', edges, fields=('id', 'param1', 'param2', 'param3', 'speed', 'length', 'lanes','geometry', 'name', 'source', 'target','network', 'road_type', 'oneway'))

如果模型中没有oneway字段，可以优化判断逻辑：

# 生成反向边的唯一标识
edges_gdf['reverse_pair'] = edges_gdf.apply(lambda x: f"{min(x['source'], x['target'])}-{max(x['source'], x['target'])}", axis=1)
# 统计每个pair的边数，大于1则为双向道路
pair_counts = edges_gdf['reverse_pair'].value_counts()
edges_gdf['oneway'] = edges_gdf['reverse_pair'].apply(lambda x: pair_counts[x] == 1)

3. 偏移距离过小导致视觉不可见 #

你在EPSG:3857（米单位）下执行偏移，当前设置的distance_offset = 0.8 * 15 = 12米，这个距离在地图缩放级别较低时可能几乎看不到。

验证与调整： #

可以临时调大偏移距离测试效果，比如把distance_offset_percentage改成2.0，确认双线是否显示；如果有效，再根据实际需求调整到合适的数值。

4. 偏移后的几何有效性问题 #

parallel_offset偶尔会生成无效几何（比如自相交、空几何），导致Folium无法正常渲染。

验证与修复： #

在代码中添加几何有效性检查，并尝试修复无效几何：

# 检查无效几何数量
invalid_count = len(edges_gdf[~edges_gdf['_offset_geometry_'].is_valid])
print(f"发现{invalid_count}个无效几何")

# 尝试修复无效几何
edges_gdf['_offset_geometry_'] = edges_gdf['_offset_geometry_'].buffer(0)

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