Using Map Control Parameters

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 describes map control parameters.

Parameters

The following table contains available parameters for the map control handler.

Parameter Values Description

v

6.2, 6.3, 6.3c

Specifies a major API version. The default value is the latest version, which is 6.3. For information about using version 6.3c, see Using the Core Map Control.

mkt

See the Returning Localized Results topic for a list of values.

Specifies the market to use, which defines the language Bing Maps uses. The default value is "en-US" (English).

onscriptload

A string specifying a function name.

Specifies the name of a JavaScript function to call when the map control script is loaded. The name must contain only alphanumeric characters.

The CSS and tiles will not be loaded when this function is called.

(This parameter is useful for loading the map control script from an UpdatePanel in ASP.NET Ajax. Users can call Sys.Application.notifyScriptLoaded from their callback to tell ASP.NET Ajax the script has loaded.)

Adding Parameters

To add a parameter to the map control src URL, add a "?", the parameter, and set it "=" to one of the allowable values. Use "&" to separate parameters.

The following example sets the map control version to 6.3 and the market to Italian.

<script charset="UTF-8" type="text/javascript" src="https://ecn.dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.3&mkt=it-IT">
</script>

See Also

Concepts

Displaying a Map Using JavaScript
Returning Localized Results