====== How to Use Bing Maps in Map Suite Desktop (WPF) Edition======

This guide helps you to create a bing maps key and apply it in Map Suite. 


Basically, there are two types of bing maps keys. One is Basic Key, and the other one is Bing Maps Enterprise Key. ( see picture 1 below ) 

{{:bingmapkeys.png?850|picture 1}}



=== How to Create a Basic Key ( Notice: This key is only for developing/testing purpose. )  ===

  - Go to the [[https://www.bingmapsportal.com/|Bing Maps Dev Center]].
  - Log in with your Microsoft account. ( Note: If you do not have one, create one then log in. ) 
  - Click My Account and select My keys. 
  - Select the options to create the key. ( Note: If you already have an existing key, you may use that key. )

Read [[https://msdn.microsoft.com/en-us/library/ff428642.aspx|more details]] about how to create a new key. 


=== How to Create a Bing Maps Enterprise Key ===

  - Go to [[https://www.microsoft.com/en-us/maps/licensing/#request-quote|the licensing page]] to read more and get a quote.


=== How to Use Bing Maps Key in Map Suite Desktop Edition ===

The BingMapsTileOverlay will work after assigning your Bing Maps Key to the property BingMapsOverlay.ApplicationId. Here below is how to do that in a sample. 

  - Download [[source code link will be in here|Sample Source Code]] and open it in Visual Studio.
  - Open MainWindow.xaml.cs and replace the value in the appropriate field. ( see the code sample below )
  - Restore NuGet Packages, build and run the sample. 


=== Code Usage ===

    // Create a BingMapsTileOverlay and add it to wpfMap1
    BingMapsTileOverlay bingMapsOverlay = new BingMapsTileOverlay();
    bingMapsOverlay.MapStyle = BingMapsMapType.AerialWithLabels;
    bingMapsOverlay.ApplicationId = "Place Bing Maps Key Here";
    wpfMap1.Overlays.Add(bingMapsOverlay);

\\