Visualizador de TSV: abra arquivos separados por tabulação no mapa ou como tabela

O que este visualizador faz

TSV (valores separados por tabulação) é um dos formatos de dados mais simples que existem: uma linha por registro e um caractere de tabulação entre as colunas. Muitas ferramentas geram esse formato. Bancos de dados exportam TSV, portais científicos oferecem TSV para download, e quando você copia células do Excel ou do Google Sheets, a área de transferência guarda TSV. O problema é que um arquivo TSV aberto em um editor de texto é difícil de ler, porque as colunas não ficam alinhadas.

Este visualizador lê o arquivo e mostra os dados da forma mais útil. Primeiro ele olha os nomes das colunas. Se encontra uma coluna de latitude e outra de longitude, por exemplo Latitude/Longitude, lat/lon, Breitengrad/Längengrad ou 緯度/経度, cada linha com valores válidos aparece como um ponto no mapa. Ele também lê coordenadas em graus, minutos e segundos, números com vírgula decimal e colunas únicas como "52.52, 13.40" ou POINT (13.40 52.52). Se não encontra nada, mostra os dados como tabela, e você ainda pode escolher as colunas de coordenadas.

Eu criei esta ferramenta para dar uma olhada rápida em um arquivo que alguém enviou para você. Você vê onde estão as linhas, colore os pontos por qualquer coluna, clica em um ponto para ler a linha, muda para a tabela para ordenar e filtrar, e pula de uma linha da tabela para o seu ponto. No fim, você baixa as linhas do mapa como GeoJSON ou a tabela inteira como CSV. O arquivo fica no seu navegador e nunca é enviado.

Como é um arquivo TSV

Aqui estão o cabeçalho e três linhas do arquivo de exemplo desta página. Cada → representa um caractere de tabulação, invisível na maioria dos editores. A última linha tem as células de latitude e longitude vazias, então o visualizador a conta como uma linha sem coordenadas.

ID→Name→Category→City→Country→Latitude→Longitude
1→Eiffel Tower→Tower→Paris→France→48.8584→2.2945
5→Colosseum→Monument→Rome→Italy→41.8902→12.4922
29→Plitvice Lakes→Nature park→Plitvička Jezera→Croatia→→

Separador

Um caractere de tabulação (\t, Unicode U+0009) entre duas células. Duas tabulações seguidas significam uma célula vazia.

Linhas

Um registro por linha. Quebras de linha do Windows (\r\n) e do Unix (\n) funcionam. Linhas vazias são ignoradas.

Primeira linha

Normalmente os nomes das colunas. O visualizador decide isso sozinho: se a primeira linha tem números nas mesmas colunas que a segunda, são dados. Você pode mudar a escolha no painel File.

Aspas

O formato TSV original não usa aspas, então uma célula nunca pode conter uma tabulação ou uma quebra de linha. O Excel e o Google Sheets colocam aspas no estilo do Excel quando uma célula precisa. O visualizador lê os dois estilos.

Nomes e tipo de arquivo

Normalmente .tsv, às vezes .tab ou .txt. O tipo de mídia registrado é text/tab-separated-values.

Um arquivo TSV não tem tipos de dados. Cada célula é texto, e o visualizador decide o que é número ou coordenada. Na exportação GeoJSON, números simples viram números, enquanto códigos com zero à esquerda, como o código postal 01067, continuam como texto.

TSV ou CSV: qual usar

TSV e CSV guardam o mesmo tipo de tabela. A única diferença real é o separador, mas essa diferença tem alguns efeitos práticos.

Minha opinião: se os seus dados têm endereços, texto livre ou vírgulas decimais, TSV é a escolha mais segura, porque uma tabulação quase nunca aparece dentro de um valor. Se você precisa do maior suporte possível, exporte CSV. Este visualizador converte qualquer TSV em CSV com um clique.

Quais nomes de coluna são reconhecidos

