瞭解專案中產品和資源的位置

需要設定位置資訊的產品或資源

部分產品或資源需要設定位置。

產品 預設位置 其他資訊
Firebase AI Logic
  • Gemini Developer API：無法選取位置，一律為全域。
  • 如果是 Agent Platform Gemini API (formerly Vertex AI)：如未設定位置，預設區域為 us-central1。
您可在此存取模型。
Google Analytics 沒有預設位置。
你必須設定這個位置。 		這個位置是Analytics報表位置2，代表貴機構所在的國家/地區。您的Analytics 報表位置會決定收益報表的幣別。
Firebase App Hosting 沒有預設位置。
您必須為每個後端設定這個位置。 		這個位置是 App Hosting 部署作業建立每個後端資源的位置。
每個後端都可以在不同位置。
Firebase SQL Connect 沒有預設位置。
您必須為每個執行個體設定位置。 		每個執行個體可以位於不同位置。
Cloud Firestore 1 沒有預設位置。
您必須為每個執行個體設定位置。 		每個執行個體可以位於不同位置。
Firebase Realtime Database 沒有預設位置。
您必須為每個執行個體設定位置。 		每個執行個體可以位於不同位置。
Cloud Storage for Firebase 1 沒有預設位置。
您必須為每個值區設定位置。 		每個 bucket 可以位於不同位置。
Cloud Functions for Firebase 1 如未設定位置，預設區域為 us-central1。 每個函式可以位於不同位置。

1 視您最初在專案中使用這些產品的時間而定，這些產品之間可能存在位置依附元件。您可能會看到這個依附元件稱為「預設 Google Cloud 資源的位置」。進一步瞭解這項位置資訊依附元件。

2 Analytics 報表位置不會影響 Google 處理及儲存 Firebase 客戶資料的位置。

為產品或其資源設定位置

你為部分產品設定了產品層級的位置資訊。不過，對於大多數產品，您會在資源層級設定位置 (例如，每個 Cloud Storage 值區或每個函式)。

產品 何時及如何設定位置 適用地點
Firebase AI Logic
  • Gemini Developer API：無法選取位置，一律為全域。
  • Agent Platform Gemini API (formerly Vertex AI)：在程式碼庫中初始化 Agent Platform 後端服務時，您可以選擇指定要存取模型的位置。
    如未指定位置，預設區域為 us-central1。
Firebase AI Logic 個位置
Google Analytics 在 Firebase 控制台中，為 Firebase 專案啟用 Google Analytics 時，系統會提示您選取 Analytics 報表位置。請選取代表貴機構所在位置的國家/地區。

如果您是專案擁有者或編輯者，日後可以編輯 Analytics 報表位置的時區和幣別；請前往Google Analytics設定，然後前往「報表」窗格。

 如要查看清單，請前往「Google Analytics 設定」 >「報表」窗格。
Firebase App Hosting 建立 App Hosting 後端時，系統會提示您選取位置。您可以使用 Firebase 控制台、REST API 或 Firebase CLI 建立後端。 App Hosting 個地點
Firebase SQL Connect 佈建 SQL Connect 服務執行個體時，請設定執行個體的位置。您也可以設定相關聯 Google Cloud SQL 執行個體的位置。
您可以使用 Firebase 控制台或 Firebase CLI 佈建執行個體。 		SQL Connect 服務和Cloud SQL執行個體位置
Cloud Firestore 1 佈建 Cloud Firestore 資料庫執行個體時，請設定執行個體的位置。您可以使用 Firebase 控制台、REST API、Firebase CLI 或 Terraform 佈建執行個體。 Cloud Firestore 個位置
Firebase Realtime Database 佈建 Realtime Database 執行個體時，您會設定執行個體的位置。
您可以使用 Firebase 控制台、REST API、Firebase CLI 或 Terraform 佈建執行個體。 		Realtime Database 個位置
Cloud Storage for Firebase 1 佈建 Cloud Storage 值區時，您會設定其位置。
您可以使用 Firebase 控制台、REST API 或 Terraform，佈建 bucket。 		Cloud Storage for Firebase 個位置
Cloud Functions for Firebase 1 編寫函式時，您可以選擇設定函式區域。

如未指定位置，預設區域為 us-central1。

 Cloud Functions for Firebase 個位置

1 視您最初在專案中使用這些產品的時間而定，這些產品之間可能存在位置依附關係。您可能會看到這個依附元件稱為「預設 Google Cloud 資源的位置」。進一步瞭解這項位置資訊依附元件。

查看位置資訊設定

