File formats

We currently support the following file formats directly based on the file extension:

Extension	Driver
.shp	ESRI Shapefile
.gpkg	GPKG
.geojson	GeoJSON
.vrt	VRT
.sqlite	SQLite
.csv	CSV
.fgb	FlatGeobuf
.pq	Parquet
.arrow	Arrow
.gml	GML
.nc	netCDF

If you get an error like so:

GeoDataFrames.write("test.foo", df)
ERROR: ArgumentError: There are no GDAL drivers for the .foo extension

You can specifiy the GDAL driver using a keyword as follows:

GeoDataFrames.write("test.foo", df; driver="GeoJSON")

The complete list of GDAL driver codes are listed in the GDAL documentation.

Package extensions

For several file formats, there now exist native Julia packages that can be used as backends. Before using such a specific file format, you must install and load its corresponding package.

GeoJSON

using Pkg
Pkg.add("GeoJSON")

GeoArrow

using Pkg
Pkg.add("GeoArrow")

GeoParquet

using Pkg
Pkg.add("GeoParquet")

Shapefile

using Pkg
Pkg.add("Shapefile")

FlatGeobuf

using Pkg
Pkg.add("FlatGeobuf")  # no write support yet

and as an example, to use the GeoArrow backend and download files, you will need to do:

using GeoDataFrames, GeoArrow  
# now .arrow and .feather files will be read/written using GeoArrow
GeoDataFrames.read("file.arrow")
GeoDataFrames.write("file.arrow", df)

to override this behaviour and use the default GDAL driver, you can pass the driver option as first argument:

GeoDataFrames.read(GeoDataFrames.ArchGDALDriver(), "file.arrow")
GeoDataFrames.write(GeoDataFrames.ArchGDALDriver(), "file.arrow", df)

Any keywords arguments to the read and write are passed on to the underlying package.