Edit

Localization support in Azure Maps

Azure Maps supports various languages and views based on country/region. This article provides the supported languages and views to help guide your Azure Maps implementation.

Azure Maps supported languages

Note

For supported cultures, street names are localized to the local language. For instance, if you request a location in France, the street names are in French. However, the level of localization for other data, such as country or region names, can vary by culture. For example, not every culture code can have a localized name for 'United States.'

Azure Maps is localized in variety languages across its services. The following table provides the supported language codes for each service.

Azure Maps offers localization in a wide range of languages across its various services. The following table lists the supported language codes for previous versions of its services. The Route column includes routes for driving, truck routes, and walking.

Culture Language Render Search Route Traffic Weather
af-ZA Afrikaans ✓ ✓
ar Arabic ✓ ✓ ✓ ✓ ✓
bg-BG Bulgarian ✓ ✓ ✓ ✓
bn-BD Bangla (Bangladesh) ✓
bn-IN Bangla (India) ✓
bs-BA Bosnian ✓
ca-ES Catalan ✓ ✓
cs-CZ Czech ✓ ✓ ✓ ✓ ✓
da-DK Danish ✓ ✓ ✓ ✓ ✓
de-DE German ✓ ✓ ✓ ✓ ✓
el-GR Greek ✓ ✓ ✓ ✓ ✓
en-AU English (Australia) ✓ ✓ ✓
en-NZ English (New Zealand) ✓ ✓ ✓ ✓
en-GB English (United Kingdom) ✓ ✓ ✓ ✓ ✓
en-US English (USA) ✓ ✓ ✓ ✓ ✓
es-419 Spanish (Latin America) ✓ ✓
es-ES Spanish (Spain) ✓ ✓ ✓ ✓ ✓
es-MX Spanish (Mexico) ✓ ✓ ✓
et-EE Estonian ✓ ✓ ✓
eu-ES Basque ✓
fi-FI Finnish ✓ ✓ ✓ ✓ ✓
fil-PH Filipino ✓
fr-CA French (Canada) ✓ ✓
fr-FR French (France) ✓ ✓ ✓ ✓ ✓
gl-ES Galician ✓
gu-IN Gujarati ✓
he-IL Hebrew ✓ ✓ ✓
hi-IN Hindi ✓
hr-HR Croatian ✓ ✓
hu-HU Hungarian ✓ ✓ ✓ ✓ ✓
id-ID Indonesian ✓ ✓ ✓ ✓ ✓
is-IS Icelandic ✓
it-IT Italian ✓ ✓ ✓ ✓ ✓
ja-JP Japanese ✓
kk-KZ Kazakh ✓ ✓
kn-IN Kannada ✓
ko-KR Korean ✓ ✓ ✓
lt-LT Lithuanian ✓ ✓ ✓ ✓ ✓
lv-LV Latvian ✓ ✓ ✓
mk-MK Macedonian ✓
mr-IN Marathi ✓
ms-MY Malay ✓ ✓ ✓ ✓
nb-NO Norwegian Bokmål ✓ ✓ ✓ ✓ ✓
NGT Neutral Ground Truth (Local)1 ✓ ✓
NGT-Latn Neutral Ground Truth (Latin)2 ✓ ✓
nl-BE Dutch (Belgium) ✓ ✓
nl-NL Dutch (Netherlands) ✓ ✓ ✓ ✓ ✓
pa-IN Punjabi ✓
pl-PL Polish ✓ ✓ ✓ ✓ ✓
pt-BR Portuguese (Brazil) ✓ ✓ ✓ ✓
pt-PT Portuguese (Portugal) ✓ ✓ ✓ ✓ ✓
ro-RO Romanian ✓ ✓ ✓
ru-RU Russian ✓ ✓ ✓ ✓ ✓
sk-SK Slovak ✓ ✓ ✓ ✓ ✓
sl-SI Slovenian ✓ ✓ ✓ ✓
sr-Cyrl-RS Serbian (Cyrillic) ✓ ✓
sr-Latn-RS Serbian (Latin) ✓
sv-SE Swedish ✓ ✓ ✓ ✓ ✓
ta-IN Tamil ✓
te-IN Telugu ✓
th-TH Thai ✓ ✓ ✓ ✓ ✓
tr-TR Turkish ✓ ✓ ✓ ✓ ✓
uk-UA Ukrainian ✓ ✓
ur-PK Urdu ✓
uz-Latn-UZ Uzbek ✓
vi-VN Vietnamese ✓ ✓
zh-HanS-CN Chinese (Simplified, China) ✓ ✓ ✓
zh-HanT-HK Chinese (Traditional, Hong Kong SAR) ✓
zh-HanT-TW Chinese (Traditional, Taiwan) ✓ ✓ ✓ ✓

