Como importar dados de tabelas

Como fazer upload de recursos de tabela

Use o Asset Manager ou a interface de linha de comando (CLI) para fazer upload de conjuntos de dados no formato Shapefile ou CSV. Consulte Como importar dados raster para saber mais sobre como importar rasters usando o editor de código ou a CLI. Os recursos enviados são inicialmente privados, mas podem ser compartilhados conforme descrito na seção Compartilhamento de recursos.

Fazer upload de um shapefile

Para fazer upload de um Shapefile no editor de código, clique no botão e selecione Shape files na seção Upload de tabelas. Uma caixa de diálogo de upload semelhante à Figura 1 será apresentada. Clique no botão SELECT e navegue até um arquivo Shapefile ou ZIP que contenha um Shapefile no seu sistema de arquivos local. Ao selecionar um arquivo .shp, selecione os arquivos .dbf, .shx e .prj relacionados. O Engine vai usar as coordenadas WGS84 (longitude, latitude) por padrão se um arquivo .prj não for fornecido. Se você estiver fazendo upload de um arquivo ZIP, verifique se ele contém apenas um arquivo de forma (conjunto de .shp, .dbf, .shx, .prj etc.) e nenhum nome de arquivo duplicado. Verifique se os nomes de arquivo não incluem pontos ou pontos finais adicionais. Os nomes de arquivo vão incluir um único ponto antes da extensão.

Dê à tabela um ID de recurso adequado (que ainda não exista) na pasta do usuário. Clique em UPLOAD para iniciar o upload.

recursos
Figura 1. Caixa de diálogo de upload do Shapefile do Gerenciador de recursos. Os arquivos .shp, .dbf e .shx são obrigatórios. Os outros arquivos sidecar são opcionais. Se o arquivo .prj não for fornecido, o WGS84 será assumido.

Fazer o upload de um arquivo CSV

Para fazer upload de um CSV no editor de código, ative a guia Recursos, clique no botão e selecione Arquivo CSV na seção Upload de tabela. Uma caixa de diálogo de upload semelhante à Figura 2 será apresentada. Clique no botão SELECT e navegue até um arquivo .csv no sistema de arquivos local. Dê um nome exclusivo e relevante para a tabela. Clique em "OK" para iniciar o upload.

recursos
Figura 2. A caixa de diálogo de upload de arquivos CSV do Asset Manager.

O arquivo CSV precisa conter uma linha para cada elemento e tantas colunas quanto houver propriedades ou variáveis para o conjunto de elementos. Se os elementos forem geoespaciais, eles precisarão ter uma geolocalização definida por uma string de geometria (GeoJSON, WKT) ou pelas propriedades de posição x e y. Se o arquivo CSV for uma exportação de uma ferramenta de dados geoespaciais ou SIG, como GDAL/OGR, uma coluna de geometria corretamente formatada e nomeada já deverá existir. Como alternativa, duas colunas para coordenadas x e y que representam locais de pontos podem ser definidas em um aplicativo de planilha e exportadas como formato CSV com outras variáveis.

Opções avançadas

Na seção Opções avançadas da caixa de diálogo de upload, confira e mude as configurações padrão. O desempenho do Earth Engine pode ser melhorado dividindo geometrias que têm um grande número de vértices. O Earth Engine não permite elementos com mais de 1 milhão de vértices. Durante o upload de tabelas, o Earth Engine divide automaticamente geometrias que têm mais de um milhão de vértices. É possível especificar um valor menor para melhorar o desempenho da renderização de vetores.

O Earth Engine vai tentar detectar uma coluna de geometria principal e assumir que a projeção de dados é WGS84, a menos que seja especificado de outra forma. O estado geodésico das geometrias é determinado pela interpretação de borda padrão da projeção (por exemplo, o WGS84 usa geometrias geodésicas), mas isso pode ser substituído no menu "Configurações avançadas". Se a geometria dos seus dados for pontos definidos pelas colunas x e y, nomeie as colunas respectivas como "longitude" e "latitude" ou especifique os nomes das colunas x e y nas configurações avançadas.

Acompanhar o progresso do upload

Depois de iniciar um upload de tabela, uma tarefa de "Transferência de recursos" é adicionada ao Gerenciador de tarefas, encontrada na guia Tarefas no lado direito do editor de código. Verifique o status do upload clicando no ?. ícone que aparece ao passar o cursor sobre a tarefa. Para cancelar um upload, clique no ícone de carregamento ao lado da tarefa. Quando a transferência for concluída, a célula da tarefa vai ficar azul, e o recurso vai aparecer na pasta do usuário na guia Recursos com um ícone .

Limites de upload de tabelas

Ao fazer o upload de tabelas, o número máximo de elementos é 100 milhões. O número máximo de propriedades em um elemento é 1.024. Esses limites garantem que o recurso resultante possa ser consultado de maneira eficiente. Além disso, cada elemento tem um número máximo de vértices, conforme explicado na seção "Opções avançadas" acima.

Como carregar um recurso de tabela no script

Para criar um FeatureCollection no script com base em um recurso de tabela, importe-o conforme descrito na página Gerenciar recursos.