Os nomes das colunas são comparados depois de uma limpeza: maiúsculas e minúsculas não importam, texto entre parênteses ou colchetes como (WGS84) ou [deg] é removido, e espaços e pontos viram sublinhados. Assim Latitude (WGS84), LAT. e gps latitude são todos encontrados. Se nada combinar, você escolhe as colunas no painel Coordinates.

Latitude

lat, latitude, lati, y, ycoord, point_y, decimalLatitude, gps_lat, lat_dd, lat_wgs84, além de Breite/Breitengrad, latitud, latitudine e 緯度.

Longitude

lng, lon, long, longitude, x, xcoord, point_x, decimalLongitude, gps_lon, lon_dd, além de Länge/Längengrad, longitud, longitudine e 経度.

Uma coluna com as duas

Nomes como coordinates, coords, latlng, lnglat, position, location, gps, wkt ou geometry, quando as células têm dois números ("52.52, 13.40") ou um ponto WKT (POINT (13.40 52.52)).

Escolha entre candidatos

Cada par possível de latitude e longitude é testado nas primeiras 300 linhas. Vence o par com mais valores dentro de ±90 e ±180. x/y perdem os empates para nomes lat/lon reais, então colunas x/y projetadas em metros nunca são tomadas como graus.

Ordem em uma coluna

WKT sempre traz a longitude primeiro. lnglat e lonlat significam longitude primeiro. Os outros pares de texto são lidos com a latitude primeiro, a ordem do Google Maps, a menos que só a outra ordem dê valores válidos.

Detalhes técnicos

Isto é exatamente o que o visualizador aceita e produz.

Entrada

Arquivos .tsv, .tab e .txt de até 50 MB, ou texto separado por tabulação colado na caixa Paste TSV. Um arquivo .csv recebe uma mensagem indicando a ferramenta CSV to Map.

Codificação

UTF-8. A marca de ordem de bytes no início é removida.

Formatos de coordenadas

