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

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

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

產品 預設位置 其他資訊
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 設定位置。 		每個 bucket 都可以位於不同位置。
Cloud Functions for Firebase 1 如未設定位置，預設區域為 us-central1。 每個函式可以位於不同位置。

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

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

設定產品或其資源的位置

如果只有少數產品，請在產品層級設定地點。不過，對於大多數產品，您必須在資源層級設定位置 (例如每個 Cloud Storage bucket 或每個函式)。

產品 設定位置的時機和方式 適用地區
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 bucket 時，您會設定其位置。
您可以使用 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「Data」(資料) 分頁，查看資料庫執行個體及其位置清單。
Firebase Realtime Database 在 Firebase 控制台中，前往Realtime Database「Data」(資料) 分頁，查看資料庫執行個體清單及其位置。
Cloud Storage for Firebase 在 Firebase 控制台中，前往「Cloud Storage Files」(檔案) 分頁，查看 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 日起，所有新佈建的預設 Cloud Storage for Firebase bucket 都會採用 *.firebasestorage.app 格式，且不會與 App Engine 建立關聯。

以下是可能位置依附元件的變更詳情：

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

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

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

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

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

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

    • 佈建預設 Cloud Storage bucket (*.appspot.com) 時，系統「也」佈建了 App Engine 應用程式，因此當時已設定未來預設 Cloud Firestore 執行個體的位置。即使刪除 *.appspot.com bucket，也無法刪除 App Engine 應用程式，因此未來預設 Cloud Firestore 執行個體的位置資訊設定已設妥。

如果您使用第 1 代排定函式，其位置會設為預設 Google Cloud 資源的位置。這是因為 Cloud Scheduler 和 App Engine 先前彼此相關聯。此外，如果您在佈建其他共用這項位置資訊設定的資源之前，就設定了第 1 代排定函式，那麼您也設定了這些資源的位置。

後續步驟

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