Google 地圖平台常見問題

開始使用

瞭解服務條款

用量限制和計費方式

使用 Google 地圖平台

錯誤和疑難排解

Google 地圖平台服務

Maps JavaScript API

Google Maps SDK for iOS

Google Maps SDK for Android

網址簽署

開始使用

什麼是 Google 地圖平台？

Google 地圖平台是一組由 API 和 SDK 構成的產品，可讓開發人員將 Google 地圖嵌入行動應用程式和網頁中，或是從 Google 地圖擷取資料。其中提供的產品項目有很多種，您可以根據自己的需求，使用單一 API/SDK 或是 API 和 SDK 組合。

地圖介面集：

路徑介面集：

地點介面集：

環境：

如何開始使用 Google 地圖平台？

請參閱「開始使用 Google 地圖平台」一文。

我需要哪一種 API？

如想瞭解如何根據自己的功能需求找到適合的 API，請參閱 Capabilities Explorer。

如何開始在我的網站上使用 API？

請根據您感興趣的 API 或 SDK，參閱相關的「總覽」、「開發人員」及「入門指南」。如需說明範例，請參閱 Maps SDK for Android 或 Maps JavaScript API。

Google 地圖平台的資料涵蓋哪些國家/地區？

Google 地圖團隊持續增加新的地圖資料，將逐漸涵蓋更多國家/地區。如需涵蓋範圍的最新資訊，請參閱 Google 地圖涵蓋範圍資料。網頁頂端顯示的篩選框可以讓您篩選資料。如果 Google 與資料供應商之間的授權協議有所變動，涵蓋範圍資料也會跟著調整。

另請參閱：

如不使用 Google 地圖平台產品，我還能在網站上嵌入 Google 地圖嗎？

可以。Google 地圖現在能讓您將目前正在查看的地圖，直接嵌入網站或網誌，不必撰寫任何程式碼或使用 Google 地圖平台。詳情請參閱這裡的說明。

如何在行動裝置上提供 Google 地圖應用程式？

如要將地圖整合至 Android 應用程式，請使用 Maps SDK for Android。

如要將地圖整合至 iOS 應用程式，請使用 Maps SDK for iOS。

經過開發人員的調整，Maps JavaScript API 現已支援行動裝置，並適用於瀏覽器應用程式，可在 Apple iPhone 等具備網路瀏覽器 (內建完整 JavaScript 支援) 的裝置和電腦上使用。

如果應用程式支援的裝置無法使用 Maps JavaScript API，Maps Static API 會傳送 GIF、JPG 和 PNG 格式的地圖圖片，包括標記和折線。請注意，如果要在瀏覽器應用程式外使用 Maps Static API，您必須將地圖圖片連結至 Google 地圖。

Maps JavaScript API 和 Maps Embed API 支援哪些網路瀏覽器？

Maps JavaScript API 和 Maps Embed API 支援下列網路瀏覽器：

電腦
  • 最新版本的 Microsoft Edge (Windows)，不包括 IE 模式。
  • Firefox 兩個最新的主要穩定版 (Windows、macOS 和 Linux)。
  • Chrome 兩個最新的主要穩定版 (Windows、macOS 和 Linux)。
  • Safari 兩個最新的主要穩定版 (macOS)。
Android
  • 最新版本的 Chrome (Android 4.1+ 版)。
  • Chrome WebView (Android 4.4+ 版)。
iOS
  • iOS 主要版本中最新版及前一版的行動版 Safari。
  • iOS 主要版本中最新版及前一版的 UIWebView 和 WKWebView。
  • 最新版的 Chrome (iOS 版)。
我可以使用 Maps JavaScript API 列印地圖嗎？

我們不支援透過 Maps JavaScript API 列印，這是因為常用瀏覽器中支援的列印功能各有不同。

Google 地圖平台產品有任何異動時，我要如何收到通知？

建議您訂閱 Google 地圖平台網誌，掌握 Google 地理開發人員各項功能項目的最新進展與消息。

我要如何與技術支援人員聯絡？

如要瞭解可用的支援選項，請參閱 Google 地圖平台支援和資源。

技術支援的服務時間是什麼時候？
支援團隊的服務範圍是「地圖平台服務無法使用」的情況；服務時間為平日 24 小時全天候無休 (東京時間週一上午 9 點至太平洋時間週五下午 5 點)，地區性假日不提供服務。
如何恢復 Google 帳戶的存取權限？

