Google AI Studio (AIS) 整合 Google Maps Platform,可讓開發人員快速製作原型,並部署採用 AI 技術的網頁應用程式,提供互動式地圖、真實世界地點資料和路線規劃功能。
整合 Maps 試用金鑰後,您就能直接在 AI Studio 中生成具備位置辨識功能的 AI 原型,不必建立 Google Cloud Billing 帳戶或離開開發環境。如果您已使用 Google Cloud,可以連結已啟用計費功能的專案,存取所有 Google Maps Platform 產品,不受每日試用配額限制。您也可以先使用 Maps 試用金鑰,等準備好擴充時再連結專案。
主要功能與特色
- 輕鬆上手:無論您是 Google Cloud 新手,還是已有 Cloud 專案,都能直接在 AI Studio 取得 Maps 試用金鑰,不必輸入信用卡資訊或前往 Google Cloud 控制台。
- 自動偵測意圖:AI Studio 會辨識地理空間提示 (例如搜尋附近地點、顯示互動式地圖或計算路線),並自動設定 Google Maps Platform 建議和技能。
- 即時原型設計:系統會在背景自動佈建示範憑證,讓 AI 生成的程式碼立即執行。
- 順暢擴充:應用程式準備好擴充時,請連結 Cloud Billing 帳戶,或連結現有的計費雲端專案,即可移除任何配額限制。
如何開始使用
AI Studio 會佈建 Google Maps Platform 憑證,並安全地儲存在應用程式的密鑰設定中。入門方式取決於您是否為 Google Cloud 新手:
- 初次使用 Google Cloud:AI Studio 會建立免費專案和 Maps 試用金鑰,方便您開始使用。
- 現有 Google Cloud 使用者:您可以使用 Maps 試用金鑰 (包含部分 API 和每日配額限制) 免費進行原型設計,也可以連結現有的 Cloud 專案 (須付費),取得完整存取權和正式環境等級的配額。
Maps 試用金鑰受《Maps 試用專案服務條款》規範。
| 功能 | 新使用者 | 現有使用者 (免費原型設計) | 現有使用者 (連結已啟用計費功能的雲端專案) |
|---|---|---|---|
| 憑證類型 | Maps 試用金鑰 | Maps 試用金鑰 | 標準 Google Cloud API 金鑰 |
| 帳單設定 | 無須提供信用卡或 Google Cloud Billing 帳戶 | 無須提供信用卡或 Google Cloud Billing 帳戶 | 必須具備 Google Cloud Billing 帳戶 |
| API 涵蓋範圍 |
所有 Google Maps Platform API (Route Optimization、Solar 和 Nav Connect 除外),包括:
|
常用的原型設計 API (請參閱支援的功能):
|
100% 的 Google Maps Platform API 組合 (包括 Route Optimization、Solar 和 Nav Connect) |
| 每日上限 | 每個 API 每天 100 次呼叫 | 每個 API 每天 100 次呼叫 | 標準配額和每月免費用量 |
| 金鑰限制 | 自動化流程內 Secret 管理 | 自動化流程內 Secret 管理 | 自訂 HTTP 參照網址、IP 或應用程式限制 |
| 使用意圖 | 原型設計、測試和 AI Studio 網頁應用程式 | 原型設計、測試和 AI Studio 網頁應用程式 | 正式版網頁和行動應用程式 |
| 正式環境部署路徑 | 將 Cloud Billing 帳戶連結至專案,金鑰就會繼續運作 | 在 AI Studio 連結已啟用計費功能的 Cloud 專案 | 已可用於正式環境 |
疑難排解和配額
透過 AI Studio 提供的展示金鑰,每日要求數量設有上限,適用於互動式開發工作階段。每日要求上限為每個 API 每天 100 次呼叫。
「超過配額」錯誤
如果應用程式在使用示範金鑰時收到 RESOURCE_EXHAUSTED 或超出配額錯誤:
- 每日重設:試用金鑰配額每 24 小時會自動重設。重設週期結束後,即可繼續測試。
- 標準金鑰配額重疊:如果您使用標準 API 金鑰,並遇到提及試用環境限制的配額錯誤訊息,請前往 Google Cloud 控制台配額頁面,確認專案的配額限制。
- 升級以提高用量:如果原型設計需求超過每日試用限制,請升級至標準 Google Cloud 帳戶,即可解鎖完整正式版配額。
「無法使用 API」錯誤
如果您是現有的 Google Cloud 使用者,並使用 Maps 試用金鑰進行原型設計,但要求因 API 金鑰限制錯誤而失敗 (例如 Maps JavaScript API 中的 ApiTargetBlockedMapError),表示該 API 不在該金鑰的支援 API 清單中。連結已啟用計費功能的 Cloud 專案即可使用。
升級至正式版金鑰
當應用程式準備好正式上線,或需要更高的配額限制時,請在 Google Cloud 控制台中連結 Cloud Billing 帳戶,升級專案。現有的試用版 API 金鑰仍可繼續使用,因此您不需要更新應用程式程式碼。
如果您已有 Cloud Billing 帳戶,也可以略過試用金鑰:在 AI Studio 啟用 Google Maps Platform 時,選擇已啟用計費功能的雲端專案,即可取得標準 API 金鑰,一開始就享有完整的 API 涵蓋範圍和標準配額。
相關資源
- 取得並使用 Maps 試用金鑰
- Google Maps Platform 代理技能
- Maps Grounding Lite (MCP)
- Google Maps Platform Code Assist