Use o Gerenciador de recursos ou a interface de linha de comando (CLI) para fazer upload de imagens ou outros conjuntos de dados rasterizados georreferenciados no formato GeoTIFF ou TFRecord. Consulte Como importar dados vetoriais para saber como importar vetores usando o Editor de código.
Fazendo upload de recursos de imagem
GeoTIFF
No Editor de Código, é possível fazer upload de arquivos de imagem GeoTIFF de até 10 GB para sua pasta de usuário do Earth Engine. Para arquivos maiores, use a opção de upload por linha de comando.
Para fazer upload de um GeoTIFF usando o editor de código,
selecione a guia "Recursos" no canto superior esquerdo,
clique no botão 
e selecione Upload de
imagem. O Earth Engine apresenta uma caixa de diálogo de upload semelhante à
Figura 1. Clique no botão SELECIONAR e navegue até um GeoTIFF no seu sistema de arquivos
local.
Dê à imagem um ID de recurso apropriado (que ainda não exista) na sua
pasta de usuário. Se você quiser fazer upload da imagem em uma pasta ou coleção atual,
adicione o código do recurso da pasta ou da coleção como prefixo ao código do recurso, por exemplo,
projects/myproject/folder-or-collection-id/new-asset.
Clique em FAZER UPLOAD para iniciar o processo.
Depois de iniciar o upload, uma tarefa "Ingestão de recursos" vai aparecer na guia "Tarefas"
no lado direito do editor de código. Passar o cursor sobre a tarefa no gerenciador de tarefas mostra um
? que pode ser usado para verificar o status do upload. Para cancelar um upload,
clique no ícone giratório 
ao lado da
tarefa. Depois que a ingestão for concluída, o recurso vai aparecer na sua pasta de usuário com
um ícone .
Compactação GeoTIFF
Os arquivos GeoTIFF podem ser compactados com DEFLATE, JPEG, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP ou ZSTD. Os GeoTIFFs otimizados para nuvem (COGs, na sigla em inglês) que o Earth Engine lê no local em vez de ingerir aceitam um conjunto mais restrito. Consulte Compactação de COG.
Recomendações para a melhor experiência de upload de arquivos grandes:
- Melhor opção: o ZSTD oferece um bom equilíbrio entre velocidade e compactação.
- Evite: o LZMA pode ser muito lento, apesar da boa compactação.
- Arquivos descompactados: resultam em arquivos maiores e tempos de upload mais longos.
- Compactação com perdas (por exemplo, JPEG): pode alterar os valores de pixel. Use compactação sem perdas (por exemplo, DEFLATE, LZMA, LZW, ZSTD) em vez de compactação com perdas, a menos que você entenda o impacto potencial nos seus dados.
TF_RECORD
Para fazer upload de uma imagem de um arquivo TFRecord, é preciso ter o arquivo de mixer associado que foi gerado quando você exportou as imagens em que realizou a inferência. Consulte a página de exportação para mais detalhes sobre o arquivo do mixer. Mais especificamente, para importar previsões (como uma imagem) feitas em imagens exportadas,
- Exportar imagens para um ou mais arquivos TFRecord.
- Realizar inferência nas imagens (ou seja,
model.predict()). - Grava a saída de
model.predict()em um arquivo TFRecord. As previsões precisam estar na mesma ordem das exportações de imagens em que você realizou a inferência. A ordem pode ser aplicada por uma classificação dos nomes de arquivos produzidos pela exportação. Consulte a seção de exportações de arquivos grandes para mais detalhes. - Faça upload dos arquivos TFRecord e do mixer associado para o Earth Engine.
Edição de propriedades
Edite os metadados do recurso especificando uma ou mais propriedades de metadados. No menu
Properties, clique em Add property para
definir um nome e um valor de propriedade (Figura 2). O valor pode ser uma string ou um número.
Insira strings sem aspas. Para formatar um número como uma string, insira aspas simples
(') antes do número.
Por padrão, uma propriedade system:time_start
é adicionada sem valor. Essa propriedade é usada pelo Earth Engine ao aplicar
filtros de data ImageCollection. Insira uma data no formato mostrado
na Figura 2 ou um número que represente milissegundos desde 1º de janeiro de 1970. Consulte
o glossário para mais informações sobre carimbos de data/hora no Earth Engine.
O Gerenciador de recursos interpreta um número inserido como o valor de uma propriedade chamada
system:time_start ou system:time_end como milissegundos e
o formata como uma data.
Clique no ícone para remover uma propriedade.
Opções avançadas
No menu Avançado, escolha a política de pirâmide e o modo de mascaramento para seus dados.
A política de pirâmide especifica como o Earth Engine gera versões de menor resolução da imagem. Saiba mais sobre como o Earth Engine lida com várias resoluções no documento de escala. Escolha uma política de pirâmide "Média", "Mínimo" ou "Máximo" para calcular níveis de resolução mais baixos da pirâmide de imagens como a média, o mínimo ou o máximo de cada grupo 2x2 de pixels de resolução mais alta. Essa é uma opção adequada para imagens de valor contínuo. Para dados categóricos (por exemplo, cobertura do solo) ou de controle de qualidade, escolha uma política de pirâmide "Amostra" (o pixel superior esquerdo) ou "Modo" (valor que ocorre com mais frequência ou amostra se não houver modo).
O modo de máscara indica como a imagem enviada é mascarada (se for o caso). Para especificar um valor sem dados, selecione "Valor sem dados" e insira o valor. Os pixels com esse valor serão mascarados na imagem enviada. Esse valor é aplicado a cada banda da imagem de forma independente. Para usar a última banda da imagem como máscara para as outras bandas, selecione "Usar última banda como banda alfa". A banda alfa precisa ser uma banda de 8 bits sem sinal, em que 0 são dados mascarados (completamente transparentes) e 255 é completamente opaco.
Uploads em blocos
Para fazer upload de uma única imagem como vários blocos, em que cada bloco é armazenado em um arquivo de origem diferente, clique em Adicionar outro arquivo para adicionar mais arquivos ao upload. O Earth Engine vai combinar os blocos para criar uma única imagem na sua pasta de usuário.
Há algumas restrições quanto aos tipos de arquivos que podem ser enviados para um recurso de imagem. Especificamente:
- As imagens precisam ter o mesmo número de bandas, profundidade de bits, projeção, resolução e valores de preenchimento.
- O deslocamento de um arquivo para o outro precisa ser um múltiplo inteiro do tamanho do pixel.
- As lacunas entre os blocos serão preenchidas com pixels mascarados na imagem final. Portanto, o ideal é que os blocos sejam adjacentes e não estejam espalhados. Imagens com lacunas que ocupam mais de 99% da área da imagem não serão ingeridas.