Informazioni sulle località dei prodotti e delle risorse nel progetto

Prodotti o risorse che richiedono un'impostazione della località

Diversi prodotti o risorse richiedono un'impostazione della località.

Product	Default location	Additional information
Firebase AI Logic	Per Gemini Developer API: non è possibile selezionare la località; è sempre globale. Per Vertex AI Gemini API: se la località non è impostata, la regione predefinita è `us-central1`.	Questa località è quella in cui puoi accedere al modello.
Google Analytics	Nessuna località predefinita. Devi impostare questa località.	Questa località è la Analytics località dei report², che rappresenta il paese o la regione della tua organizzazione. A sua volta, la località dei report Analytics imposta la valuta per i report sulle entrate.
Firebase App Hosting	Nessuna località predefinita. Devi impostare questa località per ogni backend.	Questa località è quella in cui App Hosting deployment crea ciascuna delle risorse di backend. Ogni backend può trovarsi in una località diversa.
Firebase Data Connect	Nessuna località predefinita. Devi impostare la località per ogni istanza.	Ogni istanza può trovarsi in una località diversa.
Cloud Firestore ¹	Nessuna località predefinita. Devi impostare la località per ogni istanza.	Ogni istanza può trovarsi in una località diversa.
Firebase Realtime Database	Nessuna località predefinita. Devi impostare la località per ogni istanza.	Ogni istanza può trovarsi in una località diversa.
Cloud Storage for Firebase ¹	Nessuna località predefinita. Devi impostare la località per ogni bucket.	Ogni bucket può trovarsi in una località diversa.
Cloud Functions for Firebase ¹	Se la località non è impostata, la regione predefinita è `us-central1`.	Ogni funzione può trovarsi in una località diversa.

¹ A seconda di quando hai iniziato a utilizzare questi prodotti in nel tuo progetto, potrebbero esistere dipendenze di località tra questi prodotti. Potresti vedere questa dipendenza indicata come la "località per le risorse Google Cloud predefinite". Scopri di più su questa dipendenza di località.

² La località dei report Analytics non influisce sulla località di elaborazione e archiviazione dei dati dei clienti da parte di Google per Firebase.

Impostare una località per un prodotto o le relative risorse

Per alcuni prodotti, imposti la località a livello di prodotto. Tuttavia, per la maggior parte dei prodotti, imposti la località a livello di risorsa (ad esempio, per ogni Cloud Storage bucket o ogni funzione).

Product	When and how to set the location	Available locations
Firebase AI Logic	Per Gemini Developer API: non è possibile selezionare la località; è sempre globale. Per Vertex AI Gemini API: quando inizializzi il servizio di backend nel codice, puoi facoltativamente specificare una località per accedere al modello.Vertex AI Se non specifichi una località, la regione predefinita è `us-central1`.	Firebase AI Logic località
Google Analytics	Quando abiliti Google Analytics nel tuo progetto Firebase nella Firebase console, ti viene chiesto di selezionare una località dei report di Analytics. Devi selezionare un paese o una regione che rappresenti la località della tua organizzazione. Se sei il proprietario o l'editor di un progetto, puoi modificare in un secondo momento il fuso orario e la valuta per la località dei report di Analytics; vai alle Google Analytics impostazioni, quindi al riquadro Report.	Consulta l'elenco nel Google Analytics riquadro > Report delle impostazioni.
Firebase App Hosting	Quando crei un App Hosting backend, ti viene chiesto di selezionare una località. Puoi utilizzare la Firebase console, l'API REST o Firebase CLI per creare un backend.	App Hosting località
Firebase Data Connect	Quando esegui il provisioning di un'istanza del servizio Data Connect, imposti le relative località. Imposti anche la località dell'istanza associata Google Cloud SQL. Puoi utilizzare la console o la CLI per eseguire il provisioning di un'istanza. FirebaseFirebase	Località del servizio Data Connect e dell'istanza Cloud SQL
Cloud Firestore ¹	Quando esegui il provisioning di un'istanza del database Cloud Firestore, imposti la relativa località. Puoi utilizzare la Firebase console, l'API REST, Firebase CLI o Terraform per eseguire il provisioning di un'istanza.	Cloud Firestore località
Firebase Realtime Database	Quando esegui il provisioning dell'istanza Realtime Database, imposti la relativa località. Puoi utilizzare la console Firebase, l'API REST, la CLI Firebase o Terraform per eseguire il provisioning di un'istanza.	Realtime Database località
Cloud Storage for Firebase ¹	Quando esegui il provisioning del Cloud Storage bucket, imposti la relativa località. Puoi utilizzare la console Firebase , l'API REST o Terraform per eseguire il provisioning di un bucket.	Cloud Storage for Firebase località
Cloud Functions for Firebase ¹	Quando scrivi una funzione, puoi facoltativamente impostarne la regione. Se non specifichi una località, la regione predefinita è `us-central1`.	Cloud Functions for Firebase località

Visualizzare le impostazioni di localizzazione

