Flutter GeoJSON解析插件geojson2的使用

在本教程中，我们将探讨如何使用geojson2插件来解析GeoJSON数据，并将其展示在Flutter应用中。geojson2是一个强大的工具，可以帮助你处理Dart中的GeoJSON数据。其主要功能包括解析器、搜索功能和地理围栏功能。

安装插件

首先，在你的pubspec.yaml文件中添加geojson2依赖：

dependencies:
  flutter:
    sdk: flutter
  geojson: ^x.x.x  # 替换为最新版本号
  flutter_map: ^x.x.x  # 如果你需要在地图上展示GeoJSON数据，可以添加此依赖

然后运行flutter pub get以安装依赖。

简单函数

从字符串数据解析GeoJSON

你可以使用featuresFromGeoJson函数从GeoJSON字符串数据中获取FeaturesCollection对象。参数包括：

• data: 包含GeoJSON数据的字符串，必需。
• nameProperty: 用于设置地理系列名称的属性，如果为空则自动设置。
• verbose: 如果为true，则打印解析的数据。

示例代码：

import 'package:geojson/geojson.dart';

Future<void> parseGeoJsonFromString() async {
  final geo = GeoJson();
  final data = '{"type": "FeatureCollection", "features": []}';
  final features = await geo.featuresFromGeoJson(data);
}

从文件解析GeoJSON

如果你有一个GeoJSON文件，可以使用featuresFromGeoJsonFile函数从文件中获取FeaturesCollection对象。参数包括：

• file: 需要加载的文件，必需。
• nameProperty: 用于设置地理系列名称的属性，如果为空则自动设置。
• verbose: 如果为true，则打印解析的数据。

示例代码：

import 'package:geojson/geojson.dart';
import 'dart:io';

Future<void> parseGeoJsonFromFile() async {
  final geo = GeoJson();
  final file = File('path/to/your/file.geojson');
  final features = await geo.featuresFromGeoJsonFile(file);
}

Web支持

由于Web不支持隔离（isolate），你可以使用featuresFromGeoJsonMainThread函数来解析GeoJSON数据。参数包括：

• data: 包含GeoJSON数据的字符串，必需。
• nameProperty: 用于设置地理系列名称的属性，如果为空则自动设置。
• verbose: 如果为true，则打印解析的数据。

示例代码：

import 'package:geojson/geojson.dart';

Future<void> parseGeoJsonOnWeb() async {
  final geo = GeoJson();
  final data = '{"type": "FeatureCollection", "features": []}';
  final features = await geo.featuresFromGeoJsonMainThread(data);
}

响应式API

解析并监听

当你处理大量数据时，使用响应式API来实时获取解析的特征数据非常有用。这些API提供了类型化的流，以便在解析完成后立即检索特征数据。可用的流包括：

• processedFeatures: 解析后的所有几何数据。
• processedPoints: 解析后的点。
• processedMultipoints: 解析后的多点。
• processedLines: 解析后的线。
• processedMultilines: 解析后的多线。
• processedPolygons: 解析后的多边形。
• processedMultipolygons: 解析后的多多边形。
• endSignal: 指示解析完成的信号。

示例代码：

import 'package:flutter/services.dart' show rootBundle;
import 'package:geojson/geojson.dart';
import 'package:flutter_map/flutter_map.dart';

/// 数据用于绘制Flutter地图上的多段线层
final lines = <Polyline>[];

Future<void> parseAndDrawAssetsOnMap() async {
  final geo = GeoJson();
  geo.processedLines.listen((GeoJsonLine line) {
    /// 当解析到一条线时，立即将其添加到地图上
    setState(() => lines.add(Polyline(
        strokeWidth: 2.0, color: Colors.blue, points: line.geoSerie.toLatLng())));
  });
  geo.endSignal.listen((_) => geo.dispose());
  final data = await rootBundle
      .loadString('assets/railroads_of_north_america.geojson');
  await geo.parse(data, verbose: true);
}

数据属性

解析数据后，GeoJson实例将具有访问数据的属性：

List<GeoJsonFeature> features;
List<GeoJsonPoint> points;
List<GeoJsonMultiPoint> multipoints;
List<GeoJsonLine> lines;
List<GeoJsonMultiLine> multilines;
List<GeoJsonPolygon> polygons;
List<GeoJsonMultiPolygon> multipolygons;

示例代码：

final List<GeoJsonLine> lines = geo.lines;

搜索

在GeoJSON文件中搜索

你可以使用searchInFile方法在GeoJSON文件中进行搜索。参数包括：

• filePath: 文件路径。
• query: 搜索条件。
• verbose: 如果为true，则打印解析的数据。

示例代码：

import 'package:geojson/geojson.dart';

Future<void> searchInGeoJsonFile() async {
  final geo = GeoJson();
  await geo.searchInFile("countries.geojson",
      query: GeoJsonQuery(
          geometryType: GeoJsonFeatureType.multipolygon,
          matchCase: false,
          property: "name",
          value: "Zimbabwe"),
      verbose: true);
  List<GeoJsonMultiPolygon> result = geo.multipolygons;
}

使用字符串数据搜索

也可以使用search方法，参数为字符串数据而不是文件路径。该方法同样提供流以实时获取找到的数据。

示例代码：

import 'package:geojson/geojson.dart';

Future<void> searchInGeoJsonString() async {
  final geo = GeoJson();
  await geo.search('{"type": "FeatureCollection", "features": []}',
      query: GeoJsonQuery(
          geometryType: GeoJsonFeatureType.multipolygon,
          matchCase: false,
          property: "name",
          value: "Zimbabwe"),
      verbose: true);
  List<GeoJsonMultiPolygon> result = geo.multipolygons;
}

地理围栏

距离围栏

你可以使用geofenceDistance方法在给定距离内查找点。参数包括：

• point: 要搜索的GeoJsonPoint。
• points: 要搜索的点列表。
• distance: 要搜索的距离（米）。

示例代码：

import 'package:geojson/geojson.dart';

Future<void> geofenceByDistance() async {
  final geo = GeoJson();
  final point = GeoJsonPoint(name: "Point", geoPoint: GeoPoint(latitude: 37.7749, longitude: -122.4194));
  final points = [
    GeoJsonPoint(name: "Point 1", geoPoint: GeoPoint(latitude: 37.7750, longitude: -122.4195)),
    GeoJsonPoint(name: "Point 2", geoPoint: GeoPoint(latitude: 37.7748, longitude: -122.4193))
  ];
  await geo.geofenceDistance(point: point, points: points, distance: 100);
  List<GeoPoint> foundPoints = geo.points;
}

多边形围栏

你可以使用geofencePolygon方法检查点是否在多边形内。参数包括：

• polygon: 要检查的GeoJsonPolygon。
• points: 要搜索的点列表。

示例代码：

import 'package:geojson/geojson.dart';

Future<void> geofenceByPolygon() async {
  final geo = GeoJson();
  final polygon = GeoJsonPolygon(name: "Polygon", geoSeries: []);
  final points = [
    GeoJsonPoint(name: "Point 1", geoPoint: GeoPoint(latitude: 37.7750, longitude: -122.4195)),
    GeoJsonPoint(name: "Point 2", geoPoint: GeoPoint(latitude: 37.7748, longitude: -122.4193))
  ];
  await geo.geofencePolygon(polygon: polygon, points: points);
  List<GeoPoint> foundPoints = geo.points;
}