Guia de Upload de Dados
Como enviar arquivos e dados para o repositório do SIGMA-PLI.
ANALISTA+
Este guia é destinado a usuários com papel ANALISTA (nível 3) ou superior.
Usuários VISUALIZADOR e OPERADOR não possuem permissão de upload.
1. Visão Geral
O Upload Inteligente (/storage/upload-inteligente) permite que analistas e produtores
enviem arquivos para o Repositório de Dados do PLI, registrando-os automaticamente no
Catálogo de Arquivos com metadados detalhados. Todo arquivo enviado é validado, tem seus
metadados extraídos automaticamente e é classificado em um dos dez perfis
do catálogo — o que determina quais campos serão preenchidos e qual processamento adicional
(como publicação no GeoServer) será executado.
2. Formatos Aceitos por Perfil
O catálogo classifica todo arquivo enviado em um de dez perfis. O perfil determina quais metadados serão coletados e qual processamento automático será executado. A tabela abaixo lista as extensões aceitas em cada perfil — certifique-se de enviar o formato correto para o perfil escolhido.
2.1 Database
Bancos e dumps de dados estruturados.
| Formato | Extensões | Descrição |
|---|---|---|
| Access (novo) | .accdb | Microsoft Access 2007+ Database |
| Backup | .bak | Database Backup |
| SQLite / File DB | .db | Database File (SQLite e outros) |
| SQL Dump | .dump | Database Dump |
| Access (legado) | .mdb | Microsoft Access 97-2003 Database |
| SQL Script | .sql | SQL Dump / Script de exportação |
| SQLite | .sqlite | SQLite Database |
2.2 Desenho 2D/3D
Arquivos CAD, modelos 2D/3D e desenhos técnicos.
| Formato | Extensões | Descrição |
|---|---|---|
| 3D Studio Max | .3ds | 3D Studio Max |
| MicroStation | .dgn | MicroStation Design File |
| AutoCAD Drawing | .dwg | Desenho nativo AutoCAD |
| DXF | .dxf | Drawing Exchange Format — intercâmbio CAD |
| Autodesk FBX | .fbx | Autodesk FBX (modelos 3D) |
| IFC | .ifc | Industry Foundation Classes (BIM) |
| OBJ | .obj | Wavefront OBJ (malha 3D) |
| SketchUp | .skp | Modelo 3D SketchUp |
| STL | .stl | Stereolithography (impressão 3D) |
2.3 Documentos de Texto
Documentos textuais, relatórios e apresentações.
| Formato | Extensões | Descrição |
|---|---|---|
| Word (legado) | .doc | Microsoft Word 97-2003 |
| Word | .docx | Microsoft Word (formato atual) |
| Portable Document Format | ||
| PowerPoint | .pptx | Microsoft PowerPoint |
| RTF | .rtf | Rich Text Format |
| Texto simples | .txt | Plain Text |
2.4 Geodatabase
Bases geográficas e geodatabases estruturadas.
| Formato | Extensões | Descrição |
|---|---|---|
| File Geodatabase (ESRI) | .gdb (como .zip) | Esri File Geodatabase — compacte a pasta .gdb em .zip antes de enviar |
| GeoPackage | .gpkg | GeoPackage (OGC) — base geoespacial auto-contida |
2.5 Geoespacial Raster
Dados geoespaciais matriciais (grades e imagens georreferenciadas).
| Formato | Extensões | Descrição |
|---|---|---|
| GeoTIFF | .geotiff | GeoTIFF (extensão longa) |
| IMG | .img | Raster ERDAS Imagine |
| TIFF | .tif, .tiff | Tagged Image File Format georreferenciado |
2.6 Geoespacial Vetor
Dados geoespaciais vetoriais (pontos, linhas e polígonos).
| Formato | Extensões | Descrição |
|---|---|---|
| Shapefile | .shp (enviar como .zip) | Formato vetorial ESRI — compacte .shp, .dbf, .shx e .prj em um único .zip |
| GeoJSON | .geojson | Vetorial baseado em JSON |
| KML / KMZ | .kml, .kmz | Formato Google Earth |
| GPX | .gpx | Dados de GPS (trilhas e waypoints) |
2.7 Mídia
Imagens, vídeos e áudios.
| Formato | Extensões | Descrição |
|---|---|---|
| Imagem | .jpg, .jpeg, .png, .gif | Fotografias e imagens digitais |
| Vídeo | .mp4 | Arquivo de vídeo |
| Áudio | .mp3 | Arquivo de áudio |
2.8 Nuvem de Pontos
Conjuntos de pontos tridimensionais (LiDAR e fotogrametria).
| Formato | Extensões | Descrição |
|---|---|---|
| E57 | .e57 | E57 Point Cloud (ISO 24711) |
| LAS | .las | Formato padrão ASPRS para LiDAR |
| LAZ | .laz | LAS comprimido |
| PLY | .ply | Polygon File Format (fotogrametria/malhas) |
| PTS | .pts | PTS Point Cloud |
| XYZ | .xyz | XYZ Point Cloud (texto simples) |
2.9 Compactado/Pacote
Arquivos compactados e pacotes de intercâmbio de múltiplos arquivos.
| Formato | Extensões | Descrição |
|---|---|---|
| ZIP | .zip | Compactação padrão — obrigatório para Shapefiles e File Geodatabases |
| RAR | .rar | Compactação RAR |
| 7-Zip | .7z | Compactação 7-Zip |
2.10 Tabular
Planilhas e dados estruturados em linhas e colunas.
| Formato | Extensões | Descrição |
|---|---|---|
| CSV | .csv | Valores separados por delimitador |
| Excel | .xls, .xlsx | Planilha Microsoft Excel |
| ODS | .ods | Planilha LibreOffice/OpenDocument |
3. Limites
| Parâmetro | Valor |
|---|---|
| Tamanho máximo por arquivo | 500 MB |
| Formatos aceitos | Ver tabelas acima |
| Armazenamento | Cloudflare R2 (global) |
4. Passo a Passo do Upload
4.1 Acessar a Tela de Upload
- Faça login na plataforma
- Acesse Repositório de Dados do PLI → Upload Inteligente
(
/storage/upload-inteligente) - A tela do wizard de upload será exibida
4.2 Selecionar o Arquivo
- Clique em "Selecionar arquivo" ou arraste o arquivo para a área de upload
- O sistema validará: extensão permitida, tamanho dentro do limite e integridade do arquivo
Shapefiles: Compacte todos os componentes (.shp, .dbf, .shx, .prj, etc.) em
um único arquivo
.zip antes de enviar.
4.3 Preencher Metadados
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome do dado | Sim | Nome descritivo do dataset |
| Descrição | Sim | Descrição detalhada do conteúdo |
| Tema/Categoria | Sim | Categoria temática (ex: Hidrografia, Uso do Solo) |
| Produtor | Auto | Sua instituição (preenchido automaticamente) |
| Escala | Não | Escala do dado (ex: 1:50.000) |
| Sistema de Coord. | Não | CRS/EPSG (detectado automaticamente se geoespacial) |
| Data de referência | Não | Data de coleta ou produção do dado |
| Palavras-chave | Não | Tags para facilitar a busca |
| Abrangência territorial | Não | Área geográfica de cobertura do dado — seleção por nível hierárquico (ver tabela abaixo) |
Níveis de Abrangência Territorial
Ao selecionar a abrangência territorial, escolha primeiro o nível hierárquico e depois a área específica:
| Nível | Áreas disponíveis |
|---|---|
| País | Brasil |
| Grande Região | Centro-Oeste, Nordeste, Norte, Sudeste, Sul |
| Unidade Federativa | Acre, Alagoas, Amapá, Amazonas, Bahia, Ceará, Distrito Federal, Espírito Santo, Goiás, Maranhão, Mato Grosso, Mato Grosso do Sul, Minas Gerais, Pará, Paraíba, Paraná, Pernambuco, Piauí, Rio de Janeiro, Rio Grande do Norte, Rio Grande do Sul, Rondônia, Roraima, Santa Catarina, São Paulo, Sergipe, Tocantins |
| RA / RM (SP) | RA Central, RA de Araçatuba, RA de Barretos, RA de Bauru, RA de Campinas, RA de Franca, RA de Itapeva, RA de Marília, RA de Presidente Prudente, RA de Registro, RA de Ribeirão Preto, RA de São José do Rio Preto, RA de São José dos Campos, RA de Sorocaba, RM da Baixada Santista, RM de Campinas, RM de Piracicaba, RM de Ribeirão Preto, RM de São Paulo, RM de Sorocaba, RM do Vale do Paraíba e Litoral Norte |
| ZEE (SP) | Cuestas Basálticas, Depressão Periférica Paulista, Planalto Atlântico, Planalto Ocidental Paulista, Província Costeira |
4.4 Enviar
- Revise os metadados preenchidos
- Clique em "Enviar"
- Aguarde o upload e processamento (uma barra de progresso será exibida)
- Ao finalizar, você verá confirmação, metadados extraídos e link para o registro no catálogo
5. Processamento Automático
5.1 Para Dados Geoespaciais
| Etapa | Descrição |
|---|---|
| Extração de metadados | Extensão, CRS, bbox, número de feições/bandas |
| Validação geométrica | Verifica integridade das geometrias |
| Preview | Gera preview/thumbnail do dado |
| Catalogação | Registra no dicionário com metadados |
| Publicação (GeoServer) | Publica como camada WMS/WFS (se configurado) |
| Indexação (Memgraph) | Indexa no grafo de relacionamentos |
| Armazenamento (R2) | Armazena o arquivo original no Cloudflare R2 |
5.2 Para Dados Tabulares/Documentos
| Etapa | Descrição |
|---|---|
| Extração de metadados | Número de linhas/colunas (CSV), número de páginas (PDF) |
| Catalogação | Registra no dicionário |
| Armazenamento (R2) | Armazena o arquivo original |
6. Boas Práticas
6.1 Nomenclatura de Arquivos
- Use nomes descritivos:
hidrografia_sp_2024.shp.zip(nãodados.zip) - Evite caracteres especiais: espaços, acentos, #, @
- Use underscore (
_) como separador
6.2 Shapefiles
- Sempre comprima todos os componentes em um
.zip - Inclua o arquivo
.prj(projeção) — sem ele, o CRS não será detectado - Verifique se o
.dbftem codificação UTF-8 para acentos
6.3 Dados Tabulares (CSV)
- Use UTF-8 como codificação
- Use vírgula ou ponto-e-vírgula como separador
- Inclua cabeçalho na primeira linha
- Para dados com coordenadas, nomeie as colunas:
latitude,longitude
6.4 Rasters (GeoTIFF)
- Verifique se o GeoTIFF tem CRS embarcado
- Comprima com LZW ou DEFLATE para reduzir tamanho
- Inclua overviews (pirâmides) para visualização rápida em mapas
7. Erros Comuns
| Erro | Causa | Solução |
|---|---|---|
| "Extensão não permitida" | Formato não suportado | Verifique os formatos aceitos |
| "Arquivo muito grande" | Excede 500 MB | Comprima ou divida o arquivo |
| "Erro no upload" | Conexão instável | Tente novamente, verifique conexão |
| "CRS não detectado" | Shapefile sem .prj | Adicione o arquivo .prj ao .zip |
| "Geometria inválida" | Feições corrompidas | Repare no QGIS (Fix Geometries) |
8. Consultar Dados Enviados
Após o upload, seus dados estarão disponíveis em:
- Catálogo de Arquivos (
/storage/catalogo): navegue e filtre pelo catálogo completo - SIGMA Drive (
/storage): pesquise arquivos por nome, tipo ou produtor - WebGIS (
/dicionario/webgis): visualize camadas geoespaciais publicadas no mapa interativo - Editor de Catálogo (
/storage/editor-catalogo): edite metadados de arquivos já catalogados (requer ANALISTA+)