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 (provenienti dall'editor di codice, dalle librerie client, dalle app o dall'API REST) vengono instradate tramite un progetto Cloud, consentendo il controllo degli accessi, la gestione delle risorse e il monitoraggio dell'utilizzo nella console Cloud.
Accedi a Earth Engine
Per utilizzare Earth Engine, devi avere accesso a un progetto cloud che:
- con l'API Earth Engine abilitata,
- è registrato per l'uso commerciale o non commerciale e
- ti (o all'utente) conceda i ruoli e le autorizzazioni corretti.
Crea un progetto
Visita la pagina di registrazione per creare e registrare un nuovo progetto Cloud o per 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 della console Cloud o facendo clic sul seguente pulsante:
Crea un progetto cloudAbilita 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 EngineNella pagina dell'API Earth Engine, assicurati di aver selezionato il tuo progetto e fai clic sul pulsante ABILITA.
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
(Facoltativo) Crea una cartella degli asset
Puoi creare una cartella di asset di Earth Engine associata a un progetto Cloud a cui hai accesso utilizzando il comando earthengine create folder con 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.
Utilizza un progetto esistente
Rivolgiti al 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 nel progetto.
Specifica un progetto
Le sezioni seguenti 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 relativa all'autenticazione e all'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 verrà chiesto di selezionare un progetto tramite cui instradare le richieste. Segui le istruzioni nella finestra di dialogo di pubblicazione.
Strumento a riga di comando
Per associare le chiamate di 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, invia chiamate HTTP autenticate in cui l'autenticazione è gestita da oauth2. In un ambiente locale, puoi utilizzare il comando gcloud. Puoi anche utilizzare un service account 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.
Configura 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.
Service account
I service account hanno automaticamente accesso una volta che il progetto principale è registrato e l'API Earth Engine è abilitata. Devono inoltre disporre delle autorizzazioni corrette all'interno del progetto. È possibile configurare un numero qualsiasi di service account in un progetto per l'utilizzo di Earth Engine. Visita la pagina dei 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, dovrai 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 trasmette 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 tenendo un corso di formazione…
Bene. Se registri un progetto non commerciale, non è richiesta alcuna configurazione della fatturazione. Dopodiché, puoi aggiungere gli studenti al progetto.
Faccio parte di un team operativo/un'organizzazione commerciale…
Bene. Puoi registrare un progetto per uso commerciale e aggiungere i tuoi collaboratori. Presta attenzione anche al limite di postazioni 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 cancellati 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 al progetto (inclusi, ad esempio, gli asset archiviati nella directory principale del progetto, le app EE a livello di progetto, i dati di Monitoring e così via). Questo processo potrebbe essere reversibile per un massimo di 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 di Earth Engine.
Per l'eliminazione programmatica di un asset 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 per la sicurezza dell'editor di codice impedisce il funzionamento di questa chiamata in quell'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-assetScript dell'editor di codice
Per eliminare gli script dell'editor di codice di Earth Engine:
Editor di codice
Dalla scheda "Script" nell'editor di codice, seleziona uno script o un repository ed eliminalo. Una volta contrassegnato come eliminato, un repository diventa non recuperabile entro 30 giorni.
Utilizzo di Git
Gli utenti esperti possono utilizzare Git per gestire i propri script. Visita la pagina 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.
Riferimenti "Ottieni link"
Utilizza la pagina Gestisci link per visualizzare ed eliminare i link "Genera link" dall'editor di codice. Per accedere a questa pagina, vai all'opzione "Gestisci link" nel menu a discesa accanto al pulsante "Genera link".
Configura l'accesso non commerciale
Per configurare l'accesso non commerciale (non a 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 non a pagamento 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 il tuo progetto viene considerato 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 Cloud. Ti consigliamo di completare la procedura di verifica il prima possibile. Se non intervieni prima del 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 verificati nuovamente per l'accesso su base periodica.
Configura l'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.
Termina l'accesso commerciale
Se sei un cliente diretto di Earth Engine e vuoi interrompere l'utilizzo di Earth Engine in un contesto a pagamento, devi apportare diverse modifiche per interrompere l'addebito:
Interrompi gli addebiti per l'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 nell'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_IDSe scegli il piano "Limitato", il tuo account di fatturazione non incorrerà in ulteriori costi di abbonamento alla piattaforma Earth Engine dopo il ciclo di fatturazione corrente.
Interrompi gli addebiti per il computing
- Per evitare nuovi addebiti relativi al calcolo (tempo EECU), disattiva l'API Earth Engine nei tuoi progetti Cloud. Tieni presente che questa operazione non interrompe le richieste in corso né elimina gli oggetti archiviati, pertanto potresti comunque incorrere in addebiti di Earth Engine anche con l'API disabilitata.
- Per informazioni sulla disabilitazione delle API, consulta la guida della console API.
Interrompi i costi di archiviazione
- Gli asset Earth Engine archiviati continuano a generare costi anche se l'API è disabilitata. L'eliminazione degli asset evita l'addebito di ulteriori tariffe per lo spazio di archiviazione di EE.