Returning Localized Results
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.
The Bing Maps AJAX Control 6.3 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="https://ecn.dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.3&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.
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 - Belgium |
nl-BE |
Map labels |
Dutch - Netherlands |
nl-NL |
VEMap.Find, VEMap.GetDirections |
English - Australia |
en-AU |
VEMap.GetDirections* |
English - Canada |
en-CA |
Map control dashboard, VEMap.Find, VEMap.GetDirections* |
English – India1 |
en-IN1 |
VEMap.GetDirections* |
English - United Kingdom |
en-GB |
VEMap.GetDirections |
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**, 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**, map labels |
Swedish - Sweden |
sv-SE |
VEMap.Find, VEMap.GetDirections |
* Directions are returned in neutral English (“en”) for these cultures.
** Directions are returned in neutral Spanish (“es”) for these cultures.
Remarks
VEMap.GetRoute is deprecated and will ignore specified cultures.
Error messages are always displayed in English - United States.
See Also
Reference
VEMap.Find Method
VEMap.GetDirections Method
VEMap.ShowDashboard Method