TestsTested | ✓ |
LangLanguage | Obj-CObjective C |
License | MIT |
ReleasedLast Release | Jun 2016 |
Maintained by Comyar Zaheri, Comyar Zaheri.
CZWeatherKit is a simple, extensible weather library for iOS, tvOS, and OS X that allows for easy fetching of weather data from various weather services.
*Note: Features requiring MapKit are unsupported with tvOS.
Included in this project is a Swift playground, CZWeatherKit.playground
, that will let you play around with CZOpenWeatherMapRequest
. However if you're as lazy as I am, here are some code snippets to get you started:
#import <CZWeatherKit/CZWeatherKit.h>
CZWundergroundRequest *request = [CZWundergroundRequest newConditionsRequest];
request.location = [CZWeatherLocation locationFromCity:@"Seattle" state:@"WA"];
request.key = @"wundergroundApiKey";
[request sendWithCompletion:^(CZWeatherData *data, NSError *error) {
CZWeatherCurrentCondition *condition = data.current;
// dreams come true here
}];
import CZWeatherKit
let request = CZWundergroundRequest.newForecastRequest()
request.location = CZWeatherLocation(fromCity: "Seattle", state: "WA")
request.key = "wundergroundApiKey"
request.sendWithCompletion { (data, error) -> Void in
if let weather = data {
for forecast in weather.dailyForecasts {
// dreams come true here
}
}
}
#import <CZWeatherKit/CZWeatherKit.h>
CZOpenWeatherMap *request = [CZOpenWeatherMapRequest newCurrentRequest];
request.location = [CZWeatherLocation locationFromCity:@"Seattle" state:@"WA"];
[request sendWithCompletion:^(CZWeatherData *data, NSError *error) {
CZWeatherCurrentCondition *condition = data.current;
// dreams come true here
}];
import CZWeatherKit
let request = CZOpenWeatherMapRequest.newDailyForecastRequestForDays(3)
request.location = CZWeatherLocation(fromCity: "Seattle", state: "WA")
request.sendWithCompletion { (data, error) -> Void in
if let weather = data {
for forecast in weather.dailyForecasts {
// dreams come true here
}
}
}
A weather service allows for the dispatching of weather data requests and allows for more fine-grained control over how requests are handled as opposed to the interface provided by CZWeatherDataRequest
. An ideal use case for a weather service is powering a weather app.
import CZWeatherKit
let service = CZWeatherService()
request = CZOpenWeatherMapRequest.newCurrentRequest()
request.location = CZWeatherLocation(fromCity: "Seattle", state: "WA")
service.dispatchRequest(request, completion: { (data, error) -> Void in
if let weather = data {
// dreams come true here
}
})
CZWeatherKit currently supports the following weather services:
+1
in the comments of the issue if you need this feature.CZWeatherKit supports Climacons out of the box. The Climacons Font is a font set created by Adam Whitcroft featuring weather icons.
Core | Description |
---|---|
CZWeatherService |
Asyncronously dispatches requests, caches responses, and simplifies key management when making frequent API calls. |
CZPINWeatherDataCache |
An implementation of the CZWeatherDataCache protocol that uses PINCache for caching weather data. |
Model Type | Description |
---|---|
CZWeatherLocation |
Represents a location to retrieve weather data for. |
CZWeatherData |
Top-level container for all other weather data. |
CZWeatherCurrentCondition |
Contains data for current conditions. |
CZWeatherForecastCondition |
Contains data for a day's forecasted conditions. |
CZWeatherHourlyCondition |
Contains data for an hour's conditions. |
CZWeatherRequest |
The abstract base class for all request classes. |
CZWundergroundRequest |
Used for calling the Wunderground API. |
CZOpenWeatherMapRequest |
Used for calling the OpenWeatherMap API. |
CZForecastioRequest |
Used for calling the Forecast.io API. |
CZWorldWeatherOnlineRequest |
Used for calling the World Weather Online API. |
API Type | Description |
---|---|
CZWundergroundAPI |
Wunderground API class. |
CZOpenWeatherMapAPI |
OpenWeatherMap API class. |
CZForecastioAPI |
Forecastio API class. |
CZWorldWeatherOnlineAPI |
WorldWeatherOnline API class. |
Protocols | Description |
---|---|
CZWeatherAPI |
The protocol for weather API classes. |
CZWeatherDataCache |
The protocol for a cache used by a CZWeatherService . |
Headers | Description |
---|---|
CZClimacons |
Contains mappings for Climacons to chars. |
CZWeatherKitTypes |
Contains varions type definitions. |
If you would like to contribute to the development of CZWeatherKit, please take care to follow the style conventions and please include unit tests in your pull request.
For feature requests or general questions, feel free to post an issue.