常見問題

此常見問題涵蓋了特定於 Google Maps APIs Premium Plan 的問題。

針對所有 Google Maps APIs 的共通問題,請參閱 Google Maps APIs 常見問題

開始使用

舊版 Google Maps APIs for Work 授權與更新

購買 Google Maps APIs Premium Plan

使用限制

開發您的應用程式

KML

網址簽署

設定樣式

開始使用

什麼是 Google Maps APIs Premium Plan?

Google Maps APIs Premium Plan (Premium Plan) 能讓您存取我們的服務套件,確保您擁有所需的全部工具來為應用程式及網站實作可自訂、適用行動裝置、可擴充的地圖。

Google Maps APIs Premium Plan 中包含哪些 API?

Google Maps APIs Premium Plan 中包含下列 Google 產品。使用這些產品的應用程式皆涵蓋在 Google Maps APIs Premium Plan SLA 中,並有資格使用技術支援

* Premium Plan Asset Tracking 授權不包含 Google Places API。如果您有 Asset Tracking 授權且想使用 Places API,請聯絡 Google Maps 銷售團隊。

Google Maps APIs Premium Plan 不涵蓋下列 API。使用這些 API 的應用程式必須遵守針對 API 發佈的服務條款,但並不涵蓋在 Google Maps APIs Premium Plan SLA 中,也無資格使用技術支援:

如何聯絡 Google Maps APIs Premium Plan 技術支援?

Google Maps APIs Premium Plan 客戶可以使用以下的 Google Cloud Support Portal 來向 Google 支援提出新的支援案件:

https://google.secure.force.com/

您需要使用者名稱和密碼來存取此入口網站。如果您沒有帳戶,請填寫此表單

如需更多資訊,請參閱支援與資源指南。

如何重設 Google Cloud Support Portal 登入憑證?

我忘記密碼了Google Cloud Support Portal 登入頁面上也有此連結。

Google Maps APIs Premium Plan 服務條款有哪些?

如果您是 Google Maps APIs Premium Plan 客戶,請參閱您的合約以瞭解約束您的 Google Maps APIs 使用方式的條款。如需更多資訊,請參閱 Google Maps APIs Premium Plan 使用條款

舊版 Google Maps APIs for Work 授權與更新

哪裡可以找到關於舊版 Google Maps APIs for Work 授權的資訊?

若要判斷您是否擁有舊的 Maps APIs for Work 授權:在 Google Cloud Support Portal 中,按一下左側的 [Maps:Usage Report]。如果報告頂端的 ID 是下列格式,則您擁有新的 Premium Plan:
gme-[company] & proj-[number] ([type]) 反之,則您擁有舊的授權。如需更多資訊,請參閱 Maps APIs for Work 授權指南。

新的 Premium Plan 有哪些更新?

請參閱針對更新客戶的變更摘要授權更新常見問題

購買 Google Maps APIs Premium Plan

為何要購買 Google Maps APIs Premium Plan?

如果您的公司或機構有下列任一需求,建議您購買 Premium Plan:

  • 提供 24 小時技術支援的服務水準協議 (SLA)
  • 銷售具有內嵌「Google 地圖」之產品或服務的能力
  • 針對內部應用程式或網站使用 Google Maps APIs 的能力
  • 特定數目的配額
  • 針對資產追蹤應用程式使用 Google Maps APIs 的能力
  • 您現有的 Maps APIs for Work 授權提供進階版功能
如何購買 Google Maps APIs Premium Plan?

請聯絡 Google 業務代表以取得購買 Premium Plan 的詳細資料,並根據您應用程式的使用量取得估價。

必須有 Google 帳戶才能使用 Google Maps APIs Premium Plan 嗎?

是,您必須有 Google 帳戶才能存取 Google API Console 上的 Google Maps APIs。

使用限制

Google Maps APIs Premium Plan 使用量是如何計算的?

擁有舊版 Maps APIs for Work 或 Maps API for Business 授權嗎?請參閱我們的 Maps APIs for Work 授權指南。若要判斷您是否擁有舊的授權:在 Google Cloud Support Portal 中,按一下左側的 [Maps:Usage Report]。如果報告頂端的 ID 屬於下列格式,則您擁有新的 Premium Plan:
gme-[company] & proj-[number] ([type])
反之,則您擁有舊的授權。

透過 Google Maps APIs Premium Plan,您的應用程式會取決於其所要求的 API,以不同費用取用配額。您需根據應用程式的年度使用量估計來購買一或多年份的配額,稱為 Maps APIs Credits。應用程式所有針對 Maps API 的要求都會從您所購買的額度集區中取用額度。例如,如果您的應用程式使用 Google Maps JavaScript API 來顯示地圖,則其會針對 Maps JavaScript API 地圖載入取用額度。如果您的應用程式取用完集區中的所有額度,您可以依需求購買更多額度。如需更多資訊,請參閱 Premium Plan 使用費用與限制指南。

