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 Data Catalog 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 dell'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 interfaccia utente pensando agli 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 prima lo script che vuoi trasformare in un'app, quindi apri il riquadro di gestione delle 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 come editor, un nome per l'app, seleziona un progetto cloud Google e specifica la posizione del codice sorgente dell'app. Limita l'accesso a questa app a un gruppo Google specifico o mantienila accessibile pubblicamente utilizzando le opzioni 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 di app" se vuoi che questa app venga visualizzata nella tua galleria di app pubblica disponibile all'indirizzo 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 Gestione app facendo clic sul pulsante App sopra la sezione degli script nell'editor di codice. Da qui puoi aggiornare la configurazione dell'app o eliminarla.
Collabora con altri utenti alle app di proprietà del progetto
Per impostazione predefinita, le app che pubblichi con il tuo nome utente possono essere modificate solo da te. La collaborazione sulle app è possibile con le app di proprietà del progetto. Le app di proprietà del progetto sono app di proprietà e pubblicate nell'ambito di un progetto Cloud. Chiunque abbia il ruolo IAM Earth Engine Apps Publisher può modificare ed eliminare le app pubblicate nell'ambito del 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 Earth Engine Apps Publisher 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 utenti, premi il pulsante CONDIVIDI PROGETTO. In questo modo, si aprirà la pagina IAM della console Cloud per il progetto, dove potrai concedere ai collaboratori il ruolo IAM Publisher di app Earth Engine.
Domande frequenti
- Come faccio a rimuovere un'app dalla mia galleria di app?
- La casella di controllo "Metti in primo piano 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 mostrate in primo piano.
- Il mio codice Earth Engine è visibile?
- Sì, a chiunque possa accedere all'app. Sebbene non sia chiaramente visibile quando l'app viene pubblicata, è abbastanza facile per qualcuno visualizzare il codice JavaScript dell'app osservando il traffico di rete verso il proprio 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 nell'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à visualizzabile dall'app; gli asset devono essere condivisi con l'app o pubblicamente.
- Perché visualizzo la pagina "L'app non è ancora pronta"?
- Dopo la creazione di un'app, potrebbe essere necessario un po' di tempo prima che le informazioni vengano propagate nel sistema. In genere, il problema si risolve entro pochi minuti. Se l'errore persiste, contattaci per ricevere assistenza.
- Perché le geometrie che ho disegnato vengono visualizzate nella mia app?
- In questo modo è facile mostrare le geometrie di riferimento nella tua app e puoi creare app in cui gli utenti possono modificare le geometrie. Se non vuoi che vengano visualizzate o modificate geometrie particolari, 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 sugli strumenti di geometria.
- Che cos'è la quota dell'app?
- Per evitare che script errati o che richiedono un utilizzo intensivo delle risorse influiscano negativamente sulla disponibilità del servizio, Earth Engine prevede quote di utilizzo delle app per le query simultanee. Questa quota funziona in modo simile alla quota per utente di Earth Engine, con la differenza che è legata all'app, anziché a un utente specifico.
- Ogni app che creo ha una propria quota?
- Sì, a ogni app è associata una quota separata. Per le app meno recenti 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 addebitati costi per le mie app?
- Utilizziamo Google Cloud per una serie di attività dietro le quinte. Non ti verrà addebitato alcun costo per la creazione di un'app Earth Engine. Tuttavia, Google Cloud Storage non è senza costi, quindi se scegli di esportare i risultati delle tue analisi in Google Cloud Storage, potrebbe essere associata 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 esegue il wrapping delle richieste nel backoff esponenziale, riprovando la query fino a quando non viene eseguita correttamente. La libreria client di Earth Engine riproverà a inviare la richiesta cinque volte.Se la tua app diventa così popolare che molti utenti ricevono errori di superamento della quota, 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 archiviando le statistiche aggregate memorizzabili nella cache come asset di tabelle Earth Engine, anziché calcolarle on the fly.