Accesso a Earth Engine

Earth Engine viene eseguito su Google Cloud e richiede progetti Cloud per l'accesso e la gestione delle API. Tutte le chiamate di Earth Engine (dal Code Editor, dalle librerie client, dalle app o dall'API REST) vengono indirizzate tramite un progetto Cloud, consentendo il controllo dell'accesso, la gestione delle risorse e il monitoraggio dell'utilizzo nella console Cloud.

Ottenere l'accesso a Earth Engine

Per utilizzare Earth Engine, devi avere accesso a un progetto Cloud che:

Crea un progetto

Visita la pagina di registrazione per creare e registrare un nuovo progetto Cloud o registrare un progetto esistente. Dopo la registrazione, l'accesso a Earth Engine viene attivato immediatamente.

I progetti creati durante la procedura di registrazione possono essere gestiti nella console Google Cloud. Puoi attivare o disattivare l'API Earth Engine dalla pagina dell'API Earth Engine nella console Cloud.

Passaggi manuali (automatizzati dalla pagina di registrazione)

Creazione di un progetto cloud

Se non l'hai ancora fatto, crea un progetto Google Cloud. Puoi farlo dalla pagina dei progetti di Cloud Console o facendo clic sul pulsante seguente:

Crea un progetto cloud

Abilita l'API Earth Engine

Per abilitare l'API Earth Engine per il tuo progetto, fai clic sul seguente pulsante per andare alla pagina dell'API Earth Engine:

Abilita l'API Earth Engine

Nella pagina dell'API Earth Engine, assicurati di aver selezionato il tuo progetto e fai clic sul pulsante ATTIVA.

Registra il progetto per uso commerciale o non commerciale

Modifica il seguente URL per il tuo progetto, visita la pagina e completa il flusso di registrazione. 

https://code.earthengine.google.com/register?project=my-project

Creare una cartella degli asset (facoltativo)

Puoi creare una cartella di asset Earth Engine associata a un progetto Cloud a cui hai accesso utilizzando il comando earthengine create folder utilizzando un percorso come descritto qui. Ad esempio: 

earthengine create folder projects/my-project/assets/

Puoi anche creare una cartella di asset per un progetto nell'editor di codice aggiungendo il progetto nel riquadro Asset.

Non è necessario creare questa cartella, a meno che tu non preveda di archiviare asset nel progetto.

Utilizzare un progetto esistente

Contatta il personale IT della tua organizzazione per informazioni sui progetti cloud esistenti configurati per Earth Engine. Assicurati che all'Account Google che utilizzerai per accedere ai servizi Earth Engine siano concessi i ruoli e le autorizzazioni corretti per il progetto.

Specificare un progetto

Le seguenti sezioni descrivono come specificare un progetto per le varie interfacce dei servizi di Earth Engine.

Librerie client (Python, JavaScript)

La funzione ee.Initialize() viene utilizzata per specificare un progetto per le richieste di Earth Engine provenienti dalle librerie client Python e JavaScript. Esistono diversi modi per configurare la specifica del progetto. Per ulteriori dettagli, consulta la pagina Autenticazione e inizializzazione.

Editor di codice

Fai clic sull'icona del profilo nell'angolo in alto a destra dell'editor di codice e seleziona "Cambia progetto Cloud" dal menu. Scegli un progetto dalla finestra di dialogo di selezione.

App Earth Engine

Quando pubblichi un'app Earth Engine, ti viene chiesto di selezionare un progetto attraverso cui instradare le richieste. Segui le istruzioni nella finestra di dialogo di pubblicazione.

Strumento a riga di comando

Per associare le chiamate Earth Engine dallo strumento a riga di comando a un progetto Cloud, utilizza il parametro --project nella chiamata a earthengine o utilizza set_project per impostare un progetto predefinito.

API REST

