#KFOpenWeatherMapAPI Client for iOS and OSX

A client connecting to the OpenWeatherMap API for fetching current weather data, interval/daily forecasts, and searching cities.

#Installation Add

pod 'KFOpenWeatherMapAPI'

to your podfile and run

pod install

Initialize the client with your API key obtained from http://openweathermap.org/login and an api version (currently 2.5):

self.apiClient = [[KFOpenWeatherMapAPIClient alloc] initWithAPIKey:@"1111111111"andAPIVersion:@"2.5"];

for a full documentation see http://docs.kf-interactive.com/KFOpenWeatherMapAPI

You can request weather data for a city by its name, its OpenWeatherMap city id, or by its geo location. For more acurate results you can #Usage ##Current Weather For requesting the current weather for Los Angeles use:

[self.apiClient weatherForCityName:@"Los Angeles"withResultBlock:^(BOOL success, id responseData, NSError *error)
{
if (success)
{
KFOWMWeatherResponseModel *responseModel = (KFOWMWeatherResponseModel *)responseData;
NSLog(@"received weather: %@, temperature: %@ K, %@%%rH, %@ mbar", responseModel.cityName, responseModel.mainWeather.temperature, responseModel.mainWeather.humidity, responseModel.mainWeather.pressure);
}
else
{
NSLog(@"could not get weather: %@", error);
}
}];

This will return a KFOWMWeatherResponseModel including all data from the api parsed as native objects:
KFOpenWeatherMapAPI[6102:c07] received weather: Los Angeles, temperature: 292.65 K, 71%rH, 1011 mbar

##Forecast

To get the forecast for Los Angeles for the next hours call

[self.apiClient forecastForCityName:@"Los Angeles"withResultBlock:^(BOOL success, id responseData, NSError *error)
{
if (success)
{
KFOWMForecastResponseModel *responseModel = (KFOWMForecastResponseModel *)responseData;
NSString *humidity = [[responseModel.list valueForKeyPath:@"mainWeather.humidity"] componentsJoinedByString:@"%rH, "];
NSLog(@"received forecast: %@, humidity: %@", responseModel.city.cityName, humidity);
}
else
{
NSLog(@"could not get forecast: %@", error);
}
}];

and you get a KFOWMForecastResponseModel:
KFOpenWeatherMapAPI[6448:c07] received forecast: Los Angeles, humidity: 80%rH, 70%rH, 67%rH, 66%rH, …

##Daily Forecast

For getting a daily forecast for 4 days for Los Angeles use

[self.apiClient dailyForecastForCityName:@"Los Angeles"numberOfDays:4withResultBlock:^(BOOL success, id responseData, NSError *error)
{
if (success)
{
KFOWMDailyForecastResponseModel *responseModel = (KFOWMDailyForecastResponseModel *)responseData;
NSLog(@"received daily forecast: %@, %@", responseModel.city.cityName, [[responseModel.list valueForKeyPath:@"temperature.day"] componentsJoinedByString:@" K, "]);
}
else
{
NSLog(@"could not get daily forecast: %@", error);
}
}];

that returns a KFOWMDailyForecastResponseModel:
KFOpenWeatherMapAPI[6605:c07] received daily forecast: Los Angeles, 299.71 K, 299.93 K, 300.69 K, 301.13 K ##Search To search for a phrase you can call

[self.apiClient searchForPhrase:@"London"numberOfResults:10withResultBlock:^(BOOL success, id responseData, NSError *error)
{
if (success)
{
KFOWMSearchResponseModel *responseModel = (KFOWMSearchResponseModel *)responseData;
NSMutableArray *foundCities = [NSMutableArraynew];
for (KFOWMWeatherResponseModel *listModel in responseModel.list)
{
NSString *city = [NSStringstringWithFormat:@"%@, %@", listModel.cityName, listModel.systemInfo.country];
[foundCities addObject:city];
}
NSLog(@"search results: %@", [foundCities componentsJoinedByString:@", "]);
}
else
{
NSLog(@"could not get search results: %@", error);
}
}];

that will result in a KFOWMSearchResponseModel:
KFOpenWeatherMapAPI[6976:c07] search results: London, GB, London, CA, London, US, London, US

#License This code is distributed under the terms and conditions of the MIT license.

#Author Rico Becker
@ricobeck
https://twitter.com/ricobeck