GuidesFlutter API ReferencesHERE SDK for Android API referencesHERE SDK for iOS API references
v4.25.5-0
Guides
Start typing to search…
  1. HERE SDK for iOS Developer Guide

Get started

This topic helps you get started with the HERE SDK. Follow the instructions to:

  • Get credentials for using the HERE SDK.
  • Download the HERE SDK package
  • Run a basic HERE SDK-powered example app in an emulator on your machine.

Get credentials (Explore and Navigate)

You can use the HERE SDK (Explore) right away by signing up to the HERE Base Plan. With the Navigate license, you’ll need extra onboarding steps before your credentials are active. Not sure which license fits your needs? See the overview of licenses and choose the right pricing plan with your HERE Account Executive.

To use the HERE SDK, you must register at least one app and obtain OAuth 2.0 credentials (Access key ID and Access key secret).

  1. Sign up to the HERE Base Plan and get access to the HERE platform portal.
  2. Sign in to the HERE platform portal.
  3. Follow the steps in Authorization via OAuth to get OAuth2 credentials. Note: You only need the OAuth 2.0 credentials. You do not need to install the OLP CLI and get a token.
  4. The credentials are always tied to the Application ID. Keep this handy if you need to contact the HERE support team.

Download the HERE SDK (Explore) package

The credentials you created in the previous step are valid for the Explore package, so you’re ready to go right away:

Download the HERE SDK (Explore) package and start building apps!

Download the HERE SDK (Navigate) package

Contact us to get access. The Navigate package is only available for customers who have signed a contract with HERE Technologies.

Note

While you wait for access, you can already start with the HERE SDK (Explore), which provides a subset of the same APIs and features.

Once you got access, proceed with the steps below:

  • Use the Application ID to accept the quote in the Sales portal. Before you accept the quote your credentials will not work with Navigate and you will not be able to download Navigate package. If you need help with this step, contact your HERE Account Executive.
  • The previous step enables you to download the HERE SDK (Navigate) package.

Now you are ready to start building apps with the Navigate license!

Contents of the HERE SDK package

The HERE SDK package contains:

  • The heresdk.xcframework which contains the HERE SDK binaries to include in your app.
  • Several documentation assets including this guide, the API Reference and the example apps.
  • The HERE_NOTICE file that must be included in any app created with the HERE SDK. See the open source notices to learn more.

The binary is a natively compiled SDK. Since the Explore binary is a subset of the Navigate binary, the Navigate binary works with all Explore example apps, but not always vice versa. APIs that are exclusive to Navigate are not included in the Explore binary. Likewise, the changelog and API Reference are tailored to each license, matching the corresponding binary.

Your credentials can be used with all example apps you can find in the HERE SDK package and on GitHub for your license. If you have a Navigate license, your credentials work with every app and feature. If you have an Explore license, your credentials also work with all apps, but some features that require the Navigate license will be unavailable.

Run the Hello Map example app

The example apps included in the HERE SDK release package and available on GitHub provide a comprehensive preview of the HERE SDK's capabilities. To get started, run the basic HelloMap example in the emulator. Follow these steps:

  1. Install Xcode. To download, visit this page.
  2. Unpack the HERE SDK release package you downloaded from the HERE platform portal.
  3. Unpack the archive with example apps. Its name ends with examples-VERSION_NUMBER.zip.
  4. Copy the heresdk.xcframework folder to your app's root folder.
  5. Run Xcode by double-clicking on the project file HelloMap/HelloMap.xcodeproj.
  6. In Xcode, open the file HelloMap/HelloMap/HelloMapApp.swift.
  7. Inside this file, replace the placeholders in the following code with your credentials:
// Set your credentials for the HERE SDK.
let accessKeyID = "YOUR_ACCESS_KEY_ID"
let accessKeySecret = "YOUR_ACCESS_KEY_SECRET"
let authenticationMode = AuthenticationMode.withKeySecret(accessKeyId: accessKeyID,
                                                          accessKeySecret: accessKeySecret)
let options = SDKOptions(authenticationMode: authenticationMode)
  1. Select the play button to build and run the "HelloMap" app.

You can now see an app displaying a HERE map running in the Xcode simulator. Alternatively, you can run the app on your preferred iOS device.

It's time to experiment with the code! For example, try modifying the example by replacing MapScheme.normalDay in the loadScene(...) method found in the MapViewUIRepresentable class with MapScheme.satellite. You can also try other map schemes or explore some of the available map layers.

"HelloMap" example running in an emulator.

See Integrate the HERE SDK to learn how to initialize the SDKNativeEngine and to learn about the basic building blocks of an app created with the HERE SDK.

Building multiple apps

When you plan to use the same credentials for multiple apps, you need to set a scope to differentiate your apps.

Next steps

Updated 4 hours ago