如何追蹤應用程式的 Google Maps APIs Premium Plan 使用量?

如需關於追蹤應用程式 Maps APIs Credits 使用量、其他使用量報告和分析的資訊,請參閱 Premium Plan 報告指南。

如何估計應用程式的 Maps APIs Credits 使用量?

您可以使用 Google Maps APIs Premium Calculator 來估計應用程式的使用量。

此外,額度計算範例也相當實用。

如果我用完所有 Maps APIs Credits 會怎麼樣?

如果您用完 Maps APIs Credits,您應用程式的要求會繼續成功運作,但您的帳戶可能需繳交超額費用。在這種情況下,您需要盡快更新 Google Maps APIs Premium Plan 授權,以避免帳戶遭到停權。當您已使用 85% 配額時,Google 將透過電子郵件通知您。

為何 Google Places API 詳細資料要求收取 2 Maps APIs Credits,但地點自動完成要求卻僅收取 0.1 額度?

Google Places API 使用更廣泛的商家及其他地點資料庫。由於商家頻繁開業、歇業,因此得花費許多時間及精力來維持此資料庫的準確性。所以,我們需要針對地點詳細資料要求收取較多額度。針對地點自動完成,我們了解使用者經常需要輸入數個字元來尋找地點,因此我們僅對每個要求收取一小部分的額度。

開發您的應用程式

Google API Console 專案 ID 和用戶端編號會同時核發給我嗎?

是,您的歡迎函中會包含 Google API Console 專案 ID 及用戶端編號。

提供給我的 Google API Console 專案中會啟用所有可用的 API 嗎?

是,在 Premium Plan 中,我們會自動為相同的 Google API Console 專案佈建所有 API。您可以在單一專案中存取所有 API。相同平台(Web、Web 服務、Android、iOS)上的 API 可共用相同的 API 金鑰。您的 API 金鑰提供即時的使用量報告,以及 30 天內的歷史使用量資料。如果您需要如 Maps API Analytics、按管道區分的使用量報告、超過 30 天的歷史報告資料等功能,您可以針對大部分 API 使用用戶端編號(而非 API 金鑰)。(用戶端編號不適用於 Google Places API、Google Maps Geolocation API、Google Maps Roads API、Google Maps Android API、Google Maps SDK for iOS。)

API 金鑰和用戶端編號有何差別?

透過專案 ID,您可以在 Google API Console 中產生 API 金鑰。以下是使用 API 金鑰和用戶端編號的主要差異:

  • API 支援:API 金鑰可以搭配任何 Maps API 使用。或者,用戶端編號也可以搭配任何 API 使用,除了 Google Places API、Google Maps Geolocation API、Google Maps Roads API、Google Maps Android API、Google Maps SDK for iOS。
  • 報告:您的 API 金鑰提供即時的使用量報告,以及 30 天內的歷史使用量資料。如果您需要如 Maps API Analytics、按管道區分的使用量報告、超過 30 天的歷史報告資料等功能,請針對支援用戶端編號的 API 使用用戶端編號。
  • 錯誤代碼:如果您使用 API 金鑰,您會根據 HTTP 狀態碼類別(例如 3xx 和 4xx 錯誤)收到錯誤訊息,這些訊息僅提供一般資訊。如果您使用用戶端編號,您會在 Google Cloud Support Portal 報告中收到更詳細的 API 專屬錯誤代碼,有助於進行疑難排解。
  • 安全性:只要您遵循以下指導方針,API 金鑰和用戶端編號同樣安全:
    • 如果您使用 API 金鑰,請務必將金鑰加以保密。所有針對 Maps API 的要求均使用 HTTPS,因此被他人攔截流量的風險有限。然而,如果有人取得您的金鑰,他們就可以使用您的金鑰來對 Maps API 做出要求。若要防止用戶端 API 出現這種問題,您可以限制能使用您金鑰的網域。針對伺服器端 API,請限制您的金鑰,以僅接受從您伺服器來源 IP 位址發出的要求。如需更多關於安全地使用 API 金鑰的資訊,請參閱 Console 說明中心
    • 如果您使用用戶端編號,請務必將密碼編譯金鑰(用來產生數位簽章)加以保密。此外,請絕對不要在 API 要求中使用密碼編譯金鑰,或用此金鑰來簽署使用 JavaScript 的網址,因為這些做法可能會公開您的金鑰。
我需要在測試環境中使用 Google Maps APIs Premium Plan 憑證嗎?

