Skip to main content

How to procure Azure Map Keys

To add Azure Map as a service provider in Maptaskr, you must first have credentials configured via the Azure Portal. We'll go over the step-by-step guide on establishing a new key for use within Maptaskr.

note

This document is accurate as of 28th February 2025, UI/UX and names of resources are subject to change at Microsoft's discretion.

Also note that Azure Maps is fully functional from version 2.2.3.4 onwards, which you can find in our Releases Page

  1. Log-on to the Azure Portal
  2. On the home page, click Create a resource
    alt text
  3. Click See more in All services
    alt text
  4. Search for Azure Maps Accounts and select the option shown in the image below
    alt text
  5. Click Create
    alt text
  6. Populate the details for creating the service, including a Resource Group. Region only affects metadata capabilities, and any can be selected here. Click Next
    alt text
  7. Give the allowed origins list a value that suits your requirements, such as the URL of the D365 environment that will be using this key. In our example we have set a * wildcard value for demonstration purposes.
    alt text
  8. The rest of the setup can be skipped to the Review + Create step, unless you require more configuration specific to your needs. Then click Create. The procerement of the resource may take a few minutes.
  9. Once the procurement initiates, it'll automatically redirect you to the resources deployment page. When the deployment is complete, you will be prompted to go to the resource. Once prompted, go to the resource.
  10. Once you are in the Azure Maps Account resource, open the authentication tab and copy your primary key value.
    alt text
  11. Go to the Maptaskr model-driven-app and open Configuration -> Manage Providers tab -> Add Provider -> Select Azure Maps from the dropdown -> Paste your primary key into the Azure Maps Key input box and click Add or Update.
    alt text
  12. Now let's go into the Maptaskr Dashboard and verify that our base map and geocoding is functioning. We should be able to see a map, and the search panel should auto-suggest addresses based on our input:
  13. That's it! Azure Maps is now configured and can be used for the following services:
    • Base Map View
    • Satellite Map View
    • Geocoding
    • Routing
    • Address Searching