Google 地圖平台常見問題

為什麼Google 地圖平台地理編碼器提供的地點與Google 地圖上的不同？ ... 您無法在自家網站上儲存及提供透過Maps Static API 產生的圖片。

Google 地圖平台 總覽 產品 定價 說明文件 開始使用 開始使用Google地圖平台 API挑選器 計費和定價方式 報表與監控 地圖ID 常見問題 支援與資源 事件管理 地圖介面集 MapsJavaScriptAPI MapsSDKforAndroid MapsSDKforiOS MapsStaticAPI StreetViewStaticAPI MapsEmbedAPI 地圖網址 MapsElevationAPI 路徑介面集 DirectionsAPI DistanceMatrixAPI RoadsAPI 解決方案 產業解決方案 遊戲服務 運輸與物流 地點介面集 PlacesAPI PlacesSDKforAndroid PlacesSDKforiOS PlacesLibrary、MapsJavaScriptAPI GeocodingAPI GeolocationAPI TimeZoneAPI 其他資源 API安全性最佳做法 地圖涵蓋範圍詳細資料 最佳化指南 行動作業系統和軟體支援 淘汰項目 資產追蹤方案 根憑證授權單位遷移常見問題 網址編碼 WordPress使用者 網誌 社群 StackOverflow GitHub YouTube Discord Twitter IssueTracker Language English BahasaIndonesia Deutsch Español Español–AméricaLatina Français Português–Brasil Русский 中文–简体 中文–繁體 日本語 한국어 登入 說明文件 Google 地圖平台 總覽 產品 定價 說明文件 More 網誌 社群 More Google地圖平台說明文件 開始使用 開始使用Google地圖平台 API挑選器 地圖ID 常見問題 支援與資源 事件管理 最佳做法 API安全性最佳做法最佳化指南最佳化網路服務使用情形 計費和定價方式 計費和定價方式總覽 計費方式 定價方式 公共計畫 報表與監控 報表與監控總覽 報表 監控 地圖介面集 MapsJavaScriptAPI MapsSDKforAndroid MapsSDKforiOS MapsStaticAPI StreetViewStaticAPI MapsEmbedAPI 地圖網址 路徑介面集 DirectionsAPI DistanceMatrixAPI RoadsAPI 地點介面集 PlacesAPI PlacesSDKforAndroid PlacesSDKforiOS PlacesLibrary、MapsJavaScriptAPI GeocodingAPI GeolocationAPI TimeZoneAPI ElevationAPI 解決方案 產業解決方案 零售 遊戲服務 其他資源 地圖涵蓋範圍詳細資料 行動作業系統和軟體支援 淘汰項目 資產追蹤方案 根憑證授權單位遷移常見問題 網域 正式發布前檢查清單 付費方案 網址編碼 WordPress使用者 開始使用 開始使用Google地圖平台 API挑選器 計費和定價方式 報表與監控 地圖ID 常見問題 支援與資源 事件管理 地圖介面集 MapsJavaScriptAPI MapsSDKforAndroid MapsSDKforiOS MapsStaticAPI StreetViewStaticAPI MapsEmbedAPI 地圖網址 MapsElevationAPI 路徑介面集 DirectionsAPI DistanceMatrixAPI RoadsAPI 解決方案 產業解決方案 遊戲服務 運輸與物流 地點介面集 PlacesAPI PlacesSDKforAndroid PlacesSDKforiOS PlacesLibrary、MapsJavaScriptAPI GeocodingAPI GeolocationAPI TimeZoneAPI 其他資源 API安全性最佳做法 地圖涵蓋範圍詳細資料 最佳化指南 行動作業系統和軟體支援 淘汰項目 資產追蹤方案 根憑證授權單位遷移常見問題 網址編碼 WordPress使用者 StackOverflow GitHub YouTube Discord Twitter IssueTracker 首頁 產品 Google地圖平台 說明文件 提供意見 Google地圖平台常見問題 開始使用 什麼是Google地圖平台？ 如何開始使用Google地圖平台？ 我需要哪一種API？ 如何開始在我的網站上使用API？ Google地圖平台的資料涵蓋哪些國家/地區？ 如不使用Google地圖平台產品，我還能在網站上嵌入Google地圖嗎？ 如何在行動裝置上提供Google地圖應用程式？ MapsJavaScriptAPI和MapsEmbedAPI支援哪些網路瀏覽器？ 我可以使用MapsJavaScriptAPI列印地圖嗎？ Google地圖平台產品有任何異動時，我要如何收到通知？ 我該如何與技術支援人員聯絡？ 技術支援的服務時間是什麼時候？ 如何重新取得Google帳戶的存取權限？ 如何重新取得特定專案的存取權限？ 我可以在搭載ARM的Mac上使用地圖和PlacesSDKforiOS嗎？ 瞭解服務條款 Google地圖平台產品的服務條款有什麼內容？ 我的網站符合《Google地圖平台服務條款》的規定嗎？ 我可以直接存取地圖圖塊和衛星圖像嗎？ 我可以將Google地圖平台產品用於追蹤應用程式嗎？ 我可以在非網頁應用程式中使用Google地圖平台產品嗎？ 我可以在有密碼保護的網站上使用Google地圖平台產品嗎？ 我可以建立文件中內含Google地圖平台資料的應用程式嗎？ 如何讓Google搜尋結果停止收錄我的內容？ 我可以使用MapsStaticAPI產生地圖圖片，並在我的網站上儲存與提供該圖片嗎？ 用量限制和計費方式 如何為專案設定帳單資訊？ GoogleCloudPlatform的免費方案客戶如何升級至付費帳戶？ Google地圖平台是否有用量限制？ 如何計算使用費？ Google地圖平台如何計算地圖載入量？ 我要如何監控配額的使用情形？ 如果超過用量限制會怎麼樣？ 我的網站流量很大，可以使用Google地圖平台產品嗎？ 如果我的網站或應用程式突然大受歡迎，我的地圖會停止運作嗎？ 如何計算用量及計費？ 使用Google地圖平台需要支付多少費用？ 是否能查看以其他幣別為單位的定價資訊？ 我已經完成帳單設定，要如何查看帳單？ 萬一用量突然無預警增加，我要如何避免帳單金額暴增？ 我收到一則訊息，當中提及我的專案已連結至「Google地圖平台轉換帳戶」，但我沒有這個帳戶的存取權限，該怎麼做？ 為什麼我的配額限制設定為每天1次要求？要如何提高上限？ 我收到了帳單違規通知，該如何解決這個問題？ 使用Google地圖平台 我該針對不同的Google地圖平台產品使用哪組金鑰或憑證？ 如何將金鑰限制類型從HTTP參照網址變更為IP位址限制？ 如何取得新的API金鑰？ 如何查看每個Google地圖平台版本的變更項目？ 如何在網頁載入之後，以非同步方式將API載入該網頁？ 如何用英文以外的語言顯示Google地圖平台產品？ 可以透過安全資料傳輸層(SSL)(HTTPS)存取Google地圖平台嗎？ 如何在Google地圖平台中回報錯誤或提出新功能建議？ Google地圖平台的各項API如何使用網站Cookie？ 我找不到問題的解答，該與誰聯絡？ 錯誤和疑難排解 這個錯誤代表什麼意義？ 我的地圖顏色看起來比平常深，為什麼會這樣？ 如何解決錯誤代碼為OVER_DAILY_LIMIT或OVER_QUERY_LIMIT的問題？ 如何解決錯誤代碼為kGMSPlacesRateLimitExceeded或9005PLACES_API_RATE_LIMIT_EXCEEDED的問題？ 如何解決「這個IP、網站或行動應用程式未獲權使用此API金鑰」的錯誤？ 如何解決「具有參照連結限制的API金鑰無法搭配此API使用」的錯誤？ Google地圖平台服務 我需要將地址轉換成經緯度的格式組合，Google地圖平台是否支援此功能？ 哪些國家/地區可以使用地理編碼？ 為什麼Google地圖平台地理編碼器提供的地點與Google地圖上的不同？ 如何設定我的地理編碼器查詢格式，才能盡可能提高要求的成功率？ 如何設定美國編號公路的地址格式，以便進行地理編碼？ 何時應該使用API地理編碼器類別？何時應該使用HTTP地理編碼服務？ 如何透過Google地圖平台提供行車路線？ 哪些國家/地區可以使用行車路線功能？ 哪些國家/地區可以使用大眾運輸路線功能？ MapsJavaScriptAPI支援哪些KML和GeoRSS功能？ 使用MapsJavaScriptAPI的KmlLayer類別顯示KML時，KML大小和複雜度有什麼限制？ 如何在地圖上算繪由內部網路網站代管的KML檔案？ MapsStaticAPI支援的路徑端點或標記數量上限是多少？ 為何無法在特定國家/地區使用Google地圖平台產品？ 如何回報Google基本地圖問題？ 系統如何針對使用MapsJavaScriptAPI的服務監控成效？ GoogleMapsSDKforiOS 在Xcode12中，無法正確建構要用於模擬工具的應用程式，要如何修正這個問題？ 如何解決「kGMSPlacesRateLimitExceeded」錯誤？ 我在使用iOS8.x裝置進行偵錯時，遇到當機/異常終止狀況，該怎麼做？ 圓邊角且較寬的螢幕對於GoogleMapsiOSSDK有何影響？ GoogleMapsSDKforAndroid 如何解決「9001Operationfailedduetoexceedingthequotausagelimit」錯誤？ 我的應用程式只會顯示灰色空白圖塊，不會顯示地圖。

