本地化地圖

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

本地化語言

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

language 參數會影響控制項名稱、版權聲明、行車路線和控制標籤,以及對服務要求的回應。對服務的影響並不明顯。舉例來說,當您對地理編碼的街道地址層級傳回國家/地區名稱時,國家/地區名稱會以您要求的語言傳回,但其餘地址則取決於您進行地理編碼的位置。另一方面,郵遞區號和政治結果會以要求的語言傳回。嘗試這個示範,以便在更新 language 參數時,測試地圖上的變更。

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

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

查看範例

如果您設定地圖語言,也請務必考慮設定區域。這可以確保應用程式符合當地法律。

注意:如果您以上述方式載入 API,則無論使用者偏好設定為何,地圖都會為所有使用者使用日文。 設定這個選項前,請務必先完成此行為。

Maps JavaScript API 也支援雙向 (Bidi) 雙向文字,當中包含原生語言為由左至右 (LTR) 和由右至左 (RTL) 的語言。RTL 語言範例包括阿拉伯文、希伯來文和波斯文。一般來說,如要從 RTL 語言頁面正常顯示內容,請在網頁的 <html> 元素中加入 dir='rtl'。以下範例顯示阿拉伯文控制項的埃及開羅地圖:

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

查看範例

請參閱支援的語言清單。請注意,我們會經常新增語言,因此這份清單可能不夠詳盡。

區域本地化

如要修改應用程式以提供不同的地圖圖塊或偏誤 (例如將區域結果偏誤到該區域),請在載入 Maps JavaScript API 程式碼時,將 region 參數新增至 <script> 標記。

由於身為 Maps JavaScript API 應用程式的開發人員,建議您一律設定 region 參數,因為當設定了 region 時,這些服務 (例如「地點自動完成」) 通常會提供更優質的結果。此外,您也有責任確保應用程式符合自身代管國家/地區的正確區域本地化規範,確保應用程式符合當地法律。

region 參數接受 萬國碼 (Unicode) 區域子標記 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&region=GB&callback=initMap">
</script>

以下範例顯示兩張地圖,其中一組為「Toledo」的地理編碼,這是根據設為 US (美國) 的「region」(美國) 至「俄亥俄州托萊多市」(Aledo, Ohio),

查看美國範例ES 範例

「本地化」示範

設定地圖語言時,請一併考慮設定區域。 以下示範可讓你以自己選擇的語言和地區載入地圖。

全螢幕模式中查看此示範。