Per associare le chiamate all'API REST a un progetto Cloud, emetti chiamate HTTP autenticate in cui l'autenticazione viene gestita da oauth2. In un ambiente locale, puoi utilizzare il comando gcloud. Puoi anche utilizzare un account di servizio associato a un progetto Cloud. Consulta la guida rapida all'API REST per un esempio di utilizzo di google.oath.service_account.Credentials.from_service_account_file() per l'autenticazione con un service account.

Configurare l'accesso al progetto

Le sezioni seguenti descrivono come configurare i progetti abilitati per Earth Engine per l'utilizzo da parte di altre persone e service account.

Account di servizio

Gli account di servizio hanno automaticamente accesso una volta registrato il progetto padre e abilitata l'API Earth Engine. Inoltre, devono disporre delle autorizzazioni corrette all'interno del progetto. Qualsiasi numero di service account in un progetto può essere configurato per utilizzare Earth Engine. Visita la pagina Service account per scoprire di più sull'utilizzo dei service account con Earth Engine.

Account Google

I progetti cloud utilizzano Cloud IAM per gestire ruoli e autorizzazioni. Affinché altre persone possano accedere a Earth Engine tramite il tuo progetto, devi utilizzare la console Cloud per concedere loro i ruoli e le autorizzazioni corretti.

ID client OAuth 2.0

Potresti dover creare un ID client OAuth 2.0 da un progetto, ad esempio per creare un'app che trasmetta le credenziali utente a Earth Engine. Puoi gestire le credenziali per il tuo progetto Cloud andando al menu della console Cloud () e selezionando API e servizi > Credenziali. (Scegli il progetto se richiesto).

Per creare un nuovo ID client per il progetto, fai clic su + CREA CREDENZIALI > ID client OAuth > Applicazione web.

Nella configurazione dell'applicazione web:

  • Specifica le origini JavaScript autorizzate, ad esempio:
http://localhost:8080
https://foo-ee-project.appspot.com
  • Specifica gli URI di reindirizzamento autorizzati, ad esempio:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

Scopri di più sull'autenticazione degli utenti con OAuth.

Scenari comuni

Sto insegnando un corso didattico…

Bene. Se registri un progetto non commerciale, non è richiesta alcuna configurazione di fatturazione. Dopodiché, potrai aggiungere i tuoi studenti al progetto.

Faccio parte di un team operativo/organizzazione commerciale…

Bene. Puoi registrare un progetto per uso commerciale e aggiungervi i tuoi collaboratori. Presta attenzione anche al limite di posti nell'abbonamento a Earth Engine che selezioni.

Eliminazione dei dati di Earth Engine

Eliminazione a livello di account

L'eliminazione a livello di account rimuoverà tutti i dati di Earth Engine dal tuo account.

Se il tuo account fa parte di un'organizzazione Google Workspace, l'amministratore controlla i dati dell'account. Quando un amministratore elimina un Account Google, tutti i dati di Earth Engine associati vengono eliminati entro circa 30 giorni.

Il team di Earth Engine non può recuperare i dati una volta eliminati.

Progetti Cloud

Quando un progetto Cloud viene eliminato, viene attivata l'eliminazione dei dati di Earth Engine associati a quel progetto (inclusi, ad esempio, tutti gli asset archiviati nella radice del progetto, tutte le app EE a livello di progetto, i dati di Monitoring e così via). Questa procedura potrebbe essere reversibile fino a 30 giorni, ma non è mai possibile recuperare i dati dopo 30 giorni.

Asset

Il metodo più semplice per eliminare gli asset è utilizzare la scheda "Asset" nell'editor di codice per visualizzare ed eliminare manualmente gli asset Earth Engine.

Per l'eliminazione programmatica di una risorsa con ID projects/{project-id}/assets/{asset-id} (ad es. projects/my-project/assets/my-asset):

Client Python

ee.data.deleteAsset('projects/my-project/assets/my-asset')

Client JavaScript

Tieni presente che la sandbox di sicurezza dell'editor di codice impedisce il funzionamento di questa chiamata in questo ambiente.

ee.data.deleteAsset('projects/my-project/assets/my-asset')

