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 Windows Phone requires that you generate and provide a key when utilizing a Bing component.

The ArcGIS API for Windows Phone 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.

Getting a Bing Maps key

To get a Bing Maps key, you have the following choices:

• Using the Bing Maps Application Key from ArcGIS Server.
• Creating a key using the Bing Maps Portal.

Using the Bing Maps Application Key from ArcGIS Server

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.

Creating a key using the Bing Maps Portal

A key can also be created using the Bing Maps Portal by taking 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 or view keys page, enter 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. 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. If you previously used a Bing Maps token, you can remove any client or server logic to generate and apply the tokens.