Flutter地理坐标转换插件latlong_to_osgrid的使用

Flutter地理坐标转换插件latlong_to_osgrid的使用

简介

这个包可以将给定的纬度和经度坐标转换为12位的OS Grid Reference，反之亦然。坐标可以以十进制格式或度、分、秒的形式给出。

开始使用

在你的应用程序的pubspec.yaml文件中添加以下内容：

dependencies:
    latlong_to_osgrid: ^1.3.3

使用方法

只需导入该包并开始使用即可。

import 'package:latlong_to_osgrid/latlong_to_osgrid.dart';

class YourClass {

    // 如果不想处理OSRef和LatLong对象，可以使用内置转换器
    // 请参见下面的例子了解如何使用转换器
    void usingConverter() {
        LatLongConverter converter = new LatLongConverter();
        OSRef result = converter.getOSGBFromDec(53.9623, -1.0819);
        print("${result.numericalRef}"); // 输出东向和北向 (460334 452192)
        print("${result.letterRef}"); // 输出字母对参考 (SE 60334 52192)
    }

    // 或者可以直接使用OSRef和LatLong对象进行转换
    void usingObjects() {
        LatLong latL = new LatLong(53.9623, -1.0819, 0, Datums.WGS84);
        OSRef osReference = latL.toOsGrid();
        print("${osReference.numericalRef}"); // 输出东向和北向如上
        print("${osReference.letterRef}"); // 输出字母对参考如上
    }

}

从纬度和经度获取OS网格

以下函数返回一个具有easting和northing属性的OSRef对象。

使用十进制纬度和经度

使用LatLongConverter对象，调用getOSGBfromDec()函数，并传入十进制的纬度和经度值。除非另有说明，否则包会默认这些纬度和经度坐标是WGS84基准（有关自定义基准，请参见下文）。

import 'package:latlong_to_osgrid/latlong_to_osgrid.dart';

class YourClass {

    LatLongConverter converter = new LatLongConverter();

    void yourFunction(double lat, double long) {
        OSRef result = converter.getOSGBfromDec(lat, long);
        print("${result.easting} ${result.northing}");
    }

    // 也可以定义自己的纬度和经度对象
    void yourOtherFunction(LatLong ll) {
        OSRef result = converter.getOSGBfromDec(ll.lat, ll.long);
        print("${result.easting} ${result.northing}");
    }

}

使用度、分、秒的纬度和经度

使用LatLongConverter对象，调用getOSGBfromDms()函数，并传入纬度和经度的度、分、秒值。如果需要，还可以调用getDegreeFromDecimal()函数，将十进制的纬度或经度转换为度数——该函数返回一个包含三个元素的数组，其中第一个元素是度数，第二个是分钟，第三个是秒。

import 'package:latlong_to_osgrid/latlong_to_osgrid.dart';

class YourClass {

    LatLongConverter converter = new LatLongConverter();

    void yourFunction(var latDeg, var latMin, var latSec, var longDeg, var longMin, var longSec) {
        OSRef result = converter.getOSGBfromDms(latDeg, latMin, latSec, longDeg, longMin, longSec);
        print("${result.easting} ${result.northing}");
    }

}

从OS网格获取纬度和经度

以下函数返回一个具有lat、long、height和datum属性的LatLong对象。由该函数得出的纬度和经度以十进制形式返回。（请参阅下文将其转换为度、分、秒）。使用LatLongConverter对象，调用getLatLongFromOSGB()函数，并传入OS网格参考的东向和北向值。 可以通过调用转换器的getLatLongFromOSGBLetterRef()函数来提供字母对格式的OS网格参考（例如TG 51409 13177），而不是单独给出东向和北向。如果你自己创建了一个OSRef对象，则可以在创建时使用东向和北向或字母对参考中的任何一个，另一个将在创建时生成，并可以通过OSRef对象的numericalRef和letterRef属性访问。

import 'package:latlong_to_osgrid/latlong_to_osgrid.dart';

class YourClass {

    LatLongConverter converter = new LatLongConverter();

    void yourFunction(int easting, int northing) {
        LatLong result = converter.getLatLongFromOSGB(easting, northing);
        print("${result.lat} ${result.long}");
    }

    void yourFunctionOne(String letterRef) {
        LatLong result = converter.getLatLongFromOSGBLetterRef(letterRef);
        print("${result.lat} ${result.long}");
    }

    // 也可以定义自己的OSRef对象
    void yourOtherFunction(OSRef os) {
        LatLong result = converter.getLatLongFromOSGB(os.easting, os.northing);
        print("${result.lat} ${result.long}");
    }