該如何解決這個問題？ 網址簽署 我可以使用JavaScript簽署網址嗎？ 為什麼我的MapsAPI網路服務要求收到「HTTP403禁止」的回應訊息？ 開始使用 什麼是Google地圖平台？ Google地圖平台是一組由API和SDK構成的產品，可讓開發人員將Google地圖嵌入行動應用程式和網頁中，或是從Google地圖擷取資料。

其中提供的產品項目有很多種，您可以根據自己的需求，使用單一API/SDK或是API和SDK組合。

地圖介面集： MapsJavaScriptAPI MapsSDKforAndroid MapsSDKforiOS MapsStaticAPI StreetViewStaticAPI 地圖網址 MapsEmbedAPI 路徑介面集： DirectionsAPI DistanceMatrixAPI RoadsAPI 地點介面集： PlacesAPI PlacesSDKforAndroid PlacesSDKforiOS MapsJavaScriptAPI地點資料庫 GeocodingAPI GeolocationAPI TimeZoneAPI 如何開始使用Google地圖平台？ 請參閱「開始使用Google地圖平台」一文。

我需要哪一種API？ 如想瞭解如何根據自己的功能需求找到適合的API，請參閱API挑選器。

如何開始在我的網站上使用API？ 請根據您感興趣的API或SDK，參閱相關的「總覽」、「開發人員」及「入門指南」。

如需說明範例，請參閱MapsSDKforAndroid或MapsJavaScriptAPI。

Google地圖平台的資料涵蓋哪些國家/地區？ Google地圖團隊持續增加新的地圖資料，將逐漸涵蓋更多國家/地區。

如需有關涵蓋範圍的最新資訊，請參閱Google地圖涵蓋資料。

網頁頂端的篩選器方塊可用來篩選資料。

請注意，如果Google與資料提供者之間的授權協議有所變動，涵蓋資料也會跟著調整。

另請參閱： 如何用英文以外的語言顯示Google地圖平台產品？ 哪些國家/地區可以使用大眾運輸路線功能？ 如不使用Google地圖平台產品，我還能在網站上嵌入Google地圖嗎？ 可以，Google地圖現在能讓您將目前正在查看的地圖，內嵌至您的網站或網誌，不必撰寫任何程式碼或使用Google地圖平台。

詳情請參閱這裡的說明。

如何在行動裝置上提供Google地圖應用程式？ 如要將地圖整合至Android應用程式，請使用MapsSDKforAndroid。

如要將地圖內嵌至原生的iOS應用程式，請使用GoogleMapsSDKiOS。

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

如果應用程式支援的裝置無法使用MapsJavaScriptAPI，MapsStaticAPI會傳送GIF、JPG和PNG格式的地圖圖片，包括標記和折線。

請注意，如果要在瀏覽器應用程式外使用MapsStaticAPI，您必須將地圖圖片連結至Google地圖。

MapsJavaScriptAPI和MapsEmbedAPI支援哪些網路瀏覽器？ MapsJavaScriptAPI和MapsEmbedAPI支援下列網路瀏覽器： 電腦 最新版本的MicrosoftEdge(Windows) 最新版本及前一個版本的Firefox(Windows、macOS、Linux) 最新版本及前一個版本的Chrome(Windows、macOS、Linux) 最新版本及前一個版本的Safari(macOS) 自2021年8月起，InternetExplorer11使用者會在地圖頂端看到警告訊息。

支援InternetExplorer11的最新版MapsJavaScriptAPI為3.47版。

我們將在2022年8月完全停止支援InternetExplorer11。

Edge中的IE模式也是如此。

Android 最新版本的Chrome(Android4.1+版)。

ChromeWebView(Android4.4+版)。

iOS iOS主要版本中最新版及前一版的行動版Safari。

iOS主要版本中最新版及前一版的UIWebView和WKWebView。

最新版的Chrome(iOS版)。

我可以使用MapsJavaScriptAPI列印地圖嗎？ 我們不支援透過MapsJavaScriptAPI列印，這是因為常用瀏覽器中支援的列印功能各有不同。

Google地圖平台產品有任何異動時，我要如何收到通知？ 建議您訂閱Google地圖平台網誌，掌握Google地理開發人員各項功能項目的最新進展與消息。

我該如何與技術支援人員聯絡？ 如要瞭解可用的支援選項，請參閱Google地圖平台支援和資源。

技術支援的服務時間是什麼時候？ 支援團隊會針對「地圖平台服務無法使用」的情況提供支援，服務時間為平日24小時全天候無休(東京時間週一上午9點至太平洋時間週五下午5點)，地區性假日不提供服務。

如何重新取得Google帳戶的存取權限？ 如果您已經無法存取自己的Google帳戶(例如[email protected]或[email protected])，可以嘗試擷取或重設密碼來取回帳戶。

請造訪Google帳戶說明中心，參閱「如何復原您的Google帳戶或Gmail」一文。

注意：如要復原GSuite帳戶的存取權，請向您的機構管理員提出取消刪除帳戶的要求。

如何重新取得特定專案的存取權限？ 如果您已經無法存取用來管理Google地圖平台服務的專案，可以嘗試復原該專案。

如果您可以存取與專案相關聯的Google帳戶： 如果您知道專案擁有者，且擁有Google帳戶存取權：請要求專案擁有者將您新增為專案擁有者或專案編輯者。

如果您的專案隸屬於某個機構：請與機構 管理員聯絡，並要求其將您新增為專案擁有者。

如果您不知道任何目前的專案擁有者：如果您不知道專案擁有者是誰或無法聯絡專案擁有者，請洽詢支援團隊，瞭解其他復原專案的方式。

如果您無法存取與專案相關聯的Google帳戶： 如果您已經無法存取自己的Google帳戶：請嘗試復原帳戶的使用者名稱或密碼。

如果您無法取回Google帳戶：請建立新的Google帳戶，然後與目前的專案擁有者聯絡，要求對方將您的新Google帳戶加入專案中。

