GeoParquet

Convert spatial data formats to optimized GeoParquet using the gpio CLI.

153|18|Updated Jan 18, 2025
One-click install
npx skills add https://github.com/geoparquet/geoparquet-io --skill geoparquet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: GeoParquet
Source: https://github.com/geoparquet/geoparquet-io/tree/main/skills/geoparquet
Command: npx skills add https://github.com/geoparquet/geoparquet-io --skill geoparquet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting and optimizing spatial data formats into GeoParquet to enable fast queries and scalable cloud publishing, reducing manual steps and setup overhead.

Core Features & Use Cases

  • Ingest, analyze, and convert formats such as GeoJSON, Shapefile, FlatGeobuf, GeoPackage, and CSV with geometry to GeoParquet.
  • Apply optimizations like compression, sorting, and partitioning to improve performance and storage efficiency.
  • Publish results to cloud storage (S3, GCS, Azure) and generate metadata for discovery and reuse.

Quick Start

Use the geoparquet skill to convert a local dataset to GeoParquet, optimize it, and publish to cloud storage. Examples: gpio convert geoparquet input.geojson output.parquet gpio check all output.parquet --fix --output optimized.parquet

Frequently Asked Questions about GeoParquet

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Shapefile or GeoJSON to GeoParquet?

To convert Shapefile or GeoJSON to GeoParquet, use the gpio CLI to ingest spatial data and output an optimized Parquet file. The tool handles multiple geometry formats and applies compression to reduce storage overhead.

What is the best way to optimize spatial data for cloud publishing?

The best way to optimize spatial data for cloud publishing is converting it to GeoParquet with sorting and partitioning applied. The gpio tool generates cloud-optimized output and metadata for direct publication to S3, GCS, or Azure.

Can I publish GeoParquet files directly to cloud storage like S3?

Yes, you can publish GeoParquet files directly to cloud storage like S3 or GCS. The gpio CLI requires cloud storage access to publish optimized conversion results and generate discovery metadata for downstream queries.

Do I need the gpio tool to convert FlatGeobuf to GeoParquet?

Yes, you need the gpio tool to convert FlatGeobuf to GeoParquet. The conversion, optimization, and cloud publication workflows rely entirely on the gpio CLI to process spatial data formats into query-optimized Parquet files.

Why convert spatial data to GeoParquet instead of keeping GeoJSON?

Converting spatial data to GeoParquet instead of keeping GeoJSON enables fast queries and scalable cloud publishing. GeoParquet supports compression, sorting, and partitioning optimizations that significantly improve performance and storage efficiency.

How do I validate and fix geometry errors in spatial data before conversion?

To validate and fix geometry errors before conversion, run the gpio check command with the fix flag. This checks the spatial dataset, repairs issues, and outputs an optimized GeoParquet file ready for analysis or cloud publishing.