Immich-Go项目中的Google Takeout GPS数据解析问题解析

在照片管理领域，Google Photos作为主流云相册服务，其数据导出功能(Takeout)被广泛使用。Immich-Go作为Immich生态系统的数据导入工具，近期在处理Google Takeout数据时暴露了一个值得注意的GPS元数据解析问题。

问题背景

当用户通过Google Photos手动添加地理位置信息时，系统会将GPS坐标存储在JSON补充元数据文件的geoData字段中。而相机设备直接拍摄的照片，GPS信息则会同时存在于geoDataExif和geoData两个字段。Immich-Go最初版本仅识别geoDataExif字段，导致大量用户手动添加的地理位置信息在导入过程中丢失。

技术分析

通过对比两种不同来源的照片元数据文件，可以清晰地看到差异：

1. 相机拍摄的照片：

   • 同时包含geoDataExif和geoData字段
   • 两个字段内容基本一致
   • 数据结构符合EXIF标准

2. 通过Google Photos添加位置的照片：

   • 仅包含geoData字段
   • 数据结构与EXIF标准略有不同
   • 缺少部分精度参数

这种差异源于Google Photos内部处理逻辑：当照片包含原生EXIF GPS数据时，系统会保留原始信息并复制一份到通用字段；而用户手动添加的位置则仅存储在通用字段中。

解决方案

Immich-Go团队已经针对此问题发布了修复方案，主要改进包括：

1. 优先读取geoData字段作为位置信息来源
2. 保留对geoDataExif的兼容性支持
3. 统一两种数据源的处理逻辑

这种改进确保了无论地理位置信息来自相机设备还是Google Photos手动添加，都能被正确识别和导入。

最佳实践建议

对于需要从Google Photos迁移到Immich的用户，建议：

1. 在迁移前检查Takeout数据中的JSON文件，确认geoData字段存在且完整
2. 使用最新版本的Immich-Go工具进行导入
3. 导入完成后抽样检查照片的地理位置信息是否完整
4. 对于重要照片，考虑在迁移前在Google Photos中导出包含位置信息的版本

该问题的解决不仅提升了Immich-Go的工具可靠性，也为其他类似项目处理Google Takeout数据提供了有价值的参考。元数据兼容性问题在数据迁移场景中十分常见，这个案例展示了如何通过分析数据源差异来制定稳健的解决方案。