我可以在搭載ARM的Mac上使用MapsSDKforiOS和PlacesSDKforiOS嗎？ 您可以在以搭載新ARM的Mac上進行開發，不過必須在實體iOS裝置上建構和執行。

這項限制只是暫時的，我們正持續擴大支援在模擬工具上進行開發。

瞭解服務條款 Google地圖平台產品的服務條款有什麼內容？ 《Google地圖平台服務條款》已列載於以下網址： https://cloud.google.com/maps-platform/terms 我的網站符合《Google地圖平台服務條款》的規定嗎？ 只要您的網站符合《Google地圖平台服務條款》規定，就可以在應用程式內使用Google地圖平台。

不過，我們並不樂見Google地圖平台被拿來不當使用，例如指出城市裡哪些地方可以購買禁藥，或用來從事任何非法活動。

此外，我們也尊重個人隱私，請勿使用Google地圖平台來洩露個人隱私資訊。

建議您在開發及推出應用程式之前，先向律師諮詢，確認您的應用程式是否符合《Google地圖平台服務條款》的規定。

Google工程師只能提供技術協助，無法提供任何法律諮詢。

Google保留相關權利，得以隨時暫停或終止您對本服務的使用權限，請務必詳閱《MapsAPI條款》。

我可以直接存取地圖圖塊和衛星圖像嗎？ 除了使用Google地圖平台，您無法透過任何其他機制(例如建立自己的地圖API或使用大量圖塊下載指令碼)來存取地圖圖塊或衛星影像。

如果您的應用程式是透過Google地圖平台以外的途徑存取圖塊，系統將會封鎖其存取權限。

詳情請參閱《Google地圖平台服務條款》。

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

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

MapsJavaScriptAPI只能在這些支援的瀏覽器中執行。

我可以在有密碼保護的網站上使用Google地圖平台產品嗎？ 沒問題，您可以在私人存取的應用程式中使用Google地圖介面集、路徑介面集、地點介面集服務。

詳情請參閱《Google地圖平台服務條款》。

我可以建立文件中內含Google地圖平台資料的應用程式嗎？ 假如您的應用程式會產生任何電子或紙本形式的文件(包括圖片)，則文件內不得包含任何來自Google地圖平台的資料。

詳情請參閱《Google地圖平台服務條款》的「禁止爬梳」(NoScraping)一節。

如何讓Google搜尋結果停止收錄我的內容？ 我們已停止收集這項資料。

indexing參數已淘汰不用，因此不會產生任何作用。

雖然您並不需要另行選擇停用，但我們建議您盡早移除該參數。

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

我可以使用MapsStaticAPI產生地圖圖片，並在我的網站上儲存與提供該圖片嗎？ 您無法在自家網站上儲存及提供透過MapsStaticAPI產生的圖片。

所有要求靜態圖片的網頁都必須將HTMLimg標記的src屬性或HTMLdiv標記的CSSbackground-image屬性直接連結至MapsStaticAPI，讓所有地圖圖片顯示在網頁的HTML內容中，再由Google直接向使用者提供圖像。

用量限制和計費方式 如何為專案設定帳單資訊？ 請參閱「開始使用Google地圖平台」一文。

GoogleCloudPlatform的免費方案客戶如何升級至付費帳戶？ GoogleCloudPlatform免費方案計畫提供$300美元的抵免額，讓客戶免付費試用任何GoogleCloudPlatform(GCP)服務，包括Google地圖平台(GMP)API。

但在免付費試用期結束後，必須升級為付費帳戶，才能繼續使用這些服務。

如要升級為付費帳戶，請前往CloudConsole。

Google地圖平台是否有用量限制？ 針對您可以向Google地圖平台產品發出的要求數，我們並未設定任何每日上限。

唯一的用量限制是每秒查詢次數(QPS)。

(以距離矩陣來說，是根據每秒事件數(EPS)設定限制，計算方式為用戶端和伺服器端查詢次數的總和。

) 下表列出各項API的用量限制。

API 用量限制 路線 每秒查詢50次 距離矩陣 每秒1000個事件 海拔高度 每秒查詢100次 地理編碼 每秒查詢50次 地理位置 每秒查詢100次 動態地圖 每秒查詢500次 靜態地圖 每秒查詢500次 StreetViewImageAPI 每秒查詢500次 時區 每秒查詢500次 地點(行動裝置除外) 每秒查詢100次 道路 每秒查詢500次 如要控管支出，您可以監控API使用情況，並針對所有可計費API設定每日要求數上限。

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

如何計算使用費？ 如需Google地圖平台產品定價總覽，請參閱價目表。

如要進一步瞭解Google地圖平台各式API的計費方式，請參閱瞭解地圖介面集、路徑介面集和地點介面集的計費方式。

Google地圖平台如何計算地圖載入量？ 發生下列任一情況時，系統會計為一次地圖載入： 使用MapsJavaScriptAPI顯示地圖的網頁或應用程式。

應用程式向MapsStaticAPI要求單一地圖圖片。

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

每次向StreetViewStaticAPI要求嵌入靜態(非互動式)街景服務全景，系統會計為一次靜態街景服務全景。

每次針對MapsJavaScriptAPI、MapsSDKforAndroid、MapsSDKforiOS應用程式中的全景物件執行個體化，系統就會計為一次動態街景服務全景。

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

如何監控用量？ 您可以在GoogleCloudPlatformConsole中監控個別API的使用情形。

選取您要查看的API所屬的專案。

在資訊主頁的API清單中，按一下API名稱。

在頁面頂端附近，按一下「指標」或「配額」。

如要查看整個專案的流量報表和帳單資訊，請按照以下步驟操作： 如果您尚未設定帳單資訊，請先進行設定。

前往CloudConsole的帳單頁面。

選擇專案。

在左側欄中，按一下「報表」。

使用右側欄的篩選器，即可查看帳單帳戶的報表。

詳情請參閱Google地圖平台報表、監控您的API使用情形和限制API用量。

超過要求比率(每秒查詢次數)限制會怎麼樣？ 如果超過特定Google地圖平台產品的每秒查詢次數限制，API會傳回錯誤訊息。

要是屢次超過上限，系統可能會暫時封鎖您的API存取權限。

如果您超過要求的每秒查詢次數限制或濫用服務，該要求會傳回特定錯誤訊息。

假如您繼續超過限制，系統可能會暫時封鎖您的Google地圖平台存取權限。

注意事項：MapsJavaScriptAPI中的下列這四個網路服務API會提供同等的用戶端服務：Directions、DistanceMatrix、Elevation和Geocoding。

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

這表示網路服務將停止正常回應，並改為只傳回狀態碼OVER_QUERY_LIMIT，直到再次可用為止。

假如您收到這項錯誤是因為應用程式每秒傳送的要求數量過多，那麼服務應該幾秒內就可以恢復。

如果您經常超過每秒查詢次數用量限制，不妨考慮提高應用程式使用Google地圖平台產品的效率，藉此降低用量。

詳情請參閱最佳化指南。

我的網站流量很大，可以使用Google地圖平台產品嗎？ 可以，但我們建議您詳加瞭解應用程式使用各項Google地圖平台產品時，應遵循的相關用量限制。

如果我的網站或應用程式突然大受歡迎，我的地圖會停止運作嗎？ 您建立帳單帳戶後，如果超過每月$200美元的免付費用量限制，且沒有在帳單帳戶中提供有效的付款方式(例如信用卡、銀行轉帳設定等等)，API就會停止運作，直到您加入有效的付款方式為止。

如何計算用量及收費？ 我們會在每天結束時，按照價目表的價格來計算用量， 並於每月月底以您帳單帳戶連結的付款方式，向您收取總用量費用。

詳情請參閱「Google地圖平台計費方式」一文。

