地点选择与只读关系探索

状态：通用设计契约候选；未实现，未运行验收，第 9 节夹具全部未执行。覆盖 FAM-052 的已有地点阅读／显式单选、可选地图呈现，以及 FAM-054 的已有关系探索；不是 GIS、地图供应商集成或关系编辑器。 更新：2026-10-20（UTC） 所属章节：数据表达与分析

1. SAP 参考与 YUDS 取舍

SAP Map 区分区域数值表达的分析地图与展示地理对象的地理地图；本页只吸收“地理事实与呈现方式分开”的任务区分，不承诺区域分析或地图服务。SAP Map ↗。SAP Network Graph 用节点和连线呈现复杂非线性关系，并把文档流程交给 Process Flow；YUDS 同样不把任意关系图解释为已批准的业务流程。SAP Network Graph ↗。下列 LOC／REL 是 YUDS 自行制定的协议与限制，不是 SAP API 或 SAP 可访问性认证。

来源核对情况（2026-10-20）：Map 只读到官方 maps 页面的搜索索引正文摘录，结果标为约 2022 年发布，没有可确定的指南版本，仅据此核对分析地图／地理地图的区别；Network Graph 也只读到官方页的搜索索引正文摘录，摘录显示 Updated June 8, 2022 与 Latest Version 1.128，这里的 Latest 是索引页面自述，不是对当前最新版的核验；旧的单数 map 地址直接读取失败，两篇完整页面均未取得。本页不据索引摘录断言当前 SAP 功能、实现行为或可访问性已完整核对。

• 适用：从已提供且获准的地点集合选一个地点；核对一个对象与哪些对象存在什么关系。
• 不适用：仅需输入普通地址却强制开地图；只需读数却用地理面积暗示重要性；用布局距离断言业务相似；用关系图代替线性审批。
• 相邻规则：时间依赖沿 日历、日程提案与只读依赖时间线，流程沿 流程推进与协作责任，普通选择沿 选择组件：值、范围与层级。

2. LOC-01：地点对象与精度契约

消费者提供实例与主体／空间、授权代次、稳定地点 ID、来源版本、可见名称、用于区分同名地点的获准上下文（例如城市／场所编号）、值状态、范围／完整性、读取时间及可选择性。地点身份和显示地址不是同一字段；同名不同 ID 不自动合并，改名不改变 ID。无地理坐标的合法地点仍可在列表中选择。

地图是可选消费层。绘制前另需坐标参考系、坐标顺序／单位、有效值、来源、更新时间、精度／不确定度（已知时）与允许披露的精细度。本页的地图适配仅接受已明确声明的 WGS84 经度／纬度（度）点数据：经度 [-180,180]、纬度 [-90,90]，不得用数组位置猜顺序。其他参考系未经明确的转换能力与来源说明不得绘制；保留地点列表并说明不可绘图。未提供坐标 ≠ (0,0)；有效的 (0,0) 不得自动当作缺失。

存储精度、显示小数位、来源准确度与授权精度分别说明。多写小数不提高测量准确度；城市中心不是设备当前位置。位置只到城市时，名称和图例写“城市级示意”，不画成精确门牌定位；未知准确度直接标未知，不凭空生成误差圆。显示／复制只使用授权允许的精度，禁止先加载精确点、再靠前端四舍五入伪装保密。

3. LOC-02：结构、显式单选与事件

3.1 结构与两种模式

读取模式包含标题、当前范围／完整性、地点列表、详情、可选地图和返回；选择模式另有调用方当前值、临时候选、明确的“使用此地点”与取消。每个候选展示足以区分身份的信息；若同名仍无法区别，就不能仅凭名称接受。地图点可打开候选详情，但点选不自动提交字段；地图平移／缩放与候选选择相互独立。

非地图基本路径是同一获准集合的可检索列表＋地点详情＋单选接受。仅提供静态集合时，搜索明确是本地已提供范围，不能称全城／全球搜索。地图点、聚合标记和列表共享身份与数据修订，不能一边隐藏受限点，一边在列表或计数中泄露。

3.2 状态与接受门

区分调用方值 C 及其修订、临时候选 D、数据快照 R、应用范围 Q、地图视口 V、授权代次与异步请求身份。打开时记录 C 的修订，D 不默认变成最近地点／中心点。事件名称仅表示观察语义，不规定框架 API。

