Update Python IO docs (#853)

Author: kylebarron

python/docs/api/io/arrow_ipc.md

@@ -0,0 +1,16 @@
+# Arrow IPC
+
+It's possible to read and write GeoArrow data to the [Arrow IPC format](https://arrow.apache.org/docs/python/ipc.html).
+
+The Arrow IPC format is able to fully represent GeoArrow data. Loading such files back into memory will identically reproduce the prior data.
+
+Arrow IPC generically supports GeoArrow data without any extra behavior, so the functionality to read and write Arrow IPC files lives in [`arro3`](https://github.com/kylebarron/arro3).
+
+Refer to:
+
+- [`arro3.io.read_ipc`][]
+- [`arro3.io.read_ipc_stream`][]
+- [`arro3.io.write_ipc`][]
+- [`arro3.io.write_ipc_stream`][]
+
+When saved without any internal compression, the Arrow IPC format can also be memory-mapped, enabling faster reading.

python/docs/api/io/csv.md

@@ -0,0 +1,6 @@
+# CSV
+
+Read and write CSV files with a geometry column encoded as Well-Known Text.
+
+::: geoarrow.rust.io.read_csv
+::: geoarrow.rust.io.write_csv

python/docs/api/io/enums.md

@@ -0,0 +1,7 @@
+# FlatGeobuf
+
+Read and write [FlatGeobuf](https://flatgeobuf.org/) files.
+
+::: geoarrow.rust.io.read_flatgeobuf
+::: geoarrow.rust.io.read_flatgeobuf_async
+::: geoarrow.rust.io.write_flatgeobuf

python/docs/api/io/flatgeobuf.md

@@ -0,0 +1,10 @@
+# GDAL
+
+GDAL natively supports reading data from any vector driver as GeoArrow data, and natively supports writing data to any vector driver from GeoArrow data.
+
+For reading and writing you have two options:
+
+- You can use [`pyogrio`'s Arrow integration](https://pyogrio.readthedocs.io/en/latest/api.html#arrow-integration) directly
+- You can use the [`geoarrow.rust.core.read_pyogrio`][] wrapper.
+
+    This calls `pyogrio` under the hood (and requires that `pyogrio` is installed). The wrapper lives in `geoarrow.rust.core` because it has no dependency on any Rust IO code.

python/docs/api/io/functions.md

@@ -0,0 +1,8 @@
+# GeoJSON
+
+Read and write GeoJSON and newline-delimited GeoJSON files.
+
+::: geoarrow.rust.io.read_geojson
+::: geoarrow.rust.io.read_geojson_lines
+::: geoarrow.rust.io.write_geojson
+::: geoarrow.rust.io.write_geojson_lines

python/docs/api/io/gdal.md

@@ -0,0 +1,13 @@
+# GeoParquet
+
+Read and write [GeoParquet](https://geoparquet.org/) files.
+
+::: geoarrow.rust.io.read_parquet
+::: geoarrow.rust.io.read_parquet_async
+::: geoarrow.rust.io.write_parquet
+::: geoarrow.rust.io.ParquetDataset
+::: geoarrow.rust.io.ParquetFile
+::: geoarrow.rust.io.ParquetWriter
+::: geoarrow.rust.io.types.BboxCovering
+::: geoarrow.rust.io.enums.GeoParquetEncoding
+::: geoarrow.rust.io.types.GeoParquetEncodingT

python/docs/api/io/geojson.md

@@ -0,0 +1,6 @@
+# PostGIS
+
+Read from a PostGIS database.
+
+::: geoarrow.rust.io.read_postgis
+::: geoarrow.rust.io.read_postgis_async