使用Google地圖平台需要支付多少費用？ 如需各項API費用總覽，請參閱價目表。

只要您的應用程式產生的要求或地圖載入量，低於每月$200美元免付費額度可折抵的用量，則不必支付任何費用；但要是用量超過每月$200美元的抵免額，我們就會向您的帳單帳戶收費。

詳情請參閱瞭解Google地圖平台計費方式指南。

是否能查看以其他幣別為單位的定價資訊？ 您可以在主控台內查看其他幣別的定價資訊。

如果您選取其他貨幣，系統會根據價目表中對應的美元來換算費率。

我已經完成帳單設定，要如何查看帳單？ Google會在每月月初根據您指定的付款方式，向您收取上個月的活動費用。

如需帳單詳細資料，請參閱瞭解Google地圖平台計費方式指南。

其他資源： 瞭解如何查看費用和付款記錄。

瞭解如何取得月結單或付款收據。

瞭解如何設定及管理帳單快訊。

萬一用量突然無預警增加，我要如何避免帳單金額暴增？ Google地圖平台支援一些限制功能，可讓您指定每日要求上限和每日計費上限。

您可以設定每日用量上限，以防費用突然無預警增加；也可設定預算快訊，系統就會在帳單帳戶費用達到您設定的門檻時，寄送電子郵件通知您。

設定每日計費上限： 為避免帳單費用暴增，不妨設定每日用量上限，以防用量無預警增加。

您可以在CloudConsole中變更這項限制，步驟如下： 前往「API和服務」資訊主頁。

畫面出現提示時，請選取專案。

從清單中選取API，然後按一下「配額」分頁標籤。

按一下「每日要求數」配額旁邊的「編輯」圖示。

或者，您可以透過「IAM與管理員」的「配額」資訊主頁，編輯多個API的多個配額。

提示：您可以根據想要支出的金額，利用簡單的公式來算出每日上限。

例如：(每月支出/單價)/30=(單一API的)每日要求上限。

舉例來說，如果是透過免付費方案使用MapsJavaScriptAPI，則每月可建立28,000次呼叫。

要是您將MapsJavaScriptAPI的每日配額上限設為903(也就是28,000/31)，您就不需要支付額外費用。

請注意，由於您導入的功能可能會使用多個可計費API，因此請視需要調整上述公式。

提醒您，Google地圖平台每月會提供$200美元的抵免額，計算時請務必考量這一點。

設定及管理預算快訊： 只要設定預算快訊，系統就會在帳單帳戶費用達到您設定的門檻時，寄送電子郵件通知給帳單管理員。

當帳單帳戶的預估費用超過指定門檻的50%、90%和100%，帳單管理員就會收到電子郵件通知。

重點：設定預算「並不會」限制API用量。

設定預算的用意是讓您建立快訊，以利掌握一段期間內的支出趨勢。

快訊會提示您採取行動來控制費用，但不會在支出金額達到或超過預算時禁止使用服務。

如果您比較想要硬性設定API用量上限，避免費用繼續增加，請參閱限制API使用量。

我收到一則訊息，當中提及我的專案已連結至「Google地圖平台轉換帳戶」，但我沒有這個帳戶的存取權限，該怎麼做？ 我們之所以建立「Google地圖平台轉換帳戶」，是為了協助某些客戶轉換至新的即付即用定價方案。

Google會透過這個轉換帳戶，為客戶提供免付費方案的$200美元一次性抵免額，獲得抵免額的客戶可繼續使用Google地圖平台，直到用完該額度。

一旦超過額度上限，帳單帳戶就會關閉，而您將無法再使用Google地圖平台服務。

為避免服務中斷，我們極力建議您設定一個自己的帳單帳戶，這樣就能繼續享有免付費方案的每月$200美元抵免額。

如要變更專案的帳單帳戶，請按照下列指示操作： 建立新的帳單帳戶(如果您已有帳單帳戶，可以跳過這個步驟)。

將帳單帳戶連結至自有專案。

為什麼我的配額限制設定為每天1次要求？要如何提高上限？ 如果您尚未建立帳單帳戶並將其連結至專案，則MapsPlatformAPI每天只能傳送1次要求。

只要建立並連結帳單帳戶，就能獲得更多配額。

相關操作說明請參閱「開始使用Google地圖平台」一文。

一旦建立並連結帳單帳戶，系統就會幫您移除每日配額限制。

您可以在CloudConsole中設定限制，避免非預期的支出。

我收到了帳單違規通知，該如何解決這個問題？ Google判定您的帳戶設定了多個帳單帳戶，因此我們寄送這則通知給您。

這違反了《Google地圖平台服務條款》第3.2.4節中定義的Google條款規定。

該等條款禁止使用者建立多個帳單帳戶。

詳情請參閱帳單帳戶違規常見問題。

使用Google地圖平台 我該針對不同的地圖產品使用哪組金鑰或憑證？ 每次使用Google地圖平台產品時，您都必須提供API金鑰來驗證要求。

Google地圖平台支援Android、iOS或網頁應用程式，也可透過HTTP網路服務使用。

API金鑰： API金鑰是您使用CloudConsole產生的一組專屬ID。

使用金鑰載入API的範例：&key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo 數位簽章： 數位簽章須使用Google提供給您的網址簽署密鑰來產生，可與MapsStaticAPI及StreetViewStaticAPI搭配使用。

限制： 雖然API金鑰限制為選用功能，但我們極力建議您限制所有API金鑰，進一步提升安全性。

詳情請參閱API安全性最佳做法。

您可以對API金鑰新增應用程式限制。

一旦設下限制，該金鑰就只能在支援該類限制的平台上使用。

共有四種應用程式限制可以設定。

強制執行相同限制類型的API可以使用同一組受限制的金鑰。

IP位址(個別伺服器)：與網路服務API搭配使用。

HTTP參照網址(網站)：與網站API搭配使用。

Android應用程式限制(依套件名稱和指紋區分)：適用於MapsSDKforAndroid。

iOS應用程式限制(依iOS軟體包ID)：適用於MapsSDKforiOS。

您也可以對API金鑰新增API限制。

詳情請參閱取得、新增及限制API金鑰。

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

API/SDK 憑證和應用程式限制 MapsSDKforAndroid 具有Android限制的API金鑰1 PlacesSDKforAndroid 具有Android限制的API金鑰1 MapsSDKforiOS 具有iOS限制的API金鑰1 PlacesSDKforiOS 具有iOS限制的API金鑰1 MapsJavaScriptAPI 具有HTTP參照網址限制的API金鑰1 MapsStaticAPI 具有HTTP參照網址限制的API金鑰1+數位簽章2 StreetViewStaticAPI 具有HTTP參照網址限制的API金鑰1+數位簽章2 MapsEmbedAPI 具有HTTP參照網址限制的API金鑰1 DirectionsAPI 具有IP位址限制的API金鑰1 DistanceMatrixAPI 具有IP位址限制的API金鑰1 ElevationAPI 具有IP位址限制的API金鑰1 GeocodingAPI 具有IP位址限制的API金鑰1 GeolocationAPI 具有IP位址限制的API金鑰1 RoadsAPI 具有IP位址限制的API金鑰1 TimeZoneAPI 具有IP位址限制的API金鑰1 PlacesAPI 具有IP位址限制的API金鑰1 1雖然API金鑰限制為選用功能，但我們極力建議您限制所有API金鑰，進一步提升安全性。

2視使用情況而定，MapsStaticAPI和StreetViewStaticAPI可能會要求您提供數位簽章；但不管是什麼用途，我們極力建議您一起使用API金鑰和數位簽章來驗證要求。

