Flutter气象数据获取插件metar_dart的使用

Metar-Dart

在本指南中，我们将介绍如何使用 metar_dart 插件来获取和解析气象数据。metar_dart 是一个用于解析气象航空天气报告（如 METAR 和 SPECI）的 Dart 库。

当前 METAR 报告

当前气象报告可以从以下 URL 获取：

http://tgftp.nws.noaa.gov/data/observations/metar/stations/<station>.TXT

其中 <station> 是机场的 ICAO 站点代码。所有站点在过去几小时内的报告可以从以下 URL 获取：

http://tgftp.nws.noaa.gov/data/observations/metar/cycles/<cycle>Z.TXT

其中 <cycle> 是 2 位数的周期号（00 到 23）。

使用

示例代码

下面是一个简单的使用示例：

/// 导入 metar_dart 包
import 'package:metar_dart/metar_dart.dart';

void main() {
  /// 获取气象报告代码
  final code =
      'METAR KMIA 210800Z 33007G17KT 5000 +RA VCTS SCT020TCU BKN055 16/13 A3002 RESHRA NOSIG';

  /// 实例化 Metar 对象，并提供代码作为参数
  final metar = Metar(code);

  /// 获取报告类型
  print(metar.type_); // 输出：Meteorological Aerodrome Report

  /// 获取风向和风速
  print(metar.wind.directionInDegrees); // 输出：风向角度
  print(metar.wind.speedInKnot); // 输出：风速（单位：节）

  /// 获取气压
  print(metar.pressure.inHPa); // 输出：气压值（单位：百帕）

  /// 获取温度
  print(metar.temperatures.temperatureInCelsius); // 输出：温度值（单位：摄氏度）

  /// 输出整个 METAR 报告的摘要
  print(metar.toString());

  /// 将 METAR 数据转换为 Map
  print(metar.asMap());

  /// 将 METAR 数据转换为 JSON 字符串
  print(metar.toJSON());
}

完整示例 Demo

下面是一个完整的 Flutter 示例 Demo，展示了如何在 Flutter 应用中使用 metar_dart 插件获取并解析气象数据。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('METAR Data Example')),
        body: Center(
          child: FutureBuilder(
            future: fetchMetarData(),
            builder: (context, snapshot) {
              if (snapshot.connectionState == ConnectionState.done) {
                if (snapshot.hasError) {
                  return Text('Error: ${snapshot.error}');
                } else {
                  final metar = snapshot.data;
                  return Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                      Text('Report Type: ${metar?.type_ ?? 'N/A'}'),
                      Text('Wind Direction: ${metar?.wind.directionInDegrees ?? 'N/A'}°'),
                      Text('Wind Speed: ${metar?.wind.speedInKnot ?? 'N/A'} kt'),
                      Text('Pressure: ${metar?.pressure.inHPa ?? 'N/A'} hPa'),
                      Text('Temperature: ${metar?.temperatures.temperatureInCelsius ?? 'N/A'}°C'),
                      Text('METAR Summary: ${metar?.toString() ?? 'N/A'}'),
                    ],
                  );
                }
              } else {
                return CircularProgressIndicator();
              }
            },
          ),
        ),
      ),
    );
  }

  Future<Metar?> fetchMetarData() async {
    final code =
        'METAR KMIA 210800Z 33007G17KT 5000 +RA VCTS SCT020TCU BKN055 16/13 A3002 RESHRA NOSIG';
    try {
      final metar = Metar(code);
      return metar;
    } catch (e) {
      print('Error fetching METAR data: $e');
      return null;
    }
  }
}

在这个示例中，我们创建了一个 Flutter 应用程序，该应用程序从一个固定的 METAR 代码获取气象数据，并将其显示在屏幕上。通过 FutureBuilder，我们可以异步地获取数据并在数据可用时更新 UI。

贡献

贡献使开源社区成为一个学习、启发和创造的地方。任何贡献都将得到极大的赞赏。

如果您有任何改进建议，请在仓库中创建一个拉取请求或打开一个带有“增强”标签的问题。 不要忘记给项目加星！再次感谢！

1. Fork 项目
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)

路线图

• ✅ 添加 TAF 和 METAR 报告的解析器
• ❌ 添加验证 TAF 的函数
• ❌ 添加与验证函数交互的命令行 API
• ❌ 添加 SYNOPTIC 报告的解析器
• ❌ 添加根据 ICAO Annex 3 规则验证报告的函数
• ❌ 多语言支持
  • ❌ 葡萄牙语
  • ❌ 西班牙语

特性与问题

请在 问题跟踪器 中提交特性请求和问题。

当前源码

最新的包版本可以通过 Git 获取，只需在终端运行以下命令：

git clone https://github.com/TAF-Verification/metar-dart

作者

python-metar 库最初由 Tom Pollard 在 2005 年一月编写。2020 年，Diego Garro 基于他的工作创建了 Dart 语言的 metar-dart 包。

版本控制

该项目使用 Cider 工具进行版本控制。如果您 fork 了此仓库，请在终端运行以下命令以激活它：

pub global activate cider