KZ KMZ TOOLS
Feedback

Tutorial - Extensao por Ano

Como extrair a extensao em quilometros por entidade e por ano a partir da hierarquia de pastas de um arquivo KMZ

Resumo Rapido

A ferramenta le um arquivo .kmz em duas etapas:

  1. Inspecao: ao enviar o arquivo, a tela mostra a arvore de pastas encontrada e um palpite de qual nivel guarda o ano e qual guarda a entidade.
  2. Processamento: depois de confirmar ou corrigir esse mapeamento, a ferramenta calcula as extensoes e gera um Excel com tres abas.

O que entra no calculo: apenas linhas (LineString). Alfinetes (Point) e areas (Polygon) sao ignorados e ficam registrados na aba Notas do relatorio.

1. Como o KMZ Precisa Estar Organizado

A ferramenta nao le nome de tracado nem descricao. Ela le a hierarquia de pastas. Toda a informacao de ano e de entidade tem que estar no nome das pastas do Google Earth.

O modelo esperado e este:

Concessoes ano a ano <- pasta raiz (nivel 0) | +-- 2005 <- nivel do ano (nivel 1) | | | +-- Autoban <- nivel da entidade (nivel 2) | | +-- trecho norte (LineString) | | +-- trecho sul (LineString) | | | +-- Rodovias do Tiete | +-- SP-300 (LineString) | +-- 2006 | +-- Autoban | +-- duplicacao (LineString) | +-- Entrevias +-- SP-333 (LineString)

Regras praticas

  • Cada tracado precisa estar dentro da pasta do ano e da pasta da entidade a que pertence.
  • Tracados podem estar em subpastas mais profundas que a entidade: eles somam na entidade que esta acima deles.
  • O nome da pasta do ano precisa ser somente numeros, como 2005. Nomes como Ano 2005 ou 2005-2006 nao sao aceitos como ano: a pasta fica fora do calculo e vai para a lista de pastas ignoradas da aba Notas.
  • Duas pastas com o mesmo rotulo de ano em ramos diferentes somam no mesmo ano. Elas nao geram duas linhas no relatorio.
  • Duas pastas com o mesmo nome de entidade em anos diferentes geram uma linha para cada ano, o que e o esperado.

Atencao: se um tracado estiver pendurado direto na pasta do ano, sem pasta de entidade, ele nao e perdido: aparece agrupado na entidade (sem nome). Se essa entidade aparecer no relatorio, e sinal de que falta uma pasta no arquivo.

2. O Nivel do Ano e o Nivel da Entidade

Nivel e a profundidade da pasta contada a partir da raiz. A pasta raiz e o nivel 0, as pastas dentro dela sao o nivel 1, as pastas dentro dessas sao o nivel 2, e assim por diante.

Campo da tela O que significa No exemplo acima
Pasta raiz De qual pasta a contagem de niveis comeca Concessoes ano a ano
Nivel do ano Profundidade das pastas cujo nome e o ano, escrito somente com numeros Nivel 1
Nivel da entidade Profundidade das pastas cujo nome e a entidade (concessionaria, orgao, empresa) Nivel 2

O nivel da entidade tem que ser mais profundo que o nivel do ano. A tela nao deixa processar o contrario, porque a entidade sempre vive dentro do ano.

Quando a deteccao automatica falha

A ferramenta escolhe como pasta raiz a pasta de topo com mais tracados dentro, e tenta adivinhar o nivel do ano procurando a profundidade com a maior proporcao de pastas com nome numerico. Se nenhuma profundidade tiver nome numerico, ela prefere nao palpitar: a tela avisa e voce escolhe os dois niveis na mao, nos seletores. O processamento funciona igual.

A deteccao nao exige que todas as pastas do nivel sejam numericas, justamente porque na pratica quase sempre aparece uma pasta avulsa junto dos anos. Essa pasta avulsa fica registrada na lista de pastas fora do calculo, explicada na secao seguinte.

Antes de processar: leia a linha de previa abaixo dos seletores. Ela diz quantos anos e quantas entidades distintas o mapeamento escolhido vai produzir. Se o numero estiver estranho (um ano so, ou centenas de entidades), o nivel escolhido esta errado.

3. Pastas Fora do Escopo