如何將金鑰限制類型從HTTP參照網址變更為IP位址限制？ 重要事項：如果您使用的網路服務API內含設有參照連結限制的API金鑰，則要求將會失敗並傳回下列錯誤訊息：「使用此API時，API金鑰不能含有參照連結限制」。

請改用設有IP位址限制的API金鑰。

在將API金鑰的限制類型從HTTP參照網址改為IP位址之前，請確保所有使用該API金鑰的API都支援IP限制類型。

同一個限制類型的API可使用同一組受限制的金鑰。

如要強制執行多項限制，請另外新增一組金鑰並設定您需要的限制。

瞭解如何新增API金鑰。

進一步瞭解與Google地圖平台產品相關的API金鑰限制。

如要將設有HTTP參照網址限制的API金鑰改為IP位址限制，請按照下列指示操作： 前往CloudConsole的「憑證」頁面。

選取您要編輯的API金鑰所屬的專案。

在「憑證」頁面的API金鑰清單中，選取API金鑰名稱，並編輯該金鑰的詳細資料。

在頁面的「金鑰限制」部分，選取「IP位址(網路伺服器和Cron工作等)」，並插入適當的伺服器IP位址，然後按一下「儲存」。

如何取得新的API金鑰？ 請參閱「開始使用Google地圖平台」一文。

如何查看每個Google地圖平台版本的變更項目？ 下列連結有許多MapsAPI的版本變更資訊： MapsJavaScriptAPI DirectionsAPI DistanceMatrixAPI MapsSDKforAndroid PlacesSDKforAndroid MapsSDKforiOS PlacesSDKforiOS 您也可以使用下列網址的Google地圖平台IssueTracker工具，查看各Google地圖平台版本的錯誤，以及這些錯誤在哪些版本中已修正： https://issuetracker.google.com/bookmark-groups/76561 如何在網頁載入之後，以非同步方式將API載入該網頁？ 只要在載入API時指定回呼參數即可。

如需相關詳情或程式碼範例，請參閱MapsJavaScriptAPI說明文件中的「開始使用」章節。

如何用英文以外的語言顯示Google地圖平台產品？ 根據預設，API會根據使用者所在位置或瀏覽器設定，載入最合適的語言。

有些API可讓您在提出要求時明確指定語言。

如要進一步瞭解語言的設定方式，請參閱各API的說明文件： MapsJavaScriptAPI GeocodingAPI DirectionsAPI DistanceMatrixAPI PlacesAPI 支援的語言： Google會經常更新支援的語言，因此這份清單可能不夠詳盡，且會隨時變更。

語言代碼 語言 語言代碼 語言 af 南非荷蘭文 ja 日文 sq 阿爾巴尼亞文 kn 卡納達文 am 阿姆哈拉文 kk 哈薩克文 ar 阿拉伯文 km 高棉文 hy 亞美尼亞文 ko 韓文 az 亞塞拜然文 ky 吉爾吉斯文 eu 巴斯克文 lo 寮文 be 白俄羅斯文 lv 拉脫維亞文 bn 孟加拉文 lt 立陶宛文 bs 波士尼亞文 mk 馬其頓文 bg 保加利亞文 ms 馬來文 my 緬甸文 ml 馬拉雅拉姆文 ca 加泰隆尼亞文 mr 馬拉提文 zh 中文 mn 蒙古文 zh-CN 中文(簡體) ne 尼泊爾文 zh-HK 中文(香港) no 挪威文 zh-TW 中文(繁體) pl 波蘭文 hr 克羅埃西亞文 pt 葡萄牙文 cs 捷克文 pt-BR 葡萄牙文(巴西) da 丹麥文 pt-PT 葡萄牙文(葡萄牙) nl 荷蘭文 pa 旁遮普文 en 英文 ro 羅馬尼亞文 en-AU 英文(澳洲) ru 俄文 en-GB 英文(英國) sr 塞爾維亞文 et 愛沙尼亞文 si 錫蘭文 fa 波斯文 sk 斯洛伐克文 fi 芬蘭文 sl 斯洛維尼亞文 fil 菲律賓文 es 西班牙文 fr 法文 es-419 西班牙文(拉丁美洲) fr-CA 法文(加拿大) sw 史瓦西里文 gl 加里斯亞文 sv 瑞典文 ka 喬治亞文 ta 泰米爾文 de 德文 te 泰盧固文 el 希臘文 th 泰文 gu 古吉拉特文 tr 土耳其文 iw 希伯來文 uk 烏克蘭文 hi 印度文 ur 烏都文 hu 匈牙利文 uz 烏玆別克文 is 冰島文 vi 越南文 id 印尼文 zu 祖魯文 it 義大利文 您可以透過這個範例應用程式，看看使用以上語言呈現出來的地圖介面是什麼樣子。

可以透過安全資料傳輸層(SSL)(HTTPS)存取Google地圖平台嗎？ MapsJavaScriptAPI、MapsStaticAPI和WebServiceAPI都可以透過安全的(HTTPS)連線存取。

如要瞭解如何透過安全資料傳輸層(SSL)存取API，請參閱相關API的說明文件。

請注意，MapsStaticAPI不支援使用HTTPS的自訂圖示網址，因此將顯示預設圖示。

如何在Google地圖平台中回報錯誤或提出新功能建議？ 如果您遇到可能是平台設計錯誤而造成的問題，請先至相關論壇提問。

這樣可以讓其他開發人員進行驗證，確認問題並非來自您的程式碼。

有任何新功能建議，也請先在相關論壇中提出，確定目前還沒有符合您需求的解決方案。

如果您認為自己確實發現新的錯誤，或覺得Google地圖平台產品的現有功能無法滿足您的需求，則請使用Google地圖平台IssueTracker工具。

將錯誤或新功能要求登錄到IssueTracker之前，務必先確認目前還沒有任何人提過同樣的問題/要求。

如果已經有人提出，您可以對該項目加上星號，告訴我們您對此有興趣，屆時就能收到最新消息通知。

Google地圖平台的API如何使用網站Cookie？ MapsSDKforAndroid和MapsSDKforiOS會遵循Google隱私權政策來使用Cookie，例如用來計算每日和過去7天的活躍使用者人數，以及防止服務濫用行為。

這些Cookie不會與任何已登入的Google帳戶建立關聯，也不會隨著API呼叫收集到的其他資訊一起記錄下來。

我找不到問題的解答，該與誰聯絡？ Google的開發人員關係維繫團隊成員常會在StackOverflow上與大家交流；這是一個由程式設計人員合作編輯，專供同業提問和尋找解答的網站。

如果您有Google地圖應用程式開發以及維護等方面的問題，這個網站可以提供最佳的技術諮詢。

如要進一步瞭解如何在StackOverflow上發問，請參閱這個支援網頁。

為確保過程順利進行，請求協助時，不妨運用以下幾個小秘訣： 先搜尋目前的討論內容。

其他人可能已遇過類似問題，並且已有解決方式。

如果可以的話，請附上您的網站連結。

如果程式碼不容易在線上檢視，也可只張貼程式碼片段。

提供所有相關資訊，包括瀏覽器版本、錯誤，以及其他有助排解問題的相關事證。

錯誤和疑難排解 這個錯誤代表什麼意義？ 如果載入或執行GoogleMapsAPI時發生錯誤，請參考下列連結的錯誤代碼說明： MapsJavaScriptAPI MapsStaticAPI StreetViewStaticAPI MapsEmbedAPI ElevationAPI GeocodingAPI GeolocationAPI DirectionsAPI DistanceMatrixAPI RoadsAPI TimeZoneAPI PlacesAPI 我的地圖顏色看起來比平常深，為什麼會這樣？ 在某些情況下，地圖顏色可能會變得比較深(有點像「負片」效果的街景服務圖片)，而且會有「僅供開發使用」浮水印。

這通常代表有API金鑰或帳單方面的問題。