Strumento a riga di comando

Utilizza il comando rm:

earthengine rm projects/my-project/assets/my-asset

Script dell'editor di codice

Per eliminare gli script dell'editor di codice di Earth Engine:

Editor di codice

Nella scheda "Script" dell'editor di codice, seleziona uno script o un repository ed eliminalo. Una volta contrassegnato come eliminato, un repository diventa irrecuperabile entro 30 giorni.

Utilizzo di Git

Gli utenti esperti possono utilizzare Git per gestire i propri script. Consulta https://earthengine.googlesource.com/ per visualizzare l'elenco dei repository che puoi visualizzare.

App Earth Engine

Per eliminare le tue app Earth Engine, utilizza il pulsante "App" nell'editor di codice per gestire le tue app.

Utilizza la pagina Gestisci link per visualizzare ed eliminare i link "Ottieni link" dall'editor di codice. Puoi trovare questa pagina selezionando l'opzione "Gestisci link" nel menu a discesa accanto al pulsante "Ottieni link".

Configurazione dell'accesso non commerciale

Per configurare l'accesso non commerciale (senza pagamento) a Earth Engine per il tuo progetto, devi compilare il questionario di registrazione nella console Cloud per confermare l'idoneità del progetto.

Verifica

Poiché Earth Engine concede l'accesso senza costi a una grande quantità di risorse di calcolo, Google richiede la verifica di ogni progetto registrato per l'accesso non commerciale. La procedura di verifica viene eseguita nell'ambito della registrazione. Se completi il questionario di verifica e viene stabilito che il tuo progetto è commerciale, non potrai utilizzare Earth Engine senza pagare.

A partire dal 26 settembre 2025, tutti i progetti non commerciali devono aver compilato il questionario nella console Google Cloud. Ti consigliamo di completare la procedura di verifica il prima possibile. Se non intervieni entro il 26 settembre 2025, l'accesso del tuo progetto a Earth Engine verrà sospeso fino al completamento della procedura di verifica.

Nuova verifica

Tutti i progetti con accesso non commerciale dovranno essere riverificati periodicamente per l'accesso.

Configurazione dell'accesso commerciale

Per configurare l'accesso commerciale (a pagamento) a Earth Engine per il tuo progetto, devi configurare il progetto utilizzando la pagina di registrazione e scegliere un piano nell'account di fatturazione.

Interruzione dell'accesso commerciale

Se sei un cliente diretto di Earth Engine e vuoi interrompere l'utilizzo di Earth Engine in un contesto a pagamento, sono necessarie diverse modifiche per interrompere l'addebito:

  • Interrompere gli addebiti dell'abbonamento

    • Per terminare l'abbonamento a Earth Engine sul tuo account di fatturazione, devi utilizzare la pagina "Gestisci piani" (accessibile dal menu a discesa delle impostazioni utente in alto a destra dell'editor di codice quando utilizzi un progetto Cloud registrato collegato a quell'account di fatturazione).

    • Puoi anche accedere direttamente alla pagina "Gestisci piani" per un account di fatturazione:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID

    • Se scegli il piano "Limitato", il tuo account di fatturazione non dovrà più sostenere ulteriori costi di abbonamento alla piattaforma Earth Engine dopo il ciclo di fatturazione corrente.

  • Interrompere gli addebiti per il calcolo

    • Per evitare nuovi addebiti relativi al calcolo (tempo EECU), disattiva l'API Earth Engine nei tuoi progetti Cloud. Tieni presente che questa operazione non termina le richieste in corso né elimina gli oggetti archiviati, pertanto potresti comunque incorrere in addebiti di Earth Engine anche con l'API disattivata.
    • Per informazioni sulla disattivazione delle API, consulta la Guida della console API.

  • Interrompere i costi di archiviazione

    • Gli asset Earth Engine archiviati continuano a generare costi anche se l'API è disattivata. L'eliminazione degli asset impedisce di incorrere in ulteriori tariffe di archiviazione di EE.