convert Command¶

The convert command group handles format conversions. By default, converts to GeoParquet. Use subcommands for other conversions.

Subcommands¶

Subcommand	Description
`geoparquet`	Convert vector formats to optimized GeoParquet (default)
`geopackage`	Convert GeoParquet to GeoPackage (.gpkg)
`flatgeobuf`	Convert GeoParquet to FlatGeobuf (.fgb)
`csv`	Convert GeoParquet to CSV with optional WKT geometry
`shapefile`	Convert GeoParquet to Shapefile (.shp)
`geojson`	Convert GeoParquet to GeoJSON (streaming or file)
`reproject`	Reproject a GeoParquet file to a different CRS

Quick Reference¶

gpio convert --help
gpio convert geoparquet --help
gpio convert geopackage --help
gpio convert flatgeobuf --help
gpio convert csv --help
gpio convert shapefile --help
gpio convert geojson --help
gpio convert reproject --help

To GeoParquet (default)¶

For detailed usage, see the Convert to GeoParquet Guide.

# Convert Shapefile to GeoParquet
gpio convert input.shp output.parquet

# Explicit subcommand
gpio convert geoparquet input.gpkg output.parquet

To GeoJSON¶

For detailed usage, see the GeoJSON Conversion Guide.

# Stream to stdout (for tippecanoe)
gpio convert geojson data.parquet | tippecanoe -P -o tiles.pmtiles

# Write to file
gpio convert geojson data.parquet output.geojson

geojson Options¶

Option	Default	Description
`--no-rs`	false	Disable RFC 8142 record separators
`--precision N`	7	Coordinate decimal precision
`--write-bbox`	false	Include bbox property for features
`--id-field COL`	none	Use column as feature id
`--description TEXT`	none	Add description to FeatureCollection
`--feature-collection`	false	Output FeatureCollection instead of GeoJSONSeq
`--pretty`	false	Pretty-print with indentation
`--lco KEY=VALUE`	none	GDAL layer creation option (repeatable)
`--verbose`	false	Show debug output
`--profile NAME`	none	AWS profile for S3

To GeoPackage¶

Convert GeoParquet to GeoPackage format. GeoPackage is an OGC standard based on SQLite with spatial indexing support.

# Convert to GeoPackage
gpio convert geopackage data.parquet output.gpkg

# With custom layer name
gpio convert geopackage data.parquet output.gpkg --layer-name buildings

# Auto-detection (no subcommand needed)
gpio convert data.parquet output.gpkg

geopackage Options¶

Option	Default	Description
`--layer-name TEXT`	features	Layer name in GeoPackage
`--overwrite`	false	Overwrite existing file
`--verbose`	false	Show debug output
`--profile NAME`	none	AWS profile for S3

To FlatGeobuf¶

Convert GeoParquet to FlatGeobuf format. FlatGeobuf is a cloud-native format with built-in spatial indexing designed for efficient streaming and HTTP range requests.

# Convert to FlatGeobuf
gpio convert flatgeobuf data.parquet output.fgb

# Auto-detection (no subcommand needed)
gpio convert data.parquet output.fgb

flatgeobuf Options¶

Option	Default	Description
`--verbose`	false	Show debug output
`--profile NAME`	none	AWS profile for S3

To CSV¶

Convert GeoParquet to CSV format with optional WKT geometry column. Complex types (STRUCT, LIST, MAP) are JSON-encoded.

# Convert to CSV with WKT geometry
gpio convert csv data.parquet output.csv

# Export only attributes (no geometry)
gpio convert csv data.parquet output.csv --no-wkt

# Exclude bbox column
gpio convert csv data.parquet output.csv --no-bbox

# Auto-detection (no subcommand needed)
gpio convert data.parquet output.csv

csv Options¶

Option	Default	Description
`--no-wkt`	false	Exclude WKT geometry column
`--no-bbox`	false	Exclude bbox column if present
`--verbose`	false	Show debug output
`--profile NAME`	none	AWS profile for S3

To Shapefile¶

Convert GeoParquet to Shapefile format.

Shapefile Limitations

Column names truncated to 10 characters
File size limit of 2GB
Limited data type support
Creates multiple files (.shp, .shx, .dbf, .prj)

Consider using GeoPackage or FlatGeobuf for modern workflows.

# Convert to Shapefile
gpio convert shapefile data.parquet output.shp

# With custom encoding
gpio convert shapefile data.parquet output.shp --encoding Latin1

# Auto-detection (no subcommand needed)
gpio convert data.parquet output.shp

shapefile Options¶

Option	Default	Description
`--encoding TEXT`	UTF-8	Character encoding for attribute data
`--overwrite`	false	Overwrite existing file
`--verbose`	false	Show debug output
`--profile NAME`	none	AWS profile for S3

Reproject¶

Reproject a GeoParquet file to a different CRS.

gpio convert reproject input.parquet output.parquet --dst-crs EPSG:32610

See gpio convert reproject --help for all options.