如要使用Google地圖平台產品，您必須具備帳單帳戶，且所有要求一律應包含有效的API金鑰。

下列流程可協助您排解這個問題： 您目前是否使用API金鑰？ 我不確定，要怎麼檢查我是否使用API金鑰？ API金鑰會以key參數的形式傳遞，用來載入MapsJavaScriptAPI。

您可以透過下列這幾種方式，檢查自己是否使用API金鑰： 使用Google地圖平台API檢查工具Chrome擴充功能，這可讓您判斷網站是否已正確導入Google的授權MapsAPI。

如果您是使用程式庫或外掛程式來載入MapsJavaScriptAPI，請檢查該程式庫的設定並尋找API金鑰選項。

檢查瀏覽器中的錯誤。

如果看到下列訊息，表示您並未正確使用API金鑰： GoogleMapsJavaScriptAPI警告：NoApiKeys GoogleMapsJavaScriptAPI錯誤：MissingKeyMapError 針對網頁程式開發人員： 如果您可以存取應用程式的原始碼，請尋找用來載入MapsJavaScriptAPI的 在瀏覽器中查看網站產生的網路流量。

在Chrome中，您可以前往開發人員工具的「網路」分頁，這裡會顯示由您網站發出的網路要求。

使用MapsJavaScriptAPI發出的要求會列在路徑maps/api/js下方，而您可以在這裡查看要求是否使用key參數。

查看「網路」分頁時，依maps/api/js篩選網路流量，可能會比較容易找到您需要的資訊。

否，我並未使用API金鑰。

如要取得API金鑰，請點選下方按鈕。

如果未看到任何設定指引，請按照「開始使用Google地圖平台」一文中的完整操作說明進行。

開始使用 是，我目前使用API金鑰。

太好了！接著我們來檢查帳單帳戶是否已連結至專案。

您的專案是否已連結帳單帳戶？ 我不確定，要怎麼檢查帳單帳戶是否已連結至我的專案？ 前往GoogleCloudConsole的 「帳單」頁面，然後選取當初建立的API金鑰是在哪個專案底下。

如要確認金鑰是否已與專案連結，請按照以下步驟進行： 從「Google地圖平台」>「憑證」下方的左側選單，前往「憑證」部分。

查看自家網站是否已列出您目前使用的API金鑰。

如果沒有，請切換至其他專案再查看一次憑證。

假如都找不到API金鑰的專案，代表您目前可能已經無法存取該專案。

請向貴機構組織中的相關人員尋求協助。

如果找不到原始專案，建議您： 建立新專案，方法是在專案清單中選取「新增專案」，或透過ResourceManager頁面選取「建立專案」。

建立新的API金鑰，在「憑證」頁面中即可建立。

按一下「建立憑證」，然後選取「API金鑰」。

在CloudConsole中找到您的專案後，前往左側選單的「帳單」部分，查看帳單帳戶是否已連結完成。

否，我的專案未連結任何帳單帳戶。

前往CloudConsole的「啟用計費功能」頁面，並在專案中新增帳單帳戶。

詳情請參閱開始使用Google地圖平台。

是，我的專案已連結帳單帳戶。

太好了！接下來請確認您提供的付款方式是否有效。

您提供的付款方式是否不再有效(例如信用卡已過期)？ 您可以在CloudConsole中新增、移除或更新付款方式。

是否超過您自行對API施加的限制？ 如果您為了避免支出突然增加，而針對API設定了每日上限(這是常見的預防做法)，只要提高每日上限就能解決這個問題。

您可以前往CloudConsole中的「API和服務」資訊主頁，查看每日限制。

進入資訊主頁後： 畫面出現提示時，請選取專案。

從清單中選取API，然後按一下「配額」分頁標籤。

您的API金鑰是否有IP位址限制？ 設有IP位址限制的API金鑰，只能與來自指定伺服器端的網路服務搭配使用(例如GeocodingAPI和其他網路服務API)。

大多數網路服務在MapsJavaScriptAPI中都有對應的服務項目(相關範例請參閱地理編碼服務)。

如要使用MapsJavaScriptAPI用戶端服務，您必須另外建立一個能設定HTTP參照網址限制的安全API金鑰(請參閱取得、新增及限制API金鑰)。

如何解決錯誤代碼為OVER_DAILY_LIMIT或OVER_QUERY_LIMIT的問題？ 系統傳回這些錯誤代碼的原因可能如下： 要求中缺少API金鑰。

提供的API金鑰無效。

專案未連結至帳單帳戶。

超過自行設定的用量上限。

您提供的付款方式已失效(例如信用卡已過期)。

您已超過指定API的每秒查詢次數限制。

如要使用Google地圖平台產品，您必須具備帳單帳戶，且所有要求一律應包含有效的API金鑰。

如要解決這個問題，請按照下列步驟操作： 設定帳單帳戶。

取得新的API金鑰。

如果可行的話，建議調整 用量上限，就能提高每日限制。

如何解決錯誤代碼為kGMSPlacesRateLimitExceeded或9005PLACES_API_RATE_LIMIT_EXCEEDED的問題？ 如果您看到kGMSPlacesRateLimitExceeded或9005PLACES_API_RATE_LIMIT_EXCEEDED，代表您用的是已經淘汰的PlacesSDKforAndroid或PlacesSDKforiOS版本。

請前往https://goo.gle/places-sdk-deprecation瞭解詳情，並取得新版SDK。

如何解決「這個IP、網站或行動應用程式未獲權使用此API金鑰」的錯誤？ 有很多情況都可能會造成這個錯誤： 您對API金鑰啟用了IP位址(伺服器)限制，但有未經授權的IP位址嘗試提出要求。

您對API金鑰啟用了HTTP參照網址(網站)限制，但有未經授權的參照網址嘗試提出要求。

您設定了套件名稱及指紋，藉此對Android應用程式進行使用限制，但有未經授權的Android應用程式嘗試提出要求。

您指定了軟體包ID，藉此限制來自iOS應用程式的要求，但有未經授權的iOS應用程式嘗試提出要求。

當您使用任一網路服務API，而其中的API金鑰含有HTTP參照網址限制，就有可能導致這項錯誤。

傳送至這些API的要求應識別為具有IP位址限制的API金鑰，因此，請將金鑰限制類型從HTTP參照網址變更為IP位址限制。

如要進一步瞭解如何限制API金鑰，請參閱API金鑰最佳做法。

查看及編輯API金鑰憑證 如要查看API金鑰及管理限制，請按照下列步驟操作： 前往CloudConsole的「憑證」頁面。

選取您要查看的API金鑰所屬的專案。

如要查看憑證詳細資料(包括對該金鑰設下的任何限制)，請在API金鑰清單中按一下金鑰名稱。

系統會針對您選取的API金鑰，顯示完整憑證，包括您為金鑰設定的任何限制。

您可以在這裡視需要變更、刪除或更新限制。

如何解決「具有參照連結限制的API金鑰無法搭配此API使用」的錯誤？ 您目前正在使用網路服務API，而其中的API金鑰含有HTTP參照網址限制。

基於安全考量，網路服務API必須使用具有IP位址限制的API金鑰。

因此，請將金鑰限制類型從HTTP參照網址限制變更為IP位址限制。

或者，如果您的金鑰已搭配MapsJavaScriptAPI使用，則請建立新的API金鑰。

Google地圖平台服務 我需要將地址轉換成經緯度的格式組合，Google地圖平台是否支援此功能？ 是，我們支援此功能。

這個程序稱為「地理編碼」，MapsJavaScriptAPI包含用於執行地理編碼服務的類別：google.maps.Geocoder。

此外，Google也提供GeocodingAPI，其中包含的REST介面能夠以JSON和XML格式回應。

