SDK for iOS 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 13.0 and the iOS 16 SDK. For more details, see System Requirements.

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

Acquire HERE SDK Credentials

Before working with HERE SDK you need to acquire a set of credentials by registering your application on Each application requires a unique set of credentials. For the available authentication options, see the Identity & Access Management Developer Guide.

Launch the Project Using Cocoapods

You can start trying a sample SDK for iOS 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 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 temporary location. For more information on using CocoaPods in an Xcode project, see Create a Simple App Using 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.

App credential strings are located in HelloMapAppDelegate.m file with the following labels:
  • kHelloMapAppID
  • kHelloMapAppCode
  • kHelloMapLicenseKey

Launch the Project from the Downloaded SDK for iOS Package

You can also open a sample project from SDK for iOS 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.