为什么做这个
想把「去过哪」记下来。不想要导航软件那一堆花里胡哨的功能和广告, 就想做一个单纯的地图收藏夹 —— 尤其喜欢卫星图,能看清地面的细节,看一眼就能想起当时的事。
市面上的打卡工具,要么把数据锁在平台账号里,要么只能生成一张发完就忘的图片。 所以自己做了一个:数据是一个 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 里只有保护区边界,落点会比实际偏几公里,直接拖动标记就能修正。