Graus decimais (48.8584, 48,8584), com símbolo de grau ou letra de hemisfério (48.8584° N, W 1.5115), e graus-minutos-segundos (48°51'30"N, 48 51 30 N, 48:51.5).

Coordenadas válidas

Latitude entre −90 e 90, longitude entre −180 e 180 (WGS84). Linhas fora desses intervalos são contadas e ficam fora do mapa. Linhas que caberiam com os dois valores trocados também são contadas, com um botão Swap.

Linhas desiguais

Linhas com menos células que o cabeçalho são completadas com células vazias. Células a mais ganham colunas próprias, chamadas Column N. O painel File mostra quantas linhas eram desiguais.

Visão de tabela

100 linhas por página, ordenação por qualquer coluna (números são ordenados como números), uma caixa de filtro que busca em todas as células e um botão ⌖ em cada linha com coordenadas, que pula para o ponto dela.

Colorir por coluna

Qualquer coluna com até 10 valores diferentes pode colorir os pontos, com legenda e contagem por valor.

Exportação

GeoJSON com as linhas que estão no mapa, cada coluna como propriedade. CSV com a tabela inteira, incluindo linhas sem coordenadas.

Privacidade

O arquivo é lido no seu navegador. Só os blocos do mapa base vêm da internet.

Como abrir um arquivo TSV, passo a passo

Este é o processo completo com o exemplo embutido: 29 pontos turísticos europeus com as colunas Latitude e Longitude, em que uma linha não tem coordenadas. O passo 6 mostra o que acontece com um arquivo cujas colunas de coordenadas têm nomes incomuns.

1

Passo 1: Abra o visualizador

O mapa abre com um mapa base de ruas. Use Upload, Paste TSV ou arraste um arquivo para o mapa. Aqui eu cliquei em Sample Data.

2

Passo 2: Confira o arquivo

O painel File mostra o tamanho, o número de linhas e colunas, e se a primeira linha foi lida como nomes de coluna. 28 das 29 linhas estão no mapa; a linha dos Lagos de Plitvice tem as células de coordenadas vazias.

3

Passo 3: Confirme as colunas de coordenadas

O painel Coordinates mostra as colunas encontradas, aqui Latitude e Longitude. Você pode escolher outras colunas a qualquer momento, ou mudar para "One column" para células como "48.85, 2.29" ou POINT (2.29 48.85).

4

Passo 4: Colora os pontos por uma coluna

Escolha uma coluna em "Color by column". Aqui Category dá a cada tipo de ponto turístico a sua própria cor, com legenda e contagem. Clique em qualquer ponto para ler a linha dele.

5

Passo 5: Mude para a tabela

Clique em Table para ver todas as linhas. As colunas de coordenadas ficam destacadas. Clique no nome de uma coluna para ordenar, digite na caixa de filtro para buscar e clique em ⌖ para pular para aquela linha no mapa.

6

Passo 6: Um arquivo sem coordenadas reconhecidas

Esta lista colada usa as colunas N e E, que o visualizador não trata como nomes de coordenadas. Por isso ela abre como tabela, com um aviso. Escolha N como latitude e E como longitude no painel Coordinates e o mapa abre.

Outras formas de abrir um arquivo TSV

Este visualizador é o jeito mais rápido de olhar um arquivo TSV. Quando o mesmo arquivo faz parte de um trabalho maior, eu uso estas ferramentas.

A mesma tarefa em código

Todos os exemplos usam o arquivo de exemplo desta página, com as coordenadas nas colunas `Latitude` e `Longitude`.

# Python: pandas reads TSV with sep="\t", GeoPandas builds the points
import pandas as pd
import geopandas as gpd

df = pd.read_csv("landmarks.tsv", sep="\t", dtype=str)
df = df.dropna(subset=["Latitude", "Longitude"])
gdf = gpd.GeoDataFrame(
    df,
    geometry=gpd.points_from_xy(df["Longitude"].astype(float), df["Latitude"].astype(float)),
    crs="EPSG:4326",
)
gdf.to_file("landmarks.geojson", driver="GeoJSON")

# GDAL / OGR: TSV to GeoJSON in one command
ogr2ogr -f GeoJSON landmarks.geojson landmarks.tsv \
  -oo X_POSSIBLE_NAMES=Longitude -oo Y_POSSIBLE_NAMES=Latitude \
  -a_srs EPSG:4326

# Command line: print name and coordinates, skip rows without a latitude
awk -F'\t' 'NR > 1 && $6 != "" { print $2 ": " $6 ", " $7 }' landmarks.tsv

# Only the columns you need (cut splits on tabs by default)
cut -f2,6,7 landmarks.tsv

Minha opinião: use este visualizador para olhar um arquivo novo e conferir as coordenadas. Depois que você conhece as colunas, o ogr2ogr ou algumas linhas de pandas fazem a conversão toda vez que os dados mudam.

Como o visualizador funciona

Isto é o que acontece entre soltar um arquivo e ver o mapa ou a tabela. Cada passo roda no seu navegador.

1. Verificar o separador. As primeiras linhas são verificadas em busca de tabulações. Se não houver nenhuma, mas houver vírgulas ou pontos e vírgulas, você recebe um aviso de que o arquivo provavelmente é CSV.
2. Separar linhas e células. O Papa Parse divide o texto nas tabulações e quebras de linha e entende aspas no estilo do Excel. Se as aspas quebrarem as linhas, o arquivo é lido de novo com cada aspa tratada como texto comum, como no formato TSV original.
3. Encontrar o cabeçalho. Se a primeira linha tem números nas mesmas colunas que a segunda, são dados, e as colunas se chamam Column 1, Column 2 e assim por diante. Caso contrário, ela traz os nomes das colunas. Nomes vazios são preenchidos e nomes repetidos ganham (2), (3).
4. Detectar as coordenadas. Os nomes das colunas são limpos e comparados com as listas acima. Cada par candidato é testado em até 300 linhas, e vence o par com mais valores válidos. Se nenhum par servir, são testadas colunas com os dois valores.
5. Mapa ou tabela. Com coordenadas, cada linha é lida como graus decimais ou graus-minutos-segundos, linhas inválidas são contadas e os pontos são desenhados em uma camada canvas. Sem coordenadas, a tabela abre no lugar.
6. Mudar tudo. A escolha do cabeçalho, as colunas de coordenadas, a ordem e as cores podem ser mudadas na barra lateral. O mapa e a tabela se atualizam na hora.

A detecção é só um primeiro palpite. Cada escolha pode ser mudada na barra lateral, então um palpite errado custa um clique.

Lendo coordenadas: DMS, intervalos e precisão

As coordenadas em arquivos TSV aparecem de várias formas. Estes três blocos explicam como o visualizador as transforma em pontos e como saber se os números fazem sentido.

decimal = degrees + minutes / 60 + seconds / 3600

52°31'12"N  →  52 + 31/60 + 12/3600     =  52.52
13°24'18"E  →  13 + 24/60 + 18/3600     =  13.405
33°52'08"S  →  −(33 + 52/60 + 8/3600)   = −33.8689

valid  ⇔  −90 ≤ latitude ≤ 90   and   −180 ≤ longitude ≤ 180

stored:   lat = 151.21,  lon = −33.87   →  invalid
swapped:  lat = −33.87,  lon = 151.21   →  valid (Sydney)

1° latitude  ≈ 111 320 m
1° longitude ≈ 111 320 m · cos(latitude)

decimals   latitude step   longitude step in Paris (48.86°)
1          11.1 km          7.3 km
2          1.1 km           730 m
3          111 m            73 m
4          11.1 m           7.3 m
5          1.1 m            0.73 m
6          0.11 m           0.07 m

Quando este visualizador ajuda

Estas são as situações em que eu abro um visualizador de TSV.

1. Conferir um download de um portal de dados. Muitos portais científicos e governamentais, como bancos de dados de biodiversidade e de nomes geográficos, oferecem downloads em TSV. Você vê na hora onde estão os registros e quais não têm coordenadas.
2. Olhar uma exportação de banco de dados. Ferramentas de banco de dados muitas vezes exportam texto delimitado por tabulação. Abra como tabela, ordene, filtre e confira as colunas de localização no mapa.
3. Levar células de uma planilha para o mapa. Selecione células no Excel ou no Google Sheets, copie e cole em Paste TSV. As linhas aparecem no mapa sem salvar nenhum arquivo.
4. Ler um arquivo sem coordenadas. Nem todo arquivo TSV é geográfico. A visão de tabela com ordenação e filtro é um jeito rápido de ler qualquer arquivo separado por tabulação, sem abrir uma planilha.
5. Converter TSV em CSV ou GeoJSON. Gere um CSV para ferramentas que não leem TSV, ou um GeoJSON para QGIS, ArcGIS ou um mapa web.
6. Encontrar coordenadas erradas. As contagens de valores ausentes, fora do intervalo e trocados, junto com o próprio mapa, mostram erros difíceis de ver em uma longa lista de números.
7. Ler coordenadas DMS. Listas de levantamento e dados antigos em graus, minutos e segundos são lidos diretamente, sem conversão prévia.
8. Agrupar pontos por uma coluna. Colora por tipo, status ou região para ver padrões, por exemplo quais lugares pertencem a qual categoria.

Perguntas frequentes

Bibliotecas e créditos

A detecção de coordenadas, o leitor de DMS e a tabela foram escritos para este site. O mapa e a leitura de TSV usam software de código aberto.

• Leaflet 1.9 · BSD-2-Clause · Volodymyr Agafonkin and contributors
  Desenha o mapa interativo, a camada de pontos em canvas e os popups.
• Papa Parse 5 · MIT · Matt Holt and contributors
  Divide o texto TSV em linhas e células, incluindo células entre aspas no estilo do Excel.
• OpenStreetMap, Protomaps (hosted by KONAKTIVE), CARTO, Esri World Imagery · ODbL e termos do provedor · OpenStreetMap contributors, Protomaps, KONAKTIVE, CARTO, Esri
  Blocos e imagens do mapa base.

Ferramentas relacionadas