如果您已經無法存取自己的 Google 帳戶 (例如 [email protected] 或 [email protected])，可擷取或重設密碼，嘗試取回帳戶。請造訪 Google 帳戶說明中心，參閱「如何復原您的 Google 帳戶或 Gmail」一文。

如何恢復特定專案的存取權限？

如果您已經無法存取用來管理 Google 地圖平台服務的專案，可以嘗試復原該專案。

如果您可以存取與專案相關聯的 Google 帳戶：

如果您 無法存取與專案相關聯的 Google 帳戶：

我可以在搭載 ARM 的 Mac 上使用 Maps SDK for iOS 和 Places SDK for iOS 嗎？

您可以在搭載新 ARM 的 Mac 上進行開發工作，不過必須在實體 iOS 裝置中建構和執行。這項限制只是暫時的，我們正持續擴大支援，讓開發人員可以透過模擬工具進行開發。

瞭解服務條款

Google 地圖平台產品的服務條款有什麼內容？

《Google 地圖平台服務條款》已列載於以下網址：

https://cloud.google.com/maps-platform/terms

我的網站符合《Google 地圖平台服務條款》的規定嗎？

只要您的網站符合《Google 地圖平台服務條款》的規定，就可以在應用程式內使用 Google 地圖平台。

不過，我們並不樂見 Google 地圖平台遭到不當使用。例如用來標示城市內可購買禁藥的地方，或從事任何非法活動。此外，我們也尊重個人隱私，請勿使用 Google 地圖平台來洩露個人隱私資訊。

建議您先向律師諮詢，確認應用程式符合《Google 地圖平台服務條款》的規定，再開發及推出應用程式。Google 工程師只能提供技術協助，無法提供任何法律諮詢。Google 保留相關權利，得以隨時暫停或終止您對本服務的使用權限，請務必詳閱《Maps API 條款》。

我可以直接存取地圖圖塊和衛星圖像嗎？

除了使用 Google 地圖平台，您無法透過任何其他機制 (例如建立自己的地圖 API 或使用大量圖塊下載指令碼) 存取地圖圖塊或衛星圖像。如果您的應用程式是透過 Google 地圖平台以外的途徑存取圖塊，該應用程式的存取權限將會遭到封鎖。詳情請參閱《Google 地圖平台服務條款》。

我可以將 Google 地圖平台產品用於追蹤應用程式嗎？

只要應用程式符合《Google 地圖平台服務條款》的規定，透過 Google 地圖平台產品顯示即時資料的功能 (即追蹤)，就不會受到任何限制。

我可以在非網頁應用程式中使用 Google 地圖嗎？

可以，Google 地圖平台產品現在可以在非網頁應用程式中使用，但必須遵循《Google 地圖平台服務條款》的其他適用限制。

Maps JavaScript API 只能在這些支援的瀏覽器中執行。

我可以在有密碼保護的網站上使用 Google 地圖平台產品嗎？

沒問題，您可以在私人存取的應用程式中使用 Google 地圖介面集、路徑介面集、地點介面集和環境服務。詳情請參閱《Google 地圖平台服務條款》。

我可以建立文件中內含 Google 地圖平台資料的應用程式嗎？

假如您的應用程式會產生任何電子或紙本形式的文件 (包括圖片)，則文件內不得包含任何來自 Google 地圖平台的資料。 詳情請參閱《Google 地圖平台服務條款》的「禁止爬梳」(No Scraping) 一節。

如何讓 Google 搜尋結果停止收錄我的內容？

我們已停止收集這項資料。indexing 參數已淘汰不用，因此不會產生任何作用。雖然您並不需要另行選擇停用，但我們建議您盡早移除該參數。

如要從搜尋結果中移除您的網頁或網站，請遵循說明中心提供的 操作指示。

我可以使用 Maps Static API 產生地圖圖片，並在我的網站上儲存與提供該圖片嗎？

您無法在自家網站上儲存及提供透過 Maps Static API 產生的圖片。所有要求靜態圖片的網頁都必須將 HTML img 標記的 src 屬性或 HTML div 標記的 CSS background-image 屬性直接連結至 Maps Static API，讓所有地圖圖片顯示在網頁的 HTML 內容中，再由 Google 直接向使用者提供圖像。

用量限制和計費方式

如何為專案設定帳單資訊？
請參閱「開始使用 Google 地圖平台」一文。
Google Cloud 免費方案客戶如何升級至付費帳戶？
Google Cloud 免費方案計畫提供 $300 美元的抵免額，讓客戶免付費試用任何 Google Cloud 服務，包括 Google 地圖平台 (簡稱「GMP」) API，但免費試用期結束後，必須升級為付費帳戶，才能繼續使用這些服務。如要升級為付費帳戶，請前往 Cloud 控制台。
Google 地圖平台是否有用量限制？

