6. Conversão de Planilha para GeoJSON (Interface Gráfica)#

Este capítulo apresenta métodos práticos para converter planilhas Excel em arquivos GeoJSON válidos usando ferramentas de interface gráfica (QGIS) e edição manual.

Público-alvo: Usuários sem conhecimento de programação.

📥 Download dos Templates: Os templates estão disponíveis no Portal de Dados Abertos da ARTESP: https://dadosabertos.artesp.sp.gov.br/dataset/programacao-de-obras

• template_lxx_conservacao_2026_r0.xlsx
• template_lxx_obras_2026_r0.xlsx

Introdução e Visão Geral#

Este guia apresenta um processo passo a passo para usuários que preferem trabalhar com ferramentas visuais (Excel + QGIS) em vez de programação.

⚠️ IMPORTANTE: Requisitos de Precisão Geométrica da ARTESP#

A ARTESP adotou o formato GeoJSON especificamente para obter geometrias realistas e precisas dos serviços a serem executados.

Requisitos obrigatórios:

1. Serviços lineares (pavimentação, sinalização horizontal, barreiras) DEVEM usar LineString que segue o traçado real da rodovia.

2. Serviços de área (SAU, estacionamentos, áreas de intervenção) DEVEM usar Polygon representando a área real da intervenção.

3. Serviços pontuais (instalação de 1 equipamento em 1 local específico) podem usar Point.

❌ NÃO SERÃO ACEITOS:

• ❌ MULTIPOINT com apenas 2 pontos (início e fim) para representar serviços lineares
• ❌ LineString com apenas 2 pontos (linha reta) que não acompanha o traçado da rodovia
• ❌ Geometrias aproximadas ou simplificadas para serviços que requerem precisão

✅ Implicações para escolha do método:

• Opção 1 (Fórmula Excel): Gera MULTIPOINT → Aceita APENAS para serviços pontuais onde km_inicial = km_final
• Opção 2 (WKT Manual): Aceita SE o WKT contiver geometria completa e precisa
• Opção 3 (QGIS Desenho Manual): RECOMENDADO para a maioria dos serviços lineares e de área
• Opção 4 (ogr2ogr): Aceita se WKT de entrada já for completo e preciso

💡 Recomendação: Para a maioria dos serviços de conservação e obras, use a Opção 3 (QGIS Desenho Manual) para garantir conformidade com os requisitos da ARTESP.

flowchart TD
    Start([Iniciar Conversão])

    Start --> Q1{Tem coordenadas<br/>de km_inicial<br/>e km_final?}

    Q1 -->|Sim| Opt1[🌟 OPÇÃO 1<br/>Fórmula Excel<br/>POINT/MULTIPOINT<br/>Automático]

    Q1 -->|Não| Q2{Já tem<br/>WKT pronto?}

    Q2 -->|Sim| Opt2[OPÇÃO 2<br/>WKT Manual<br/>Copy/Paste]

    Q2 -->|Não| Q3{Precisa geometria<br/>precisa seguindo<br/>traçado?}

    Q3 -->|Sim| Opt3[OPÇÃO 3<br/>QGIS Desenho<br/>Manual sobre Mapa]

    Q3 -->|Não,<br/>linha de comando| Opt4[OPÇÃO 4<br/>ogr2ogr<br/>CLI Avançado]

    Opt1 --> End1([Opção 1:<br/>Fórmula Excel])
    Opt2 --> End2([Opção 2:<br/>WKT Manual])
    Opt3 --> End3([Opção 3:<br/>QGIS Desenho])
    Opt4 --> End4([Opção 4:<br/>ogr2ogr])

    style Opt1 fill:#e1f5e1,stroke:#4caf50,stroke-width:4px
    style Opt2 fill:#e3f2fd,stroke:#2196f3,stroke-width:2px
    style Opt3 fill:#fff3e0,stroke:#ff9800,stroke-width:2px
    style Opt4 fill:#ffebee,stroke:#f44336,stroke-width:2px
    style Start fill:#f3e5f5,stroke:#9c27b0
    style End1 fill:#c8e6c9,stroke:#4caf50
    style End2 fill:#bbdefb,stroke:#2196f3
    style End3 fill:#ffe0b2,stroke:#ff9800
    style End4 fill:#ffcdd2,stroke:#f44336

Passos do processo:

1. Preparar a planilha Excel (seção 6.2)
2. Limpar, adicionar coluna ID e coordenadas (seção 6.3)
3. Escolher método de geometria - 4 opções:
   • Opção 1: Fórmula Excel automática (mais fácil)
   • Opção 2: WKT manual (se já tem WKT)
   • Opção 3: QGIS desenho manual (geometrias precisas) 🌟
   • Opção 4: ogr2ogr CLI (avançado)
