Visor de GeoParquet

Qué hace esta herramienta

Los archivos GeoParquet no se pueden leer directamente. A diferencia de GeoJSON, no puedes abrir uno en un editor de texto y ver las coordenadas, y la mayoría de las herramientas de escritorio GIS de uso habitual todavía no abren este formato de forma nativa. Eso deja un vacío entre tener un archivo .parquet y saber realmente qué contiene: cuántas entidades tiene, qué tipo de geometría usa, qué columnas incluye y qué área cubre.

Este visor cierra ese vacío. Suelta un archivo y la herramienta lee el contenedor Parquet, revisa los metadatos propios de GeoParquet del archivo para encontrar la columna de geometría y su codificación, decodifica cada valor WKB (Well-Known Binary) de vuelta a coordenadas reales, y dibuja el resultado en un mapa. Haz clic en cualquier entidad para ver su tabla de atributos completa, ajusta el color y el estilo para que los patrones se distingan mejor, y exporta todo de nuevo como un archivo GeoJSON cuando lo necesites en un formato que ya entienden más herramientas. Ningún archivo se sube a ningún sitio: el lector de Parquet es una compilación WebAssembly que se ejecuta por completo en tu equipo.

Cómo lee el visor un archivo GeoParquet

El proceso ocurre en tres etapas. Primero, una compilación WebAssembly de la librería Parquet en Rust lee los datos de columna en bruto y los entrega como una tabla de Apache Arrow, el mismo formato en memoria que usan internamente GeoPandas y DuckDB. Segundo, el visor lee los metadatos del esquema de la tabla en busca de una clave llamada "geo", el pequeño bloque JSON que lleva todo archivo GeoParquet y que indica cuál es la columna de geometría principal, describe su codificación y enumera qué tipos de geometría están presentes. Si falta esa clave, el archivo es un Parquet normal, no GeoParquet, y el visor lo indica así en lugar de adivinar.

Tercero, el visor recorre cada fila de la columna de geometría, que contiene valores WKB en bruto, y decodifica cada uno de vuelta a coordenadas: un byte de bandera para el orden de bytes, un código de cuatro bytes para el tipo de geometría, y luego las coordenadas mismas como pares de números de 8 bytes. El mismo decodificador reconoce también la bandera SRID que PostGIS añade a su salida EWKB y los marcadores de dimensión Z/M del estándar ISO WKB, así que los archivos exportados desde una base de datos espacial también se leen correctamente. Las propiedades de cada una de las demás columnas se leen del mismo modo en que Arrow ya las almacena y se adjuntan a cada entidad, y el conjunto se convierte en una FeatureCollection GeoJSON estándar lista para dibujarse en el mapa.

Guía paso a paso

Paso 1

Haz clic en "Subir" y elige un archivo .parquet, arrastra y suelta uno sobre el mapa, o haz clic en "Datos de ejemplo" para cargar un pequeño ejemplo ya preparado.

Paso 2

El archivo se decodifica por completo en tu navegador. El panel de información del archivo muestra el número de entidades, el tipo de geometría, el nombre de la columna de geometría, el CRS y el tamaño del archivo, tomados directamente de sus propios metadatos.

Paso 3

Haz clic en cualquier punto, línea o polígono del mapa para abrir una ventana emergente con todas las propiedades guardadas para esa entidad.

Paso 4

Usa el panel de estilo para cambiar el color, el grosor de línea y la opacidad de relleno aplicados a todas las entidades del mapa.

Paso 5

Haz clic en "Descargar como GeoJSON" para exportar todas las entidades decodificadas como un archivo GeoJSON estándar.

Casos de uso reales

Dónde ayuda realmente poder abrir un archivo GeoParquet directamente, sin escribir código.

1. Revisar rápidamente la salida de un flujo de procesamiento de datos. Si un script o un proceso ETL genera archivos GeoParquet, arrastrar la última salida directamente a este visor es una forma rápida de confirmar que la geometría y los atributos se ven bien antes de confiar en el archivo en las siguientes etapas.
2. Explorar un conjunto de datos abierto antes de escribir código. Conjuntos de datos como Overture Maps o las colecciones de Source Cooperative se distribuyen como GeoParquet. Descargar un pequeño extracto y verlo aquí muestra exactamente qué columnas y qué tipos de geometría contiene, antes de configurar DuckDB o GeoPandas.
3. Verificar una conversión de GeoJSON a GeoParquet. Después de convertir un archivo con una herramienta como el conversor de GeoJSON a GeoParquet de este sitio, cargar el resultado en este visor confirma que la conversión conservó correctamente todas las entidades y propiedades.
4. Revisar datos antes de publicarlos como datos abiertos. Cada vez más equipos municipales y de investigación publican GeoParquet junto con GeoJSON. Una revisión visual rápida aquí detecta problemas evidentes, como una columna de geometría vacía o un cuadro delimitador en el hemisferio equivocado, antes de que el archivo se publique.
5. Enseñar o demostrar el formato GeoParquet. Como el panel de información del archivo muestra la columna de geometría principal, el CRS y la codificación directamente desde los metadatos del propio archivo, esta es una forma cómoda de mostrar a estudiantes o colegas qué hay realmente dentro de un archivo GeoParquet.
6. Recuperar datos utilizables de un archivo sin otro visor a mano. Todavía no todas las herramientas GIS de escritorio leen GeoParquet. Cuando solo necesitas ver qué contiene un archivo .parquet en ese momento, o extraerlo de nuevo como GeoJSON para una herramienta que solo entiende ese formato, esto te ahorra instalar nada.

Preguntas frecuentes