调用方的 C 被其他操作改写时，旧选择层的接受应被阻止并解释原值已变化，不覆盖新值。等待核验时改 D、关闭或权限变化，旧核验不得接受、关层或抢焦。来源更新使候选失效时明确要求重选／重新核对，不静默替换成同名地点。已有选择被过滤隐藏时显示“候选不在当前结果”；本有界模式必须重新进入当前有效集合核对后再接受，不能让隐藏候选悄悄通过。

纯本地校验足以保证本地协议一致，不保证地点营业、服务可达、库存或配送能力。需要这些业务事实的产品须另行提供真实验证和说明；没有时只交付地点选择值，不能用“可用”笼统盖过未知。

3.3 地图与数据失败分开

底图加载失败、点层失败、列表数据失败、部分覆盖、无匹配地点和无权限分别呈现。底图失败但已获准列表可用时，列表继续完成同一选择，不强迫用户刷新整页。读取失败可保留仍获准的旧列表并标明时间／范围；能否接受旧版本由消费者能力明示，未声明时阻止接受旧结果。

请求绑定实例、主体、Q 修订、数据来源、授权代次和序号；旧成功、旧错误均不覆盖新范围。地图第三方返回的内容不作为授权源。地图视口改变默认不触发外部查询或上传地点；只有另行批准并明确配置的服务适配才能做对应读取，且须说明范围和资料传输。

4. LOC-03：定位、提供商与权限边界

本次基本契约不请求设备定位、不自动调用地址解析、不导航、不加载未批准的外部底图。调用方提供的数据可在本地列表中完成任务；地图能力不存在时直接用列表，不显示虚假的地图成功态。

未来增加“使用当前位置”必须作为独立能力：用户明确触发、平台权限状态、此次用途与接收方、传输的数据／精度、超时／拒绝／撤回、缓存寿命及手动替代均已定义，才允许请求。系统授予定位不等于获准发给任意地图商；已有权限也不等于本次打开选择器就要采集。拒绝后保留手动列表，不循环弹权限，不用 IP 或其他渠道绕过。即使得到当前位置，也只是临时候选，不自动接受／保存。

地图瓦片、SDK、地理编码和外部导航可能向提供商披露视口、查询文字或坐标；接入前记录实际服务、许可证／署名、数据去向、隐私／权限及失败行为。本稿没有选择任何服务商、密钥或计费方案，也不批准数据传输。坐标、地址或精准范围不得默认写入日志、遥测、URL 或复制内容。权限撤回时同步清除受限详情、点、聚合计数、候选、可反推的范围及新输出路径；不承诺追回已有的合法外部副本。

5. LOC-04：输入、视觉与平台

列表项和地点详情可被键盘／读屏访问；使用、取消、搜索、清除筛选有具名控件。Web 采用普通列表／表＋独立选择控件，不把整张地图设成无说明的应用角色。焦点不因底图晚到、地图重绘或地理排序改变而移动；候选失效时清理无效候选，并在当前任务中说明原因；仅当当前焦点目标也失效／将被移除时，才按 LP-G05（见 浮层组件：对话框、抽屉与提示）修复到结果标题或有效控制。当前焦点在另一合法控件时保留原处，候选清理不触发移焦。

触控不以长按放点、拖动地图或双指缩放作为唯一任务路径；放大／缩小按钮及列表替代分别可用。所有标记的必要详情可点开，不只靠悬浮。窄屏优先列表和详情，地图作为可切换的辅助呈现；切换保留 D／Q，字体放大后仍可读出身份与精度。原生端使用系统辅助语义与返回模型，按 平台适配、国际化与输入能力 分端验证，不把 Web 地图 SDK 可渲染视为四端支持。

默认 primary 墨色、neutral 中性灰，沿现有七个 role × 固定 step 和 27 档文字尺度；候选、已接受值、键盘焦点、数据状态分开呈现，标记形状与文字补充颜色。地图供应商自带的颜色不扩展 YUDS role；底图太杂时给标签稳定表面并测实际对比，不能套用纯色静态证据。

6. REL-01：只读关系模型与解剖

用途是理解“哪些实体以何种已知关系相连”，不提供连线编辑、合并实体、推断隐含关系或业务执行。消费者提供图实例、主体／空间、来源／快照、覆盖范围、节点集合、边集合、授权代次与可读详情。节点有稳定 ID、类型、名称、状态；边有独立的稳定 ID、起点／终点、方向（有向／无向）、关系类型、来源依据及必要的有效期间。节点名、渲染位置、边的数组下标都不是身份。

解剖为任务标题／范围、过滤／定位入口、关系视图、图例、当前节点或边的详情、关系等效表、加载／完整性说明和返回。等效表至少提供边身份、起点、关系类型、方向、终点及获准依据，另有节点清单容纳孤立节点。只列节点不列边不能称等效；把图截图或静态导出作为读屏替代也不合格。

