Deprecated: Microsoft has retired Bing Maps for Enterprise. New Bing Maps accounts are no longer available, free (Basic) keys stopped working on June 30, 2025, and Enterprise keys stop working on June 30, 2028. The Bing Maps control is no longer updated. We recommend switching to Azure Maps: see Configure Azure Maps Autocomplete on Dataverse Forms. This article remains available for existing Bing Maps customers.
This article explains how to add the Sharp XRM Bing Maps Autocomplete control to a Microsoft Dataverse model-driven form. These steps must be done by an administrator or a user with system customization privileges.
Configure Bing Maps Autosuggest on a model-driven form
To keep the example simple, we use the Account table and its Address 1 columns. The configuration is the same for other tables and columns, standard or custom.
Before you start, you need an API Configuration record for Bing Maps (see Set up your Bing Maps API key).
- In the Power Apps Maker Portal, select the environment where Address Validation for Dataverse is installed. Go to Tables > Account > Forms (or open the table from your solution) and open the main form you want to use.
- In the form designer, select the Address 1: Street 1 column. You can also find it with Tree view. In the properties pane, select Hide label.
- In the properties pane, expand Components and select + Component.
- In Add component, select Sharp XRM - Bing Maps Autocomplete. If it isn't listed, select Get more components, add the control, and then select it.
- Configure the control properties described in the table below. For API Configuration Name and Advanced Settings ID, enter a static value. For each address property, select the table column where the value should be stored.
- Under Show component on, select where the control should be used (Web, Mobile, Tablet) and select Done.
- Select Save and publish, then open an account record to test the control.
Control properties
| Property | Description | Value type |
|---|---|---|
| API Configuration Name * | The unique name of your Bing Maps API Configuration record. | Static value |
| Advanced Settings ID | If you use Address Control Settings, the Identifier of your setting record. | Static value |
| Configuration Cache Hours | Optional. How long the API configuration is cached in the browser, in hours (1 to 168, default 24). | Static value |
| Street * | Column to store the street address. This is the column the control is placed on. | Single line of text |
| Unit number | Column for the unit or suite number. Bing Maps does not return unit numbers; you can leave this empty. | Single line of text |
| City * | Column to store the city. | Single line of text |
| State * | Column to store the state or province. | Single line of text |
| Zip / Postal code | Column to store the postal code. | Single line of text |
| Country * | Column to store the country. The long name is used by default; see Advanced Settings for ISO2. | Single line of text |
| County | Column to store the county, when returned. | Single line of text |
| Full address | Optional column for the complete formatted address. | Single line of text |
| Latitude | Column to store the latitude. | Floating point number |
| Longitude | Column to store the longitude. | Floating point number |
| Display Address Fields | Legacy option. Set it to No and add the individual address columns to the form. | Yes / No |
* Required.
Working with Advanced Settings
- In the Address Validation for Power Apps app, go to Settings > Address Control Settings and select + New.
- Enter a unique Identifier. This is the value you enter in the control's Advanced Settings ID property.
- Set API Type to Bing Maps and choose the parameters below.
| Parameter | Possible values | Description |
|---|---|---|
| Country Display | Use ISO2 Country Code / Use ISO3 Country Code / Use Long Country Name | For example, CA or Canada. ISO3 is not available with Bing Maps; selecting it returns the ISO2 code. |
Note: Address Control Settings are cached in each user's browser and refresh automatically when the cached copy expires. To apply a change immediately, users can clear their browser cache.
Visual example in a model-driven form
Assign the required security privileges to users
After configuration, assign the required security roles to users so they can use the autocomplete controls. See Assign privileges for users.