如何在三维地图上看DIY AirTag的永久轨迹？NinjiaTag Web前端完整使用指南（轨迹点/热图/GPX导出）

如何在三维地图上看DIY AirTag的永久轨迹NinjiaTag Web前端完整使用指南轨迹点/热图/GPX导出【免费下载链接】NinjiaTag-backend项目地址: https://gitcode.com/gh_mirrors/ni/NinjiaTag-backendNinjiaTag 是一个开源的 DIY AirTag 项目无需 Mac、也无需一直开着 iPhone自建服务器即可从 FindMy 网络后台永久抓取并保存你 DIY 定位标签的位置数据。本指南带你一步步完成 NinjiaTag Web 前端的全部操作——配置服务器地址、导入物品密钥、在三维地图上查询轨迹点与热图并导出 GPX 轨迹文件把 DIY AirTag 的永久轨迹真正看在手里。30秒速览NinjiaTag 的三维轨迹能做什么和只能看最新位置的方案不同NinjiaTag 的核心卖点是轨迹永久记录✅ 后端定期从 FindMy 网络拉取位置存入本地 SQLite 数据库存储时长不限主流同类产品一般只保留 7 天✅ 基于开源 Mapbox-GL 三维地图引擎支持三维地形显示渲染美观✅ 支持任意时间段、单/多物品查询轨迹点、热图、最新位置三种模式✅ 支持导出 GPXGPS eXchange Format轨迹文件可导入其他地图工具✅ Web 前端内置密钥管理导入 JSON 密钥文件即可绑定物品硬件门槛很低一颗烧录好固件的蓝牙模块nRF5x 或 ST17H66 一枚纽扣电池就能成为兼容 FindMy 网络的 DIY AirTag。成品开箱教程见usr_guide/2032_TAG.md2032 圆形 Tag与usr_guide/Mini_TAG.md迷你版接线刷写模块参考flash_guide/目录下的两份烧录教程。第一步打开 Web 前端并配置服务器地址用浏览器打开 NinjiaTag Web 前端页面NinjiaTagPage基于 Vue3 Mapbox-GL 开发建议收藏或添加到桌面手机、电脑都能访问。点击页面右上角的配置服务器按钮填入你部署的数据查询服务地址格式为http://服务器ip:3000/query注意加上/query后缀保存即可。后端服务由项目根目录的server.mjs提供默认监听 3000 端口通过/query接口从本地 SQLite 数据库reports.db中查询位置数据。 提示如果你把前端页面部署在 HTTPS 域名下由于浏览器安全限制后端服务也必须部署为 HTTPS需要 SSL 证书否则无法访问。第二步添加 DIY AirTag 物品两种方式任选方式一粘贴序列号添加购买成品推荐用微信扫描包装盒上的序列号二维码得到一串序列号点击页面左下角物品管理按钮在粘贴序列号或 JSON 密钥添加输入框中粘贴序列号点击右侧的 号按钮即可添加方式二导入 JSON 密钥文件自建服务器推荐自行烧录固件时先在keygen/目录执行python3 generate_keys.py生成密钥该脚本支持-n参数批量生成多密钥滚动标签滚动密钥能让位置上报更频繁但功耗略增。然后把生成的.json密钥文件通过物品管理 → 解析 JSON 密钥文件上传解析后选择确认使用数据保存密钥即可。添加完成后在物品管理对话框中点击刷新按钮能看到最新更新日期说明已成功从后端获取到位置数据。第三步三维地图查询轨迹——轨迹点、热图、最新位置三种模式点击主页面右下角的数据选择按钮在对话框中选择物品和时间段即可切换三种查询模式轨迹点把历史轨迹以点阵形式渲染在三维地图上鼠标悬停或点击任意轨迹点即可显示该点的经纬度和时间点支持随意缩放回溯任意历史时刻的位置。热图Hotspot类似 GIS 系统的人流密度显示——Tag 经常待的地方颜色更深偶尔去或从不去的地方颜色浅一眼看穿它跑过哪些地方。最新位置以图标形式显示物品当前最新上报的位置。底图引擎为 Mapbox-GL支持三维地形渲染页面左上角可自由切换卫星、浅色、深色、街道、户外及高德地图等底图样式。第四步GPX 导出——把永久轨迹带进专业工具前端支持对单个或多个物品、任意时间段的轨迹导出 GPXGPS eXchange Format文件。操作步骤在数据选择对话框中勾选目标物品设定起止时间范围执行 GPX 导出下载生成的文件。下载的 GPX 文件可以导入 Google Earth、各类运动户外导航软件等第三方工具用更专业的视角回放你的 DIY AirTag 出行轨迹也能方便地与自己的历史行程做对比分析。常见问题为什么看不到位置数据刚添加物品 / 数据为空DIY AirTag 的位置来自 FindMy 网络中路过的苹果设备带上 Tag 到地铁、商场等人流密集处走一圈等待后台抓取入库即可。后台抓取有间隔request_reports.mjs定时任务默认每 5 分钟向 FindMy 服务器请求一次位置并写入数据库cron 间隔可自行修改刚更新的位置请稍等片刻再刷新。刷新太快被限流后端/query接口对每个 IP 做了限流5 分钟内最多 100 次请求短时间内频繁刷新会被临时拒绝。浏览器自动跳转 https直接访问 http 地址时可能被自动重定向把地址栏改回http再回车即可。项目核心文件速查文件作用server.mjsWeb 查询后端服务Express SQLite监听 3000 端口提供/query接口request_reports.mjs定时任务入口默认每 5 分钟触发一次位置抓取request_reports.py核心抓取脚本从 FindMy 网络获取位置数据Pythonkeygen/generate_keys.py批量生成物品密钥支持多密钥滚动标签keys/readme.md服务端密钥.keys 文件放置目录说明usr_guide/2032_TAG.md2032 圆形 Tag 开箱与 Web 端使用教程usr_guide/Mini_TAG.md迷你版 Tag 接线3.3V/5V与使用教程flash_guide/nrf5x.md、flash_guide/ST17H66.mdnRF5x / ST17H66 模块刷机教程⚠️ 免责声明NinjiaTag 仅用于研究与物品防丢场景请遵守当地法律法规严禁将本项目用于非法追踪用途。配置好服务器地址、导入密钥、选一个时间段点一下轨迹点——你的 DIY AirTag 从此不再只有一张最新位置截图而是一条可以在三维地图上无限回看、随时导出 GPX 的永久轨迹。【免费下载链接】NinjiaTag-backend项目地址: https://gitcode.com/gh_mirrors/ni/NinjiaTag-backend创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考