針對向 Google 地圖平台產品發出的要求數，我們並未設定任何每日上限，唯一的用量限制是每分鐘查詢次數 (QPM)。

下表列出各項 API 的用量限制。您可以在 Cloud 控制台中查看及修改配額限制。

API 用量限制
Address Validation 每分鐘 6,000 次查詢
Aerial View: Lookup Video 每分鐘 180 次查詢，每天 100,000 次查詢
Aerial View: Render Video 每分鐘 100 次查詢，每天 100 次查詢
空氣品質 每分鐘 6,000 次查詢
Maps JavaScript API：3D 地圖 每分鐘 30,000 次查詢
Maps JavaScript API：動態地圖 每分鐘 30,000 次查詢
Elevation 每分鐘 6,000 次查詢
Geocoding 每分鐘 3,000 次查詢
Geolocation 每分鐘 6,000 次查詢
Map Tiles API：2D 地圖圖塊 每分鐘 6,000 次查詢，每天 15,000 次查詢
Map Tiles API：街景服務圖塊 每分鐘 6,000 次查詢，每天 15,000 次查詢
Map Tiles API：擬真成像 3D 圖塊 每分鐘 12,000 次查詢，每天 10,000 個根要求。
導覽：設定目的地要求 每分鐘 30,000 次查詢
地點 每分鐘 6,000 次查詢
Places Aggregate 每分鐘 1,200 次查詢
Pollen 每分鐘 6,000 次查詢
Roads 每分鐘 30,000 次查詢
Route：Compute Routes 每分鐘 3,000 次查詢
Routes：Compute Route Matrix 每分鐘 3,000 個元素
Solar 每分鐘 600 次查詢
Static Maps 每分鐘 30,000 次查詢
Street View Image API 每分鐘 30,000 次查詢
Time Zone 每分鐘 30,000 次查詢
天氣 每分鐘 6,000 次查詢

如要控管支出，您可以監控 API 用量，並針對任何可計費 API 的所有要求設定每日上限。

部署 Google 地圖平台產品時，請務必遵循標準版《Google 地圖平台服務條款》。

如何計算使用費？

如需 Google 地圖平台產品定價總覽，請參閱價目表。

如要進一步瞭解 Google 地圖平台 API 的計費方式，請參閱「Google 地圖平台計費和定價總覽」一文。

Google 地圖平台如何計算地圖載入量？

發生下列任一情況即計為一次地圖載入：

  • 使用 Maps JavaScript API 顯示地圖的網頁或應用程式。
  • 應用程式向 Maps Static API 要求單一地圖圖片。

街景服務全景和地圖載入量現已分開計費。

  • 每次向 Street View Static API 要求嵌入靜態 (非互動式) 街景服務全景，系統會計為一次靜態街景服務全景。
  • 每次針對 Maps JavaScript API、Maps SDK for Android、Maps SDK for iOS 應用程式中的全景物件執行個體化，即計為一次動態街景服務全景。

網頁或應用程式載入地圖、靜態地圖圖片或街景服務全景後，使用者與這些元素之間的任何互動 (例如平移、縮放或切換地圖圖層)，都不會產生額外的地圖載入量或影響用量限制。

新增標記不會造成地圖載入量增加，但確認圖釘位置的方式 (例如載入或重新載入 google.maps.Map() 類別) 可能會產生相關費用。

如何監控用量？

您可以在 Google Cloud 控制台中監控個別 API 的用量。

  1. 選取您要查看的 API 所屬的專案。
  2. 在資訊主頁的 API 清單中，按一下 API 名稱。
  3. 在頁面頂端附近，按一下「指標」或「配額」。

如要查看整個專案的流量報表和帳單資訊，請按照以下步驟操作：

  1. 如果您尚未設定帳單資訊，請先進行設定。
  2. 前往 Cloud 控制台的帳單頁面。
  3. 選取專案。
  4. 在左側欄中，按一下「報表」。使用右側欄的篩選器，即可查看帳單帳戶的報表。

詳情請參閱「Google 地圖平台報表」、「Google 地圖平台監控」和「設定配額限制」。

超過要求比率 (每分鐘查詢次數) 限制會怎麼樣？

如果超過特定 Google 地圖平台產品的每分鐘查詢次數限制，API 會傳回錯誤訊息。要是屢次超過上限，系統可能會暫時封鎖您的 API 存取權限。