所有 Google Maps APIs 皆需使用 API 金鑰或用戶端編號驗證。在測試環境中開發應用程式時,請考慮下列事項:

  • 如果您的測試環境需要存取技術支援,您必須使用 Premium Plan 憑證(用戶端編號或 API 金鑰)。請注意,Maps API 的使用會根據使用費用與限制來取用您方案的 Maps APIs Credits。
  • 如果您不想讓測試環境取用您方案的 Maps APIs Credits,您可以使用標準憑證(Google API Console 中設定的 API 金鑰);然而,在這種情況下,您的測試環境將資格使用技術支援。如果您選擇使用標準憑證,您的應用程式或網站將受到各 API 的標準使用限制規範。如需更多關於標準使用限制的資訊,請參閱定價與方案
  • 如果您預期在測試環境中產生大量資料,並希望測試環境能存取技術支援,但不想取用 Premium Plan 的 Maps APIs Credits,請考慮採用開發專用的授權。這是一般而言較低價的選項,並提供技術支援。請聯絡您的 Google Maps 客戶經理來取得更多資訊。
  • 如果您要為應用程式進行負載測試,可以針對模擬 API 執行這些測試。請參閱推出前檢查清單中的在應用程式上執行負載測試
如何以 Google Maps APIs Premium Plan 存取 Zagat 功能?

在 Premium Plan 中,針對 Google Places API Web Service 的包含您 API 金鑰的要求會傳回進階版 Zagat 內容。若要確認您有 Zagat 內容的存取權,請傳送要求至 Google Places API Web Service,並加上註冊時為您建立的專案中的金鑰。以下是範例網址:

https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants+in+mountain+View,+ca&key=YOUR_API_KEY
如何以 Google Maps APIs Premium Plan 存取進階版行動裝置功能?

您可以和標準 API(Google Maps SDK for iOSGoogle Maps Android API)使用者一樣,使用相同的 SDK 來存取進階版行動裝置功能。若要存取進階版功能,請務必使用註冊時為您建立的專案中的 API 金鑰。若要確認您有進階版行動裝置功能的存取權,請使用靜態程式庫載入地圖。如需詳細資訊,請參閱開始在 AndroidiOS 上使用 Premium Plan 指南。

Google Maps APIs Premium Plan 是否為 Android 提供動態程式庫?

是,在 Premium Plan 中,您也可以使用 Google Maps Android API 動態程式庫(而非靜態程式庫)。如需詳細資訊,請參閱開始在 Android 上使用 Premium Plan 指南。

如何從透過 HTTPS (SSL) 載入的頁面使用 Google Maps APIs Premium Plan 用戶端編號存取 Google Maps JavaScript API?

若要從透過 HTTPS 載入的頁面存取 Google Maps JavaScript API,您首先必須授權您想使用 API 的 HTTPS 網址

如何在使用 Common Loader base_domain 參數時,透過 HTTPS (SSL) 載入 Google Maps JavaScript API?

您無法使用設有 base_domain 參數的 Common Loader 來透過 SSL 載入 Maps JavaScript API。

base_domain 參數並不會影響應用程式效能;API 要求總是由最適合使用者位置的 Maps 伺服器處理,無論 API 是在哪個網域載入。

base_domain 確實會將地理編碼結果偏向指定區域;要在沒有 base_domain 的情況下達到相同效果,請設定地理編碼服務的 region 參數

KML

如何轉譯裝載於內部網路網站之地圖上的 KML 檔案?

在 Google Maps JavaScript API 中產生 KML 疊加層的 KmlLayer 類別使用裝載於 Google 的服務來擷取、剖析 KML 檔案以進行轉譯。因此,您無法顯示不是代管於可供大眾存取之網址的 KML 檔案,或需要驗證才能存取的 KML 檔案。

如果您需要開發的應用程式會使用代管於內部網路網站的 KML 檔案,建議您使用第三方 JavaScript 程式庫在用戶端轉譯 KML。由於 KML 檔案是由瀏覽器分析,效能可能會比使用 KmlLayer 類別要低。

網址簽署

我可以使用 JavaScript 簽署網址嗎?

強烈建議您不要使用 JavaScript 簽署網址,因為這可能會將您的密碼編譯金鑰公開給使用者。因此,簽章應該僅能由伺服器端元件產生。

我為何收到針對 Maps API Web 服務要求的 HTTP 403 禁止回應?

HTTP 403 回應指出權限問題,可能是因為無法為此要求驗證簽章。可能的原因有:

  1. 已指定簽章,但不是此要求的正確簽章。
  2. 要求指定 Google Maps APIs Premium Plan 用戶端編號但沒有指定簽章,而所呼叫的 Web 服務需要所有使用用戶端編號做出的要求包含有效簽章。
  3. 已指定簽章,但尚未指定關聯的 Google Maps APIs Premium Plan 用戶端編號。

設定樣式

為何商家沒出現在我的地圖上?

使用 Google Maps JavaScript API 並包含 client 參數來載入地圖時,地圖上的商家清單預設為關閉。若要將它們重新打開,您需要在地圖中包含一些樣式設定程式碼

var styles = [
  {
    featureType: 'poi.business',
    stylers: [
      { visibility: 'on' }
    ]
  }
];

map.setOptions({styles: styles});