1 Neutral Ground Truth (Local) - Official languages for all regions in local scripts if available
2 Neutral Ground Truth (Latin) - Latin exonyms are used if available

Note

The Weather service isn't included in this section because it supports localization for cultures listed in the "Previous" tab of this article.

Azure Maps offers localization in a wide range of languages across its various services. The following table lists the supported language codes for the latest services. The Route column includes routes for both driving and walking.

Culture Language Search Autocomplete Render Route Traffic Truck Route
af Afrikaans ✓ ✓ ✓ ✓ ✓
sq Albanian ✓ ✓ ✓
am Amharic ✓ ✓ ✓
ar-sa Arabic (Saudi Arabia) ✓ ✓ ✓ ✓ ✓ ✓
hy Armenian ✓ ✓ ✓
as Assamese ✓ ✓ ✓
az-Latn Azerbaijani (Latin) ✓ ✓ ✓
bn-BD Bangla (Bangladesh) ✓ ✓ ✓
bn-IN Bangla (India) ✓ ✓
eu Basque ✓ ✓ ✓
be Belarusian ✓ ✓ ✓
bn Bangla ✓
bs Bosnian (Latin) ✓ ✓ ✓
bg Bulgarian ✓ ✓ ✓ ✓ ✓
my Burmese ✓ ✓
ca Catalan Spanish ✓ ✓ ✓
ku-Arab Central Kurdish ✓ ✓ ✓
chr Cherokee ✓ ✓
zh-Hans Chinese (Simplified) ✓
zh-Hant Chinese (Traditional) ✓
zh-HanT-TW Chinese (Traditional, Taiwan) ✓ ✓ ✓
hr Croatian ✓ ✓ ✓
cs Czech ✓ ✓ ✓ ✓ ✓ ✓
da Danish ✓ ✓ ✓ ✓ ✓ ✓
prs-Arab Dari ✓ ✓ ✓
nl Dutch ✓
nl-BE Dutch (Belgium) ✓
nl-NL Dutch (Netherlands) ✓ ✓ ✓ ✓ ✓
en-NZ English (New Zealand) ✓
en-GB English (United Kingdom) ✓ ✓ ✓ ✓ ✓ ✓
en-US English (United States) ✓ ✓ ✓ ✓ ✓ ✓
et Estonian ✓ ✓ ✓ ✓
fo Faroese ✓ ✓
fil-Latn Filipino ✓ ✓ ✓
fi Finnish ✓ ✓ ✓ ✓ ✓ ✓
fr French ✓
fr-CA French (Canada) ✓
fr-FR French (France) ✓ ✓ ✓ ✓ ✓
fy Frisian ✓ ✓
gl Galician ✓ ✓ ✓
ka Georgian ✓ ✓ ✓
de-de German (Germany) ✓ ✓ ✓ ✓ ✓ ✓
el Greek ✓ ✓ ✓ ✓ ✓ ✓
kl Greenlandic ✓ ✓
gu Gujarati ✓ ✓ ✓
ha-Latn Hausa (Latin) ✓ ✓ ✓
haw Hawaiian ✓ ✓
he Hebrew ✓ ✓ ✓ ✓
hi Hindi ✓ ✓ ✓
hu Hungarian ✓ ✓ ✓ ✓ ✓ ✓
is Icelandic ✓ ✓ ✓
ig-Latn Igbo ✓ ✓ ✓
id Indonesian ✓ ✓ ✓ ✓ ✓ ✓
iu Inuktitut ✓ ✓
ga Irish ✓ ✓ ✓
xh isiXhosa ✓ ✓ ✓
zu isiZulu ✓ ✓ ✓
it Italian (Italy) ✓ ✓ ✓ ✓ ✓ ✓
ja Japanese ✓ ✓
kn Kannada ✓ ✓ ✓
kk Kazakh ✓ ✓ ✓
km Khmer ✓ ✓ ✓
qut-Latn K'iche' ✓ ✓
rw Kinyarwanda ✓ ✓ ✓
sw Kiswahili ✓ ✓ ✓
kok Konkani ✓ ✓ ✓
ko Korean ✓ ✓ ✓ ✓
ky-Cyrl Kyrgyz ✓ ✓ ✓
lo Lao ✓ ✓
lv Latvian ✓ ✓ ✓ ✓
lt Lithuanian ✓ ✓ ✓ ✓ ✓ ✓
lb Luxembourgish ✓ ✓ ✓
mk Macedonian ✓ ✓ ✓
ms Malay (Malaysia) ✓ ✓ ✓ ✓ ✓
ml Malayalam ✓ ✓ ✓
mt Maltese ✓ ✓ ✓
mi-Latn Maori ✓ ✓ ✓
mr Marathi ✓ ✓ ✓
mn-Cyrl Mongolian (Cyrillic) ✓ ✓ ✓
ne Nepali (Nepal) ✓ ✓ ✓
no Norwegian ✓
nb Norwegian (Bokmål) ✓ ✓ ✓ ✓ ✓ ✓
nn Norwegian (Nynorsk) ✓ ✓ ✓
or Odia ✓ ✓ ✓
ps Pashto ✓ ✓
fa Persian ✓ ✓ ✓
pl Polish ✓ ✓ ✓ ✓ ✓ ✓
pt Portuguese ✓ ✓
pt-BR Portuguese (Brazil) ✓ ✓ ✓ ✓ ✓
pt-PT Portuguese (Portugal) ✓ ✓ ✓ ✓ ✓ ✓
pa-Arab Punjabi (Arabic) ✓ ✓ ✓
pa Punjabi (Gurmukhi) ✓ ✓ ✓
quz Quechua (Peru) ✓ ✓ ✓
ro Romanian (Romania) ✓ ✓ ✓ ✓
rm Romansh ✓ ✓
ru Russian ✓ ✓ ✓ ✓ ✓ ✓
se Sami (Northern) ✓ ✓
sa Sanskrit ✓ ✓
gd-Latn Scottish Gaelic ✓ ✓ ✓
sr Serbian ✓ ✓
sr-Cyrl-BA Serbian (Cyrillic, Bosnia and Herzegovina) ✓ ✓ ✓
sr-Cyrl-ME Serbian (Cyrillic, Montenegro) ✓
sr-Cyrl-RS Serbian (Cyrillic, Serbia) ✓ ✓
sr-Latn Serbian (Latin) ✓
sr-Latn-ME Serbian (Latin, Montenegro) ✓
sr-Latn-RS Serbian (Latin, Serbia) ✓ ✓ ✓
nso Sesotho sa Leboa ✓ ✓ ✓
tn Setswana ✓ ✓ ✓
sd-Arab Sindhi (Arabic) ✓ ✓ ✓
si Sinhala ✓ ✓ ✓
sk Slovak ✓ ✓ ✓ ✓ ✓ ✓
sl Slovenian ✓ ✓ ✓ ✓ ✓
es Spanish ✓
es-MX Spanish (Mexico) ✓ ✓ ✓
es-ES Spanish (Spain) ✓ ✓ ✓ ✓ ✓
sv Swedish (Sweden) ✓ ✓ ✓ ✓ ✓ ✓
syr Syriac ✓ ✓
tg-Cyrl-TJ Tajik (Cyrillic) ✓ ✓ ✓
ta Tamil ✓ ✓ ✓
tt-Cyrl Tatar (Cyrillic) ✓ ✓ ✓
te Telugu ✓ ✓ ✓
th Thai ✓ ✓ ✓ ✓ ✓ ✓
bo Tibetan ✓ ✓
ti Tigrinya ✓ ✓ ✓
to Tongan ✓ ✓
tr Turkish ✓ ✓ ✓ ✓ ✓ ✓
tk-Latn Turkmen (Latin) ✓ ✓ ✓
uk Ukrainian ✓ ✓ ✓
ur Urdu ✓ ✓ ✓
ug-Arab Uyghur ✓ ✓ ✓
uz-Latn Uzbek (Latin) ✓ ✓ ✓
ca-ES-valencia Valencian ✓ ✓ ✓
vi Vietnamese ✓ ✓ ✓
cy Welsh ✓ ✓ ✓
wo Wolof ✓ ✓ ✓
yo-Latn Yoruba ✓ ✓ ✓