    void yourOtherFunctionOne(OSRef os) {
        LatLong result = converter.getLatLongFromOSGBLetterRef(os.letterRef);
        print("${result.lat} ${result.long}");
    }

}

指定自定义基准

默认情况下，纬度和经度值被视为WGS84基准。这是最广泛使用的基准，被GPS设备使用。如果出于某种原因，你希望给出或接收不同的基准下的纬度和经度坐标，则可以导入Datums.dart文件，并像下面这样将所需的基准传递给转换器。

import 'package:latlong_to_osgrid/latlong_to_osgrid.dart';
import 'package:latlong_to_osgrid/maths/Datums.dart';

class YourClass {

    LatLongConverter converter = new LatLongConverter();

    void yourFunction(double lat, double long) {
        OSRef result = converter.getOSGBfromDec(lat, long, Datums.NAD27);
        print("${result.easting} ${result.northing}");
    }

}

支持的基准列表如下：

• OSGB36
• WGS84
• ED50
• ETRS89
• Irl1975
• NAD27
• NAD83
• NTF
• Potsdam
• TokyoJapan
• WGS72

在十进制和度、分、秒之间切换纬度和经度

正如上面提到的，可以使用LatLongConverter在十进制和度、分、秒之间切换纬度和经度值。这通过LatLongConverter对象中的getDegreeFromDecimal()和getDecimalFromDegree()函数完成。示例如下：

import 'package:latlong_to_osgrid/latlong_to_osgrid.dart';

class YourClass {

    LatLongConverter converter = new LatLongConverter();

    void DecimalToDmsExample(double lat, double long) {
        var latDms = converter.getDegreeFromDecimal(lat);
        var longDms = converter.getDegreeFromDecimal(long);
        print("${latDms[0]}° ${latDms[1]}' ${latDms[2]}\"");
        print("${longDms[0]}° ${longDms[1]}' ${longDms[2]}\"");
    }

    void DmsToDecimalExample(var latDeg, var latMin, var latSec, var longDeg, var longMin, var longSec) {
        double latDec = converter.getDecimalFromDegree(latDeg, latMin, latSec);
        double longDec = converter.getDecimalFromDegree(longDeg, longMin, longSec);
        print("$latDec $longDec");
    }

}

完整示例Demo

import 'package:latlong_to_osgrid/latlong_to_osgrid.dart';

class ExampleClass {
  LatLongConverter converter = new LatLongConverter();

  // 示例：从十进制纬度和经度获取OSGB
  void OSGBfromDecExample(double lat, double long) {
    OSRef result = converter.getOSGBfromDec(lat, long);
    print("Easting and Northing: ${result.easting} ${result.northing}");
  }

  // 示例：从度、分、秒的纬度和经度获取OSGB
  void OSGBfromDmsExample(var latDeg, var latMin, var latSec, var longDeg, var longMin, var longSec) {
    OSRef result = converter.getOSGBfromDms(latDeg, latMin, latSec, longDeg, longMin, longSec);
    print("Easting and Northing: ${result.easting} ${result.northing}");
  }

  // 示例：从OSGB获取纬度和经度
  void LatLongfromOSGBExample(var easting, var northing) {
    LatLong result = converter.getLatLongFromOSGB(easting, northing);
    print("Latitude and Longitude: ${result.lat} ${result.long}");
  }

  // 示例：从十进制到度、分、秒
  void DecimalToDmsExample(double lat, double long) {
    var latDms = converter.getDegreeFromDecimal(lat);
    var longDms = converter.getDegreeFromDecimal(long);
    print("Degrees, Minutes, Seconds for Latitude: ${latDms[0]}° ${latDms[1]}' ${latDms[2]}\"");
    print("Degrees, Minutes, Seconds for Longitude: ${longDms[0]}° ${longDms[1]}' ${longDms[2]}\"");
  }

  // 示例：从度、分、秒到十进制
  void DmsToDecimalExample(var latDeg, var latMin, var latSec, var longDeg, var longMin, var longSec) {
    var latDec = converter.getDecimalFromDegree(latDeg, latMin, latSec);
    var longDec = converter.getDecimalFromDegree(longDeg, longMin, longSec);
    print("Decimal Latitude and Longitude: $latDec $longDec");
  }

}

void main() {
  ExampleClass example = ExampleClass();

  // 调用示例函数
  example.OSGBfromDecExample(53.9623, -1.0819);
  example.OSGBfromDmsExample(53, 57, 44, -1, 5, 1);
  example.LatLongfromOSGBExample(460334, 452192);
  example.DecimalToDmsExample(53.9623, -1.0819);
  example.DmsToDecimalExample(53, 57, 44, -1, 5, 1);
}