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:
- 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.
- 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 comoAno 2005ou2005-2006nao 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
- 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
- Envie o arquivo
- Acesse a pagina "Extensao por Ano"
- Arraste o arquivo .kmz ou clique para selecionar
- 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"
- Ajuste a tolerancia se precisar
- Comece com o padrao de 22 metros
- 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.