Nem tudo no arquivo entra no calculo. Uma pasta fica de fora em dois casos, e em nenhum deles ela e descartada em silencio: a pasta sempre aparece em uma lista chamada "Pastas fora do calculo", com o motivo escrito ao lado.

Na tela, antes de processar

Depois do envio do arquivo, o bloco "Pastas fora do calculo" lista as pastas de topo que nao sao a pasta raiz escolhida. E o caso de um arquivo que guarda, ao lado da pasta principal, uma pasta separada de rascunho ou de projeto futuro. O motivo mostrado e "nao e a pasta raiz escolhida".

Use isso como conferencia: se uma pasta que deveria contar aparece nessa lista, a pasta raiz escolhida esta errada. Troque o seletor de pasta raiz e a lista muda na hora, sem precisar enviar o arquivo de novo.

No relatorio, na aba Notas

A secao "Pastas fora do calculo" da aba Notas lista as pastas que estavam no nivel escolhido como ano mas cujo nome nao e um numero. E o caso de uma pasta "Futuro" ou "Em estudo" morando junto das pastas de ano. O motivo registrado e "rotulo de ano nao numerico", acompanhado de quantas subpastas e quantos tracados aquela pasta continha.

Atencao: essas duas listas tem causas diferentes e nao sao a mesma lista. Confira as duas. Se todas as pastas do nivel do ano tiverem nome nao numerico, nada sobra para calcular e o processamento devolve um erro pedindo outro nivel.

4. A Tolerancia de Sobreposicao

Em arquivos reais o mesmo trecho de rodovia costuma estar desenhado mais de uma vez: um tracado de ida e outro de volta, ou um tracado redesenhado sobre o antigo. Somar tudo inflaciona a quilometragem.

Para dar uma segunda leitura, o calculo divide o mapa em uma grade de celulas do tamanho da tolerancia. Cada segmento de linha cai em uma celula. Se dois segmentos caem na mesma celula, eles contam uma unica vez. O resultado vai para as colunas "sem sobreposicao" do relatorio.

Tolerancia Efeito
22 metros (padrao) Une pistas de ida e volta de uma rodovia comum. Recomendado para comecar.
Menor (5 a 10 m) Une menos. Pistas paralelas passam a contar em dobro. Use quando tracados proximos sao de fato trechos diferentes.
Maior (50 m ou mais) Une mais. Comeca a unir rodovias vizinhas que nao tem relacao, subestimando a extensao.

Por que isto e ESTIMATIVA e nao interseccao geometrica

Aviso honesto sobre as colunas "sem sobreposicao": elas acertam o caso de um tracado desenhado sobre si mesmo. Mas dois tracados paralelos a uma distancia maior que a tolerancia caem em celulas diferentes da grade e contam em dobro, mesmo sendo o mesmo trecho de rodovia na pratica.

A ferramenta nao calcula interseccao geometrica entre as linhas. Ela compara posicoes aproximadas em uma grade. Isso e rapido e suficiente para auditoria, mas nao e exato. Em concreto:

  • Ida e volta separadas por 15 m, com tolerancia de 22 m: contam uma vez. Correto.
  • Ida e volta separadas por 40 m, com tolerancia de 22 m: contam duas vezes. A coluna "sem sobreposicao" fica maior que a realidade.
  • Duas rodovias diferentes que passam a 10 m uma da outra, com tolerancia de 22 m: contam uma vez. A coluna "sem sobreposicao" fica menor que a realidade.

Como usar na pratica: trate a coluna de extensao bruta como o numero oficial e as colunas "sem sobreposicao" como um indicador de quanto o arquivo tem de tracado repetido. Elas servem para encontrar problema no desenho, nao para substituir a medicao.

5. Como Ler as Tres Abas do Relatorio

Aba 1 - Resumo por ano

Uma linha por ano, mais dois graficos ao lado da tabela (km por ano em barras e km acumulado em linha).

Coluna O que e
Ano O ano, lido do nome da pasta
Entidades Quantidade de entidades distintas naquele ano
km no ano Extensao bruta somada de todos os tracados daquele ano
km acumulado Soma do ano atual com todos os anteriores. E uma formula =SUM() viva, nao um valor fixo, para voce auditar na propria planilha
km no ano (sem sobrep.) Mesmo calculo com a deduplicacao por grade aplicada
km acumulado (sem sobrep.) Acumulado da coluna anterior, tambem como formula

