Samples demonstrating how to use the WRLD iOS API to display beautiful, interactive 3D maps on iOS devices.
- Xcode (version 7.3 or later)
- CocoaPods
- A WRLD API key
- In root of repo, run
pod installto setup dependencies using CocoaPods. open api-samples.xcworkspaceto open the generated Xcode workspace.- Place your WRLD API key in the Info.plist file for each example app. See 'Set your WRLD API key' below for details.
You will see two schemes in the project:
- HelloWorld - this is a minimal app, demonstrating how to drop a WRLDMapView into your app using Interface Builder.
- ApiSamples - this app contains a collection of samples, each illustrating an individual API feature.
Select the active scheme for the app you want to build in Xcode, then build and run the app.
In order to run these samples, you need to sign up for a free developer account at https://www.wrld3d.com/developers. Then create an API key to use in your apps.
These example apps read the API key from their Info.plist file. Set the value of the 'WrldApiKey' entry with the API key that you have just created.
See:
- https://github.com/wrld3d/ios-api-example/blob/master/HelloWorld/Info.plist#L47
- https://github.com/wrld3d/ios-api-example/blob/master/ApiSamples/Info.plist#L47
If you are creating a new app, or integrating WRLD 3D Maps into an existing app, the API key should be present in the main bundle info dictionary for the key "WrldApiKey" at the time the WRLDMapView is created.
For more detailed information, see the API documentation and API examples.
We also have step-by-step instructions on how to integrate a WRLD map view into your app.
Questions, comments, or problems? All feedback is welcome - just create an issue.
These samples use the WRLD iOS SDK, available via CocoaPods.
The source for the SDK is available at https://github.com/wrld3d/ios-api
These samples are released under the Simplified BSD License. See the LICENSE.md file for details.