常見問題

本頁面僅適用於舊版 Maps APIs for Work 或 Maps API for Business 授權的客戶。本頁面不適用於 2016 年 1 月推出之新版 Google Maps APIs Premium Plan 的客戶。

此常見問題涵蓋了特定於舊版 Google Maps APIs for Work 授權的問題。

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

開始使用

使用限制

使用 Google Maps APIs

KML

網址簽署

設定樣式

開始使用

Google Maps APIs for Work 中包含哪些產品?

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

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

如何聯絡 Google Maps APIs for Work 技術支援?

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

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

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

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

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

Google Maps APIs for Work 服務條款有哪些?

如果您是 Google Maps APIs for Work 客戶,請參閱您的合約以瞭解約束您的 Google Maps APIs 使用方式的條款。

使用限制

Google Maps APIs for Work 使用量是如何追蹤、報告的?
  • 針對 Google Maps APIs for Work 授權,Maps JavaScript API、Street View Image API、Static Maps API 的使用量是根據頁面檢視數計算的。

    頁面檢視數的定義為:

    1. 將 Google Maps JavaScript API 載入頁面的單次動作。每當使用 API 頁面重新載入時,Maps JavaScript API 便會重新載入。使用者和地圖的互動(例如平移、縮放、變更地圖類型)不會產生額外的頁面檢視。然而,請注意,如果將 API 載入頁面(即使您當時並未使用 API 來顯示地圖),就會產生一次頁面檢視。因此,不建議您納入會在頁面範本中載入 API 的 <script> 標記,而建議僅針對選擇性的使用者活動顯示地圖作為回應,在頁面上非同步載入 API
    2. 針對 Google Street View Image API 或 Google Static Maps API 影像的單次要求。

    Google Maps APIs for Work 客戶可以在 Google Cloud Support Portal 上追蹤頁面檢視使用量:https://google.secure.force.com/

    請注意,Google Maps APIs Standard 和 Premium Plan 應用程式受限於「地圖載入」,和頁面檢視略為不同。如需詳細資訊,請參閱 Google Maps APIs 常見問題

  • Google Maps Mobile SDK for Work 以地圖載入來追蹤使用量。如需詳細資訊,請參閱 Google Maps Mobile SDK 使用限制
  • Google Maps APIs Web 服務以要求來追蹤使用量(Google Maps Distance Matrix API 以元素來追蹤使用量)。如需詳細資訊,請參閱 Google Maps APIs Web 服務 使用限制
Google Maps JavaScript API 有哪些使用限制?

構成「頁面檢視」的要求(如上所述)會納入隨 Google Maps APIs for Work 授權購買的頁面檢視總數中計算。到達此限制時,需要立即更新您的授權。

Google Maps Mobile SDK for Work 有哪些使用限制?

每一次的地圖載入都會納入隨 Google Maps Mobile SDK for Work 授權購買的地圖載入總數中計算。到達此限制時,需要立即更新您的授權。如需詳細資訊,請參閱 Google Maps Mobile SDK 使用限制

Google Maps APIs Web 服務有哪些使用限制?

Google Maps APIs for Work 客戶有下列 Google Maps APIs Web 服務使用限制:

Web 服務 限制
路線規劃 每日配額為每 24 小時 100,000 個以上的要求,視年度合約購買量而定。每個要求最多可有 23 個途經地點。速率限制為每秒 10 個要求。
海拔 每日配額為每 24 小時 100,000 個以上的要求,視年度合約購買量而定。每個要求最多可有 512 個點。速率限制為每秒 10 個要求。
地理編碼 每日配額為每 24 小時 100,000 個以上的要求,視年度合約購買量而定。速率限制為每秒 10 個要求。
距離矩陣  每日配額為每 24 小時 100,000 個以上的元素,視年度合約購買量而定。每個查詢最多可有 625 個元素,每 10 秒最多 1,000 個元素。
時區 每日配額為每 24 小時 100,000 個以上的要求,視年度合約購買量而定。速率限制為每秒 10 個要求。
道路 每日配額為每 24 小時 100,000 個以上的要求,視年度合約購買量而定。速率限制為每秒 10 個要求。每個要求最多可包含 100 個點。

這些限制適用於各 Google Maps APIs for Work 用戶端編號或開發人員專案,並由所有使用同一用戶端編號或開發人員專案的應用程式和 IP 位址共用。

如果您需要更高的使用上限,請聯絡您的 Google Maps APIs for Work 客戶經理來取得購買資訊。

Google Places API 和 Google Maps Geolocation API 有哪些使用限制?

如果您已經隨著 Google Maps APIs for Work 合約購買 Google Places API 或 Google Maps Geolocation API,您的限制會列在 Google API Console 的「Quotas」區塊中。如果您需要更高的上限,請透過 Google Cloud Support Portal 聯絡 Google

Google Maps JavaScript API 製作的地理編碼要求有哪些使用限制?

針對 Maps JavaScript API 製作的地理編碼要求,Google Maps APIs for Work 客戶有下列使用限制:

服務 使用的 API   限制
地理編碼
Google Maps JavaScript API

無論多少使用者共用同一 IP 位址,地理編碼的每日配置和速率限制都是以每個使用者工作階段來計算。

此服務不得用於批次地理編碼操作;您應該使用 Google Maps Geocoding API 來進行這類操作。

Google Maps Image API 的使用限制為何?

Google Maps APIs for Work 客戶有下列 Google Maps Image API 使用限制:

服務 限制
Google Static Maps API

要求會納入隨 Google Maps APIs for Work 授權購買的頁面檢視總數中計算。

影像大小上限為 2048 乘以 2048 像素。這會以 size 乘以 scale 計算,如下所述。

Google Street View Image API

要求會納入隨 Google Maps APIs for Work 授權購買的頁面檢視總數中計算。

影像大小上限為 2048 乘以 2048 像素。


您可以要求最大 2048x2048 像素的 Google Static Maps API 影像。由於靜態地圖要求中的 scale 值會影響傳回的像素數量,每個拓展層級的最大 size 值會不同:

拓展 大小上限 傳回
1 2048x2048 2048x2048
2 1024x1024 2048x2048
4 512x512 2048x2048

Google Street View Image API 不支援 scale 參數。

使用 Google Maps APIs

針對不同的 Google Maps APIs 產品,我該使用何種金鑰或憑證?

每次使用 Google Maps APIs 時,您必須包含憑證來驗證您的要求。所需的憑證類型會因隨 Google Maps APIs for Work 授權使用的 API 而有所不同。針對大多數的 API,您需使用用戶端編號。在某些情況下,您需使用 API 金鑰。

  • 用戶端 ID:用戶端編號是在您註冊為 Google Maps APIs for Work 客戶時提供給您。

    使用用戶端 ID 載入 API 的範例為:&client=gme-companyname

  • 數位簽章:一般而言,Google Maps APIs for Work 客戶在使用用戶端編號驗證時,會使用數位簽章。數位簽章必須使用由 Google 提供給您的密碼編譯金鑰產生。
  • API 金鑰:API 金鑰是您使用 Google API Console 產生的唯一識別碼。API 金鑰通常用於標準 API。Google Maps APIs for Work 客戶一般會使用用戶端編號,但也有少數 API 要求使用 API 金鑰而非用戶端編號。針對要求使用 API 金鑰的 API,您可以選擇使用未套用限制的 API 金鑰(稱為「一般 API 金鑰」),或安全性更高的已套用限制金鑰(建議使用)。任何平台中的 API 都能使用一般 API 金鑰。

    如果您選擇為 API 金鑰增加限制(例如 IP 位址),一旦套用了限制,金鑰便只能在支援該限制類型的平台上運作。API 金鑰限制有四種類型:

    • 伺服器限制(依 IP 位址)- 用於 Web 服務 API
    • 瀏覽器限制(依 HTTP 參照網址)- 用於 Web API
    • Android 應用程式限制(依套件名稱和指紋)- 用於 Android API
    • iOS 應用程式限制(依 iOS 套件組合識別碼)- 用於 iOS API

    相同平台中的 API 可以使用相同的限制金鑰。

    注意:在 Google API Console 上產生金鑰時,Google Maps APIs for Work 使用者請務必選擇在註冊時為他們建立的專案。這個專案的名稱將會包括「Business」或「Work」的字眼。

    使用金鑰載入 API 的範例為:&key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

下表指出應該與每個 Google Maps APIs 產品搭配使用的憑證。(如上所述,API 金鑰限制的類型為:伺服器、瀏覽器、Android、iOS。)

API Google Maps APIs for Work 使用者
Google Maps Android API Android 限定 API 金鑰
Google Places API for Android 無法使用
Google Maps SDK for iOS iOS 限定 API 金鑰
Google Places API for iOS 無法使用
Google Maps JavaScript API 用戶端 ID
Google Static Maps API 用戶端 ID + 數位簽章
Google Street View Image API 用戶端 ID + 數位簽章
Google Maps Embed API 無法使用
Google Maps Directions API 用戶端 ID + 數位簽章
Google Maps Distance Matrix API 用戶端 ID + 數位簽章
Google Maps Elevation API 用戶端 ID + 數位簽章
Google Maps Geocoding API 用戶端 ID + 數位簽章
Google Maps Geolocation API 伺服器限制 API 金鑰
Google Maps Roads API 伺服器限制 API 金鑰
Google Maps Time Zone API 用戶端 ID + 數位簽章
Google Places API Web Service 伺服器限制 API 金鑰
如何從透過 HTTPS (SSL) 載入的頁面使用 Google Maps APIs for Work 用戶端編號存取 Google Maps APIs?

若要從透過 HTTPS 載入的頁面存取 Google Maps APIs,您首先必須授權您想使用 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 簽署網址,因為這可能會將您的密碼編譯金鑰公開給使用者。因此,簽章應該僅能由伺服器端元件產生。

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

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

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

設定樣式

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

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

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

map.setOptions({styles: styles});