Visor de TSV: abre archivos separados por tabulaciones en un mapa o como tabla

Qué hace este visor

TSV (valores separados por tabulaciones) es uno de los formatos de datos más simples que existen: una fila por línea y un carácter de tabulación entre columnas. Muchas herramientas lo generan. Las bases de datos lo exportan, los portales científicos lo ofrecen para descargar, y cuando copias celdas de Excel o Google Sheets, el portapapeles guarda TSV. El problema es que un archivo TSV abierto en un editor de texto es difícil de leer, porque las columnas no quedan alineadas.

Este visor lee el archivo y lo muestra de la forma más útil. Primero mira los nombres de las columnas. Si encuentra una columna de latitud y otra de longitud, por ejemplo Latitude/Longitude, lat/lon, Breitengrad/Längengrad o 緯度/経度, cada fila con valores válidos aparece como un punto en el mapa. También lee coordenadas en grados, minutos y segundos, números con coma decimal y columnas únicas como "52.52, 13.40" o POINT (13.40 52.52). Si no encuentra nada, muestra los datos como una tabla, y aun así puedes elegir tú las columnas de coordenadas.

Lo hice para echar un vistazo rápido a un archivo que alguien te envía. Puedes ver dónde están las filas, colorear los puntos por cualquier columna, hacer clic en un punto para leer su fila, pasar a la tabla para ordenar y filtrar, y saltar de una fila de la tabla a su punto. Al terminar, puedes descargar las filas del mapa como GeoJSON, o la tabla completa como CSV. El archivo se queda en tu navegador y nunca se sube.

Cómo es un archivo TSV

Aquí tienes la cabecera y tres filas del archivo de ejemplo de esta página. Cada → representa un carácter de tabulación, invisible en la mayoría de los editores. La última fila tiene vacías las celdas de latitud y longitud, así que el visor la cuenta como una fila sin 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

Un carácter de tabulación (\t, Unicode U+0009) entre dos celdas. Dos tabulaciones seguidas significan una celda vacía.

Filas

Un registro por línea. Funcionan los finales de línea de Windows (\r\n) y de Unix (\n). Las líneas vacías se omiten.

Primera fila

Normalmente los nombres de las columnas. El visor lo decide solo: si la primera fila tiene números en las mismas columnas que la segunda, son datos. Puedes cambiar la elección en el panel File.

Comillas

El formato TSV original no usa comillas, así que una celda nunca puede contener una tabulación o un salto de línea. Excel y Google Sheets añaden comillas de estilo Excel cuando una celda las necesita. El visor lee los dos estilos.

Nombres y tipo de archivo

Normalmente .tsv, a veces .tab o .txt. El tipo de medio registrado es text/tab-separated-values.

Un archivo TSV no tiene tipos de datos. Cada celda es texto, y el visor decide qué es un número o una coordenada. En la exportación GeoJSON, los números simples pasan a ser números, mientras que los códigos con un cero inicial, como el código postal 01067, siguen siendo texto.

TSV o CSV: cuál usar

TSV y CSV guardan el mismo tipo de tabla. La única diferencia real es el separador, pero esa diferencia tiene algunos efectos prácticos.

Mi opinión: si tus datos tienen direcciones, texto libre o comas decimales, TSV es la opción más segura, porque una tabulación casi nunca aparece dentro de un valor. Si necesitas la máxima compatibilidad, exporta CSV. Este visor convierte cualquier TSV a CSV con un clic.

Qué nombres de columna se reconocen

Los nombres de columna se comparan después de limpiarlos: no importan mayúsculas ni minúsculas, se quita el texto entre paréntesis o corchetes como (WGS84) o [deg], y los espacios y puntos pasan a ser guiones bajos. Así se encuentran Latitude (WGS84), LAT. y gps latitude. Si nada coincide, eliges las columnas en el panel Coordinates.

Latitud

lat, latitude, lati, y, ycoord, point_y, decimalLatitude, gps_lat, lat_dd, lat_wgs84, además de Breite/Breitengrad, latitud, latitudine y 緯度.

Longitud

lng, lon, long, longitude, x, xcoord, point_x, decimalLongitude, gps_lon, lon_dd, además de Länge/Längengrad, longitud, longitudine y 経度.

Una columna con ambos

Nombres como coordinates, coords, latlng, lnglat, position, location, gps, wkt o geometry, cuando las celdas tienen dos números ("52.52, 13.40") o un punto WKT (POINT (13.40 52.52)).

Elegir entre candidatos

