Bing Maps AJAX Control Troubleshooting and Support

  • Article

You are not viewing the latest version of the AJAX control. Bing Maps AJAX V7 is the recommended JavaScript control for Bing Maps. If you need this documentation, it is available in as a CHM or PDF download.

This topic contains information about common problems that arise when developing applications using the Bing Maps AJAX Control 6.3.

  • Rendering Issues

  • Supported Browsers

  • Proxy Authentication Errors

  • Printing Issues

  • Bing Maps Developer Resources and Support

Rendering Issues

The following solutions may help if you are experiencing issues downloading or rendering the map control.

  • If the map control is not downloading properly, the script tag src attribute of your page may not be set correctly. Make sure you are referencing the map control correctly using https://ecn.dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.3.

  • If the map is not rendering properly, note that version 6.0 and higher of the map control supports the correct method of setting the page height to 100% by using an absolute height attribute in the body tag. The previous versions of the map control did not require this setting. Users upgrading to this version of the map control should change the body tag to the following to render the page at 100%.

<body style="position:absolute;width:100%;height:100%;" …
  • If the map is not rendering properly, check that you have specified DOCTYPE at the beginning of your HTML page.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  • If routes are not displaying on the map, check that charset is set to UTF-8 in the meta tag of your HTML page.
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

Supported Browsers

The latest version of the Bing Maps AJAX Control 6.3 is supported on the following web browsers. If you are not using a supported Web browser, certain features of the map control may not work.

Browser Version 6.3, Full Version 6.3, Core

Internet Explorer 7.0

Supported on the PC

Supported on the PC

Internet Explorer 8.0

Supported on the PC

Supported on the PC

Internet Explorer 9.0

Supported on the PC

Supported on the PC

Firefox 2.0

Supported on the PC

Not supported

Firefox 3.0

Supported on the PC

Not supported

Firefox 3.5

Supported on the PC

Supported on the PC

Firefox 3.6

Supported on the PC

Supported on the PC

Firefox 4.0

Supported on the PC

Supported on the PC

Safari 2

Supported on the Mac

Not supported

Safari 3

Supported on the Mac

Not supported

Safari 4

Supported on the Mac

Supported on the Mac

Google Chrome

Supported on the PC

Supported on the PC

Remarks

Routes do not display in Safari 2.0.

Proxy Authentication Errors

If you receive a proxy authentication error (HTTP status code 407) when executing certain calls to the map control, check your proxy settings in Internet Explorer or in Windows.

  • To check your proxy setting in Internet Explorer, click Tools, Internet Options. Select the Connections tab and click the LAN Settings button. Under the Proxy server section, set the Address and Port values.

  • To check your proxy setting in Windows, click Start, Control Panel, Internet Options. Select the Connections tab and click the LAN Settings button. Under the Proxy server section, set the Address and Port values.

Printing Issues

If your map is not printing correctly, one of the following solutions may help:

Enable Printing

Before you can print the map, set the VEPrintOptions.EnablePrinting Property to true, and pass the VEPrintOptions object to the VEMap.SetPrintOptions Method to enable printing. Make sure you do this only once you are ready to print, as setting this property to true may cause a decrease in the performance of the map control.

Turn on the Print Backgrounds browser option

To properly print all of the items on the map, the Print Backgrounds setting must be selected. This option is not turned on by default.

In Internet Explorer browsers:

  • Select the Tools menu.

  • Select the Internet Options menu item.

  • Go to the Advanced Settings tab.

  • Check the Print Backgrounds item under Printing.

In Firefox browsers:

  • Select the File menu.

  • Select the Page Setup menu item.

  • Go to the Format and Options tab.

  • Check Print Backgrounds.

In Safari browsers:

  • Select the File menu.

  • Select the Print menu item.

  • Click on the Copies & Pages drop-down box.

  • Select Safari.

  • Check Print Backgrounds.

Notes about printing certain features

  • Copyright. The copyright on the map prints with a white background, unless the Web browser print background setting is false.

  • Scale Bar. The scale bar color will not print if the Web browser print background setting is false.

  • Map control dashboard. The map control dashboard, which includes the map navigation controls and map style settings, does not print.

  • Find control. If you have used the VEMap.ShowFindControl Method to show the find control, this control will not print.

  • Find disambiguation box. The disambiguation box that appears when you have requested that ambiguous search results appear does not print.

  • Information boxes. If you use your mouse pointer to hover over pushpins or steps along a route, a box will appear that contains pushpin property details or route instruction text. These information boxes do not print.

  • Tile opacity. User specified tile opacity will not be printed.

  • Image opacity. Image opacity does not print when using Internet Explorer 7.

  • Pushpin transparency. Pushpin transparency does not always print.

  • Shapes when DPI is 120. When your display is set to 120DPI, shapes do not print properly when Internet Explorer is your Web browser.

Developer Resources and Support

Developer Resources

The following resources are available for Bing Maps developers:

Account Access Issues

If you are using the Bing Maps Token Service to track your map control usage and you are experiencing issues with your Bing Maps Customer Services site user name and password, or with your Bing Maps Developer Account ID and password, contact the Bing Maps Account Administrator.

Note Support for Bing Maps account access issues is available only through e-mail. E-mail messages are answered within two business days.

Licensing Questions

If you are interested in finding out more about Bing Maps or have questions about licensing Bing Maps, email maplic@microsoft.com or go to https://www.microsoft.com/maps/contact.aspx. From North, Central, and South America, you can also contact Bing Maps by calling (800) 426-9400, ext. 11315.