← 返回卫岗校区地图

卫岗校区:数据来源与状态说明

生成日期:2026 年 9 月 15 日 · 数据版本 weigang-v1-draft · 非校方正式导航产品,非测绘成果

信息管理学院·师生AI探索小组

这是一份可操作的校园三维样板。建筑平面轮廓与名称来自开放地图数据; 建筑高度、立面、运动场划线规格、道路宽度与通行状态均未实测。可用于认识校园布局、核对地点与讨论下一阶段, 暂不作为可靠的到楼门导航。

数据来源

项内容
几何与名称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

查看数据覆盖平面图 ↗  查看数据清单与哈希 ↗

明确未取得 / 未核实的资料

路线功能说明

路线沿校园内开放地图道路网络计算(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 时间戳。

← 返回卫岗校区地图 查看浦口校区原型(归档)