feat(junction): classify complex junction shapes
This commit is contained in:
1 parent
38ea779d9b
commit
a359f88edc
13 files changed
+440
-14
No files matched your search
@@ -0,0 +1,66 @@
|
||||
# 复杂路口形态与参数编辑规划
|
||||
|
||||
## Goal
|
||||
|
||||
让复杂路口渲染适配真实路口形态,而不是把所有候选都按 `2×2` 十字路口处理。用户需要在独立 JunctionTools 页面中看到与实际拓扑一致的道路面、斑马线、停止线、中央区域、角部圆角和人行道转角,覆盖 `2×2`、`2×1`、T 字和必要的非规则三臂/多臂路口。
|
||||
|
||||
## Confirmed Technical Facts
|
||||
|
||||
- `src/compile/complex-junction.js` 当前按方向将进口分组为 `arms`,并生成道路面、斑马线、停止线、角部岛、圆角填充和人行道转角。
|
||||
- 当前实现要求至少 3 个外部进口,但圆角、角部设施和中心区域的几何仍带有四臂/对称路口假设。
|
||||
- `2×1` 的问题不只是车道数少,还涉及是否存在相向车道、中央分隔带和对应的角部设施。
|
||||
- T 字路口只有三个有效外部进口,不应闭合生成不存在的第四个角部或第四组穿行设施。
|
||||
- 复杂路口当前参数编辑尚未开放,JunctionTools 中复杂模式仍是只读。
|
||||
|
||||
## Proposed First Phase
|
||||
|
||||
1. 根据有效进口臂数量、每臂车道/车行道成员、相邻夹角和道路方向,识别十字、偏置十字、T 字、三臂非规则和不支持形态。
|
||||
2. 将几何生成拆成“臂级元素”和“角级元素”:只为真实存在的臂生成进口、停止线和对应斑马线,只为真实相邻角生成角部岛、圆角和人行道转角。
|
||||
3. 对单车道/单向臂关闭不适用的中央分隔逻辑,避免 `2×1` 被套用 `2×2` 的双向中央结构。
|
||||
4. 对无法可靠识别或几何质量不足的形态保留普通路口回退,并给出可理解的诊断。
|
||||
5. 第一阶段复杂路口参数继续只读;待形态识别和渲染稳定后,再开放按形态约束的参数编辑。
|
||||
|
||||
## Domain Model For Follow-Up Design
|
||||
|
||||
复杂路口需要先建立结构模型,再生成几何,避免把几何参数当成形态判断:
|
||||
|
||||
1. **拓扑层**:有效进口臂数量、进口臂之间的夹角、是否为 T 字/十字/偏置十字/非规则三臂。
|
||||
2. **车行结构层**:每条臂的单向/双向状态、每方向车道数、道路宽度、中央分隔或导流结构。
|
||||
3. **交通组织层**:每条进口臂对应的停止线、斑马线、转向车道、导流岛和行人过街关系。
|
||||
4. **几何表现层**:道路面、核心冲突区、角部圆角、人行道转角和车道线;这些元素必须由前面三层推导,而不是固定套用四臂模板。
|
||||
|
||||
JunctionTools 后续应在页面顶部显示可理解的结构摘要,例如“3 臂 T 字 · 2 个方向 × 每方向 1 车道 + 1 条单向支路”,让用户先确认系统对路口的理解,再编辑参数。
|
||||
|
||||
## Terminology Constraint
|
||||
|
||||
“2×2”和“2×1”描述的是组成复杂路口的原始节点布局或合并结构,不是车道数,也不能直接决定最终路口外观。`2×1` 可以形成 T 字,也可以形成十字或偏置十字。
|
||||
|
||||
实现必须将两个概念分开:
|
||||
|
||||
1. **节点布局**:候选 cluster 内的节点数量、相对排布和短连接关系;仅用于候选选择与几何推导。
|
||||
2. **最终路口形态**:由 cluster 边界向外延伸的有效道路臂、方向、夹角和连接关系判定为十字、T 字、偏置十字或非规则形态;这是 UI 文案和生成规则的依据。
|
||||
|
||||
产品不得用“2×1”直接给用户解释为 T 字。应使用“4 臂十字路口”“3 臂 T 字路口”等最终形态文案;必要时才在高级信息中展示节点布局。
|
||||
|
||||
## Out of Scope For First Phase
|
||||
|
||||
- 不同时开放复杂路口的核心半径、进口宽度、圆角等自由拖拽编辑。
|
||||
- 不修改 OSM 拓扑,不自动创建或删除道路、设施或节点。
|
||||
- 不要求一次覆盖所有任意角度和多层立交形态;超出识别范围的路口必须安全回退。
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [ ] `2×2` 路口保持现有视觉质量,且只生成真实存在的臂和角部元素。
|
||||
- [ ] `2×1` 路口不再出现双向四车道专属的多余中央/角部结构。
|
||||
- [ ] T 字路口不生成不存在的第四臂、第四组斑马线或闭合角部设施。
|
||||
- [ ] 至少有一个真实 OSM 样例覆盖每种形态,并有几何/诊断回归测试。
|
||||
- [ ] 不支持或识别不确定的形态回退为普通路口,并给出可理解原因。
|
||||
- [ ] 复杂路口现有选择、刷新保持、普通路口编辑和地图编号功能不回归。
|
||||
|
||||
## Open Product Decision
|
||||
|
||||
无。节点布局与最终形态必须独立判断;下一步设计将以真实 OSM 样例验证这组分类规则。
|
||||
|
||||
## Final Planning Boundary
|
||||
|
||||
本任务第一阶段只解决“理解并正确渲染复杂路口”,不开放自由几何编辑。分类依据必须来自 cluster 外边界的有效道路臂和连接关系;cluster 内部节点布局只用于确定合并范围和中心,不作为形态名称。
|
||||
Reference in new issue
Block a user