Узнайте о расположении продуктов и ресурсов в вашем проекте.

Глобальных настроек местоположения на уровне проекта или приложения не существует.
Местоположение задается для каждого продукта или ресурса, а в некоторых случаях — для группы продуктов. Однако обычно местоположение для каждого продукта и каждого ресурса задается независимо от других.

Обратите внимание, что некоторые продукты и ресурсы Firebase не поддерживают выбор местоположения . Кроме того, вы можете дополнительно установить ограничение по местоположению на уровне организации для продуктов и ресурсов, поддерживающих выбор местоположения.

Товары или ресурсы, требующие указания местоположения.

Для некоторых товаров или ресурсов требуется указать местоположение.

Продукт	Местоположение по умолчанию	Дополнительная информация
Firebase AI Logic	Для Gemini Developer API : выбор местоположения невозможен; всегда используется глобальный адрес. Для API Vertex AI Gemini : если местоположение не указано, используется регион по умолчанию. us-central1 .	Здесь вы получаете доступ к модели.
Google Analytics	Местоположение по умолчанию отсутствует. Необходимо указать это местоположение.	Это местоположение — местоположение для формирования отчетов Analytics ^2 , которое представляет страну или регион вашей организации. Ваше местоположение для формирования отчетов Analytics , в свою очередь, определяет валюту для отчетности по доходам.
Firebase App Hosting	Местоположение по умолчанию отсутствует. Необходимо указать это местоположение для каждого бэкэнда.	В этом месте развертывание App Hosting создает все ваши серверные ресурсы. Каждый бэкэнд может располагаться в разном месте.
Firebase Data Connect	Местоположение по умолчанию отсутствует. Необходимо указать местоположение для каждого экземпляра.	Каждый экземпляр может находиться в разном месте.
Cloud Firestore ^1	Местоположение по умолчанию отсутствует. Необходимо указать местоположение для каждого экземпляра.	Каждый экземпляр может находиться в разном месте.
Firebase Realtime Database	Местоположение по умолчанию отсутствует. Необходимо указать местоположение для каждого экземпляра.	Каждый экземпляр может находиться в разном месте.
Cloud Storage for Firebase ^1	Местоположение по умолчанию отсутствует. Необходимо указать местоположение для каждого контейнера.	Каждое ведро может находиться в разном месте.
Cloud Functions for Firebase ^1	Если местоположение не указано, используется регион по умолчанию. us-central1 .	Каждая функция может находиться в разном месте.

^1. В зависимости от того, когда вы впервые начали использовать эти продукты в своем проекте, между ними могут существовать зависимости по местоположению. Вы можете встретить такую ​​зависимость, как «местоположение для ресурсов Google Cloud по умолчанию». Узнайте больше об этой зависимости по местоположению .

^2. Место, где вы указываете данные для отчетности в Analytics не влияет на то, где Google может обрабатывать и хранить данные клиентов для Firebase .

Укажите местоположение продукта или его ресурсов.

Для некоторых продуктов местоположение задается на уровне продукта. Однако для большинства продуктов местоположение задается на уровне ресурса (например, для каждого сегмента Cloud Storage или каждой функции).

Продукт	Когда и как установить местоположение	Доступные места
Firebase AI Logic	Для Gemini Developer API : выбор местоположения невозможен; всегда используется глобальный адрес. Для API Vertex AI Gemini : при инициализации серверной части Vertex AI в вашем коде вы можете дополнительно указать место, откуда будет осуществляться доступ к модели. Если вы не укажете местоположение, по умолчанию будет использоваться следующий регион: us-central1 .	Места расположения Firebase AI Logic
Google Analytics	При включении Google Analytics в вашем проекте Firebase в консоли Firebase вам будет предложено выбрать местоположение для создания отчетов Analytics. Вам следует выбрать страну или регион, соответствующий местоположению вашей организации. Если вы являетесь владельцем проекта или редактором, вы можете позже изменить часовой пояс и валюту для местоположения отчетов Google Analytics; для этого перейдите в настройки Google Analytics , а затем в раздел «Отчеты» .	Список см. в настройках Google Analytics > Панель отчетов .
Firebase App Hosting	При создании бэкэнда App Hosting вам будет предложено выбрать местоположение. Для создания бэкэнда можно использовать консоль Firebase , REST API или Firebase CLI.	Места App Hosting
Firebase Data Connect	При создании экземпляра службы Data Connect вы задаете его местоположение. Вы также задаете местоположение связанного с ним экземпляра Google Cloud SQL . Для создания экземпляра можно использовать консоль Firebase или Firebase CLI.	Расположение сервиса Data 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.	Cloud Storage for Firebase
Cloud Functions for Firebase ^1	При написании функции вы можете дополнительно задать её область действия. Если вы не укажете местоположение, по умолчанию будет использоваться следующий регион: us-central1 .	Cloud Functions for Firebase

^1. В зависимости от того, когда вы впервые начали использовать эти продукты в своем проекте, между ними могут существовать зависимости по местоположению. Вы можете встретить такую ​​зависимость, как «местоположение для ресурсов Google Cloud по умолчанию». Узнайте больше об этой зависимости по местоположению .

Просмотреть настройки местоположения

