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

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

简介

dart_suncalc 是一个用于计算太阳和月亮的位置以及不同日出、日落等天文时间的库。该库是基于 JavaScript 版本的 suncalc 重构而来，最初由 Vladimir Agafonkin (“mourner”) 开发。dart_suncalc 还包含了来自其他开发者的一些修复和改进。

使用示例

以下是一个完整的示例，展示了如何使用 dart_suncalc 插件来计算太阳的位置和日照时间。我们将创建一个简单的 Flutter 应用程序，显示当前日期的太阳升起、落下时间，并计算太阳在这些时刻的位置（方位角和高度角）。

完整示例代码

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Sun Position Calculator',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: SunPositionScreen(),
    );
  }
}

class SunPositionScreen extends StatefulWidget {
  [@override](/user/override)
  _SunPositionScreenState createState() => _SunPositionScreenState();
}

class _SunPositionScreenState extends State<SunPositionScreen> {
  // 定义经纬度（以伦敦为例）
  final double latitude = 51.5;
  final double longitude = -0.1;

  // 存储太阳时间
  Map<String, DateTime?>? sunTimes;

  // 存储太阳位置
  SunPosition? sunrisePosition;
  SunPosition? sunsetPosition;

  [@override](/user/override)
  void initState() {
    super.initState();
    _calculateSunTimesAndPositions();
  }

  // 计算太阳的时间和位置
  void _calculateSunTimesAndPositions() {
    final now = DateTime.now();
    sunTimes = SunCalc.getTimes(now, lat: latitude, lng: longitude);

    if (sunTimes != null) {
      // 获取日出时的太阳位置
      if (sunTimes!['sunrise'] != null) {
        sunrisePosition = SunCalc.getPosition(sunTimes!['sunrise'], lat: latitude, lng: longitude);
      }

      // 获取日落时的太阳位置
      if (sunTimes!['sunset'] != null) {
        sunsetPosition = SunCalc.getPosition(sunTimes!['sunset'], lat: latitude, lng: longitude);
      }
    }

    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('太阳位置与日照时间'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(
              '当前位置：纬度 ${latitude}, 经度 ${longitude}',
              style: TextStyle(fontSize: 16),
            ),
            SizedBox(height: 20),
            Text(
              '今天太阳的相关信息：',
              style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
            ),
            SizedBox(height: 10),
            _buildSunTimeItem('日出', sunTimes?['sunrise']),
            _buildSunTimeItem('正午', sunTimes?['solarNoon']),
            _buildSunTimeItem('日落', sunTimes?['sunset']),
            SizedBox(height: 20),
            Text(
              '太阳位置（日出时）：',
              style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
            ),
            SizedBox(height: 10),
            _buildSunPositionItem('方位角', sunrisePosition?.azimuth, '度'),
            _buildSunPositionItem('高度角', sunrisePosition?.altitude, '度'),
            SizedBox(height: 20),
            Text(
              '太阳位置（日落时）：',
              style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
            ),
            SizedBox(height: 10),
            _buildSunPositionItem('方位角', sunsetPosition?.azimuth, '度'),
            _buildSunPositionItem('高度角', sunsetPosition?.altitude, '度'),
          ],
        ),
      ),
    );
  }

  // 构建太阳时间项
  Widget _buildSunTimeItem(String label, DateTime? time) {
    if (time == null) {
      return Container();
    }
    return Row(
      children: [
        Text('$label: ', style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold)),
        Text(time.toLocal().toString(), style: TextStyle(fontSize: 16)),
      ],
    );
  }

  // 构建太阳位置项
  Widget _buildSunPositionItem(String label, double? value, String unit) {
    if (value == null) {
      return Container();
    }
    return Row(
      children: [
        Text('$label: ', style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold)),
        Text('${(value * 180 / PI).toStringAsFixed(2)} $unit', style: TextStyle(fontSize: 16)),
      ],
    );
  }
}