如果您超過要求的每分鐘查詢次數限制或濫用服務，該要求會傳回特定錯誤訊息。假如您繼續超過限制，系統可能會暫時封鎖您的 Google 地圖平台存取權限。

注意：下列 Web 服務 API 在 Maps JavaScript API 中提供同等的用戶端服務：Elevation、Geocoding。

超過用量限制

如果超過用量限制，就會收到 OVER_QUERY_LIMIT 狀態碼回應。

這表示 Web 服務已停止正常回應，並改為只傳回狀態碼 OVER_QUERY_LIMIT，直到再次可用為止。假如是因為應用程式每分鐘傳送的要求數量過多而收到這項錯誤，這種情況可能會在幾秒內發生。

如果您經常超過每分鐘查詢次數用量限制，不妨考慮調整應用程式，以更有效率的方式使用 Google 地圖平台產品，藉此降低用量，或是申請增加配額。詳情請參閱最佳化指南。

我的網站流量很大，可以使用 Google 地圖平台產品嗎？

可以。但我們建議您詳閱適用的 Google 地圖平台產品用量限制，瞭解應用程式使用這些產品的相關規定。

建立帳單帳戶後，如果您超過免費用量上限，且未在帳單帳戶中提供有效的付款方式 (例如信用卡或銀行轉帳)，API 就會停止運作，直到您新增有效的付款方式。

如何計算用量及收費？

我們會在每天結束時，按照價目表的價格計算用量，並於每月月底以您帳單帳戶連結的付款方式，向您收取總用量費用。詳情請參閱「Google 地圖平台計費方式」一文。

使用 Google 地圖平台需要支付多少費用？

如需各項 API 費用總覽，請參閱價目表。只要應用程式產生的要求或地圖載入量，不超過當月的免費用量上限，則不必支付任何費用；但要是用量超過免費使用上限，我們就會向您的帳單帳戶收費。詳情請參閱「Google 地圖平台計費方式」一文。

是否能查看以其他幣別為單位的定價資訊？

您可以在控制台內查看其他幣別的定價資訊。如果您選取其他貨幣，系統會根據價目表中對應的美元換算費率。

我已經完成帳單設定，要如何查看帳單？

Google 會在每月月初根據您指定的付款方式，向您收取上個月的活動費用。如需帳單詳細資料，請參閱「Google 地圖平台計費方式」一文。

其他資源：

萬一用量突然無預警增加，我要如何避免帳單金額暴增？

Google 地圖平台設有一些功能，讓您指定每日要求上限和每日計費上限。比如說，您可以設定每日用量上限，以防費用突然無預警增加；也可設定預算快訊，一旦帳單帳戶費用達到指定門檻，就會收到電子郵件通知。

設定每日計費上限：

為避免帳單費用暴增，不妨設定每日用量上限，以防用量無預警增加。您可以在 Cloud 控制台中變更這項限制

設定及管理預算快訊：

只要設定預算快訊，系統就會在帳單帳戶費用達到指定門檻時，寄送電子郵件通知給帳單管理員。當帳單帳戶的預估費用超過指定門檻的 50%、90% 和 100%，帳單管理員都會收到電子郵件通知。

我收到一則訊息，當中提及我的專案已連結至「Google 地圖平台轉換帳戶」，但我沒有這個帳戶的存取權限，該怎麼做？

我們之所以建立「Google 地圖平台轉換帳戶」，是為了協助某些客戶轉換至即付即用定價方案。Google 會透過這個轉換帳戶，提供免付費方案的 $200 美元一次性抵免額給客戶，獲得抵免額的客戶可繼續使用 Google 地圖平台，直到用完該額度。一旦超過額度上限，帳單帳戶就會關閉，而您將無法再使用 Google 地圖平台服務。為避免服務中斷，我們極力建議您設定自己的帳單帳戶，這樣就能繼續享有每月免費用量上限。如要變更專案的帳單帳戶，請按照下列指示操作：

  1. 建立新的帳單帳戶 (如果您已有帳單帳戶，可以跳過這個步驟)。
  2. 將帳單帳戶連結至自有專案。
為什麼我的配額限制設定為每天 1 次要求？要如何提高上限？

如果您尚未建立帳單帳戶並連結至專案，則 Google 地圖平台 API 每天只能傳送 1 次要求。只要建立並連結帳單帳戶，就能獲得更多配額。相關操作說明請參閱「開始使用 Google 地圖平台」一文。

一旦建立並連結帳單帳戶，系統就會幫您移除每日配額限制。您可以在 Cloud 控制台中設定限制，避免非預期的支出。

