Getting started with the WRLD iOS SDK
The WRLD iOS SDK is a framework for displaying beautiful, interactive 3D map views in Cocoa Touch apps for iPhone or iPad. Map views can be embedded into apps using iOS 8.0 or above, using Objective-C, or by simply hooking up in Xcode Interface Builder.
1. Sign up and get an API Key
If you don’t have an account yet, you will need to sign up for the Digital Twin plan and confirm your email address
Take note of the created key, you will need it soon
2. Get the WRLD iOS SDK
Requirements: XCode 7.3 or later.
Install using CocoaPods
- Install CocoaPods.
Create a Podfile in the root folder of you app project (replacing ‘MyAppTargetName’ as appropriate for your app)
platform :ios, '8.0' target 'MyAppTargetName' do pod 'WRLD' end
- In Terminal, run
pod install. This will download the SDK and create an
xcworkspacefile. Open this file in Xcode.
Install using direct download
- From the latest GitHub release page, download the
- In Xcode, select your app’s project in Project Navigator to display Project Editor. Select the app’s target, then on the
Generaltab, find the
- Unzip the
wrld-ios-sdkzip file and drag
Embedded Binariessection. Check “Copy items if needed” in the resulting dialog box, then click “Finish”. This links the WRLD.framework with your project.
3. Use a map view in your app
To provide your app with an API key, in Xcode, open your app’s
Info.plist file (select it in the Project Navigator).
Add an entry with the columns set as follows:
- Value: [your api key]
See our walkthrough guide for simple step-by-step instructions.
4. Add some features
Now that you have your first map, let’s add some features to it!
Take a look at some of our examples to get up and running:
The WRLD iOS SDK is undergoing active development - we will be expanding with further features and improvements.
The example GitHub repository contains an open-source iOS app that illustrates the API features.
Got a question?
Feel free to email us at
firstname.lastname@example.org or use our Messenger to chat to us directly!
Got a feature request, or found a bug?
Feel free to submit to the WRLD iOS SDK issue tracker on GitHub.