GeoFlutterFire 使用教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00079/article/details/139038575

GeoFlutterFire 使用教程

GeoFlutterFire :fire:GeoFlutterFire:fire: is an open-source library that allows you to store and query firestore documents based on their geographic location. 项目地址: https://gitcode.com/gh_mirrors/ge/GeoFlutterFire

1. 项目介绍

GeoFlutterFire 是一个开源库，允许你在 Firestore 数据库中存储和查询基于地理位置的文档。它通过将地理位置数据存储为字符串键，并提供实时查询功能，使得开发者能够轻松地在地图上显示和查询附近的文档。GeoFlutterFire 的核心优势在于它能够实时更新查询结果，并且只加载附近的数据，从而保持应用程序的轻量和响应速度。

2. 项目快速启动

2.1 添加依赖

首先，在你的 Flutter 项目中添加 GeoFlutterFire 依赖：

dependencies:
  geoflutterfire: <latest-version>

你也可以直接引用 GitHub 仓库：

dependencies:
  geoflutterfire:
    git:
      url: git://github.com/DarshanGowda0/GeoFlutterFire.git

2.2 初始化

在你的项目中初始化 Firestore 和 GeoFlutterFire：

import 'package:geoflutterfire/geoflutterfire.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

// 初始化 Firestore 和 GeoFlutterFire
final geo = Geoflutterfire();
final _firestore = FirebaseFirestore.instance;

2.3 写入地理位置数据

使用 GeoFirePoint 将地理位置数据写入 Firestore 文档：

GeoFirePoint myLocation = geo.point(latitude: 12.960632, longitude: 77.641603);

_firestore.collection('locations').add({
  'name': 'random name',
  'position': myLocation.data
});

2.4 查询地理位置数据

查询距离某个点 50 公里内的文档：

GeoFirePoint center = geo.point(latitude: 12.960632, longitude: 77.641603);

var collectionReference = _firestore.collection('locations');
double radius = 50;
String field = 'position';

Stream<List<DocumentSnapshot>> stream = geo.collection(collectionRef: collectionReference)
    .within(center: center, radius: radius, field: field);

stream.listen((List<DocumentSnapshot> documentList) {
  // 处理查询结果
});