Create an iOS app (Preview)

This article shows you how to add the Azure Maps to an iOS app. It walks you through these basic steps:

  • Setup your development environment.
  • Create your own Azure Maps account.
  • Get your primary Azure Maps key to use in the app.
  • Reference the Azure Maps libraries from the project.
  • Add an Azure Maps control to the app.

Prerequisites

Create an Azure Maps account

Create a new Azure Maps account with the following steps:

  1. In the upper left-hand corner of the Azure portal , select Create a resource.

  2. In the Search the Marketplace box, type Azure Maps.

  3. From the Results, select Azure Maps, then select the Create button that appears below the map.

  4. On the Create Maps Account page, enter the following values:

    • The Subscription that you want to use for this account.
    • The Resource group name for this account. You may choose to Create new or Use existing resource group.
    • The Name of your new account.
    • The Pricing tier for this account.
    • Read the License and Privacy Statement, and check the checkbox to accept the terms.
    • Select the Create button.

    Create an Azure maps account.

Get the primary key for your account

Once your Maps account is successfully created, retrieve the primary key that enables you to query the Maps APIs.

  1. Open your Maps account in the portal.

  2. In the settings section, select Authentication.

  3. Copy the Primary Key to your clipboard. Save it locally to use later in this tutorial.

Note

This quickstart uses the Shared Key authentication approach for demonstration purposes, but the preferred approach for any production environment is to use Azure Active Directory authentication.

Get the subscription key.

Create a project in Xcode

First, create a new iOS App project. Complete these steps to create a Xcode project:

  1. Under File, select New -> Project.

  2. On the iOS tab, select App, and then Next.

  3. Enter app name, bundle ID then select Next.

See the Creating a Xcode Project for an App for more help with creating a new project.

Create the first iOS application.

Install the Azure Maps iOS SDK

The next step in building your application is to install the Azure Maps iOS SDK. Complete these steps to install the SDK:

  1. With the desired Xcode iOS project selected in the Project navigator select the + button to Add package dependency.

    Add package dependency.

  2. Enter the following in the resulting dialog:

    • Enter https://github.com/Azure/azure-maps-ios-sdk-distribution.git in the search bar that appears in the top right corner.
    • Select Up to Next Major Version in the Dependency Rule field.
    • Enter 1.0.0-pre.1 into the Dependency Rule version field.

    Add dependency rule to an iOS project.

  3. Once the package alongside its dependencies is resolved, select the Add Package button to complete the dependency setup.

    Add package to an iOS project.

Add MapControl view

  1. Add custom UIView to view controller

  2. Select MapControl class from AzureMapsControl module

    Add an Azure maps control.

  3. In the AppDelegate.swift file you'll need to:

    • add import for the Azure Maps SDK
    • set your Azure Maps authentication information

Setting the authentication information on the AzureMaps class globally using the AzureMaps.configure(subscriptionKey:) or AzureMaps.configure(aadClient:aadAppId:aadTenant:) methods makes it so you won't have to add your authentication information on every view.

  1. Select the run button, as shown in the following graphic (or press CMD + R), to build your application.

    Run the iOS application.

Xcode will take a few seconds to build the application. After the build is complete, you can test your application in the simulated iOS device. You should see a map like this one:

Your first map on an iOS application.

Clean up resources

Take these steps to clean up the resources created in this quickstart:

  1. Close Xcode and delete the project you created.

  2. If you tested the application on an external device, uninstall the application from that device.

If you don't plan on continuing to develop with the Azure Maps iOS SDK:

  1. Navigate to the Azure portal page. Select All resources from the main portal page. Or, select the menu icon in the upper left-hand corner, then All resources.

  2. Select your Azure Maps account. At the top of the page, select Delete.

  3. Optionally, if you don't plan to continue developing iOS apps, uninstall Xcode.

Additional information

See the following articles for additional code examples: