HERE iOS SDK Developer's Guide

Run the Sample Application

This tutorial provides instructions on how to run the Objective-C and Swift sample applications to render a map on an iOS device. The tutorial assumes you are using Xcode 9 and the iOS 11 SDK. For more details, see System Requirements.

Tasks for this basic application include:
  • Check HERE Credentials.
  • Launch the sample project using CocoaPods or manually from the package.

Acquire HERE SDK Credentials

Before working with with HERE SDK, you need to acquire a set of credentials by registering your application on Each application requires a unique set of credentials.

Launch the Project Using Cocoapods

You can start trying a sample HERE iOS SDK project by using Cocoapods. CocoaPods is an open source dependency manager for Objective-C and Swift Xcode projects. To get started with using CocoaPods on macOS, follow the instructions in the Getting Started guide on

Once you have configured CocoaPods in your development environment, try the tutorial project by using the following command.

pod try HEREMaps
Note: This command is only intended for product demonstration purposes. It only puts the HERE SDK in a tempoary location. For more information on using CocoaPods in a Xcode project, see Create a Simple App Using the HERE SDK.

After invoking this command, you are prompted to choose between an Objective-C or a Swift sample project. Make a selection, and the script opens a project in Xcode, with HERE SDK dependencies already configured. You can then follow the instructions in the project README.txt to add app credentials and run the app.

Launch the Project from the Downloaded HERE iOS SDK Package

You can also open a sample project from the HERE iOS SDK package, which you can download from The Xcode projects are available in the sample-apps folder. To run the project, double-click on HelloMap.xcodeproj or SwiftHelloMap.xcodeproj, then follow the instructions in the README.txt file.