您已全部設定完成!

若要開始開發,請參閱我們的開發人員文件

啟用 Google Maps JavaScript API

為協助您開始,我們將先引導您使用「Google 開發人員控制台」來執行一些動作:

  1. 建立或選擇專案
  2. 啟用 Google Maps JavaScript API 與相關服務
  3. 建立適當的金鑰
繼續

將地圖當地語系化

您可以使用下列方式自訂特定國家或地區的地圖:

  • 變更預設語言設定。
  • 指定地區代碼,根據指定的國家或領土更改地圖的行為。

語言當地語系化

在預設情況下,Google Maps JavaScript API 在顯示文字資訊(例如地圖上的控制項名稱、版權聲明、駕駛路線規劃與標籤)時會使用在瀏覽器中指定的使用者偏好語言設定。在大部分情況下,建議使用瀏覽器設定。然而,如果您想要讓 Maps JavaScript API 忽略瀏覽器的語言設定,可以在載入 Maps JavaScript API 程式碼時將 language 參數新增到 <script> 標記,以強制顯示特定語言的資訊。

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

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

檢視範例

如果您設定地圖的語言,請務必一併設定區域。這樣做有助於確保應用程式遵守當地的法律。

注意:當您以上述方式載入 API 時,無論使用者的偏好設定為何,地圖都會為所有使用者使用日文語言。設定此選項之前,請務必確定您想要上述的行為。

Maps JavaScript API 也支援雙向 (Bidi) 文字,雙向文字包含原生由左至右 (LTR) 與由右至左 (RTL) 兩種語言的字元。RTL 語言的範例包括阿拉伯文、希伯來文與波斯文。一般而言,您要在頁面的 <html> 元素中加入 dir='rtl' 指定 RTL 語言頁面才能正確轉譯。下列範例使用阿拉伯文控制項轉譯埃及開羅的地圖:

<!DOCTYPE html>
<html dir="rtl">
  <body>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ar&region=EG">
    </script>
  </body>
</html>

檢視範例

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

區域當地語系化

當您從 maps.googleapis.com 載入 Google Maps JavaScript API 時,會預設套用適用於美國的應用程式行為。如果您想要改變應用程式來提供不同的地圖方塊或讓應用程式有某種偏向(例如讓地理編碼結果偏向某個地區),您可以在載入 Maps JavaScript API 程式碼時,在 <script> 標記中新增 region 參數來覆寫此預設行為。

身為 Maps JavaScript API 應用程式的開發人員,您有責任為應用程式所在的國家/地區套用正確的地區當地語系化,以確保您的應用程式遵守當地的法律。

region 參數接受 Unicode 地區子標記識別碼,這個識別碼(通常)可以一對一對應到國家/地區代碼的頂層網域 (ccTLD)。大部分 Unicode 地區識別碼和 ISO 3166-1 代碼完全相同,有些則是明顯例外。例如,英國的 ccTLD 是 "uk" (對應到網域 .co.uk),而其地區識別碼為 "GB"。

例如,下列指令碼標記會將地圖當地語系化為英國:

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

下列範例示範兩個地圖,一個根據預設地區(美國)將 "Toledo" 地理編碼為 "Toledo, Ohio",一個根據 region 設定為 ES (西班牙)的偏向結果地理編碼為 "Toledo, Spain"。

檢視 US 範例ES 範例

在中國載入 API

在中國,Google Maps JavaScript API 是從 http://maps.google.cn 網域提供服務。對中國提供內容時,請將 https://maps.googleapis.com 取代為 http://maps.google.cn。例如:

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY">
</script>

如果您特別以中國的使用者為目標,應該同時新增地區與語言參數。API 支援 zh-CNzh-TW 兩者做為 language 參數的值。

<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY">
</script>

傳送您對下列選項的寶貴意見...

這個網頁
Google Maps JavaScript API
Google Maps JavaScript API
需要協助嗎?請前往我們的支援網頁