You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sedona.apache.org by ji...@apache.org on 2026/09/25 05:14:58 UTC
(sedona) branch master updated: [DOCS] Add GeoPandas API coverage reference (#3400)

This is an automated email from the ASF dual-hosted git repository.

jiayuasu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/sedona.git


The following commit(s) were added to refs/heads/master by this push:
     new 740a7917acd [DOCS] Add GeoPandas API coverage reference (#3400)
740a7917acd is described below

commit 740a7917acdc16337874db32876fc2f381a14ff1
Author: Jia Yu <ji...@apache.org>
AuthorDate: Thu Sep 24 22:14:52 2026 -0700

    [DOCS] Add GeoPandas API coverage reference (#3400)
---
 README.md                         |   3 +-
 docs/api/geopandas-coverage.md    | 287 ++++++++++++++++++++++++++++++++++++++
 docs/sedonaspark.md               |   1 +
 docs/sedonaspark.zh.md            |   1 +
 docs/tutorial/geopandas-api.md    |   2 +
 docs/tutorial/geopandas-api.zh.md |   2 +
 mkdocs.yml                        |   2 +
 7 files changed, 297 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5f2e2695965..5ee7f3e207a 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,7 @@
 [![R build](https://github.com/apache/sedona/actions/workflows/r.yml/badge.svg)](https://github.com/apache/sedona/actions/workflows/r.yml)
 [![Scala and Java build](https://github.com/apache/sedona/actions/workflows/java.yml/badge.svg)](https://github.com/apache/sedona/actions/workflows/java.yml)
 
+[![GeoPandas API coverage: 91.4% (including partial implementations)](https://img.shields.io/badge/GeoPandas_API_coverage-91.4%25-brightgreen)](docs/api/geopandas-coverage.md "GeoPandas 1.1.4 API availability in Sedona 2.0.0 development, including partial implementations")
 [![GitHub commit activity](https://img.shields.io/github/commit-activity/m/apache/sedona)](https://github.com/apache/sedona/graphs/commit-activity)
 [![GitHub Issues marked as good first issue](https://img.shields.io/github/issues/apache/sedona/good%20first%20issue?color=%237057ff)](https://github.com/apache/sedona/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22good%20first%20issue%22)
 
@@ -107,7 +108,7 @@ Some of the key features of Apache Sedona include:
 * Support for a wide range of geospatial data formats, including [GeoJSON](https://en.wikipedia.org/wiki/GeoJSON), [WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry), and [ESRI](https://www.esri.com) [Shapefile](https://en.wikipedia.org/wiki/Shapefile).
 * Scalable distributed processing of large vector and raster datasets.
 * Tools for spatial indexing, spatial querying, and spatial join operations.
-* Integration with popular geospatial Python tools such as [GeoPandas](https://geopandas.org).
+* GeoPandas API on Apache Spark. See the [coverage reference](docs/api/geopandas-coverage.md) for API availability and limitations in the 2.0.0 development version, compared with GeoPandas 1.1.4.
 * Integration with popular big data tools, such as Spark, [Hadoop](https://hadoop.apache.org/), [Hive](https://hive.apache.org/), and Flink for data storage and querying.
 * A user-friendly API for working with geospatial data in the [SQL](https://en.wikipedia.org/wiki/SQL), [Python](https://www.python.org/), [Scala](https://www.scala-lang.org/) and [Java](https://www.java.com) languages.
 * Flexible deployment options, including standalone, local, and cluster modes.
diff --git a/docs/api/geopandas-coverage.md b/docs/api/geopandas-coverage.md
new file mode 100644
index 00000000000..873a5a422bf
--- /dev/null
+++ b/docs/api/geopandas-coverage.md
@@ -0,0 +1,287 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# GeoPandas API coverage
+
+The `sedona.spark.geopandas` package provides a GeoPandas-style API on Apache Spark.
+This reference describes **Sedona 2.0.0 (development)** against the **GeoPandas 1.1.4** API catalog.
+These counts describe the development branch and do not apply to Sedona 1.9.1.
+For setup and examples, see the [GeoPandas programming guide](../tutorial/geopandas-api.md).
+Import `sedona.spark.geopandas` instead of `geopandas`; the tables use upstream
+API names so they can be compared directly with the GeoPandas catalog.
+
+## Coverage summary
+
+**91.4% API availability (160 of 175 catalogued APIs)**, including partial implementations.
+
+Availability is the number of APIs marked **Available / partially available**
+divided by the total. It measures whether a named API has an implementation, not
+complete parameter support, identical results, or fully distributed execution.
+The notes below identify known restrictions.
+
+| API group | Available / partially available | Unsupported |
+| --- | ---: | ---: |
+| GeoSeries | 119 | 4 |
+| GeoDataFrame | 26 | 7 |
+| Input/output | 3 | 2 |
+| Tools | 6 | 2 |
+| Spatial index | 6 | 0 |
+| Total | 160 | 15 |
+
+### Status definitions
+
+- **Available / partially available**: an implementation exists, with any known parameter, result, or execution limitations described in the notes. The common differences below still apply.
+- **Unsupported**: not implemented, raises `NotImplementedError` without providing the operation, or is intentionally excluded from the distributed API.
+
+### What is counted
+
+The denominator contains the unique named methods, properties, and module functions in the
+GeoPandas 1.1.4 reference catalogs for
+[GeoSeries](https://github.com/geopandas/geopandas/blob/v1.1.4/doc/source/docs/reference/geoseries.rst),
+[GeoDataFrame](https://github.com/geopandas/geopandas/blob/v1.1.4/doc/source/docs/reference/geodataframe.rst),
+[input/output](https://github.com/geopandas/geopandas/blob/v1.1.4/doc/source/docs/reference/io.rst),
+[tools](https://github.com/geopandas/geopandas/blob/v1.1.4/doc/source/docs/reference/tools.rst), and
+[spatial indexing](https://github.com/geopandas/geopandas/blob/v1.1.4/doc/source/docs/reference/sindex.rst).
+
+Each qualified name is counted once, including missing and intentionally unsupported APIs.
+For example, `GeoDataFrame.clip` and `geopandas.clip` are separate catalog entries;
+repeated listings of `GeoSeries.boundary` count only once. The `GeoSeries` and
+`GeoDataFrame` class constructor entries, testing utilities, and the general pandas API
+inherited through pandas-on-Spark are excluded. Alternate constructors such as
+`GeoDataFrame.from_features` are included.
+GeoSeries operations inherited by GeoDataFrame are not counted again unless the
+GeoDataFrame catalog lists them explicitly. API links below open the upstream
+GeoPandas reference; they describe the target interface, not Sedona's support level.
+
+## Common differences
+
+- **Execution and ordering:** operations use Spark and generally evaluate lazily. Row order is not guaranteed unless an API explicitly preserves it. Follow pandas-on-Spark guidance for index alignment and operations across different frames.
+- **Geometry engines:** Sedona generally uses JTS, whereas GeoPandas uses Shapely/GEOS. Geometry ordering and some algorithm results can differ. Spatial measurements are planar; use an appropriate projected CRS for distances and areas.
+- **Local results:** plotting and some conversion methods collect distributed data to the driver. The notes identify these methods. Scalar aggregations materialize their required scalar result; constructors that start with local data distribute that input.
+- **Nearest joins:** `sjoin_nearest` supports point inputs and inner joins. Ties follow Sedona configuration and do not guarantee GeoPandas' complete set of tied rows. See [nearest point joins](../tutorial/geopandas-api.md#nearest-point-joins).
+- **Coordinate transforms:** `GeoSeries.transform` runs a callable on worker batches, so a callable that depends on the whole coordinate array can produce different results. It requires Spark 3.5+ and Shapely 2+.
+
+## GeoSeries
+
+| API | Status | Notes |
+| --- | --- | --- |
+| [`GeoSeries.area`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.area.html) | Available / partially available | — |
+| [`GeoSeries.boundary`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.boundary.html) | Available / partially available | — |
+| [`GeoSeries.bounds`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.bounds.html) | Available / partially available | — |
+| [`GeoSeries.total_bounds`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.total_bounds.html) | Available / partially available | Distributed aggregation returns four bounds to the driver. |
+| [`GeoSeries.length`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.length.html) | Available / partially available | — |
+| [`GeoSeries.geom_type`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.geom_type.html) | Available / partially available | Standalone LinearRing geometries are represented as LineString. |
+| [`GeoSeries.offset_curve`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.offset_curve.html) | Available / partially available | Scalar distance only; join_style and mitre_limit are accepted but ignored. |
+| [`GeoSeries.distance`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.distance.html) | Available / partially available | — |
+| [`GeoSeries.hausdorff_distance`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.hausdorff_distance.html) | Available / partially available | — |
+| [`GeoSeries.frechet_distance`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.frechet_distance.html) | Available / partially available | densify is not supported. |
+| [`GeoSeries.representative_point`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.representative_point.html) | Available / partially available | — |
+| [`GeoSeries.exterior`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.exterior.html) | Available / partially available | Returns LineString rings instead of LinearRing geometries. |
+| [`GeoSeries.interiors`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.interiors.html) | Available / partially available | Interior rings are returned as LineString geometries instead of LinearRing objects. |
+| [`GeoSeries.minimum_bounding_radius`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.minimum_bounding_radius.html) | Available / partially available | — |
+| [`GeoSeries.minimum_clearance`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.minimum_clearance.html) | Available / partially available | — |
+| [`GeoSeries.x`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.x.html) | Available / partially available | — |
+| [`GeoSeries.y`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.y.html) | Available / partially available | — |
+| [`GeoSeries.z`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.z.html) | Available / partially available | — |
+| [`GeoSeries.m`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.m.html) | Available / partially available | — |
+| [`GeoSeries.get_coordinates`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.get_coordinates.html) | Available / partially available | — |
+| [`GeoSeries.count_coordinates`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.count_coordinates.html) | Available / partially available | — |
+| [`GeoSeries.count_geometries`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.count_geometries.html) | Available / partially available | — |
+| [`GeoSeries.count_interior_rings`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.count_interior_rings.html) | Available / partially available | — |
+| [`GeoSeries.set_precision`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.set_precision.html) | Unsupported | Explicit NotImplementedError stub. |
+| [`GeoSeries.get_precision`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.get_precision.html) | Unsupported | Explicit NotImplementedError stub. |
+| [`GeoSeries.get_geometry`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.get_geometry.html) | Available / partially available | — |
+| [`GeoSeries.is_closed`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.is_closed.html) | Available / partially available | Standalone LinearRing identity is lost; empty LinearRing behavior differs. |
+| [`GeoSeries.is_empty`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.is_empty.html) | Available / partially available | — |
+| [`GeoSeries.is_ring`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.is_ring.html) | Available / partially available | — |
+| [`GeoSeries.is_simple`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.is_simple.html) | Available / partially available | — |
+| [`GeoSeries.is_valid`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.is_valid.html) | Available / partially available | — |
+| [`GeoSeries.is_valid_reason`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.is_valid_reason.html) | Available / partially available | — |
+| [`GeoSeries.is_valid_coverage`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.is_valid_coverage.html) | Available / partially available | Distributed validation returns a single boolean to the driver. |
+| [`GeoSeries.invalid_coverage_edges`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.invalid_coverage_edges.html) | Available / partially available | — |
+| [`GeoSeries.has_m`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.has_m.html) | Available / partially available | — |
+| [`GeoSeries.has_z`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.has_z.html) | Available / partially available | — |
+| [`GeoSeries.is_ccw`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.is_ccw.html) | Available / partially available | — |
+| [`GeoSeries.contains`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.contains.html) | Available / partially available | — |
+| [`GeoSeries.contains_properly`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.contains_properly.html) | Available / partially available | — |
+| [`GeoSeries.crosses`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.crosses.html) | Available / partially available | — |
+| [`GeoSeries.disjoint`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.disjoint.html) | Available / partially available | — |
+| [`GeoSeries.dwithin`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.dwithin.html) | Available / partially available | — |
+| [`GeoSeries.geom_equals`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.geom_equals.html) | Available / partially available | — |
+| [`GeoSeries.geom_equals_exact`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.geom_equals_exact.html) | Available / partially available | Standalone LinearRing and matching LineString inputs cannot be distinguished. |
+| [`GeoSeries.geom_equals_identical`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.geom_equals_identical.html) | Available / partially available | Comparison uses Spark storage: LinearRing identity and some empty/NaN-Z or mixed coordinate layouts cannot be distinguished. |
+| [`GeoSeries.intersects`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.intersects.html) | Available / partially available | — |
+| [`GeoSeries.overlaps`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.overlaps.html) | Available / partially available | — |
+| [`GeoSeries.touches`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.touches.html) | Available / partially available | — |
+| [`GeoSeries.within`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.within.html) | Available / partially available | — |
+| [`GeoSeries.covers`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.covers.html) | Available / partially available | — |
+| [`GeoSeries.covered_by`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.covered_by.html) | Available / partially available | — |
+| [`GeoSeries.relate`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.relate.html) | Available / partially available | — |
+| [`GeoSeries.relate_pattern`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.relate_pattern.html) | Available / partially available | — |
+| [`GeoSeries.clip_by_rect`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.clip_by_rect.html) | Available / partially available | Uses intersection with an envelope; boundary-only intersections and empty output types differ from GeoPandas rectangle clipping. |
+| [`GeoSeries.difference`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.difference.html) | Available / partially available | GeometryCollection operands are not generally supported by the underlying difference operation. |
+| [`GeoSeries.intersection`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.intersection.html) | Available / partially available | — |
+| [`GeoSeries.symmetric_difference`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.symmetric_difference.html) | Available / partially available | — |
+| [`GeoSeries.union`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.union.html) | Available / partially available | — |
+| [`GeoSeries.buffer`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.buffer.html) | Available / partially available | Array/Series distances are not supported; extra keyword arguments are ignored. |
+| [`GeoSeries.centroid`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.centroid.html) | Available / partially available | — |
+| [`GeoSeries.concave_hull`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.concave_hull.html) | Available / partially available | — |
+| [`GeoSeries.convex_hull`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.convex_hull.html) | Available / partially available | — |
+| [`GeoSeries.envelope`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.envelope.html) | Available / partially available | — |
+| [`GeoSeries.extract_unique_points`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.extract_unique_points.html) | Available / partially available | — |
+| [`GeoSeries.force_2d`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.force_2d.html) | Available / partially available | — |
+| [`GeoSeries.force_3d`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.force_3d.html) | Available / partially available | — |
+| [`GeoSeries.make_valid`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.make_valid.html) | Available / partially available | Only method='structure' is supported; the default method='linework' raises. |
+| [`GeoSeries.minimum_bounding_circle`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.minimum_bounding_circle.html) | Available / partially available | — |
+| [`GeoSeries.maximum_inscribed_circle`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.maximum_inscribed_circle.html) | Available / partially available | — |
+| [`GeoSeries.minimum_clearance_line`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.minimum_clearance_line.html) | Available / partially available | — |
+| [`GeoSeries.minimum_rotated_rectangle`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.minimum_rotated_rectangle.html) | Available / partially available | — |
+| [`GeoSeries.normalize`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.normalize.html) | Available / partially available | — |
+| [`GeoSeries.orient_polygons`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.orient_polygons.html) | Available / partially available | — |
+| [`GeoSeries.remove_repeated_points`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.remove_repeated_points.html) | Available / partially available | — |
+| [`GeoSeries.reverse`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.reverse.html) | Available / partially available | — |
+| [`GeoSeries.sample_points`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.sample_points.html) | Available / partially available | Only method='uniform'; RNG results/state advancement differ; extra keywords are ignored. |
+| [`GeoSeries.segmentize`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.segmentize.html) | Available / partially available | — |
+| [`GeoSeries.shortest_line`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.shortest_line.html) | Available / partially available | — |
+| [`GeoSeries.simplify`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.simplify.html) | Available / partially available | — |
+| [`GeoSeries.simplify_coverage`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.simplify_coverage.html) | Available / partially available | Spark Classic with checkpoint storage required; finite valid 2D polygon coverage only, at most 100,000 coordinates per geometry. Conservative simplification may retain extra vertices and never removes rings or parts. |
+| [`GeoSeries.snap`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.snap.html) | Available / partially available | Array-like tolerance is not supported. |
+| [`GeoSeries.transform`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.transform.html) | Available / partially available | Requires Spark >=3.5 and Shapely >=2.0. Callbacks run per Spark batch and must not depend on batch boundaries or mutable state. |
+| [`GeoSeries.affine_transform`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.affine_transform.html) | Available / partially available | — |
+| [`GeoSeries.rotate`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.rotate.html) | Available / partially available | — |
+| [`GeoSeries.scale`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.scale.html) | Available / partially available | — |
+| [`GeoSeries.skew`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.skew.html) | Available / partially available | — |
+| [`GeoSeries.translate`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.translate.html) | Available / partially available | — |
+| [`GeoSeries.interpolate`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.interpolate.html) | Available / partially available | — |
+| [`GeoSeries.line_merge`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.line_merge.html) | Available / partially available | directed=True is not supported. |
+| [`GeoSeries.project`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.project.html) | Available / partially available | — |
+| [`GeoSeries.shared_paths`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.shared_paths.html) | Available / partially available | — |
+| [`GeoSeries.build_area`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.build_area.html) | Available / partially available | — |
+| [`GeoSeries.constrained_delaunay_triangles`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.constrained_delaunay_triangles.html) | Available / partially available | — |
+| [`GeoSeries.delaunay_triangles`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.delaunay_triangles.html) | Available / partially available | Computes a separate triangulation per input geometry rather than aggregating vertices across the series. |
+| [`GeoSeries.explode`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.explode.html) | Available / partially available | — |
+| [`GeoSeries.intersection_all`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.intersection_all.html) | Available / partially available | Distributed aggregation returns one geometry to the driver. |
+| [`GeoSeries.polygonize`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.polygonize.html) | Available / partially available | full=True is not supported. |
+| [`GeoSeries.union_all`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.union_all.html) | Available / partially available | grid_size is not supported; non-default method values are ignored with a warning. |
+| [`GeoSeries.voronoi_polygons`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.voronoi_polygons.html) | Available / partially available | Computes a separate diagram per geometry; only_edges=True is not supported. |
+| [`GeoSeries.from_arrow`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.from_arrow.html) | Available / partially available | Converts a local Arrow array through GeoPandas before constructing the distributed series. |
+| [`GeoSeries.from_file`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.from_file.html) | Available / partially available | Supports Shapefile, GeoJSON, GeoPackage and GeoParquet; uses format/table_name options and does not implement general GeoPandas reader keywords. |
+| [`GeoSeries.from_wkb`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.from_wkb.html) | Available / partially available | Only on_invalid='raise' is implemented. |
+| [`GeoSeries.from_wkt`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.from_wkt.html) | Available / partially available | Only on_invalid='raise' is implemented. |
+| [`GeoSeries.from_xy`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.from_xy.html) | Available / partially available | Additional constructor keyword arguments support name only. |
+| [`GeoSeries.to_arrow`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.to_arrow.html) | Available / partially available | Collects the entire series to the driver and delegates to local GeoPandas. |
+| [`GeoSeries.to_file`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.to_file.html) | Available / partially available | Writes GeoJSON or GeoParquet through Spark; schema, engine and GeoPandas metadata options are not implemented. |
+| [`GeoSeries.to_json`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.to_json.html) | Available / partially available | Collects the entire series through a GeoDataFrame and serializes with local GeoPandas. |
+| [`GeoSeries.to_wkb`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.to_wkb.html) | Available / partially available | Supports hex; additional Shapely serialization keyword arguments are ignored. |
+| [`GeoSeries.to_wkt`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.to_wkt.html) | Available / partially available | Additional Shapely formatting keyword arguments are ignored. |
+| [`GeoSeries.crs`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.crs.html) | Available / partially available | — |
+| [`GeoSeries.set_crs`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.set_crs.html) | Available / partially available | — |
+| [`GeoSeries.to_crs`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.to_crs.html) | Available / partially available | — |
+| [`GeoSeries.estimate_utm_crs`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.estimate_utm_crs.html) | Available / partially available | Uses aggregated bounds to select a local pyproj CRS. |
+| [`GeoSeries.fillna`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.fillna.html) | Available / partially available | Distributed alignment is lazy; invalid duplicate replacement indexes raise when evaluated. limit requires global ordering. |
+| [`GeoSeries.isna`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.isna.html) | Available / partially available | — |
+| [`GeoSeries.notna`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.notna.html) | Available / partially available | — |
+| [`GeoSeries.clip`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.clip.html) | Available / partially available | Rectangular masks use ST_Intersection; boundary-only results can differ from GeoPandas fast rectangle clipping. |
+| [`GeoSeries.plot`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.plot.html) | Available / partially available | Collects the entire series to the driver and delegates to local GeoPandas plotting. |
+| [`GeoSeries.explore`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.explore.html) | Unsupported | No GeoSeries implementation. |
+| [`GeoSeries.sindex`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.sindex.html) | Available / partially available | Returns and caches a Sedona SpatialIndex; query options and results differ from GeoPandas (see Spatial index below). |
+| [`GeoSeries.has_sindex`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.has_sindex.html) | Available / partially available | — |
+| [`GeoSeries.cx`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.cx.html) | Available / partially available | — |
+| [`GeoSeries.__geo_interface__`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoSeries.__geo_interface__.html) | Unsupported | Intentionally excluded by the distributed API plan (issue #2230). |
+
+## GeoDataFrame
+
+| API | Status | Notes |
+| --- | --- | --- |
+| [`GeoDataFrame.from_file`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.from_file.html) | Available / partially available | Reads Shapefile, GeoJSON, GeoPackage, and GeoParquet; GeoPandas reader options are unsupported and directory formats must be explicit. |
+| [`GeoDataFrame.from_features`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.from_features.html) | Available / partially available | Builds small local feature collections through GeoPandas before distributing them; properties follow Spark schema inference. |
+| [`GeoDataFrame.from_postgis`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.from_postgis.html) | Unsupported | Stub raises NotImplementedError. |
+| [`GeoDataFrame.from_arrow`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.from_arrow.html) | Available / partially available | Converts local GeoArrow input through GeoPandas; to_pandas_kwargs requires GeoPandas 1.1 or newer. |
+| [`GeoDataFrame.to_file`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_file.html) | Available / partially available | Writes GeoJSON and GeoParquet through Spark; GeoPackage output, schema, engine, and GeoPandas metadata options are unsupported. |
+| [`GeoDataFrame.to_json`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_json.html) | Available / partially available | Collects the distributed frame to the driver and delegates to GeoPandas. |
+| [`GeoDataFrame.to_geo_dict`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_geo_dict.html) | Unsupported | Intentionally unsupported local feature-collection interface for distributed data; current stub raises NotImplementedError. |
+| [`GeoDataFrame.to_parquet`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_parquet.html) | Available / partially available | Uses the Sedona GeoParquet writer and Spark options; GeoPandas/PyArrow writer-option parity is not provided. |
+| [`GeoDataFrame.to_arrow`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_arrow.html) | Available / partially available | Collects the distributed frame to the driver and delegates to GeoPandas; index=None includes the distributed index. |
+| [`GeoDataFrame.to_feather`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_feather.html) | Unsupported | Stub raises NotImplementedError. |
+| [`GeoDataFrame.to_postgis`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_postgis.html) | Unsupported | No GeoDataFrame implementation is present. |
+| [`GeoDataFrame.to_wkb`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_wkb.html) | Available / partially available | Distributed binary and hexadecimal output work; Shapely serialization keyword options are rejected. |
+| [`GeoDataFrame.to_wkt`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_wkt.html) | Available / partially available | Distributed output works; Shapely formatting keywords are rejected and stored precision is retained rather than default six-place rounding. |
+| [`GeoDataFrame.crs`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.crs.html) | Available / partially available | Delegates CRS metadata access to the active geometry column. |
+| [`GeoDataFrame.set_crs`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.set_crs.html) | Available / partially available | Assigns or removes active-column CRS metadata, including epsg, inplace, and allow_override. |
+| [`GeoDataFrame.to_crs`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.to_crs.html) | Available / partially available | Transforms the active geometry column; supports crs, epsg, and inplace. |
+| [`GeoDataFrame.estimate_utm_crs`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.estimate_utm_crs.html) | Available / partially available | Uses a distributed bounds aggregation; only four aggregate values reach the driver. |
+| [`GeoDataFrame.rename_geometry`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.rename_geometry.html) | Available / partially available | Renames the active geometry column, with inplace support. |
+| [`GeoDataFrame.set_geometry`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.set_geometry.html) | Available / partially available | Existing-column drop=True is rejected; array-like and column selection otherwise work. |
+| [`GeoDataFrame.active_geometry_name`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.active_geometry_name.html) | Available / partially available | Returns the active geometry column label, or None. |
+| [`GeoDataFrame.dissolve`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.dissolve.html) | Available / partially available | Unary union only, without grid_size; supported aggregate aliases and grouping forms are restricted, and unobserved categorical groups and MultiIndex columns are unsupported. |
+| [`GeoDataFrame.explode`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.explode.html) | Available / partially available | Distributed geometry-part expansion supports column, ignore_index, and index_parts; non-geometry columns delegate to pandas-on-Spark. |
+| [`GeoDataFrame.sjoin`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.sjoin.html) | Available / partially available | Contains-properly is unavailable; dwithin requires scalar distance; right joins retain left geometries and row order is not preserved. |
+| [`GeoDataFrame.sjoin_nearest`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.sjoin_nearest.html) | Available / partially available | Point-only inner joins, default suffixes, exclusive=False, flat string columns, and single-level indexes; KNN tie behavior can omit equidistant or coincident rows. |
+| [`GeoDataFrame.clip`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.clip.html) | Available / partially available | Rectangular masks use ST_Intersection; boundary-only results can differ from GeoPandas fast rectangle clipping. |
+| [`GeoDataFrame.overlay`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.overlay.html) | Available / partially available | All five modes are distributed; MultiIndex columns are unsupported, and keep_geom_type=None omits the conditional dropped-geometry warning. |
+| [`GeoDataFrame.explore`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.explore.html) | Unsupported | No GeoDataFrame implementation is present. |
+| [`GeoDataFrame.plot`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.plot.html) | Available / partially available | Collects the distributed frame to the driver and delegates to GeoPandas. |
+| [`GeoDataFrame.sindex`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.sindex.html) | Available / partially available | Returns a Sedona spatial index with different query results and options; the GeoDataFrame does not retain the index cache. |
+| [`GeoDataFrame.has_sindex`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.has_sindex.html) | Available / partially available | GeoDataFrame spatial-index state is not retained; use a retained active GeoSeries for cache state. |
+| [`GeoDataFrame.cx`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.cx.html) | Available / partially available | Distributed coordinate bounding-box selection supports open, reversed, and inclusive slice bounds. |
+| [`GeoDataFrame.__geo_interface__`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.__geo_interface__.html) | Unsupported | Intentionally unsupported local feature-collection interface for distributed data; current stub raises NotImplementedError. |
+| [`GeoDataFrame.iterfeatures`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.GeoDataFrame.iterfeatures.html) | Unsupported | Intentionally unsupported row iterator for distributed data; current stub raises NotImplementedError. |
+
+## Input/output
+
+| API | Status | Notes |
+| --- | --- | --- |
+| [`geopandas.list_layers`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.list_layers.html) | Available / partially available | GeoPackage only; string/path-like inputs only. Reads layer metadata through Spark and collects the small layer listing to pandas. |
+| [`geopandas.read_file`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.read_file.html) | Available / partially available | Reads Shapefile, GeoJSON, GeoPackage and GeoParquet only. GeoPandas bbox/mask/columns/rows/engine options are warned about and ignored; GeoPackage requires table_name rather than layer. |
+| [`geopandas.read_postgis`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.read_postgis.html) | Unsupported | No implementation or public export in sedona.spark.geopandas. |
+| [`geopandas.read_feather`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.read_feather.html) | Unsupported | No implementation or public export in sedona.spark.geopandas. |
+| [`geopandas.read_parquet`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.read_parquet.html) | Available / partially available | Reads GeoParquet through Spark. The columns, storage_options, bbox and to_pandas_kwargs parameters are accepted but silently ignored (no warning); column selection and bbox filtering are not applied. Extra kwargs trigger a warning. |
+
+## Tools
+
+| API | Status | Notes |
+| --- | --- | --- |
+| [`geopandas.sjoin`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.sjoin.html) | Available / partially available | Contains-properly is unavailable; dwithin requires scalar distance; right joins retain left geometries and row order is not preserved. |
+| [`geopandas.sjoin_nearest`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.sjoin_nearest.html) | Available / partially available | Point-only inner joins with exclusive=False, default suffixes, flat unique string columns and single-level indexes. All equidistant rows are not guaranteed; max_distance filters results after the KNN search. |
+| [`geopandas.overlay`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.overlay.html) | Available / partially available | All five overlay modes are implemented natively; MultiIndex columns are explicitly unsupported. keep_geom_type=None does not emit the conditional dropped-geometry warning. |
+| [`geopandas.clip`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.clip.html) | Available / partially available | Rectangular masks use ST_Intersection; boundary-only results can differ from GeoPandas fast rectangle clipping. |
+| [`geopandas.tools.geocode`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.tools.geocode.html) | Unsupported | No geocode implementation or tools export. |
+| [`geopandas.tools.reverse_geocode`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.tools.reverse_geocode.html) | Unsupported | No reverse_geocode implementation or tools export. |
+| [`geopandas.tools.collect`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.tools.collect.html) | Available / partially available | Distributed inputs use ST_Collect_Agg and materialize only the metadata and one scalar geometry required by the API; local inputs delegate to GeoPandas. |
+| [`geopandas.points_from_xy`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.points_from_xy.html) | Available / partially available | Constructs 2D/3D points with CRS through native expressions, but returns a distributed GeoSeries instead of upstream GeometryArray. Distributed coordinate Series must share a frame and index. |
+
+## Spatial index
+
+| API | Status | Notes |
+| --- | --- | --- |
+| [`SpatialIndex.intersection`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.sindex.SpatialIndex.intersection.html) | Available / partially available | Bounding-box wrapper; a distributed index collects matching geometry objects to the driver instead of returning positional indices. Bounds are required as four coordinates. |
+| [`SpatialIndex.is_empty`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.sindex.SpatialIndex.is_empty.html) | Available / partially available | Checks whether the input row count is zero; an input containing only null or empty geometries reports False, unlike the upstream index. |
+| [`SpatialIndex.nearest`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.sindex.SpatialIndex.nearest.html) | Available / partially available | Scalar Shapely input only with a Sedona k argument; no return_all, max_distance or exclusive arguments. Distributed results are collected geometry objects rather than the upstream index-pair array. |
+| [`SpatialIndex.query`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.sindex.SpatialIndex.query.html) | Available / partially available | Scalar Shapely input only; predicates limited to None/intersects/contains, without distance or output_format arguments. Distributed results are collected geometry objects; the local intersects path queries bounding boxes. |
+| [`SpatialIndex.size`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.sindex.SpatialIndex.size.html) | Available / partially available | Counts input rows, including null and empty geometries; upstream counts actual indexed geometries. |
+| [`SpatialIndex.valid_query_predicates`](https://geopandas.org/en/v1.1.4/docs/reference/api/geopandas.sindex.SpatialIndex.valid_query_predicates.html) | Available / partially available | Returns a fresh set containing only None, intersects and contains, reflecting the narrower query implementation. |
+
+## Maintaining this reference
+
+When API support changes, update its status and notes, recalculate the category and
+overall counts, and update the percentage in the repository README badge. Keep the upstream
+baseline version fixed unless the entire catalog is refreshed. Adding a stub does not
+increase availability, and adding one supported parameter does not make an API fully
+compatible. The [GeoPandas implementation tracker](https://github.com/apache/sedona/issues/2230)
+records ongoing work; this page records the implementation available in the version above.
diff --git a/docs/sedonaspark.md b/docs/sedonaspark.md
index 0b681ba1f86..bc01e0ff4a1 100644
--- a/docs/sedonaspark.md
+++ b/docs/sedonaspark.md
@@ -79,6 +79,7 @@ SedonaSpark extends Apache Spark with a rich set of out-of-the-box distributed S
 * **Blazing fast**: SedonaSpark executes computations in parallel on many nodes in a cluster so that large computations can run fast.
 * Supports **various file formats**, including GeoJSON, Shapefile, GeoParquet, STAC, JDBC, OSM PBF, CSV, and PostGIS.
 * Exposes several **language APIs,** including SQL, Python, Java, Scala, and R.
+* Provides a [GeoPandas-style API](tutorial/geopandas-api.md) on Spark. See the [API coverage reference](api/geopandas-coverage.md) for availability and limitations.
 * **Scalable**: Horizontally scale to tens, hundreds, or thousands of nodes depending on the size of your data.  You can process massive spatial datasets with SedonaSpark.
 * **Portable**: Easy to run in a custom environment, locally or in the cloud with AWS EMR, Microsoft Fabric, or Google DataProc.
 * **Extensible**: You can extend SedonaSpark with your custom logic that suits your specific geospatial data analysis needs.
diff --git a/docs/sedonaspark.zh.md b/docs/sedonaspark.zh.md
index cb3db6198ec..c1c74bf9a64 100644
--- a/docs/sedonaspark.zh.md
+++ b/docs/sedonaspark.zh.md
@@ -79,6 +79,7 @@ SedonaSpark 在 Apache Spark 之上扩展了一套丰富、开箱即用的分布
 * **极致性能**：SedonaSpark 在集群中的多个节点上并行执行计算，使大规模计算能够快速完成。
 * 支持**多种文件格式**，包括 GeoJSON、Shapefile、GeoParquet、STAC、JDBC、OSM PBF、CSV 和 PostGIS。
 * 提供多种**语言 API**，包括 SQL、Python、Java、Scala 和 R。
+* 在 Spark 上提供 [GeoPandas 风格的 API](tutorial/geopandas-api.md)。请参阅 [API 覆盖情况参考](api/geopandas-coverage.md)，了解可用功能和限制。
 * **可扩展**：可根据数据规模水平扩展到数十、数百乃至数千个节点，使用 SedonaSpark 处理海量空间数据集。
 * **可移植**：易于在自定义环境中运行，可在本地或云端（如 AWS EMR、Microsoft Fabric、Google DataProc）部署。
 * **可扩展定制**：可以使用自定义逻辑对 SedonaSpark 进行扩展，以满足特定的地理空间数据分析需求。
diff --git a/docs/tutorial/geopandas-api.md b/docs/tutorial/geopandas-api.md
index b0164c713fe..acdf3d463e1 100644
--- a/docs/tutorial/geopandas-api.md
+++ b/docs/tutorial/geopandas-api.md
@@ -21,6 +21,8 @@
 
 The GeoPandas API for Apache Sedona provides a familiar GeoPandas interface that scales your geospatial analysis beyond single-node limitations. This API combines the intuitive GeoPandas DataFrame syntax with the distributed processing power of Apache Sedona on Apache Spark, enabling you to work with planetary-scale datasets using the same code patterns you already know.
 
+See the [API coverage reference](../api/geopandas-coverage.md) for supported methods, parameter limitations, and the coverage percentage.
+
 ## Overview
 
 ### What is the GeoPandas API for Apache Sedona?
diff --git a/docs/tutorial/geopandas-api.zh.md b/docs/tutorial/geopandas-api.zh.md
index 5cfe2b00c66..70ac06dfce1 100644
--- a/docs/tutorial/geopandas-api.zh.md
+++ b/docs/tutorial/geopandas-api.zh.md
@@ -21,6 +21,8 @@
 
 Apache Sedona 上的 GeoPandas API 提供了与 GeoPandas 一致的接口，可以让您的地理空间分析突破单机的局限。该 API 把熟悉的 GeoPandas DataFrame 语法与 Apache Sedona 在 Apache Spark 上的分布式处理能力结合起来，让您能够使用同样的代码模式处理行星级（planetary-scale）的数据集。
 
+请参阅 [API 覆盖情况参考](../api/geopandas-coverage.md)，了解支持的方法、参数限制和 API 覆盖率。
+
 ## 概览
 
 ### 什么是 Apache Sedona 的 GeoPandas API？
diff --git a/mkdocs.yml b/mkdocs.yml
index b3e1e58c24d..5492fb120b2 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -102,6 +102,7 @@ nav:
               - DataFrame/SQL: api/viz/sql.md
               - RDD: api/viz/java-api.md
           - Sedona R: api/rdocs
+          - GeoPandas API coverage: api/geopandas-coverage.md
           - Sedona Python: api/pydocs
       - Release notes: setup/release-notes.md
 
@@ -299,6 +300,7 @@ plugins:
             Raster DataFrame / SQL app: 栅格 DataFrame / SQL 应用
             Pure SQL environment: 纯 SQL 环境
             GeoPandas API on Sedona: Sedona 上的 GeoPandas API
+            GeoPandas API coverage: GeoPandas API 覆盖情况
             Spatial RDD app: 空间 RDD 应用
             Sedona R: Sedona R
             Work with GeoPandas and Shapely: 与 GeoPandas 和 Shapely 配合使用