Informazioni sulle località dei prodotti e delle risorse nel progetto

Non esiste un'impostazione globale della posizione a livello di progetto o di app.
Le località vengono impostate per prodotto o per risorsa e, in alcuni casi, per gruppo di prodotti. In genere, però, la località viene impostata per ogni prodotto e ogni risorsa indipendentemente dalle altre.

Tieni presente che alcuni prodotti e risorse Firebase non supportano la selezione della località. Inoltre, puoi facoltativamente impostare una limitazione della località a livello di organizzazione per i prodotti e le risorse che supportano la selezione della località.

Prodotti o risorse che richiedono un'impostazione di localizzazione

Diversi prodotti o risorse richiedono un'impostazione di localizzazione.

Product	Località predefinita	Ulteriori informazioni
Firebase AI Logic	Per Gemini Developer API: non è possibile selezionare la località; è sempre globale. Per Agent Platform Gemini API (formerly Vertex AI): se la località non è impostata, la regione predefinita è us-central1.	Questa è la località da cui accedi al modello.
Google Analytics	Nessuna località predefinita. Devi impostare questa località.	Questa località è la località per i report Analytics^2, che rappresenta il paese o la regione della tua organizzazione. La tua località per i report Analytics, a sua volta, imposta la valuta per i report Entrate.
Firebase App Hosting	Nessuna località predefinita. Devi impostare questa località per ogni backend.	In questa località, il deployment App Hosting crea ciascuna delle tue risorse di backend. Ogni backend può trovarsi in una località diversa.
Firebase SQL Connect	Nessuna località predefinita. Devi impostare la località per ogni istanza.	Ogni istanza può trovarsi in una località diversa.
Cloud Firestore ^1	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 ^1	Nessuna località predefinita. Devi impostare la località per ogni bucket.	Ogni bucket può trovarsi in una località diversa.
Cloud Functions for Firebase ^1	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 nel tuo progetto, potrebbero esserci dipendenze di località tra questi prodotti. Questa dipendenza potrebbe essere indicata come "località per le risorse Google Cloud predefinite". Scopri di più su questa dipendenza dalla località.

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

Imposta una località per un prodotto o le relative risorse

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

Product	Quando e come impostare la località	Paesi in cui è disponibile la funzionalità
Firebase AI Logic	Per Gemini Developer API: non è possibile selezionare la località; è sempre globale. Per Agent Platform Gemini API (formerly Vertex AI): quando inizializzi il servizio di backend Agent Platform nel tuo codebase, puoi facoltativamente specificare una località da cui accedere al modello. Se non specifichi una località, la regione predefinita è us-central1.	Firebase AI Logic località
Google Analytics	Quando attivi Google Analytics nel tuo progetto Firebase nella console Firebase, ti viene chiesto di selezionare una località per i report di Analytics. Devi selezionare un paese o una regione che rappresenti la località della tua organizzazione. Se sei un Project Owner o un Editor, puoi modificare in un secondo momento il fuso orario e la valuta per la località dei report di Analytics. Vai alle impostazioni di Google Analytics, quindi al riquadro Reporting.	Visualizza l'elenco nel riquadro Impostazioni Google Analytics > Report.
Firebase App Hosting	Quando crei un backend App Hosting, ti viene chiesto di selezionare una località. Puoi utilizzare la console Firebase, l'API REST o l'interfaccia a riga di comando Firebase per creare un backend.	App Hosting località
Firebase SQL Connect	Quando esegui il provisioning di un'istanza di servizio SQL Connect, imposti le sue località. Imposti anche la località dell'istanza Google Cloud SQL associata. Puoi utilizzare la console Firebase o l'interfaccia a riga di comando Firebase per eseguire il provisioning di un'istanza.	Servizio SQL Connect e località delle istanze Cloud SQL
Cloud Firestore ^1	Quando esegui il provisioning di un'istanza di database Cloud Firestore, ne imposti la località. Per eseguire il provisioning di un'istanza, puoi utilizzare la console Firebase, l'API REST, l'interfaccia a riga di comando Firebase o Terraform.	Cloud Firestore località
Firebase Realtime Database	Quando esegui il provisioning dell'istanza Realtime Database, ne imposti la località. Puoi utilizzare la console Firebase, l'API REST, l'interfaccia a riga di comando Firebase o Terraform per eseguire il provisioning di un'istanza.	Realtime Database località
Cloud Storage for Firebase ^1	Quando esegui il provisioning del bucket Cloud Storage, ne imposti la 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 ^1	Quando scrivi una funzione, puoi impostarne la regione. Se non specifichi una località, la regione predefinita è us-central1.	Cloud Functions for Firebase località

