Skip to content
CaeruvisPublic

About

A privacy-focused iOS journey tracker that uses the iPhone’s GPS, compass, and motion sensors to record routes, display live travel statistics, and export trips as GPX or JSON

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

Repository files navigation

Altiscope app icon

Altiscope

A local-first journey recorder for iPhone and iPad. Your journey, recorded.

功能

  • 旅程记录 :步行、骑行、驾车、公共交通、飞行;开始、暂停、继续、结束;本地存储,无需账号。
  • 地图 :使用 Apple MapKit,提供探索、驾车、公共交通、卫星四种样式;当前位置持续更新,不等待轨迹的保存周期。探索显示常规兴趣点,驾车显示交通和驾车相关兴趣点,公共交通突出交通站点,卫星使用系统混合影像。
  • 界面 :轨迹、日志和仪表三个页面,统计单位切换位于仪表页底部。
  • 三维轨迹 :按真实记录高度绘制主线和半透明幕帘,零平面固定为 0 m;支持点选高度、与图表共享单位,未知高度/暂停处断开。相机不能可靠对齐时回退二维;系统全览限制倾角时,进入三维自动查看局部航段。
  • 回看 :按海拔着色,海拔与地速共享 UTC 时间轴的双轴图。在仪表页底部切换公制 m / km/h 与航空 ft / kts,选择自动保存并同步到统计曲线及地图点选读数。
  • 日志管理 :名称搜索、每条日志的管理页面修改名称/类型、导出 GPX / JSON、删除确认;笔记界面已移除,旧笔记继续保存在原文件和导出中;GPX / JSON / JSONL 导入预览、重复检测、多个轨迹分别导入。
  • 格式 :本地 .jsonl 与导出 .json 共用逐行 JSON:首行保存类型、名称、笔记及会话信息,其后每行保存一条 UTC 采样,含惯导与 GPS;缺失值显式为 null。保留原始运动、空值和分段,兼容旧根对象 JSON 及旧事件日志。
  • 惯性导航 :新记录默认启用,运动与定位独立采集。采用位置规则 3:惯导优先;新鲜、通过质量过滤且 GPS 报告水平精度 ≤ 7 m 的定位覆盖当前保存状态,同时通过 inertialBeforeGPS 保留覆盖前惯导,并保留独立定位观测及原始运动。此阈值指 GPS 报告精度,不是 GPS 与惯导坐标之间的距离差。超过 7 m 的定位不校正已初始化的惯导。缺少初始条件或真实运动中断时保留缺口,不制造位置。

页面

  • 轨迹页 :进入页面即获取当前位置,预览定位不会创建旅程。面板仅保留“实时数据”和“统计曲线”;打开曲线时,距离、记录时长及标题向上退出,记录控制收起,只保留选项和图表,返回实时数据时恢复。开始记录、返回实时记录使用文字按钮。
  • 日志页 :点击一条路径后加载并查看该记录;每条已结束记录的管理页提供名称 / 类型修改、GPX / 完整 JSON 导出和红色删除按钮,删除前需确认。导出不再放在轨迹页的三点菜单中;笔记编辑和展示入口已移除,旧笔记数据保留。
  • 仪表页 :显示指南针、加速度与定位质量,统计单位切换位于内容底部。

记录文件结构

本地记录和 .json 导出均为 JSONL(逐行 JSON) :每行一个完整对象,首行 recordType: "metadata",随后按记录顺序重复 recordType: "sample"。导出保留 .json 扩展名,内容不再是单个 metadata + samples 根对象;外部工具需逐行解析。旧根对象 JSON 仍可导入,重新导出采用新组织方式,历史采样值不被改写。

首行的 travelMode、name、notes 对应路径类型、名称和笔记,并保留恢复所需的版本、时间、分段、状态和单位。可选派生字段 containsLowConfidence 用于摘要提示;旧文件缺失时保持未知,不为补充摘要而重写历史采样。每条采样的 timestamp 为带毫秒和 Z 的 UTC 字符串;inertial 包含坐标、速度、ENU 速度与加速度、高度及前进角;gps 包含实际可获得的坐标、速度和高度,各指标独立判断,未知为 null。坐标保持 WGS 84,速度 m/s、加速度 m/s²、高度 m、角度 deg。

新采样方向角 优先采用同一连续段中前一条记录的有效惯导水平速度向量;该向量不超过 2 秒 且水平速度至少 0.5 m/s 时才使用。否则使用当前有效手机指南针(有效期 5 秒 ,区分真北/磁北),两者都未知时角度及来源为 null。这些阈值是沿用现有配置的工程默认值,尚未经真机标定。每条落盘前确定角度,导出原样保留;手机姿态与 ENU 加速度变换继续由运动传感器独立处理。

构建

需要 Xcode;应用最低 iOS / iPadOS 17.6,核心包支持 macOS 13 / iOS 17。开发使用 Xcode 26.3。

python3 Scripts/generate_project.py
swift test
xcodebuild -project Altiscope.xcodeproj -scheme Altiscope \
  -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' \
  CODE_SIGNING_ALLOWED=NO build

打开 Altiscope.xcodeproj 运行应用;模拟器构建无需个人签名团队。真机安装时,复制 Config/Secrets.example.xcconfig 为 Config/Secrets.xcconfig 并填写自己的 DEVELOPMENT_TEAM;这个本地文件被 Git 忽略,现有签名设置保留在其中。

LICENSE

MIT License © 2026 Caeruvis

设计参考 Volanta 的地图、日志和统计布局。

坐标转换部分源自 wandergis/coordtransform,© 2015 记忆的残骸,遵循 MIT 许可。版权与授权文本随应用资源打包。

About

A privacy-focused iOS journey tracker that uses the iPhone’s GPS, compass, and motion sensors to record routes, display live travel statistics, and export trips as GPX or JSON

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages