查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

了解项目中的产品和资源的位置

需要设置位置信息的产品或资源

多个产品或资源需要设置位置信息。

产品	默认位置	其他信息
Google Analytics	没有默认位置。您必须设置此位置。	此位置是Analytics报告位置²，代表贵组织所在的国家或地区。Analytics 报告位置会决定收入报告所采用的币种。
Data Connect	没有默认位置。您必须为每个实例设置位置。	每个实例都可以位于不同的位置。
Cloud Firestore ¹	没有默认位置。您必须为每个实例设置位置。	每个实例都可以位于不同的位置。
Realtime Database	没有默认位置。您必须为每个实例设置位置。	每个实例都可以位于不同的位置。
Cloud Storage for Firebase ¹	没有默认位置。您必须为每个存储桶设置位置。	每个存储桶都可以位于不同的位置。
Cloud Functions for Firebase ¹	如果未设置位置，则默认区域为 `us-central1`。	每个函数都可以位于不同的位置。
Vertex AI in Firebase	如果未设置位置，则默认区域为 `us-central1`。	此位置是运行 Vertex AI 服务以及您访问模型的位置。

¹ 这些产品之间可能存在位置依赖关系，具体取决于您在项目中首次开始使用这些产品的时间。您可能会看到此依赖项被称为“默认 Google Cloud 资源的位置”。详细了解此位置依赖项。

² 您的 Analytics 报告位置不会影响 Google 处理及存储 Firebase 客户数据的位置，

为产品或其资源设置位置

对于某些产品，您可以在产品级别设置位置。不过，对于大多数产品，您需要在资源级别设置位置（例如，为每个 Cloud Storage 存储桶或每个函数设置位置）。

产品	何时以及如何设置位置	可用位置
Google Analytics	如果通过 Firebase 控制台为 Firebase 项目启用 Google Analytics，系统会提示您选择 Analytics 报告位置。您应选择代表贵组织所在位置的国家/地区。如果您的角色为项目 Owner 或 Editor，则可以修改 Analytics 报告位置的时区和币种；前往您的 Google Analytics 设置，然后前往“报告”窗格。	请参阅Google Analytics设置 > 报告窗格中的列表。
Data Connect	配置 Data Connect 服务实例时，您需要设置其位置。您还需要设置关联的 Google Cloud SQL 实例的位置。您可以使用 Firebase 控制台或 Firebase CLI 来预配实例。	Data Connect 服务和 Cloud SQL 实例位置
Cloud Firestore ¹	预配 Cloud Firestore 数据库实例时，您需要设置其位置。您可以使用 Firebase 控制台、REST API、Firebase CLI 或 Terraform 来预配实例。	Cloud Firestore 位置
Realtime Database	预配 Realtime Database 实例时，您可以设置其位置。您可以使用 Firebase 控制台、REST API、Firebase CLI 或 Terraform 来配置实例。	Realtime Database 位置
Cloud Storage for Firebase ¹	预配 Cloud Storage 存储桶时，您需要设置其位置。您可以使用 Firebase 控制台、REST API 或 Terraform 来配置存储桶。	Cloud Storage for Firebase 位置
Cloud Functions for Firebase ¹	编写函数时，您可以选择设置其区域。如果您未指定位置，则默认区域为 `us-central1`。	Cloud Functions for Firebase 位置
Vertex AI in Firebase	在代码库中初始化 Vertex AI 服务和生成模型时，您可以选择指定位置。如果您未指定位置，则默认区域为 `us-central1`。	Vertex AI in Firebase 位置

查看位置信息设置

产品	在哪里查看位置信息设置
Google Analytics	在 Firebase 控制台中，前往“设置”“项目设置”>“集成”>“Google Analytics”。点击账号以打开您的 Google Analytics 账号，然后前往管理面板，查找您的账号所在的位置信息。
Data Connect	在 Firebase 控制台中，转到Data Connect页面以查看数据库实例及其位置的列表。
Cloud Firestore	在 Firebase 控制台中，转到Cloud Firestore“数据”标签页，查看数据库实例及其位置的列表。
Realtime Database	在 Firebase 控制台中，转到Realtime Database“数据”标签页，查看数据库实例及其位置的列表。
Cloud Storage for Firebase	在 Firebase 控制台中，转到Cloud Storage“文件”标签页，查看存储桶及其位置的列表。
Cloud Functions for Firebase	Google Cloud预定函数 - 在 Cloud Scheduler 控制台中，前往以查看每个作业和函数的主题列表。位置是主题名称中的最后一个部分。非预定函数：在函数的源代码中，查找 `region` 参数。如果未指定区域，则默认位置为 `us-central1`。
Vertex AI in Firebase	在您的代码库中，查找 Vertex AI 服务和生成模型的初始化。如果未指定位置，则默认位置为 `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 的名称格式都为 *.firebasestorage.app，并且不与 App Engine 相关联。

以下是可能的位置依赖项中发生变化的详细信息：

从 2024 年 10 月 30 日开始，如果默认 Cloud Firestore 实例和 Firebase 存储桶的默认 Cloud Storage 尚未配置，则：
- 预配默认的 Cloud Firestore 实例会为项目中日后预配的任何 App Engine 应用设置位置。不过，它不会决定未来默认 Cloud Storage 存储桶的位置。
- 配置默认的 Cloud Storage 存储桶不再会配置 App Engine 应用。因此，默认 Cloud Storage 存储桶的位置不会决定未来默认 Cloud Firestore 实例的位置。
从 2024 年 10 月 30 日开始，如果默认 Cloud Firestore 实例已配置，但 Firebase 存储桶的默认 Cloud Storage 尚未配置：
- 现有的默认 Cloud Firestore 实例不会决定未来默认 Cloud Storage 存储桶的位置 (*.firebasestorage.app)。
从 2024 年 10 月 30 日开始，如果 Firebase 存储桶的默认 Cloud Storage 已配置（具体而言，是 *.appspot.com 存储桶），但默认 Cloud Firestore 实例未配置：
- 在配置默认 Cloud Storage 存储桶 (*.appspot.com) 时，还配置了 App Engine 应用，因此当时就设置了未来默认 Cloud Firestore 实例的位置。即使您删除了 *.appspot.com 存储桶，也无法删除 App Engine 应用，因此未来默认 Cloud Firestore 实例的位置设置已设置。

如果您使用的是第 1 代调度函数，则其位置会设置为默认 Google Cloud 资源的位置。这是因为 Cloud Scheduler 和 App Engine 之前相互关联。此外，如果您在预配共用此位置信息设置的其他资源之前设置了第 1 代预定函数，那么您也需要设置其位置信息。

后续步骤

如需详细了解如何构建应用以满足您的延迟、可用性和耐用性要求，请参阅地理位置和区域。