Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Getting a Bing Maps Key

Bing

To use the Bing Maps APIs, you must have a Bing Maps Key.

Ff428642.note(en-us,MSDN.10).gifNote:
When you use the Bing Maps APIs with a Bing Maps Key, usage transactions are logged. See Viewing Bing Maps Usage for more information.

Creating a Bing Maps Key

You can create two Bing Maps Keys. If you require additional keys, contact Bing Maps for Enterprise to become an enterprise customer.

Note: The Bing Maps Key system was updated in July, 2012. If you created a key in the previous system, it was automatically migrated. For more details, see the Key Migration table.

  1. Go to the Bing Maps Account Center at https://www.bingmapsportal.com.

    • If you have a Bing Maps Account, sign in with the Windows Live ID that you used to create the account.

    • If you do not have a Bing Maps Account, click Create, and follow the instructions in Creating a Bing Maps Account.

  2. Select Create or view keys under My Account.

  3. In the Create key box on the My keys page, provide the following information for the application that will use the Bing Maps key:

    • Application name: Required. The name of the application.

    • Application URL: The URL of the application.

    • Key type: Required. Select the key type that you want to create. The key and application types you choose determine your usage limits. For more information, see the Bing Maps Terms of Use.

      Key Type Description

      Trial

      Trial keys are used for evaluation during a 90 day evaluation period and must not exceed 10,000 transactions of any type in any 30 day period.

      Basic

      Basic keys are used for non-trial applications that do not exceed 50,000 transactions of any type within a 24 hours period and comply with the limits of the application type as defined by the Bing Maps Terms of Use.

      Enterprise

      Enterprise keys are used for enterprise accounts only with a separately executed, valid Bing Maps agreement in place. Enterprise keys are required for enterprise applications in production.

      To become an enterprise customer, contact Bing Maps for Enterprise.

    • Application type: Required. Select the application type that best represents the application that will use this key.



      Trial Key Application Types



      Note that trial keys expire after 90 days. When you view map keys, trial keys that are expiring in 30 days or less are shown in orange font and trial keys that have expired are shown in red.

      Application Type [Trial] Description

      Public website

      For evaluation of an Application that is/will be a public website. The trial key will expire after 90 days.

      Private website

      For evaluation of an Application that is/will be a private website that is available to authenticated users on a private network. The trial key will expire after 90 days.

      Mobile

      For evaluation of an Application that is/will be available as a mobile application (see definition of Mobile App in Terms of Use) and will operate within the terms and limits described in the Terms of Use. The trial key will expire after 90 days.

      Windows Store app

      For evaluation of an Application that is/will be available as a Windows Store app and will operate within the terms and limits described in the Terms of Use. The trial key will expire after 90 days.

      Business asset management

      For evaluation of an Application that is/will be used to track, query (including reverse-geocoding), display, or perform calculations using an asset’s GPS position. The trial key will expire after 90 days.

      Education

      For evaluation of an Application that is/will be a public website that belongs to an educational institution or is used for instructional non-commercial use (e.g., for teaching purpose). The trial key will expire after 90 days.

      Not-for-profit

      For evaluation of an Application that is/will be a public website that belongs to a charitable or other non-profit organization with tax-exempt status. The trial key will expire after 90 days.



      Basic Key Application Types

      Application Type [Basic] Description

      Public website

      Application is a public website that is available without restriction, and does not exceed 125,000 sessions or 500,000 transactions of any type within a 12 month period.

      Mobile

      Application that is/will be available to consumers as a mobile application (see definition of Mobile App in Terms of Use) and will operate within the terms and limits described in the Terms of Use.

      Windows Store app

      Application is a Windows Store app that is available to consumers or available internally for free instructional non-commercial use.

      Education

      Application is a public website that belongs to an educational institution or is used for instructional non-commercial use (e.g., for teaching purpose).

      Not-for-profit

      Application is a public website that belongs to a charitable or other non-profit organization with tax-exempt status.



      Enterprise Key Application Types

      Ff428642.note(en-us,MSDN.10).gifNote:
      Enterprise keys are required for enterprise applications in production.

      Application Type [Enterprise] Description

      Public website

      Application is a public website that is available without restriction.

      Private website

      Application is a private website that is available to authenticated users on a private network.

      Mobile

      Application is a mobile app that is publicly available or used by authenticated enterprise users (employees or agents of the enterprise) as a mobile application and will operate within the terms and limits described in your separately executed Bing Maps Agreement.

      Windows Store app

      Application is a Windows Store app that is publicly available or is used by authenticated enterprise users (e.g., employees or agents of the enterprise) over private network or otherwise exceeds the limits associated with the Basic Key.

      Business asset management

      Application that is/will be used to track, query (including reverse-geocoding), display, or perform calculations using an asset’s GPS position.




      Legacy Application Types

      If you have created keys that prior to this key system, you may also see keys with the following key type.

      Legacy Application Type

      Enterprise (Legacy)

      This application type is shown for keys that were created before the latest set of enterprise application types were defined.

  4. Type the characters of the security code, and then click Submit. The new key displays in the list of available keys. Use this key to authenticate your Bing Maps application as described in the documentation for the Bing Maps API you are using.

Upgrading Your Account

If you want to upgrade your account to be an enterprise account, contact Bing Maps for Enterprise.

Bing Maps Terms of Use

Key Migration

In July, 2012, Bing Maps updated the Bing Maps Key system. Existing keys were automatically be moved to this new system according to the following table.

Previous Key Type New Key Type New Application Type

Evaluation/Trial

Trial

Public website

Windows Metro style apps (BETA)

Trial

Windows Store app*

Developer

Basic

Public website

Broadcast

Basic

Broadcast

Mobile

Basic

Mobile

Not-for-profit

Basic

Not-for-profit

Education

Basic

Education

Enterprise

Enterprise

Enterprise (Legacy)

This application type is only for migrated keys and is not available in the new system.

Note: *Legacy “Windows Metro style apps (BETA)” keys were migrated to “Windows Store app” keys and expired on Jan 15, 2013. Any new Trial key created after Jul 26, 2012 with an application type of “Windows Store app” will expire after 90 days.

Usage Transactions

When you use the Bing Maps APIs with a valid Bing Maps Key, usage transactions are logged.

You can view detailed reports of your Bing Maps usage in the Bing Maps Account Center. For more information, see Viewing Bing Maps Usage.

Show:
© 2014 Microsoft. All rights reserved.