Informazioni sulle località dei prodotti e delle risorse nel progetto

Prodotti o risorse che richiedono un'impostazione della posizione

Diversi prodotti o risorse richiedono un'impostazione della posizione.

Product Località predefinita Ulteriori informazioni
Firebase AI Logic
  • Per Gemini Developer API: non è possibile selezionare una località; sempre globale.
  • Per Vertex AI Gemini API: se la località non è impostata, la regione predefinita è us-central1.
Questa località è il punto di accesso al modello.
Google Analytics Nessuna posizione predefinita.
Devi impostare questa posizione.
Questa località è la Analytics località di generazione dei report2, che rappresenta il paese o la regione della tua organizzazione. La tua Analytics località di generazione dei report, a sua volta, imposta la valuta per i report sulle entrate.
Firebase App Hosting Nessuna posizione predefinita.
Devi impostare questa posizione per ogni backend.
Questa posizione è quella in cui il deployment di App Hosting crea ciascuna delle tue risorse di backend.
Ogni backend può trovarsi in una posizione diversa.
Firebase Data Connect Nessuna posizione predefinita.
Devi impostare la posizione per ogni istanza.
Ogni istanza può trovarsi in una posizione diversa.
Cloud Firestore 1 Nessuna posizione predefinita.
Devi impostare la posizione per ogni istanza.
Ogni istanza può trovarsi in una posizione diversa.
Firebase Realtime Database Nessuna posizione predefinita.
Devi impostare la posizione per ogni istanza.
Ogni istanza può trovarsi in una posizione diversa.
Cloud Storage for Firebase 1 Nessuna posizione predefinita.
Devi impostare la posizione per ogni bucket.
Ogni bucket può trovarsi in una posizione diversa.
Cloud Functions for Firebase 1 Se la località non è impostata, la regione predefinita è us-central1. Ogni funzione può trovarsi in una posizione diversa.

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

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

Impostare una posizione per un prodotto o le relative risorse

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

Product Quando e come impostare la posizione Località disponibili
Firebase AI Logic
  • Per Gemini Developer API: non è possibile selezionare una località; sempre globale.
  • Per Vertex AI Gemini API: quando inizializzi il servizio di backend Vertex AI nel tuo codebase, puoi specificare facoltativamente una posizione per 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à di generazione dei report di Analytics. Devi selezionare un paese o una regione che rappresenti la sede 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 posizione dei report di Analytics. Vai alle impostazioni di Google Analytics, quindi al riquadro Report.

Consulta l'elenco nel riquadro Impostazioni Google Analytics > Report.
Firebase App Hosting Quando crei un backend App Hosting, ti viene chiesto di selezionare una posizione. Puoi utilizzare la console Firebase, l'API REST o la CLI Firebase per creare un backend. App Hosting località
Firebase Data Connect Quando esegui il provisioning di un'istanza del servizio Data Connect, imposti le relative posizioni. Hai anche impostato la posizione dell'istanza Google Cloud SQL associata.
Puoi utilizzare la console Firebase o la CLI Firebase per eseguire il provisioning di un'istanza.
Data Connect e posizioni delle istanze Cloud SQL
Cloud Firestore 1 Quando esegui il provisioning di un'istanza di database Cloud Firestore, ne imposti la posizione. Puoi utilizzare la console Firebase, l'API REST, la CLI Firebase o Terraform per eseguire il provisioning di un'istanza. Cloud Firestore località
Firebase Realtime Database Quando esegui il provisioning dell'istanza Realtime Database, ne imposti la posizione.
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 1 Quando esegui il provisioning del bucket Cloud Storage, ne imposti la posizione.
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 facoltativamente la regione.

Se non specifichi una località, la regione predefinita è us-central1.

Cloud Functions for Firebase località

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

Visualizzare le impostazioni di localizzazione

Product Dove visualizzare l'impostazione della posizione
Firebase AI Logic
  • Per Gemini Developer API: non è possibile selezionare una località; sempre globale.
  • Per Vertex AI Gemini API: nel tuo codebase, cerca l'inizializzazione del servizio di backend Vertex AI. 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 per aprire il tuo account Google Analytics e poi vai al pannello Amministratore per trovare le informazioni 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 posizioni.
  • Per visualizzare la posizione 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 di database e delle relative posizioni.
Cloud Firestore Nella console Firebase, vai alla scheda Cloud Firestore Dati per visualizzare l'elenco delle istanze di database e delle relative posizioni.
Firebase Realtime Database Nella console Firebase, vai alla scheda Realtime Database Dati per visualizzare l'elenco delle istanze di database e delle relative posizioni.
Cloud Storage for Firebase Nella console Firebase, vai alla scheda Cloud Storage File per visualizzare l'elenco dei bucket e delle relative posizioni.
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 dalla località dovute a "località per le risorse Google Cloud predefinite"

La "località per le risorse Google Cloud predefinite" è l'impostazione di località per qualsiasi risorsa del progetto associata a Google App Engine, tra cui le seguenti:

  • 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 prima generazione

Questa "posizione per le risorse Google Cloud predefinite" è un'impostazione immutabile. Inoltre, quando imposti la posizione per una delle risorse associate, imposti indirettamente la posizione 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 giorno 30 ottobre 2024, tutti i bucket Cloud Storage predefiniti per Firebase di cui è stato eseguito il provisioning di recente hanno il formato del nome *.firebasestorage.app e non sono associati a App Engine.

Ecco i dettagli di ciò che è cambiato nelle possibili dipendenze dalla posizione:

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

    • Il provisioning dell'istanza Cloud Firestore predefinita imposta la posizione per qualsiasi app App Engine futura 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 posizione del bucket Cloud Storage predefinito non determina la posizione dell'istanza Cloud Firestore predefinita futura.

  • A partire dal 30 ottobre 2024, se l'istanza Cloud Firestore predefinita è già stata sottoposta a provisioning, ma il Cloud Storage predefinito per il bucket Firebase non è stato sottoposto a provisioning:

    • L'istanza Cloud Firestore predefinita esistente non determina la posizione del futuro bucket Cloud Storage predefinito (*.firebasestorage.app).
  • A partire dal 30 ottobre 2024, se il Cloud Storage predefinito per il bucket Firebase è già stato provisionato (in particolare, il bucket *.appspot.com), ma l'istanza Cloud Firestore predefinita non è stata provisionata:

    • Quando è stato eseguito il provisioning del bucket Cloud Storage predefinito (*.appspot.com), è stato eseguito il provisioning anche di un'app App Engine e quindi la posizione 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 posizione dell'istanza Cloud Firestore predefinita futura è già impostata.

Se hai utilizzato le funzioni pianificate di prima generazione, la loro posizione è impostata sulla posizione delle risorse Google Cloud predefinite. Questo perché Cloud Scheduler e App Engine avevano precedentemente un'associazione tra loro. Inoltre, se hai configurato le funzioni programmate di 1ª gen. prima di eseguire il provisioning di altre risorse che condividevano questa impostazione della posizione, devi impostare anche la loro posizione.

Passaggi successivi

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