Cada posible par de latitud y longitud se prueba con las primeras 300 filas. Gana el par con más valores dentro de ±90 y ±180. x/y pierden los empates frente a nombres lat/lon reales, así que las columnas x/y proyectadas en metros nunca se toman como grados.

Orden en una columna

WKT siempre lleva la longitud primero. lnglat y lonlat significan longitud primero. Los demás pares de texto se leen con la latitud primero, el orden de Google Maps, salvo que solo el otro orden dé valores válidos.

Detalles técnicos

Esto es exactamente lo que el visor acepta y produce.

Entrada

Archivos .tsv, .tab y .txt de hasta 50 MB, o texto separado por tabulaciones pegado en el cuadro Paste TSV. Un archivo .csv recibe un aviso que remite a la herramienta CSV to Map.

Codificación

UTF-8. Se quita la marca de orden de bytes del principio.

Formatos de coordenadas

Grados decimales (48.8584, 48,8584), con símbolo de grado o letra de hemisferio (48.8584° N, W 1.5115), y grados-minutos-segundos (48°51'30"N, 48 51 30 N, 48:51.5).

Coordenadas válidas

Latitud entre −90 y 90, longitud entre −180 y 180 (WGS84). Las filas fuera de esos rangos se cuentan y quedan fuera del mapa. Las filas que encajarían con los dos valores intercambiados también se cuentan, con un botón Swap.

Filas desiguales

Las filas con menos celdas que la cabecera se completan con celdas vacías. Las celdas de más reciben sus propias columnas, llamadas Column N. El panel File muestra cuántas filas eran desiguales.

Vista de tabla

100 filas por página, orden por cualquier columna (los números se ordenan como números), un cuadro de filtro que busca en todas las celdas, y un botón ⌖ en cada fila con coordenadas que salta a su punto.

Colorear por columna

Cualquier columna con hasta 10 valores distintos puede colorear los puntos, con una leyenda y un recuento por valor.

Exportación

GeoJSON con las filas que están en el mapa, cada columna como propiedad. CSV con la tabla completa, incluidas las filas sin coordenadas.

Privacidad

El archivo se lee en tu navegador. Solo las teselas del mapa base vienen de internet.

Cómo abrir un archivo TSV, paso a paso

Este es el proceso completo con el ejemplo integrado: 29 monumentos europeos con las columnas Latitude y Longitude, donde una fila no tiene coordenadas. El paso 6 muestra qué pasa con un archivo cuyas columnas de coordenadas tienen nombres poco comunes.

1

Paso 1: Abre el visor

El mapa se abre con un mapa base de calles. Usa Upload, Paste TSV o arrastra un archivo al mapa. Aquí hice clic en Sample Data.

2

Paso 2: Revisa el archivo

El panel File muestra el tamaño, el número de filas y columnas, y si la primera fila se leyó como nombres de columna. 28 de las 29 filas están en el mapa; la fila de los Lagos de Plitvice tiene vacías las celdas de coordenadas.

3

Paso 3: Confirma las columnas de coordenadas

El panel Coordinates muestra las columnas encontradas, aquí Latitude y Longitude. Puedes elegir otras columnas en cualquier momento, o cambiar a «One column» para celdas como "48.85, 2.29" o POINT (2.29 48.85).

4

Paso 4: Colorea los puntos por una columna

Elige una columna en «Color by column». Aquí Category da a cada tipo de monumento su propio color, con leyenda y recuento. Haz clic en cualquier punto para leer su fila.

5

Paso 5: Pasa a la tabla

Haz clic en Table para ver todas las filas. Las columnas de coordenadas están resaltadas. Haz clic en el nombre de una columna para ordenar, escribe en el cuadro de filtro para buscar y haz clic en ⌖ para saltar a esa fila en el mapa.

6

Paso 6: Un archivo sin coordenadas reconocidas

Esta lista pegada usa las columnas N y E, que el visor no trata como nombres de coordenadas. Por eso se abre como tabla con un aviso. Elige N como latitud y E como longitud en el panel Coordinates y se abre el mapa.

Otras formas de abrir un archivo TSV

Este visor es la forma más rápida de mirar un archivo TSV. Cuando el mismo archivo forma parte de un trabajo mayor, uso estas herramientas.

La misma tarea en código

Todos los ejemplos usan el archivo de ejemplo de esta página, con las coordenadas en las columnas `Latitude` y `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

Mi opinión: usa este visor para mirar un archivo nuevo y comprobar sus coordenadas. Cuando conozcas las columnas, ogr2ogr o unas pocas líneas de pandas hacen la conversión cada vez que cambian los datos.

Cómo funciona el visor

Esto es lo que pasa entre soltar un archivo y ver el mapa o la tabla. Cada paso se ejecuta en tu navegador.

1. Comprobar el separador. Se buscan tabulaciones en las primeras líneas. Si no hay ninguna pero sí comas o puntos y coma, recibes un aviso de que el archivo probablemente es CSV.
2. Separar filas y celdas. Papa Parse divide el texto en tabulaciones y saltos de línea y entiende las comillas de estilo Excel. Si las comillas rompen las filas, el archivo se lee de nuevo tomando cada comilla como texto normal, como en el formato TSV original.
3. Encontrar la cabecera. Si la primera fila tiene números en las mismas columnas que la segunda, son datos, y las columnas se llaman Column 1, Column 2, etc. Si no, contiene los nombres de columna. Los nombres vacíos se completan y los repetidos reciben (2), (3).
4. Detectar las coordenadas. Los nombres de columna se limpian y se comparan con las listas de arriba. Cada par candidato se prueba con hasta 300 filas, y gana el par con más valores válidos. Si ningún par encaja, se prueban columnas con ambos valores.
5. Mapa o tabla. Con coordenadas, cada fila se lee como grados decimales o grados-minutos-segundos, las filas no válidas se cuentan y los puntos se dibujan en una capa canvas. Sin coordenadas, se abre la tabla.
6. Cambiarlo todo. La elección de la cabecera, las columnas de coordenadas, el orden y los colores se pueden cambiar en la barra lateral. El mapa y la tabla se actualizan al instante.

La detección solo es una primera propuesta. Cada elección se puede cambiar en la barra lateral, así que una propuesta equivocada cuesta un clic.

Leer coordenadas: DMS, rangos y precisión

Las coordenadas de los archivos TSV aparecen de varias formas. Estos tres bloques explican cómo el visor las convierte en puntos y cómo saber si los números tienen 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

Cuándo ayuda este visor

Estas son las situaciones en las que abro un visor de TSV.

1. Revisar una descarga de un portal de datos. Muchos portales científicos y públicos, como las bases de datos de biodiversidad y de nombres geográficos, ofrecen descargas en TSV. Ves al momento dónde están los registros y cuáles no tienen coordenadas.
2. Mirar una exportación de base de datos. Las herramientas de bases de datos suelen exportar texto delimitado por tabulaciones. Ábrelo como tabla, ordénalo y fíltralo, y revisa las columnas de ubicación en el mapa.
3. Llevar al mapa celdas de una hoja de cálculo. Selecciona celdas en Excel o Google Sheets, cópialas y pégalas en Paste TSV. Las filas aparecen en el mapa sin guardar ningún archivo.
4. Leer un archivo sin coordenadas. No todos los archivos TSV son geográficos. La vista de tabla con orden y filtro es una forma rápida de leer cualquier archivo separado por tabulaciones sin abrir una hoja de cálculo.
5. Convertir TSV a CSV o GeoJSON. Obtén un CSV para herramientas que no leen TSV, o un GeoJSON para QGIS, ArcGIS o un mapa web.
6. Encontrar coordenadas erróneas. Los recuentos de valores que faltan, fuera de rango o intercambiados, y el propio mapa, muestran errores difíciles de ver en una larga lista de números.
7. Leer coordenadas DMS. Las listas topográficas y los datos antiguos en grados, minutos y segundos se leen directamente, sin convertirlos antes.
8. Agrupar puntos por una columna. Colorea por tipo, estado o región para ver patrones, por ejemplo qué lugares pertenecen a cada categoría.

Preguntas frecuentes

Bibliotecas y créditos

La detección de coordenadas, el lector DMS y la tabla se escribieron para este sitio. El mapa y la lectura de TSV usan software de código abierto.

• Leaflet 1.9 · BSD-2-Clause · Volodymyr Agafonkin and contributors
  Dibuja el mapa interactivo, la capa de puntos en canvas y las ventanas emergentes.
• Papa Parse 5 · MIT · Matt Holt and contributors
  Divide el texto TSV en filas y celdas, incluidas las celdas entre comillas de estilo Excel.
• OpenStreetMap, Protomaps (hosted by KONAKTIVE), CARTO, Esri World Imagery · ODbL y condiciones del proveedor · OpenStreetMap contributors, Protomaps, KONAKTIVE, CARTO, Esri
  Teselas e imágenes del mapa base.

Herramientas relacionadas