Bing blogs

This is a place devoted to giving you deeper insight
into the news, trends, people and technology behind Bing.

Maps Blog

November
01

Virtual Earth Control URLs Changing

To provide a stable and predictable set of tools for our developers through the future, we are moving the all controls for Virtual Earth to a new location. The original control locations will be retired in the coming weeks to prepare for changes required by the Windows Live Local announcement.  Updating your applications now will prevent these changes from impacting your applications and ensure future changes have minimal impact as well.

The Standard Control, previously available at http://virtualearth.msn.com/js/MapControl.js, will be moved to a new home here:

http://dev.virtualearth.net/standard/v1/MapControl.js

The current version of the Commercial Control is also being migrated to the new location.  The new location of the files referenced in the Commercial Control SDK (which will be updated shortly to reflect the changing URLs) are now:

http://dev.virtualearth.net/commercial/v1/VE_MapSearchControl.js
http://dev.virtualearth.net/commercial/v1/VE_MapSearchControl.css

If your application references the old URLs, it is important that you update it as soon as you can to avoid changes to the Virtual Earth URL related to the Windows Live Local announcement from affecting your application.  The controls hosted at the new location are the same controls you are currently using, just hosted elsewhere—no other changes should be needed to your code base. 

If you have downloaded the control and are hosting it locally (not recommended), you should update your application to reference the new location as a static script reference in your application or it may also break when the old URL is retired.

We apologize for any inconvenience this causes; however, it is a necessary step in providing a stable, predictable developer platform moving forward.   As is true for many beta products, especially those built for developers, Virtual Earth is going through these changes to provide a more stable infrastructure than our earlier preview code provided.  As always, we will strive to minimize breaking changes, provide sufficient notification of those changes, and generally provide a good experience for our developers.  We thank you for your commitment to the Virtual Earth development platform, and look forward to sharing all the advances we are making with you and your customers.

Alex Daley
MapPoint Technical Evangelist

Update 1: If you are using the Standard Control and directly referencing the file "ve.js" on our servers in order to utilize the navigation controls, you will need to download and host that control locally to your site before the original control URLs are retired--it will not be hosted on dev.virtualearth.net.  I realize this is in direct contrast to the instructions about referencing the hosted controls on our servers, but this is a result of a design change instituted afte this first version was released.  As with the current commercial control, going forward, navigation controls will be embedded in the Map Control for simplicity.

Comments

  • My application references the old URLs, and so I'm going to update it now.