卫岗校区:数据来源与状态说明
生成日期: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)。用于演示与自动化检查。 |
新生报到动线
地图顶部的「新生报到」模式是一条报到动线:概览态列步骤;点「开始报到」后进入进行态。手机上底部换成一条细导航条(不占抽屉);桌面没有细条、进行态就是左栏面板本身:当前步骤高亮,面板底部出现「下一步」与「退出报到」。两边看的是同一个当前步;按钮上的字也一样,中间步骤写「下一步」,最后一步写「完成」,点「完成」就退出进行态。「距你约 N 米」这一栏只在手机细条上,它依赖定位;桌面面板给的是站与站之间的「至下一站约 N 米」,那个数字按道路网络现算,不依赖定位。进行态里点地图上的楼名只是弹出详情卡,报到流程不被中断,「← 返回报到流程」把它收回去;「先点某一步、再点开始报到」就是从那一步开始走。它是独立于地图数据的一个文件(dist/data/weigang/checkin.json),校方改了流程只需要改这个文件,前端代码不用动。
| 项 | 说明 |
|---|---|
| 内容来源 | 目前没有校方资料。步骤顺序是项目整理的草案,报到点、时间、所需材料完全没有,页面顶部的黄色横幅已明确标注。 |
| 未知的那一步 | 「报到注册」指向的楼栋我们不知道,所以不指定地点——灰色显示并写明原因。挑一栋楼填上去是最省事也最坏的做法:指错楼比不指更糟。 |
| 为什么不写死楼栋 | 新生住哪栋宿舍按院系分配,校区里同时有南苑与北苑;从哪个校门进也因人而异。这些步骤给出候选列表由使用者自己选,选定后按校区记住,刷新不用重选。 |
| 距离怎么来的 | 运行时按道路网络现算,不存在文件里:存下来的距离会过期,也会变成第二个真相来源。手机细条上的「距你约 N 米」要有定位才算得出来,没有定位时那一栏留空,不会显示「距你 0 米」;桌面面板与步骤行的「至下一站约 N 米」不需要定位。 |
| 通行未验证 | 路线沿开放地图(OpenStreetMap)的道路计算,没有现场走过。这句话一直显示在横幅里,不折叠。校门当天是否开放同样未核实。 |
| 防编造 | 任何要展示的说明文字都必须同时写明来源(detailSource),否则校验脚本直接失败。这是这个功能唯一的硬闸。 |
| 校方资料到位后 | 改 checkin.json:把未知步骤填上地点、补上来源、把状态从草案改成正式。不需要改任何前端代码。 |
实拍照片
| 项 | 说明 |
|---|---|
| 来源 | 高德开放平台 Web 服务的 POI 照片(v5/place/detail、v5/place/text 的 show_fields=photos),图片字节来自 store.is.autonavi.com。逐张记录在 data/weigang/validated/amap-photos.json。 |
| 覆盖 | 扫描 363 个候选实体,185 个取得照片,共 339 张(155 个实体本身即高德 POI,30 个为 OSM 几何实体)。没有照片的实体不会显示自己的图,也不用占位图凑数;点开一栋没有自有照片的建筑时改取楼内地点照片,规则见下一行。 |
| 点开一栋楼看到谁的照片 | 100 栋可点建筑里只有 12 栋自己有高德照片,所以照片分三档取,每档措辞不同,不把楼内地点的照片说成这栋楼的照片: ① 建筑自己的照片:标注「实拍照片:高德地图」。若该实体是按名称匹配来的,后面跟着「(名称与位置匹配,可能非该楼本体)」。 ② 高德自己声明在这栋楼里的 POI(字段 parentBuildingId;OSM 服务用 parentId):句首写明「该建筑暂无自有实拍,以下为楼内地点的高德实拍(非该建筑本体外观照)」,并且每张图单独标注它属于楼内哪个地点(例如「星巴克(南农店)」),灯箱署名里也带着这个地点名。③ 本项目按建筑轮廓推断:前两档都没有、且该建筑有轮廓时,用 pointInShape 找出中心点落在轮廓内的有照片地点,措辞是「以下为楼内及紧邻地点的高德实拍(按建筑轮廓匹配,非该建筑本体外观照)」。这一档是几何推断,不是高德的声明,所以不能和第②档用同一句话。 |
| 一屏最多几张 | 三档合计最多 6 张,建筑自己的照片优先占位;被截掉的写「另有 N 张未显示」。三档都没有的建筑明确写「该建筑暂无实拍照片」,不留空白,也不拿别的楼的照片顶替。 |
| 匹配方式 | 分两类,证据强度不同,卡片上分别标注: ① 实体本身就是高德 POI(编号前缀 amap-),按 POI 编号精确取图,无任何推断;② 实体来自 OpenStreetMap( wgb-/wgp-/wge-),以实体质心为圆心 250 m 做关键词周边检索,并要求名称互为包含关系。第二类在卡片上明确标注「名称与位置匹配,可能非该楼本体」。 |
| 为什么不用全城检索 | 实测过并已放弃:全南京检索「图书馆」,前十条是南京图书馆、金陵图书馆、建邺区图书馆……校区图书馆完全不在结果里。通用名称必须用半径检索,距离才会参与排序。 |
| 版权状态 | 不是开放许可素材。这些是高德用户上传的照片,版权属于上传者/高德。每张照片在界面上标注「图片来源:高德地图」,索引里逐张保留高德 POI 编号与原始链接。若要正式公开或商用,应先取得校方或高德授权,或改用学校提供的实拍图。 |
| 其他可替换途径 | ① 校方宣传部与各学院官网的官方实拍图,授权最清晰,建议优先;② 百度地图/腾讯地图街景 API,需另申请 key,且只覆盖道路沿线;③ 现场自行拍摄,版权最干净。本项目当前采用的是覆盖最广、但授权最弱的一档。 |
| 下架方式 | 删除 data/weigang/validated/amap-photos.json 中的对应条目,重跑 scripts/data/33-build-photo-index.mjs 与 scripts/tools/photo-resize.cs,并清掉 dist/assets/photos 下失去引用的文件即可。前端代码无需改动。 |
| 处理过程 | 原图重新编码为宽 ≤ 900 px 的 JPEG(详情/灯箱)与 200 px 缩略图(列表行)。编码前应用 EXIF 方向,并丢弃原图的 EXIF 块——用户上传的手机照片常带 GPS 与设备信息。列表行只取缩略图。 |
| 体积 | 详情图约 33 MB、缩略图约 3 MB,全部为本站静态资源,不产生任何第三方请求。 |
导览形象「楠小秾」
地图上的导览角色是南京农业大学招生吉祥物楠小秾。它不依赖定位:定位只是它众多出场状态之一,首屏加载、搜索无结果、选中建筑、道路带路、到达终点都会出现。
| 项 | 说明 |
|---|---|
| 素材来源 | 南京农业大学官方网站公开发布页面(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 时间戳。