Продукт	Где посмотреть настройки местоположения
Firebase AI Logic	Для Gemini Developer API : выбор местоположения невозможен; всегда используется глобальный адрес. Для API Vertex AI Gemini : в вашем коде найдите инициализацию бэкэнд-сервиса Vertex AI . Если местоположение не указано, то используется местоположение по умолчанию. 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 Data Connect	В консоли Firebase перейдите на страницу Data Connect , чтобы просмотреть список экземпляров вашей базы данных и их местоположение.
Cloud Firestore	В консоли Firebase перейдите на вкладку « Данные Cloud Firestore , чтобы просмотреть список экземпляров вашей базы данных и их местоположение.
Firebase Realtime Database	В консоли Firebase перейдите на вкладку «Данные Realtime Database , чтобы просмотреть список экземпляров вашей базы данных и их местоположение.
Cloud Storage for Firebase	В консоли Firebase перейдите на вкладку « Файлы Cloud Storage , чтобы просмотреть список ваших хранилищ и их местоположение.
Cloud Functions for Firebase	Запланированные функции: В консоли Google Cloud перейдите в Cloud Scheduler , чтобы просмотреть список тем для каждого задания и функции. Местоположение — это последний сегмент в названии темы. Непланируемые функции: В исходном коде вашей функции найдите параметр region . Если регион не указан, то местоположение по умолчанию — это... us-central1 .

Возможны зависимости от местоположения из-за "местоположения для ресурсов Google Cloud по умолчанию".

Параметр «Расположение ресурсов Google Cloud по умолчанию» — это параметр, определяющий местоположение любых ресурсов проекта, связанных с Google App Engine , включая следующие:

• экземпляр базы данных Cloud Firestore по умолчанию
• Корзина Cloud Storage для Firebase по умолчанию имеет следующий формат имени: *.appspot.com
• Google Cloud Scheduler используется специально для запланированных функций первого поколения.

Примечание: Ни один из других ресурсов в вашем проекте не имеет этой зависимости от местоположения, включая следующие: экземпляры Realtime Database, нестандартные экземпляры Cloud Firestore , нестандартные корзины Cloud Storage , стандартные корзины Cloud Storage с указанным форматом имени. *.firebasestorage.app , незапланированные функции и запланированные функции 2-го поколения.

Это "местоположение для ресурсов Google Cloud по умолчанию" является неизменяемой настройкой. Кроме того, когда вы задаете местоположение для одного из связанных ресурсов, вы косвенно задаете местоположение для всех них из-за их общей связи с App Engine .

Однако, в связи с многочисленными изменениями в экосистеме Firebase и Google Cloud за эти годы, связь ресурсов с App Engine также претерпела изменения. Наиболее примечательно то, что начиная с 30 октября 2024 года все вновь создаваемые по умолчанию Cloud Storage for Firebase имеют следующий формат именования: *.firebasestorage.app , и они не связаны с App Engine .

Ключевой момент: начиная с 30 октября 2024 года , при создании корзины Cloud Storage for Firebase по умолчанию больше не задается "расположение ресурсов Google Cloud по умолчанию" (например, расположение экземпляра Cloud Firestore по умолчанию для проекта). Кроме того, при создании экземпляра Cloud Firestore по умолчанию больше не задается расположение новой корзины Cloud Storage for Firebase по умолчанию (с форматом имени, например, *.firebasestorage.app ).

Вот подробности изменений в возможных зависимостях местоположения :

• Начиная с 30 октября 2024 года , если стандартный экземпляр Cloud Firestore и стандартный сегмент Cloud Storage for Firebase еще не созданы:

  • Создание экземпляра Cloud Firestore по умолчанию определяет местоположение для любого будущего приложения App Engine , созданного в проекте. Однако это не определяет местоположение будущего сегмента Cloud Storage по умолчанию.

  • Создание Cloud Storage по умолчанию больше не приводит к созданию приложения App Engine . Таким образом, местоположение Cloud Storage по умолчанию не определяет местоположение будущего экземпляра Cloud Firestore по умолчанию.

• Начиная с 30 октября 2024 года , если стандартный экземпляр Cloud Firestore уже создан, но стандартный сегмент Cloud Storage for Firebase еще не создан:

  • Существующий экземпляр Cloud Firestore по умолчанию не определяет местоположение будущего сегмента Cloud Storage по умолчанию. *.firebasestorage.app ).

• Начиная с 30 октября 2024 года , если стандартный сегмент Cloud Storage for Firebase уже создан (в частности, *.appspot.com bucket) , но экземпляр Cloud Firestore по умолчанию не был создан:

  • Back when the default Cloud Storage bucket ( После создания учетной записи *.appspot.com было также создано приложение App Engine , и, таким образом, местоположение будущего экземпляра Cloud Firestore по умолчанию было определено в тот момент. Даже если вы удалите В хранилище *.appspot.com нельзя удалить приложение App Engine , поэтому параметры местоположения для будущего экземпляра Cloud Firestore по умолчанию уже заданы.

Если вы использовали запланированные функции первого поколения , то их местоположение устанавливается в соответствии с местоположением ресурсов Google Cloud по умолчанию. Это связано с тем, что Cloud Scheduler и App Engine ранее были связаны друг с другом. Кроме того, если вы настроили запланированные функции первого поколения до выделения других ресурсов, которые используют это же местоположение, то вы также устанавливаете их местоположение.

Следующие шаги

• Для получения дополнительной информации о создании приложений, отвечающих вашим требованиям к задержке, доступности и отказоустойчивости, обратитесь к разделу «География и регионы» .