The AerisWeather SDK for iOS and tvOS allows a developer to quickly and easily add weather content and functionality to their iOS and tvOS applications quickly and easily without having to code anything themselves. It utilizes the AerisWeather API backend for data loading and is built on top of an object mapping system that efficiently loads requested weather content into third-party iOS and tvOS applications, greatly reducing the amount of code and development needed on the developer end.

Looking for the version 2.0 docs? You can still access the documentation for version 2.0 of our iOS SDK here.

Once you have our SDK setup in your own project by following our installation guide, getting data into your applications is quick and easy. For example, loading the current conditions for a particular place is as simple as the following sample code demonstrates:

AWFPlace *place = [AWFPlace placeWithCity:@"seattle" state:@"wa" country:@"us"];
[[AWFObservations sharedService] getForPlace:place options:nil completion:^(AWFWeatherEndpointResult * _Nullable result) {
    if (result.error) {
        NSLog(@"Observation data failed to load! %@", result.error);
        return;
    }

    NSArray *results = result.results;
    if ([results count] > 0) {
        AWFObservation *obs = (AWFObservation *)[results objectAtIndex:0];

        // do something with obs...
    }
}];

Or, in Swift:

let place = AWFPlace(city: "seattle", state: "wa", country: "us")
AWFObservations.sharedService().get(forPlace: place, options: nil) { (result) in
    guard let results = result?.results else { print("Observation data failed to load - \(String(describing: result?.error))"); return }

    if let obs = results.first as? AWFObservation {
        // do something with obs...
    }
}

You can learn more about the various ways to load AerisWeather API data into your application by reviewing our Getting Started guide. Also, make sure to check out how you can add a fully-functional weather map powered by AerisWeather Maps or graph various weather data from our API.

Be sure to review our complete demo application for extensive SDK usage examples and code and our selection of quick code examples.

Last modified: July 26, 2021