Bing Maps overview

Bing Maps offers access to rich map imagery and data as well as robust search, location, and routing services. Access to the Bing services platform requires explicit registration with Microsoft. The subsequent use of Bing services in the ArcGIS API for WPF requires that you generate and provide a key when utilizing a Bing component.

The ArcGIS API for WPF uses Bing Maps imagery, geocoding, and routing services via a set of proxy classes in the ESRI.ArcGIS.Client.Bing library—namely, the TileLayer, Geocoder, and Routing classes, respectively. Each class has a Token property that is set to a Bing Maps key. Bing Maps keys can only be used with Bing Maps production services and they do not expire. The key is included in each request to a Bing Maps service to authorize access.

Note:

Although the Token property can be set to a valid token generated by a Bing Maps token service for either the production or staging environment, the Bing token and staging service architecture has been deprecated, and as a result you should use Bing Maps keys going forward. A Bing Maps key is similar to a token, but it does not expire and is associated with a specific application name and URL.

ArcGIS Server version 10.0 and later comes with a Bing Maps Application Key. You can access the key using the following steps in Manager:

1. Log in to Manager.
2. On the left pane, click Services > Settings.
3. Find the Bing Maps Key section of the panel and click View Bing Maps Key.
4. Add the user name and password of an account that is an administrator on the web server where Manager is installed, and belongs to the agsadmin operating system group on the server object manager (SOM) machine.
5. Copy the Bing Maps key into a text editor program, such as Notepad, so that you can use it later when adding Bing Maps to your applications.

Alternatively, you can create a key using the Bing Maps Portal by doing the following steps:

1. In a browser, navigate to Bing Maps Account Center.
2. Create or use a Windows Live ID to log in.
3. On the "Create and view Bing Maps keys" page, add an application name and URL to create a key. Currently the name and URL are not validated.
4. Copy the key, which is available on the same page and use it to set the Token property, or apply the token in the proxy class constructor and a Bing component in the ArcGIS API for WPF. See the topic on Using Bing Imagery, Geocode, and Route services for more information.
5. Run your application. It functions without requiring you to generate new tokens and updates the Token property on a regular basis. As a result, you can remove any client or server logic to generate and apply Bing Maps tokens.