Create your Azure Maps account using an ARM template

You can create your Azure Maps account using an Azure Resource Manager (ARM) template. After you have an account, you can implement the APIs in your website or mobile application.

A resource manager template is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. The template uses declarative syntax. In declarative syntax, you describe your intended deployment without writing the sequence of programming commands to create the deployment.

If your environment meets the prerequisites and you're familiar with using ARM templates, select the Deploy to Azure button. The template will open in the Azure portal.

Deploy to Azure

Prerequisites

To complete this article:

  • If you don't have an Azure subscription, create a free account before you begin.

Review the template

The template used in this quickstart is from Azure Quickstart Templates.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "accountName":{
            "type": "string",
            "defaultValue": "[uniqueString(resourceGroup().id)]",
            "metadata": {
                "description": "The name for your Azure Maps account. This value must be globally unique."
            }
        }, 
        "pricingTier": { 
            "type": "string", 
            "allowedValues":[ 
                "S0", 
                "S1", 
                "G2"
            ], 
            "defaultValue": "G2",
            "metadata": { 
                "description": "The pricing tier for the account. Use S0 for small-scale development. Use S1 or G2 for large-scale applications." 
            } 
        }, 
        "kind": { 
            "type": "string", 
            "allowedValues":[ 
                "Gen1", 
                "Gen2" 
            ], 
            "defaultValue": "Gen2", 
            "metadata": { 
                "description": "The pricing tier for the account. Use Gen1 for small-scale development. Use Gen2 for large-scale applications." 
            } 
        } 
    }, 
    "resources": [
        {
            "name": "[parameters('accountName')]",
            "type": "Microsoft.Maps/accounts",
            "apiVersion": "2021-02-01",
            "location": "global",
            "sku": {
               "name": "[parameters('pricingTier')]"
            }, 
            "kind" : "[parameters('kind')]" 
        }
    ]
}

The Azure Maps account resource is defined in this template:

Deploy the template

  1. Select the following image to sign in to Azure and open a template. The template creates an Azure Maps account.

    Deploy to Azure

  2. Select or enter the following values.

    ARM template deploy portal

    Unless it's specified, use the default value to create your Azure Maps account.

    • Subscription: select an Azure subscription.
    • Resource group: select Create new, enter a unique name for the resource group, and then click OK.
    • Location: select a location.
    • Account Name: enter a name for your Azure Maps account, which must be globally unique.
    • Pricing Tier: select the appropriate pricing tier, the default value for the template is S0.
  3. Select Review + create.

  4. Confirm your settings on the review page and click Create. After your Azure Maps has been deployed successfully, you get a notification:

    ARM template deploy portal notification

The Azure portal is used to deploy your template. You can also use the Azure PowerShell, Azure CLI, and REST API. To learn other deployment methods, see Deploy templates.

Review deployed resources

You can use the Azure portal to check your Azure Maps account and view your keys. You can also use the following Azure CLI script to list your account keys.

az maps account keys list --name MyMapsAccount --resource-group MyResourceGroup

Clean up resources

When no longer needed, delete the resource group, which also deletes the Azure Maps account. To delete the resource group by using Azure CLI:

az group delete --name MyResourceGroup

Next steps

To learn more about Azure Maps and Azure Resource Manager, continue on to the articles below.