iOS Setup


SDK Configuration

The AirMapSDK-Swift library reads a JSON configuration file during initialization. This airmap.config.json file can be downloaded from the AirMap Developer Portal and placed at the root of the project's app bundle.

MapBox Api Key

AirMap exposes an AirMapMapView, which exposes methods that allow you to configure the map with Rulesets. AirMapMapView is a subclass of MGLMapView, which is apart of the Mapbox SDK for iOS. Please sign up and request a Mapbox access token:

You can add this access token to your airmap.config.json.


The AirMapSDK-Swift library and its dependencies are available via CocoaPods. Various subspecs are available including AirMap/Core, AirMap/Traffic, AirMap/Telemetry, and AirMap/UI:

Check SDK Releases for latest version

# ...
pod 'AirMapSDK', :git => '', :tag => '2.0.0.beta.3'
# ...

post_install do |installer|
    # List of Pods to use as Swift 3.2
    swift3targets = ['Lock', 'SwiftMQTT'] 

    installer.pods_project.targets.each do |target|
        if swift3targets.include?
            target.build_configurations.each do |config|
                config.build_settings['SWIFT_VERSION'] = '3.2'

Importing Library

To use the AirMap SDK within your code, add the following import statement:

import AirMap

Example Application

An example iOS and Mac App is available in the the features/rulesets branch of the AirMapSDK-Swift repository.

Example App Setup

Clone Repo

$ git clone
$ cd AirMapSDK-Swift
$ git checkout 2.0.0.beta.3

Install Dependencies

$ cd Example
$ pod install

Open the project

$ open AirMapSDK.xcworkspace

Configure AirMap

Download your application's airmap.config.json file from the AirMap Developer Portal and set the Mapbox access token.

Add the configuration file to the root of the project.

iOS Setup