Azure Maps supported views

You need to configure the View parameter as required for the REST APIs and the Web SDK, for the services being used.

Azure Maps View parameter (also referred to as "user region parameter") is a two letter ISO-3166 country/region Code that shows the correct maps for that country/region specifying which set of geopolitically disputed content is returned via Azure Maps services, including borders and labels displayed on the map.

REST APIs

You must configure the View parameter to determine which set of geopolitically disputed content Azure Maps services return.

Affected Azure Maps REST services:

Search

  • Get Search Fuzzy
  • Get Search POI
  • Get Search POI Category
  • Get Search Nearby
  • Get Search Address
  • Get Search Address Structured
  • Get Search Address Reverse
  • Get Search Address Reverse Cross Street
  • Post Search Inside Geometry
  • Post Search Address Batch
  • Post Search Address Reverse Batch
  • Post Search Along Route
  • Post Search Fuzzy Batch

Render

  • Get Map Tile
  • Get Map Image

Search

  • Get Geocode Autocomplete
  • Get Geocoding
  • Get Geocoding Batch
  • Get Polygon
  • Get Reverse Geocoding
  • Get Reverse Geocoding Batch

Render

  • Get Map Static Image
  • Get Map Tile

SDKs

You need to have the latest version of Web SDK and configure the View parameter as required. This parameter determines which set of geopolitically disputed content the Azure Maps service returns.

