Aeris iOS Weather SDK

The Aeris iOS Framework allows a developer to quickly and easily add weather content and functionality to their iOS applications quickly and easily without having to code anything themselves. It utilizes the Aeris 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 applications, greatly reducing the amount of code and development needed on the developer end.


Requirements + Compatibility

  • Minimum iOS Deployment Target: iOS 7
  • Supports both Swift (any version) and Objective-C languages
  • Fully Compatible with Xcode 7.0 and iOS 9.0
  • ARC enabled
  • Dependencies: AFNetworking 3.0

Migrating from 1.0 to 2.0

If you’re upgrading from a pre-2.0 version of the SDK, review the 2.0 Migration Guide for an overview of the architectural changes from 1.0.


Before you can begin using the Aeris iOS SDK in your project, you will need to determine which components from the AerisWeather iOS SDK you will use and ensure that you have the required Aeris API keys for your application.

Step 1: Integrate the AerisWeather SDK libraries with your project using either CocoaPods or manual installation by following our setup guide on Github.

Step 2: Obtain Aeris API access keys by registering your application with your account.

Step 3: Import the Aeris iOS SDK framework modules into the necessary portions of your project, or within your project’s global precompiled header (*.pch) file:


#import <Aeris/Aeris.h>


import Aeris

Step 4: Initialize AerisEngine with your application’s API access keys in your AppDelegate:


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
	self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];

	[AerisEngine engineWithKey:@"__CLIENT_ID__" secret:@"__CLIENT_SECRET__"];

	self.window.backgroundColor = [UIColor whiteColor];
	[self.window makeKeyAndVisible];

	return YES;


func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
	AerisEngine.engineWithKey("__CLIENT_ID__", secret: "__CLIENT_SECRET__")
	window = UIWindow(frame: UIScreen.mainScreen().bounds)
	window?.backgroundColor = UIColor.whiteColor()
	return true


Occasionally it may be useful to have the Aeris iOS SDK output additional log messages in order to debug issues within your own application, such as API requests and errors as well as internal view and map events. By default, the Aeris iOS SDK only outputs error messages and warnings. So if you require more information during development and testing, just enable debug mode after initializing the AerisEngine with your access keys:


[AerisEngine engineWithKey:@"__CLIENT_ID__" secret:@"__CLIENT_SECRET__"];
[AerisEngine enableDebug];


AerisEngine.engineWithKey("__CLIENT_ID__", secret: "__CLIENT_SECRET__")