哪些國家/地區可以使用地理編碼？ 如要查看Google地圖平台地理編碼器目前支援的國家/地區，請參閱Google地圖涵蓋資料。

地理編碼的準確性可能因國家/地區而異，建議您使用傳回的location_type欄位來判斷結果是否適用於您的應用程式。

請注意，您能夠使用的地理編碼資料取決於我們與資料提供者之間的合約，因此可能會隨時變動。

為什麼Google地圖平台地理編碼器提供的地點與Google地圖上的不同？ API和Google地圖的地理編碼器有時會使用不同的資料集(視國家/地區而定)。

API地理編碼器偶爾會有資料更新，因此一段時間過後，您看到的結果可能會有所變更或改善。

如何設定我的地理編碼器查詢格式，才能盡可能提高要求的成功率？ 地理編碼器的主要用途為轉換街道地址，將其對應至地理座標。

因此，我們建議您根據下列指南設定地理編碼要求格式，以盡可能提升查詢的成功率： 按照相關國家/地區郵政服務使用的格式來指定地址。

不要指定額外的地址項目(例如相關國家/地區郵政服務未納入地址定義的公司名稱、單位號碼、樓層號碼或套房號碼)，否則會導致傳回含有ZERO_RESULTS的回應。

請按照這裡指定的格式來設定pluscode(加號在網址中會逸出為%2B，空格則逸出為%20)： 全球代碼是4個字元的區碼，加上6個字元以上的地區代碼(例如849VCWC8+R9為849VCWC8%2BR9)。

複合代碼是6個字元以上的地區代碼，加上明確的位置(例如CWC8+R9MountainView,CA,USA為CWC8%2BR9%20Mountain%20View%20CA%20USA)。

如果可能的話，建議使用建築物的街道號碼，而非建築物名稱。

如果可能的話，建議使用街道號碼的地址，而非交叉路口街道。

不要提供「建議」，例如附近地標。

如何設定美國編號公路的地址格式，以便進行地理編碼？ Google地圖平台地理編碼器要求按以下地址格式來指定美國編號的公路： 郡級道路： "CoRoadNNN"，其中的「NNN」代表道路編號，例如"CoRoad82" 州級高速公路： "StateNNN"，其中的「State」是指州的全名，而「NNN」則是高速公路的編號，例如"California82" 美國公路："U.S.NNN"，其中的「NNN」是高速公路的編號，例如"U.S.101" 美國州際公路："InterstateNNN"，其中的「NNN」是指州際高速公路，例如"Interstate280" 何時應該使用API地理編碼器類別？何時應該使用HTTP地理編碼服務？ 請參閱「地理編碼策略」一文，當中會詳細說明不同地理編碼策略的優缺點。

如何透過Google地圖平台提供行車路線？ DirectionsAPI可讓您提供單一和多段路程的行車路線。

您可以透過路徑規劃選項，指定交通方式(開車)、單一或多組路徑和相關限制(避開收費道路)來規劃路線。

此服務的格式如下： HTTP要求/回應介面(在行動裝置和其他應用程式中使用)與MapsSDKforAndroid及其他Google地圖網路服務相容。

詳情請參閱DirectionsAPI。

針對用戶端應用程式，JavaScriptAPI可讓您透過google.maps.DirectionsService類別提供行車路線。

DirectionsRenderer類別可自動為您建立疊加層和路線窗格。

如需其他範例，請參閱這份說明文件。

針對伺服器端應用程式，Java、Python、Go和Node.js用戶端介面也提供同樣的功能。

如需參考說明文件，請造訪以下連結：Google地圖服務適用的Java用戶端、Google地圖服務適用的Python用戶端、Google地圖服務適用的Go用戶端及Google地圖服務適用的Node.js用戶端。

哪些國家/地區可以使用行車路線功能？ 如要查看Google地圖平台產品中目前支援行車路線功能的國家/地區，請參閱Google地圖涵蓋資料。

請注意，您能夠使用的行車路線資料取決於我們與資料提供者之間的合約，因此可能會隨時變動。

哪些國家/地區可以使用大眾運輸路線功能？ DirectionsAPI和DistanceMatrixAPI支援所有Google大眾運輸合作夥伴(日本除外)。

MapsJavaScriptAPI支援哪些KML和GeoRSS功能？ MapsJavaScriptAPI中的KmlLayer類別可讓開發人員將KML/KMZ和GeoRSS檔案疊加在地圖上。

相關說明文件與範例請參閱這裡。

使用MapsJavaScriptAPI的KmlLayer類別顯示KML時，KML大小和複雜度有什麼限制？ 有關使用KmlLayer類別顯示KML時，KML的大小和複雜度限制，請參閱這裡的資訊： 如何在地圖上算繪由內部網路網站代管的KML檔案？ 在MapsJavaScriptAPI中產生KML疊加層的 KmlLayer類別，會使用Google代管的服務來擷取和剖析KML檔案，以進行算繪。

因此，如果KML檔案不是託管於可公開存取的網址，或者需要驗證才能存取，那麼這些檔案就無法顯示。

如果您要開發的應用程式是使用由內部網路網站代管的KML檔案，建議您採用第三方JavaScript程式庫，在用戶端算繪KML檔案。

由於KML檔案是透過瀏覽器進行分析，因此效能可能會低於使用KmlLayer類別分析的效能。

MapsStaticAPI支援的路徑端點或標記數量上限是多少？ StaticMapsAPI支援的標記或路徑端點數量無上限。

如果使用自訂圖示，每次提交要求只能指定最多5個不同的圖示，但每個圖示在地圖上都能多次使用。

請注意，MapsStaticAPI的網址長度上限大約為8,192個字元，因此限制了標記和路徑端點的數量，其原本取決於在指定每個經緯度組合時，所使用的小數位數。

如要進一步瞭解使用的小數位數與地球上的地點精確性有何關係，請參閱維基百科的DecimalDegrees一文。

為何無法在特定國家/地區使用Google地圖平台產品？ MapsAPI不得在禁止領土/地區使用；請另外參閱《服務條款》。

如何回報Google基本地圖問題？ 您可以透過Google地圖提供意見回饋，指出錯誤或遺漏的地圖資訊，例如： 地址或標記位置有誤 路名不正確 單行道和雙向道資訊有誤 道路繪製有誤 道路已封閉 道路不存在 如要修改地點或商家資訊，請提出修改建議。

如果有基於法律因素而必須移除的Google地圖內容，請提交法律案件申請。

如果是重大問題或要求本身具有時效性，請提交客服案件，並附上具體的問題描述。

系統如何針對使用MapsJavaScriptAPI的服務監控成效？ 部分用戶端功能旨在記錄成功或失敗，以便計算服務等級目標。

在記錄服務等級目標資訊的呼叫中，這項資訊會透過maps.googleapis.com/maps_api_js_slo/log傳送至Google。

這項資訊包括使用中MapsJavaScriptAPI的成功狀態、延遲時間和版本/管道。

此外，系統可能會批次處理這些呼叫以提升成效。

請注意，您可能需要在「內容安全政策」中允許maps.googleapis.com，確保系統不會在瀏覽器層級封鎖這些呼叫。

例如：包含HTTP標頭的Content-Security-Policy:default-src'self'maps.googleapis.com;，或是包含HTML中繼標記的。

GoogleMapsSDKforiOS 在Xcode12中，無法正確建構要用於模擬工具的應用程式，要如何修正這個問題？ 如要解決這個問題，請開啟Xcode專案版本設定，然後只針對「iOS模擬工具」版本，將arm64新增到ExcludedArchitectures。

詳情請參閱下列StackOverflow討論串。

如何解決「kGMSPlacesRateLimitExceeded」錯誤？ 如果看到這個錯誤，代表您用的是已經淘汰的PlacesSDKforiOS版本。

