如何通过Flutter在Firestore文档中添加Geopoint、Timestamp及文档引用

嗨，我之前也碰到过这个问题，其实Flutter的cloud_firestore插件已经为这些特殊类型提供了直接的构造方式，下面给你逐个说明并附上实用示例：

1. Geopoint（地理坐标） #

直接用Geopoint类的构造函数，传入纬度和经度数值即可，注意纬度范围是-90到90，经度是-180到180。

示例代码：

import 'package:cloud_firestore/cloud_firestore.dart';

// 构造旧金山的地理坐标
final sanFrancisco = Geopoint(37.7749, -122.4194);

2. Timestamp（时间戳） #

有几种常用构造方式，满足不同场景需求：

• 获取当前时间：Timestamp.now()
• 从DateTime对象转换：Timestamp.fromDateTime(DateTime.now())
• 从毫秒/微秒时间戳转换：Timestamp.fromMillisecondsSinceEpoch(1620000000000)

示例代码：

// 当前时间戳
final now = Timestamp.now();

// 从指定DateTime转换（比如2024年6月1日10点30分）
final specificDate = Timestamp.fromDateTime(DateTime(2024, 6, 1, 10, 30));

// 从毫秒数转换
final fromMillis = Timestamp.fromMillisecondsSinceEpoch(1717200000000);

3. 文档引用（DocumentReference） #

先获取目标集合的引用，再通过doc()方法传入文档ID，就能构造出对应文档的引用对象。

示例代码：

// 构造指向users集合中ID为"user_456"的文档引用
final userDocRef = FirebaseFirestore.instance.collection('users').doc('user_456');

完整存入示例 #

把这三个类型整合到Map中，存入Firestore集合的完整代码：

import 'package:cloud_firestore/cloud_firestore.dart';

Future<void> saveSpecialData() async {
  // 构造各特殊类型对象
  final location = Geopoint(31.2304, 121.4737); // 上海坐标
  final createTime = Timestamp.now();
  final relatedPostRef = FirebaseFirestore.instance.collection('posts').doc('post_789');

  // 组装数据Map
  final data = {
    'name': '上海外滩',
    'location': location,
    'createTime': createTime,
    'relatedPost': relatedPostRef,
    'rating': 4.8
  };

  // 添加到places集合
  await FirebaseFirestore.instance.collection('places').add(data);
}

读取时的处理 #

存入后读取这些数据，直接将字段转换为对应类型即可：

Future<void> fetchSpecialData() async {
  final docSnapshot = await FirebaseFirestore.instance.collection('places').doc('your_doc_id').get();
  
  if (docSnapshot.exists) {
    final data = docSnapshot.data()!;
    
    // 读取Geopoint
    final Geopoint location = data['location'];
    print('纬度: ${location.latitude}, 经度: ${location.longitude}');
    
    // 读取Timestamp并转为DateTime
    final Timestamp timestamp = data['createTime'];
    final DateTime date = timestamp.toDate();
    print('创建时间: ${date.toString()}');
    
    // 读取文档引用并获取关联文档
    final DocumentReference postRef = data['relatedPost'];
    print('关联帖子ID: ${postRef.id}');
    final postDoc = await postRef.get();
    if (postDoc.exists) {
      print('关联帖子内容: ${postDoc.data()}');
    }
  }
}

内容的提问来源于stack exchange，提问作者Tree