Flutter地图工具插件maps_toolkit2的使用

插件maps_toolkit2简介

maps_toolkit2 是 maps_toolkit 的一个分支版本，目标是使其与 flutter_map 兼容。它是一个用于地球表面测量的库，包括面积、距离、方向等功能。

该库的主要功能包括计算路径的面积、两点之间的距离、方向等。

插件maps_toolkit2使用步骤

1. 添加依赖

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

dependencies:
  ...
  maps_toolkit2: ^1.0.1

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

2. 基本用法示例

以下是一个简单的示例，展示如何计算伦敦和巴黎之间的距离：

import 'package:maps_toolkit2/maps_toolkit2.dart';

void main() {
  // 定义两个城市的坐标
  final cityLondon = LatLng(51.5073509, -0.1277583);
  final cityParis = LatLng(48.856614, 2.3522219);

  // 计算两点之间的距离（单位为米）
  final distance = SphericalUtil.computeDistanceBetween(cityLondon, cityParis) / 1000.0;

  // 输出结果
  print('Distance between London and Paris is $distance km.');
}

输出结果：

Distance between London and Paris is 343.76655244035794 km.

3. 使用 Google Maps 包

如果你想将 maps_toolkit2 与 google_maps_flutter 结合使用，可以指定一个前缀来避免命名冲突：

import 'package:maps_toolkit2/maps_toolkit2.dart' as mp;
import 'package:google_maps_flutter/google_maps_flutter.dart';

void main() {
  // 定义两个点
  final pointFromToolkit = LatLng(90, 0);
  final pointFromGoogleMap = LatLng(90, 0);

  // 使用 SphericalUtil 计算角度
  final angle = mp.SphericalUtil.computeAngleBetween(pointFromToolkit, pointFromGoogleMap);

  print('Angle between points is $angle degrees.');
}

函数列表

以下是 maps_toolkit2 提供的主要函数及其用途：

• SphericalUtil.computeArea
  计算地球表面上闭合路径的面积。

• SphericalUtil.computeDistanceBetween
  计算两点之间的距离（单位为米）。

• SphericalUtil.computeHeading
  计算从一个点到另一个点的方向。

• SphericalUtil.computeLength
  计算给定路径的长度（单位为米）。

• SphericalUtil.computeOffset
  计算从原点移动一定距离后的点，方向由指定的角度决定。

• SphericalUtil.computeOffsetOrigin
  计算起点的位置，已知终点、移动的距离和初始方向。

• SphericalUtil.computeSignedArea
  计算地球表面上闭合路径的有符号面积。

• SphericalUtil.interpolate
  计算从起点到终点的某个比例位置。

• PolygonUtil.containsLocation
  判断给定点是否位于多边形内。

• PolygonUtil.isLocationOnEdge
  判断给定点是否位于多边形边缘附近（指定误差范围）。

• PolygonUtil.isLocationOnPath
  判断给定点是否位于折线上（指定误差范围）。

• PolygonUtil.locationIndexOnPath
  判断给定点是否位于折线上，并返回其位置索引。

• PolygonUtil.simplify
  使用 Douglas-Peucker 算法简化多边形或折线。

• PolygonUtil.isClosedPolygon
  判断给定的点列表是否构成一个闭合多边形。

• PolygonUtil.distanceToLine
  计算点到线段的距离。

• PolygonUtil.decode
  解码编码的路径字符串为一系列的 LatLng。

• PolygonUtil.encode
  将一系列的 LatLng 编码为路径字符串。

特性与问题报告

如果你发现任何问题或有新的功能需求，请在 GitHub 问题跟踪器 中提交。

示例代码

以下是从官方示例中提取的完整代码：

import 'package:flutter/material.dart';
import 'package:maps_toolkit2/maps_toolkit2.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('maps_toolkit2 Example')),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              final cityLondon = LatLng(51.5073509, -0.1277583);
              final cityParis = LatLng(48.856614, 2.3522219);

              final distance = SphericalUtil.computeDistanceBetween(
                      cityLondon, cityParis) /
                  1000.0;

              ScaffoldMessenger.of(context).showSnackBar(
                SnackBar(content: Text('Distance: $distance km')),
              );
            },
            child: Text('Calculate Distance'),
          ),
        ),
      ),
    );
  }
}