產品 如何查看位置資訊設定
Firebase AI Logic
  • Gemini Developer API：無法選取位置，一律為全域。
  • 如果是 Agent Platform Gemini API (formerly Vertex AI)：請在程式碼集中尋找 Agent Platform 後端服務的初始化作業。如未指定位置，預設位置為 us-central1。
Google Analytics 在 Firebase 控制台中，依序前往「設定」「專案設定」 >「整合」 > Google Analytics。 按一下帳號開啟 Google Analytics 帳戶，然後前往「管理」面板，即可查看帳戶位置資訊。
Firebase App Hosting
  • 前往 Firebase 控制台的App Hosting頁面，查看後端清單及其位置。
  • 如要查看特定後端的所在位置，可以使用 Firebase CLI 指令 firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID。
Firebase SQL Connect 前往 Firebase 控制台的SQL Connect頁面，查看資料庫執行個體及其位置的清單。
Cloud Firestore 在 Firebase 控制台中，前往「資料」Cloud Firestore分頁，查看資料庫執行個體清單及其位置。
Firebase Realtime Database 在 Firebase 控制台中，前往「資料」Realtime Database分頁，查看資料庫執行個體清單及其位置。
Cloud Storage for Firebase 在 Firebase 控制台中，前往「檔案」Cloud Storage分頁，即可查看 bucket 清單及其位置。
Cloud Functions for Firebase
  • 排程函式：在 Google Cloud 控制台中，前往 Cloud Scheduler，即可查看每個工作和函式的主題清單。位置是主題名稱的最後一個區段。
  • 非排程函式：在函式的原始碼中，尋找 region 參數。如未指定區域，則預設位置為 us-central1。

「預設 Google Cloud 資源位置」可能導致位置依附元件

「預設 Google Cloud 資源的位置」是指與 Google App Engine 相關聯的所有專案資源的位置設定，包括：

  • 預設 Cloud Firestore 資料庫執行個體
  • Firebase 值區的預設 Cloud Storage，名稱格式為 *.appspot.com
  • Google Cloud Scheduler，專門用於第 1 代排程函式

「預設Google Cloud資源位置」是不可變更的設定。此外，由於相關聯的資源都與 App Engine 相關聯，因此當您為其中一個資源設定位置時，也會間接為所有資源設定位置。

不過，Firebase 和 Google Cloud 生態系統多年來歷經許多變化，資源與 App Engine 的關聯也隨之改變。最值得注意的是，自 2024 年 10 月 30 日起，所有新佈建的 Firebase 預設 Cloud Storage bucket 都會採用 *.firebasestorage.app 的命名格式，且不會與 App Engine 建立關聯。

以下是可能位置資訊依附元件的變更詳細資料：

  • 2024 年 10 月 30 日起，如果尚未佈建預設 Cloud Firestore 執行個體和 Firebase bucket 的預設 Cloud Storage：

    • 佈建預設 Cloud Firestore 執行個體會為專案中佈建的任何未來 App Engine 應用程式設定位置。 不過，這不會決定日後預設 Cloud Storage 值區的位置。

    • 系統不再透過佈建預設 Cloud Storage 值區佈建 App Engine 應用程式。因此，預設 Cloud Storage 值區的位置不會決定未來預設 Cloud Firestore 執行個體的位置。

  • 2024 年 10 月 30 日起，如果已佈建預設Cloud Firestore執行個體，但尚未佈建 Firebase bucket 的預設 Cloud Storage：

    • 現有的預設 Cloud Firestore 執行個體「不會」決定未來預設 Cloud Storage bucket (*.firebasestorage.app) 的位置。

  • 2024 年 10 月 30 日起，如果已 佈建 Firebase bucket 的 預設 Cloud Storage (具體來說，就是 *.appspot.com bucket)，但尚未佈建 預設 Cloud Firestore 執行個體：

    • 在佈建預設 Cloud Storage bucket (*.appspot.com) 時，App Engine 應用程式也會一併佈建，因此未來預設 Cloud Firestore 執行個體的位置會在當時設定。即使刪除 *.appspot.com 值區，也無法刪除 App Engine 應用程式，因此系統已設定未來預設 Cloud Firestore 執行個體的位置設定。

如果您使用第 1 代排程函式，系統會將函式位置設為預設 Google Cloud 資源的位置。這是因為「Cloud Scheduler」和「App Engine」先前已建立關聯。此外，如果您先設定第 1 代排程函式，然後佈建共用這個位置設定的其他資源，也請設定這些資源的位置。

後續步驟

  • 如要進一步瞭解如何建構符合延遲時間、可用性與耐用性需求的應用程式，請參閱地理位置與地區。