首页 / 软件项目 / 御坂足迹地图
Software · 2026 · 纯静态

御坂足迹地图 footprint-map

把这二十多年去过的地方,收进一张自己能控制的地图里。 双击 HTML 就能用,零构建、零 npm、零框架。 数据全在浏览器本地;真加密只在云端模式里。

开源 · MIT 已上线 地图可视化 纯静态 坐标对齐

想动手试,点「示例地图」 —— 那是示例数据,加点、改点、拖位置随便折腾。改动只落在你自己浏览器的本地存储里:关掉页面下次打开还在,换台设备就看不到,也影响不到我。它跑在静态托管上,背后没有任何后端 —— 不存数据、不认账号。「我的真实足迹」那版是只读的 —— 点位是我这些年实际去过的地方,能拖能缩放,但改不了。

纯静态:index.html 双击就能用,零构建、零 npm、零框架;Leaflet 144KB 与 marked 35KB 全部内联在 vendor/,不请求任何 CDN。

界面实拍

截图取自真实运行界面
30.7749, 103.5077 点位模式 · Esri 卫星 · 本机
1点位与路书
这是本机模式下的样子:双击地图落一个点,每个点能写 Markdown —— 路书、票价、住宿、外链图片。编辑与删除只在本机与静态托管下可用,线上那版是我的真实数据,只读。
  • 工具栏本机 / 底图切换 / 路线 / 展开 / 关闭 / 分组 / 搜索 / 导出 / 导入 / 重置 / 私密
  • 这个点位标题 + 分类「好玩的」+ Markdown 正文 + 编辑 / 删除
  • 状态栏光标坐标与当前缩放级别,随鼠标实时变化
查看原图 →
2路线与筛选
这是云端模式下的样子:路线把「已去过」的路程点按时间连成一条虚线;工具栏右上多了「已解锁」,写入口只在这种登录态下出现。右侧面板同时按分类和时间区间筛,两个条件是「且」的关系。
  • 绘制方式红色虚线,按时间顺序连接路程类点位
  • 筛选面板八个分类各自计数 + 时间区间(全部 / 近 1 年 / 近 3 年 / 自定义)
  • 权限状态右上「已解锁」—— 这一版是云端模式的登录态
查看原图 →
30.4460, 104.3039 路线模式 · 天地图卫星 · 云端已解锁

为什么做这个

想把「去过哪」记下来。不想要导航软件那一堆花里胡哨的功能和广告, 就想做一个单纯的地图收藏夹 —— 尤其喜欢卫星图,能看清地面的细节,看一眼就能想起当时的事。

市面上的打卡工具,要么把数据锁在平台账号里,要么只能生成一张发完就忘的图片。 所以自己做了一个:数据是一个 JSON 文件,页面是一个静态站点,服务器上不存任何东西。

三种用法,同一份代码

同一份代码支持三种用法,打开页面右下角 ⚙️ 设置就能切换。

一、双击打开

下载整个文件夹,双击 index.html。没有服务器、没有构建、没有 npm install, file:// 下也照常工作。数据写进浏览器本地存储,刷新不丢,关掉再开还在。

二、扔到任意静态托管

上传到 GitHub Pages、对象存储或自己的 Nginx 就能用。不需要 Node、不需要数据库、不需要后端。 访客看到的是示例数据,他自己加的点只存在他自己浏览器里。

三、接自己的云端

想让手机和电脑看到同一份数据,就在设置里填一个 API 地址。接口契约很小: 两个端点(列出 / 增量提交),ops 是增量变更日志不是整份覆盖, rev 是乐观锁版本号,两边同时改会返回 409 REV_MISMATCH。

关于「私密点位」它到底保护什么,这里说清楚:本机与静态托管模式下,私密点位只是界面隐藏,数据在浏览器里是明文 —— 它只防别人拿你电脑随便点,不防技术手段;只有云端模式才是真加密,每条点位单独 AES-256-GCM, 密钥由口令经 PBKDF2-SHA256 迭代 60 万次派生。云端模式还有三条硬边界:未登录时服务端不下发密文; 静态文件里没有任何密文;密钥只存在内存和 sessionStorage,关掉标签页就失效。

为什么本机模式不做加密:file:// 下的浏览器不提供 WebCrypto(不是安全上下文),做不了真正的密码学操作。 与其搞一个看着像加密、实际上只是混淆的东西,不如直说。

看完上面两张图,想自己动一下:去 GitHub 把整个文件夹下下来,双击 index.html 就完事了 —— 不用装 Node、不用跑 npm、也不用注册账号。改坏了,工具栏里有「重置」;想先摸摸手感,页面顶上那个「示例地图」入口是同一份代码。

底图与坐标

六种底图:高德标准、高德卫星、天地图卫星、Esri 卫星、OSM、Carto 浅色。 数据以 GCJ-02 存储,切到 WGS-84 底图时自动反算,点位不会飘几百米 —— 这是国内地图应用最容易翻车的地方。天地图需要自己申请 key,填进设置里即可,源码里不内置任何私有 key。

点位与路书

六个分类:路程、好吃的、好喝的、好玩的、风景、兴趣点。每个点位能写 Markdown。 想去的地方先标「未去过」,去过了改成「已去过」并填时间,轨迹会自动连线。

两条筛选是「且」

分类筛选和时间区间筛选(全部 / 近 1 年 / 近 3 年 / 自定义)是两个条件同时生效。 名称搜索回车即跳转,只匹配点位名称,不做地名解析。

已知边界

  • 底图瓦片来自第三方服务(高德 / 天地图 / Esri / OSM / Carto)。自己用没问题,做成对公众开放的服务前要先确认各家条款与署名要求。天地图必须填自己的 key。
  • 单机容量受浏览器限制,localStorage 一般 5MB 左右,纯文字点位能存几千条。图片请用外链图床,不要塞 base64。
  • 本机模式不跨设备,换电脑要手动导出导入。
  • 搜索只匹配点位名称,不做地名解析 —— 那需要接地理编码 API,会引入依赖和配额问题。
  • 示例数据的坐标来自公开景点信息,个别景区在 OSM 里只有保护区边界,落点会比实际偏几公里,直接拖动标记就能修正。