Flutter地理范围或区域选择插件georange的使用

简介

georange 是一个用于编码和解码 geohashes、计算两点之间的距离以及生成 geohashes 范围的 Flutter 插件。它主要用于帮助查询数据库（目前仅测试了 Firestore）。

特性

• 编码和解码 geohashes
• 计算两点之间的距离
• 生成经纬度范围的 geohashes
• 受 GeoFlutterFire 影响

许可证

• MIT License

版本

• 最新版本可以在 Pub 上查看

开始使用

添加依赖

在你的 pubspec.yaml 文件中添加 georange 依赖：

dependencies:
  georange: ^<latest-version>

然后运行以下命令来获取依赖包：

flutter packages get

初始化

在 Dart 文件中导入 georange 并初始化：

import 'package:georange/georange.dart';

GeoRange georange = GeoRange();

示例

编码经纬度

将经纬度编码为 geohash：

var encoded = georange.encode(-1.2862368, 36.8195783);
print(encoded); // 输出: kzf0tvg5n

解码 geohash

将 geohash 解码为经纬度：

Point decoded = georange.decode("kzf0tvg5n");
print(decoded.latitude); // 输出: -1.2862372398376465
print(decoded.longitude); // 输出: 36.819584369659424

生成范围

生成指定距离内的 geohash 范围：

Range range = georange.geohashRange(-1.2921, 36.8219, distance: 10);
print(range.lower); // 输出: kzf05k6hh
print(range.upper); // 输出: kzf30mptu

计算两点之间的距离

计算两个点之间的距离：

Point point1 = Point(latitude: -4.0435, longitude: 39.6682); // Mombasa
Point point2 = Point(latitude: -1.2921, longitude: 36.8219); // Nairobi

var distance = georange.distance(point1, point2);
print(distance); // 输出: 439.716 (单位：公里)

与 Firestore 的结合使用

添加文档

在 Firestore 中添加包含 geohash 字段的文档：

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

final FirebaseFirestore _db = FirebaseFirestore.instance;
GeoRange georange = GeoRange();

void main() async {
  String myhash = georange.encode(-1.2862368, 36.8195783);
  await _db.collection("locations").add({
    "geohash": myhash,
  });
}

查询 Firestore

查询 Firestore 中的文档：

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

final FirebaseFirestore _db = FirebaseFirestore.instance;
GeoRange georange = GeoRange();

void main() async {
  // 假设 currentLocation 是当前的位置
  Range range = georange.geohashRange(currentLocation.latitude, currentLocation.longitude, distance: 10);

  QuerySnapshot snapshot = await _db
      .collection("locations")
      .where("geohash", isGreaterThanOrEqualTo: range.lower)
      .where("geohash", isLessThanOrEqualTo: range.upper)
      .limit(10)
      .get();

  for (var doc in snapshot.docs) {
    print(doc.data());
  }
}

完整示例

以下是一个完整的示例代码，展示了如何使用 georange 插件进行编码、解码、生成范围和计算距离：

import 'package:georange/georange.dart';

void main() {
  GeoRange georange = GeoRange();

  // 编码经纬度
  var encoded = georange.encode(-1.2862368, 36.8195783);
  print('Encoded geohash: $encoded'); // 输出: kzf0tvg5n

  // 解码 geohash
  Point decoded = georange.decode("kzf0tvg5n");
  print('Decoded latitude: ${decoded.latitude}'); // 输出: -1.2862372398376465
  print('Decoded longitude: ${decoded.longitude}'); // 输出: 36.819584369659424

  // 计算两点之间的距离
  Point point1 = Point(latitude: -4.0435, longitude: 39.6682); // Mombasa
  Point point2 = Point(latitude: -1.2921, longitude: 36.8219); // Nairobi
  var distance = georange.distance(point1, point2);
  print('Distance between two points: $distance km'); // 输出: 439.716

  // 生成范围
  Range range = georange.geohashRange(-1.2921, 36.8219, distance: 10);
  print('Lower bound of range: ${range.lower}'); // 输出: kzf05k6hh
  print('Upper bound of range: ${range.upper}'); // 输出: kzf30mptu
}

希望这些内容能帮助你更好地理解和使用 georange 插件！如果有任何问题，欢迎随时提问。