卫岗校区：数据来源与状态说明
生成日期：2026 年 9 月 15 日 · 数据版本 weigang-v1-draft · 非校方正式导航产品，非测绘成果这是一份可操作的校园三维样板。建筑平面轮廓与名称来自开放地图数据； 建筑高度、立面、运动场划线规格、道路宽度与通行状态均未实测。可用于认识校园布局、核对地点与讨论下一阶段， 暂不作为可靠的到楼门导航。
数据来源
| 项 | 内容 |
|---|---|
| 几何与名称 | OpenStreetMap，经 Overpass API 取得 |
| 许可证 | ODbL 1.0 / © OpenStreetMap contributors（署名见地图页脚） |
| 校区边界要素 | OSM way/590891898，amenity=university，53 个顶点（凹多边形） |
| 边界标签 | 玄武区 · 卫岗 1 号 · 邮编 210095（来自该 OSM 要素，未经校方确认） |
| 坐标系统 | 源数据 WGS84（EPSG:4326）；显示为以校区中心 (118.8377699, 32.0356929) 为原点的局部等距近似米制 XY |
| 边界范围 | 118.832874–118.842666 E，32.031098–32.040287 N；外接矩形 924 × 1023 m |
| 校区面积 | 约 57.0 ha（外接矩形 94.5 ha，因此"在外接矩形内"不等于"在校区内"） |
| 名称来源 | OSM name 标签，未经校方核对；无名称的建筑不编造名称，也不进入搜索列表 |
当前覆盖
| 图层 | 数量 |
|---|---|
| 建筑轮廓 | 107 |
| 其中有名称 | 60（OSM name 标签） |
| 有楼层标签 | 8 |
| 实测高度 | 0（源数据无高度标签） |
| 道路段 | 94（其中 10 条有名称） |
| 可搜索地点 | 111 |
| 校门 | 6（均未取得确认名称，因此不出现在地点列表，定位卡片只能写"未收录校门名称"） |
| 绿地/林地 | 25 片，6.23 ha |
| 水体 | 2（莲池、水榭） |
| 运动场地 | 10（篮球场 7、足球场 1、田径场 1、游泳馆 1） |
| 带示意划线的场地 | 8 |
明确未取得 / 未核实的资料
- 建筑高度：源数据 0 条高度标签，全部
UNKNOWN。三维体块高度是显示示意，不是实测。 - 建筑楼层：仅 8 / 107 栋有层数标签，其余
UNKNOWN。 - 运动场划线：源数据没有标线信息。场上的线、篮架、跑道条数是按轮廓长宽比生成的示意几何，不代表实际涂装；游泳馆不生成泳道。
- 道路宽度与通行状态：宽度为显示值；能否步行、是否禁行未验证。
- 桥梁与地道：跨层语义未建立，二维相交不能当作可通行。
- 单株树木：源数据没有树点，只有绿地/林地面，没有单株树模型。
- 建筑入口门点：未取得。路线终点只能到建筑轮廓附近，不能声称到楼门。
- 食堂等生活设施：开放数据中未取得，未凭空新增。
- 绝对定位精度：没有校方控制点，无法量化误差。平面近似在最远角上约 1.55 m / 1377 m（0.11%），但这不是准确度验收。
路线功能说明
路线沿校园内开放地图道路网络计算（Dijkstra 最短路径），是真实计算而非固定演示线。 但起终点使用"最近道路节点吸附"，没有入口、禁止通行、障碍物与地面层级数据。 路线面板会显示起止路点距所选地点多少米——该数值就是"还不能到门口"的量化说明。
本页面的道路数据包含 5 条 oneway 路段与 5 条受限通行路段；它们目前尚未纳入路线过滤，
因此现有路线结果不构成"合法路线"证明。
定位功能与精度
地图上的「定位」按钮取用浏览器自身的定位能力（navigator.geolocation）。需要说明三件事。
| 项 | 说明 |
|---|---|
| 坐标系 | 设备定位输出 WGS84，与本地米制帧的原点同一基准，直接投影，中间不做任何转换。若先把 WGS84 转成 GCJ-02 再投影，位置会整体偏移 536.5 m。 |
| 高德 / 腾讯坐标 | 粘贴进来的高德坐标默认按 GCJ-02 解析，先反向转回 WGS84 再投影。卡片同时显示两种坐标值，供你拿去高德地图人工核对，但只有 WGS84 会进入渲染。 |
| 精度显示 | 设备给出的精度直接显示为「±N 米」，精度圈半径就是该数值本身，未做任何美化。室外通常 5–20 m，可能落到相邻建筑上；室内基本失效。粘贴或点选的位置没有精度信息，卡片如实写"无精度信息"。 |
| 不做吸附 | 定位点不会被吸附到道路或建筑上，就画在坐标所指的位置。只有"以我为起点算路线"时才对起点做最近路点吸附，并把吸附距离报出来。 |
| 当前环境实测 | 本项目开发机（Edge 153 / Windows）上，设备定位实测取不到结果：首次请求 2.5 秒返回一个约 94 m 精度的旧缓存位置，其后 5 次不同参数组合与 watchPosition 全部超时。enableHighAccuracy:true 时浏览器会无视 25 秒超时，跑满 97 秒才失败——因此代码固定使用 enableHighAccuracy:false。Windows 定位开关为"允许"、lfsvc 服务在运行，失败原因在网络定位后端不可达，不是代码缺陷。手机与微信内置浏览器的可用性尚未实测（UNKNOWN）。 |
| 替代入口 | 设备定位不可用时，可以在卡片里粘贴高德坐标或高德地点链接，或直接在地图上点选。这两种方式在卡片上明确标注为"非定位"。高德短链需要联网解析，纯静态页面做不到，遇到会给明确提示而不是静默失败。 |
| 链接参数 | ?at=经度,纬度 可把位置固定在链接里（默认按 WGS84 解析，加 &atcrs=gcj02 则按 GCJ-02）。用于演示与自动化检查。 |
导览形象「楠小秾」
地图上的导览角色是南京农业大学招生吉祥物楠小秾。它不依赖定位：定位只是它众多出场状态之一，首屏加载、搜索无结果、选中建筑、道路带路、到达终点都会出现。
| 项 | 说明 |
|---|---|
| 素材来源 | 南京农业大学官方网站公开发布页面（njau.edu.cn、zsxx.njau.edu.cn）。共取得 18 个候选文件，逐条记录在 data/weigang/raw/mascot/mascot-artwork.meta.json。 |
| 实际采用 | 1 张：举「诚朴勤仁」校训书的奔跑立绘（njau-C.jpg，550×558，白底、无第三方水印）。其余候选分别是报纸版面扫描件、带媒体水印的图、真人照片，或根本不含吉祥物，逐条否决理由见上述记录文件。 |
| 透明底 | 原件是白底 JPEG，不能直接上地图（会在图上留一块白色方块）。透明底由本项目自行抠制（scripts/tools/mascot-cutout.cs，走边界洪泛填充，以免打穿衣服、书页与鞋的内部白色），属派生资产，不是学校提供的原始文件。 |
| 姿态数量 | 官方只提供 1 个姿态（举校训书奔跑），已作参考与最后兜底。另有 19 个生成姿态（5 个状态 + 14 个场所），按handoff/18_NANXIAONONG_PROMPTS.md 的提示词生成，覆盖全部 15 类建筑。 |
| 生成素材 | 由委托方交付，本项目未调用任何图像服务。交付物是一张 5×4 拼版加一张单独的高清 hello；切图、去底、统一构图由 scripts/tools/mascot-sheet.cs 完成，逐文件哈希与切图参数记在 data/weigang/raw/mascot/generated/generated-artwork.meta.json。生成模型、参数与提示词版本未提供，因此这批图无法复现。 |
| 未按提示词实现的部分 | 「迎宾」实际拿到的是拿麦克风讲话的姿态，「医护」拿到的是抱爱心，「活动」拿到的是彩球，「球类」拿到的是足球（提示词写的是篮球）。逐条差异与处理理由记在上述存档的 departuresFromPrompts 段。 |
| 构图与缩放 | 全部为 256×256、透明底、脚踩画面底边、角色占较长边 88%，因此在地图上可以互换而不需重新缩放。256 是按实际用途定的：立绘最大只画到地标（全校区视图下约 250 px），再大只是浪费手机流量。坐姿与蹲姿因为「较长边」是高度，归一化后会偏大，另乘 STANCE.scale 补正（read/dorm/eat 0.72、garden 0.84、swim 0.88）。 |
| 加载方式 | 立绘按需加载，不是一次性全部下载：首屏只等兜底那一张，四个地标先挂上去，各自的图到了再就地替换；路线带路、点选行走、选中建筑所对应的姿态都是用到才取。这是部署后实测改的——原先要等 5 MB 图片全部下完才建场景，慢网络上页面根本打不开。 |
| 授权状态 | 委托方于 2026-09-19 表示形象使用已经学校领导同意，并指示直接取用官网公开图片。项目侧没有收到书面授权文件。本条仅记录该指示，不构成法律意见；学校若提供正式素材包或书面授权，应替换本目录资产并更新本页。 |
| 比例说明 | 地图内立绘为卡通夸张比例（地标约 45 m 高、带路角色约 21 m），不是实际人体尺寸。全校视图跨度约 1105 m，真实人体尺度不足 1 像素。这是示意地图的通行做法，在此明示。 |
| 互动 | 点导览员换一条使用提示；点地图上的地标立绘直接打开那栋楼；点空白地面导览员会走过去；进入「数据覆盖」时它讲解三级可信度；首次进入有三步新手引导（按校区各记一次，?guide=on 可强制重看）。 |
制作
| 项 | 内容 |
|---|---|
| 团队 | 信息管理学院·师生AI探索小组（团队名称后续可调整） |
| 指导老师 | 沈军威 |
| 学生 | 周铉翔（26 级本科生） |
| 说明 | 本项目为课程/课题原型，非校方正式产品。数据来源、已知缺口与逐条依据均记录在本页与 reports/intake/CHANGELOG.md。 |
获取校方资料后如何升级
本管线按 data/weigang/raw → interim → validated 分层，运行包由
scripts/data/06-build-runtime.mjs 生成。拿到校方现势 CAD/GIS、楼号表或实测数据后，
按同一目录约定替换来源层即可，前端无需改动。每条数据都应记录来源、取得时间、坐标基准、
原始文件哈希与人工修订原因。原始 OSM 响应保存在 data/weigang/raw/，
逐文件带 SHA256 与 osm_base 时间戳。