Flutter太阳位置与日照时间计算插件apsl_sun_calc的使用

Flutter太阳位置与日照时间计算插件apsl_sun_calc的使用

Apsl Sun Calc 插件简介

apsl_sun_calc 是一个用于计算太阳和月亮位置及相位的Flutter包。它基于给定的日期和地理位置，提供太阳和月亮的位置、日光阶段（如黎明、黄昏、黄金时段等）以及月亮的照明情况。该Dart包灵感来源于 suncalc JavaScript 库。

功能特性

• 太阳位置：计算太阳的方位角和高度角。
• 月亮位置：确定月亮的方位角、高度角和距离。
• 日照时间：获取各种日光阶段（如黎明、黄昏、黄金时段等）。
• 月亮照明：计算月亮的照明比例、相位和角度。
• Flutter支持：兼容Flutter移动和Web平台。

前置条件

在开始使用之前，请确保你已经满足以下要求：

• Flutter SDK
• Dart SDK

安装

1. 在 pubspec.yaml 文件中添加 apsl_sun_calc 依赖：

   dependencies:
     apsl_sun_calc: ^0.0.1
   

2. 运行以下命令安装包：

   flutter pub get
   

使用方法

在你的Dart代码中导入 apsl_sun_calc 包：

import 'package:apsl_sun_calc/apsl_sun_calc.dart';

示例代码

下面是一个完整的示例Demo，展示了如何使用 apsl_sun_calc 计算太阳位置，并在Flutter应用中显示结果。

import 'package:apsl_sun_calc/apsl_sun_calc.dart';
import 'package:flutter/material.dart';
import 'package:gap/gap.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  // This widget is the root of your application.
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Apsl Sun Calc Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  [@override](/user/override)
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  dynamic sunPosition;
  dynamic moonPosition;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("Apsl Sun Calc Example"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(
              "太阳位置:  \n${sunPosition ?? "未计算"}",
              style: Theme.of(context).textTheme.bodyMedium,
              textAlign: TextAlign.center,
            ),
            const Gap(10),
            ElevatedButton(
              onPressed: () {
                setState(() {
                  // 计算当前时间、纬度51.5、经度-0.1的太阳位置
                  sunPosition = SunCalc.getSunPosition(
                    DateTime.now(),
                    51.5, // 纬度
                    -0.1, // 经度
                  );
                });
              },
              child: const Text("获取太阳位置"),
            ),
            const Gap(20),
            Text(
              "月亮位置:  \n${moonPosition ?? "未计算"}",
              style: Theme.of(context).textTheme.bodyMedium,
              textAlign: TextAlign.center,
            ),
            const Gap(10),
            ElevatedButton(
              onPressed: () {
                setState(() {
                  // 计算当前时间、纬度51.5、经度-0.1的月亮位置
                  moonPosition = SunCalc.getMoonPosition(
                    DateTime.now(),
                    51.5, // 纬度
                    -0.1, // 经度
                  );
                });
              },
              child: const Text("获取月亮位置"),
            ),
          ],
        ),
      ),
    );
  }
}