未知类型显示来源原文或“类型未知”，不把未知关系升级为因果。几何距离、层级、线长和交叉只是布局，不代表时间、强度或重要性；产品若提供度量／层级，必须独立标注定义，不能从布局反推。双向关系须明确是无向边、一条双向业务关系还是两条有向边；消费者未声明时停在“方向未知”，不画确定箭头。自环和相同端点的多条边保留各自身份；循环不默认当作错误或完整闭环。

7. REL-02：探索状态、事件与等效表

分离根／范围 Q、实际快照 R、展开集合 X、选择 S、焦点 F、展示位置 V。根变化改 Q，不把原节点当新根；折叠只改 X，不删除事实。选择一次只针对一个节点或一条边，事件携带身份／来源版本；高亮关联项只是阅读提示，不等于批量选择或新增关系。

每次读取绑定实例／主体、根、Q 修订、展开目标及展开代次、授权代次、请求序号。展开后立即折叠时，迟到的成功不得再展开或抢焦；迟到的失败不覆盖新展开的错误。消费者没有远程邻接接口时只能探索所给集合；界面写“当前提供范围”，不提供假的“加载全网”。只提供了部分邻居时不制造完整度假象，总数未知时不显示 100%。

路径阅读如提供，只能沿已存在、可访问的边逐步浏览，保留浏览栈、节点／边身份和返回。它不是自动寻找最短路径；“没有找到”只能指当前范围。布局刷新保留 S 及有效的 F，不按坐标重选；所选对象不再可读时清理选择、详情与派生高亮并说明；只有当前焦点目标同时失效／将被移除时，才按 LP-G05 修复焦点，其他合法焦点保持原处。折叠含聚焦对象的子集前，将焦点移到有效的折叠控制；用户已离开该子集时不抢焦。

8. REL-03：错误、权限与可访问性

缺失端点须区分范围外、未加载、数据损坏和受限；是否允许披露占位由产品权限策略决定。不得通过“隐藏 3 个节点”、边长度、度数、搜索建议或缓存详情泄露不允许披露的存在。读权撤回时同时清理节点、相关边、派生计数／高亮、历史面包屑中的敏感名称及新的复制／导出路径；重新取得授权前不以旧图继续推导关系。

布局失败不代表业务关系不存在，仍可用等效表读取／选择；数据失败和图渲染失败分别显示。部分边数据损坏时，明确哪些已提供的记录不能绘图，授权允许时在表中保留错误行；不静默丢弃后显示为完整。刷新失败可显示获准的旧快照并标为旧，不能把新根的标题套在旧图上。

基本路径为可筛选节点清单 → 节点详情 → 相邻关系表 → 边详情 → 另一端节点，键盘 Tab 与具名按钮即可完成；无需二维箭头空间导航。图若另做复合导航，须独立定义稳定顺序、进出、当前节点和关系选择的可访问语义；不能仅用 SVG 图形名代替任务。触控用户可在列表中选择细线对应的关系，读屏能读出“起点 A，关系类型 T，指向终点 B”，无向关系不宣读成单向。

同一过滤、来源、快照与权限在图和表之间保持一致；表可以用不同排序，但不丢孤立节点、自环、多边与质量状态。手机采用节点／关系列表和逐项详情，提供返回栈，不强制横向拖动大图。四端的文字放大、读屏、键盘／替代输入、旋转和后台恢复均需实际验证。

9. 精确验证夹具（全部运行未执行）

10. 明确未支持与交付条件

地图不包含：自由落点／拖点编辑、地址地理编码、当前位置采集、路径规划／导航、测距测面积、围栏、区域绘制、热力／分区统计、离线地图、第三方底图与计费集成。关系不包含：新增／删除节点和边、拖线连接、关系推断、因果分析、最短路径、全图算法、自动实体合并、实时协作和业务写入。任何扩展都先独立声明输入、权限、算法责任、异步／失败与可访问路径，不能把按钮解禁当成已经补齐契约。

消费实例须绑定实际提供的数据／服务、权限披露策略、规模、平台／构建／辅助技术、日志事件和夹具结果。当前只有设计候选与文档走查，没有实现、地理精度认证、运行可访问性或全面 SAP 对齐的结论。涉及未声明的坐标系、方向、披露策略或远端写入语义的实例保持阻塞／草案状态，不以通用族已经写出来替代这些决策。

相关页面：来源规则见 来源、快照与依据追溯；权限规则见 权限变化、并发修改与保存冲突。