Introdução
Os apps do Earth Engine são interfaces de usuário dinâmicas e compartilháveis para análises do Earth Engine. Com os apps, os especialistas podem usar elementos simples da interface para aproveitar o catálogo de dados e o poder analítico do Earth Engine, que podem ser usados por especialistas e não especialistas.
Os apps publicados no Earth Engine podem ser acessados pelo URL específico do aplicativo gerado no momento da publicação. Não é necessário ter uma conta do Earth Engine para visualizar ou interagir com um app publicado. Os apps selecionados como destaque pelo criador também estão disponíveis na Galeria de apps específica do usuário (por exemplo, USERNAME.users.earthengine.app).
Criar seu app
Os apps do Earth Engine podem aproveitar a maioria das mesmas funções usadas no Editor de código, com algumas exceções. Além disso, projetamos a API de interface do usuário pensando nos desenvolvedores de apps. Se você não conhece a API User Interface, consulte a visão geral da API User Interface.
Publicação do app
Para publicar um app no editor de código, primeiro carregue o script que você quer transformar em um app e abra o painel "Gerenciamento de apps". Para acessar esse painel, clique no botão Apps acima da seção de script no editor de código.
Em seguida, clique no botão NEW APP.
Na caixa de diálogo, escolha o acesso de editor, um nome do app, selecione um projeto do Google Cloud e especifique o local do código-fonte do app. Restrinja o acesso a este app a um determinado Grupo do
Google ou mantenha-o acessível publicamente usando as opções na guia "Restrição". Para apps
acessíveis publicamente, você também pode fornecer uma imagem de visualização personalizada para o app, além de uma
descrição na guia "Galeria". Clique em "Mostrar este app na Galeria de apps" se quiser que ele apareça na sua galeria pública de apps disponível em
USERNAME.users.earthengine.app
. Se quiser, inclua um logotipo personalizado no
canto superior esquerdo do app fazendo upload de uma imagem na guia "Logotipo".
Como gerenciar seus aplicativos
Para gerenciar um app no editor de código, abra o painel "Gerenciamento de apps" clicando no botão Apps acima da seção de script no editor de código. Aqui, você pode atualizar a configuração ou excluir o app.
Colaborar com outras pessoas em apps de propriedade do projeto
Por padrão, os apps publicados com seu nome de usuário só podem ser editados por você. A colaboração em apps é possível com os Apps de propriedade do projeto. Os apps de propriedade do projeto são aqueles que são de propriedade e publicados em um projeto do Cloud. Qualquer pessoa com a função de IAM Publicador de apps do Earth Engine pode editar e excluir apps publicados no projeto do Cloud. Saiba mais sobre os papéis do IAM do Earth Engine.
Para ativar os apps de propriedade do projeto, escolha a opção Projeto do Cloud na etapa "Escolher o acesso de edição", selecione o projeto do Cloud que você quer usar e termine o fluxo de publicação do app normalmente. O app será publicado no domínio PROJECT-ID.projects.earthengine.app
e poderá ser editado por qualquer pessoa que tenha o papel de editor de IAM do Earth Engine Apps no projeto do Cloud.
Para conferir os apps de um projeto do Cloud, pressione o botão ADD CLOUD PROJECT e selecione o projeto do Cloud.
Para compartilhar o projeto do Cloud com outras pessoas, pressione o botão SHARE PROJECT. Você será direcionado à página do IAM do Console do Cloud para o projeto, onde poderá conceder aos colaboradores o papel de IAM de editor de apps do Earth Engine.
Perguntas frequentes
- Como faço para remover um app da Galeria de apps?
- A caixa de seleção "Feature this App" na página de configuração do app controla se um app aparece ou não na página "Apps em destaque". Os apps com acesso restrito não podem ser destaque.
- Meu código do Earth Engine está visível?
- Sim, para qualquer pessoa que possa acessar o app. Embora não seja claramente visível quando o app é publicado, é bastante fácil para alguém conferir o JavaScript do app observando o tráfego de rede no navegador da Web. No Chrome, por exemplo, o JavaScript vai aparecer no painel de rede das Ferramentas para desenvolvedores.
- Quais são as possíveis causas do erro "Ocorreu um erro ao carregar algumas partes do mapa" em um app publicado?
- Verifique se todos os recursos de imagem ou tabela usados no app são compartilhados publicamente ou com o app. Na caixa de diálogo de compartilhamento de recursos, selecione a opção "Qualquer pessoa pode ler" ou escolha o nome do app na lista suspensa. Para apps restritos a um Grupo do Google, o compartilhamento de um recurso com esse grupo não vai torná-lo visível para o app. Em vez disso, os recursos precisam ser compartilhados com o app ou publicamente.
- Por que a página "O app ainda não está pronto" aparece?
- Depois que um app é criado, pode levar algum tempo para que as informações sejam propagadas pelo sistema. Isso geralmente é resolvido em poucos minutos. Se o erro persistir, entre em contato para receber ajuda.
- Por que minhas geometrias desenhadas aparecem no meu app?
- Isso facilita a exibição de geometrias de referência no seu app e permite que você crie apps em que os usuários possam editar as geometrias. Se você não quiser que geometrias específicas sejam mostradas ou editadas, é possível ocultar ou bloquear camadas de geometria individuais para impedir que os usuários as vejam ou editem antes de publicar o app. Consulte a documentação das ferramentas de geometria para saber mais.
- O que é a cota do app?
- Para evitar que scripts incorretos ou que consomem muitos recursos afetem negativamente a disponibilidade do serviço, o Earth Engine tem cotas de uso de apps em consultas simultâneas. Essa cota funciona de maneira semelhante à cota por usuário do Earth Engine, exceto pelo fato de que ela está vinculada ao app, e não a um usuário específico.
- Cada app que eu criar terá uma cota própria?
- Sim, uma cota separada é associada a cada app. Para apps mais antigos criados com uma chave de API, a cota está vinculada ao projeto do Cloud em que você gera uma chave de API do app. Se você gerar várias chaves de API no mesmo projeto do Cloud, elas vão compartilhar a mesma cota de uso.
- Por que é preciso ter uma conta do Cloud Billing? Vou receber cobranças pelos meus apps?
- Usamos o Google Cloud Platform para várias tarefas nos bastidores. Não haverá cobrança pela criação de um app do Earth Engine. No entanto, o Google Cloud Storage não é sem custo financeiro. Portanto, se você exportar os resultados das suas análises para o Google Cloud Storage, poderá haver uma taxa associada.
- Como posso entender melhor o uso e a cota dos meus apps?
-
Se a cota for excedida, o Earth Engine poderá retornar erros
HTTP 429: Too Many Requests
. Geralmente, esses erros são tratados pela biblioteca de cliente do Earth Engine, que agrupa solicitações em espera exponencial, tentando a consulta até que ela seja bem-sucedida. A biblioteca de cliente do Earth Engine vai tentar a solicitação cinco vezes.Se o app se tornar tão popular que muitos usuários receberem erros de cota excedida, eles vão receber uma mensagem de aviso, e o Earth Engine talvez precise restringir (temporariamente) o acesso ao app.
Para evitar erros 429, ative o armazenamento em cache do seu aplicativo, por exemplo, armazenando estatísticas agregadas em cache como recursos de tabela do Earth Engine, em vez de calculá-las em tempo real.