Product	Where to view the location setting
Firebase AI Logic	Per Gemini Developer API: non è possibile selezionare la località; è sempre globale. Per Vertex AI Gemini API: nel codice, cerca l'inizializzazione del servizio di backend Vertex AI. Se non viene specificata una località, la località predefinita è `us-central1`.
Google Analytics	Nella console Firebase, vai a Impostazioni Impostazioni progetto > Integrazioni > Google Analytics. Fai clic sul numero di conto bancario per aprire il tuo Google Analytics account, quindi vai al pannello di amministrazione per trovare i dati sulla posizione del tuo account.
Firebase App Hosting	Nella console Firebase, vai alla pagina App Hosting per visualizzare l'elenco dei backend e delle relative località. Per visualizzare la località di un backend specifico, puoi utilizzare il comando CLI Firebase`firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID`
Firebase Data Connect	Nella console Firebase, vai alla pagina Data Connect per visualizzare l'elenco delle istanze del database e delle relative località.
Cloud Firestore	Nella console Firebase, vai alla scheda Cloud Firestore Dati per visualizzare l'elenco delle istanze del database e delle relative località.
Firebase Realtime Database	Nella console Firebase, vai alla scheda Realtime Database Dati per visualizzare l'elenco delle istanze del database e delle relative località.
Cloud Storage for Firebase	Nella console Firebase, vai alla scheda Cloud Storage File per visualizzare l'elenco dei bucket e delle relative località.
Cloud Functions for Firebase	Funzioni pianificate: nella console Google Cloud, vai a Cloud Scheduler per visualizzare l'elenco degli argomenti per ogni job e funzione. La località è l'ultimo segmento nel nome dell'argomento. Funzioni non pianificate: nel codice sorgente della funzione, cerca un `region` parametro. Se non viene specificata una regione, la località predefinita è `us-central1`.

Possibili dipendenze di località dovute alla "località per le risorse Google Cloud predefinite"

La "località per le risorse Google Cloud predefinite" è l'impostazione della località per tutte le risorse del progetto associate a Google App Engine, tra cui:

Istanza del database Cloud Firestore predefinita
predefinito Cloud Storage per Firebase bucket con il formato del nome *.appspot.com
Google Cloud Scheduler utilizzato specificamente con le funzioni pianificate di 1ª gen.

Questa "località per le risorse Google Cloud predefinite" è un'impostazione immutabile. Inoltre, quando imposti la località per una delle risorse associate, imposti indirettamente la località per tutte le risorse a causa della loro associazione comune a App Engine.

Tuttavia, con le numerose modifiche apportate all'ecosistema Firebase e Google Cloud nel corso degli anni, le associazioni delle risorse a App Engine sono cambiate. In particolare, a partire dal 30 ottobre 2024, tutti i bucket predefiniti Cloud Storage per Firebase di cui è stato eseguito il provisioning di recente hanno il formato del nome *.firebasestorage.app e non sono associati a App Engine.

Di seguito sono riportati i dettagli delle modifiche apportate alle possibili dipendenze di località:

A partire dal 30 ottobre 2024, se l' istanza Cloud Firestore predefinita e il bucket Cloud Storage per Firebase predefinito non sono ancora stati sottoposti a provisioning:
- Il provisioning dell'istanza Cloud Firestore predefinita imposta la località per qualsiasi app App Engine futura di cui è stato eseguito il provisioning nel progetto. Tuttavia, non determina la località del futuro predefinito Cloud Storage bucket.
- Il provisioning del bucket Cloud Storage predefinito non esegue più il provisioning di un'app App Engine. Di conseguenza, la località del bucket Cloud Storage predefinito non determina la località della futura istanza Cloud Firestore predefinita.
A partire dal 30 ottobre 2024, se l'istanza Cloud Firestore predefinita è già stata sottoposta a provisioning, ma il bucket Cloud Storage per Firebase predefinito non è stato sottoposto a provisioning:
- L'istanza predefinita esistente Cloud Firestore non determina la località del futuro bucket predefinito Cloud Storage (*.firebasestorage.app).
A partire dal 30 ottobre 2024, se il bucket Cloud Storage per Firebase predefinito è già stato sottoposto a provisioning (in particolare, il bucket *.appspot.com), ma l' istanza Cloud Firestore predefinita non è stata sottoposta a provisioning:
- Quando è stato eseguito il provisioning del bucket Cloud Storage predefinito (*.appspot.com), è stato eseguito il provisioning anche di un'app App Engine e, di conseguenza, la località della futura istanza Cloud Firestore predefinita è stata impostata in quel momento. Anche se elimini il bucket *.appspot.com, non puoi eliminare l'app App Engine, quindi l'impostazione della località della futura istanza Cloud Firestore predefinita è già impostata.

Se hai utilizzato le funzioni pianificate di 1ª gen., la relativa località è impostata sulla località per le risorse Google Cloud predefinite. Questo perché Cloud Scheduler e App Engine avevano in precedenza un'associazione con l'altro. Inoltre, se hai configurato le funzioni pianificate di 1ª gen. prima di eseguire il provisioning di altre risorse che condividevano questa impostazione della località, hai impostato anche la relativa località.

Passaggi successivi

Per ulteriori informazioni sulla creazione di applicazioni che soddisfino i requisiti di latenza, disponibilità e durabilità, consulta Geografia e regioni.