4. Exportar para GeoJSON via QGIS
5. Adicionar metadados e ajustar formato
6. Validar o arquivo

Passo 1: Preparar a Planilha Excel#

1. Baixe o template apropriado do Portal de Dados Abertos:

   • Para conservação: template_lxx_conservacao_2026_r0.xlsx
   • Para obras: template_lxx_obras_2026_r0.xlsx

2. Abra o arquivo no Excel ou LibreOffice Calc

3. Preencha seus dados seguindo as instruções do template

Exemplo de preenchimento para CONSERVAÇÃO:

Exemplo de preenchimento para OBRAS:

⚠️ Pontos de Atenção:

• Campo local: Use ponto e vírgula (;) para separar múltiplos locais
  • Exemplo: PISTA_NORTE;PISTA_SUL;CANTEIRO_CENTRAL
• Campo lote: Use o formato L + 2 dígitos
  • Correto: L01, L13, L22
  • Errado: L1, L133, 1
• Datas: Formato YYYY-MM-DD
  • Correto: 2026-03-15
  • Errado: 15/03/2026, 03-15-2026
• Campo observacoes_gerais: Deixe em branco se não houver observações (será convertido para null)
• Separador decimal: Use ponto (.), não vírgula
  • Correto: 125.500
  • Errado: 125,500

Passo 2: Limpar e Preparar a Planilha#

Antes de importar no QGIS, você precisa preparar a planilha:

A. Remover Linhas de Cabeçalho e Exemplos:

1. Delete as linhas 1-5 do template (cabeçalho, instruções e exemplos)
2. A primeira linha deve conter apenas os nomes das colunas
3. A segunda linha em diante deve conter seus dados reais

B. Remover Abas Não Utilizadas:

1. Se o arquivo Excel tiver múltiplas abas, delete todas exceto a aba com seus dados
2. Renomeie a aba principal para “Dados” (opcional, mas recomendado)

C. Adicionar Coluna ID:

1. Crie uma nova coluna chamada id (primeira coluna, antes de lote)
2. Preencha com identificadores únicos sequenciais:
   • Para conservação: conserva-001, conserva-002, conserva-003, …
   • Para obras: obra-001, obra-002, obra-003, …
   • Ou simplesmente: 1, 2, 3, …

D. Adicionar Colunas de Coordenadas:

As coordenadas geográficas dos pontos inicial e final de cada serviço são necessárias para gerar as geometrias.

1. Adicione 4 novas colunas após a coluna id:

   • lon_inicio - Longitude do km_inicial
   • lat_inicio - Latitude do km_inicial
   • lon_fim - Longitude do km_final
   • lat_fim - Latitude do km_final

2. Preencha com as coordenadas em graus decimais no sistema SIRGAS 2000 (EPSG:4674)

⚠️ IMPORTANTE: Separador Decimal

As coordenadas DEVEM usar PONTO (.) como separador decimal, não vírgula.

• ✅ Correto: -46.6333 ou -23.5505
• ❌ Errado: -46,6333 ou -23,5505

Como garantir formato correto:

1. Formate as células como Número:

   • Selecione as colunas de coordenadas (lon_inicio, lat_inicio, lon_fim, lat_fim)
   • Clique direito → Formatar Células
   • Escolha Número
   • Configure 6 casas decimais

2. Se sua planilha já tem vírgulas, use Localizar e Substituir:

   • Pressione Ctrl+H
   • Localizar: , (vírgula)
   • Substituir: . (ponto)
   • Clique em Substituir Tudo (aplique apenas nas colunas de coordenadas)

Exemplo após limpeza (CONSERVAÇÃO):

Próximos Passos: Escolha seu Método#

Agora que seus dados estão preparados, escolha uma das quatro opções para gerar as geometrias:

📊 Tabela Comparativa:

⚠️ ATENÇÃO - Requisitos ARTESP:

• Serviços lineares (pavimentação, sinalização, barreiras) → Use Opção 3 (QGIS Desenho Manual)
• Serviços de área (SAU, estacionamentos) → Use Opção 3 (QGIS Desenho Manual)
• Serviços pontuais (1 equipamento em 1 local) → Pode usar Opção 1 (Fórmula Excel com POINT)

💡 Recomendação: Para a maioria dos serviços de conservação e obras, use a Opção 3 (QGIS Desenho Manual) para garantir geometrias precisas que seguem o traçado real da rodovia.

📌 Navegação:

• ➡️ Opção 1: Fórmula Excel/Calc
• ➡️ Opção 2: WKT Manual
• ➡️ Opção 3: QGIS Desenho Manual 🌟 Recomendado
• ➡️ Opção 4: ogr2ogr CLI