By default, the View parameter is set to Unified, even if not defined in the request. Determine the location of your users. Then, set the View parameter correctly for that location. Alternatively, you can set 'View=Auto', which returns the map data based on the IP address of the request. The View parameter in Azure Maps must be used in compliance with applicable laws, including those laws about mapping of the country/region where maps, images, and other data and third-party content that you're authorized to access via Azure Maps is made available.

The following table provides supported views.

View Description Maps Search
AE United Arab Emirates (Arabic View) ✓
AR Argentina (Argentinian View) ✓ ✓
BH Bahrain (Arabic View) ✓
IN India (Indian View) ✓ ✓
IQ Iraq (Arabic View) ✓
JO Jordan (Arabic View) ✓
KW Kuwait (Arabic View) ✓
LB Lebanon (Arabic View) ✓
MA Morocco (Moroccan View) ✓ ✓
OM Oman (Arabic View) ✓
PK Pakistan (Pakistani View) ✓ ✓
PS Palestinian Authority (Arabic View) ✓
QA Qatar (Arabic View) ✓
SA Saudi Arabia (Arabic View) ✓
SY Syria (Arabic View) ✓
YE Yemen (Arabic View) ✓
Auto Automatically detect based on request ✓ ✓
Unified Unified View (Others) ✓ ✓
View Description Maps Search Autocomplete
AE United Arab Emirates (Arabic View) ✓
AR Argentina (Argentinian View) ✓ ✓ ✓
BH Bahrain (Arabic View) ✓
IN India (Indian View) ✓ ✓ ✓
IQ Iraq (Arabic View) ✓
JO Jordan (Arabic View) ✓
KW Kuwait (Arabic View) ✓
LB Lebanon (Arabic View) ✓
MA Morocco (Moroccan View) ✓ ✓ ✓
OM Oman (Arabic View) ✓
PK Pakistan (Pakistani View) ✓ ✓ ✓
PS Palestinian Authority (Arabic View) ✓
QA Qatar (Arabic View) ✓
SA Saudi Arabia (Arabic View) ✓
SY Syria (Arabic View) ✓
US United States of America ✓ ✓
YE Yemen (Arabic View) ✓
Auto Automatically detect based on request ✓ ✓
Unified Unified View (Others) ✓ ✓