我收到了帳單違規通知，該如何解決這個問題？

Google 判定您的帳戶設定了多個帳單帳戶，因此我們寄送這則通知給您。這違反了《Google 地圖平台服務條款》中定義的 Google 條款規定。該等條款禁止使用者建立多個帳單帳戶。 詳情請參閱帳單帳戶違規常見問題。

使用 Google 地圖平台

我該針對不同的地圖產品使用哪組金鑰或憑證？

每次使用 Google 地圖平台產品，都要提供 API 金鑰驗證要求。Google 地圖平台支援 Android、iOS 或網頁應用程式，也可透過 HTTP Web 服務使用。

API 金鑰：

  • API 金鑰是您使用 Cloud 控制台產生的一組專屬 ID。
  • 使用金鑰載入 API 的範例：&key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

數位簽章：

  • 數位簽章須使用 Google 提供給您的網址簽署密鑰來產生，可與 Maps Static API 及 Street View Static API 搭配使用。

限制：

  • 雖然 API 金鑰限制為選用功能，但我們極力建議您限制所有 API 金鑰，進一步提升安全性。詳情請參閱 API 安全性最佳做法。
  • 您可以對 API 金鑰新增應用程式限制。 一旦設下限制，該金鑰就只能在支援該類限制的平台上使用。 共有四種應用程式限制可以設定。強制執行相同限制類型的 API 可以使用同一組受限制的金鑰。
  • 您也可以對 API 金鑰新增 API 限制。詳情請參閱「取得、新增及限制 API 金鑰」一文。

下表列出每個 Google 地圖平台 API/SDK 的金鑰/憑證和應用程式限制。

API/SDK 憑證和應用程式限制
Maps SDK for Android 具有 Android 限制的 API 金鑰1
Places SDK for Android 具有 Android 限制的 API 金鑰1
Navigation SDK for Android 具有 Android 限制的 API 金鑰1
Maps SDK for iOS 具有 iOS 限制的 API 金鑰1
Places SDK for iOS 具有 iOS 限制的 API 金鑰1
Navigation SDK for iOS 具有 iOS 限制的 API 金鑰1
Maps JavaScript API 具有 HTTP 參照網址限制的 API 金鑰1
Map Tiles API 具有 IP 位址限制的 API 金鑰1
Maps Datasets API OAuth 權杖
Aerial View API 具有 IP 位址限制的 API 金鑰1
Maps Static API 具有 HTTP 參照網址限制的 API 金鑰1 + 數位簽章2
Street View Static API 具有 HTTP 參照網址限制的 API 金鑰1 + 數位簽章2
Maps Embed API 具有 HTTP 參照網址限制的 API 金鑰1
Address Validation API 具有 IP 位址限制的 API 金鑰1
Elevation API 具有 IP 位址限制的 API 金鑰1
Geocoding API 具有 IP 位址限制的 API 金鑰1
Geolocation API 具有 IP 位址限制的 API 金鑰1
Places API 具有 IP 位址限制的 API 金鑰1
Places Aggregate API 具有 IP 位址限制的 API 金鑰1
Roads API 具有 IP 位址限制的 API 金鑰1
Routes API 具有 IP 位址限制的 API 金鑰1
Time Zone API 具有 IP 位址限制的 API 金鑰1
Air Quality API 具有 IP 位址限制的 API 金鑰1
Pollen API 具有 IP 位址限制的 API 金鑰1
Solar API 具有 IP 位址限制的 API 金鑰1
Weather API 具有 IP 位址限制的 API 金鑰1
1 雖然 API 金鑰限制為選用功能，但我們極力建議您限制所有 API 金鑰，進一步提升安全性。
2 視使用情況而定，Maps Static API 和 Street View Static API 可能會要求您提供數位簽章；但不管是什麼用途，我們極力建議您一起使用 API 金鑰和數位簽章來驗證要求。
如何將金鑰限制類型從 HTTP 參照網址變更為 IP 位址限制？

重要事項：如果您使用的 Web 服務 API 內含設有參照連結限制的 API 金鑰，則要求將會失敗並傳回下列錯誤訊息：「使用此 API 時，API 金鑰不能含有參照連結限制」。請改用設有 IP 位址限制的 API 金鑰。

在將 API 金鑰的限制類型從 HTTP 參照網址改為 IP 位址之前，請確保所有使用該 API 金鑰的 API 都支援 IP 限制類型。同一個限制類型的 API 可使用同一組受限制的金鑰。如要強制執行多項限制，請另外新增一組金鑰並設定您需要的限制。瞭解如何