Aba 2 - Por entidade

O detalhe: uma linha por combinacao de ano e entidade, com filtro automatico ligado no cabecalho e uma linha de TOTAL no fim.

Coluna O que e
Ano e Entidade O par que identifica a linha
Tracados Quantas linhas (LineString) foram somadas nessa combinacao
Extensao (km) Extensao bruta
Sem sobreposicao (km) Extensao com a deduplicacao por grade
Sobreposicao (%) Quanto da extensao bruta foi considerada repetida. O valor e percentual: 30 significa 30 por cento

Sobre o numero de entidades: a coluna Entidades da aba Resumo conta entidades distintas, nao linhas da planilha. Se a mesma entidade aparece em cinco anos, ela conta uma vez em cada um desses anos no resumo, e produz cinco linhas na aba de detalhe. O resumo mostrado na tela ao fim do processamento tambem conta entidades distintas em todo o arquivo, por isso ele costuma ser menor que o numero de linhas da aba Por entidade.

Aba 3 - Notas

O registro do que aconteceu naquele processamento. Leia sempre antes de usar os numeros. Ela traz:

  • Metodologia: como as distancias foram calculadas (segmento a segmento sobre o elipsoide WGS84) e quais geometrias entraram.
  • Sobreposicao: qual tolerancia foi usada e o aviso de que a deduplicacao e estimativa por grade.
  • Escopo do arquivo: quantos tracados foram processados, a extensao total, e quantas geometrias foram descartadas por tipo.
  • Pastas fora do calculo: a mesma lista que apareceu na tela, com a quantidade de tracados de cada pasta ignorada.
  • Entidades a conferir: as entidades com sobreposicao alta, que costumam indicar tracado desenhado mais de uma vez.

Entidades a conferir: essa lista tambem aparece na tela, junto do botao de download. Nao e erro. E um convite a abrir o KMZ naquela entidade e verificar se o tracado esta duplicado de proposito.

6. Passo a Passo

  1. Prepare o KMZ no Google Earth Pro
    • Uma pasta por ano
    • Dentro de cada ano, uma pasta por entidade
    • Dentro de cada entidade, os tracados como linhas
    • Salve o conjunto como um unico arquivo .kmz
  2. Envie o arquivo
    • Acesse a pagina "Extensao por Ano"
    • Arraste o arquivo .kmz ou clique para selecionar
  3. Confira o mapeamento detectado
    • Verifique a arvore de pastas mostrada na tela
    • Confirme a pasta raiz, o nivel do ano e o nivel da entidade
    • Leia a linha de previa e o bloco "Pastas fora do calculo"
  4. Ajuste a tolerancia se precisar
    • Comece com o padrao de 22 metros
  5. Processe e baixe
    • Clique em "Processar"
    • Confira o resumo e a lista de entidades a conferir
    • Baixe a planilha e leia a aba Notas

7. Problemas Comuns

Sintoma Causa provavel Solucao
Aparece um unico ano no relatorio Nivel do ano apontando para a raiz ou para um nivel errado Corrija o "Nivel do ano" e confira a linha de previa
Centenas de entidades com nomes de trecho Nivel da entidade profundo demais, pegando os tracados Suba o "Nivel da entidade" um nivel
Aparece a entidade (sem nome) Tracados pendurados direto na pasta do ano Crie a pasta da entidade no KMZ, ou aceite o agrupamento
Extensao muito menor que o esperado Pastas importantes caindo em "Pastas fora do calculo" Reveja a pasta raiz e os dois niveis
Extensao zero em uma entidade A pasta tem apenas alfinetes ou areas, sem linhas Confira a aba Notas na secao de geometrias descartadas
Sobreposicao alta demais em uma entidade Tracado desenhado mais de uma vez no KMZ Abra o KMZ naquela entidade e remova a duplicata

8. Suporte

Se tiver duvidas ou encontrar problemas:

  • Volte para a ferramenta em Extensao por Ano e reenvie o arquivo para rever a arvore de pastas
  • Leia a aba Notas do relatorio: ela registra tudo que ficou de fora do calculo
  • Consulte o Tutorial de Marcos KM para informacoes gerais sobre coordenadas em KML

Lembre-se: os numeros brutos sao medicao. As colunas "sem sobreposicao" sao estimativa. Sempre diga qual dos dois voce esta usando.