Introduzione
Le app Earth Engine sono interfacce utente dinamiche e condivisibili per le analisi di Earth Engine. Con le app, gli esperti possono utilizzare semplici elementi dell'interfaccia utente per sfruttare il catalogo dati e la potenza analitica di Earth Engine, sia per gli esperti che per i non esperti.
Le app pubblicate da Earth Engine sono accessibili dall'URL specifico per l'applicazione generato al momento della pubblicazione. Non è necessario un account Earth Engine per visualizzare o interagire con un'app pubblicata. Le app selezionate come in primo piano dal loro creator sono disponibili anche in una galleria di app specifica per l'utente (ad es. USERNAME.users.earthengine.app).
Crea la tua app
Le app Earth Engine possono sfruttare la maggior parte delle stesse funzioni utilizzate nell'editor di codice, con alcune eccezioni. Inoltre, abbiamo progettato l'API di interfaccia utente tenendo conto degli sviluppatori di app. Se non hai mai utilizzato l'API User Interface, consulta la panoramica dell'API UI.
Pubblicazione dell'app
Per pubblicare un'app dall'editor di codice, carica innanzitutto lo script che vuoi trasformare in un'app, quindi apri il riquadro Gestione app, a cui puoi accedere facendo clic sul pulsante App sopra la sezione dello script nell'editor di codice.
Poi fai clic sul pulsante NUOVA APP.
Nella finestra di dialogo, scegli l'accesso in modifica, un nome per l'app, seleziona un progetto Google Cloud e specifica la posizione del codice sorgente dell'app. Limita l'accesso a questa app a un determinato gruppo Google o mantienila accessibile pubblicamente utilizzando le opzioni disponibili nella scheda Limitazione. Per le app accessibili pubblicamente, puoi anche fornire un'immagine di anteprima personalizzata per l'app e una descrizione nella scheda Galleria. Fai clic su "Metti in evidenza questa app nella tua Galleria app" se vuoi
che questa app venga visualizzata nella tua galleria pubblica di app disponibile su
USERNAME.users.earthengine.app
. Se vuoi, puoi includere un logo personalizzato nell'angolo in alto a sinistra dell'app caricando un'immagine a tua scelta dalla scheda Logo.
Gestione delle applicazioni
Per gestire un'app dall'editor di codice, apri il riquadro di gestione delle app facendo clic sul pulsante App sopra la sezione dello script nell'editor di codice. Da qui puoi aggiornare la configurazione dell'app o eliminarla.
Collaborare con altri utenti sulle app di proprietà del progetto
Per impostazione predefinita, le app pubblicate con il tuo nome utente sono modificabili solo da te. La collaborazione su App è possibile con le app di proprietà del progetto. Le app di proprietà del progetto sono app di proprietà e pubblicate in un progetto Cloud. Chiunque disponga del ruolo IAM Editore di app Earth Engine può modificare ed eliminare le app pubblicate nel progetto Cloud. Scopri di più sui ruoli IAM di Earth Engine qui.
Per attivare le app di proprietà del progetto, scegli l'opzione Progetto Cloud nel
passaggio "Scegli l'accesso in modifica" e seleziona il progetto Cloud che vuoi utilizzare, quindi completa
il flusso di pubblicazione dell'app come di consueto. L'app verrà pubblicata nel dominio
PROJECT-ID.projects.earthengine.app
e potrà essere modificata da chiunque disponga del
ruolo IAM Editore di app Earth Engine nel progetto Cloud.
Per visualizzare le app per un progetto cloud, premi il pulsante AGGIUNGI PROGETTO CLOUD e seleziona il progetto cloud.
Per condividere il progetto cloud con altri, premi il pulsante CONDIVIDI PROGETTO. Verrà visualizzata la pagina IAM della console Cloud per il progetto, in cui puoi concedere ai collaboratori il ruolo IAM Editore di app Earth Engine.
Domande frequenti
- Come faccio a rimuovere un'app dalla mia Galleria di app?
- La casella di controllo "Metti in evidenza questa app" nella pagina di configurazione dell'app controlla se un'app viene visualizzata o meno nella pagina App in primo piano. Le app con accesso limitato non possono essere in primo piano.
- Il mio codice Earth Engine è visibile?
- Sì, a chiunque possa accedere all'app. Anche se non è chiaramente visibile quando l'app viene pubblicata, è abbastanza facile per chiunque visualizzare il codice JavaScript dell'app osservando il traffico di rete sul browser web. In Chrome, ad esempio, il codice JavaScript sarà visibile nel riquadro Rete degli Strumenti per sviluppatori.
- Quali sono alcune possibili cause dell'errore "Si è verificato un errore durante il caricamento di alcune parti della mappa" per un'app pubblicata?
- Assicurati che tutti gli asset immagine o tabella utilizzati nella tua app siano condivisi pubblicamente o con l'app. Nella finestra di dialogo di condivisione degli asset, seleziona l'opzione "Chiunque può leggere" o scegli il nome dell'app dall'elenco a discesa. Per le app limitate a un gruppo Google, la condivisione di un asset con quel gruppo Google non lo renderà visibile dall'app. Gli asset devono essere condivisi con l'app o pubblicamente.
- Perché visualizzo la pagina "L'app non è ancora pronta"?
- Dopo aver creato un'app, potrebbe essere necessario del tempo prima che le informazioni vengano propagate nel sistema. In genere, il problema viene risolto entro pochi minuti. Se l'errore persiste, contattaci.
- Perché le geometrie disegnate vengono mostrate nella mia app?
- In questo modo è facile mostrare le geometrie di riferimento nella tua app e puoi creare app in cui gli utenti possono modificarle. Se non vuoi che determinate geometrie vengano visualizzate o modificate, puoi nascondere o bloccare i singoli livelli di geometria per impedire agli utenti di visualizzarli o modificarli prima di pubblicare l'app. Per saperne di più, consulta la documentazione degli strumenti di geometria.
- Che cos'è la quota di app?
- Per impedire che script errati o che richiedono molte risorse influiscano negativamente sulla disponibilità del servizio, Earth Engine ha quote di utilizzo delle app per le query simultanee. Questa quota funziona in modo simile alla quota per utente di Earth Engine, tranne per il fatto che è associata all'app anziché a un utente specifico.
- Ogni app che creo ha una quota propria?
- Sì, a ogni app è associata una quota separata. Per le app precedenti create con una chiave API, la quota è legata al progetto Cloud da cui generi la chiave API di un'app. Se generi più chiavi API dallo stesso progetto Cloud, tutte condivideranno la stessa quota di utilizzo.
- Perché è necessario un account di fatturazione Cloud? Mi verranno addebitate le mie app?
- Utilizziamo la piattaforma Google Cloud per una serie di attività dietro le quinte. La creazione di un'app Earth Engine non comporta costi. Tuttavia, Google Cloud Storage non è senza costi, pertanto se scegli di esportare i risultati delle tue analisi in Google Cloud Storage, potrebbe essere applicata una tariffa.
- Come faccio a comprendere meglio l'utilizzo e la quota delle mie app?
-
Se la quota viene superata, Earth Engine potrebbe restituire errori
HTTP 429: Too Many Requests
. In genere, questi errori vengono gestiti dalla libreria client di Earth Engine, che aggira le richieste con il backoff esponenziale, riprovando la query fino a quando non va a buon fine. La libreria client Earth Engine riproverà la richiesta cinque volte.Se la tua app diventa così popolare che molti utenti ricevono errori di quota superata, gli utenti visualizzeranno un messaggio di avviso ed Earth Engine potrebbe dover limitare (temporaneamente) l'accesso all'app.
Per evitare di ricevere errori 429, ti consigliamo di attivare la memorizzazione nella cache per la tua applicazione, ad esempio memorizzando le statistiche aggregate memorizzabili nella cache come asset tabella Earth Engine, anziché calcolarle dinamicamente.