quick-ios-app.md

title	description	author	ms.author	ms.date	ms.topic	ms.service	services	ms.custom
Create an iOS app	Steps to create an Azure Maps account and the first iOS App.	stevemunk	v-munksteve	11/23/2021	quickstart	azure-maps	azure-maps	mode-other

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 by signing into the Azure portal . If you don't have an Azure subscription, create a free account before you begin.
• Make an Azure Maps account
• Obtain a primary subscription key , also known as the primary key or the subscription key. For more information on authentication in Azure Maps, see manage authentication in Azure Maps .
• Download ‎Xcode on the Mac App Store for free.

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.

   

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.

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.

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.

   

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.

   

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

   

Add MapControl view

1. Add custom UIView to view controller

2. Select MapControl class from AzureMapsControl module

   

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.

   

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:

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:

• Manage authentication in Azure Maps
• Change map styles in iOS maps
• Add a symbol layer
• Add a line layer
• Add a polygon layer