Migration Guide Bing Maps V7 to V8 Bing Maps V7 to V8 Migration Guide Contents 1.0 Introduction ............................................................................................................................................ 4 1.1 Why Bing Maps v8? ............................................................................................................................. 4 1.2 Suggested Migration Plan ................................................................................................................... 5 1.3 Technical Resources ............................................................................................................................ 5 2.0 What’s New in Bing Maps V8 .................................................................................................................. 6 2.1 Map Script URL .................................................................................................................................... 6 2.2 Asynchronous load the Map ............................................................................................................... 7 2.3 Release Branches ................................................................................................................................ 7 2.4 Localization ......................................................................................................................................... 8 2.5 Key New Features ............................................................................................................................... 8 3.0 Breaking Changes from Bing Maps V7 .................................................................................................. 12 3.1 Deprecated Modules......................................................................................................................... 12 3.2 Deprecated Classes ........................................................................................................................... 12 3.3 Deprecated Class Function, Properties or Events ............................................................................. 14 3.4 Breaking Class Function or Property Changes .................................................................................. 18 3.5 Custom HTML Pushpins .................................................................................................................... 18 3.6 EntityCollection deprecation ............................................................................................................ 20 3.7 Infobox Breaking Change .................................................................................................................. 21 3.8 Map Center Offset Workaround ....................................................................................................... 22 4. 0 Code Optimizations in V8 ..................................................................................................................... 23 4.1 Loading the Map ............................................................................................................................... 23 4.2 Adding an array of shapes to the map .............................................................................................. 23 4.3 Changing the Color of the Pushpins .................................................................................................. 24 4.4 Setting the Color of a Polygon or Polyline ........................................................................................ 25 4.5 Getting the Location of a Mouse Event ............................................................................................ 25 4.6 Adding Events to an Array of Shapes ................................................................................................ 26 4.7 Polygons with holes .......................................................................................................................... 26 4.8 Loading Multiple Modules ................................................................................................................ 28 4.9 Adding Tile Layers to the Map .......................................................................................................... 28 4.10 Bing Maps REST Services ................................................................................................................. 30 Bing Maps V7 to V8 Migration Guide 5.0 Bing Maps V7 Modules CodePlex Project support ............................................................................... 32 6.0 Additional Bing Maps Tips ..................................................................................................................... 34 6.1 Optimizing Transactions with the REST services ............................................................................... 34 6.2 Data Tips & Tricks .............................................................................................................................. 34 6.3 Determining a User’s Location .......................................................................................................... 35 7.0 Useful Tools & Support ......................................................................................................................... 38 7.1 Migration Support ............................................................................................................................. 38 7.2 Bing Maps Blog .................................................................................................................................. 38 Appendix A: Fiddler Redirect test ............................................................................................................... 39 Bing Maps V7 to V8 Migration Guide 1.0 Introduction This guide is designed to support you in your Bing Maps migration from version 7 to version 8. This resource provides detailed comparisons between the JavaScript API of these two versions of Bing Maps as well as comparative code samples, migration suggestions and best practices for migrating your code to the newest version of Bing Maps. As you read this document you should gain an understanding of the benefits of Bing Maps v8 and how to leverage it in your existing mapping applications. 1.1 Why Bing Maps v8? The version 7 of Bing Maps has been around for over 6 years. Version 8 of Bing Maps was just recently released and offers numerous advantages over v7, many of which are highlighted in section 2.0 What’s New in Bing Maps V8 of this document. The Bing Maps v8 web control is the recommended migration path from v7. Version 8 is over 80% backwards compatible with the v7 control which should help minimize the effort involved in migrating apps. The Bing Maps V8 control contains several new innovative features and functionalities and there is a well laid out roadmap for bring new features to V8 on a regular basis. Faster and more fluid map control When it comes to performance the v8 is miles ahead of v7. Version 8 is capable of rendering data much faster than versions 7, and can also render a lot more data too. When dealing with small data sets on a standard browser this might not be that noticeable but if you need to display a large data set or are using a mobile browser this increased performance makes a big difference. Increased culture support Version 7 supported 22 different culture codes (languages). Version 8 supports significantly more culture codes and uses the Bing Maps REST services to perform geocode and route requests which has support for 117 languages. Many new features Over the years Bing Maps customers and developers have requested number of new features and functionalities. Many of these are now available in v8. Some of the most notable one’s being; Bing Maps V7 to V8 Migration Guide 1.2 Suggested Migration Plan To assist you with planning, we have compiled this list of high‐level steps to use as a baseline plan to move your codebase and development practices to version 8 equivalents. While your ultimate plan will depend on your specific situation, the following steps outline suggested components of any effort: 1) Review existing application and identify where Bing Maps v7 code is being used. 2) As an option, before touching any code test your existing app against version 8 as it is by using the steps outlined in Appendix A: Fiddler Redirect test 3) Identify which features of Bing Maps v7 are being used and review the migration information in this document. 4) Migrate code to version v8 of Bing Maps and update script reference to point to the new v8 map control URL. 5) Test your migrated application. 6) Deploy your application to your production environment. 1.3 Technical Resources Here is a list of useful technical resources for the Bing Maps v8 web control. Bing Maps v8 Interactive SDK Bing Maps v8 documentation Bing Maps MSDN documentation (All Bing Maps APIs) Bing Maps MSDN Forums Bing Maps Dev Center Bing Maps REST Services (MSDN) Bing Spatial Data Services (MSDN) Bing Maps Terms of Use Bing Maps V7 to V8 Migration Guide 2.0 What’s New in Bing Maps V8 The Bing Maps v8 control reduces development time by requiring less code to implement more features into your app. It also brings significance performance improvement by using the HTML5 canvas, which provides the ability to render vector data over 10 times faster than previous versions of Bing Maps. It also supports rendering thousands of more shapes, allowing users to view more data and gain