Returning Localized Results

Returning Localized Results

Collapse All

Language Filter

Virtual Earth Map Control SDK, version 6.2

The Virtual Earth map 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://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

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.GetDirections Method
VEMap.ShowDashboard Method

Concepts

VEPlace Class
VERoute Class

Other Resources

VEMap.Find Method

Manage Your Profile | Legal | Contact Us | MSDN Flash Newsletter

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

Reference

Concepts

Other Resources