weather 1.0.0

A weather plugin for fetching current weather and forecasting via the OpenWeatherMap API. Works for both Android and iOS.

weather

This package uses the OpenWeatherMAP API to get the current weather status as well as weather forecasts.

The weather can be fetched with the device location or with a custom location.

Install (Flutter)

Add weather as a dependency in pubspec.yaml. For help on adding as a dependency, view the pubspec documenation.

AndroidX support

Only for Android API level 28

Update the contents of the android/gradle.properties file with the following:

android.enableJetifier=true
android.useAndroidX=true
org.gradle.jvmargs=-Xmx1536M

Next, add the following dependencies to your android/build.gradle file:

dependencies {
  classpath 'com.android.tools.build:gradle:3.3.0'
  classpath 'com.google.gms:google-services:4.2.0'
} 

And finally, set the Android compile- and minimum SDK versions to compileSdkVersion 28, and minSdkVersion 21 respectively, inside the android/app/build.gradle file.

Permissions

The package uses your location to fetch weather data, therefore location tracking must be enabled.

Android

Add the following entry to your manifest.xml file, in the Android project of your application:

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

In addition, it is recommended to set your minimum SDK version to 21.

iOS

1. Open the XCode project of your app, named Runner.xcodeproj
2. Locate the info.plist file in the Runner directory.
3. Right click info.plist and choose Open as > Source Code.
4. Add the following entries inside the <dict></dict> tags`:

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app uses location to forecast the weather.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>This app uses location to forecast the weather.</string>

Known issues

There is an issue with the location plugin which this package depends on, where an error with the following message

The use of Swift 3 @objc inference in Swift 4 mode is deprecated

may be thrown. For a solution, check the following stack overflow question: https://stackoverflow.com/questions/44379348/the-use-of-swift-3-objc-inference-in-swift-4-mode-is-deprecated

Usage

First and foremost you need an API key from OpenWeatherMap, which can be acquired for free here.

import 'package:weather/weather.dart';

...

WeatherStation weatherStation = new WeatherStation("YOUR_API_KEY");

Query current weather

For specific documentation on the current weather API, see the OpenWeatherMap weather API docs.

With device location

Weather weather = await weatherStation.currentWeather();

With custom location

Weather weather = await weatherStation.currentWeather(lat: LATITUDE, lon: LONGITUDE);

For a complete list of all the properties of the Weather class, check the documentation

Get temperature

The Temperature class holds a temperature and can output the temperature in Celsius, Fahrenheit, and Kelvin:

double celsius = weather.temperature.celsius;
double fahrenheit = weather.temperature.celsius;
double kelvin = weather.temperature.kelvin;

Query 5 day forecast

For API documentation on the forecast API, see the OpenWeatherMap forecast API docs.

With device location

List<Weather> forecasts = await weatherStation.fiveDayForecast();

With custom location

List<Weather> forecasts = await weatherStation.fiveDayForecast(lat: LATITUDE, lon: LONGITUDE);

Exceptions

The following are cases for which an exception will be thrown:

• No Location permission was given
• The provided OpenWeather API key is invalid
• An bad response was given by the API; it may be down.