Returning Localized Results

The Bing Maps AJAX Control provides the ability to return results in different languages.

Setting the Culture

By default the map control features are provided in the culture English-United States (en-US). However, the map control culture can be changed by adding the mkt parameter to the map control reference, as in the following example, which sets the culture to French-France (fr-FR).

<script type="text/javascript" src="http://ecn.dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.2&mkt=fr-fr"></script>

Note:
More information about setting map control parameters is found in the Using Map Control Parameters topic.

Supported Cultures

Depending on the culture specified in the map control reference, the following items are returned in the language of the culture:

The map control dashboard. The dashboard is the default interface for controlling the map (the compass-and-zoom control).
3D setup and instructional dialog boxes.
The VEPlace.Name Property of the results returned by the VEMap.Find Method
The VERouteItineraryItem.Text Property for each VERouteItineraryItem in the VERouteItinerary.Items array returned by the VEMap.GetDirections Method. Some locales are only supported by VEMap.GetDirections when you set the VERouteOptions.UseMWS Property to true.
Map labels for Road and Hybrid map styles.

The following table lists supported cultures for the map control and available features for each culture. If you set the map control mkt parameter to a value not found in this table, the map control will not load.

Language - Country/Region	Culture	Feature Support
Czech - Czech Republic	cs-CZ	VEMap.Find, VEMap.GetDirections
Danish - Denmark	da-DK	VEMap.Find, VEMap.GetDirections
Dutch - Netherlands	nl-NL	VEMap.Find, VEMap.GetDirections
English - Australia	en-AU	VEMap.GetDirections using MWS
English - Canada	en-CA	Map control dashboard, VEMap.Find, VEMap.GetDirections using MWS
English - India*	en-IN*	VEMap.GetDirections using MWS*
English - United Kingdom	en-GB	VEMap.GetDirections using MWS
English - United States	en-US	All features. This is the default culture.
Finnish -Finland	fi-FI	VEMap.Find, VEMap.GetDirections
French - Canada	fr-CA	Map control dashboard, 3D dialogs, VEMap.Find, VEMap.GetDirections, map labels
French - France	fr-FR	Map control dashboard, 3D dialogs, VEMap.Find, VEMap.GetDirections, map labels
German - Germany	de-DE	Map control dashboard, VEMap.Find, VEMap.GetDirections, map labels
Italian - Italy	it-IT	Map control dashboard, 3D dialogs, VEMap.Find, VEMap.GetDirections, map labels
Japanese - Japan	ja-JP	Map control dashboard, 3D dialogs, VEMap.Find, map labels
Norwegian (Bokmal) - Norway	nb-NO	VEMap.Find, VEMap.GetDirections
Portuguese - Brazil	Pt-BR	VEMap.Find, VEMap.GetDirections
Portuguese - Portugal	pt-PT	VEMap.Find, VEMap.GetDirections
Spanish - Mexico	es-MX	VEMap.GetDirections using MWS, map labels
Spanish - Spain	es-ES	Map control dashboard, VEMap.Find, VEMap.GetDirections, map labels
Spanish - United States	es-US	Map control dashboard, VEMap.Find, VEMap.GetDirections using MWS, map labels
Swedish - Sweden	sv-SE	VEMap.Find, VEMap.GetDirections

* The src for the fully supported India map control is http://dev.mapindia.live.com/mapcontrol/mapcontrol.ashx?v=6.2. Information about this map control is found at http://dev.mapindia.live.com/sdk.

Remarks

If you set the VERouteOptions.UseMWS Property to true and use the VEMap.GetDirections Method with a supported culture, the MapPoint Web Service will return the route directions in the neutral language of that culture. See the Supported Languages topic in the Microsoft MapPoint Web Service SDK for more information.

VEMap.GetRoute is deprecated and will ignore specified cultures.

Reference

>VEMap.Find Method
VEMap.GetDirections Method
VEMap.ShowDashboard Method

Concepts

VEPlace Class
VERoute Class