Requirements
To use ForecastIO, all you need is an API key for the Dark Sky API. ForecastIO supports iOS (≥9.0), macOS (≥10.10), watchOS (≥2.0), and tvOS (≥9.0).
Installation
ForecastIO is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "ForecastIO"
To integrate using Carthage, specify it in your Cartfile:
github "sxg/ForecastIO"
Swift 2.3
A Swift 2.3 compatible version of ForecastIO is available on the swift2.3 branch. This version is frozen at the ForecastIO 2.1.1 API and no longer supported. To install the Swift 2.3 compatible version of ForecastIO, simply add the following line to your Podfile:
pod "ForecastIO", :git => "https://github.com/sxg/ForecastIO.git", :branch => "swift2.3"
To integrate the Swift 2.3 compatible version using Carthage, specify it in your Cartfile:
github "sxg/ForecastIO" "swift2.3"
Documentation & Unit Tests
The full documentation for ForecastIO is available on CocoaDocs.
ForecastIO includes a full suite of unit tests with 100% code coverage.
Usage
First, create a DarkSkyClient with your API key:
import ForecastIO
...
let client = DarkSkyClient(apiKey: "YOUR_API_KEY_HERE")
You can choose units that you want Forecast responses to use:
client.units = .si
The following units are supported:
- SI
- US (default)
- Canadian
- UK
- Auto (uses the local units for the location for which you are requesting weather data)
More details about the units of each property are available in the Dark Sky API docs.
You can also choose the language that you want Forecast responses to use:
client.language = .english
Many languages are supported (a full list is available here). If no language is specified, English is used as the default.
With the DarkSkyClient, you can make two kinds of requests. The first will get the current Forecast for a particular location:
let myLoc = CLLocationCoordinate2D(latitude: myLat, longitude: myLon)
client.getForecast(location: myLoc) { result in
switch result {
case .success(let currentForecast, let requestMetadata):
// We got the current forecast!
case .failure(let error):
// Uh-oh. We have an error!
}
}
The second kind of request is called a time machine request, and it will get a Forecast for a particular location at a particular time:
let myLoc = CLLocationCoordinate2D(latitude: myLat, longitude: myLon)
client.getForecast(location: myLoc, time: myTime) { result in
switch result {
case .success(let forecast, let requestMetadata):
// We got the forecast!
case .failure(let error):
// Uh-oh. We have an error!
}
}
The Forecast you receive will have metadata as well as DataPoints and DataBlocks associated with it. A DataPoint such as the currently property on Forecast represents various weather phenomena occurring at a specific instant in time. A DataBlock such as the minutely, hourly, and daily properties on Forecast represent the various weather phenomena occurring over a period of time and are represented by an array of DataPoints.
DataPoints and DataBlocks contain a large amount of information, and any of these fields can be excluded from the API response through the excludeFields parameter of the getForecast methods. excludeFields is optional and defaults to an empty array, meaning no data will be excluded from the API response. Alternatively, if you need more data, you can set the extendHourly parameter of the getForecast method to true to make the hourly property on Forecast return hourly data for a full week instead of 24 hours. extendHourly is an optional parameter and defaults to false. extendHourly is not supported on time machine requests.
For a full list of properties defined on all models, consult the full documentation on CocoaDocs.
Author
Satyam Ghodasara, [email protected], @_Satyam_
License
ForecastIO is available under the MIT license. See the LICENSE file for more info.
107 Nov 8, 2022
1k Nov 30, 2022
195 Nov 29, 2021
5 Oct 28, 2022
171 Jun 18, 2022
184 Nov 25, 2022
11 Jan 22, 2022
8 Apr 5, 2021
579 Dec 31, 2022
2 Dec 1, 2019
2 Mar 15, 2022
1 Jan 30, 2022
6 Sep 23, 2022
213 Jul 8, 2022
52 Jul 11, 2019
95 Jun 30, 2022
74 Dec 2, 2020
714 Jan 9, 2023
260 Dec 22, 2022