¹ A seconda di quando hai iniziato a utilizzare questi prodotti nel tuo progetto, potrebbero esserci dipendenze di località tra questi prodotti. Questa dipendenza potrebbe essere indicata come "località per le risorse Google Cloud predefinite". Scopri di più su questa dipendenza dalla località.

Visualizza le impostazioni di geolocalizzazione

Product	Dove visualizzare l'impostazione di geolocalizzazione
Firebase AI Logic	Per Gemini Developer API: non è possibile selezionare la località; è sempre globale. Per Agent Platform Gemini API (formerly Vertex AI): nel codebase, cerca l'inizializzazione del servizio di backend Agent Platform. Se non viene specificata una località, quella 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 account Google Analytics, quindi vai al pannello di amministrazione Admin 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 tuoi backend e delle relative località. Per visualizzare la località di un backend specifico, puoi utilizzare il comando dell'interfaccia a riga di comando Firebase firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
Firebase SQL Connect	Nella console Firebase, vai alla pagina SQL Connect per visualizzare l'elenco delle istanze di database e le relative località.
Cloud Firestore	Nella console Firebase, vai alla scheda Cloud Firestore Dati per visualizzare l'elenco delle istanze di database e le relative località.
Firebase Realtime Database	Nella console Firebase, vai alla scheda Realtime Database Dati per visualizzare l'elenco delle istanze di database e le 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 del nome dell'argomento. Funzioni non pianificate: nel codice sorgente della funzione, cerca un parametro region. Se non viene specificata una regione, la località predefinita è us-central1.

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

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

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

Nota: nessuna delle altre risorse del progetto condivide questa dipendenza dalla località, tra cui: istanze Realtime Database, istanze Cloud Firestore non predefinite, bucket Cloud Storage non predefiniti, bucket Cloud Storage predefiniti con il formato del nome *.firebasestorage.app, funzioni non pianificate e funzioni pianificate di 2ª generazione.

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, a causa della loro associazione comune con App Engine.

Tuttavia, con i numerosi cambiamenti apportati 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 Cloud Storage per Firebase predefiniti di cui è stato eseguito il provisioning di recente hanno il formato del nome *.firebasestorage.app e non sono associati a App Engine.

Cloud StorageGoogle CloudCloud Firestore Inoltre, il provisioning dell'istanza Cloud Firestore predefinita non imposta più la località per un nuovo bucket Cloud Storage predefinito per Firebase (con il formato del nome *.firebasestorage.app).

Ecco i dettagli delle modifiche alle possibili dipendenze della località:

• A partire dal 30 ottobre 2024, se l'istanza Cloud Firestore predefinita e il bucket Cloud Storage for Firebase predefinito non sono ancora stati sottoposti a provisioning:

  • Il provisioning dell'istanza Cloud Firestore predefinita imposta la località per qualsiasi futura app App Engine di cui viene eseguito il provisioning nel progetto. Tuttavia, non determina la posizione del futuro bucket Cloud Storage predefinito.

  • Il provisioning del bucket Cloud Storage predefinito non esegue più il provisioning di un'app App Engine. Pertanto, la località del bucket Cloud Storage predefinito non determina la località della futura istanza Cloud Firestore predefinita.

• A partire dal 30 ottobre 2024, se è già stato eseguito il provisioning dell'istanza Cloud Firestore predefinita, ma non è stato eseguito il provisioning del bucket Cloud Storage for Firebase predefinito:

  • L'istanza Cloud Firestore predefinita esistente non determina la località del bucket Cloud Storage predefinito futuro (*.firebasestorage.app).

• A partire dal 30 ottobre 2024, se il bucket Cloud Storage predefinito per Firebase è già stato eseguito il provisioning (nello specifico, il bucket *.appspot.com), ma non è stato eseguito il provisioning dell'istanza Cloud Firestore predefinita:

  • Quando è stato eseguito il provisioning del bucket Cloud Storage predefinito (*.appspot.com), è stato eseguito anche il provisioning di un'app App Engine e, di conseguenza, è stata impostata la località della futura istanza Cloud Firestore predefinita. Anche se elimini il bucket *.appspot.com, non puoi eliminare l'app App Engine, quindi le impostazioni di localizzazione della futura istanza Cloud Firestore predefinita sono già impostate.

Se hai utilizzato le funzioni pianificate di 1ª gen., la loro località è impostata su quella delle risorse Google Cloud predefinite. Questo perché Cloud Scheduler e App Engine erano precedentemente associati tra loro. Inoltre, se hai configurato funzioni pianificate di 1ª generazione. prima di eseguire il provisioning di altre risorse che condividevano questa impostazione di localizzazione, hai impostato anche la loro località.

Passaggi successivi

• Per saperne di più sulla creazione di applicazioni che soddisfino i requisiti di latenza, disponibilità e durabilità, consulta Area geografica e regioni.