將地圖本地化

您可以透過下列方式自訂特定國家/地區或區域的地圖:

  • 變更預設語言設定。
  • 指定區碼,根據特定國家/地區或地域調整地圖的行為。

語言本地化

根據預設,Maps JavaScript API 會依照使用者在瀏覽器中指定的偏好語言設定來顯示文字資訊,例如地圖上的控制項名稱、版權聲明、行車路線和標籤。在大部分情況下,最好採用瀏覽器設定。不過,如果您希望 Maps JavaScript API 略過瀏覽器的語言設定,可以在載入 Maps JavaScript API 程式碼時為 <script> 標記加入 language 參數,強制瀏覽器以特定語言顯示資訊。

language 參數會影響控制項名稱、版權聲明、行車路線和控制項標籤,以及對服務要求的回應。服務受到的影響並不明顯。舉例來說,對街道層級地址進行地理編碼時,系統會以您要求的語言傳回國家/地區名稱,地址的其餘部分則取決於進行地理編碼的位置。另一方面,郵政和政治結果會以要求的語言傳回。請使用 這裡的本地化示範程式碼,瞭解更新 language 參數時地圖上發生的變化。

下例顯示日文地圖,且將區域設為日本:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=JP&language=ja&callback=initMap">
</script>

查看範例。

如要設定地圖語言,請務必考慮一併設定區域,這有助於確保您的應用程式符合當地法律規定。

注意:如果您以上述方式載入 API,則無論使用者偏好設定為何,地圖一律會顯示日文。請先確定您希望這樣做,再設定這個選項。

Maps JavaScript API 也原生支援雙向文字 (Bidi),包含由左到右 (LTR) 和由右到左 (RTL) 語言的字元。舉例來說,阿拉伯文、希伯來文和波斯文就屬於由右到左語言。一般來說,如要讓網頁正常顯示由右到左語言,您必須將 dir='rtl' 加入網頁的 <html> 元素。下例使用阿拉伯文控制項轉譯埃及開羅的地圖:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=EG&language=ar&callback=initMap">
</script>

查看範例

支援的語言

Google 會經常更新支援的語言,因此這份清單可能不夠詳盡,且會隨時變更。

語言代碼 語言 語言代碼 語言
af 南非荷蘭文 ja 日文
sq 阿爾巴尼亞文 kn 卡納達文
am 阿姆哈拉文 kk 哈薩克文
ar 阿拉伯文 km 高棉文
hy 亞美尼亞文 ko 韓文
az 亞塞拜然文 ky 吉爾吉斯文
eu 巴斯克文 lo 寮文
be 白俄羅斯文 lv 拉脫維亞文
bn 孟加拉文 lt 立陶宛文
bs 波士尼亞文 mk 馬其頓文
bg 保加利亞文 ms 馬來文
my 緬甸文 ml 馬拉雅拉姆文
ca 加泰隆尼亞文 mr 馬拉提文
zh 中文 mn 蒙古文
zh-CN 中文 (簡體) ne 尼泊爾文
zh-HK 中文 (香港) no 挪威文
zh-TW 繁體中文 (台灣) pl 波蘭文
hr 克羅埃西亞文 pt 葡萄牙文
cs 捷克文 pt-BR 葡萄牙文 (巴西)
da 丹麥文 pt-PT 葡萄牙文 (葡萄牙)
nl 荷蘭文 pa 旁遮普文
en 英文 ro 羅馬尼亞文
en-AU 英文 (澳洲) ru 俄文
en-GB 英文 (英國) sr 塞爾維亞文 (西里爾字母)
et 愛沙尼亞文 sr-Latn 塞爾維亞文 (拉丁字母)
fa 波斯文 si 錫蘭文
fi 芬蘭文 sk 斯洛伐克文
fil 菲律賓文 sl 斯洛維尼亞文
fr 法文 es 西班牙文
fr-CA 法文 (加拿大) es-419 西班牙文 (拉丁美洲)
gl 加里西亞文 sw 史瓦西里文
ka 喬治亞文 sv 瑞典文
de 德文 ta 泰米爾文
el 希臘文 te 泰盧固文
gu 古吉拉特文 th 泰文
iw 希伯來文 tr 土耳其文
hi 北印度文 uk 烏克蘭文
hu 匈牙利文 ur 烏都文
為 冰島文 uz 烏茲別克文
id 印尼文 vi 越南文
it 義大利文 zu 祖魯文

區域本地化

如要修改應用程式的地圖圖塊或自訂調整 (例如根據特定區域調整地理編碼結果),您可以在載入 Maps JavaScript API 程式碼時,將 region 參數加到 <script> 標記。

對於 Maps JavaScript API 應用程式的開發人員,我們建議一律設定 region 參數。設定 region 之後,各項服務 (例如 Places Autocomplete) 通常能提供更準確的結果。 此外,針對應用程式的代管主機所在國家/地區,您有責任套用正確的區域本地化設定,確保應用程式符合當地法律規定。

region 參數接受萬國碼 (Unicode) 區域子標記 ID。一般來說,該 ID 可一對一對應至國家/地區代碼頂層網域 (ccTLD)。大多數萬國碼 (Unicode) 區域 ID 與 ISO 3166-1 alpha-2 代碼相同,但有一些需要注意的例外情況。舉例來說,英國的 ccTLD 是「uk」(對應到網域 .co.uk),而區域 ID 卻是「GB」。如需支援區域的相關資訊,請參閱 Google 地圖平台涵蓋範圍詳細資料。請試用這裡的示範,瞭解更新 region 參數時地圖上發生的變化。

舉例來說,以下指令碼標記針對英國將地圖本地化:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=GB&callback=initMap">
</script>

下例顯示兩張地圖,其中一張根據 region 設為 US (美國) 的值,將「Toledo」的位置編碼為「Toledo, Ohio」;另一張則根據 region 設為 ES (西班牙) 的值,將結果調整成「Toledo, Spain」。

查看美國範例和西班牙範例。

本地化示範

設定地圖語言時,也必須考慮設定區域。以下示範可讓您以自己選擇的語言和區域載入地圖。

在全螢幕模式中查看這個示範。