Creating an Azure Maps subscription key

To get an Azure Maps Subscription Key, you must first have an Azure account and a valid subscription. The key is generated when you create an Azure Maps Account (Resource) in the Azure Portal.

Set Up an Azure Account #

If you do not already have an Azure account and a subscription, you must create one first.

1. Create a Microsoft Account: If you don’t have a Microsoft account (Outlook, Hotmail, or a corporate Microsoft 365 account), you’ll need one.
2. Get an Azure Subscription:
   • Navigate to the Azure Pricing page
   • Choose your preferred option:
     • Azure Free Account: Best for evaluation. Includes credit and free amounts of select services. Requires a credit card for identity verification, but you won’t be charged unless you explicitly upgrade.
     • Pay-As-You-Go: For immediate production use.

Create the Azure Maps Resource #

Once you have an active Azure subscription, you can create the Maps resource which contains your key.

1. Go to the Azure Portal
2. Sign in with your Microsoft account credentials.
3. Create a new resource, by clicking on the “+ Create a resource” button in the upper-left corner.
4. Search for Azure Maps and Create the Maps resource.
5. Complete the Resource Creation form to complete the process.

Getting Your Primary Key #

Once the resource is deployed, you can find your key within the resource settings.

1. From within the Azure Portal click on Go to Resource link to view the new resource.
2. On the left-hand menu navigate to Settings > Authentication.
3. Copy the Primary Key
4. Add this key within our settings area under Maps > Settings > Azure Subscription Key.

With this complete, your key should be installed and your maps should be fully functional. You will see tileset previews working as expected, along with any Azure specific engine features.