PlacesSDKforiOS的2.7.0版已停用，且不再提供。

請盡快更新應用程式以便使用最新版本。

詳情請參閱遷移指南。

我在使用iOS8.x裝置進行偵錯時當機，該怎麼辦？ 如果在搭載iOS8.x的裝置偵錯時遇到問題，請按照下列步驟，在您執行中的XCode配置停用GPU畫格擷取： 在XCode中選擇「Product」(產品)、「Scheme」(配置)、「ManageSchemes」(管理配置)。

選取一個架構，然後選取「Edit…」(編輯…)。

將「GPUFrameCapture」(GPU畫格擷取)選項設為「Disabled」(停用)。

請注意，部分裝置可能不會顯示這個選項。

圓邊角且較寬的螢幕對於GoogleMapsiOSSDK有何影響？ 從iPhoneX開始，iPhone的螢幕外型設計有所改變，包括圓邊角、裝置頂部的感應器區域(俗稱「瀏海」)，以及螢幕底部用來存取主畫面的橫條。

從iOS11.0SDK開始，Apple新增了SafeAreaAPI，方便開發人員將元素固定在安全區域，以免超出新的螢幕畫面範圍而遭裁切。

GoogleMapsiOSSDK提供許多視覺元素和控制項，例如室內挑選器及問題回報連結。

在2.4版中，這些視覺元素和控制項可能會因為新的螢幕形狀而受到遮擋。

如果裝置處於橫向模式，「瀏海」區域或Home鍵橫條可能就會擋到室內樓層挑選器。

GoogleMapsiOSSDK2.5版本自動修正了這些版面配置問題。

在iPhoneX或更高版本的系統上使用應用程式時，系統會增加GMSMapView和GMSPanoramaView的邊框間距，避免視覺元素遭到裁切。

根據預設，我們一律會加上邊框間距。

GoogleMapsiOSSDK假設該邊框間距是為了讓元素落在安全區域內而加上的設定。

如果您在設計介面時即已考量到這點，並將所有元素都安排在安全區域內，那就不用另外做什麼處理。

如果您設計的介面不適用於我們的預設調整項，我們也在GMSMapView引進了新的屬性：paddingAdjustmentBehavior。

GMSMapView現在可讓您從「Always」(一律)(預設值)、「Automatic」(自動)及「Never」(永不)這三個邊框間距調整行為中挑選一個。

如果GMSMapView的邊框間距行為設為「Always」(一律)，系統將一律對邊框間距增加安全區域插邊。

這樣您在設計介面時，即可假設所有元素位置與安全區域的邊緣都會保持間距。

這是預設值。

如果GMSMapView的邊框間距行為設為「Automatic」(自動)，系統將一律從邊框間距或安全區域插邊兩者中，選擇較大的那個。

這可讓您從螢幕邊緣增加邊框間距，而且也能確保所有元素都落在安全區域內。

如果GMSMapView的邊框間距行為設為「Never」(永不)，系統將一律不會對邊框間距增加安全區域插邊；在版本2.5之前都是採取這種做法。

如果您在設計邊框間距時已經考量到安全區域，或您認為系統有其他行為與您的介面不符，不妨選擇這個設定。

根據《Google地圖平台服務條款》的規定，您有責任確保Google標誌和版權聲明會持續顯示在畫面上。

但相較之下，GMSPanoramaView就沒有可選用的邊框間距屬性。

這表示您無法進行調整，而GMSPanoramaView會一律套用所有必要的邊框間距，確保所有視覺元素都位於安全區域。

GoogleMapsSDKforAndroid 如何解決「9005PLACES_API_RATE_LIMIT_EXCEEDED」錯誤？ 如果看到這個錯誤，代表您用的是已經淘汰的PlacesSDKforAndroid版本。

PlacesSDKforAndroid的GooglePlay服務版本已停用，且不再提供。

請盡快更新應用程式，即可使用最新版本。

詳情請參閱遷移指南。

我的應用程式只會顯示灰色空白圖塊，不會顯示地圖。

該如何解決這個問題？ 顯示灰色空白圖塊而未顯示地圖，造成這點的常見原因是驗證方面的問題。

您可以按照下列步驟操作，使用ADBlogcat解決這類問題。

請確認您已安裝ADB。

如未安裝，請按照這裡的指南進行。

在裝置或AndroidEmulator上安裝出現這個問題的應用程式。

如果使用AndroidEmulator，請確認模擬器設定已納入Play商店。

在AndroidStudio終端機執行adblogcat-e"GoogleMapsAndroidAPI"。

這樣只會印出記錄訊息與「GoogleMapsAndroidAPI」相符的那幾行資料(您也可以透過加上「>logcat.txt」將記錄輸出至文字檔) 在裝置上重現問題，並檢查是否有常見錯誤，例如： 資訊清單中參照錯誤/非預期的API金鑰。

專案未啟用計費功能。

專案API未啟用SDK。

API金鑰限制中加入錯誤的SHA1指紋。

沒有在build.gradle檔案中加入GooglePlay服務依附元件。

網址簽署 我可以使用JavaScript簽署網址嗎？ 使用JavaScript簽署網址可能會向使用者暴露您的網址簽署密鑰，我們非常不建議這樣做。

因此，請僅使用伺服器端元件產生簽章。

為什麼我的MapsAPI網路服務要求收到「HTTP403禁止」(HTTP403Forbidden)的回應訊息？ HTTP403回應表示有權限問題，或許是因為無法針對該要求進行簽章驗證。

可能的原因如下： 簽章不正確：指定的簽章無法用於這個要求。

該要求指定了Google地圖平台付費方案的API金鑰，但並未指定簽章；而您所呼叫的服務規定以API金鑰提出的要求都必須隨附有效簽章。

已指定簽章，但未指定相關聯的Google地圖平台付費方案API金鑰。

提供意見 Exceptasotherwisenoted,thecontentofthispageislicensedundertheCreativeCommonsAttribution4.0License,andcodesamplesarelicensedundertheApache2.0License.Fordetails,seetheGoogleDevelopersSitePolicies.JavaisaregisteredtrademarkofOracleand/oritsaffiliates. Lastupdated2022-03-30UTC. [{ "type":"thumb-down", "id":"missingTheInformationINeed", "label":"缺少我需要的資訊" },{ "type":"thumb-down", "id":"tooComplicatedTooManySteps", "label":"過於複雜/步驟過多" },{ "type":"thumb-down", "id":"outOfDate", "label":"過時" },{ "type":"thumb-down", "id":"translationIssue", "label":"翻譯問題" },{ "type":"thumb-down", "id":"samplesCodeIssue", "label":"示例/程式碼問題" },{ "type":"thumb-down", "id":"otherDown", "label":"其他" }] [{ "type":"thumb-up", "id":"easyToUnderstand", "label":"容易理解" },{ "type":"thumb-up", "id":"solvedMyProblem", "label":"確實解決了我的問題" },{ "type":"thumb-up", "id":"otherUp", "label":"其他" }] 想進一步說明嗎？ StackOverflow 使用google-maps標記提出問題。

GitHub 運用現有樣本進行設計。

Discord 與其他開發人員交流，瞭解Google地圖平台。

IssueTracker 如果發生錯誤，請傳送錯誤報告給我們！ 瞭解詳情 常見問題 API挑選器 教學課程 平台 Android iOS 網路 網路服務 產品資訊 計費方式與方案簡介 與銷售人員聯絡 支援 服務條款 Android Chrome Firebase GoogleCloudPlatform 所有產品 條款 隱私權 訂閱GoogleDevelopers電子報 訂閱 Language English BahasaIndonesia Deutsch Español Español–AméricaLatina Français Português–Brasil Русский 中文–简体 中文–繁體 日本語 한국어