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/05/11 19:07:59 UTC

(sedona) branch branch-1.9.0 updated (b084f02427 -> 3f1023526f)

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

jiayuasu pushed a change to branch branch-1.9.0
in repository https://gitbox.apache.org/repos/asf/sedona.git


    from b084f02427 [DOCS] Update Maven coordinates to Sedona 1.9.0 / geotools-wrapper 1.9.0-33.5 (#2860)
     new 8f008a38cb [GH-2867] Wire mkdocs-static-i18n for Chinese documentation (#2920)
     new c4613115cf [GH-2909] Translate documentation landing pages to Chinese (#2922)
     new d7d91f1b04 [GH-2867] Replace EN/中文 pill with 文A icon dropdown in header (#2923)
     new 58fde4148e [GH-2910] Translate Setup / Install section to Chinese (#2924)
     new 30523d8aec [GH-2911] Translate Tutorial / Programming Guide (part 1) to Chinese (#2931)
     new d0dc9aa32a [GH-2911] Translate Tutorial / Programming Guide (part 2) to Chinese (#2933)
     new 6ddd74ce06 [GH-2911] Translate Tutorial / Programming Guide (part 3) to Chinese (#2934)
     new 95030043bb [GH-2911] Translate Tutorial / Programming Guide (part 4) to Chinese (#2935)
     new d1337ff86f [GH-2867] Make language switcher respect mike version prefix (#2936)
     new 0df937c198 [GH-2912] Translate Community & ASF section to Chinese (#2937)
     new 42ba95942c [GH-2867] Strip mike canonical-version prefix from language switcher links (#2945)
     new 3f1023526f [GH-2867] Translate Stats, Viz, and SQL overview pages to Chinese (#2947)

The 12 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 .../stylesheets/components/_lang-switch.scss       |  99 +++
 docs-overrides/assets/stylesheets/extra.scss       |   1 +
 docs-overrides/main.html                           | 360 +++++++---
 docs-overrides/partials/alternate.html             |  42 ++
 docs-overrides/partials/header.html                |   4 +-
 ...-Transformation.md => CRS-Transformation.zh.md} | 138 ++--
 docs/api/sql/DataFrameAPI.zh.md                    |  98 +++
 docs/api/sql/NearestNeighbourSearching.zh.md       | 203 ++++++
 docs/api/sql/Optimizer.zh.md                       | 418 ++++++++++++
 docs/api/sql/Overview.zh.md                        |  97 +++
 docs/api/sql/Parameter.zh.md                       |  84 +++
 docs/api/sql/Raster-affine-transformation.zh.md    |  85 +++
 docs/api/sql/Raster-map-algebra.zh.md              | 145 ++++
 ...acy-parquet.md => Reading-legacy-parquet.zh.md} |  13 +-
 docs/api/sql/Spider.zh.md                          | 322 +++++++++
 docs/api/sql/Visualization-SedonaKepler.zh.md      |  96 +++
 docs/api/sql/Visualization-SedonaPyDeck.zh.md      | 161 +++++
 docs/api/stats/sql.zh.md                           | 244 +++++++
 .../viz-gallery.md => api/viz/java-api.zh.md}      |   6 +-
 docs/api/viz/sql.zh.md                             | 161 +++++
 .../ST_XMin.md => asf/asf.zh.md}                   |  24 +-
 docs/asf/telemetry.zh.md                           |  30 +
 docs/community/contact.zh.md                       |  65 ++
 .../{contributor.md => contributor.zh.md}          |  82 +--
 docs/community/develop.zh.md                       | 189 +++++
 docs/community/geopandas.zh.md                     |  85 +++
 docs/community/publication.zh.md                   |  70 ++
 docs/community/{publish.md => publish.zh.md}       | 198 +++---
 docs/community/release-manager.zh.md               | 170 +++++
 docs/community/rule.zh.md                          |  75 ++
 docs/community/{snapshot.md => snapshot.zh.md}     |  36 +-
 docs/community/{vote.md => vote.zh.md}             |  60 +-
 docs/download.zh.md                                |  63 ++
 docs/index.zh.md                                   |  26 +
 docs/sedonaflink.zh.md                             | 111 +++
 docs/{sedonasnow.md => sedonasnow.zh.md}           |  24 +-
 docs/sedonaspark.zh.md                             | 135 ++++
 ...-analytics.md => azure-synapse-analytics.zh.md} | 104 +--
 docs/setup/cluster.zh.md                           |  51 ++
 docs/setup/compile.zh.md                           | 193 ++++++
 docs/setup/databricks.zh.md                        | 194 ++++++
 docs/setup/docker.zh.md                            | 179 +++++
 docs/setup/{emr.md => emr.zh.md}                   |  30 +-
 docs/setup/fabric.zh.md                            | 134 ++++
 .../{install-python.md => install-python.zh.md}    |   8 +-
 docs/setup/flink/install-scala.zh.md               |  33 +
 docs/setup/flink/{modules.md => modules.zh.md}     |  16 +-
 .../flink/platform.zh.md}                          |  22 +-
 docs/setup/glue.zh.md                              | 107 +++
 docs/setup/install-python.zh.md                    | 122 ++++
 docs/setup/install-scala.zh.md                     |  94 +++
 ...aven-coordinates.md => maven-coordinates.zh.md} | 114 ++--
 docs/setup/{modules.md => modules.zh.md}           |  18 +-
 docs/setup/overview.zh.md                          |  55 ++
 docs/setup/{platform.md => platform.zh.md}         |  10 +-
 docs/setup/snowflake/install.zh.md                 | 116 ++++
 docs/setup/snowflake/{modules.md => modules.zh.md} |  12 +-
 docs/setup/{wherobots.md => wherobots.zh.md}       |   6 +-
 docs/setup/{zeppelin.md => zeppelin.zh.md}         |  32 +-
 .../Advanced-Tutorial-Tune-your-Application.zh.md  |  86 +++
 .../ST_M.md => tutorial/benchmark.zh.md}           |  25 +-
 ...g-algorithms.md => clustering-algorithms.zh.md} |  48 +-
 .../{distance-spark.md => distance-spark.zh.md}    | 114 ++--
 docs/tutorial/concepts/spatial-joins.zh.md         | 418 ++++++++++++
 docs/tutorial/demo.zh.md                           |  62 ++
 .../tutorial/files/csv-geometry-sedona-spark.zh.md | 192 ++++++
 ...-sedona-spark.md => geojson-sedona-spark.zh.md} |  94 +--
 ...dona-spark.md => geopackage-sedona-spark.zh.md} |  94 +--
 docs/tutorial/files/geoparquet-sedona-spark.zh.md  | 352 ++++++++++
 .../files/geotiffmetadata-sedona-spark.zh.md       | 186 +++++
 docs/tutorial/files/shapefiles-sedona-spark.zh.md  | 219 ++++++
 ...tac-sedona-spark.md => stac-sedona-spark.zh.md} | 214 +++---
 .../flink/{pyflink-sql.md => pyflink-sql.zh.md}    |  13 +-
 docs/tutorial/flink/{sql.md => sql.zh.md}          | 170 ++---
 docs/tutorial/geopandas-api.zh.md                  | 398 +++++++++++
 ...eopandas-shapely.md => geopandas-shapely.zh.md} |  60 +-
 docs/tutorial/jupyter-notebook.zh.md               |  58 ++
 docs/tutorial/raster.zh.md                         | 758 +++++++++++++++++++++
 docs/tutorial/{rdd.md => rdd.zh.md}                | 305 ++++-----
 docs/tutorial/snowflake/sql.zh.md                  | 618 +++++++++++++++++
 .../{sql-pure-sql.md => sql-pure-sql.zh.md}        |  37 +-
 docs/tutorial/{sql.md => sql.zh.md}                | 476 ++++++-------
 docs/tutorial/storing-blobs-in-parquet.zh.md       |  67 ++
 .../tutorial/{viz-gallery.md => viz-gallery.zh.md} |   6 +-
 docs/tutorial/viz.zh.md                            | 247 +++++++
 docs/tutorial/zeppelin.zh.md                       |  85 +++
 mkdocs.yml                                         | 117 ++++
 pyproject.toml                                     |   1 +
 88 files changed, 9930 insertions(+), 1460 deletions(-)
 create mode 100644 docs-overrides/assets/stylesheets/components/_lang-switch.scss
 create mode 100644 docs-overrides/partials/alternate.html
 copy docs/api/sql/{CRS-Transformation.md => CRS-Transformation.zh.md} (61%)
 create mode 100644 docs/api/sql/DataFrameAPI.zh.md
 create mode 100644 docs/api/sql/NearestNeighbourSearching.zh.md
 create mode 100644 docs/api/sql/Optimizer.zh.md
 create mode 100644 docs/api/sql/Overview.zh.md
 create mode 100644 docs/api/sql/Parameter.zh.md
 create mode 100644 docs/api/sql/Raster-affine-transformation.zh.md
 create mode 100644 docs/api/sql/Raster-map-algebra.zh.md
 copy docs/api/sql/{Reading-legacy-parquet.md => Reading-legacy-parquet.zh.md} (76%)
 create mode 100644 docs/api/sql/Spider.zh.md
 create mode 100644 docs/api/sql/Visualization-SedonaKepler.zh.md
 create mode 100644 docs/api/sql/Visualization-SedonaPyDeck.zh.md
 create mode 100644 docs/api/stats/sql.zh.md
 copy docs/{tutorial/viz-gallery.md => api/viz/java-api.zh.md} (83%)
 create mode 100644 docs/api/viz/sql.zh.md
 copy docs/{api/flink/Bounding-Box-Functions/ST_XMin.md => asf/asf.zh.md} (70%)
 create mode 100644 docs/asf/telemetry.zh.md
 create mode 100644 docs/community/contact.zh.md
 copy docs/community/{contributor.md => contributor.zh.md} (70%)
 create mode 100644 docs/community/develop.zh.md
 create mode 100644 docs/community/geopandas.zh.md
 create mode 100644 docs/community/publication.zh.md
 copy docs/community/{publish.md => publish.zh.md} (75%)
 create mode 100644 docs/community/release-manager.zh.md
 create mode 100644 docs/community/rule.zh.md
 copy docs/community/{snapshot.md => snapshot.zh.md} (57%)
 copy docs/community/{vote.md => vote.zh.md} (59%)
 create mode 100644 docs/download.zh.md
 create mode 100644 docs/index.zh.md
 create mode 100644 docs/sedonaflink.zh.md
 copy docs/{sedonasnow.md => sedonasnow.zh.md} (50%)
 create mode 100644 docs/sedonaspark.zh.md
 copy docs/setup/{azure-synapse-analytics.md => azure-synapse-analytics.zh.md} (62%)
 create mode 100644 docs/setup/cluster.zh.md
 create mode 100644 docs/setup/compile.zh.md
 create mode 100644 docs/setup/databricks.zh.md
 create mode 100644 docs/setup/docker.zh.md
 copy docs/setup/{emr.md => emr.zh.md} (62%)
 create mode 100644 docs/setup/fabric.zh.md
 copy docs/setup/flink/{install-python.md => install-python.zh.md} (80%)
 create mode 100644 docs/setup/flink/install-scala.zh.md
 copy docs/setup/flink/{modules.md => modules.zh.md} (71%)
 copy docs/{api/snowflake/vector-data/Geometry-Constructors/ST_LineFromText.md => setup/flink/platform.zh.md} (76%)
 create mode 100644 docs/setup/glue.zh.md
 create mode 100644 docs/setup/install-python.zh.md
 create mode 100644 docs/setup/install-scala.zh.md
 copy docs/setup/{maven-coordinates.md => maven-coordinates.zh.md} (61%)
 copy docs/setup/{modules.md => modules.zh.md} (58%)
 create mode 100644 docs/setup/overview.zh.md
 copy docs/setup/{platform.md => platform.zh.md} (84%)
 create mode 100644 docs/setup/snowflake/install.zh.md
 copy docs/setup/snowflake/{modules.md => modules.zh.md} (71%)
 copy docs/setup/{wherobots.md => wherobots.zh.md} (58%)
 copy docs/setup/{zeppelin.md => zeppelin.zh.md} (51%)
 create mode 100644 docs/tutorial/Advanced-Tutorial-Tune-your-Application.zh.md
 copy docs/{api/flink/Geometry-Accessors/ST_M.md => tutorial/benchmark.zh.md} (71%)
 copy docs/tutorial/concepts/{clustering-algorithms.md => clustering-algorithms.zh.md} (56%)
 copy docs/tutorial/concepts/{distance-spark.md => distance-spark.zh.md} (51%)
 create mode 100644 docs/tutorial/concepts/spatial-joins.zh.md
 create mode 100644 docs/tutorial/demo.zh.md
 create mode 100644 docs/tutorial/files/csv-geometry-sedona-spark.zh.md
 copy docs/tutorial/files/{geojson-sedona-spark.md => geojson-sedona-spark.zh.md} (54%)
 copy docs/tutorial/files/{geopackage-sedona-spark.md => geopackage-sedona-spark.zh.md} (53%)
 create mode 100644 docs/tutorial/files/geoparquet-sedona-spark.zh.md
 create mode 100644 docs/tutorial/files/geotiffmetadata-sedona-spark.zh.md
 create mode 100644 docs/tutorial/files/shapefiles-sedona-spark.zh.md
 copy docs/tutorial/files/{stac-sedona-spark.md => stac-sedona-spark.zh.md} (55%)
 copy docs/tutorial/flink/{pyflink-sql.md => pyflink-sql.zh.md} (75%)
 copy docs/tutorial/flink/{sql.md => sql.zh.md} (61%)
 create mode 100644 docs/tutorial/geopandas-api.zh.md
 copy docs/tutorial/{geopandas-shapely.md => geopandas-shapely.zh.md} (81%)
 create mode 100644 docs/tutorial/jupyter-notebook.zh.md
 create mode 100644 docs/tutorial/raster.zh.md
 copy docs/tutorial/{rdd.md => rdd.zh.md} (53%)
 create mode 100644 docs/tutorial/snowflake/sql.zh.md
 copy docs/tutorial/{sql-pure-sql.md => sql-pure-sql.zh.md} (64%)
 copy docs/tutorial/{sql.md => sql.zh.md} (57%)
 create mode 100644 docs/tutorial/storing-blobs-in-parquet.zh.md
 copy docs/tutorial/{viz-gallery.md => viz-gallery.zh.md} (86%)
 create mode 100644 docs/tutorial/viz.zh.md
 create mode 100644 docs/tutorial/zeppelin.zh.md


(sedona) 08/12: [GH-2911] Translate Tutorial / Programming Guide (part 4) to Chinese (#2935)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 95030043bb0bb70d44f8351c131b7c0d14ab559d
Author: Jia Yu <ji...@apache.org>
AuthorDate: Fri May 8 11:06:32 2026 -0700

    [GH-2911] Translate Tutorial / Programming Guide (part 4) to Chinese (#2935)
    
    (cherry picked from commit 5f3af2097aac4b26bdb397d1be54e88bcdeee1bc)
---
 docs/tutorial/rdd.zh.md |  864 +++++++++++++++++++++++++++++
 docs/tutorial/sql.zh.md | 1414 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 2278 insertions(+)

diff --git a/docs/tutorial/rdd.zh.md b/docs/tutorial/rdd.zh.md
new file mode 100644
index 0000000000..28d2ee4e96
--- /dev/null
+++ b/docs/tutorial/rdd.zh.md
@@ -0,0 +1,864 @@
+<!--
+ 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.
+ -->
+
+本页介绍如何使用 Sedona-core 创建空间 RDD(SpatialRDD)并执行空间查询。
+
+## 配置依赖
+
+请参阅 [配置依赖](sql.md#set-up-dependencies) 进行依赖配置。
+
+## 创建 Sedona 配置
+
+请参阅 [创建 Sedona 配置](sql.md#create-sedona-config) 创建 Sedona 配置。
+
+## 初始化 SedonaContext
+
+请参阅 [初始化 SedonaContext](sql.md#initiate-sedonacontext) 初始化 SedonaContext。
+
+## 从 SedonaSQL DataFrame 创建 SpatialRDD
+
+请先按 [创建 Geometry 类型列](sql.md#create-a-geometry-type-column) 创建 Geometry 类型列,然后从 DataFrame 创建 SpatialRDD:
+
+=== "Scala"
+
+	```scala
+	var spatialRDD = StructuredAdapter.toSpatialRdd(spatialDf, "usacounty")
+	```
+
+=== "Java"
+
+	```java
+	SpatialRDD spatialRDD = StructuredAdapter.toSpatialRdd(spatialDf, "usacounty")
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import StructuredAdapter
+
+	spatialRDD = StructuredAdapter.toSpatialRdd(spatialDf, "usacounty")
+	```
+
+`"usacounty"` 是几何列的列名,可选参数。如果不提供,将使用第一个几何列。
+
+## 转换坐标参考系
+
+Sedona 不会自动管理 SpatialRDD 中所有几何对象的坐标单位(基于度还是基于米)。SedonaSQL 中所有相关距离的单位与 SpatialRDD 中几何对象的单位保持一致。
+
+自 `v1.5.0` 起,该函数默认使用 lon/lat 顺序(之前为 lat/lon 顺序)。可以使用 ==spatialRDD.flipCoordinates== 交换 X 与 Y。
+
+转换 SpatialRDD 的坐标参考系:
+
+=== "Scala"
+
+	```scala
+	val sourceCrsCode = "epsg:4326" // WGS84,最常见的基于度的 CRS
+	val targetCrsCode = "epsg:3857" // 最常见的基于米的 CRS
+	objectRDD.CRSTransform(sourceCrsCode, targetCrsCode, false)
+	```
+
+=== "Java"
+
+	```java
+	String sourceCrsCode = "epsg:4326" // WGS84,最常见的基于度的 CRS
+	String targetCrsCode = "epsg:3857" // 最常见的基于米的 CRS
+	objectRDD.CRSTransform(sourceCrsCode, targetCrsCode, false)
+	```
+
+=== "Python"
+
+	```python
+	sourceCrsCode = "epsg:4326" // WGS84,最常见的基于度的 CRS
+	targetCrsCode = "epsg:3857" // 最常见的基于米的 CRS
+	objectRDD.CRSTransform(sourceCrsCode, targetCrsCode, False)
+	```
+
+`CRSTransform(sourceCrsCode, targetCrsCode, false)` 的第三个参数为 `false` 表示不容忍 Datum shift;如果希望宽松处理,请改为 `true`。
+
+!!!warning
+	CRS 转换应在创建每个 SpatialRDD 之后立即进行,否则会导致查询结果错误。例如:
+
+=== "Scala"
+
+	```scala
+	val objectRDD = WktReader.readToGeometryRDD(sedona.sparkContext, inputLocation, wktColumn, allowTopologyInvalidGeometries, skipSyntaxInvalidGeometries)
+	objectRDD.CRSTransform("epsg:4326", "epsg:3857", false)
+	```
+
+=== "Java"
+
+	```java
+	SpatialRDD objectRDD = WktReader.readToGeometryRDD(sedona.sparkContext, inputLocation, wktColumn, allowTopologyInvalidGeometries, skipSyntaxInvalidGeometries)
+	objectRDD.CRSTransform("epsg:4326", "epsg:3857", false)
+	```
+
+=== "Python"
+
+	```python
+	objectRDD = WktReader.readToGeometryRDD(sedona.sparkContext, inputLocation, wktColumn, allowTopologyInvalidGeometries, skipSyntaxInvalidGeometries)
+	objectRDD.CRSTransform("epsg:4326", "epsg:3857", False)
+	```
+
+详细的 CRS 信息可在 [EPSG.io](https://epsg.io/) 查询。
+
+## 编写空间范围查询
+
+空间范围查询接收一个查询窗口与一个 SpatialRDD,返回与查询窗口满足指定关系的所有几何对象。
+
+假设您已经有一个 SpatialRDD(typed 或 generic),可以用以下代码执行空间范围查询。
+
+==spatialPredicate== 可以设置为 `SpatialPredicate.INTERSECTS`,返回与查询窗口相交的所有几何对象。支持的空间谓词包括:
+
+* `CONTAINS`:几何对象完全位于查询窗口内部
+* `INTERSECTS`:几何对象与查询窗口至少有一个公共点
+* `WITHIN`:几何对象完全位于查询窗口之内(不接触边)
+* `COVERS`:查询窗口的所有点都在几何对象上
+* `COVERED_BY`:几何对象的所有点都在查询窗口上
+* `OVERLAPS`:几何对象与查询窗口在空间上相互重叠
+* `CROSSES`:几何对象与查询窗口在空间上相交穿过
+* `TOUCHES`:几何对象与查询窗口仅在边界上有公共点
+* `EQUALS`:几何对象与查询窗口在空间上相等
+
+!!!note
+	空间范围查询等价于带空间谓词作为搜索条件的 SELECT。例如:
+	```sql
+	SELECT *
+	FROM checkin
+	WHERE ST_Intersects(checkin.location, queryWindow)
+	```
+
+=== "Scala"
+
+	```scala
+	val rangeQueryWindow = new Envelope(-90.01, -80.01, 30.01, 40.01)
+	val spatialPredicate = SpatialPredicate.COVERED_BY // 仅返回完全被窗口覆盖的几何对象
+	val usingIndex = false
+	var queryResult = RangeQuery.SpatialRangeQuery(spatialRDD, rangeQueryWindow, spatialPredicate, usingIndex)
+	```
+
+=== "Java"
+
+	```java
+	Envelope rangeQueryWindow = new Envelope(-90.01, -80.01, 30.01, 40.01)
+	SpatialPredicate spatialPredicate = SpatialPredicate.COVERED_BY // 仅返回完全被窗口覆盖的几何对象
+	boolean usingIndex = false
+	JavaRDD queryResult = RangeQuery.SpatialRangeQuery(spatialRDD, rangeQueryWindow, spatialPredicate, usingIndex)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import Envelope
+	from sedona.spark import RangeQuery
+
+	range_query_window = Envelope(-90.01, -80.01, 30.01, 40.01)
+	consider_boundary_intersection = False  ## 仅返回完全被窗口覆盖的几何对象
+	using_index = False
+	query_result = RangeQuery.SpatialRangeQuery(spatial_rdd, range_query_window, consider_boundary_intersection, using_index)
+	```
+
+!!!note
+    Sedona Python 用户:如果希望在转换为 Spatial DataFrame 时避免 jvm-python serde,请改用同一模块下的 `RangeQueryRaw`。其参数与 `RangeQuery` 相同,但返回的是 jvm rdd 引用,可由 Adapter 不经 Python-jvm serde 直接转换为 DataFrame。
+
+    示例:
+    ```python
+    from sedona.spark import Envelope
+    from sedona.spark import RangeQueryRaw
+    from sedona.spark import Adapter
+
+    range_query_window = Envelope(-90.01, -80.01, 30.01, 40.01)
+    consider_boundary_intersection = False  ## 仅返回完全被窗口覆盖的几何对象
+    using_index = False
+    query_result = RangeQueryRaw.SpatialRangeQuery(
+        spatial_rdd, range_query_window, consider_boundary_intersection, using_index
+    )
+    gdf = StructuredAdapter.toDf(query_result, spark, ["col1", ..., "coln"])
+    ```
+
+### 范围查询窗口
+
+除了矩形(Envelope)类型之外,Sedona 范围查询窗口还可以是 Point/Polygon/LineString。
+
+构造一个点、4 顶点折线、4 顶点多边形的代码如下:
+
+=== "Scala"
+
+	```scala
+	val geometryFactory = new GeometryFactory()
+	val pointObject = geometryFactory.createPoint(new Coordinate(-84.01, 34.01))
+
+	val geometryFactory = new GeometryFactory()
+	val coordinates = new Array[Coordinate](5)
+	coordinates(0) = new Coordinate(0,0)
+	coordinates(1) = new Coordinate(0,4)
+	coordinates(2) = new Coordinate(4,4)
+	coordinates(3) = new Coordinate(4,0)
+	coordinates(4) = coordinates(0) // 末尾坐标与首坐标相同以构成闭环
+	val polygonObject = geometryFactory.createPolygon(coordinates)
+
+	val geometryFactory = new GeometryFactory()
+	val coordinates = new Array[Coordinate](4)
+	coordinates(0) = new Coordinate(0,0)
+	coordinates(1) = new Coordinate(0,4)
+	coordinates(2) = new Coordinate(4,4)
+	coordinates(3) = new Coordinate(4,0)
+	val linestringObject = geometryFactory.createLineString(coordinates)
+	```
+
+=== "Java"
+
+	```java
+	GeometryFactory geometryFactory = new GeometryFactory()
+	Point pointObject = geometryFactory.createPoint(new Coordinate(-84.01, 34.01))
+
+	GeometryFactory geometryFactory = new GeometryFactory()
+	Coordinate[] coordinates = new Array[Coordinate](5)
+	coordinates(0) = new Coordinate(0,0)
+	coordinates(1) = new Coordinate(0,4)
+	coordinates(2) = new Coordinate(4,4)
+	coordinates(3) = new Coordinate(4,0)
+	coordinates(4) = coordinates(0) // 末尾坐标与首坐标相同以构成闭环
+	Polygon polygonObject = geometryFactory.createPolygon(coordinates)
+
+	GeometryFactory geometryFactory = new GeometryFactory()
+	val coordinates = new Array[Coordinate](4)
+	coordinates(0) = new Coordinate(0,0)
+	coordinates(1) = new Coordinate(0,4)
+	coordinates(2) = new Coordinate(4,4)
+	coordinates(3) = new Coordinate(4,0)
+	LineString linestringObject = geometryFactory.createLineString(coordinates)
+	```
+
+=== "Python"
+
+	可以将 Shapely 几何对象作为查询窗口。Shapely 几何对象的创建方法请参阅 [Shapely 官方文档](https://shapely.readthedocs.io/en/stable/manual.html)。
+
+### 使用空间索引
+
+Sedona 提供两种空间索引:Quad-Tree 与 R-Tree。指定索引类型后,Sedona 会在每个 SpatialRDD 分区上构建本地索引。
+
+在空间范围查询中使用空间索引:
+
+=== "Scala"
+
+	```scala
+	val rangeQueryWindow = new Envelope(-90.01, -80.01, 30.01, 40.01)
+	val spatialPredicate = SpatialPredicate.COVERED_BY // 仅返回完全被窗口覆盖的几何对象
+
+	val buildOnSpatialPartitionedRDD = false // 仅在执行 join 查询时设为 TRUE
+	spatialRDD.buildIndex(IndexType.QUADTREE, buildOnSpatialPartitionedRDD)
+
+	val usingIndex = true
+	var queryResult = RangeQuery.SpatialRangeQuery(spatialRDD, rangeQueryWindow, spatialPredicate, usingIndex)
+	```
+
+=== "Java"
+
+	```java
+	Envelope rangeQueryWindow = new Envelope(-90.01, -80.01, 30.01, 40.01)
+	SpatialPredicate spatialPredicate = SpatialPredicate.COVERED_BY // 仅返回完全被窗口覆盖的几何对象
+
+	boolean buildOnSpatialPartitionedRDD = false // 仅在执行 join 查询时设为 TRUE
+	spatialRDD.buildIndex(IndexType.QUADTREE, buildOnSpatialPartitionedRDD)
+
+	boolean usingIndex = true
+	JavaRDD queryResult = RangeQuery.SpatialRangeQuery(spatialRDD, rangeQueryWindow, spatialPredicate, usingIndex)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import Envelope
+	from sedona.spark import IndexType
+	from sedona.spark import RangeQuery
+
+	range_query_window = Envelope(-90.01, -80.01, 30.01, 40.01)
+	consider_boundary_intersection = False ## 仅返回完全被窗口覆盖的几何对象
+
+	build_on_spatial_partitioned_rdd = False ## 仅在执行 join 查询时设为 TRUE
+	spatial_rdd.buildIndex(IndexType.QUADTREE, build_on_spatial_partitioned_rdd)
+
+	using_index = True
+
+	query_result = RangeQuery.SpatialRangeQuery(
+	    spatial_rdd,
+	    range_query_window,
+	    consider_boundary_intersection,
+	    using_index
+	)
+	```
+
+!!!tip
+	不一定每次都使用索引,因为构建索引本身也会花时间。空间索引在数据为复杂多边形、折线时尤其有用。
+
+### 输出格式
+
+=== "Scala/Java"
+
+	空间范围查询的输出格式仍然是一个 SpatialRDD。
+
+=== "Python"
+
+	空间范围查询返回另一个 RDD,元素为 GeoData 对象。
+
+	`SpatialRangeQuery` 的结果可以像普通 Spark RDD 一样使用 `map` 等操作;通过 `collect` 收集后则成为 Python 对象列表。
+	示例:
+
+	```python
+	query_result.map(lambda x: x.geom.length).collect()
+	```
+
+	```
+	[
+	 1.5900840000000045,
+	 1.5906639999999896,
+	 1.1110299999999995,
+	 1.1096700000000084,
+	 1.1415619999999933,
+	 1.1386399999999952,
+	 1.1415619999999933,
+	 1.1418860000000137,
+	 1.1392780000000045,
+	 ...
+	]
+	```
+
+	也可以转换为 GeoPandas GeoDataFrame:
+
+	```python
+	import geopandas as gpd
+	gpd.GeoDataFrame(
+	    query_result.map(lambda x: [x.geom, x.userData]).collect(),
+	    columns=["geom", "user_data"],
+	    geometry="geom"
+	)
+	```
+
+## 编写空间 KNN 查询
+
+空间 K 最近邻(KNN)查询接收 K、查询点与一个 SpatialRDD,返回 RDD 中距查询点最近的 K 个几何对象。
+
+假设您已经有一个 SpatialRDD(typed 或 generic),可以用以下代码执行空间 KNN 查询:
+
+=== "Scala"
+
+	```scala
+	val geometryFactory = new GeometryFactory()
+	val pointObject = geometryFactory.createPoint(new Coordinate(-84.01, 34.01))
+	val K = 1000 // K 个最近邻
+	val usingIndex = false
+	val result = KNNQuery.SpatialKnnQuery(objectRDD, pointObject, K, usingIndex)
+	```
+
+=== "Java"
+
+	```java
+	GeometryFactory geometryFactory = new GeometryFactory()
+	Point pointObject = geometryFactory.createPoint(new Coordinate(-84.01, 34.01))
+	int K = 1000 // K 个最近邻
+	boolean usingIndex = false
+	JavaRDD result = KNNQuery.SpatialKnnQuery(objectRDD, pointObject, K, usingIndex)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import KNNQuery
+	from shapely.geometry import Point
+
+	point = Point(-84.01, 34.01)
+	k = 1000 ## K 个最近邻
+	using_index = False
+	result = KNNQuery.SpatialKnnQuery(object_rdd, point, k, using_index)
+	```
+
+!!!note
+	返回 5 个最近邻的空间 KNN 查询等价于以下 Spatial SQL:
+	```sql
+	SELECT ck.name, ck.rating, ST_Distance(ck.location, myLocation) AS distance
+	FROM checkins ck
+	ORDER BY distance DESC
+	LIMIT 5
+	```
+
+### 查询中心几何
+
+除了 Point,Sedona 的 KNN 查询中心也可以是 Polygon 与 LineString。
+
+=== "Scala/Java"
+
+	创建 Polygon 与 LineString 的方法见 [范围查询窗口](#range-query-window)。
+
+=== "Python"
+
+	创建 Polygon 或 LineString 请参阅 [Shapely 官方文档](https://shapely.readthedocs.io/en/stable/manual.html)。
+
+### 使用空间索引
+
+在空间 KNN 查询中使用空间索引:
+
+=== "Scala"
+
+	```scala
+	val geometryFactory = new GeometryFactory()
+	val pointObject = geometryFactory.createPoint(new Coordinate(-84.01, 34.01))
+	val K = 1000 // K 个最近邻
+
+
+	val buildOnSpatialPartitionedRDD = false // 仅在执行 join 查询时设为 TRUE
+	objectRDD.buildIndex(IndexType.RTREE, buildOnSpatialPartitionedRDD)
+
+	val usingIndex = true
+	val result = KNNQuery.SpatialKnnQuery(objectRDD, pointObject, K, usingIndex)
+	```
+
+=== "Java"
+
+	```java
+	GeometryFactory geometryFactory = new GeometryFactory()
+	Point pointObject = geometryFactory.createPoint(new Coordinate(-84.01, 34.01))
+	val K = 1000 // K 个最近邻
+
+
+	boolean buildOnSpatialPartitionedRDD = false // 仅在执行 join 查询时设为 TRUE
+	objectRDD.buildIndex(IndexType.RTREE, buildOnSpatialPartitionedRDD)
+
+	boolean usingIndex = true
+	JavaRDD result = KNNQuery.SpatialKnnQuery(objectRDD, pointObject, K, usingIndex)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import KNNQuery
+	from sedona.spark import IndexType
+	from shapely.geometry import Point
+
+	point = Point(-84.01, 34.01)
+	k = 5 ## K 个最近邻
+
+	build_on_spatial_partitioned_rdd = False ## 仅在执行 join 查询时设为 TRUE
+	spatial_rdd.buildIndex(IndexType.RTREE, build_on_spatial_partitioned_rdd)
+
+	using_index = True
+	result = KNNQuery.SpatialKnnQuery(spatial_rdd, point, k, using_index)
+	```
+
+!!!warning
+	空间 KNN 查询仅支持 R-Tree 索引。
+
+### 输出格式
+
+=== "Scala/Java"
+
+	空间 KNN 查询的输出格式是一个几何对象列表,列表中包含 K 个几何对象。
+
+=== "Python"
+
+	输出格式是 GeoData 对象列表,包含 K 个 GeoData 对象。
+
+	示例:
+	```python
+	>> result
+
+	[GeoData, GeoData, GeoData, GeoData, GeoData]
+	```
+
+## 编写空间连接查询
+
+空间连接查询接收两个 SpatialRDD A 与 B。对于 A 中的每个几何对象,从 B 中找出与之 covered/intersected 的几何对象。A 与 B 可以是任意几何类型,且类型不必相同。
+
+假设您已经有两个 SpatialRDD(typed 或 generic),可以用以下代码执行空间连接查询:
+
+=== "Scala"
+
+	```scala
+	val spatialPredicate = SpatialPredicate.COVERED_BY // 仅返回完全被 queryWindowRDD 中各窗口覆盖的几何对象
+	val usingIndex = false
+
+	objectRDD.analyze()
+
+	objectRDD.spatialPartitioning(GridType.KDBTREE)
+	queryWindowRDD.spatialPartitioning(objectRDD.getPartitioner)
+
+	val result = JoinQuery.SpatialJoinQuery(objectRDD, queryWindowRDD, usingIndex, spatialPredicate)
+	```
+
+=== "Java"
+
+	```java
+	SpatialPredicate spatialPredicate = SpatialPredicate.COVERED_BY // 仅返回完全被 queryWindowRDD 中各窗口覆盖的几何对象
+	val usingIndex = false
+
+	objectRDD.analyze()
+
+	objectRDD.spatialPartitioning(GridType.KDBTREE)
+	queryWindowRDD.spatialPartitioning(objectRDD.getPartitioner)
+
+	JavaPairRDD result = JoinQuery.SpatialJoinQuery(objectRDD, queryWindowRDD, usingIndex, spatialPredicate)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import GridType
+	from sedona.spark import JoinQuery
+
+	consider_boundary_intersection = False ## 仅返回完全被 queryWindowRDD 中各窗口覆盖的几何对象
+	using_index = False
+
+	object_rdd.analyze()
+
+	object_rdd.spatialPartitioning(GridType.KDBTREE)
+	query_window_rdd.spatialPartitioning(object_rdd.getPartitioner())
+
+	result = JoinQuery.SpatialJoinQuery(object_rdd, query_window_rdd, using_index, consider_boundary_intersection)
+	```
+
+!!!note
+	空间连接查询等价于以下 Spatial SQL:
+	```sql
+	SELECT superhero.name
+	FROM city, superhero
+	WHERE ST_Contains(city.geom, superhero.geom);
+	```
+	找出每座城市内的所有超级英雄。
+
+### 使用空间分区
+
+Sedona 的空间分区方法可以显著加速连接查询。可选的空间分区方式有 KDB-Tree、Quad-Tree 与 R-Tree。两个 SpatialRDD 必须使用相同方式分区。
+
+如果先对 A 分区,则必须使用 A 的分区器对 B 分区。
+
+=== "Scala/Java"
+
+	```scala
+	objectRDD.spatialPartitioning(GridType.KDBTREE)
+	queryWindowRDD.spatialPartitioning(objectRDD.getPartitioner)
+	```
+
+=== "Python"
+
+	```python
+	object_rdd.spatialPartitioning(GridType.KDBTREE)
+	query_window_rdd.spatialPartitioning(object_rdd.getPartitioner())
+	```
+
+或者:
+
+=== "Scala/Java"
+
+	```scala
+	queryWindowRDD.spatialPartitioning(GridType.KDBTREE)
+	objectRDD.spatialPartitioning(queryWindowRDD.getPartitioner)
+	```
+
+=== "Python"
+
+	```python
+	query_window_rdd.spatialPartitioning(GridType.KDBTREE)
+	object_rdd.spatialPartitioning(query_window_rdd.getPartitioner())
+	```
+
+### 使用空间索引
+
+在空间连接查询中使用空间索引:
+
+=== "Scala"
+
+	```scala
+	objectRDD.spatialPartitioning(joinQueryPartitioningType)
+	queryWindowRDD.spatialPartitioning(objectRDD.getPartitioner)
+
+	val buildOnSpatialPartitionedRDD = true // 仅在执行 join 查询时设为 TRUE
+	val usingIndex = true
+	queryWindowRDD.buildIndex(IndexType.QUADTREE, buildOnSpatialPartitionedRDD)
+
+	val result = JoinQuery.SpatialJoinQueryFlat(objectRDD, queryWindowRDD, usingIndex, spatialPredicate)
+	```
+
+=== "Java"
+
+	```java
+	objectRDD.spatialPartitioning(joinQueryPartitioningType)
+	queryWindowRDD.spatialPartitioning(objectRDD.getPartitioner)
+
+	boolean buildOnSpatialPartitionedRDD = true // 仅在执行 join 查询时设为 TRUE
+	boolean usingIndex = true
+	queryWindowRDD.buildIndex(IndexType.QUADTREE, buildOnSpatialPartitionedRDD)
+
+	JavaPairRDD result = JoinQuery.SpatialJoinQueryFlat(objectRDD, queryWindowRDD, usingIndex, spatialPredicate)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import GridType
+	from sedona.spark import IndexType
+	from sedona.spark import JoinQuery
+
+	object_rdd.spatialPartitioning(GridType.KDBTREE)
+	query_window_rdd.spatialPartitioning(object_rdd.getPartitioner())
+
+	build_on_spatial_partitioned_rdd = True ## 仅在执行 join 查询时设为 TRUE
+	using_index = True
+	query_window_rdd.buildIndex(IndexType.QUADTREE, build_on_spatial_partitioned_rdd)
+
+	result = JoinQuery.SpatialJoinQueryFlat(object_rdd, query_window_rdd, using_index, True)
+	```
+
+索引应当只在两个 SpatialRDD 中的一个上构建,一般建议在较大的那一个上构建。
+
+### 输出格式
+
+=== "Scala/Java"
+
+	空间连接查询的输出格式是一个 PairRDD,每个元素是一对几何对象:左侧来自 objectRDD,右侧来自 queryWindowRDD。
+
+	```
+	Point,Polygon
+	Point,Polygon
+	Point,Polygon
+	Polygon,Polygon
+	LineString,LineString
+	Polygon,LineString
+	...
+	```
+
+	左侧对象会被右侧对象 covered/intersected。
+
+=== "Python"
+
+	该查询的结果是一个 RDD,元素为长度为 2 的 GeoData 列表。
+	示例:
+	```python
+	result.collect()
+	```
+
+	```
+	[[GeoData, GeoData], [GeoData, GeoData] ...]
+	```
+
+	可以对结果做 RDD 操作,例如取多边形质心:
+	```python
+	result.map(lambda x: x[0].geom.centroid).collect()
+	```
+
+!!!note
+    Sedona Python 用户:以下方法建议使用同一模块下的 `JoinQueryRaw`:
+
+    - spatialJoin
+
+    - DistanceJoinQueryFlat
+
+    - SpatialJoinQueryFlat
+
+    通过 Adapter 转换 DataFrame 时性能更好。这种方式可以避免 Python 与 jvm 之间昂贵的序列化,使您直接操作 Python 对象而不是原生几何。
+
+    示例:
+    ```python
+    from sedona.spark import CircleRDD
+    from sedona.spark import GridType
+    from sedona.spark import JoinQueryRaw
+    from sedona.spark import StructuredAdapter
+
+    object_rdd.analyze()
+
+    circle_rdd = CircleRDD(object_rdd, 0.1)  ## 用给定距离创建 CircleRDD
+    circle_rdd.analyze()
+
+    circle_rdd.spatialPartitioning(GridType.KDBTREE)
+    spatial_rdd.spatialPartitioning(circle_rdd.getPartitioner())
+
+    consider_boundary_intersection = (
+        False  ## 仅返回完全被 queryWindowRDD 中各窗口覆盖的几何对象
+    )
+    using_index = False
+
+    result = JoinQueryRaw.DistanceJoinQueryFlat(
+        spatial_rdd, circle_rdd, using_index, consider_boundary_intersection
+    )
+
+    gdf = StructuredAdapter.toDf(
+        result, ["left_col1", ..., "lefcoln"], ["rightcol1", ..., "rightcol2"], spark
+    )
+    ```
+
+## 编写距离连接查询
+
+!!!warning
+	RDD 距离连接仅在点几何上稳定可靠。其他几何类型请使用 Spatial SQL。
+
+距离连接查询接收两个 SpatialRDD A、B 与一个距离参数。对 A 中每个几何对象,从 B 中找出与其距离不超过给定距离的几何对象。A 与 B 可以是任意几何类型,且类型不必相同。距离的单位说明见 [此处](#transform-the-coordinate-reference-system)。
+
+如果不希望转换数据,且可以接受查询精度的损失,可以使用近似的角度作为距离。可借助 [此换算工具](https://lucidar.me/en/online-unit-converter-length-to-angle/convert-degrees-to-meters/#online-converter)。
+
+假设您已经有两个 SpatialRDD(typed 或 generic),可以用以下代码执行距离连接查询:
+
+=== "Scala"
+
+	```scala
+	objectRddA.analyze()
+
+	val circleRDD = new CircleRDD(objectRddA, 0.1) // 用给定距离创建 CircleRDD
+
+	circleRDD.spatialPartitioning(GridType.KDBTREE)
+	objectRddB.spatialPartitioning(circleRDD.getPartitioner)
+
+	val spatialPredicate = SpatialPredicate.COVERED_BY // 仅返回完全被各查询窗口覆盖的几何对象
+	val usingIndex = false
+
+	val result = JoinQuery.DistanceJoinQueryFlat(objectRddB, circleRDD, usingIndex, spatialPredicate)
+	```
+
+=== "Java"
+
+	```java
+	objectRddA.analyze()
+
+	CircleRDD circleRDD = new CircleRDD(objectRddA, 0.1) // 用给定距离创建 CircleRDD
+
+	circleRDD.spatialPartitioning(GridType.KDBTREE)
+	objectRddB.spatialPartitioning(circleRDD.getPartitioner)
+
+	SpatialPredicate spatialPredicate = SpatialPredicate.COVERED_BY // 仅返回完全被各查询窗口覆盖的几何对象
+	boolean usingIndex = false
+
+	JavaPairRDD result = JoinQuery.DistanceJoinQueryFlat(objectRddB, circleRDD, usingIndex, spatialPredicate)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import CircleRDD
+	from sedona.spark import GridType
+	from sedona.spark import JoinQuery
+
+	object_rdd.analyze()
+
+	circle_rdd = CircleRDD(object_rdd, 0.1) ## 用给定距离创建 CircleRDD
+	circle_rdd.analyze()
+
+	circle_rdd.spatialPartitioning(GridType.KDBTREE)
+	spatial_rdd.spatialPartitioning(circle_rdd.getPartitioner())
+
+	consider_boundary_intersection = False ## 仅返回完全被各查询窗口覆盖的几何对象
+	using_index = False
+
+	result = JoinQuery.DistanceJoinQueryFlat(spatial_rdd, circle_rdd, using_index, consider_boundary_intersection)
+	```
+
+距离连接仅支持 `COVERED_BY` 与 `INTERSECTS` 两种空间谓词。其他部分与空间连接查询相同。
+
+空间分区的细节见 [此处](#use-spatial-partitioning)。
+
+在连接查询中使用空间索引的细节见 [此处](#use-spatial-indexes_2)。
+
+距离连接查询的输出格式见 [此处](#output-format_2)。
+
+!!!note
+	距离连接查询等价于以下 Spatial SQL:
+	```sql
+	SELECT superhero.name
+	FROM city, superhero
+	WHERE ST_Distance(city.geom, superhero.geom) <= 10;
+	```
+	找出与每座城市相距不超过 10 英里的超级英雄。
+
+## 保存到永久存储
+
+可以随时把 SpatialRDD 写回到 HDFS、Amazon S3 等永久存储。
+
+### 保存 SpatialRDD(未建索引)
+
+把 SpatialRDD 保存为分布式 object file:
+
+=== "Scala/Java"
+
+	```scala
+	objectRDD.rawSpatialRDD.saveAsObjectFile("hdfs://PATH")
+	```
+
+=== "Python"
+
+	```python
+	object_rdd.rawJvmSpatialRDD.saveAsObjectFile("hdfs://PATH")
+	```
+
+!!!note
+	分布式 object file 中的每个对象都是字节数组(不可读)。这是 Geometry 或 SpatialIndex 的序列化格式。
+
+### 保存 SpatialRDD(已建索引)
+
+已建索引的 typed SpatialRDD 与 generic SpatialRDD 都可以保存到永久存储,但已建索引的 SpatialRDD 必须保存为分布式 object file。
+
+```
+objectRDD.indexedRawRDD.saveAsObjectFile("hdfs://PATH")
+```
+
+### 保存 SpatialRDD(已分区,未建索引)
+
+经过空间分区的 RDD 可以保存到永久存储,但 Spark 无法保留原 RDD 的分区 ID。这会导致 join 查询结果错误,相关解决方案仍在开发中,敬请关注!
+
+### 重新加载已保存的 SpatialRDD
+
+您可以轻松重新加载保存为==分布式 object file==的 SpatialRDD:
+
+=== "Scala"
+
+	```scala
+	var savedRDD = new SpatialRDD[Geometry]
+	savedRDD.rawSpatialRDD = sc.objectFile[Geometry]("hdfs://PATH")
+	```
+
+=== "Java"
+
+	```java
+	SpatialRDD savedRDD = new SpatialRDD<Geometry>
+	savedRDD.rawSpatialRDD = sc.objectFile<Geometry>("hdfs://PATH")
+	```
+
+=== "Python"
+
+	```python
+	saved_rdd = load_spatial_rdd_from_disc(sc, "hdfs://PATH", GeoType.GEOMETRY)
+	```
+
+重新加载已建索引的 SpatialRDD:
+
+=== "Scala"
+
+	```scala
+	var savedRDD = new SpatialRDD[Geometry]
+	savedRDD.indexedRawRDD = sc.objectFile[SpatialIndex]("hdfs://PATH")
+	```
+
+=== "Java"
+
+	```java
+	SpatialRDD savedRDD = new SpatialRDD<Geometry>
+	savedRDD.indexedRawRDD = sc.objectFile<SpatialIndex>("hdfs://PATH")
+	```
+
+=== "Python"
+
+	```python
+	saved_rdd = SpatialRDD()
+	saved_rdd.indexedRawRDD = load_spatial_index_rdd_from_disc(sc, "hdfs://PATH")
+	```
diff --git a/docs/tutorial/sql.zh.md b/docs/tutorial/sql.zh.md
new file mode 100644
index 0000000000..2bbf8b5af2
--- /dev/null
+++ b/docs/tutorial/sql.zh.md
@@ -0,0 +1,1414 @@
+<!--
+ 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.
+ -->
+
+本页介绍如何使用 SedonaSQL 管理空间数据。
+
+!!!note
+    Sedona 假定地理坐标按 lon/lat 顺序排列。如果您的数据是 lat/lon 顺序,请使用 `ST_FlipCoordinates` 交换 X 与 Y。
+
+SedonaSQL 支持 SQL/MM Part3 空间 SQL 标准,提供四类 SQL 算子,所有算子都可以直接通过以下方式调用:
+
+=== "Scala"
+
+	```scala
+	var myDataFrame = sedona.sql("YOUR_SQL")
+	myDataFrame.createOrReplaceTempView("spatialDf")
+	```
+
+=== "Java"
+
+	```java
+	Dataset<Row> myDataFrame = sedona.sql("YOUR_SQL")
+	myDataFrame.createOrReplaceTempView("spatialDf")
+	```
+
+=== "Python"
+
+	```python
+	myDataFrame = sedona.sql("YOUR_SQL")
+	myDataFrame.createOrReplaceTempView("spatialDf")
+	```
+
+SedonaSQL 详细 API 说明请参阅 [SedonaSQL API](../api/sql/Overview.md)。示例 county 数据(即 `county_small.tsv`)可在 [Sedona GitHub 仓库](https://github.com/apache/sedona/tree/master/spark/common/src/test/resources) 找到。
+
+## 配置依赖
+
+=== "Scala/Java"
+
+	1. 阅读 [Sedona Maven Central 坐标](../setup/maven-coordinates.md) 并在 build.sbt 或 pom.xml 中添加 Sedona 依赖。
+	2. 在 build.sbt 或 pom.xml 中添加 [Apache Spark core](https://mvnrepository.com/artifact/org.apache.spark/spark-core_2.11) 与 [Apache SparkSQL](https://mvnrepository.com/artifact/org.apache.spark/spark-sql) 依赖。
+	3. 参考 [SQL 示例项目](demo.md)。
+
+=== "Python"
+
+	1. 请阅读 [快速开始](../setup/install-python.md) 安装 Sedona Python。
+	2. 本教程基于 [Sedona SQL Jupyter Notebook 示例](jupyter-notebook.md)。
+
+## 创建 Sedona 配置
+
+在程序起始处使用以下代码创建 Sedona 配置。如果您已经有了由 AWS EMR / Databricks / Microsoft Fabric 创建的 SparkSession(通常名为 `spark`),请==跳过此步骤==。
+
+可以在 builder 中追加额外的 Spark 运行时配置,例如 `SedonaContext.builder().config("spark.sql.autoBroadcastJoinThreshold", "10485760")`。
+
+=== "Scala"
+
+	```scala
+	import org.apache.sedona.spark.SedonaContext
+
+	val config = SedonaContext.builder()
+	.master("local[*]") // 集群模式下请删除此行
+	.appName("readTestScala") // 改成合适的名字
+	.getOrCreate()
+	```
+	如果同时使用 SedonaViz 与 SedonaSQL,请在 `SedonaContext.builder()` 之后追加以下行启用 Sedona Kryo 序列化器:
+	```scala
+	.config("spark.kryo.registrator", classOf[SedonaVizKryoRegistrator].getName) // org.apache.sedona.viz.core.Serde.SedonaVizKryoRegistrator
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.sedona.spark.SedonaContext;
+
+	SparkSession config = SedonaContext.builder()
+	.master("local[*]") // 集群模式下请删除此行
+	.appName("readTestJava") // 改成合适的名字
+	.getOrCreate()
+	```
+	如果同时使用 SedonaViz 与 SedonaSQL,请在 `SedonaContext.builder()` 之后追加以下行启用 Sedona Kryo 序列化器:
+	```java
+	.config("spark.kryo.registrator", SedonaVizKryoRegistrator.class.getName()) // org.apache.sedona.viz.core.Serde.SedonaVizKryoRegistrator
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import *
+
+	config = SedonaContext.builder() .\
+	    config('spark.jars.packages',
+	           'org.apache.sedona:sedona-spark-shaded-3.3_2.12:{{ sedona.current_version }},'
+	           'org.datasyslab:geotools-wrapper:{{ sedona.current_geotools }}'). \
+	    getOrCreate()
+	```
+    如使用其他 Spark 版本,请将 sedona-spark-shaded 包名中的 `3.3` 替换为对应的 Spark major.minor 版本,例如 `sedona-spark-shaded-3.4_2.12:{{ sedona.current_version }}`。
+
+## 初始化 SedonaContext
+
+在创建 Sedona 配置之后加上以下代码。如果您已经有了由 AWS EMR / Databricks / Microsoft Fabric 创建的 SparkSession(通常名为 `spark`),请改为调用 `sedona = SedonaContext.create(spark)`。
+
+=== "Scala"
+
+	```scala
+	import org.apache.sedona.spark.SedonaContext
+
+	val sedona = SedonaContext.create(config)
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.sedona.spark.SedonaContext;
+
+	SparkSession sedona = SedonaContext.create(config)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import *
+
+	sedona = SedonaContext.create(config)
+	```
+
+也可以通过在 `spark-submit` 或 `spark-shell` 中传入 `--conf spark.sql.extensions=org.apache.sedona.sql.SedonaSqlExtensions` 完成注册。
+
+## 从文本文件加载数据
+
+假设有一个 WKT 文件 `usa-county.tsv`,路径为 `/Download/usa-county.tsv`,内容如下:
+
+```
+POLYGON (..., ...)	Cuming County
+POLYGON (..., ...)	Wahkiakum County
+POLYGON (..., ...)	De Baca County
+POLYGON (..., ...)	Lancaster County
+```
+
+文件中可能还有许多其他列。
+
+### 加载原始 DataFrame
+
+使用以下代码加载数据并创建原始 DataFrame:
+
+=== "Scala"
+	```scala
+	var rawDf = sedona.read.format("csv").option("delimiter", "\t").option("header", "false").load("/Download/usa-county.tsv")
+	rawDf.createOrReplaceTempView("rawdf")
+	rawDf.show()
+	```
+
+=== "Java"
+	```java
+	Dataset<Row> rawDf = sedona.read.format("csv").option("delimiter", "\t").option("header", "false").load("/Download/usa-county.tsv")
+	rawDf.createOrReplaceTempView("rawdf")
+	rawDf.show()
+	```
+
+=== "Python"
+	```python
+	rawDf = sedona.read.format("csv").option("delimiter", "\t").option("header", "false").load("/Download/usa-county.tsv")
+	rawDf.createOrReplaceTempView("rawdf")
+	rawDf.show()
+	```
+
+输出大致如下:
+
+```
+|                 _c0|_c1|_c2|     _c3|  _c4|        _c5|                 _c6|_c7|_c8|  _c9|_c10| _c11|_c12|_c13|      _c14|    _c15|       _c16|        _c17|
++--------------------+---+---+--------+-----+-----------+--------------------+---+---+-----+----+-----+----+----+----------+--------+-----------+------------+
+|POLYGON ((-97.019...| 31|039|00835841|31039|     Cuming|       Cuming County| 06| H1|G4020|null| null|null|   A|1477895811|10447360|+41.9158651|-096.7885168|
+|POLYGON ((-123.43...| 53|069|01513275|53069|  Wahkiakum|    Wahkiakum County| 06| H1|G4020|null| null|null|   A| 682138871|61658258|+46.2946377|-123.4244583|
+|POLYGON ((-104.56...| 35|011|00933054|35011|    De Baca|      De Baca County| 06| H1|G4020|null| null|null|   A|6015539696|29159492|+34.3592729|-104.3686961|
+|POLYGON ((-96.910...| 31|109|00835876|31109|  Lancaster|    Lancaster County| 06| H1|G4020| 339|30700|null|   A|2169240202|22877180|+40.7835474|-096.6886584|
+```
+
+### 创建 Geometry 类型列
+
+SedonaSQL 中所有几何运算都作用在 Geometry 类型对象上。因此在执行任何查询之前,需要在 DataFrame 上构造一列 Geometry 类型列。
+
+```sql
+SELECT ST_GeomFromWKT(_c0) AS countyshape, _c1, _c2
+```
+
+可以选取更多属性来组成这个 `spatialdDf`。输出大致如下:
+
+```
+|                 countyshape|_c1|_c2|     _c3|  _c4|        _c5|                 _c6|_c7|_c8|  _c9|_c10| _c11|_c12|_c13|      _c14|    _c15|       _c16|        _c17|
++--------------------+---+---+--------+-----+-----------+--------------------+---+---+-----+----+-----+----+----+----------+--------+-----------+------------+
+|POLYGON ((-97.019...| 31|039|00835841|31039|     Cuming|       Cuming County| 06| H1|G4020|null| null|null|   A|1477895811|10447360|+41.9158651|-096.7885168|
+|POLYGON ((-123.43...| 53|069|01513275|53069|  Wahkiakum|    Wahkiakum County| 06| H1|G4020|null| null|null|   A| 682138871|61658258|+46.2946377|-123.4244583|
+|POLYGON ((-104.56...| 35|011|00933054|35011|    De Baca|      De Baca County| 06| H1|G4020|null| null|null|   A|6015539696|29159492|+34.3592729|-104.3686961|
+|POLYGON ((-96.910...| 31|109|00835876|31109|  Lancaster|    Lancaster County| 06| H1|G4020| 339|30700|null|   A|2169240202|22877180|+40.7835474|-096.6886584|
+```
+
+虽然外观与输入一致,但 `countyshape` 列的类型已经变为 ==Geometry==。
+
+可以通过打印 schema 进行验证:
+
+```scala
+spatialDf.printSchema()
+```
+
+输出如下:
+
+```
+root
+ |-- countyshape: geometry (nullable = false)
+ |-- _c1: string (nullable = true)
+ |-- _c2: string (nullable = true)
+ |-- _c3: string (nullable = true)
+ |-- _c4: string (nullable = true)
+ |-- _c5: string (nullable = true)
+ |-- _c6: string (nullable = true)
+ |-- _c7: string (nullable = true)
+```
+
+!!!note
+	SedonaSQL 提供了大量构造 Geometry 列的函数,详见 [SedonaSQL 构造器 API](../api/sql/Geometry-Functions.md)。
+
+## 加载 GeoJSON 数据
+
+自 `v1.6.1` 起,Sedona 支持通过 `geojson` 数据源读取 GeoJSON 文件。它专门用于处理几何对象采用 [GeoJSON 格式](https://datatracker.ietf.org/doc/html/rfc7946) 的 JSON 文件。
+
+读取多行 GeoJSON 文件请将 `multiLine` 选项设为 `True`。
+
+=== "Python"
+
+    ```python
+    df = (
+        sedona.read.format("geojson")
+        .option("multiLine", "true")
+        .load("PATH/TO/MYFILE.json")
+        .selectExpr("explode(features) as features")  # 展开 envelope
+        .select("features.*")  # 解包 features 结构体
+        .withColumn("prop0", f.expr("properties['prop0']"))
+        .drop("properties")
+        .drop("type")
+    )
+
+    df.show()
+    df.printSchema()
+    ```
+
+=== "Scala"
+
+    ```scala
+    val df = sedona.read.format("geojson").option("multiLine", "true").load("PATH/TO/MYFILE.json")
+    val parsedDf = df.selectExpr("explode(features) as features").select("features.*")
+            .withColumn("prop0", expr("properties['prop0']")).drop("properties").drop("type")
+
+    parsedDf.show()
+    parsedDf.printSchema()
+    ```
+
+=== "Java"
+
+    ```java
+    Dataset<Row> df = sedona.read.format("geojson").option("multiLine", "true").load("PATH/TO/MYFILE.json")
+     .selectExpr("explode(features) as features") // 展开 envelope,每行一个 feature
+     .select("features.*") // 解包 features 结构体
+     .withColumn("prop0", expr("properties['prop0']")).drop("properties").drop("type")
+
+    df.show();
+    df.printSchema();
+    ```
+
+加载 GeoJSON 文件的更多信息请参阅 [此页](files/geojson-sedona-spark.md)。
+
+## 加载 Shapefile
+
+自 v`1.7.0` 起,Sedona 支持把 Shapefile 加载为 DataFrame。
+
+=== "Scala/Java"
+
+    ```scala
+    val df = sedona.read.format("shapefile").load("/path/to/shapefile")
+    ```
+
+=== "Java"
+
+    ```java
+    Dataset<Row> df = sedona.read().format("shapefile").load("/path/to/shapefile")
+    ```
+
+=== "Python"
+
+    ```python
+    df = sedona.read.format("shapefile").load("/path/to/shapefile")
+    ```
+
+输入路径既可以是包含一个或多个 Shapefile 的目录,也可以是 `.shp` 文件本身。
+
+加载 Shapefile 的更多信息请参阅 [此页](files/shapefiles-sedona-spark.md)。
+
+## 加载 GeoParquet
+
+自 v`1.3.0` 起,Sedona 原生支持加载 GeoParquet 文件。Sedona 会通过 GeoParquet 文件中的 “geo” 元数据推断几何字段。
+
+=== "Scala/Java"
+
+	```scala
+	val df = sedona.read.format("geoparquet").load(geoparquetdatalocation1)
+	df.printSchema()
+	```
+
+=== "Java"
+
+	```java
+	Dataset<Row> df = sedona.read.format("geoparquet").load(geoparquetdatalocation1)
+	df.printSchema()
+	```
+
+=== "Python"
+
+	```python
+	df = sedona.read.format("geoparquet").load(geoparquetdatalocation1)
+	df.printSchema()
+	```
+
+输出如下:
+
+```
+root
+ |-- pop_est: long (nullable = true)
+ |-- continent: string (nullable = true)
+ |-- name: string (nullable = true)
+ |-- iso_a3: string (nullable = true)
+ |-- gdp_md_est: double (nullable = true)
+ |-- geometry: geometry (nullable = true)
+```
+
+Sedona 支持 GeoParquet 文件的空间谓词下推,详见 [SedonaSQL 查询优化器](../api/sql/Optimizer.md) 文档。
+
+GeoParquet 文件读取器也可用于读取 Apache Sedona 1.3.1-incubating 及更早版本写出的旧版 Parquet 文件,详见 [读取旧版 Parquet 文件](../api/sql/Reading-legacy-parquet.md)。
+
+加载 GeoParquet 的更多信息请参阅 [此页](files/geoparquet-sedona-spark.md)。
+
+## 从 STAC catalog 加载数据
+
+Sedona 的 STAC 数据源允许从 SpatioTemporal Asset Catalog(STAC)API 读取数据,支持读取 STAC items 与 collections。
+
+可以从 S3 上的 collection 文件加载 STAC collection:
+
+```python
+df = sedona.read.format("stac").load(
+    "s3a://example.com/stac_bucket/stac_collection.json"
+)
+```
+
+也可以从 HTTP/HTTPS 端点加载:
+
+```python
+df = sedona.read.format("stac").load(
+    "https://earth-search.aws.element84.com/v1/collections/sentinel-2-pre-c1-l2a"
+)
+```
+
+STAC 数据源支持空间和时间过滤的下推,可以将这些过滤直接下推到底层数据源以减少需要读取的数据量。
+
+加载 STAC 数据的更多信息请参阅 [此页](files/stac-sedona-spark.md)。
+
+## 从 JDBC 数据源加载数据
+
+可以使用 Spark SQL JDBC 数据源的 'query' 选项把几何列转换成 Sedona 能识别的格式。该方式适用于大多数支持空间的 JDBC 数据源。Postgis 由于使用 EWKB 作为其传输格式,无需添加查询进行类型转换。
+
+=== "Scala"
+
+	```scala
+	// 适用于任意 JDBC 数据源(包括 Postgis)
+	val df = sedona.read.format("jdbc")
+		// 其他选项
+		.option("query", "SELECT id, ST_AsBinary(geom) as geom FROM my_table")
+		.load()
+		.withColumn("geom", expr("ST_GeomFromWKB(geom)"))
+
+	// Postgis 上的简化写法
+	val df = sedona.read.format("jdbc")
+		// 其他选项
+		.option("dbtable", "my_table")
+		.load()
+		.withColumn("geom", expr("ST_GeomFromWKB(geom)"))
+	```
+
+=== "Java"
+
+	```java
+	// 适用于任意 JDBC 数据源(包括 Postgis)
+	Dataset<Row> df = sedona.read().format("jdbc")
+		// 其他选项
+		.option("query", "SELECT id, ST_AsBinary(geom) as geom FROM my_table")
+		.load()
+		.withColumn("geom", expr("ST_GeomFromWKB(geom)"))
+
+	// Postgis 上的简化写法
+	Dataset<Row> df = sedona.read().format("jdbc")
+		// 其他选项
+		.option("dbtable", "my_table")
+		.load()
+		.withColumn("geom", expr("ST_GeomFromWKB(geom)"))
+	```
+
+=== "Python"
+
+	```python
+	# 适用于任意 JDBC 数据源(包括 Postgis)
+	df = (sedona.read.format("jdbc")
+		# 其他选项
+		.option("query", "SELECT id, ST_AsBinary(geom) as geom FROM my_table")
+		.load()
+		.withColumn("geom", f.expr("ST_GeomFromWKB(geom)")))
+
+	# Postgis 上的简化写法
+	df = (sedona.read.format("jdbc")
+		# 其他选项
+		.option("dbtable", "my_table")
+		.load()
+		.withColumn("geom", f.expr("ST_GeomFromWKB(geom)")))
+	```
+
+## 加载 GeoPackage
+
+自 v1.7.0 起,Sedona 支持把 GeoPackage 文件加载为 DataFrame。
+
+=== "Scala/Java"
+
+	```scala
+	val df = sedona.read.format("geopackage").option("tableName", "tab").load("/path/to/geopackage")
+	```
+
+=== "Java"
+
+	```java
+	Dataset<Row> df = sedona.read().format("geopackage").option("tableName", "tab").load("/path/to/geopackage")
+	```
+
+=== "Python"
+
+	```python
+	df = sedona.read.format("geopackage").option("tableName", "tab").load("/path/to/geopackage")
+	```
+
+加载 GeoPackage 的更多信息请参阅 [此页](files/geopackage-sedona-spark.md)。
+
+## 加载 OSM PBF
+
+自 v1.7.1 起,Sedona 支持把 OSM PBF 文件加载为 DataFrame。
+
+=== "Scala/Java"
+
+	```scala
+	val df = sedona.read.format("osmpbf").load("/path/to/osmpbf")
+	```
+
+=== "Java"
+
+	```java
+	Dataset<Row> df = sedona.read().format("osmpbf").load("/path/to/osmpbf")
+	```
+
+=== "Python"
+
+	```python
+	df = sedona.read.format("osmpbf").load("/path/to/osmpbf")
+	```
+
+OSM PBF 文件可以包含 nodes、ways 与 relations。Sedona 目前支持 Nodes、DenseNodes、Ways 与 Relations。加载后的 DataFrame schema 如下:
+
+```
+root
+ |-- id: long (nullable = true)
+ |-- kind: string (nullable = true)
+ |-- location: struct (nullable = true)
+ |    |-- longitude: double (nullable = true)
+ |    |-- latitude: double (nullable = true)
+ |-- tags: map (nullable = true)
+ |    |-- key: string
+ |    |-- value: string (valueContainsNull = true)
+ |-- refs: array (nullable = true)
+ |    |-- element: long (containsNull = true)
+ |-- ref_roles: array (nullable = true)
+ |    |-- element: string (containsNull = true)
+ |-- ref_types: array (nullable = true)
+ |    |-- element: string (containsNull = true)
+```
+
+各字段含义:
+
+- `id`:对象的唯一标识。
+- `kind`:对象类型,可能为 `node`、`way` 或 `relation`。
+- `location`:对象的位置,包含 `longitude` 与 `latitude`。
+- `tags`:键值对的 map,表示对象的 tags。
+- `refs`:对象引用的数组。
+- `ref_roles`:引用对应的角色数组。
+- `ref_types`:引用对应的类型数组。
+
+nodes 的 DataFrame 大致如下:
+
+```
++---------+----+--------------------+--------------------+----+---------+---------+
+|       id|kind|            location|                tags|refs|ref_roles|ref_types|
++---------+----+--------------------+--------------------+----+---------+---------+
+|248675410|node|{21.0884952545166...|{tactile_paving -...|NULL|     NULL|     NULL|
+|260821820|node|{21.0191555023193...|{created_by -> JOSM}|NULL|     NULL|     NULL|
+|349189665|node|{22.1437530517578...|{source -> http:/...|NULL|     NULL|     NULL|
+|353366899|node|{22.9787712097167...|{source -> http:/...|NULL|     NULL|     NULL|
+|359460224|node|{22.4816703796386...|{source -> http:/...|NULL|     NULL|     NULL|
++---------+----+--------------------+--------------------+----+---------+---------+
+only showing top 5 rows
+```
+
+ways 的大致样子:
+
+```
++-------+----+--------+--------------------+--------------------+---------+---------+
+|     id|kind|location|                tags|                refs|ref_roles|ref_types|
++-------+----+--------+--------------------+--------------------+---------+---------+
+|4307329| way|    NULL|{junction -> roun...|[2448759046, 7093...|     NULL|     NULL|
+|4307330| way|    NULL|{surface -> aspha...|[26063923, 260639...|     NULL|     NULL|
+|4308966| way|    NULL|{sidewalk -> sepa...|[3387797238, 9252...|     NULL|     NULL|
+|4308968| way|    NULL|{surface -> pavin...|[26083890, 744724...|     NULL|     NULL|
+|4308969| way|    NULL|{cycleway:both ->...|[9526831176, 1218...|     NULL|     NULL|
++-------+----+--------+--------------------+--------------------+---------+---------+
+```
+
+relations 的大致样子:
+
+```
++-----+--------+--------+--------------------+--------------------+--------------------+--------------------+
+|   id|    kind|location|                tags|                refs|           ref_roles|           ref_types|
++-----+--------+--------+--------------------+--------------------+--------------------+--------------------+
+|28124|relation|    NULL|{official_name ->...|[26382394, 26259985]|      [inner, outer]|          [WAY, WAY]|
+|28488|relation|    NULL|  {type -> junction}|[26409253, 303249...|[roundabout, roun...|[WAY, WAY, WAY, WAY]|
+|32939|relation|    NULL|{ref -> E 67, rou...|[140673970, 14067...|        [, , , , , ]|[WAY, WAY, RELATI...|
+|34387|relation|    NULL|{note -> rząd III...|[209161000, 52154...|[main_stream, mai...|[WAY, WAY, WAY, W...|
+|34392|relation|    NULL|{distance -> 1047...|[150033976, 25076...|[main_stream, mai...|[WAY, WAY, WAY, W...|
++-----+--------+--------+--------------------+--------------------+--------------------+--------------------+
+```
+
+## 转换坐标参考系
+
+Sedona 不会自动管理一列 Geometry 中所有几何对象的坐标单位(基于度还是基于米)。SedonaSQL 中所有相关距离的单位与 Geometry 列中几何对象的单位保持一致。
+
+自 `v1.5.0` 起,该函数默认使用 lon/lat 顺序(之前为 lat/lon 顺序)。可以使用 ==ST_FlipCoordinates== 交换 X 与 Y。
+
+更多细节请参阅 Sedona API 参考中的 `ST_Transform` 章节。
+
+转换前述 Geometry 列的坐标参考系:
+
+```sql
+SELECT ST_Transform(countyshape, "epsg:4326", "epsg:3857") AS newcountyshape, _c1, _c2, _c3, _c4, _c5, _c6, _c7
+FROM spatialdf
+```
+
+`ST_Transform` 第一个 EPSG 代码 EPSG:4326 是源 CRS——也就是最常见的基于度的 CRS(WGS84)。
+
+第二个 EPSG 代码 EPSG:3857 是目标 CRS——最常见的基于米的 CRS。
+
+`ST_Transform` 会把这些几何对象的 CRS 从 EPSG:4326 转换到 EPSG:3857。详细 CRS 信息可在 [EPSG.io](https://epsg.io/) 找到。
+
+多边形坐标已发生变化。输出大致如下:
+
+```
++--------------------+---+---+--------+-----+-----------+--------------------+---+
+|      newcountyshape|_c1|_c2|     _c3|  _c4|        _c5|                 _c6|_c7|
++--------------------+---+---+--------+-----+-----------+--------------------+---+
+|POLYGON ((-108001...| 31|039|00835841|31039|     Cuming|       Cuming County| 06|
+|POLYGON ((-137408...| 53|069|01513275|53069|  Wahkiakum|    Wahkiakum County| 06|
+|POLYGON ((-116403...| 35|011|00933054|35011|    De Baca|      De Baca County| 06|
+|POLYGON ((-107880...| 31|109|00835876|31109|  Lancaster|    Lancaster County| 06|
+
+```
+
+## 使用 DBSCAN 进行聚类
+
+Sedona 提供 [DBSCAN](https://en.wikipedia.org/wiki/Dbscan) 算法的实现,用于对空间数据进行聚类。
+
+该算法以 Scala 与 Python 函数的形式提供,作用在空间 DataFrame 上。返回的 DataFrame 中会增加两列:所属簇的唯一标识,以及一个表示该记录是否为核心点的布尔列。
+
+第一个参数是 DataFrame,后两个是 DBSCAN 的 epsilon 与 min_points 参数。
+
+=== "Scala"
+
+	```scala
+	import org.apache.sedona.stats.clustering.DBSCAN.dbscan
+
+	dbscan(df, 0.1, 5).show()
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.sedona.stats.clustering.DBSCAN;
+
+	DBSCAN.dbscan(df, 0.1, 5).show();
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark.stats import dbscan
+
+	dbscan(df, 0.1, 5).show()
+	```
+
+输出大致如下:
+
+```
++----------------+---+------+-------+
+|        geometry| id|isCore|cluster|
++----------------+---+------+-------+
+|   POINT (2.5 4)|  3| false|      1|
+|     POINT (3 4)|  2| false|      1|
+|     POINT (3 5)|  5| false|      1|
+|     POINT (1 3)|  9|  true|      0|
+| POINT (2.5 4.5)|  7|  true|      1|
+|     POINT (1 2)|  1|  true|      0|
+| POINT (1.5 2.5)|  4|  true|      0|
+| POINT (1.2 2.5)|  8|  true|      0|
+|   POINT (1 2.5)| 11|  true|      0|
+|     POINT (1 5)| 10| false|     -1|
+|     POINT (5 6)| 12| false|     -1|
+|POINT (12.8 4.5)|  6| false|     -1|
+|     POINT (4 3)| 13| false|     -1|
++----------------+---+------+-------+
+```
+
+DBSCAN 算法的更多内容请参阅 [此页](concepts/clustering-algorithms.md)。
+
+## 计算 Local Outlier Factor(LOF)
+
+Sedona 提供 [Local Outlier Factor](https://en.wikipedia.org/wiki/Local_outlier_factor) 算法的实现,用于识别空间数据中的异常点。
+
+该算法以 Scala 与 Python 函数的形式提供,作用在空间 DataFrame 上。返回的 DataFrame 中会增加一列保存 local outlier factor。
+
+第一个参数是 DataFrame,第二个参数是计算评分时考虑的最近邻数量。
+
+=== "Scala"
+
+	```scala
+	import org.apache.sedona.stats.outlierDetection.LocalOutlierFactor.localOutlierFactor
+
+    localOutlierFactor(df, 20).show()
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.sedona.stats.outlierDetection.LocalOutlierFactor;
+
+	LocalOutlierFactor.localOutlierFactor(df, 20).show();
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark.stats import local_outlier_factor
+
+	local_outlier_factor(df, 20).show()
+	```
+
+输出大致如下:
+
+```
++--------------------+------------------+
+|            geometry|               lof|
++--------------------+------------------+
+|POINT (-2.0231305...| 0.952098153363662|
+|POINT (-2.0346944...|0.9975325496668104|
+|POINT (-2.2040074...|1.0825843906411081|
+|POINT (1.61573501...|1.7367129352162634|
+|POINT (-2.1176324...|1.5714144683150393|
+|POINT (-2.2349759...|0.9167275845938276|
+|POINT (1.65470192...| 1.046231536764447|
+|POINT (0.62624112...|1.1988700676990034|
+|POINT (2.01746261...|1.1060219481067417|
+|POINT (-2.0483857...|1.0775553430145446|
+|POINT (2.43969463...|1.1129132178576646|
+|POINT (-2.2425480...| 1.104108012697006|
+|POINT (-2.7859235...|  2.86371824574529|
+|POINT (-1.9738858...|1.0398822680356794|
+|POINT (2.00153403...| 0.927409656346015|
+|POINT (2.06422812...|0.9222203762264445|
+|POINT (-1.7533819...|1.0273650471626696|
+|POINT (-2.2030766...| 0.964744555830738|
+|POINT (-1.8509857...|1.0375927869698574|
+|POINT (2.10849080...|1.0753419197322656|
++--------------------+------------------+
+```
+
+## 执行 Getis-Ord Gi(*) 热点分析
+
+Sedona 提供 [Gi 与 Gi*](https://en.wikipedia.org/wiki/Getis%E2%80%93Ord_statistics) 算法的实现,用于识别空间数据中的局部热点。
+
+该算法以 Scala 与 Python 函数的形式提供,作用在空间 DataFrame 上。返回的 DataFrame 中会增加 G 统计量、E[G]、V[G]、Z 分数与 p 值等列。
+
+使用 Gi 时,先为每条记录生成邻居列表,再调用 g_local 函数。
+=== "Scala"
+
+	```scala
+	import org.apache.sedona.stats.Weighting.addBinaryDistanceBandColumn
+	import org.apache.sedona.stats.hotspotDetection.GetisOrd.gLocal
+
+	val distanceRadius = 1.0
+	val weightedDf = addBinaryDistanceBandColumn(df, distanceRadius)
+    gLocal(weightedDf, "val").show()
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.sedona.stats.Weighting;
+	import org.apache.sedona.stats.hotspotDetection.GetisOrd;
+	import org.apache.spark.sql.DataFrame;
+
+	double distanceRadius = 1.0;
+	DataFrame weightedDf = Weighting.addBinaryDistanceBandColumn(df, distanceRadius);
+	GetisOrd.gLocal(weightedDf, "val").show();
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark.stats import add_binary_distance_band_column
+	from sedona.spark.stats import g_local
+
+	distance_radius = 1.0
+	weighted_df = addBinaryDistanceBandColumn(df, distance_radius)
+    g_local(weightedDf, "val").show()
+	```
+
+输出大致如下:
+
+<pre>
+<code>
++-----------+---+--------------------+-------------------+-------------------+--------------------+--------------------+--------------------+
+|   geometry|val|             weights|                  G|                 EG|                  VG|                   Z|                   P|
++-----------+---+--------------------+-------------------+-------------------+--------------------+--------------------+--------------------+
+|POINT (2 2)|0.9|[&#123;&#123;POINT (2 3), 1...| 0.4488188976377953|0.45454545454545453| 0.00356321373799772|-0.09593402008347063|  0.4617864875295957|
+|POINT (2 3)|1.2|[&#123;&#123;POINT (2 2), 0...|0.35433070866141736|0.36363636363636365|0.003325666155464539|-0.16136436037034918|  0.4359032175415549|
+|POINT (3 3)|1.2|[&#123;&#123;POINT (2 3), 1...|0.28346456692913385| 0.2727272727272727|0.002850570990398176| 0.20110780337013057| 0.42030714022155924|
+|POINT (3 2)|1.2|[&#123;&#123;POINT (2 2), 0...| 0.4488188976377953|0.45454545454545453| 0.00356321373799772|-0.09593402008347063|  0.4617864875295957|
+|POINT (3 1)|1.2|[&#123;&#123;POINT (3 2), 3...| 0.3622047244094489| 0.2727272727272727|0.002850570990398176|  1.6758983614177538| 0.04687905137429871|
+|POINT (2 1)|2.2|[&#123;&#123;POINT (2 2), 0...| 0.4330708661417323|0.36363636363636365|0.003325666155464539|  1.2040263812249166| 0.11428969105925013|
+|POINT (1 1)|1.2|[&#123;&#123;POINT (2 1), 5...| 0.2834645669291339| 0.2727272727272727|0.002850570990398176|  0.2011078033701316|  0.4203071402215588|
+|POINT (1 2)|0.2|[&#123;&#123;POINT (2 2), 0...|0.35433070866141736|0.45454545454545453| 0.00356321373799772|   -1.67884535146075|0.046591093685710794|
+|POINT (1 3)|1.2|[&#123;&#123;POINT (2 3), 1...| 0.2047244094488189| 0.2727272727272727|0.002850570990398176| -1.2736827546774914| 0.10138793530151635|
+|POINT (0 2)|1.0|[&#123;&#123;POINT (1 2), 7...|0.09448818897637795|0.18181818181818182|0.002137928242798632| -1.8887168824332323|0.029464887612748458|
+|POINT (4 2)|1.2|[&#123;&#123;POINT (3 2), 3...| 0.1889763779527559|0.18181818181818182|0.002137928242798632| 0.15481285921583854| 0.43848442662481324|
++-----------+---+--------------------+-------------------+-------------------+--------------------+--------------------+--------------------+
+</code>
+</pre>
+
+## 执行空间查询
+
+构造完 Geometry 类型列后,即可执行各类空间查询。
+
+### 范围查询
+
+使用 ==ST_Contains==、==ST_Intersects==、==ST_Within== 在单列上执行范围查询。
+
+下例查找位于给定多边形内的所有 county:
+
+```sql
+SELECT *
+FROM spatialdf
+WHERE ST_Contains (ST_PolygonFromEnvelope(1.0,100.0,1000.0,1100.0), newcountyshape)
+```
+
+!!!note
+	了解如何创建 Geometry 类型的查询窗口请参阅 [SedonaSQL 构造器 API](../api/sql/Geometry-Functions.md)。
+
+### KNN 查询
+
+使用 ==ST_Distance== 计算距离并排序。
+
+下面的代码返回距离给定多边形最近的 5 个对象:
+
+```sql
+SELECT countyname, ST_Distance(ST_PolygonFromEnvelope(1.0,100.0,1000.0,1100.0), newcountyshape) AS distance
+FROM spatialdf
+ORDER BY distance DESC
+LIMIT 5
+```
+
+### 连接查询
+
+连接查询的细节请参阅 [Join query](../api/sql/Optimizer.md)。
+
+### KNN 连接查询
+
+KNN 连接查询的细节请参阅 [KNN join query](../api/sql/NearestNeighbourSearching.md)。
+
+### 其他查询
+
+还有许多函数可以与上述查询组合使用,详见 [SedonaSQL 函数](../api/sql/Overview.md) 与 [SedonaSQL 聚合函数](../api/sql/Geometry-Functions.md#aggregate-functions)。
+
+## 可视化查询结果
+
+Sedona 提供 `SedonaPyDeck` 与 `SedonaKepler` 两种封装,都提供了在 Jupyter 环境中基于 SedonaDataFrame 创建交互式地图可视化的 API。
+
+!!!Note
+	`SedonaPyDeck` 与 `SedonaKepler` 默认要求几何对象按 lon-lat 顺序排列。如果您的 DataFrame 是 lat-lon 顺序,请使用 [ST_FlipCoordinates](../api/sql/Geometry-Editors/ST_FlipCoordinates.md)。
+
+!!!Note
+	`SedonaPyDeck` 与 `SedonaKepler` 设计上仅处理只含 1 个几何列的 SedonaDataFrame,传入包含多个几何列的 DataFrame 会出错。
+
+### SedonaPyDeck
+
+可在 Jupyter Lab/Notebook 中通过 SedonaPyDeck 可视化空间查询结果。
+
+SedonaPyDeck 基于 [pydeck](https://deckgl.readthedocs.io)(构建于 [deck.gl](https://deck.gl/) 之上)提供创建交互式地图的 API。
+
+!!!Note
+	使用 SedonaPyDeck 需要安装 sedona 的 `pydeck-map` 附加项:
+	```
+	pip install apache-sedona[pydeck-map]
+	```
+
+下面的教程展示了 SedonaPyDeck 可创建的多种地图,所用数据集均为公开数据。
+
+每个 SedonaPyDeck API 都通过可选参数提供定制能力,所有可用参数详见 [SedonaPyDeck API 文档](../api/sql/Visualization-SedonaPyDeck.md)。
+
+#### 使用 SedonaPyDeck 创建 Choropleth 地图
+
+SedonaPyDeck 的 `create_choropleth_map` API 可基于包含多边形与观测值的 SedonaDataFrame 创建 choropleth 地图:
+
+示例:
+
+```python
+SedonaPyDeck.create_choropleth_map(df=groupedresult, plot_col="AirportCount")
+```
+
+!!!Note
+	`plot_col` 是必填参数,用于告诉 SedonaPyDeck 渲染 choropleth 时使用哪一列。
+
+![使用 SedonaPyDeck 创建 Choropleth 地图](../image/choropleth.gif)
+
+所用数据集见 [此处](https://github.com/apache/sedona/tree/b66e768155866a38ba2e3404f1151cac14fad5ea/docs/usecases/data/ne_50m_airports),对应示例 notebook 见 [此处](https://github.com/apache/sedona/blob/master/docs/usecases/legacy/ApacheSedonaSQL_SpatialJoin_AirportsPerCountry.ipynb)。
+
+#### 使用 SedonaPyDeck 创建 Geometry 地图
+
+SedonaPyDeck 的 `create_geometry_map` API 可可视化任意类型几何对象的 SedonaDataFrame:
+
+示例:
+
+```python
+SedonaPyDeck.create_geometry_map(df_building, elevation_col="height")
+```
+
+![使用 SedonaPyDeck 创建 Geometry 地图](../image/buildings.gif)
+
+!!!Tip
+	`elevation_col` 是可选参数,用于渲染 3D 地图。请把对应几何对象 “高度” 信息所在的列名传入此参数。
+
+#### 使用 SedonaPyDeck 创建 Scatterplot 地图
+
+SedonaPyDeck 的 `create_scatterplot_map` API 可基于包含点的 SedonaDataFrame 创建散点地图:
+
+示例:
+
+```python
+SedonaPyDeck.create_scatterplot_map(df=crimes_df)
+```
+
+![使用 SedonaPyDeck 创建 Scatterplot 地图](../image/points.gif)
+
+所用的是 Chicago crimes 数据集,见 [此处](https://github.com/apache/sedona/blob/sedona-1.5.0/spark/common/src/test/resources/Chicago_Crimes.csv)。
+
+#### 使用 SedonaPyDeck 创建热力图
+
+SedonaPyDeck 的 `create_heatmap` API 可基于包含点的 SedonaDataFrame 创建热力图:
+
+示例:
+
+```python
+SedonaPyDeck.create_heatmap(df=crimes_df)
+```
+
+![使用 SedonaPyDeck 创建热力图](../image/heatmap.gif)
+
+所用同样是 Chicago crimes 数据集,见 [此处](https://github.com/apache/sedona/blob/sedona-1.5.0/spark/common/src/test/resources/Chicago_Crimes.csv)。
+
+### SedonaKepler
+
+可在 Jupyter Lab/Notebook 中通过 SedonaKepler 可视化空间查询结果。
+
+SedonaKepler 提供基于 [KeplerGl](https://kepler.gl/) 的交互式、可定制地图可视化 API。
+
+!!!Note
+	使用 SedonaKepler 需要安装 sedona 的 `kepler-map` 附加项:
+	```
+	pip install apache-sedona[kepler-map]
+	```
+
+下面演示如何使用 SedonaKepler 立即可视化地理空间数据。
+
+示例(取自 binder 提供的示例 notebook):
+
+```python
+SedonaKepler.create_map(df=groupedresult, name="AirportCount")
+```
+
+![使用 SedonaKepler 可视化地理空间数据](../image/sedona_customization.gif)
+
+所用数据集见 [此处](https://github.com/apache/sedona/tree/b66e768155866a38ba2e3404f1151cac14fad5ea/docs/usecases/data/ne_50m_airports),示例 notebook 见 [此处](https://github.com/apache/sedona/blob/master/docs/usecases/legacy/ApacheSedonaSQL_SpatialJoin_AirportsPerCountry.ipynb)。
+
+SedonaKepler 提供的所有 API 详见 [SedonaKepler API 文档](../api/sql/Visualization-SedonaKepler.md)。
+
+## 创建用户自定义函数(UDF)
+
+用户自定义函数(UDF)是用户编写的函数,可以对单行数据执行操作。为了覆盖几乎所有的使用场景,下面给出 4 种不同形式的 UDF 示例,演示如何在 UDF 中使用几何对象。Sedona 的序列化器会把 SQL 几何类型反序列化为 [JTS Geometry](https://locationtech.github.io/jts/javadoc-1.18.0/org/locationtech/jts/geom/Geometry.html)(Scala/Java)或 [Shapely Geometry](https://shapely.readthedocs.io/en/stable/geometry.html)(Python),可以充分利用这两个生态实现自定义逻辑。
+
+### Geometry 转 primitive
+
+下例 UDF 接收 Geometry 类型输入,返回基本类型输出:
+
+=== "Scala"
+
+	```scala
+	import org.locationtech.jts.geom.Geometry
+	import org.apache.spark.sql.types._
+
+	def lengthPoly(geom: Geometry): Double = {
+        geom.getLength
+	}
+
+	sedona.udf.register("udf_lengthPoly", lengthPoly _)
+
+	df.selectExpr("udf_lengthPoly(geom)").show()
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.spark.sql.api.java.UDF1;
+	import org.apache.spark.sql.types.DataTypes;
+
+	// 使用 lambda 注册 UDF
+	sparkSession.udf().register(
+			"udf_lengthPoly",
+			(UDF1<Geometry, Double>) Geometry::getLength,
+			DataTypes.DoubleType);
+
+	df.selectExpr("udf_lengthPoly(geom)").show()
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark.sql.types import GeometryType
+	from pyspark.sql.types import DoubleType
+
+	def lengthPoly(geom: GeometryType()):
+		return geom.length
+
+	sedona.udf.register("udf_lengthPoly", lengthPoly, DoubleType())
+
+	df.selectExpr("udf_lengthPoly(geom)").show()
+	```
+
+输出:
+
+```
++--------------------+
+|udf_lengthPoly(geom)|
++--------------------+
+|   3.414213562373095|
++--------------------+
+```
+
+### Geometry 转 Geometry
+
+下例 UDF 接收 Geometry 类型输入,返回 Geometry 类型输出:
+
+=== "Scala"
+
+	```scala
+	import org.locationtech.jts.geom.Geometry
+	import org.apache.spark.sql.types._
+
+	def bufferFixed(geom: Geometry): Geometry = {
+        geom.buffer(5.5)
+	}
+
+	sedona.udf.register("udf_bufferFixed", bufferFixed _)
+
+	df.selectExpr("udf_bufferFixed(geom)").show()
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.spark.sql.api.java.UDF1;
+	import org.apache.spark.sql.types.DataTypes;
+
+	// 使用 lambda 注册 UDF
+	sparkSession.udf().register(
+			"udf_bufferFixed",
+			(UDF1<Geometry, Geometry>) geom ->
+                geom.buffer(5.5),
+			new GeometryUDT());
+
+	df.selectExpr("udf_bufferFixed(geom)").show()
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import GeometryType
+	from pyspark.sql.types import DoubleType
+
+	def bufferFixed(geom: GeometryType()):
+    	return geom.buffer(5.5)
+
+	sedona.udf.register("udf_bufferFixed", bufferFixed, GeometryType())
+
+	df.selectExpr("udf_bufferFixed(geom)").show()
+	```
+
+输出:
+
+```
++--------------------------------------------------+
+|                             udf_bufferFixed(geom)|
++--------------------------------------------------+
+|POLYGON ((1 -4.5, -0.0729967710887076 -4.394319...|
++--------------------------------------------------+
+```
+
+### Geometry + primitive 转 Geometry
+
+下例 UDF 接收 Geometry 与基本类型两个输入,返回 Geometry 输出:
+
+=== "Scala"
+
+	```scala
+	import org.locationtech.jts.geom.Geometry
+	import org.apache.spark.sql.types._
+
+	def bufferIt(geom: Geometry, distance: Double): Geometry = {
+        geom.buffer(distance)
+	}
+
+	sedona.udf.register("udf_buffer", bufferIt _)
+
+	df.selectExpr("udf_buffer(geom, distance)").show()
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.spark.sql.api.java.UDF2;
+	import org.apache.spark.sql.types.DataTypes;
+
+	// 使用 lambda 注册 UDF
+	sparkSession.udf().register(
+			"udf_buffer",
+			(UDF2<Geometry, Double, Geometry>) Geometry::buffer,
+			new GeometryUDT());
+
+	df.selectExpr("udf_buffer(geom, distance)").show()
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import GeometryType
+	from pyspark.sql.types import DoubleType
+
+	def bufferIt(geom: GeometryType(), distance: DoubleType()):
+    	return geom.buffer(distance)
+
+	sedona.udf.register("udf_buffer", bufferIt, GeometryType())
+
+	df.selectExpr("udf_buffer(geom, distance)").show()
+	```
+
+输出:
+
+```
++--------------------------------------------------+
+|                        udf_buffer(geom, distance)|
++--------------------------------------------------+
+|POLYGON ((1 -9, -0.9509032201612866 -8.80785280...|
++--------------------------------------------------+
+```
+
+### Geometry + primitive 转 Geometry + primitive
+
+下例 UDF 接收 Geometry 与基本类型两个输入,同时返回 Geometry 与基本类型两个输出:
+
+=== "Scala"
+
+	```scala
+	import org.locationtech.jts.geom.Geometry
+	import org.apache.spark.sql.types._
+	import org.apache.spark.sql.api.java.UDF2
+
+	val schemaUDF = StructType(Array(
+		StructField("buffed", GeometryUDT),
+		StructField("length", DoubleType)
+	))
+
+	val udf_bufferLength = udf(
+		new UDF2[Geometry, Double, (Geometry, Double)] {
+			def call(geom: Geometry, distance: Double): (Geometry, Double) = {
+				val buffed = geom.buffer(distance)
+				val length = geom.getLength
+				(buffed, length)
+			}
+		}, schemaUDF)
+
+	sedona.udf.register("udf_bufferLength", udf_bufferLength)
+
+	data.withColumn("bufferLength", expr("udf_bufferLengths(geom, distance)"))
+        .select("geom", "distance", "bufferLength.*")
+		.show()
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.spark.sql.api.java.UDF2;
+	import org.apache.spark.sql.types.DataTypes;
+	import org.apache.spark.sql.types.StructType;
+	import scala.Tuple2;
+
+	StructType schemaUDF = new StructType()
+                .add("buffedGeom", new GeometryUDT())
+                .add("length", DataTypes.DoubleType);
+
+	// 使用 lambda 注册 UDF
+	sparkSession.udf().register("udf_bufferLength",
+                (UDF2<Geometry, Double, Tuple2<Geometry, Double>>) (geom, distance) -> {
+                    Geometry buffed = geom.buffer(distance);
+                    Double length = buffed.getLength();
+                    return new Tuple2<>(buffed, length);
+                },
+                schemaUDF);
+
+	df.withColumn("bufferLength", functions.expr("udf_bufferLength(geom, distance)"))
+                .select("geom", "distance", "bufferLength.*")
+				.show();
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import GeometryType
+	from pyspark.sql.types import *
+
+	schemaUDF = StructType([
+        StructField("buffed", GeometryType()),
+        StructField("length", DoubleType())
+    ])
+
+	def bufferAndLength(geom: GeometryType(), distance: DoubleType()):
+		buffed = geom.buffer(distance)
+		length = buffed.length
+		return [buffed, length]
+
+	sedona.udf.register("udf_bufferLength", bufferAndLength, schemaUDF)
+
+	df.withColumn("bufferLength", expr("udf_bufferLength(geom, buffer)")) \
+				.select("geom", "buffer", "bufferLength.*") \
+				.show()
+	```
+
+输出:
+
+```
++------------------------------+--------+--------------------------------------------------+-----------------+
+|                          geom|distance|                                        buffedGeom|           length|
++------------------------------+--------+--------------------------------------------------+-----------------+
+|POLYGON ((1 1, 1 2, 2 1, 1 1))|    10.0|POLYGON ((1 -9, -0.9509032201612866 -8.80785280...|66.14518337329191|
++------------------------------+--------+--------------------------------------------------+-----------------+
+```
+
+## 空间向量化 UDF(仅 Python)
+
+默认情况下,您在 Python 中创建的 UDF 不是向量化的,会逐行调用,速度较慢。可以使用 `vectorized` UDF,通过 Apache Arrow 以批模式执行,从而加速。
+
+要创建向量化 UDF,请使用 `sedona_vectorized_udf` 装饰器。当前仅支持标量 UDF,向量化 UDF 通常比普通 UDF 快得多,可能达到 2 倍。
+
+!!!note
+	当输入类型为几何对象时,请在使用 GEO_SERIES 向量化 UDF 时显式包含 BaseGeometry 类型(例如 shapely 的 Point 或 GeoPandas 的 GeoSeries),Sedona 会借此推断类型并判断数据是否需要转换。
+
+装饰器签名如下:
+
+```python
+def sedona_vectorized_udf(
+    udf_type: SedonaUDFType = SedonaUDFType.SHAPELY_SCALAR, return_type: DataType
+): ...
+```
+
+其中 `udf_type` 是 UDF 函数的类型,目前支持:
+
+- SHAPELY_SCALAR
+- GEO_SERIES
+
+主要差异在于函数所接收的输入数据形式不同。下面通过两个示例对几何对象执行 buffer 操作来说明。
+
+### Shapely 标量 UDF
+
+```python
+import shapely.geometry.base as b
+from sedona.spark import sedona_vectorized_udf
+
+
+@sedona_vectorized_udf(return_type=GeometryType())
+def vectorized_buffer(geom: b.BaseGeometry) -> b.BaseGeometry:
+    return geom.buffer(0.1)
+```
+
+### GeoSeries UDF
+
+```python
+import geopandas as gpd
+from sedona.spark import sedona_vectorized_udf, SedonaUDFType
+from sedona.spark import GeometryType
+
+
+@sedona_vectorized_udf(udf_type=SedonaUDFType.GEO_SERIES, return_type=GeometryType())
+def vectorized_geo_series_buffer(series: gpd.GeoSeries) -> gpd.GeoSeries:
+    buffered = series.buffer(0.1)
+
+    return buffered
+```
+
+调用 UDF 的方式如下:
+
+```python
+# Shapely 标量 UDF
+df.withColumn("buffered", vectorized_buffer(df.geom)).show()
+
+# GeoSeries UDF
+df.withColumn("buffered", vectorized_geo_series_buffer(df.geom)).show()
+```
+
+## 保存到永久存储
+
+要把空间 DataFrame 保存到 Hive 表、HDFS 等永久存储,最简单的做法是把 Geometry 列里的每个几何对象转换回普通字符串,再把得到的 DataFrame 保存到任意位置。
+
+把 DataFrame 中的 Geometry 列还原为 WKT 字符串列:
+
+```sql
+SELECT ST_AsText(countyshape)
+FROM polygondf
+```
+
+## 保存为 GeoJSON
+
+自 `v1.6.1` 起,Sedona 中的 GeoJSON 数据源可把空间 DataFrame 保存为单行 JSON 文件,几何对象按 GeoJSON 格式写出:
+
+```sparksql
+df.write.format("geojson").save("YOUR/PATH.json")
+```
+
+写出 GeoJSON 的更多信息请参阅 [此页](files/geojson-sedona-spark.md)。
+
+## 保存为 GeoParquet
+
+自 v`1.3.0` 起,Sedona 原生支持写出 GeoParquet 文件:
+
+```scala
+df.write.format("geoparquet").save(geoparquetoutputlocation + "/GeoParquet_File_Name.parquet")
+```
+
+写出 GeoParquet 的更多信息请参阅 [此页](files/geoparquet-sedona-spark.md)。
+
+## 保存到 Postgis
+
+遗憾的是,Spark SQL JDBC 数据源的 'createTableColumnTypes' 选项不支持在 PostGIS 中创建几何类型,仅识别 Spark 内置类型。这意味着您需要在 Spark 之外单独管理 PostGIS 的 schema。一种做法是先在 PostGIS 中创建好包含几何列的表,再用 Spark 写入数据;也可以先用 Spark 写入数据,然后再手动把列类型改为 geometry。
+
+PostGIS 使用 EWKB 序列化几何对象。如果您在 Sedona 中把几何对象转换为 EWKB 格式,PostGIS 端就无需再做额外转换。
+
+```
+my_postgis_db# create table my_table (id int8, geom geometry);
+
+df.withColumn("geom", expr("ST_AsEWKB(geom)")
+	.write.format("jdbc")
+	.option("truncate","true") // 不让 Spark 重建表
+	// 其他选项
+	.save()
+
+// 如果写入前没有创建表,可以在写入后修改列类型
+my_postgis_db# alter table my_table alter column geom type geometry;
+
+```
+
+## 在 DataFrame 与 SpatialRDD 之间互转
+
+### DataFrame 转 SpatialRDD
+
+使用 SedonaSQL 的 DataFrame-RDD Adapter 将 DataFrame 转换为 SpatialRDD:
+
+=== "Scala"
+
+	```scala
+	var spatialRDD = StructuredAdapter.toSpatialRdd(spatialDf, "usacounty")
+	```
+
+=== "Java"
+
+	```java
+	SpatialRDD spatialRDD = StructuredAdapter.toSpatialRdd(spatialDf, "usacounty")
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import StructuredAdapter
+
+	spatialRDD = StructuredAdapter.toSpatialRdd(spatialDf, "usacounty")
+	```
+
+`"usacounty"` 是几何列的列名,可选参数。如果不提供,将使用第一个几何列。
+
+### SpatialRDD 转 DataFrame
+
+使用 SedonaSQL 的 DataFrame-RDD Adapter 将 SpatialRDD 转换为 DataFrame。详见 [Adapter Scaladoc](../api/javadoc/sql/org/apache/sedona/sql/utils/index.html)。
+
+=== "Scala"
+
+	```scala
+	var spatialDf = StructuredAdapter.toDf(spatialRDD, sedona)
+	```
+
+=== "Java"
+
+	```java
+	Dataset<Row> spatialDf = StructuredAdapter.toDf(spatialRDD, sedona)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import StructuredAdapter
+
+	spatialDf = StructuredAdapter.toDf(spatialRDD, sedona)
+	```
+
+### 保留空间分区的 SpatialRDD 转 DataFrame
+
+`StructuredAdapter.toDf()` 默认不保留空间分区,因为对于大多数空间数据保留空间分区会引入重复要素。这些重复是为了在执行空间连接时保证正确性而有意引入的;但当使用 Sedona 准备数据用于分发时,通常不希望出现这些重复。
+
+可以使用 `StructuredAdapter` 与 `spatialRDD.spatialPartitioningWithoutDuplicates` 函数得到不含重复的、按空间分区的 Sedona DataFrame。这在生成均衡的 GeoParquet 文件时特别有用,可以在文件内保留空间邻近性,从而最大化 GeoParquet 的过滤下推性能。
+
+=== "Scala"
+
+	```scala
+	spatialRDD.spatialPartitioningWithoutDuplicates(GridType.KDBTREE)
+	// 期望分区数为 10(实际数量可能略有不同)
+	// spatialRDD.spatialPartitioningWithoutDuplicates(GridType.KDBTREE, 10)
+	var spatialDf = StructuredAdapter.toSpatialPartitionedDf(spatialRDD, sedona)
+	```
+
+=== "Java"
+
+	```java
+	spatialRDD.spatialPartitioningWithoutDuplicates(GridType.KDBTREE)
+	// 期望分区数为 10(实际数量可能略有不同)
+	// spatialRDD.spatialPartitioningWithoutDuplicates(GridType.KDBTREE, 10)
+	Dataset<Row> spatialDf = StructuredAdapter.toSpatialPartitionedDf(spatialRDD, sedona)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import StructuredAdapter
+
+	spatialRDD.spatialPartitioningWithoutDuplicates(GridType.KDBTREE)
+	# 期望分区数为 10(实际数量可能略有不同)
+	# spatialRDD.spatialPartitioningWithoutDuplicates(GridType.KDBTREE, 10)
+	spatialDf = StructuredAdapter.toSpatialPartitionedDf(spatialRDD, sedona)
+	```
+
+### SpatialPairRDD 转 DataFrame
+
+PairRDD 是空间连接查询或距离连接查询的结果。SedonaSQL 的 DataFrame-RDD Adapter 可以把它转换为 DataFrame,但需要提供左、右 RDD 的 schema。
+
+=== "Scala"
+
+	```scala
+	var joinResultDf = StructuredAdapter.toDf(joinResultPairRDD, leftDf.schema, rightDf.schema, sedona)
+	```
+
+=== "Java"
+
+	```java
+	Dataset joinResultDf = StructuredAdapter.toDf(joinResultPairRDD, leftDf.schema, rightDf.schema, sedona);
+	```
+=== "Python"
+
+	```python
+	from sedona.spark import StructuredAdapter
+
+	joinResultDf = StructuredAdapter.pairRddToDf(result_pair_rdd, leftDf.schema, rightDf.schema, spark)
+	```


(sedona) 06/12: [GH-2911] Translate Tutorial / Programming Guide (part 2) to Chinese (#2933)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit d0dc9aa32a65f1617bae49c685d2775fac61d37a
Author: Jia Yu <ji...@apache.org>
AuthorDate: Thu May 7 23:54:59 2026 -0700

    [GH-2911] Translate Tutorial / Programming Guide (part 2) to Chinese (#2933)
    
    (cherry picked from commit 33ef95c5600c6b7027a7dedb0d1d07d1aec8de32)
---
 docs/tutorial/concepts/spatial-joins.zh.md        | 418 ++++++++++++++++++
 docs/tutorial/files/geoparquet-sedona-spark.zh.md | 352 +++++++++++++++
 docs/tutorial/files/stac-sedona-spark.zh.md       | 468 ++++++++++++++++++++
 docs/tutorial/flink/sql.zh.md                     | 511 ++++++++++++++++++++++
 docs/tutorial/geopandas-api.zh.md                 | 398 +++++++++++++++++
 docs/tutorial/geopandas-shapely.zh.md             | 371 ++++++++++++++++
 6 files changed, 2518 insertions(+)

diff --git a/docs/tutorial/concepts/spatial-joins.zh.md b/docs/tutorial/concepts/spatial-joins.zh.md
new file mode 100644
index 0000000000..ddd53a6f8e
--- /dev/null
+++ b/docs/tutorial/concepts/spatial-joins.zh.md
@@ -0,0 +1,418 @@
+<!--
+ 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.
+ -->
+
+# 在 Spark 上使用 Apache Sedona 进行空间连接
+
+本文介绍如何使用 Apache Sedona 进行空间连接(spatial join)。您将了解到不同类型的空间连接以及如何高效执行它们。
+
+页面中的示例较为基础,便于直观地说明空间连接的核心概念。文末还会针对真实业务规模的数据集,进一步阐述空间连接概念并强调若干关键的性能改进。
+
+## 使用 Spark 进行 within 空间连接
+
+下图包含 3 个点和 2 个多边形:`point_b` 位于 `polygon_y` 内部,`point_c` 位于 `polygon_x` 内部,`point_a` 不在任何多边形中。
+
+![spatial join within](../../image/tutorial/concepts/spatial-join1.png)
+
+`points` 表存放点,`polygons` 表存放多边形。
+
+执行该查询的 SQL 如下:
+
+```sql
+SELECT
+    points.id as point_id,
+    polygons.id as polygon_id
+FROM points
+JOIN polygons ON ST_Within(points.geometry, polygons.geometry);
+```
+
+结果如下:
+
+```
++--------+----------+
+|point_id|polygon_id|
++--------+----------+
+|       b|         y|
+|       c|         x|
++--------+----------+
+```
+
+`point_a` 不在结果 DataFrame 中,因为它不在任何多边形内部。
+
+如果使用 `LEFT JOIN`,可以更直观地看到 `point_a` 的 `polygon_id` 为 `NULL`:
+
+```sql
+SELECT
+    points.id as point_id,
+    polygons.id as polygon_id
+FROM points
+LEFT JOIN polygons ON ST_Within(points.geometry, polygons.geometry);
+```
+
+输出:
+
+```
++--------+----------+
+|point_id|polygon_id|
++--------+----------+
+|       a|      NULL|
+|       b|         y|
+|       c|         x|
++--------+----------+
+```
+
+`point_a` 的 `polygon_id` 为 `NULL`,因为它不在任何多边形内。
+
+在生产应用中通常使用 `JOIN`。本文使用 `LEFT JOIN` 仅是为了展示哪些行没有匹配到。
+
+上面的代码使用了 `ST_Within` 谓词,它与 `ST_Contains` 含义相同,只是参数顺序相反。下面是用 `ST_Contains` 写的等价查询:
+
+```sql
+SELECT
+    points.id as point_id,
+    polygons.id as polygon_id
+FROM points
+LEFT JOIN polygons ON ST_Contains(polygons.geometry, points.geometry);
+```
+
+结果完全相同:
+
+```
++--------+----------+
+|point_id|polygon_id|
++--------+----------+
+|       a|      NULL|
+|       b|         y|
+|       c|         x|
++--------+----------+
+```
+
+## 使用 Spark 进行 crosses 空间连接
+
+下图包含 1 个多边形和 2 条折线:`line_a` 与 `line_b` 都穿过 `polygon_x`,`line_c` 没有穿过 `polygon_x`。
+
+![spatial join crosses](../../image/tutorial/concepts/spatial-join2.png)
+
+执行该空间连接的 SQL:
+
+```sql
+SELECT
+    lines.id as line_id,
+    polygons.id as polygon_id
+FROM lines
+LEFT JOIN polygons ON ST_Crosses(lines.geometry, polygons.geometry);
+```
+
+结果:
+
+```
++-------+----------+
+|line_id|polygon_id|
++-------+----------+
+|      a|         x|
+|      b|         x|
+|      c|      NULL|
++-------+----------+
+```
+
+借助 `ST_Crosses` 的空间连接,可以筛选出与多边形相交的折线。
+
+## 使用 Spark 进行 touches 空间连接
+
+假设有 1 个多边形和 2 条折线:`line_a` 不接触多边形,`line_b` 接触多边形。如下图所示:
+
+![spatial join touches](../../image/tutorial/concepts/spatial-join3.png)
+
+我们用折线创建 `table_a`,用多边形创建 `table_b`,然后做连接。
+
+多边形表内容如下:
+
+```
++---+-----------------------------------+
+|id |geometry                           |
++---+-----------------------------------+
+|x  |POLYGON ((6 2, 6 4, 8 4, 8 2, 6 2))|
++---+-----------------------------------+
+```
+
+折线表内容如下:
+
+```
++---+----------------------+
+|id |geometry              |
++---+----------------------+
+|a  |LINESTRING (2 4, 4 0) |
+|b  |LINESTRING (6 0, 10 4)|
++---+----------------------+
+```
+
+匹配相互接触的连接:
+
+```python
+sedona.sql("""
+SELECT
+    lines.id as line_id,
+    polygons.id as polygon_id
+FROM lines
+LEFT JOIN polygons ON ST_Touches(lines.geometry, polygons.geometry);
+""").show()
+```
+
+连接结果:
+
+```
++-------+----------+
+|line_id|polygon_id|
++-------+----------+
+|      a|      NULL|
+|      b|         x|
++-------+----------+
+```
+
+接下来看看如何用空间连接判断点是否在多边形内。
+
+## 使用 Spark 进行 overlaps 空间连接
+
+下图展示了 2 个多边形与若干图形:`polygon_a` 与 `polygon_x` 重叠;`line_b`、`line_c` 与 `point_d` 都不与 `polygon_y` 或 `polygon_x` 重叠。
+
+![spatial join overlaps](../../image/tutorial/concepts/spatial-join4.png)
+
+执行该空间连接的 SQL:
+
+```sql
+SELECT
+    shapes.id as shape_id,
+    polygons.id as polygon_id
+FROM shapes
+LEFT JOIN polygons ON ST_Overlaps(shapes.geometry, polygons.geometry);
+```
+
+结果:
+
+```
++--------+----------+
+|shape_id|polygon_id|
++--------+----------+
+|       a|         x|
+|       b|      NULL|
+|       c|      NULL|
+|       d|      NULL|
++--------+----------+
+```
+
+## 使用 Spark 进行 K 近邻空间连接(KNN spatial join)
+
+假设有一张地址表与一张咖啡店表,希望为每个地址找到最近的两家咖啡店。
+
+`addresses` 表包含 `latitude` 与 `longitude`:
+
+```
++---+---------+--------+
+| id|longitude|latitude|
++---+---------+--------+
+| a1|      2.0|     3.0|
+| a2|      5.0|     5.0|
+| a3|      7.0|     2.0|
++---+---------+--------+
+```
+
+`coffee_shops` 表同样包含 `latitude` 与 `longitude`:
+
+```
++---+---------+--------+
+| id|longitude|latitude|
++---+---------+--------+
+| c1|      1.0|     4.0|
+| c2|      3.0|     5.0|
+| c3|      5.0|     1.0|
+| c4|      8.0|     4.0|
++---+---------+--------+
+```
+
+为每个地址计算最近的两家咖啡店:
+
+```sql
+SELECT
+    addresses.id AS address_id,
+    coffee_shops.id AS coffee_shop_id
+FROM addresses
+JOIN coffee_shops
+ON ST_KNN(addresses.geometry, coffee_shops.geometry, 2)
+```
+
+结果:
+
+```
++----------+--------------+
+|address_id|coffee_shop_id|
++----------+--------------+
+|        a1|            c1|
+|        a1|            c2|
+|        a2|            c2|
+|        a2|            c4|
+|        a3|            c3|
+|        a3|            c4|
++----------+--------------+
+```
+
+可视化结果如下:
+
+![spatial join knn](../../image/tutorial/concepts/spatial-join5.png)
+
+可以一目了然地看出每个地址附近的两家咖啡店。
+
+## 使用 Spark 进行空间距离连接
+
+下图展示了 1 个点与若干公交站点。我们要找出与该点距离不超过 2.5 单位的所有公交站点。
+
+![spatial distance join](../../image/tutorial/concepts/spatial-join6.png)
+
+可以看出 `t2` 与 `t3` 在 2.5 单位范围内。
+
+points 表如下:
+
+```
++---+-------------+
+| id|     geometry|
++---+-------------+
+| p1|POINT (4.5 3)|
++---+-------------+
+```
+
+transit 表如下:
+
+```
++---+-----------+
+| id|   geometry|
++---+-----------+
+| t1|POINT (1 4)|
+| t2|POINT (3 4)|
+| t3|POINT (5 2)|
+| t4|POINT (8 4)|
++---+-----------+
+```
+
+执行距离连接,找出与该点距离 ≤ 2.5 的公交站点:
+
+```sql
+SELECT
+    points.id AS point_id,
+    transit.id AS transit_id
+FROM points
+JOIN transit
+ON ST_DWithin(points.geometry, transit.geometry, 2.5)
+```
+
+结果:
+
+```
++--------+----------+
+|point_id|transit_id|
++--------+----------+
+|      p1|        t2|
+|      p1|        t3|
++--------+----------+
+```
+
+Sedona 非常适合查找距离某点一定范围内的位置。
+
+Sedona 使用的是欧氏距离,因此距离单位与原始坐标的 CRS 相同。如果要在 WGS84 坐标上以米为单位运算,请使用 `ST_DistanceSphere`、`ST_DistanceSpheroid` 或 `ST_DWithin(useSpheroid = true)`。
+
+## 使用 Spark 进行空间范围连接
+
+由 `ST_Intersects`、`ST_Contains`、`ST_Within`、`ST_DWithin`、`ST_Touches`、`ST_Crosses` 触发的连接都属于范围连接(range join)。本节再展示一个范围连接示例,其实前面已经介绍过多个范围连接。
+
+假设有一张城市表与一张餐厅表,希望找出某城市内的所有餐厅。示例数据如下图:
+
+![spatial range join](../../image/tutorial/concepts/spatial-join7.png)
+
+3 家餐厅位于城市边界内,1 家餐厅在城市外。
+
+cities 表:
+
+```
++-----+--------------------+
+|   id|            geometry|
++-----+--------------------+
+|city1|POLYGON ((1 1, 1 ...|
++-----+--------------------+
+```
+
+`restaurants` 表:
+
+```
++---+-----------+
+| id|   geometry|
++---+-----------+
+| r1|POINT (2 2)|
+| r2|POINT (3 3)|
+| r3|POINT (4 4)|
+| r4|POINT (6 6)|
++---+-----------+
+```
+
+执行范围连接:
+
+```
+SELECT
+    cities.id AS city_id,
+    restaurants.id AS restaurant_id
+FROM cities
+JOIN restaurants
+ON ST_Intersects(restaurants.geometry, cities.geometry)
+```
+
+结果:
+
+```
++-------+-------------+
+|city_id|restaurant_id|
++-------+-------------+
+|  city1|           r1|
+|  city1|           r2|
+|  city1|           r3|
++-------+-------------+
+```
+
+范围连接在很多实际场景中都非常有用。
+
+## Sedona 与 Apache Spark 上的空间连接优化
+
+可以通过更优的文件格式、索引、查询写法等方式优化空间连接。
+
+例如,假设您正在对存储为 GeoJSON 的两张宽表执行空间连接,且不需要全部输出列。GeoJSON 是行式存储,不支持列裁剪。把数据从 GeoJSON 切换到 GeoParquet 等列式格式即可享受列裁剪带来的关键性能收益。
+
+更多查询优化方法请参阅 [此处](https://sedona.apache.org/latest/api/sql/Optimizer/)。
+
+## 空间广播连接
+
+Sedona 既能在单机运行,也能在多节点集群上运行。
+
+可以想象,当数据分布在集群的不同机器上时,连接两个数据集会更慢——因为需要 shuffle,开销不小。
+
+如果其中一张表很小,可以将其广播到集群中的所有机器,从而大幅提升连接速度。
+
+通常只有相对较小的 DataFrame 才适合广播,详见 [此处说明](https://sedona.apache.org/latest/api/sql/Optimizer/?h=broadcast#broadcast-index-join)。
+
+Sedona 会自动广播大小低于阈值的表,[详细信息见此](https://sedona.apache.org/latest/api/sql/Optimizer/#automatic-broadcast-index-join)。
+
+## 结论
+
+Apache Sedona 支持多种类型的空间连接。
+
+空间连接是 Sedona 引擎的强项之一。其他引擎在执行空间连接时常常受到内存问题的困扰,而 Sedona 能够在海量数据集上完成空间连接。
diff --git a/docs/tutorial/files/geoparquet-sedona-spark.zh.md b/docs/tutorial/files/geoparquet-sedona-spark.zh.md
new file mode 100644
index 0000000000..d2a8cec29c
--- /dev/null
+++ b/docs/tutorial/files/geoparquet-sedona-spark.zh.md
@@ -0,0 +1,352 @@
+<!--
+ 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.
+ -->
+
+# 在 Spark 上使用 Apache Sedona 处理 GeoParquet
+
+本页介绍如何使用 Apache Sedona 与 GeoParquet 构建空间数据湖。
+
+GeoParquet 在空间数据集场景下具有诸多优势:
+
+* 内置对几何列的支持
+* GeoParquet 是列式存储,支持列裁剪,仅使用部分列的查询会更快
+* 内嵌统计信息让某些查询能够直接跳过整块文件内容
+* 为每个 row group 存储边界框(“bbox”)元数据,可进行 row-group 级过滤
+* 列式格式利于压缩
+* 与 GeoJSON 或 CSV 不同,GeoParquet 在文件尾部携带 schema,无需推断或手动指定
+
+下面看如何把 Sedona DataFrame 写成 GeoParquet 文件。
+
+## 使用 Spark 把 Sedona DataFrame 写为 GeoParquet
+
+先创建一个 Sedona DataFrame:
+
+```python
+df = sedona.createDataFrame(
+    [
+        ("a", "LINESTRING(2.0 5.0,6.0 1.0)"),
+        ("b", "LINESTRING(7.0 4.0,9.0 2.0)"),
+        ("c", "LINESTRING(1.0 3.0,3.0 1.0)"),
+    ],
+    ["id", "geometry"],
+)
+df = df.withColumn("geometry", ST_GeomFromText(col("geometry")))
+```
+
+将 DataFrame 写成 GeoParquet 文件:
+
+```python
+df.write.format("geoparquet").mode("overwrite").save("/tmp/somewhere")
+```
+
+写出的文件如下:
+
+```
+somewhere/
+  _SUCCESS
+  part-00000-1c13be9e-6d4c-401e-89d8-739000ad3aba-c000.snappy.parquet
+  part-00003-1c13be9e-6d4c-401e-89d8-739000ad3aba-c000.snappy.parquet
+  part-00007-1c13be9e-6d4c-401e-89d8-739000ad3aba-c000.snappy.parquet
+  part-00011-1c13be9e-6d4c-401e-89d8-739000ad3aba-c000.snappy.parquet
+```
+
+Sedona 会并行写出多个 Parquet 文件,比写单一文件快得多。
+
+## 使用 Spark 将 GeoParquet 读入 Sedona DataFrame
+
+将 GeoParquet 文件读入 Sedona DataFrame:
+
+```python
+df = sedona.read.format("geoparquet").load("/tmp/somewhere")
+df.show(truncate=False)
+```
+
+结果如下:
+
+```
++---+---------------------+
+|id |geometry             |
++---+---------------------+
+|a  |LINESTRING (2 5, 6 1)|
+|b  |LINESTRING (7 4, 9 2)|
+|c  |LINESTRING (1 3, 3 1)|
++---+---------------------+
+```
+
+Sedona 在底层执行该查询的过程大致如下:
+
+1. 从 GeoParquet 文件尾部读取 schema,因此无需 schema 推断。
+2. 收集每个文件的 bbox 元数据,判断哪些数据可以被跳过。
+3. 执行查询时跳过未使用的列。
+
+得益于此,Sedona 在 GeoParquet 上的查询通常比在 CSV 等格式上更快、更稳定。CSV 既不在文件尾部存 schema,也不支持列裁剪,更没有用于数据跳过的 row-group 元数据。
+
+## 检查 GeoParquet 元数据
+
+自 v`1.5.1` 起,Sedona 提供了一个 Spark SQL 数据源 `"geoparquet.metadata"`,可用于检查 GeoParquet 元数据。返回的 DataFrame 中包含每个输入文件的 “geo” 元数据。
+
+=== "Scala"
+
+  ```scala
+  val df = sedona.read.format("geoparquet.metadata").load(geoparquetdatalocation1)
+  df.printSchema()
+  ```
+
+=== "Java"
+
+  ```java
+  Dataset<Row> df = sedona.read.format("geoparquet.metadata").load(geoparquetdatalocation1)
+  df.printSchema()
+  ```
+
+=== "Python"
+
+  ```python
+  df = sedona.read.format("geoparquet.metadata").load(geoparquetdatalocation1)
+  df.printSchema()
+  ```
+
+输出如下:
+
+```
+root
+ |-- path: string (nullable = true)
+ |-- version: string (nullable = true)
+ |-- primary_column: string (nullable = true)
+ |-- columns: map (nullable = true)
+ |    |-- key: string
+ |    |-- value: struct (valueContainsNull = true)
+ |    |    |-- encoding: string (nullable = true)
+ |    |    |-- geometry_types: array (nullable = true)
+ |    |    |    |-- element: string (containsNull = true)
+ |    |    |-- bbox: array (nullable = true)
+ |    |    |    |-- element: double (containsNull = true)
+ |    |    |-- crs: string (nullable = true)
+```
+
+GeoParquet 文件尾部为每一列存储以下数据:
+
+* geometry_type:几何对象的类型,如点、多边形等
+* bbox:文件中对象的边界框
+* crs:坐标参考系
+* covering:包含 xmin、ymin、xmax、ymax 的结构体列,用于 GeoParquet 1.1 文件的 row group 统计信息
+
+其他 Parquet 元数据存储在 Parquet 文件尾部,与普通 Parquet 文件保持一致。
+
+如果输入的 Parquet 文件没有 GeoParquet 元数据,返回 DataFrame 中的 `version`、`primary_column` 与 `columns` 字段会为 `null`。
+
+`geoparquet.metadata` 仅支持读取 GeoParquet 特有的元数据。如果需要读取通用 Parquet 文件的全部元数据,可以使用 [G-Research/spark-extension](https://github.com/G-Research/spark-extension/blob/13109b8e43dfba9272c85896ba5e30cfe280426f/PARQUET.md)。
+
+我们来查看一下元数据的内容与 schema:
+
+```
+df.show(truncate=False)
+
++-----------------------------+-------------------------------------------------------------------+
+|path                         |columns                                                            |
++-----------------------------+-------------------------------------------------------------------+
+|file:/part-00003-1c13.parquet|{geometry -> {WKB, [LineString], [2.0, 1.0, 6.0, 5.0], null, NULL}}|
+|file:/part-00007-1c13.parquet|{geometry -> {WKB, [LineString], [7.0, 2.0, 9.0, 4.0], null, NULL}}|
+|file:/part-00011-1c13.parquet|{geometry -> {WKB, [LineString], [1.0, 1.0, 3.0, 3.0], null, NULL}}|
+|file:/part-00000-1c13.parquet|{geometry -> {WKB, [], [0.0, 0.0, 0.0, 0.0], null, NULL}}          |
++-----------------------------+-------------------------------------------------------------------+
+```
+
+`columns` 列保存了 GeoParquet 数据湖中各文件的边界框信息,可用于跳过整个文件或 row group。下文还会进一步介绍如何利用 bbox 元数据。
+
+## 写出带 CRS 元数据的 GeoParquet
+
+自 v`1.5.1` 起,Sedona 支持以自定义的 GeoParquet 规范版本与 CRS 写出 GeoParquet 文件。默认的 GeoParquet 规范版本为 `1.1.0`(自 `v1.9.0` 起),默认 CRS 为 `null`。可按以下方式指定:
+
+```scala
+val projjson = "{...}" // 所有几何列共享的 PROJJSON 字符串
+df.write.format("geoparquet")
+    .option("geoparquet.version", "1.0.0")
+    .option("geoparquet.crs", projjson)
+    .save(geoparquetoutputlocation + "/GeoParquet_File_Name.parquet")
+```
+
+如果 GeoParquet 文件中存在多个几何列,可以为每个列分别指定 CRS。例如 `df` 中有两列几何列 `g0` 与 `g1`,希望分别指定它们的 CRS:
+
+```scala
+val projjson_g0 = "{...}" // g0 的 PROJJSON 字符串
+val projjson_g1 = "{...}" // g1 的 PROJJSON 字符串
+df.write.format("geoparquet")
+    .option("geoparquet.version", "1.0.0")
+    .option("geoparquet.crs.g0", projjson_g0)
+    .option("geoparquet.crs.g1", projjson_g1)
+    .save(geoparquetoutputlocation + "/GeoParquet_File_Name.parquet")
+```
+
+`geoparquet.crs` 与 `geoparquet.crs.<column_name>` 可取以下值:
+
+* `"null"`:显式将 `crs` 字段置为 `null`,这是几何 SRID 为 0 时的默认行为。
+* `""`(空字符串):省略 `crs` 字段。对于支持 CRS 的实现而言,意味着使用 [OGC:CRS84](https://www.opengis.net/def/crs/OGC/1.3/CRS84)。
+* `"{...}"`(PROJJSON 字符串):`crs` 字段会被设为表示该几何坐标参考系的 PROJJSON 对象。可在 https://epsg.io/ (页面底部点击 JSON 选项)查找特定 CRS 的 PROJJSON,也可以根据需要自定义 PROJJSON。
+
+### 通过 SRID 自动推断 CRS
+
+未显式提供 `geoparquet.crs` 选项时,Sedona 会根据几何列的 SRID 自动推导出 CRS PROJJSON。例如,如果某列所有几何对象的 SRID 都是 32632(通过 [`ST_SetSRID`](../../api/sql/Spatial-Reference-System/ST_SetSRID.md) 设置),写入器会自动在 GeoParquet 元数据中生成 EPSG:32632 对应的 PROJJSON。当 SRID 为 4326 时,由于这就是 GeoParquet 的默认 CRS(OGC:CRS84),`crs` 字段会被省略。
+
+* 若 SRID 为 0(未显式设置 SRID 的几何对象的默认值),`crs` 字段会被设为 `null`。
+* 若同一列中的几何对象 SRID 不一致,`crs` 字段默认置为 `null`。
+* 若显式提供了 `geoparquet.crs` 或 `geoparquet.crs.<column_name>` 选项,则始终优先于 SRID 推导出的 CRS。
+
+Sedona 的 GeoParquet 读写器**不会**校验坐标轴顺序(lon/lat 还是 lat/lon),假定使用者在读写时自行处理。可以使用 [`ST_FlipCoordinates`](../../api/sql/Geometry-Editors/ST_FlipCoordinates.md) 来交换几何对象的坐标轴顺序。
+
+## 写出带 covering 元数据的 GeoParquet
+
+自 `v1.6.1` 起,Sedona 支持向几何列元数据写入 [`covering` 字段](https://github.com/opengeospatial/geoparquet/blob/v1.1.0/format-specs/geoparquet.md#covering)。该字段指定一列边界框列以加速空间数据检索。该边界框列必须是顶层结构体列,包含 `xmin`、`ymin`、`xmax`、`ymax` 四个子列。如果待写入的 DataFrame 已经包含这样的列,可通过 `.option("geoparquet.covering.<geometryColumnName>", "<coveringColumnName>")` 选项把 `covering` 元数据写入 GeoParquet:
+
+```scala
+df.write.format("geoparquet")
+    .option("geoparquet.covering.geometry", "bbox")
+    .save("/path/to/saved_geoparquet.parquet")
+```
+
+如果 DataFrame 仅有一列几何列,可以省略列名直接使用 `geoparquet.covering`:
+
+```scala
+df.write.format("geoparquet")
+    .option("geoparquet.covering", "bbox")
+    .save("/path/to/saved_geoparquet.parquet")
+```
+
+如果未设置 `geoparquet.covering` 选项,Sedona 在写出 GeoParquet `1.1.0` 时会自动为您填充 covering 元数据。
+
+对每个几何列,Sedona 会使用 `<geometryColumnName>_bbox` 作为 covering 列:
+
+* 如果 `<geometryColumnName>_bbox` 已存在且是合法的 covering 结构体(`xmin`、`ymin`、`xmax`、`ymax`),Sedona 会复用它。
+* 如果 `<geometryColumnName>_bbox` 不存在,Sedona 会在写出时自动生成。
+
+显式的 `geoparquet.covering` 或 `geoparquet.covering.<geometryColumnName>` 选项始终优先于上述默认行为。
+
+可以通过 `geoparquet.covering.mode` 控制该默认行为:
+
+* `auto`(默认):在写 GeoParquet `1.1.0` 时启用 covering 元数据/列的自动生成。
+* `legacy`:禁用自动 covering 生成。
+
+```scala
+df.write.format("geoparquet")
+  .option("geoparquet.covering.mode", "legacy")
+  .save("/path/to/saved_geoparquet.parquet")
+```
+
+如果 DataFrame 中没有 covering 列,可以使用 Sedona 的 SQL 函数构造一个:
+
+```scala
+val df_bbox = df.withColumn("bbox", expr("struct(ST_XMin(geometry) AS xmin, ST_YMin(geometry) AS ymin, ST_XMax(geometry) AS xmax, ST_YMax(geometry) AS ymax)"))
+df_bbox.write.format("geoparquet").option("geoparquet.covering.geometry", "bbox").save("/path/to/saved_geoparquet.parquet")
+```
+
+## 排序后再写出 GeoParquet
+
+为了最大程度地发挥 Sedona GeoParquet filter pushdown 的性能,建议先按几何对象的 geohash 值(参见 [ST_GeoHash](../../api/sql/Geometry-Output/ST_GeoHash.md))排序,再写出 GeoParquet。示例如下:
+
+```
+SELECT col1, col2, geom, ST_GeoHash(geom, 5) as geohash
+FROM spatialDf
+ORDER BY geohash
+```
+
+接下来更深入地看看 Sedona 是如何利用 GeoParquet 的 bbox 元数据来优化查询的。
+
+## Sedona 如何在 Spark 上利用 GeoParquet 边界框(bbox)元数据
+
+bbox 元数据描述了某个文件中所包含几何对象覆盖的范围。如果查询的区域不与某个文件的边界框相交,引擎在执行查询时即可整体跳过该文件——因为它不可能包含相关数据。
+
+跳过整个文件可以极大提升性能,跳过的数据越多,查询就越快。
+
+下面来看一个由若干点和三个边界框组成的数据集示例:
+
+![GeoParquet bbox](../../image/tutorial/files/geoparquet_bbox1.png)
+
+应用一个空间过滤器,只读取某个区域内的点:
+
+![GeoParquet bbox 过滤](../../image/tutorial/files/geoparquet_bbox2.png)
+
+查询代码:
+
+```python
+my_shape = "POLYGON((4.0 3.5, 4.0 6.0, 8.0 6.0, 8.0 4.5, 4.0 3.5))"
+
+res = sedona.sql(f"""
+select *
+from points
+where st_intersects(geometry, ST_GeomFromWKT('{my_shape}'))
+""")
+res.show(truncate=False)
+```
+
+结果如下:
+
+```
++---+-----------+
+|id |geometry   |
++---+-----------+
+|e  |POINT (5 4)|
+|f  |POINT (6 4)|
+|g  |POINT (6 5)|
++---+-----------+
+```
+
+执行该查询其实并不需要边界框 1 或 3 中的数据,只需要边界框 2 中的点。文件跳过让我们对这个查询只需读取一个文件而非三个。该数据湖中各文件的 bbox 如下:
+
+```
++--------------------------------------------------------------+
+|columns                                                       |
++--------------------------------------------------------------+
+|{geometry -> {WKB, [Point], [2.0, 1.0, 3.0, 3.0], null, NULL}}|
+|{geometry -> {WKB, [Point], [7.0, 1.0, 8.0, 2.0], null, NULL}}|
+|{geometry -> {WKB, [Point], [5.0, 4.0, 6.0, 5.0], null, NULL}}|
++--------------------------------------------------------------+
+```
+
+跳过整个文件能带来显著的性能收益。
+
+## GeoParquet 的优势
+
+如前所述,GeoParquet 相比 CSV、GeoJSON 等行式格式有诸多优势:
+
+* 列裁剪
+* row-group 过滤
+* schema 写在文件尾部
+* 列式数据布局,压缩效果良好
+
+但这些优势仍不足以满足空间数据从业者所需的全部能力。
+
+## GeoParquet 的局限
+
+Parquet 与 GeoParquet 数据湖与其他数据湖一样,存在以下局限:
+
+* 不支持可靠事务
+* 不支持部分数据操作语言(DML),如 update、delete
+* 没有并发保护
+* 与数据库相比,某些操作性能较差
+
+为了克服这些局限,数据社区已逐步迁移到 Iceberg、Delta Lake、Hudi 等开放式表格式。
+
+Iceberg 最近开始支持 geometry 与 geography 列,让数据从业者既能享受开放式表格式的特性,又能复用底层的 Parquet 文件。Iceberg 解决了 GeoParquet 数据湖的局限,支持可靠事务以及 update、delete 等常见操作。
+
+## 结论
+
+GeoParquet 是空间数据社区的一项重要进展。它为地理工程师提供了内嵌 schema、性能优化与对几何列的原生支持。
+
+由于 Iceberg 现已具备 GeoParquet 的全部优秀特性甚至更多,空间数据工程师也可以平滑迁移到 Iceberg。Iceberg 提供了大量实用的开放式表格式特性,几乎在所有场景下都优于纯 GeoParquet(例外情况:永不变更的单文件数据集,或与其他引擎的兼容性需求)。
+
+将工作流从 Shapefile、GeoPackage、CSV、GeoJSON 等传统格式迁移到 GeoParquet/Iceberg 等高性能格式,能立刻提升计算效率。
diff --git a/docs/tutorial/files/stac-sedona-spark.zh.md b/docs/tutorial/files/stac-sedona-spark.zh.md
new file mode 100644
index 0000000000..6028159e79
--- /dev/null
+++ b/docs/tutorial/files/stac-sedona-spark.zh.md
@@ -0,0 +1,468 @@
+<!--
+ 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.
+ -->
+
+# 在 Spark 上使用 Apache Sedona 处理 STAC catalog
+
+STAC 数据源允许您从 SpatioTemporal Asset Catalog(STAC)API 读取数据。该数据源同时支持读取 STAC items 与 collections。
+
+## 用法
+
+要使用 STAC 数据源,可使用 `stac` 格式将 STAC catalog 加载到 Sedona DataFrame。`load` 的路径可以是本地的 STAC collection JSON 文件,也可以是 HTTP/HTTPS 端点。
+
+从本地 collection 文件加载 STAC collection:
+
+```python
+df = sedona.read.format("stac").load("/user/stac_collection.json")
+df.printSchema()
+df.show()
+```
+
+从 S3 上的 collection 文件加载:
+
+```python
+df = sedona.read.format("stac").load(
+    "s3a://example.com/stac_bucket/stac_collection.json"
+)
+df.printSchema()
+df.show()
+```
+
+也可以从 HTTP/HTTPS 端点加载:
+
+```python
+df = sedona.read.format("stac").load(
+    "https://earth-search.aws.element84.com/v1/collections/sentinel-2-pre-c1-l2a"
+)
+df.printSchema()
+df.show()
+```
+
+输出:
+
+```
+root
+ |-- stac_version: string (nullable = false)
+ |-- stac_extensions: array (nullable = true)
+ |    |-- element: string (containsNull = true)
+ |-- type: string (nullable = false)
+ |-- id: string (nullable = false)
+ |-- bbox: array (nullable = true)
+ |    |-- element: double (containsNull = true)
+ |-- geometry: geometry (nullable = true)
+ |-- title: string (nullable = true)
+ |-- description: string (nullable = true)
+ |-- datetime: timestamp (nullable = true)
+ |-- start_datetime: timestamp (nullable = true)
+ |-- end_datetime: timestamp (nullable = true)
+ |-- created: timestamp (nullable = true)
+ |-- updated: timestamp (nullable = true)
+ |-- platform: string (nullable = true)
+ |-- instruments: array (nullable = true)
+ |    |-- element: string (containsNull = true)
+ |-- constellation: string (nullable = true)
+ |-- mission: string (nullable = true)
+ |-- grid:code: string (nullable = true)
+ |-- gsd: double (nullable = true)
+ |-- collection: string (nullable = true)
+ |-- links: array (nullable = true)
+ |    |-- element: struct (containsNull = true)
+ |    |    |-- rel: string (nullable = true)
+ |    |    |-- href: string (nullable = true)
+ |    |    |-- type: string (nullable = true)
+ |    |    |-- title: string (nullable = true)
+ |-- assets: map (nullable = true)
+ |    |-- key: string
+ |    |-- value: struct (valueContainsNull = true)
+ |    |    |-- href: string (nullable = true)
+ |    |    |-- type: string (nullable = true)
+ |    |    |-- title: string (nullable = true)
+ |    |    |-- roles: array (nullable = true)
+ |    |    |    |-- element: string (containsNull = true)
+
++------------+--------------------+-------+--------------------+--------------------+--------------------+-----+-----------+--------------------+--------------+------------+--------------------+--------------------+-----------+-----------+-------------+-------+----+--------------------+--------------------+--------------------+
+|stac_version|     stac_extensions|   type|                  id|                bbox|            geometry|title|description|            datetime|start_datetime|end_datetime|             created|             updated|   platform|instruments|constellation|mission| gsd|          collection|               links|              assets|
++------------+--------------------+-------+--------------------+--------------------+--------------------+-----+-----------+--------------------+--------------+------------+--------------------+--------------------+-----------+-----------+-------------+-------+----+--------------------+--------------------+--------------------+
+|       1.0.0|[https://stac-ext...|Feature|S2B_T21NYC_202212...|[-55.202493, 1.71...|POLYGON ((-55.201...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-01 21:13:...|2024-05-01 21:13:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T21NZC_202212...|[-54.30394, 1.719...|POLYGON ((-54.302...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-03 00:39:...|2024-05-03 00:39:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T22NBH_202212...|[-53.698196, 2.63...|POLYGON ((-53.698...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-03 00:26:...|2024-05-03 00:26:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T21NYD_202212...|[-55.201423, 2.62...|POLYGON ((-55.199...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-01 21:10:...|2024-05-01 21:10:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T21NZD_202212...|[-54.302336, 2.62...|POLYGON ((-54.299...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-03 00:12:...|2024-05-03 00:12:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T22NBJ_202212...|[-53.700535, 2.63...|POLYGON ((-53.700...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-03 00:30:...|2024-05-03 00:30:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T21NYE_202212...|[-55.199906, 3.52...|POLYGON ((-55.197...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-01 21:24:...|2024-05-01 21:24:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T21NZE_202212...|[-54.300062, 3.52...|POLYGON ((-54.296...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-03 00:14:...|2024-05-03 00:14:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T22NBK_202212...|[-53.703548, 3.52...|POLYGON ((-53.703...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-03 00:32:...|2024-05-03 00:32:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
+|       1.0.0|[https://stac-ext...|Feature|S2B_T21NYF_202212...|[-55.197941, 4.42...|POLYGON ((-55.195...| NULL|       NULL|2022-12-05 14:11:...|          NULL|        NULL|2024-05-01 21:43:...|2024-05-01 21:43:...|sentinel-2b|      [msi]|   sentinel-2|   NULL|NULL|sentinel-2-pre-c1...|[{self, https://e...|{red -> {https://...|
++------------+--------------------+-------+--------------------+--------------------+--------------------+-----+-----------+--------------------+--------------+------------+--------------------+--------------------+-----------+-----------+-------------+-------+----+--------------------+--------------------+--------------------+
+```
+
+## 谓词下推(Filter Pushdown)
+
+STAC 数据源支持把空间和时间过滤下推到底层数据源,减少需要读取的数据量。
+
+### 空间过滤下推
+
+空间过滤下推让数据源能够直接在数据源层应用空间谓词(如 `st_intersects`),从而减少传输与处理的数据量。
+
+### 时间过滤下推
+
+时间过滤下推让数据源能够直接在数据源层应用时间谓词(如 `BETWEEN`、`>=`、`<=`),同样可以减少传输与处理的数据量。
+
+## 示例
+
+下面的示例假设 STAC 数据源已经被加载到名为 `STAC_TABLE` 的表中。
+
+### 不带过滤的 SQL Select
+
+```sql
+SELECT id, datetime as dt, geometry, bbox FROM STAC_TABLE
+```
+
+### 带时间过滤的 SQL Select
+
+```sql
+  SELECT id, datetime as dt, geometry, bbox
+  FROM STAC_TABLE
+  WHERE datetime BETWEEN '2020-01-01' AND '2020-12-13'
+```
+
+该例中,数据源会把时间过滤下推到底层数据源。
+
+### 带空间过滤的 SQL Select
+
+```sql
+  SELECT id, geometry
+  FROM STAC_TABLE
+  WHERE st_intersects(ST_GeomFromText('POLYGON((17 10, 18 10, 18 11, 17 11, 17 10))'), geometry)
+```
+
+该例中,数据源会把空间过滤下推到底层数据源。
+
+### Sedona 的 STAC 读取器配置
+
+在 Sedona 中使用 STAC 读取器时,可通过若干配置项控制读取行为,通常以 `Map[String, String]` 形式传入。下列是核心 Sedona 配置项:
+
+- **spark.sedona.stac.load.maxPartitionItemFiles**:单个分区中可包含的最大 item 文件数量,用于控制分区大小。默认 `-1`,表示由系统自动决定。
+
+- **spark.sedona.stac.load.numPartitions**:为 STAC 数据创建的分区数,便于控制数据分布与并行度。默认 `-1`,表示由系统自动决定。
+
+下面是 STAC 读取器的常见 reader option:
+
+- **itemsLimitMax**:从 STAC collection 加载的 item 数量上限,便于限制处理规模。默认 `-1`,表示加载全部 item。
+
+- **itemsLoadProcessReportThreshold**:item 加载进度的报告阈值。默认 `1000000`,即每加载 100 万个 item 报告一次进度。
+
+- **itemsLimitPerRequest**:单次 API 请求中获取的最大 item 数。默认 `10`。
+
+- **headers**:STAC API 请求中携带的 HTTP 头,应是 JSON 编码的字符串,包含一系列键值对。可用于鉴权或自定义头。例如:`{"Authorization": "Basic <base64_credentials>"}`
+
+可以将这些配置合并到一个 `Map[String, String]` 中传给 STAC 读取器:
+
+```scala
+  def defaultSparkConfig: Map[String, String] = Map(
+    "spark.sedona.stac.load.maxPartitionItemFiles" -> "100",
+    "spark.sedona.stac.load.numPartitions" -> "10",
+    "spark.sedona.stac.load.itemsLimitMax" -> "20")
+
+  val sparkSession: SparkSession = {
+    val builder = SedonaContext
+            .builder()
+            .master("local[*]")
+    defaultSparkConfig.foreach { case (key, value) => builder.config(key, value) }
+    builder.getOrCreate()
+  }
+
+ df = sedona.read
+      .format("stac")
+      .option("itemsLimitMax", "100")
+      .option("itemsLoadProcessReportThreshold", "2000000")
+      .option("itemsLimitPerRequest", "100")
+      .load("https://earth-search.aws.element84.com/v1/collections/sentinel-2-pre-c1-l2a")
+```
+
+通过以上选项,可以对 Sedona 中 STAC 数据的读取与处理过程进行细粒度的控制。
+
+## Python API
+
+Python API 让您可以通过 Client 类与 STAC API 交互。它提供了打开 STAC API 连接、获取 collection、按多种条件搜索 item 的方法。
+
+### 示例代码
+
+#### 初始化客户端
+
+```python
+from sedona.spark.stac import Client
+
+# 初始化客户端
+client = Client.open("https://planetarycomputer.microsoft.com/api/stac/v1")
+```
+
+#### 在某个 collection 中按年份搜索
+
+```python
+items = client.search(
+    collection_id="aster-l1t", datetime="2020", return_dataframe=False
+)
+```
+
+#### 在某个 collection 中按月份搜索并限制最大返回数
+
+```python
+items = client.search(
+    collection_id="aster-l1t", datetime="2020-05", return_dataframe=False, max_items=5
+)
+```
+
+#### 按 bbox 与时间区间搜索
+
+```python
+items = client.search(
+    collection_id="aster-l1t",
+    ids=["AST_L1T_00312272006020322_20150518201805"],
+    bbox=[-180.0, -90.0, 180.0, 90.0],
+    datetime=["2006-01-01T00:00:00Z", "2007-01-01T00:00:00Z"],
+    return_dataframe=False,
+)
+```
+
+#### 按多个 bbox 搜索
+
+```python
+bbox_list = [[-180.0, -90.0, 180.0, 90.0], [-100.0, -50.0, 100.0, 50.0]]
+items = client.search(collection_id="aster-l1t", bbox=bbox_list, return_dataframe=False)
+```
+
+#### 在多个时间区间内搜索并以 DataFrame 返回
+
+```python
+interval_list = [
+    ["2020-01-01T00:00:00Z", "2020-06-01T00:00:00Z"],
+    ["2020-07-01T00:00:00Z", "2021-01-01T00:00:00Z"],
+]
+df = client.search(
+    collection_id="aster-l1t", datetime=interval_list, return_dataframe=True
+)
+df.show()
+```
+
+#### 同时使用 bbox 与时间将 item 写入 GeoParquet
+
+```python
+# 将 DataFrame 中的 item 写入 GeoParquet,同时指定 bbox 与时间
+client.get_collection("aster-l1t").save_to_geoparquet(
+    output_path="/path/to/output", bbox=bbox_list, datetime="2020-05"
+)
+```
+
+以上示例演示了如何使用 Client 类按各种条件检索 STAC collection,并以 PyStacItem 迭代器或 Spark DataFrame 的形式返回。
+
+### 鉴权
+
+许多 STAC 服务都需要鉴权才能访问数据。STAC 客户端支持多种鉴权方式:HTTP Basic Authentication、Bearer Token Authentication,以及自定义 HTTP 头。
+
+#### Basic 认证
+
+Basic 认证通常用于 API key 或用户名/密码组合。许多服务(如 Planet Labs)会把 API key 作为用户名,密码留空。
+
+```python
+from sedona.spark.stac import Client
+
+# 示例 1:使用 API key(常见模式)
+client = Client.open("https://api.example.com/stac/v1")
+client.with_basic_auth("your_api_key_here", "")
+
+# 在认证状态下搜索 item
+df = client.search(collection_id="example-collection", max_items=10)
+df.show()
+
+# 示例 2:使用用户名与密码
+client = Client.open("https://api.example.com/stac/v1")
+client.with_basic_auth("username", "password")
+
+df = client.search(collection_id="example-collection", max_items=10)
+df.show()
+
+# 示例 3:链式调用
+df = (
+    Client.open("https://api.example.com/stac/v1")
+    .with_basic_auth("your_api_key", "")
+    .search(collection_id="example-collection", max_items=10)
+)
+df.show()
+```
+
+#### Bearer Token 认证
+
+Bearer Token 认证常与 OAuth2 token 或 JWT token 一起使用。注意:某些服务可能仅支持特定的鉴权方式。
+
+```python
+from sedona.spark.stac import Client
+
+# 使用 bearer token
+client = Client.open("https://api.example.com/stac/v1")
+client.with_bearer_token("your_access_token_here")
+
+df = client.search(collection_id="example-collection", max_items=10)
+df.show()
+
+# 链式调用
+df = (
+    Client.open("https://api.example.com/stac/v1")
+    .with_bearer_token("your_token")
+    .search(collection_id="example-collection", max_items=10)
+)
+df.show()
+```
+
+#### 自定义 HTTP 头
+
+也可以在创建客户端时直接传入自定义 HTTP 头,适用于鉴权方式较为特殊的服务。
+
+```python
+from sedona.spark.stac import Client
+
+# 使用自定义 HTTP 头
+headers = {"Authorization": "Bearer your_token_here", "X-Custom-Header": "custom_value"}
+client = Client.open("https://api.example.com/stac/v1", headers=headers)
+
+df = client.search(collection_id="example-collection", max_items=10)
+df.show()
+```
+
+#### 在 Scala DataSource 中使用鉴权
+
+直接在 Scala 或 Spark SQL 中使用 STAC 数据源时,可以把鉴权 HTTP 头作为 JSON 编码的 option 传入:
+
+```python
+import json
+from pyspark.sql import SparkSession
+
+# 准备鉴权 HTTP 头
+headers = {"Authorization": "Basic <base64_encoded_credentials>"}
+headers_json = json.dumps(headers)
+
+# 在鉴权状态下加载 STAC 数据
+df = (
+    spark.read.format("stac")
+    .option("headers", headers_json)
+    .load("https://api.example.com/stac/v1/collections/example-collection")
+)
+
+df.show()
+```
+
+```scala
+// Scala 示例
+val headersJson = """{"Authorization":"Basic <base64_encoded_credentials>"}"""
+
+val df = sparkSession.read
+  .format("stac")
+  .option("headers", headersJson)
+  .load("https://api.example.com/stac/v1/collections/example-collection")
+
+df.show()
+```
+
+#### 注意事项
+
+- **鉴权方式互斥**:设置新的鉴权方式会覆盖此前的 Authorization 头,但不会影响其他自定义 HTTP 头。
+- **HTTP 头会向下传播**:在 Client 上设置的 HTTP 头会自动应用到后续的 collection 与 item 请求。
+- **不同服务有不同的要求**:不同 STAC 服务可能要求不同的鉴权方式。例如 Planet Labs 在访问 collection 时需要 Basic 认证,而非 Bearer Token。
+- **向后兼容**:所有鉴权参数都是可选的。原本访问无需鉴权的公开 STAC 服务的代码不受影响,可继续使用。
+
+### 方法
+
+**`open(url: str, headers: Optional[dict] = None) -> Client`**
+打开到指定 STAC API URL 的连接。
+
+参数:
+
+* `url` (*str*):要连接的 STAC API URL。例如:`"https://planetarycomputer.microsoft.com/api/stac/v1"`
+* `headers` (*Optional[dict]*):可选的 HTTP 头字典,用于鉴权或自定义头。例如:`{"Authorization": "Bearer token123"}`
+
+返回:
+
+* `Client`:连接到指定 URL 的 `Client` 实例。
+
+---
+
+**`with_basic_auth(username: str, password: str) -> Client`**
+为客户端启用 HTTP Basic 认证。
+
+该方法会将用户名与密码进行 Base64 编码,并添加相应的 Authorization 头。
+
+参数:
+
+* `username` (*str*):用户名。对于 API key,此项通常就是 API key 本身。例如 `"your_api_key"`。
+* `password` (*str*):密码。对于 API key 通常留空。例如 `""`。
+
+返回:
+
+* `Client`:返回自身以便链式调用。
+
+---
+
+**`with_bearer_token(token: str) -> Client`**
+为客户端启用 Bearer Token 认证。
+
+该方法会添加 Bearer Token 形式的 Authorization 头,常用于 OAuth2 与 API token 场景。
+
+参数:
+
+* `token` (*str*):用于鉴权的 bearer token。例如 `"your_access_token_here"`。
+
+返回:
+
+* `Client`:返回自身以便链式调用。
+
+---
+
+**`get_collection(collection_id: str) -> CollectionClient`**
+按 collection ID 获取对应的 CollectionClient。
+
+参数:
+
+* `collection_id` (*str*):collection 的 ID。例如 `"aster-l1t"`。
+
+返回:
+
+* `CollectionClient`:对应 collection 的 `CollectionClient` 实例。
+
+---
+
+**`search(*ids: Union[str, list], collection_id: str, bbox: Optional[list] = None, datetime: Optional[Union[str, datetime.datetime, list]] = None, max_items: Optional[int] = None, return_dataframe: bool = True) -> Union[Iterator[PyStacItem], DataFrame]`**
+在指定 collection 中按可选过滤条件搜索 item。
+
+参数:
+
+* `ids` (*Union[str, list]*):可变数量的 item ID,用于过滤。例如 `"item_id1"` 或 `["item_id1", "item_id2"]`。
+* `collection_id` (*str*):要搜索的 collection ID。例如 `"aster-l1t"`。
+* `bbox` (*Optional[list]*):用于过滤 item 的边界框列表,每项形如 `[min_lon, min_lat, max_lon, max_lat]`。例如 `[[ -180.0, -90.0, 180.0, 90.0 ]]`。
+* `datetime` (*Optional[Union[str, datetime.datetime, list]]*):单个日期时间、符合 RFC 3339 的时间戳,或一组时间区间。例如 `"2020-01-01T00:00:00Z"`、`datetime.datetime(2020, 1, 1)`、`[["2020-01-01T00:00:00Z", "2021-01-01T00:00:00Z"]]`。
+* `max_items` (*Optional[int]*):返回 item 的最大数量。例如 `100`。
+* `return_dataframe` (*bool*):若为 `True`(默认),返回 Spark DataFrame,而不是 `PyStacItem` 迭代器。例如 `True`。
+
+返回:
+
+* *Union[Iterator[PyStacItem], DataFrame]*:与过滤条件匹配的 `PyStacItem` 迭代器或 Spark DataFrame。
+
+## 参考
+
+- STAC 规范:https://stacspec.org/
+
+- STAC Browser:https://github.com/radiantearth/stac-browser
diff --git a/docs/tutorial/flink/sql.zh.md b/docs/tutorial/flink/sql.zh.md
new file mode 100644
index 0000000000..5d7276c507
--- /dev/null
+++ b/docs/tutorial/flink/sql.zh.md
@@ -0,0 +1,511 @@
+<!--
+ 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.
+ -->
+
+本页介绍如何使用 SedonaSQL 管理空间数据。==示例代码以 Java 编写,但同样适用于 Scala==。
+
+SedonaSQL 支持 SQL/MM Part3 空间 SQL 标准,提供四类 SQL 算子(如下文所示),所有算子都可以直接通过以下方式调用:
+
+```java
+Table myTable = tableEnv.sqlQuery("YOUR_SQL")
+```
+
+SedonaSQL 详细的 API 说明请参阅 [SedonaSQL API](../../api/flink/Overview.md)。
+
+## 配置依赖
+
+1. 阅读 [Sedona Maven Central 坐标](../../setup/maven-coordinates.md)
+2. 在 build.sbt 或 pom.xml 中添加 Sedona 依赖
+3. 在 build.sbt 或 pom.xml 中添加 [Flink 依赖](https://nightlies.apache.org/flink/flink-docs-master/docs/dev/configuration/overview/)
+4. 参考 [SQL 示例项目](../demo.md)
+
+## 初始化 Stream Environment
+
+在程序起始处使用以下代码初始化 `StreamExecutionEnvironment`:
+
+```java
+StreamExecutionEnvironment env = StreamExecutionEnvironment.getExecutionEnvironment();
+EnvironmentSettings settings = EnvironmentSettings.newInstance().inStreamingMode().build();
+StreamTableEnvironment tableEnv = StreamTableEnvironment.create(env, settings);
+```
+
+## 初始化 SedonaContext
+
+在创建好 `StreamExecutionEnvironment` 与 `StreamTableEnvironment` 后,添加以下代码:
+
+==Sedona >= 1.4.1==
+
+```java
+StreamTableEnvironment sedona = SedonaContext.create(env, tableEnv);
+```
+
+==Sedona <1.4.1==
+
+下面这种方式自 Sedona 1.4.1 起已弃用,请改用上面的方式创建 SedonaContext。
+
+```java
+SedonaFlinkRegistrator.registerType(env);
+SedonaFlinkRegistrator.registerFunc(tableEnv);
+```
+
+!!!warning
+	Sedona 内置了一套高效的几何与索引序列化器,忘记启用它们会导致内存占用过高。
+
+该函数会注册 Sedona 的用户自定义类型与用户自定义函数。
+
+## 创建 Geometry 类型列
+
+SedonaSQL 中所有几何运算都作用在 Geometry 类型对象上。因此在执行任何查询之前,需要先在 DataFrame 上构造一列 Geometry 类型列。
+
+假设有一张如下的 Flink Table `tbl`:
+
+```
++----+--------------------------------+--------------------------------+
+| op |                   geom_polygon |                   name_polygon |
++----+--------------------------------+--------------------------------+
+| +I | POLYGON ((-0.5 -0.5, -0.5 0... |                       polygon0 |
+| +I | POLYGON ((0.5 0.5, 0.5 1.5,... |                       polygon1 |
+| +I | POLYGON ((1.5 1.5, 1.5 2.5,... |                       polygon2 |
+| +I | POLYGON ((2.5 2.5, 2.5 3.5,... |                       polygon3 |
+| +I | POLYGON ((3.5 3.5, 3.5 4.5,... |                       polygon4 |
+| +I | POLYGON ((4.5 4.5, 4.5 5.5,... |                       polygon5 |
+| +I | POLYGON ((5.5 5.5, 5.5 6.5,... |                       polygon6 |
+| +I | POLYGON ((6.5 6.5, 6.5 7.5,... |                       polygon7 |
+| +I | POLYGON ((7.5 7.5, 7.5 8.5,... |                       polygon8 |
+| +I | POLYGON ((8.5 8.5, 8.5 9.5,... |                       polygon9 |
++----+--------------------------------+--------------------------------+
+10 rows in set
+```
+
+可以这样创建一张带有 Geometry 类型列的 Table:
+
+```java
+sedona.createTemporaryView("myTable", tbl)
+Table geomTbl = sedona.sqlQuery("SELECT ST_GeomFromWKT(geom_polygon) as geom_polygon, name_polygon FROM myTable")
+geomTbl.execute().print()
+```
+
+输出如下:
+
+```
++----+--------------------------------+--------------------------------+
+| op |                   geom_polygon |                   name_polygon |
++----+--------------------------------+--------------------------------+
+| +I | POLYGON ((-0.5 -0.5, -0.5 0... |                       polygon0 |
+| +I | POLYGON ((0.5 0.5, 0.5 1.5,... |                       polygon1 |
+| +I | POLYGON ((1.5 1.5, 1.5 2.5,... |                       polygon2 |
+| +I | POLYGON ((2.5 2.5, 2.5 3.5,... |                       polygon3 |
+| +I | POLYGON ((3.5 3.5, 3.5 4.5,... |                       polygon4 |
+| +I | POLYGON ((4.5 4.5, 4.5 5.5,... |                       polygon5 |
+| +I | POLYGON ((5.5 5.5, 5.5 6.5,... |                       polygon6 |
+| +I | POLYGON ((6.5 6.5, 6.5 7.5,... |                       polygon7 |
+| +I | POLYGON ((7.5 7.5, 7.5 8.5,... |                       polygon8 |
+| +I | POLYGON ((8.5 8.5, 8.5 9.5,... |                       polygon9 |
++----+--------------------------------+--------------------------------+
+10 rows in set
+```
+
+虽然外观与输入一致,但 `geom_polygon` 列的类型已经变为 ==Geometry==。
+
+可以打印 schema 进行验证:
+
+```java
+geomTbl.printSchema()
+```
+
+输出:
+
+```
+(
+  `geom_polygon` RAW('org.locationtech.jts.geom.Geometry', '...'),
+  `name_polygon` STRING
+)
+```
+
+!!!note
+	SedonaSQL 提供了大量构造 Geometry 列的函数,详见 [SedonaSQL 构造器 API](../../api/flink/Geometry-Functions.md)。
+
+## 转换坐标参考系
+
+Sedona 不会自动管理一列 Geometry 中所有几何对象的坐标单位(基于度还是基于米)。SedonaSQL 中所有相关距离的单位与 Geometry 列中几何对象的单位保持一致。
+
+如需对前面创建的 Geometry 列进行 CRS 转换,可使用以下代码:
+
+```java
+Table geomTbl3857 = sedona.sqlQuery("SELECT ST_Transform(countyshape, "epsg:4326", "epsg:3857") AS geom_polygon, name_polygon FROM myTable")
+geomTbl3857.execute().print()
+```
+
+`ST_Transform` 第一个 EPSG 代码 EPSG:4326 是源 CRS——也就是最常见的基于度的 CRS(WGS84)。
+
+`ST_Transform` 第二个 EPSG 代码 EPSG:3857 是目标 CRS——最常见的基于米的 CRS。
+
+`ST_Transform` 会把这些几何对象的 CRS 从 EPSG:4326 转换到 EPSG:3857。详细的 CRS 信息可以在 [EPSG.io](https://epsg.io/) 找到。
+
+!!!note
+	了解不同的空间查询谓词请阅读 [SedonaSQL ST_Transform API](../../api/flink/Spatial-Reference-System/ST_Transform.md)。
+
+例如,存储美国坐标的 Table 转换前后会变为如下样子:
+
+转换前:
+
+```
++----+--------------------------------+--------------------------------+
+| op |                     geom_point |                     name_point |
++----+--------------------------------+--------------------------------+
+| +I |                POINT (32 -118) |                          point |
+| +I |                POINT (33 -117) |                          point |
+| +I |                POINT (34 -116) |                          point |
+| +I |                POINT (35 -115) |                          point |
+| +I |                POINT (36 -114) |                          point |
+| +I |                POINT (37 -113) |                          point |
+| +I |                POINT (38 -112) |                          point |
+| +I |                POINT (39 -111) |                          point |
+| +I |                POINT (40 -110) |                          point |
+| +I |                POINT (41 -109) |                          point |
++----+--------------------------------+--------------------------------+
+```
+
+转换后:
+
+```
++----+--------------------------------+--------------------------------+
+| op |                            _c0 |                     name_point |
++----+--------------------------------+--------------------------------+
+| +I | POINT (-13135699.91360628 3... |                          point |
+| +I | POINT (-13024380.422813008 ... |                          point |
+| +I | POINT (-12913060.932019735 ... |                          point |
+| +I | POINT (-12801741.44122646 4... |                          point |
+| +I | POINT (-12690421.950433187 ... |                          point |
+| +I | POINT (-12579102.459639912 ... |                          point |
+| +I | POINT (-12467782.96884664 4... |                          point |
+| +I | POINT (-12356463.478053367 ... |                          point |
+| +I | POINT (-12245143.987260092 ... |                          point |
+| +I | POINT (-12133824.496466817 ... |                          point |
++----+--------------------------------+--------------------------------+
+```
+
+构造完 Geometry 类型列后,即可执行各类空间查询。
+
+## 范围查询
+
+使用 ==ST_Contains==、==ST_Intersects== 等谓词可以在单列上执行范围查询。
+
+下例查找位于给定多边形内的所有 county:
+
+```java
+geomTable = sedona.sqlQuery(
+  "
+    SELECT *
+    FROM spatialdf
+    WHERE ST_Contains (ST_PolygonFromEnvelope(1.0,100.0,1000.0,1100.0), newcountyshape)
+  ")
+geomTable.execute().print()
+```
+
+!!!note
+	了解不同的空间查询谓词请阅读 [SedonaSQL Predicate API](../../api/flink/Geometry-Functions.md#predicates)。
+
+## KNN 查询
+
+使用 ==ST_Distance== 计算距离并排序。
+
+下面的代码返回距离给定多边形最近的 5 个对象:
+
+```java
+geomTable = sedona.sqlQuery(
+  "
+    SELECT countyname, ST_Distance(ST_PolygonFromEnvelope(1.0,100.0,1000.0,1100.0), newcountyshape) AS distance
+    FROM geomTable
+    ORDER BY distance DESC
+    LIMIT 5
+  ")
+geomTable.execute().print()
+```
+
+## 连接查询
+
+下面的等值连接借助 Flink 内置的 equi-join 算法。可以选择跳过 Sedona 的 refinement 步骤来牺牲一部分查询精度。完整示例可参考 [SQL 示例项目](../demo.md)。
+
+操作步骤如下:
+
+### 1. 为两张表生成 S2 ID
+
+使用 [ST_S2CellIds](../../api/flink/Spatial-Indexing/ST_S2CellIDs.md) 为每个几何对象生成 cell ID,单个几何对象可能产生多个 ID。
+
+```sql
+SELECT id, geom, name, ST_S2CellIDs(geom, 15) as idarray
+FROM lefts
+```
+
+```sql
+SELECT id, geom, name, ST_S2CellIDs(geom, 15) as idarray
+FROM rights
+```
+
+### 2. 展开 ID 数组
+
+S2 cell ID 是整数数组,需要把它们展开成多行,以便后续按 ID 进行连接。
+
+```
+SELECT id, geom, name, cellId
+FROM lefts CROSS JOIN UNNEST(lefts.idarray) AS tmpTbl1(cellId)
+```
+
+```
+SELECT id, geom, name, cellId
+FROM rights CROSS JOIN UNNEST(rights.idarray) AS tmpTbl2(cellId)
+```
+
+### 3. 执行等值连接
+
+按 S2 cellId 对两张表做等值连接:
+
+```sql
+SELECT lcs.id as lcs_id, lcs.geom as lcs_geom, lcs.name as lcs_name, rcs.id as rcs_id, rcs.geom as rcs_geom, rcs.name as rcs_name
+FROM lcs JOIN rcs ON lcs.cellId = rcs.cellId
+```
+
+### 4. 可选:refine 结果
+
+由于 S2 cellId 的特性,连接结果可能存在少量假阳性,具体程度取决于 S2 level 的选择:level 越小,cell 越大,展开行数越少,但假阳性越多。
+
+为了保证正确性,可使用任一 [空间谓词](../../api/sql/Geometry-Functions.md#predicates) 过滤掉假阳性,将下面的查询替换步骤 3 中的查询:
+
+```sql
+SELECT lcs.id as lcs_id, lcs.geom as lcs_geom, lcs.name as lcs_name, rcs.id as rcs_id, rcs.geom as rcs_geom, rcs.name as rcs_name
+FROM lcs, rcs
+WHERE lcs.cellId = rcs.cellId AND ST_Contains(lcs.geom, rcs.geom)
+```
+
+可以看到,这里相比步骤 2 的查询多加了一个 `ST_Contains` 过滤来剔除假阳性,也可以使用 `ST_Intersects` 等其他谓词。
+
+!!!tip
+	如果不要求 100% 的准确度且希望更快的查询速度,可以跳过此步骤。
+
+### 5. 可选:去重
+
+由于生成 S2 cellId 时使用了展开操作,结果 DataFrame 中可能出现 `<lcs_geom, rcs_geom>` 重复匹配。可以通过 GroupBy 查询去重:
+
+```sql
+SELECT lcs_id, rcs_id, FIRST_VALUE(lcs_geom), FIRST_VALUE(lcs_name), first(rcs_geom), first(rcs_name)
+FROM joinresult
+GROUP BY (lcs_id, rcs_id)
+```
+
+`FIRST_VALUE` 函数用于在多个重复值中取第一个。
+
+如果没有为每个几何对象提供唯一 ID,也可以直接按几何分组:
+
+```sql
+SELECT lcs_geom, rcs_geom, first(lcs_name), first(rcs_name)
+FROM joinresult
+GROUP BY (lcs_geom, rcs_geom)
+```
+
+!!!note
+	做点-多边形 join 时不会出现该问题,可以放心忽略;只有 polygon-polygon、polygon-linestring、linestring-linestring 等连接才会遇到此问题。
+
+### 距离连接中的 S2 用法
+
+S2 同样适用于距离连接。先使用 `ST_Buffer(geometry, distance)` 把其中一列原始几何对象包裹起来。如果原始几何对象是点,`ST_Buffer` 会把它们变成半径为 `distance` 的圆。
+
+例如,在步骤 1 之前,先在左表上运行:
+
+```sql
+SELECT id, ST_Buffer(geom, DISTANCE), name
+FROM lefts
+```
+
+由于坐标位于经纬度系统中,`distance` 的单位应为度而不是米或英里。可以根据实际米值估算对应的度数,可借助 [此换算工具](https://lucidar.me/en/online-unit-converter-length-to-angle/convert-degrees-to-meters/#online-converter)。
+
+## 把空间 Table 转换为空间 DataStream
+
+### 获取 DataStream
+
+使用 TableEnv 的 `toDataStream` 函数:
+
+```java
+DataStream<Row> geomStream = sedona.toDataStream(geomTable)
+```
+
+### 取出 Geometry
+
+接着用 Map 从每个 Row 对象中取出 Geometry:
+
+```java
+import org.locationtech.jts.geom.Geometry;
+
+DataStream<Geometry> geometries = geomStream.map(new MapFunction<Row, Geometry>() {
+            @Override
+            public Geometry map(Row value) throws Exception {
+                return (Geometry) value.getField(0);
+            }
+        });
+geometries.print();
+```
+
+输出如下:
+
+```
+14> POLYGON ((1.5 1.5, 1.5 2.5, 2.5 2.5, 2.5 1.5, 1.5 1.5))
+2> POLYGON ((5.5 5.5, 5.5 6.5, 6.5 6.5, 6.5 5.5, 5.5 5.5))
+5> POLYGON ((8.5 8.5, 8.5 9.5, 9.5 9.5, 9.5 8.5, 8.5 8.5))
+16> POLYGON ((3.5 3.5, 3.5 4.5, 4.5 4.5, 4.5 3.5, 3.5 3.5))
+12> POLYGON ((-0.5 -0.5, -0.5 0.5, 0.5 0.5, 0.5 -0.5, -0.5 -0.5))
+13> POLYGON ((0.5 0.5, 0.5 1.5, 1.5 1.5, 1.5 0.5, 0.5 0.5))
+15> POLYGON ((2.5 2.5, 2.5 3.5, 3.5 3.5, 3.5 2.5, 2.5 2.5))
+3> POLYGON ((6.5 6.5, 6.5 7.5, 7.5 7.5, 7.5 6.5, 6.5 6.5))
+1> POLYGON ((4.5 4.5, 4.5 5.5, 5.5 5.5, 5.5 4.5, 4.5 4.5))
+4> POLYGON ((7.5 7.5, 7.5 8.5, 8.5 8.5, 8.5 7.5, 7.5 7.5))
+```
+
+### 在 Geometry 中保存非空间属性
+
+可以把其他非空间属性拼接到 Geometry 的 `userData` 字段中保存,便于后续恢复。`userData` 字段可以是任意对象类型。
+
+```java
+import org.locationtech.jts.geom.Geometry;
+
+DataStream<Geometry> geometries = geomStream.map(new MapFunction<Row, Geometry>() {
+            @Override
+            public Geometry map(Row value) throws Exception {
+                Geometry geom = (Geometry) value.getField(0);
+                geom.setUserData(value.getField(1));
+                return geom;
+            }
+        });
+geometries.print();
+```
+
+`print` 命令不会输出 `userData` 字段。可以这样获取:
+
+```java
+import org.locationtech.jts.geom.Geometry;
+
+geometries.map(new MapFunction<Geometry, String>() {
+            @Override
+            public String map(Geometry value) throws Exception
+            {
+                return (String) value.getUserData();
+            }
+        }).print();
+```
+
+输出如下:
+
+```
+13> polygon9
+6> polygon2
+10> polygon6
+11> polygon7
+5> polygon1
+12> polygon8
+8> polygon4
+4> polygon0
+7> polygon3
+9> polygon5
+```
+
+## 把空间 DataStream 转换为空间 Table
+
+### 使用 Sedona 的 FormatUtils 创建 Geometry
+
+* 从 WKT 字符串创建 Geometry
+
+```java
+import org.apache.sedona.common.utils.FormatUtils;
+import org.locationtech.jts.geom.Geometry;
+
+DataStream<Geometry> geometries = text.map(new MapFunction<String, Geometry>() {
+            @Override
+            public Geometry map(String value) throws Exception
+            {
+                FormatUtils formatUtils = new FormatUtils(FileDataSplitter.WKT, false);
+                return formatUtils.readGeometry(value);
+            }
+        })
+```
+
+* 从字符串 `1.1, 2.2` 创建 Point,使用 `,` 作为分隔符。
+
+```java
+import org.apache.sedona.common.utils.FormatUtils;
+import org.locationtech.jts.geom.Geometry;
+
+DataStream<Geometry> geometries = text.map(new MapFunction<String, Geometry>() {
+            @Override
+            public Geometry map(String value) throws Exception
+            {
+                FormatUtils<Geometry> formatUtils = new FormatUtils(",", false, GeometryType.POINT);
+                return formatUtils.readGeometry(value);
+            }
+        })
+```
+
+* 从字符串 `1.1, 1.1, 10.1, 10.1` 创建 Polygon,表示以 (1.1, 1.1) 与 (10.1, 10.1) 为最小/最大角点的矩形。
+
+```java
+import org.apache.sedona.common.utils.FormatUtils;
+import org.locationtech.jts.geom.GeometryFactory;
+import org.locationtech.jts.geom.Geometry;
+
+DataStream<Geometry> geometries = text.map(new MapFunction<String, Geometry>() {
+            @Override
+            public Geometry map(String value) throws Exception
+            {
+            	  // 在此实现 minX、minY、maxX、maxY 四个 double 值的解析逻辑
+            	  ...
+	            Coordinate[] coordinates = new Coordinate[5];
+	            coordinates[0] = new Coordinate(minX, minY);
+	            coordinates[1] = new Coordinate(minX, maxY);
+	            coordinates[2] = new Coordinate(maxX, maxY);
+	            coordinates[3] = new Coordinate(maxX, minY);
+	            coordinates[4] = coordinates[0];
+	            GeometryFactory geometryFactory = new GeometryFactory();
+	            return geometryFactory.createPolygon(coordinates);
+            }
+        })
+```
+
+### 创建 Row 对象
+
+把 Geometry 包进 Flink Row 中放入 `geomStream`。也可以在 Row 中放入其他属性。本例为所有几何对象赋了同一个常量 `myName`。
+
+```java
+import org.apache.sedona.common.utils.FormatUtils;
+import org.locationtech.jts.geom.Geometry;
+import org.apache.flink.types.Row;
+
+DataStream<Row> geomStream = text.map(new MapFunction<String, Row>() {
+            @Override
+            public Row map(String value) throws Exception
+            {
+                FormatUtils formatUtils = new FormatUtils(FileDataSplitter.WKT, false);
+                return Row.of(formatUtils.readGeometry(value), "myName");
+            }
+        })
+```
+
+### 得到空间 Table
+
+使用 TableEnv 的 `fromDataStream` 函数,并指定列名 `geom` 与 `geom_name`:
+
+```java
+Table geomTable = sedona.fromDataStream(geomStream, "geom", "geom_name")
+```
diff --git a/docs/tutorial/geopandas-api.zh.md b/docs/tutorial/geopandas-api.zh.md
new file mode 100644
index 0000000000..fe6b356861
--- /dev/null
+++ b/docs/tutorial/geopandas-api.zh.md
@@ -0,0 +1,398 @@
+<!--
+ 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.
+ -->
+
+# Apache Sedona 上的 GeoPandas API
+
+Apache Sedona 上的 GeoPandas API 提供了与 GeoPandas 一致的接口,可以让您的地理空间分析突破单机的局限。该 API 把熟悉的 GeoPandas DataFrame 语法与 Apache Sedona 在 Apache Spark 上的分布式处理能力结合起来,让您能够使用同样的代码模式处理行星级(planetary-scale)的数据集。
+
+## 概览
+
+### 什么是 Apache Sedona 的 GeoPandas API?
+
+Apache Sedona 的 GeoPandas API 是一层兼容层,让您能够在分布式地理空间数据上使用 GeoPandas 风格的操作。您原有的 GeoPandas 代码不再受限于单机处理能力,可以充分利用 Apache Spark 集群进行大规模地理空间分析。
+
+### 主要优势
+
+- **熟悉的 API**:使用您已经熟悉的 GeoPandas 语法与方法
+- **分布式处理**:突破单机限制,处理大规模数据集
+- **惰性求值**:受益于 Apache Sedona 的查询优化与延迟执行
+- **高性能**:利用分布式计算高效完成复杂的地理空间运算
+- **平滑迁移**:以最少的代码改动迁移现有 GeoPandas 工作流
+
+## 准备工作
+
+Apache Sedona 的 GeoPandas API 通过 PySpark 的 pandas-on-Spark 集成自动管理 SparkSession。准备方式有两种:
+
+### 方式 1:自动创建 SparkSession(推荐)
+
+GeoPandas API 会自动使用 PySpark 的默认 SparkSession:
+
+```python
+from sedona.spark.geopandas import GeoDataFrame, read_parquet
+
+# 无需显式配置 SparkSession,使用默认会话
+# API 会自动初始化 Sedona context
+```
+
+### 方式 2:手动配置 SparkSession
+
+如果需要自定义 SparkSession,或需要在某些环境下显式控制:
+
+```python
+from sedona.spark.geopandas import GeoDataFrame, read_parquet
+from sedona.spark import SedonaContext
+
+# 创建并配置 SparkSession
+config = SedonaContext.builder().getOrCreate()
+sedona = SedonaContext.create(config)
+
+# GeoPandas API 会使用上面配置好的会话
+```
+
+### 方式 3:复用现有 SparkSession
+
+如果已有 SparkSession(如 Databricks、EMR 等托管环境):
+
+```python
+from sedona.spark.geopandas import GeoDataFrame, read_parquet
+from sedona.spark import SedonaContext
+
+# 复用现有 SparkSession(如 Databricks 中的 `spark`)
+sedona = SedonaContext.create(spark)  # `spark` 即已有会话
+```
+
+### SparkSession 是如何被管理的
+
+GeoPandas API 借助 PySpark 的 pandas-on-Spark 自动管理 SparkSession 生命周期:
+
+1. **默认会话**:导入 `sedona.spark.geopandas` 时,会自动通过 `pyspark.pandas.utils.default_session()` 获取 PySpark 的默认会话。
+
+2. **自动注册 Sedona 函数**:必要时 API 会自动把 Sedona 的空间函数与优化注册到 SparkSession。
+
+3. **透明集成**:所有 GeoPandas 操作在底层都被翻译为 Spark SQL 操作,使用所配置的 SparkSession 执行。
+
+4. **无需手动管理 context**:与传统的 Sedona 用法不同,您通常不需要显式调用 `SedonaContext.create()`,除非有自定义配置需求。
+
+这种设计让 API 更加易用,把 SparkSession 管理的复杂度隐藏起来,同时仍能充分发挥分布式处理的能力。
+
+### S3 配置
+
+在使用 S3 数据时,GeoPandas API 使用 Spark 内置的 S3 支持,而不是 s3fs 等外部库。可通过 Spark 配置开启对公开 S3 桶的匿名访问:
+
+```python
+from sedona.spark import SedonaContext
+
+# 公开 S3 桶的匿名访问
+config = (
+    SedonaContext.builder()
+    .config(
+        "spark.hadoop.fs.s3a.bucket.bucket-name.aws.credentials.provider",
+        "org.apache.hadoop.fs.s3a.AnonymousAWSCredentialsProvider",
+    )
+    .getOrCreate()
+)
+
+sedona = SedonaContext.create(config)
+```
+
+需要鉴权访问 S3 时,请使用合适的 AWS 凭据提供者:
+
+```python
+# 使用 IAM 角色(在 EC2/EMR 上推荐)
+config = (
+    SedonaContext.builder()
+    .config(
+        "spark.hadoop.fs.s3a.aws.credentials.provider",
+        "com.amazonaws.auth.InstanceProfileCredentialsProvider",
+    )
+    .getOrCreate()
+)
+
+# 使用 access key(不推荐用于生产环境)
+config = (
+    SedonaContext.builder()
+    .config("spark.hadoop.fs.s3a.access.key", "your-access-key")
+    .config("spark.hadoop.fs.s3a.secret.key", "your-secret-key")
+    .getOrCreate()
+)
+```
+
+## 基本用法
+
+### 引入 API
+
+不再直接导入 GeoPandas,而是从 Sedona 的 GeoPandas 模块导入:
+
+```python
+# 传统的 GeoPandas 导入
+# import geopandas as gpd
+
+# Sedona GeoPandas API 的导入
+import sedona.spark.geopandas as gpd
+
+# 或
+from sedona.spark.geopandas import GeoDataFrame, read_parquet
+```
+
+### 读取数据
+
+API 支持读取多种地理空间格式,包括来自云存储的 Parquet 文件。要以匿名凭据访问 S3,请配置 Spark 使用匿名 AWS 凭据:
+
+```python
+from sedona.spark import SedonaContext
+
+# 配置 Spark 进行匿名 S3 访问
+config = (
+    SedonaContext.builder()
+    .config(
+        "spark.hadoop.fs.s3a.bucket.wherobots-examples.aws.credentials.provider",
+        "org.apache.hadoop.fs.s3a.AnonymousAWSCredentialsProvider",
+    )
+    .getOrCreate()
+)
+
+sedona = SedonaContext.create(config)
+
+# 直接从 S3 加载 GeoParquet 文件
+s3_path = "s3://wherobots-examples/data/onboarding_1/nyc_buildings.parquet"
+nyc_buildings = gpd.read_parquet(s3_path)
+
+# 显示基本信息
+print(f"Dataset shape: {nyc_buildings.shape}")
+print(f"Columns: {nyc_buildings.columns.tolist()}")
+nyc_buildings.head()
+```
+
+### 空间过滤
+
+使用空间索引与过滤方法。注意:当前版本尚未实现 `cx` 空间索引:
+
+```python
+from shapely.geometry import box
+
+# 中央公园的边界框
+central_park_bbox = box(
+    -73.973,
+    40.764,  # 左下角(经度,纬度)
+    -73.951,
+    40.789,  # 右上角(经度,纬度)
+)
+
+# 使用空间索引筛选边界框内的建筑
+# 注意:该写法需要把数据收集到 driver 才能进行空间过滤
+# 对于大规模数据,建议改用空间连接(spatial join)
+buildings_sample = nyc_buildings.sample(1000)  # 演示用:抽样 1000 行
+central_park_buildings = buildings_sample[
+    buildings_sample.geometry.intersects(central_park_bbox)
+]
+
+# 显示结果
+print(
+    central_park_buildings[["BUILD_ID", "PROP_ADDR", "height_val", "geometry"]].head()
+)
+```
+
+**针对大规模数据的替代方案——使用空间连接:**
+
+```python
+# 用边界框创建一个 GeoDataFrame
+bbox_gdf = gpd.GeoDataFrame({"id": [1]}, geometry=[central_park_bbox], crs="EPSG:4326")
+
+# 使用空间连接筛选边界框内的建筑
+central_park_buildings = nyc_buildings.sjoin(bbox_gdf, predicate="intersects")
+```
+
+## 高级操作
+
+### 空间连接
+
+可使用与 GeoPandas 相同的语法执行空间连接:
+
+```python
+# 加载两份数据集
+left_df = gpd.read_parquet("s3://bucket/left_data.parquet")
+right_df = gpd.read_parquet("s3://bucket/right_data.parquet")
+
+# 使用 distance 谓词的空间连接
+result = left_df.sjoin(right_df, predicate="dwithin", distance=50)
+
+# 其他空间谓词
+intersects_result = left_df.sjoin(right_df, predicate="intersects")
+contains_result = left_df.sjoin(right_df, predicate="contains")
+```
+
+### 坐标参考系操作
+
+在不同坐标参考系(CRS)之间转换几何对象:
+
+```python
+# 设置初始 CRS
+buildings = gpd.read_parquet("buildings.parquet")
+buildings = buildings.set_crs("EPSG:4326")
+
+# 转换为投影坐标系以便计算面积
+buildings_projected = buildings.to_crs("EPSG:3857")
+
+# 计算面积
+buildings_projected["area"] = buildings_projected.geometry.area
+```
+
+### 几何运算
+
+应用几何变换与分析:
+
+```python
+# 缓冲区操作
+buffered = buildings.geometry.buffer(100)  # 100 米缓冲
+
+# 几何属性
+buildings["is_valid"] = buildings.geometry.is_valid
+buildings["is_simple"] = buildings.geometry.is_simple
+buildings["bounds"] = buildings.geometry.bounds
+
+# 距离计算
+from shapely.geometry import Point
+
+reference_point = Point(-73.9857, 40.7484)  # 时代广场
+buildings["distance_to_times_square"] = buildings.geometry.distance(reference_point)
+
+# 面积与周长(需要使用投影 CRS)
+buildings_projected = buildings.to_crs("EPSG:3857")  # Web Mercator
+buildings_projected["area"] = buildings_projected.geometry.area
+buildings_projected["perimeter"] = buildings_projected.geometry.length
+```
+
+## 性能考虑
+
+### 何时仍使用传统 GeoPandas:
+
+- 小数据集(< 1GB)
+- 对本地数据的简单操作
+- 需要完整的功能覆盖
+- 单机处理已经足够
+
+### 何时使用 Apache Sedona 的 GeoPandas API:
+
+- 大规模数据集(> 1GB)
+- 复杂的地理空间分析
+- 需要分布式处理
+- 数据保存在云存储(S3、HDFS 等)
+
+## 已支持的操作
+
+Apache Sedona 的 GeoPandas API 已实现 **39 个 GeoSeries 函数** 与 **10 个 GeoDataFrame 函数**,覆盖了 GeoPandas 中最常用的操作:
+
+### 数据 I/O
+
+- `read_parquet()` —— 读取 GeoParquet 文件
+- `read_file()` —— 读取多种地理空间格式
+- `to_parquet()` —— 写出为 Parquet 格式
+
+### 空间操作
+
+- `sjoin()` —— 多种谓词的空间连接
+- `buffer()` —— 几何缓冲
+- `distance()` —— 距离计算
+- `intersects()`、`contains()`、`within()` —— 空间谓词
+- `sindex` —— 空间索引(功能有限)
+
+### CRS 操作
+
+- `set_crs()` —— 设置坐标参考系
+- `to_crs()` —— 在 CRS 之间转换
+- `crs` —— 访问 CRS 信息
+
+### 几何属性
+
+- `area`、`length`、`bounds` —— 几何度量
+- `is_valid`、`is_simple`、`is_empty` —— 几何校验
+- `centroid`、`envelope`、`boundary` —— 几何属性
+- `x`、`y`、`z`、`has_z` —— 坐标访问
+- `total_bounds`、`estimate_utm_crs` —— 包围盒与 CRS 工具
+
+### 空间运算
+
+- `buffer()` —— 几何缓冲
+- `distance()` —— 距离计算
+- `intersects()`、`contains()`、`within()` —— 空间谓词
+- `intersection()` —— 几何相交
+- `make_valid()` —— 几何校验与修复
+- `sindex` —— 空间索引(功能有限)
+
+### 数据转换
+
+- `to_geopandas()` —— 转换为传统 GeoPandas
+- `to_wkb()`、`to_wkt()` —— 转换为 WKB/WKT
+- `from_xy()` —— 通过坐标创建几何
+- `geom_type` —— 获取几何类型
+
+## 完整工作流示例
+
+```python
+import sedona.spark.geopandas as gpd
+from sedona.spark import SedonaContext
+
+# 配置 Spark 进行匿名 S3 访问
+config = (
+    SedonaContext.builder()
+    .config(
+        "spark.hadoop.fs.s3a.bucket.wherobots-examples.aws.credentials.provider",
+        "org.apache.hadoop.fs.s3a.AnonymousAWSCredentialsProvider",
+    )
+    .getOrCreate()
+)
+
+sedona = SedonaContext.create(config)
+
+# 加载数据
+DATA_DIR = "s3://wherobots-examples/data/geopandas_blog/"
+overture_size = "1M"
+postal_codes_path = DATA_DIR + "postal-code/"
+overture_path = DATA_DIR + overture_size + "/" + "overture-buildings/"
+
+postal_codes = gpd.read_parquet(postal_codes_path)
+buildings = gpd.read_parquet(overture_path)
+
+# 空间分析
+buildings = buildings.set_crs("EPSG:4326")
+buildings_projected = buildings.to_crs("EPSG:3857")
+
+# 计算面积并过滤
+buildings_projected["area"] = buildings_projected.geometry.area
+large_buildings = buildings_projected[buildings_projected["area"] > 1000]
+
+result = large_buildings.sjoin(postal_codes, predicate="intersects")
+
+# 按邮政编码聚合
+summary = (
+    result.groupby("postal_code")
+    .agg({"area": "sum", "BUILD_ID": "count"})
+    .rename(columns={"BUILD_ID": "building_count"})
+)
+
+print(summary.head())
+```
+
+## 资源与贡献
+
+完整且最新的 API 文档(包含方法签名、参数与示例)请参阅:
+
+**📚 [GeoPandas API 文档](https://sedona.apache.org/latest/api/pydocs/sedona.spark.geopandas.html)**
+
+Apache Sedona 的 GeoPandas API 是一个开源项目,欢迎参与贡献:可在 [GitHub issue tracker](https://github.com/apache/sedona/issues/2230) 报告 bug、提出新需求或贡献代码。更多贡献指南请参阅 [贡献者指南](../community/develop.md)。
diff --git a/docs/tutorial/geopandas-shapely.zh.md b/docs/tutorial/geopandas-shapely.zh.md
new file mode 100644
index 0000000000..1442effd25
--- /dev/null
+++ b/docs/tutorial/geopandas-shapely.zh.md
@@ -0,0 +1,371 @@
+<!--
+ 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 和 Shapely 配合使用
+
+!!! note
+	Sedona 1.6.0 之前的版本仅支持 Shapely 1.x。如需使用 Shapely 2.x,请使用 1.6.0 及以上的 Sedona。
+
+    如果您使用 Sedona < 1.6.0,请安装 GeoPandas <= `0.11.1`,因为 GeoPandas > 0.11.1 会自动安装 Shapely 2.0;如果使用 Shapely,请安装 <= `1.8.5`。
+
+## 与 GeoPandas 互通
+
+Sedona Python 已实现序列化器与反序列化器,可以将 Sedona Geometry 对象转换为 Shapely 的 BaseGeometry。基于此,您可以用 GeoPandas 从文件加载数据(驱动可参考 Fiona 支持的列表),并基于 GeoDataFrame 创建 Spark DataFrame。
+
+### 从 GeoPandas 到 Sedona DataFrame
+
+使用 GeoPandas 的 `read_file` 方法从 shapefile 加载数据,并基于 GeoDataFrame 创建 Spark DataFrame:
+
+```python
+import geopandas as gpd
+from sedona.spark import *
+
+config = SedonaContext.builder().getOrCreate()
+
+sedona = SedonaContext.create(config)
+
+gdf = gpd.read_file("gis_osm_pois_free_1.shp")
+
+sedona.createDataFrame(gdf).show()
+```
+
+输出如下:
+
+```
+
++---------+----+-----------+--------------------+--------------------+
+|   osm_id|code|     fclass|                name|            geometry|
++---------+----+-----------+--------------------+--------------------+
+| 26860257|2422|  camp_site|            de Kroon|POINT (15.3393145...|
+| 26860294|2406|     chalet|      Leśne Ustronie|POINT (14.8709625...|
+| 29947493|2402|      motel|                null|POINT (15.0946636...|
+| 29947498|2602|        atm|                null|POINT (15.0732014...|
+| 29947499|2401|      hotel|                null|POINT (15.0696777...|
+| 29947505|2401|      hotel|                null|POINT (15.0155749...|
++---------+----+-----------+--------------------+--------------------+
+
+```
+
+如需借助 Arrow 优化加快转换速度,可以使用 `create_spatial_dataframe`,它接收 SparkSession 与 GeoDataFrame 作为参数,返回 Sedona DataFrame:
+
+```python
+def create_spatial_dataframe(
+    spark: SparkSession, gdf: gpd.GeoDataFrame
+) -> DataFrame: ...
+```
+
+- spark:SparkSession
+- gdf:gpd.GeoDataFrame
+- 返回:DataFrame
+
+示例:
+
+```python
+from sedona.spark.geoarrow import create_spatial_dataframe
+
+create_spatial_dataframe(spark, gdf)
+```
+
+### 从 Sedona DataFrame 到 GeoPandas
+
+用 Spark 读取数据并转换为 GeoPandas:
+
+```python
+import geopandas as gpd
+from sedona.spark import *
+
+config = SedonaContext.builder().getOrCreate()
+
+sedona = SedonaContext.create(config)
+
+counties = (
+    sedona.read.option("delimiter", "|").option("header", "true").csv("counties.csv")
+)
+
+counties.createOrReplaceTempView("county")
+
+counties_geom = sedona.sql("SELECT *, st_geomFromWKT(geom) as geometry from county")
+
+df = counties_geom.toPandas()
+gdf = gpd.GeoDataFrame(df, geometry="geometry")
+
+gdf.plot(
+    figsize=(10, 8),
+    column="value",
+    legend=True,
+    cmap="YlOrBr",
+    scheme="quantiles",
+    edgecolor="lightgray",
+)
+```
+
+<br>
+<br>
+
+![poland_image](https://user-images.githubusercontent.com/22958216/67603296-c08b4680-f778-11e9-8cde-d2e14ffbba3b.png)
+
+<br>
+<br>
+
+也可以尝试通过 GeoArrow 转换为 GeoPandas,对于大型结果集这种方式可能显著更快(要求 geopandas >= 1.0)。
+
+```python
+import geopandas as gpd
+from sedona.spark import dataframe_to_arrow
+
+config = SedonaContext.builder().getOrCreate()
+
+sedona = SedonaContext.create(config)
+
+test_wkt = ["POINT (0 1)", "LINESTRING (0 1, 2 3)"]
+df = sedona.createDataFrame(zip(test_wkt), ["wkt"]).selectExpr(
+    "ST_GeomFromText(wkt) as geom"
+)
+
+gpd.GeoDataFrame.from_arrow(dataframe_to_arrow(df))
+```
+
+## 与 Shapely 对象互通
+
+### 支持的 Shapely 对象
+
+| Shapely 对象       | 是否支持           |
+|--------------------|--------------------|
+| Point              | :heavy_check_mark: |
+| MultiPoint         | :heavy_check_mark: |
+| LineString         | :heavy_check_mark: |
+| MultiLinestring    | :heavy_check_mark: |
+| Polygon            | :heavy_check_mark: |
+| MultiPolygon       | :heavy_check_mark: |
+| GeometryCollection | :heavy_check_mark: |
+
+要基于上述几何类型创建 Spark DataFrame,请使用 `sedona.sql.types` 模块下的 <b>GeometryType</b>。该转换支持包含 Shapely 对象的 list 或 tuple。
+
+针对包含整型 id 与几何类型的目标表,schema 可以这样定义:
+
+```python
+from pyspark.sql.types import IntegerType, StructField, StructType
+
+from sedona.spark import *
+
+schema = StructType(
+    [
+        StructField("id", IntegerType(), False),
+        StructField("geom", GeometryType(), False),
+    ]
+)
+```
+
+同样,包含几何类型列的 Spark DataFrame 可以通过 <b>collect</b> 方法转换为 Shapely 对象列表。
+
+### Point 示例
+
+```python
+from shapely.geometry import Point
+
+data = [[1, Point(21.0, 52.0)], [1, Point(23.0, 42.0)], [1, Point(26.0, 32.0)]]
+
+
+gdf = sedona.createDataFrame(data, schema)
+
+gdf.show()
+```
+
+```
++---+-------------+
+| id|         geom|
++---+-------------+
+|  1|POINT (21 52)|
+|  1|POINT (23 42)|
+|  1|POINT (26 32)|
++---+-------------+
+```
+
+```python
+gdf.printSchema()
+```
+
+```
+root
+ |-- id: integer (nullable = false)
+ |-- geom: geometry (nullable = false)
+```
+
+### MultiPoint 示例
+
+```python3
+from shapely.geometry import MultiPoint
+
+data = [[1, MultiPoint([[19.511463, 51.765158], [19.446408, 51.779752]])]]
+
+gdf = sedona.createDataFrame(data, schema).show(1, False)
+```
+
+```
+
++---+---------------------------------------------------------+
+|id |geom                                                     |
++---+---------------------------------------------------------+
+|1  |MULTIPOINT ((19.511463 51.765158), (19.446408 51.779752))|
++---+---------------------------------------------------------+
+
+
+```
+
+### LineString 示例
+
+```python3
+from shapely.geometry import LineString
+
+line = [(40, 40), (30, 30), (40, 20), (30, 10)]
+
+data = [[1, LineString(line)]]
+
+gdf = sedona.createDataFrame(data, schema)
+
+gdf.show(1, False)
+```
+
+```
+
++---+--------------------------------+
+|id |geom                            |
++---+--------------------------------+
+|1  |LINESTRING (10 10, 20 20, 10 40)|
++---+--------------------------------+
+
+```
+
+### MultiLineString 示例
+
+```python3
+from shapely.geometry import MultiLineString
+
+line1 = [(10, 10), (20, 20), (10, 40)]
+line2 = [(40, 40), (30, 30), (40, 20), (30, 10)]
+
+data = [[1, MultiLineString([line1, line2])]]
+
+gdf = sedona.createDataFrame(data, schema)
+
+gdf.show(1, False)
+```
+
+```
+
++---+---------------------------------------------------------------------+
+|id |geom                                                                 |
++---+---------------------------------------------------------------------+
+|1  |MULTILINESTRING ((10 10, 20 20, 10 40), (40 40, 30 30, 40 20, 30 10))|
++---+---------------------------------------------------------------------+
+
+```
+
+### Polygon 示例
+
+```python3
+from shapely.geometry import Polygon
+
+polygon = Polygon(
+    [
+        [19.51121, 51.76426],
+        [19.51056, 51.76583],
+        [19.51216, 51.76599],
+        [19.51280, 51.76448],
+        [19.51121, 51.76426],
+    ]
+)
+
+data = [[1, polygon]]
+
+gdf = sedona.createDataFrame(data, schema)
+
+gdf.show(1, False)
+```
+
+```
+
++---+--------------------------------------------------------------------------------------------------------+
+|id |geom                                                                                                    |
++---+--------------------------------------------------------------------------------------------------------+
+|1  |POLYGON ((19.51121 51.76426, 19.51056 51.76583, 19.51216 51.76599, 19.5128 51.76448, 19.51121 51.76426))|
++---+--------------------------------------------------------------------------------------------------------+
+
+```
+
+### MultiPolygon 示例
+
+```python3
+from shapely.geometry import MultiPolygon
+
+exterior_p1 = [(0, 0), (0, 2), (2, 2), (2, 0), (0, 0)]
+interior_p1 = [(1, 1), (1, 1.5), (1.5, 1.5), (1.5, 1), (1, 1)]
+
+exterior_p2 = [(0, 0), (1, 0), (1, 1), (0, 1), (0, 0)]
+
+polygons = [Polygon(exterior_p1, [interior_p1]), Polygon(exterior_p2)]
+
+data = [[1, MultiPolygon(polygons)]]
+
+gdf = sedona.createDataFrame(data, schema)
+
+gdf.show(1, False)
+```
+
+```
+
++---+----------------------------------------------------------------------------------------------------------+
+|id |geom                                                                                                      |
++---+----------------------------------------------------------------------------------------------------------+
+|1  |MULTIPOLYGON (((0 0, 0 2, 2 2, 2 0, 0 0), (1 1, 1.5 1, 1.5 1.5, 1 1.5, 1 1)), ((0 0, 0 1, 1 1, 1 0, 0 0)))|
++---+----------------------------------------------------------------------------------------------------------+
+
+```
+
+### GeometryCollection 示例
+
+```python3
+from shapely.geometry import GeometryCollection, Point, LineString, Polygon
+
+exterior_p1 = [(0, 0), (0, 2), (2, 2), (2, 0), (0, 0)]
+interior_p1 = [(1, 1), (1, 1.5), (1.5, 1.5), (1.5, 1), (1, 1)]
+exterior_p2 = [(0, 0), (1, 0), (1, 1), (0, 1), (0, 0)]
+
+geoms = [
+    Polygon(exterior_p1, [interior_p1]),
+    Polygon(exterior_p2),
+    Point(1, 1),
+    LineString([(0, 0), (1, 1), (2, 2)]),
+]
+
+data = [[1, GeometryCollection(geoms)]]
+
+gdf = sedona.createDataFrame(data, schema)
+
+gdf.show(1, False)
+```
+
+```
++---+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+|id |geom                                                                                                                                                                     |
++---+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+|1  |GEOMETRYCOLLECTION (POLYGON ((0 0, 0 2, 2 2, 2 0, 0 0), (1 1, 1 1.5, 1.5 1.5, 1.5 1, 1 1)), POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0)), POINT (1 1), LINESTRING (0 0, 1 1, 2 2))|
++---+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+```


(sedona) 01/12: [GH-2867] Wire mkdocs-static-i18n for Chinese documentation (#2920)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 8f008a38cb9fb794ad9043afa2896d1639e7651e
Author: Jia Yu <ji...@apache.org>
AuthorDate: Wed May 6 21:14:05 2026 -0700

    [GH-2867] Wire mkdocs-static-i18n for Chinese documentation (#2920)
    
    (cherry picked from commit 3b5de9fda180be296eb4ab9b8e382bc0141c7543)
---
 docs/index.zh.md |  26 +++++++++++++
 mkdocs.yml       | 117 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 pyproject.toml   |   1 +
 3 files changed, 144 insertions(+)

diff --git a/docs/index.zh.md b/docs/index.zh.md
new file mode 100644
index 0000000000..9ff2fb01cb
--- /dev/null
+++ b/docs/index.zh.md
@@ -0,0 +1,26 @@
+<!--
+ 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.
+ -->
+
+### 2025/09/12:Sedona 1.8.0 发布。本次重要版本引入了 GeoPandas 兼容 API、PyFlink 支持、Java 11 升级、Spark 4.0 支持,以及向量化 UDF、Moran I 自相关、MySQL 几何类型支持和增强的空间过滤下推等众多新特性。
+
+### 2025/06/07:Sedona 1.7.2 发布。本次为纯 Bug 修复版本,也是 Java 8 上的最后一个发布版本。
+
+### 2025/03/15:Sedona 1.7.1 发布。包含 KNN 连接性能改进、GeoStats 的 SQL 接口、STAC catalog 读取器、OSM PBF 读取器,以及更优的 GeoParquet 文件分区。
+
+### 2024/12/02:Sedona 1.7.0 发布。引入了名为 KNN Join 的新连接类型、名为 GeoStats 的新统计模块、用于 Shapefile 和 GeoPackage 的基于 DataFrame 的读取器,以及众多新的 ST 函数。
diff --git a/mkdocs.yml b/mkdocs.yml
index becd4933d1..1d1a92cee1 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -251,6 +251,123 @@ plugins:
       archive_date_format: MMMM yyyy
       # Maximum number of authors to display in the post excerpt
       post_excerpt_max_authors: 5
+  - i18n:
+      docs_structure: suffix
+      fallback_to_default: true
+      reconfigure_material: true
+      reconfigure_search: true
+      languages:
+        - locale: en
+          default: true
+          name: English
+          build: true
+        - locale: zh
+          name: 中文
+          build: true
+          site_name: Apache Sedona
+          site_description: Apache Sedona 是一个用于处理大规模空间数据的集群计算系统。Sedona 在 Apache Spark、Apache Flink 和 Snowflake 等现有集群计算系统的基础上,提供了一套开箱即用的分布式空间数据集和空间 SQL,可以高效地跨机器加载、处理和分析大规模空间数据。
+          nav_translations:
+            Home: 首页
+            Install: 安装
+            Overview: 概述
+            Modules: 模块
+            Language wrappers: 语言封装
+            Maven Central coordinate: Maven Central 坐标
+            Use Sedona in Docker: 在 Docker 中使用 Sedona
+            Install Sedona in your local Spark cluster: 在本地 Spark 集群中安装 Sedona
+            Install Sedona Scala/Java: 安装 Sedona Scala/Java
+            Install Sedona Python: 安装 Sedona Python
+            Install Sedona R: 安装 Sedona R
+            Install Sedona-Zeppelin: 安装 Sedona-Zeppelin
+            Set up Spark cluster manually: 手动搭建 Spark 集群
+            Cloud platforms: 云平台
+            Install on Wherobots: 在 Wherobots 上安装
+            Install on Databricks: 在 Databricks 上安装
+            Install on AWS EMR: 在 AWS EMR 上安装
+            Install on AWS Glue: 在 AWS Glue 上安装
+            Install on Microsoft Fabric: 在 Microsoft Fabric 上安装
+            Install on Azure Synapse Analytics: 在 Azure Synapse Analytics 上安装
+            Programming Guide: 编程指南
+            Programming Guides: 编程指南
+            Spatial DataFrame / SQL app: 空间 DataFrame / SQL 应用
+            Raster DataFrame / SQL app: 栅格 DataFrame / SQL 应用
+            Pure SQL environment: 纯 SQL 环境
+            GeoPandas API on Sedona: Sedona 上的 GeoPandas API
+            Spatial RDD app: 空间 RDD 应用
+            Sedona R: Sedona R
+            Work with GeoPandas and Shapely: 与 GeoPandas 和 Shapely 配合使用
+            Files: 文件
+            Concepts: 概念
+            Spatial Joins: 空间连接
+            Clustering Algorithms: 聚类算法
+            Distance: 距离
+            Map visualization SQL app: 地图可视化 SQL 应用
+            Use Apache Zeppelin: 使用 Apache Zeppelin
+            Gallery: 案例库
+            Performance tuning: 性能调优
+            Benchmark: 基准测试
+            Tune RDD application: 调优 RDD 应用
+            Storing large raster geometries in Parquet files: 在 Parquet 文件中存储大型栅格几何对象
+            API: API
+            SQL: SQL
+            Quick start: 快速开始
+            Vector data: 矢量数据
+            Geometry Functions: 几何函数
+            Geography Functions: 地理函数
+            DataFrame Style functions: DataFrame 风格函数
+            Query optimization: 查询优化
+            CRS Transformation: 坐标系转换
+            Nearest-Neighbour searching: 最近邻搜索
+            Reading Legacy Parquet Files: 读取旧版 Parquet 文件
+            Visualization: 可视化
+            Raster data: 栅格数据
+            Raster Functions: 栅格函数
+            Raster map algebra: 栅格地图代数
+            Raster affine transformation: 栅格仿射变换
+            Parameter: 参数
+            RDD (core): RDD(核心)
+            Scala/Java doc: Scala/Java 文档
+            Stats: 统计
+            DataFrame: DataFrame
+            Viz: 可视化
+            DataFrame/SQL: DataFrame/SQL
+            RDD: RDD
+            Sedona Python: Sedona Python
+            Release notes: 发布说明
+            Sedona with Apache Flink: 在 Apache Flink 上使用 Sedona
+            Spatial SQL app (Flink): 空间 SQL 应用(Flink)
+            Spatial SQL app (PyFlink): 空间 SQL 应用(PyFlink)
+            Examples: 示例
+            Scala/Java: Scala/Java
+            Python: Python
+            Overview (Flink): 概述(Flink)
+            Install Sedona SQL: 安装 Sedona SQL
+            Spatial SQL app (Snowflake): 空间 SQL 应用(Snowflake)
+            Overview (Snowflake): 概述(Snowflake)
+            Blog: 博客
+            Community: 社区
+            Download: 下载
+            Compile the code: 编译源码
+            Contributor Guide: 贡献者指南
+            Rules: 规则
+            Develop: 开发
+            Contribute to Geopandas API on Sedona: 为 Sedona 的 Geopandas API 贡献代码
+            Committer Guide: 提交者指南
+            Project Management Committee: 项目管理委员会
+            Become a release manager: 成为发布经理
+            Publish a snapshot version: 发布快照版本
+            Make a release: 发布版本
+            Vote a release: 投票发布
+            Publications: 论文
+            Apache Software Foundation: Apache 软件基金会
+            Foundation: 基金会
+            License: 许可证
+            Events: 活动
+            Sponsorship: 赞助
+            Thanks: 致谢
+            Security: 安全
+            Privacy: 隐私
+            Telemetry: 遥测
   - git-revision-date-localized:
       type: datetime
   - mike:
diff --git a/pyproject.toml b/pyproject.toml
index 93bcddd023..26cb5ce4f2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -51,6 +51,7 @@ docs = [
   "mkdocs-git-revision-date-localized-plugin",
   "mkdocs-jupyter",
   "mkdocs-macros-plugin",
+  "mkdocs-static-i18n",
   "pymdown-extensions",
   "mike",
   "blacken-docs",


(sedona) 09/12: [GH-2867] Make language switcher respect mike version prefix (#2936)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit d1337ff86f31add964b57a68ce6813b5a5fc48cc
Author: Jia Yu <ji...@apache.org>
AuthorDate: Fri May 8 11:21:40 2026 -0700

    [GH-2867] Make language switcher respect mike version prefix (#2936)
    
    (cherry picked from commit d4a604a8fa6e9ba616fec546e4455bd13e3bf612)
---
 docs-overrides/partials/alternate.html | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/docs-overrides/partials/alternate.html b/docs-overrides/partials/alternate.html
index 513dcb4f9c..0056fe9e2c 100644
--- a/docs-overrides/partials/alternate.html
+++ b/docs-overrides/partials/alternate.html
@@ -4,11 +4,20 @@
     <span class="sd-lang-switch__glyph" aria-hidden="true"><span class="sd-lang-switch__glyph-cn">文</span><span class="sd-lang-switch__glyph-en">A</span></span>
   </summary>
   <ul class="sd-lang-switch__menu">
+    {#-
+      mkdocs-static-i18n stores `alt.link` as a server-absolute path like
+      `/zh/sedonaspark/`. Passing that directly to `| url` keeps the leading
+      slash, so the link bypasses any deployment prefix added by mike (e.g.
+      `/latest-snapshot/`) and lands at the wrong version. Strip the leading
+      slash so `| url` resolves against the docs root and stays inside the
+      current mike version.
+    -#}
     {% for alt in config.extra.alternate %}
       {%- set is_active = (alt.lang == config.theme.language) -%}
+      {%- set alt_link = alt.link[1:] if alt.link.startswith('/') else alt.link -%}
       <li>
         <a
-          href="{{ alt.link | url }}"
+          href="{{ alt_link | url }}"
           hreflang="{{ alt.lang }}"
           lang="{{ alt.lang }}"
           target="_self"


(sedona) 07/12: [GH-2911] Translate Tutorial / Programming Guide (part 3) to Chinese (#2934)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 6ddd74ce063ee0fa9425b97dd14c84fa3068534c
Author: Jia Yu <ji...@apache.org>
AuthorDate: Fri May 8 09:27:52 2026 -0700

    [GH-2911] Translate Tutorial / Programming Guide (part 3) to Chinese (#2934)
    
    (cherry picked from commit fd4675b335e50afbe2051a2381cd3896b0648e7c)
---
 docs/tutorial/raster.zh.md        | 758 ++++++++++++++++++++++++++++++++++++++
 docs/tutorial/snowflake/sql.zh.md | 618 +++++++++++++++++++++++++++++++
 2 files changed, 1376 insertions(+)

diff --git a/docs/tutorial/raster.zh.md b/docs/tutorial/raster.zh.md
new file mode 100644
index 0000000000..4b4dac57a5
--- /dev/null
+++ b/docs/tutorial/raster.zh.md
@@ -0,0 +1,758 @@
+<!--
+ 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.
+ -->
+
+!!!note
+    Sedona 中所有栅格函数均使用从 1 开始的索引,唯一例外是 [map algebra 函数](../api/sql/Raster-map-algebra.md),它使用从 0 开始的索引。
+
+!!!note
+    Sedona 假定地理坐标按 lon/lat 顺序排列。如果您的数据是 lat/lon 顺序,请使用 `ST_FlipCoordinates` 交换 X 与 Y。
+
+自 `v1.1.0` 起,Sedona SQL 在 DataFrame 与 SQL 中支持栅格数据源与栅格算子。==Scala、Java、Python、R== 等所有 Sedona 语言绑定都已支持栅格能力。
+
+本页介绍如何使用 SedonaSQL 管理栅格数据。
+
+=== "Scala"
+
+	```scala
+	var myDataFrame = sedona.sql("YOUR_SQL")
+	myDataFrame.createOrReplaceTempView("rasterDf")
+	```
+
+=== "Java"
+
+	```java
+	Dataset<Row> myDataFrame = sedona.sql("YOUR_SQL")
+	myDataFrame.createOrReplaceTempView("rasterDf")
+	```
+
+=== "Python"
+
+	```python
+	myDataFrame = sedona.sql("YOUR_SQL")
+	myDataFrame.createOrReplaceTempView("rasterDf")
+	```
+
+SedonaSQL 详细 API 说明请参阅 [SedonaSQL API](../api/sql/Overview.md)。示例栅格数据可在 [Sedona GitHub 仓库](https://github.com/apache/sedona/blob/0eae42576c2588fe278f75cef3b17fee600eac90/spark/common/src/test/resources/raster/raster_with_no_data/test5.tiff) 中找到。
+
+## 配置依赖
+
+=== "Scala/Java"
+
+	1. 阅读 [Sedona Maven Central 坐标](../setup/maven-coordinates.md),并在 build.sbt 或 pom.xml 中添加 Sedona 依赖。
+	2. 在 build.sbt 或 pom.xml 中添加 [Apache Spark core](https://mvnrepository.com/artifact/org.apache.spark/spark-core) 与 [Apache SparkSQL](https://mvnrepository.com/artifact/org.apache.spark/spark-sql) 依赖。
+	3. 参考 [SQL 示例项目](demo.md)。
+
+=== "Python"
+
+	1. 请阅读 [快速开始](../setup/install-python.md) 安装 Sedona Python。
+	2. 本教程基于 [Sedona SQL Jupyter Notebook 示例](jupyter-notebook.md)。
+
+## 创建 Sedona 配置
+
+在程序起始处使用以下代码创建 Sedona 配置。如果您已经有了由 Wherobots / AWS EMR / Databricks 创建的 SparkSession(通常名为 `spark`),可跳过此步骤直接使用 `spark`。
+
+可以在 builder 中追加额外的 Spark 运行时配置,例如 `SedonaContext.builder().config("spark.sql.autoBroadcastJoinThreshold", "10485760")`。
+
+=== "Scala"
+
+	```scala
+	import org.apache.sedona.spark.SedonaContext
+
+	val config = SedonaContext.builder()
+	.master("local[*]") // 集群模式下请删除此行
+	.appName("readTestScala") // 改成合适的名字
+	.getOrCreate()
+	```
+	如果同时使用 SedonaViz 与 SedonaSQL,请在 `SedonaContext.builder()` 之后追加以下行启用 Sedona Kryo 序列化器:
+	```scala
+	.config("spark.kryo.registrator", classOf[SedonaVizKryoRegistrator].getName) // org.apache.sedona.viz.core.Serde.SedonaVizKryoRegistrator
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.sedona.spark.SedonaContext;
+
+	SparkSession config = SedonaContext.builder()
+	.master("local[*]") // 集群模式下请删除此行
+	.appName("readTestScala") // 改成合适的名字
+	.getOrCreate()
+	```
+	如果同时使用 SedonaViz 与 SedonaSQL,请在 `SedonaContext.builder()` 之后追加以下行启用 Sedona Kryo 序列化器:
+	```scala
+	.config("spark.kryo.registrator", SedonaVizKryoRegistrator.class.getName) // org.apache.sedona.viz.core.Serde.SedonaVizKryoRegistrator
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import *
+
+	config = SedonaContext.builder() .\
+	    config('spark.jars.packages',
+	           'org.apache.sedona:sedona-spark-shaded-3.3_2.12:{{ sedona.current_version }},'
+	           'org.datasyslab:geotools-wrapper:{{ sedona.current_geotools }}'). \
+	    getOrCreate()
+	```
+    请将 sedona-spark-shaded 包名中的 `3.3` 替换为对应的 Spark major.minor 版本,例如 `sedona-spark-shaded-3.4_2.12:{{ sedona.current_version }}`。
+
+## 初始化 SedonaContext
+
+在创建 Sedona 配置之后加上以下代码。如果您已经有了由 Wherobots / AWS EMR / Databricks 创建的 SparkSession(通常名为 `spark`),请改为调用 `SedonaContext.create(spark)`。
+
+=== "Scala"
+
+	```scala
+	import org.apache.sedona.spark.SedonaContext
+
+	val sedona = SedonaContext.create(config)
+	```
+
+=== "Java"
+
+	```java
+	import org.apache.sedona.spark.SedonaContext;
+
+	SparkSession sedona = SedonaContext.create(config)
+	```
+
+=== "Python"
+
+	```python
+	from sedona.spark import *
+
+	sedona = SedonaContext.create(config)
+	```
+
+也可以通过 `spark-submit` / `spark-shell` 传入 `--conf spark.sql.extensions=org.apache.sedona.sql.SedonaSqlExtensions` 一并完成注册。
+
+## 加载 GeoTiff 数据
+
+加载 GeoTiff 栅格数据的推荐方式是 `raster` 数据源。它会加载 GeoTiff 文件并自动将其切分为较小的 tile,每个 tile 在结果 DataFrame 中作为一行,并以 `Raster` 类型存储。
+
+=== "Scala"
+    ```scala
+    var rasterDf = sedona.read.format("raster").load("/some/path/*.tif")
+    rasterDf.createOrReplaceTempView("rasterDf")
+    rasterDf.show()
+    ```
+
+=== "Java"
+    ```java
+    Dataset<Row> rasterDf = sedona.read().format("raster").load("/some/path/*.tif");
+    rasterDf.createOrReplaceTempView("rasterDf");
+    rasterDf.show();
+    ```
+
+=== "Python"
+    ```python
+    rasterDf = sedona.read.format("raster").load("/some/path/*.tif")
+    rasterDf.createOrReplaceTempView("rasterDf")
+    rasterDf.show()
+    ```
+
+输出大致如下:
+
+```
++--------------------+---+---+----+
+|                rast|  x|  y|name|
++--------------------+---+---+----+
+|GridCoverage2D["g...|  0|  0| ...|
+|GridCoverage2D["g...|  1|  0| ...|
+|GridCoverage2D["g...|  2|  0| ...|
+...
+```
+
+各列含义:
+
+- `rast`:以 `Raster` 类型表示的栅格数据。
+- `x`:tile 的 X 坐标(从 0 开始);只有未禁用 retile 时才会出现。
+- `y`:tile 的 Y 坐标(从 0 开始);同上。
+- `name`:栅格文件名。
+
+### Tiling 选项
+
+默认情况下启用 tiling(`retile = true`),且 tile 大小由 GeoTiff 的内部 tile 方案决定,无需手动指定 `tileWidth` 或 `tileHeight`。建议栅格数据使用 [Cloud Optimized GeoTIFF (COG)](https://www.cogeo.org/) 格式,因为它通常会把像素数据组织为正方形 tile。
+
+也可以可选地覆盖 tile 大小,或完全禁用 tiling:
+
+| 选项 | 默认值 | 说明 |
+| :--- | :--- | :--- |
+| `retile` | `true` | 是否启用 tiling。设为 `false` 则把整张栅格作为一行加载。 |
+| `tileWidth` | GeoTiff 内部 tile 宽度 | 可选。手动指定每个 tile 的宽度(像素)。 |
+| `tileHeight` | 若设置了 `tileWidth` 则与之相同,否则使用 GeoTiff 内部 tile 高度 | 可选。手动指定每个 tile 的高度(像素)。 |
+| `padWithNoData` | `false` | 当右、下边缘的 tile 小于指定大小时,使用 NODATA 值进行填充。 |
+
+覆盖 tile 大小:
+
+=== "Python"
+    ```python
+    rasterDf = (
+        sedona.read.format("raster")
+        .option("tileWidth", "256")
+        .option("tileHeight", "256")
+        .load("/some/path/*.tif")
+    )
+    ```
+
+!!!note
+    如果栅格数据的内部 tile 方案不利于切分,`raster` 数据源会抛出错误。可以通过 `option("retile", "false")` 关闭自动切分,或手动指定 tile 大小绕过该问题。更彻底的做法是使用 `gdal_translate` 等工具把数据转换为 COG 格式。
+
+### 从目录中加载栅格文件
+
+`raster` 数据源也支持 Spark 通用文件源选项,如 `option("pathGlobFilter", "*.tif*")` 与 `option("recursiveFileLookup", "true")`。例如,递归加载某目录下所有 `.tif` 文件:
+
+=== "Python"
+    ```python
+    rasterDf = (
+        sedona.read.format("raster")
+        .option("recursiveFileLookup", "true")
+        .option("pathGlobFilter", "*.tif*")
+        .load(path_to_raster_data_folder)
+    )
+    ```
+
+!!!tip
+    当传入路径以 `/` 结尾时,`raster` 数据源会递归地在该目录及其子目录中查找栅格文件。这等价于不带尾部 `/` 并设置 `option("recursiveFileLookup", "true")`。
+
+!!!tip
+    加载栅格之后,可以在 Jupyter Notebook 中通过 `SedonaUtils.display_image(df)` 快速预览:它会自动识别栅格列并以图像形式渲染。详情请参阅 [栅格可视化文档](../api/sql/Raster-Functions.md#raster-output)。
+
+## 加载非 GeoTiff 数据(NetCDF、Arc Grid)
+
+对于 NetCDF、Arc Info ASCII Grid 等非 GeoTiff 栅格格式,请配合 Spark 内置的 `binaryFile` 数据源与 Sedona 的栅格构造器一起使用。
+
+### 步骤 1:加载为 binary DataFrame
+
+=== "Scala"
+    ```scala
+    var rawDf = sedona.read.format("binaryFile").load(path_to_raster_data)
+    rawDf.createOrReplaceTempView("rawdf")
+    rawDf.show()
+    ```
+
+=== "Java"
+    ```java
+    Dataset<Row> rawDf = sedona.read().format("binaryFile").load(path_to_raster_data);
+    rawDf.createOrReplaceTempView("rawdf");
+    rawDf.show();
+    ```
+
+=== "Python"
+    ```python
+    rawDf = sedona.read.format("binaryFile").load(path_to_raster_data)
+    rawDf.createOrReplaceTempView("rawdf")
+    rawDf.show()
+    ```
+
+输出大致如下:
+
+```
+|                path|    modificationTime|length|             content|
++--------------------+--------------------+------+--------------------+
+|file:/Download/ra...|2023-09-06 16:24:...|174803|[49 49 2A 00 08 0...|
+```
+
+如需加载多个栅格文件,可递归加载:
+
+=== "Python"
+    ```python
+    rawDf = (
+        sedona.read.format("binaryFile")
+        .option("recursiveFileLookup", "true")
+        .option("pathGlobFilter", "*.asc*")
+        .load(path_to_raster_data_folder)
+    )
+    rawDf.createOrReplaceTempView("rawdf")
+    rawDf.show()
+    ```
+
+### 步骤 2:创建 Raster 类型列
+
+SedonaSQL 中所有栅格运算都要求 Raster 类型对象,可使用以下任一构造器:
+
+#### 从 GeoTiff 创建
+
+```sql
+SELECT RS_FromGeoTiff(content) AS rast, modificationTime, length, path FROM rawdf
+```
+
+#### 从 Arc Grid 创建
+
+```sql
+SELECT RS_FromArcInfoAsciiGrid(content) AS rast, modificationTime, length, path FROM rawdf
+```
+
+#### 从 NetCDF 创建
+
+加载 NetCDF 文件的方法详见 [RS_FromNetCDF](../api/sql/Raster-Constructors/RS_FromNetCDF.md)。
+
+校验栅格列是否创建成功:
+
+```python
+rasterDf.printSchema()
+```
+
+```
+root
+ |-- rast: raster (nullable = true)
+ |-- modificationTime: timestamp (nullable = true)
+ |-- length: long (nullable = true)
+ |-- path: string (nullable = true)
+```
+
+## 栅格的元数据
+
+Sedona 提供了获取栅格元数据的函数,以及获取栅格 world file 的函数。
+
+### 元数据
+
+该函数返回一个数组,包含栅格的所有必要信息,详见 [RS_MetaData](../api/sql/Raster-Operators/RS_MetaData.md)。
+
+```sql
+SELECT RS_MetaData(rast) FROM rasterDf
+```
+
+输出形如:
+
+```
+[-1.3095817809482181E7, 4021262.7487925636, 512.0, 517.0, 72.32861272132695, -72.32861272132695, 0.0, 0.0, 3857.0, 1.0]
+```
+
+数组中前两个元素是栅格图像左上像素的真实地理坐标(如经纬度),接下来的两个元素是栅格的像素维度。
+
+### World File
+
+[world file](https://en.wikipedia.org/wiki/World_file) 有 GDAL 与 ESRI 两种 georeference。详情参见 [RS_GeoReference](../api/sql/Raster-Accessors/RS_GeoReference.md)。
+
+```sql
+SELECT RS_GeoReference(rast, "ESRI") FROM rasterDf
+```
+
+输出如下:
+
+```
+72.328613
+0.000000
+0.000000
+-72.328613
+-13095781.645176
+4021226.584486
+```
+
+world file 用于通过建立图像到世界坐标的变换,把真实地理坐标对应到图像像素,从而实现 georeference 与 geolocate。
+
+## 栅格操作
+
+自 `v1.5.0` 起 Sedona 增加了大量栅格操作能力。下面给出几个示例查询。
+
+!!!note
+    更多栅格操作请参阅 [SedonaSQL 栅格算子](../api/sql/Raster-Functions.md#raster-operators)。
+
+### 坐标转换
+
+Sedona 支持按需在像素坐标与世界坐标之间互相转换。
+
+#### PixelAsPoint
+
+使用 [RS_PixelAsPoint](../api/sql/Pixel-Functions/RS_PixelAsPoint.md) 将像素坐标转换为世界坐标位置:
+
+```sql
+SELECT RS_PixelAsPoint(rast, 450, 400) FROM rasterDf
+```
+
+输出:
+
+```
+POINT (-13063342 3992403.75)
+```
+
+#### 世界坐标转栅格坐标
+
+使用 [RS_WorldToRasterCoord](../api/sql/Raster-Accessors/RS_WorldToRasterCoord.md) 把世界坐标位置转换为像素坐标。仅取 X 用 [RS_WorldToRasterCoordX](../api/sql/Raster-Accessors/RS_WorldToRasterCoordX.md),仅取 Y 用 [RS_WorldToRasterCoordY](../api/sql/Raster-Accessors/RS_WorldToRasterCoordY.md)。
+
+```sql
+SELECT RS_WorldToRasterCoord(rast, -1.3063342E7, 3992403.75)
+```
+
+输出:
+
+```
+POINT (450 400)
+```
+
+### 像素操作
+
+使用 [RS_Values](../api/sql/Raster-Operators/RS_Values.md) 获取由点几何数组指定位置上的栅格值。这些点几何的坐标表示真实世界位置。
+
+```sql
+SELECT RS_Values(rast, Array(ST_Point(-13063342, 3992403.75), ST_Point(-13074192, 3996020)))
+```
+
+输出:
+
+```
+[132.0, 148.0]
+```
+
+要在网格或某个几何区域内修改像素值,可使用 [RS_SetValues](../api/sql/Raster-Operators/RS_SetValues.md):
+
+```sql
+SELECT RS_SetValues(
+        rast, 1, 250, 260, 3, 3,
+        Array(10, 12, 17, 26, 28, 37, 43, 64, 66)
+    )
+```
+
+详细用法请点击上面的链接。
+
+### 波段操作
+
+Sedona 提供了从栅格图像中选择特定波段并构造新栅格的 API。例如,使用 [RS_Band](../api/sql/Raster-Band-Accessors/RS_Band.md) 从栅格中选取 2 个波段以构造多波段栅格。
+
+下面以一张 [多波段栅格](https://github.com/apache/sedona/blob/2a0b36989aa895c0781f9a10c907dd726506d0b7/spark/common/src/test/resources/raster_geotiff_color/FAA_UTM18N_NAD83.tif) 为例进行演示,加载与转换为 raster 类型的方式与前文相同。
+
+```sql
+SELECT RS_Band(colorRaster, Array(1, 2))
+```
+
+如果有多个单波段栅格,希望把额外的波段加入栅格以执行 [map algebra 操作](#execute-map-algebra-operations),可使用 [RS_AddBand](../api/sql/Raster-Operators/RS_AddBand.md):
+
+```sql
+SELECT RS_AddBand(raster1, raster2, 1, 2)
+```
+
+执行后 `raster1` 会附带上 `raster2` 中指定的波段。
+
+### 重采样栅格数据
+
+Sedona 支持使用最近邻、双线性、双三次等不同插值方法对栅格数据进行重采样,以改变 cell 大小或对齐栅格网格,详见 [RS_Resample](../api/sql/Raster-Operators/RS_Resample.md)。
+
+```sql
+SELECT RS_Resample(rast, 50, -50, -13063342, 3992403.75, true, "bicubic")
+```
+
+更多用法请参考链接中的文档。
+
+## 执行 map algebra 操作
+
+map algebra 是一种通过数学表达式对栅格进行计算的方法。表达式既可以是简单的算术运算,也可以是多个运算的复杂组合。
+
+归一化植被指数(NDVI)是一个简单的图形指标,常用于分析航天平台的遥感测量结果,评估观测目标是否包含活体绿色植被:
+
+```
+NDVI = (NIR - Red) / (NIR + Red)
+```
+
+其中 NIR 表示近红外波段,Red 表示红色波段。
+
+```sql
+SELECT RS_MapAlgebra(raster, 'D', 'out = (rast[3] - rast[0]) / (rast[3] + rast[0]);') as ndvi FROM raster_table
+```
+
+更多内容请参阅 [Map Algebra API](../api/sql/Raster-map-algebra.md)。
+
+## 栅格与矢量数据的互通
+
+### 几何转栅格
+
+可以使用 [RS_AsRaster](../api/sql/Raster-Operators/RS_AsRaster.md) 把几何对象栅格化:
+
+```sql
+SELECT RS_AsRaster(
+        ST_GeomFromWKT('POLYGON((150 150, 220 260, 190 300, 300 220, 150 150))'),
+        RS_MakeEmptyRaster(1, 'b', 4, 6, 1, -1, 1),
+        'b', 230
+    )
+```
+
+针对该矢量生成的图像如下:
+
+![Rasterized vector](../image/rasterized-image.png)
+
+!!!note
+    示例图像中的矢量坐标做了适度放大以便观察,实际使用时不一定与本例完全一致。
+
+### 空间范围查询
+
+Sedona 提供了基于几何窗口的栅格谓词来执行范围查询。例如使用 [RS_Intersects](../api/sql/Raster-Predicates/RS_Intersects.md):
+
+```sql
+SELECT rast FROM rasterDf WHERE RS_Intersect(rast, ST_GeomFromWKT('POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))'))
+```
+
+### 空间连接查询
+
+Sedona 的栅格谓词同样支持基于栅格列与几何列的空间连接:
+
+```sql
+SELECT r.rast, g.geom FROM rasterDf r, geomDf g WHERE RS_Interest(r.rast, g.geom)
+```
+
+!!!note
+    上述范围查询与连接查询都会基于提供的几何边界以及栅格的空间边界进行过滤。
+
+    Sedona 还提供了更多用于空间范围查询与空间连接的栅格谓词,详见 [栅格谓词文档](../api/sql/Raster-Functions.md#raster-predicates)。
+
+## 可视化栅格图像
+
+Sedona 提供了若干 API 把栅格数据以图像形式可视化。
+
+### Base64 字符串
+
+[RS_AsBase64](../api/sql/Raster-Output/RS_AsBase64.md) 将栅格编码为 Base64 字符串,可以使用 [在线解码器](https://base64-viewer.onrender.com/) 查看:
+
+```sql
+SELECT RS_AsBase64(rast) FROM rasterDf
+```
+
+### HTML Image
+
+[RS_AsImage](../api/sql/Raster-Output/RS_AsImage.md) 返回一个 HTML `<img>` 标签,可以在 HTML viewer 或 Jupyter Notebook 中查看:
+
+```sql
+SELECT RS_AsImage(rast, 500) FROM rasterDf
+```
+
+输出如下:
+
+![Output](../image/DisplayImage.png)
+
+!!!tip
+    在 Jupyter Notebook 中使用 `SedonaUtils.display_image` 即可直接渲染栅格,无需手动调用 RS_AsImage:
+
+    ```python
+    from sedona.spark import SedonaUtils
+
+    SedonaUtils.display_image(rasterDf)
+    ```
+
+    详情请参阅 [在 Jupyter 中显示栅格](../api/sql/Raster-Functions.md#raster-output)。
+
+### 二维矩阵
+
+如果上述 API 不能满足需求,Sedona 还提供了将栅格数据可视化为二维矩阵的 API:
+
+```sql
+SELECT RS_AsMatrix(rast) FROM rasterDf
+```
+
+输出形如:
+
+```sql
+| 1   3   4   0|
+| 2   9  10  11|
+| 3   4   5   6|
+```
+
+更多用法请参阅 [栅格可视化文档](../api/sql/Raster-Functions.md#raster-output)。
+
+## 保存到永久存储
+
+保存栅格数据分两步:(1) 使用某个 `RS_AsXXX` 函数将 Raster 列转换为二进制格式;(2) 通过 Sedona 的 `raster` 数据源 writer 把二进制 DataFrame 写入文件。
+
+### 步骤 1:转换为二进制格式
+
+可选的输出格式函数:
+
+| 函数 | 格式 | 说明 |
+| :--- | :--- | :--- |
+| [RS_AsGeoTiff](../api/sql/Raster-Output/RS_AsGeoTiff.md) | GeoTiff | 通用栅格格式,可选压缩 |
+| [RS_AsCOG](../api/sql/Raster-Output/RS_AsCOG.md) | Cloud Optimized GeoTiff | 适合云存储,支持高效的范围读取 |
+| [RS_AsArcGrid](../api/sql/Raster-Output/RS_AsArcGrid.md) | Arc Grid | 基于 ASCII 的格式,仅支持单波段 |
+| [RS_AsPNG](../api/sql/Raster-Output/RS_AsPNG.md) | PNG | 图像格式,仅支持无符号整型像素 |
+
+```sql
+SELECT RS_AsGeoTiff(rast) AS raster_binary FROM rasterDf
+```
+
+### 步骤 2:写入文件
+
+使用 Sedona 内置的 `raster` 数据源写出二进制 DataFrame:
+
+=== "Scala"
+    ```scala
+    rasterDf.withColumn("raster_binary", expr("RS_AsGeoTiff(rast)"))
+      .write.format("raster").mode("overwrite").save("my_raster_file")
+    ```
+
+=== "Python"
+    ```python
+    rasterDf.withColumn("raster_binary", expr("RS_AsGeoTiff(rast)")).write.format(
+        "raster"
+    ).mode("overwrite").save("my_raster_file")
+    ```
+
+writer 数据源的常用选项:
+
+| 选项 | 默认值 | 说明 |
+| :--- | :--- | :--- |
+| `rasterField` | schema 中最后一个 `binary` 列 | 要写出的二进制列名。当 DataFrame 含有多个 binary 列时,强烈建议显式指定。 |
+| `fileExtension` | `.tiff` | 输出文件的扩展名(如 `.png`、`.asc`)。 |
+| `pathField` | None | 包含输出文件名的列名。仅使用基础文件名(去掉目录),并把已有扩展名替换为 `fileExtension`。未设置时每个文件以随机 UUID 命名。 |
+| `useDirectCommitter` | `true` | 若为 `true`,文件直接写入目标位置;若为 `false`,先写入临时位置再移动。`false` 速度较慢,尤其在 S3 等对象存储上。 |
+
+带全部选项的示例:
+
+=== "Scala"
+    ```scala
+    rasterDf.withColumn("raster_binary", expr("RS_AsGeoTiff(rast)"))
+      .write.format("raster")
+      .option("rasterField", "raster_binary")
+      .option("pathField", "name")
+      .option("fileExtension", ".tiff")
+      .mode("overwrite")
+      .save("my_raster_file")
+    ```
+
+=== "Python"
+    ```python
+    rasterDf.withColumn("raster_binary", expr("RS_AsGeoTiff(rast)")).write.format(
+        "raster"
+    ).option("rasterField", "raster_binary").option("pathField", "name").option(
+        "fileExtension", ".tiff"
+    ).mode(
+        "overwrite"
+    ).save(
+        "my_raster_file"
+    )
+    ```
+
+写出后的文件结构形如:
+
+```
+my_raster_file
+- part-00000-6c7af016-c371-4564-886d-1690f3b27ca8-c000
+	- test1.tiff
+	- .test1.tiff.crc
+- part-00001-6c7af016-c371-4564-886d-1690f3b27ca8-c000
+	- test2.tiff
+	- .test2.tiff.crc
+- _SUCCESS
+```
+
+读回保存的栅格:
+
+```python
+rasterDf = sedona.read.format("raster").load("my_raster_file/*/*.tiff")
+```
+
+## 在 Python 中收集并本地处理带栅格列的 DataFrame
+
+自 `v1.6.0` 起,Sedona 支持把含有栅格列的 DataFrame 收集(collect)到 Python 端进行本地处理。栅格对象在 Python 端表示为 `SedonaRaster`,可对其执行各种栅格操作。
+
+!!!tip
+    如果只是希望在 Jupyter 中快速预览栅格,无需 collect DataFrame,使用 `SedonaUtils.display_image(df)` 即可:
+
+    ```python
+    from sedona.spark import SedonaUtils
+
+    SedonaUtils.display_image(df_raster)
+    ```
+
+```python
+df_raster = (
+    sedona.read.format("raster").option("retile", "false").load("/path/to/raster.tif")
+)
+rows = df_raster.collect()
+raster = rows[0].rast
+raster  # <sedona.raster.sedona_raster.InDbSedonaRaster at 0x1618fb1f0>
+```
+
+通过 `SedonaRaster` 对象的属性可以读取栅格元数据:
+
+```python
+raster.width  # 栅格宽度
+raster.height  # 栅格高度
+raster.affine_trans  # 仿射变换矩阵
+raster.crs_wkt  # 以 WKT 表示的坐标参考系
+```
+
+可以通过 `as_numpy` 或 `as_numpy_masked` 方法获取栅格波段数据的 numpy 数组,数组按 CHW 顺序组织。
+
+```python
+raster.as_numpy()  # 栅格的 numpy 数组
+raster.as_numpy_masked()  # nodata 值被掩为 nan 的 numpy 数组
+```
+
+如果希望使用 `rasterio` 处理栅格数据,可以通过 `as_rasterio` 方法获取一个 `rasterio.DatasetReader` 对象。
+
+!!!note
+    使用此方法需要安装 `rasterio` 包(>= 1.2.10):`pip install rasterio`。
+
+```python
+ds = raster.as_rasterio()  # rasterio.DatasetReader 对象
+# 使用 rasterio 处理栅格
+band1 = ds.read(1)  # 读取第 1 个波段
+```
+
+## 编写处理栅格数据的 Python UDF
+
+可以编写 Python UDF 来处理栅格数据。UDF 接收 `SedonaRaster` 对象作为输入,返回任意 Spark 数据类型。下面是一个计算栅格均值的 UDF 示例:
+
+```python
+from pyspark.sql.types import DoubleType
+
+
+def mean_udf(raster):
+    return float(raster.as_numpy().mean())
+
+
+sedona.udf.register("mean_udf", mean_udf, DoubleType())
+df_raster.withColumn("mean", expr("mean_udf(rast)")).show()
+```
+
+```
++--------------------+------------------+
+|                rast|              mean|
++--------------------+------------------+
+|GridCoverage2D["g...|1542.8092886117788|
++--------------------+------------------+
+```
+
+返回栅格对象的 UDF 较为棘手,因为 Sedona 目前还不支持序列化 Python 端的栅格对象。但可以让 UDF 返回波段数据数组,再通过 `RS_MakeRaster` 构造栅格对象。下面是一个基于输入栅格第一个波段创建掩码栅格的 Python UDF:
+
+```python
+from pyspark.sql.types import ArrayType, DoubleType
+import numpy as np
+
+
+def mask_udf(raster):
+    band1 = raster.as_numpy()[0, :, :]
+    mask = (band1 < 1400).astype(np.float64)
+    return mask.flatten().tolist()
+
+
+sedona.udf.register("mask_udf", band_udf, ArrayType(DoubleType()))
+df_raster.withColumn("mask", expr("mask_udf(rast)")).withColumn(
+    "mask_rast", expr("RS_MakeRaster(rast, 'I', mask)")
+).show()
+```
+
+```
++--------------------+--------------------+--------------------+
+|                rast|                mask|           mask_rast|
++--------------------+--------------------+--------------------+
+|GridCoverage2D["g...|[0.0, 0.0, 0.0, 0...|GridCoverage2D["g...|
++--------------------+--------------------+--------------------+
+```
+
+## 性能优化
+
+处理大规模栅格数据集时,请参考 [在 Parquet 中存储栅格几何对象](storing-blobs-in-parquet.md) 一文中的性能优化建议。
diff --git a/docs/tutorial/snowflake/sql.zh.md b/docs/tutorial/snowflake/sql.zh.md
new file mode 100644
index 0000000000..b044421b2b
--- /dev/null
+++ b/docs/tutorial/snowflake/sql.zh.md
@@ -0,0 +1,618 @@
+<!--
+ 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.
+ -->
+
+完成安装后,您就可以开始使用 Sedona 函数了。请使用具备访问数据库权限的用户重新登录 Snowflake。
+
+!!!note
+	使用 Sedona 函数时请始终保留 schema 名 `SEDONA`(如 `SEDONA.ST_GeomFromWKT`),以避免与 Snowflake 内置函数冲突。
+
+## 在 Snowflake 中访问 Sedona 函数
+
+请先确保引用了正确的函数。默认情况下,Sedona 函数位于 `SEDONASNOW.SEDONA` 这个数据库.schema 下:
+
+```sql
+USE DATABASE SEDONASNOW;
+```
+
+也可以使用其他数据库,并通过完全限定名调用,例如 `SEDONASNOW.SEDONA.ST_GeomFromText`。
+
+## 创建示例表
+
+下面创建一个 `city_tbl`,其中包含城市的位置与名称。每个位置以 WKT 字符串表示:
+
+```sql
+CREATE OR REPLACE TABLE city_tbl (wkt STRING, city_name STRING);
+INSERT INTO city_tbl(wkt, city_name) VALUES ('POINT (-122.33 47.61)', 'Seattle');
+INSERT INTO city_tbl(wkt, city_name) VALUES ('POINT (-122.42 37.76)', 'San Francisco');
+```
+
+可以查看该表的内容:
+
+```sql
+SELECT *
+FROM city_tbl;
+```
+
+输出:
+
+```
+WKT	CITY_NAME
+POINT (-122.33 47.61)	Seattle
+POINT (-122.42 37.76)	San Francisco
+```
+
+## 创建 Geometry/Geography 列
+
+SedonaSQL 中所有几何运算都作用在 Geometry/Geography 类型对象上。因此在执行任何查询之前,需要在表上构造一列 Geometry/Geography 类型列:
+
+```sql
+CREATE OR REPLACE TABLE city_tbl_geom AS
+SELECT SEDONA.ST_GeomFromWKT(wkt) AS geom, city_name
+FROM city_tbl
+```
+
+`city_tbl_geom` 表中的 `geom` 列现在是 `Binary` 类型,其中数据以 Sedona 能理解的格式存储。该查询的输出会以 WKB 二进制形式显示几何对象,类似如下:
+
+```
+GEOM CITY_NAME
+010100000085eb51b81e955ec0ae47e17a14ce4740  Seattle
+01010000007b14ae47e19a5ec0e17a14ae47e14240  San Francisco
+```
+
+如需以人类可读的方式查看该列内容,可以使用 `SEDONA.ST_AsText`,例如:
+
+```sql
+SELECT SEDONA.ST_AsText(geom), city_name
+FROM city_tbl_geom
+```
+
+也可以创建 Snowflake 原生 Geometry / Geography 类型列。例如,以下代码创建一个 Snowflake 原生 Geometry 类型列(注意函数名称没有 `SEDONA` 前缀):
+
+```sql
+CREATE OR REPLACE TABLE city_tbl_geom AS
+SELECT ST_GeometryFromWKT(wkt) AS geom, city_name
+FROM city_tbl
+```
+
+下面的代码创建一个 Snowflake 原生 Geography 类型列(同样没有 `SEDONA` 前缀):
+
+```sql
+CREATE OR REPLACE TABLE city_tbl_geom AS
+SELECT ST_GeographyFromWKT(wkt) AS geom, city_name
+FROM city_tbl
+```
+
+!!!note
+	SedonaSQL 提供了大量构造 Geometry 列的函数,详见 [SedonaSQL API](../../api/snowflake/vector-data/Geometry-Functions.md)。
+
+## 检查经纬度顺序(lon/lat)
+
+在 SedonaSnow `v1.4.1` 及之前的版本中,下列函数使用 lat/lon 顺序:
+
+* SEDONA.ST_Transform
+* SEDONA.ST_DistanceSphere
+* SEDONA.ST_DistanceSpheroid
+
+下列函数使用 `lon/lat` 顺序:
+
+* SEDONA.ST_GeomFromGeoHash
+* SEDONA.ST_GeoHash
+* SEDONA.ST_S2CellIDs
+
+自 Sedona `v1.5.0` 起,所有函数统一使用 lon/lat 顺序。
+
+如果原始数据的坐标顺序与所需顺序不一致,可使用 `SEDONA.ST_FlipCoordinates(geom: Geometry)` 进行翻转。
+
+上文示例数据采用 lon/lat 顺序,可按如下方式翻转坐标:
+
+```sql
+CREATE OR REPLACE TABLE city_tbl_geom AS
+SELECT SEDONA.ST_FlipCoordinates(geom) AS geom, city_name
+FROM city_tbl_geom
+```
+
+再次查看表内容,此时已变为 lat/lon 顺序:
+
+```sql
+SELECT SEDONA.ST_AsText(geom), city_name
+FROM city_tbl_geom
+```
+
+输出:
+
+```
+GEOM	CITY_NAME
+POINT (47.61 -122.33)	Seattle
+POINT (37.76 -122.42)	San Francisco
+```
+
+## 保存为普通列
+
+要将表持久化到永久存储中,只需把 Geometry 类型列里的每个几何对象转换回普通字符串再保存即可。
+
+可使用以下代码把表中的 Geometry 列还原为 WKT 字符串列:
+
+```sql
+SELECT SEDONA.ST_AsText(geom)
+FROM city_tbl_geom
+```
+
+!!!note
+	SedonaSQL 提供了多种保存 Geometry 列的函数,详见 [SedonaSQL API](../../api/snowflake/vector-data/Overview.md)。
+
+## 转换坐标参考系
+
+Sedona 不会自动管理一列 Geometry 中所有几何对象的坐标单位(基于度还是基于米)。SedonaSQL 中所有相关距离的单位与 Geometry 列中几何对象的单位保持一致。
+
+要转换 Geometry 列的坐标参考系,可使用 `SEDONA.ST_Transform(A:geometry, SourceCRS:string, TargetCRS:string)`。
+
+`SEDONA.ST_Transform` 第一个 EPSG 代码 EPSG:4326 是源 CRS——也就是最常见的基于度的 CRS(WGS84)。
+
+第二个 EPSG 代码 EPSG:3857 是目标 CRS——最常见的基于米的 CRS。
+
+`SEDONA.ST_Transform` 会把这些几何对象的 CRS 从 EPSG:4326 转换到 EPSG:3857。详细 CRS 信息可以在 [EPSG.io](https://epsg.io/) 找到。
+
+!!!note
+	该函数在 1.5.0+ 中使用 lon/lat 顺序,在 1.4.1 及之前使用 lat/lon 顺序。可以使用 `SEDONA.ST_FlipCoordinates` 交换 X 与 Y。
+
+按以下方式转换示例数据:
+
+```sql
+SELECT SEDONA.ST_AsText(SEDONA.ST_Transform(geom, 'epsg:4326', 'epsg:3857')), city_name
+FROM city_tbl_geom
+```
+
+输出:
+
+```
+POINT (6042216.250411431 -13617713.308741156)  Seattle
+POINT (4545577.120361927 -13627732.06291255)  San Francisco
+```
+
+`SEDONA.ST_Transform` 同样支持 OGC WKT 格式的 CRS 字符串。下面的查询输出与上面相同,但目标 CRS 以 OGC WKT 字符串给出:
+
+```sql
+SELECT SEDONA.ST_AsText(SEDONA.ST_Transform(geom, 'epsg:4326', 'PROJCS["WGS 84 / Pseudo-Mercator",
+     GEOGCS["WGS 84",
+         DATUM["WGS_1984",
+             SPHEROID["WGS 84",6378137,298.257223563,
+                 AUTHORITY["EPSG","7030"]],
+             AUTHORITY["EPSG","6326"]],
+         PRIMEM["Greenwich",0,
+             AUTHORITY["EPSG","8901"]],
+         UNIT["degree",0.0174532925199433,
+             AUTHORITY["EPSG","9122"]],
+         AUTHORITY["EPSG","4326"]],
+     PROJECTION["Mercator_1SP"],
+     PARAMETER["central_meridian",0],
+     PARAMETER["scale_factor",1],
+     PARAMETER["false_easting",0],
+     PARAMETER["false_northing",0],
+     UNIT["metre",1,
+         AUTHORITY["EPSG","9001"]],
+     AXIS["Easting",EAST],
+     AXIS["Northing",NORTH],
+     EXTENSION["PROJ4","+proj=merc +a=6378137 +b=6378137 +lat_ts=0 +lon_0=0 +x_0=0 +y_0=0 +k=1 +units=m +nadgrids=@null +wktext +no_defs"],
+     AUTHORITY["EPSG","3857"]]')), city_name
+FROM city_tbl_geom
+```
+
+## 范围查询
+
+使用 ==SEDONA.ST_Contains==、==SEDONA.ST_Intersects==、==SEDONA.ST_Within== 在单列上执行范围查询。
+
+下例查找位于给定多边形内的所有几何对象:
+
+```sql
+SELECT *
+FROM city_tbl_geom
+WHERE SEDONA.ST_Contains(SEDONA.ST_PolygonFromEnvelope(1.0,100.0,1000.0,1100.0), geom)
+```
+
+!!!note
+	了解如何创建 Geometry 类型的查询窗口请参阅 [SedonaSQL API](../../api/snowflake/vector-data/Geometry-Functions.md)。
+
+## KNN 查询
+
+使用 ==SEDONA.ST_Distance==、==SEDONA.ST_DistanceSphere==、==ST_DistanceSpheroid== 计算距离并排序。
+
+下面的代码返回距离给定点最近的 5 个对象:
+
+```sql
+SELECT geom, SEDONA.ST_Distance(SEDONA.ST_Point(1.0, 1.0), geom) AS distance
+FROM city_tbl_geom
+ORDER BY distance DESC
+LIMIT 5
+```
+
+## 范围连接查询
+
+!!!warning
+	Sedona 在 Snowflake 中的范围连接不会触发 Sedona 的优化空间连接算法(Sedona Spark 会触发),它使用的是 Snowflake 默认的笛卡尔连接,速度非常慢。建议改用 Sedona 的 S2 等值连接,或者使用 Snowflake 原生 ST 函数 + 原生 `Geography` 类型来执行范围连接,这样可以触发 Snowflake 的 `GeoJoin` 算法。
+
+简介:从 A、B 两侧的几何对象中找到所有满足某种谓词的几何对组合。
+
+示例:
+
+构造演示用的表:
+
+```sql
+CREATE OR REPLACE TABLE polygondf AS
+SELECT SEDONA.ST_GeomFromText('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))') polygonshape;
+```
+
+```sql
+CREATE OR REPLACE TABLE pointdf AS
+SELECT SEDONA.ST_GeomFromText('POINT(0.5 0.5)') pointshape;
+```
+
+使用不同的空间谓词执行查询:
+
+```sql
+SELECT *
+FROM polygondf, pointdf
+WHERE SEDONA.ST_Contains(polygondf.polygonshape,pointdf.pointshape)
+```
+
+```sql
+SELECT *
+FROM polygondf, pointdf
+WHERE SEDONA.ST_Intersects(polygondf.polygonshape,pointdf.pointshape)
+```
+
+```sql
+SELECT *
+FROM pointdf, polygondf
+WHERE SEDONA.ST_Within(pointdf.pointshape, polygondf.polygonshape)
+```
+
+对应的更快的空间连接(仅使用 Snowflake 原生函数)写法:
+
+```sql
+WITH polygondf AS (
+    SELECT ST_GeomFromText('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))') polygonshape
+),
+pointdf AS (
+    SELECT ST_GeomFromText('POINT(0.5 0.5)') pointshape
+)
+SELECT *
+FROM polygondf, pointdf
+WHERE ST_Contains(polygondf.polygonshape,pointdf.pointshape)
+```
+
+`ST_Intersects`、`ST_Within` 等其他谓词也可以原生使用。
+
+## 距离连接
+
+!!!warning
+	Sedona 在 Snowflake 中的距离连接不会触发 Sedona 的优化空间连接算法(Sedona Spark 会触发),它使用的是 Snowflake 默认的笛卡尔连接,速度非常慢。建议改用 Sedona 的 S2 等值连接,或者使用 Snowflake 原生 ST 函数 + 原生 `Geography` 类型来执行范围连接,从而触发 Snowflake 的 `GeoJoin` 算法。
+
+简介:从 A、B 两侧的几何对象中找到所有距离小于等于某阈值的对组合。支持的平面欧氏距离函数包括 `SEDONA.ST_Distance`、`SEDONA.ST_HausdorffDistance`、`SEDONA.ST_FrechetDistance`,基于米的测地距离函数包括 `SEDONA.ST_DistanceSpheroid` 与 `SEDONA.ST_DistanceSphere`。Snowflake 仅原生支持 `ST_Distance`。
+
+先创建两个仅含一个几何对象的演示表:
+
+```sql
+CREATE OR REPLACE TABLE pointdf2 AS
+SELECT SEDONA.ST_GeomFromText('POINT(0 0)') pointshape;
+```
+
+```sql
+CREATE OR REPLACE TABLE polygondf2 AS
+SELECT SEDONA.ST_GeomFromText('POLYGON((0.5 0.5, 0.5 1, 1 1, 1 0.5, 0.5 0.5))') polygonshape;
+```
+
+平面欧氏距离示例:
+
+`POINT(0 0)` 与 `POINT(0.5 0.5)` 之间的常规 L2 欧氏距离是 0.5 的平方根,因此下面这条查询返回这唯一一对点:
+
+```sql
+SELECT *
+FROM pointdf, pointdf2
+WHERE SEDONA.ST_Distance(pointdf.pointshape,pointdf2.pointshape) <= sqrt(0.5)
+```
+
+两个不相离的多边形之间的 L2 距离为 0,因此下面的查询返回这唯一的多边形对:
+
+```sql
+SELECT *
+FROM polygondf, polygondf2
+WHERE SEDONA.ST_Distance(polygondf.polygonshape,polygondf2.polygonshape) <= 0
+```
+
+但 Hausdorff 与 Fréchet 距离未必如此。下面的两个查询都不会返回任何行:
+
+```sql
+SELECT *
+FROM polygondf, polygondf2
+WHERE SEDONA.ST_HausdorffDistance(polygondf.polygonshape, polygondf2.polygonshape, 0.3) <= 0
+```
+
+```sql
+SELECT *
+FROM polygondf, polygondf2
+WHERE SEDONA.ST_FrechetDistance(polygondf.polygonshape, polygondf2.polygonshape)  <= 0
+```
+
+注意:只有 Hausdorff 距离接受第三个参数 `densityFraction`,取值范围 $(0,1]$,值越小结果越精确。
+
+!!!warning
+	如果使用 `SEDONA.ST_Distance`、`SEDONA.ST_HausdorffDistance` 或 `SEDONA.ST_FrechetDistance` 等平面欧氏距离函数作为谓词,Sedona 不会管理 `distance` 的单位(度还是米),其单位与几何对象保持一致。如果坐标是经纬度,那么 `distance` 的单位应当是度而不是米或英里。要修改几何对象的单位,要么通过 [SEDONA.ST_Transform](../../api/snowflake/vector-data/Spatial-Reference-System/ST_Transform.md) 转换到基于米的坐标系;如果不希望转换数据,请改用 `SEDONA.ST_DistanceSpheroid` 或 `SEDONA.ST_DistanceSphere`。
+
+例如,下面的查询大约返回 78.45 千米——因为即使没有显式设置 CRS,几何对象也被默认视为经纬度:
+
+```sql
+SELECT SEDONA.ST_DistanceSpheroid(pointdf.pointshape,pointdf2.pointshape)
+FROM pointdf, pointdf2
+```
+
+下面这条查询展示了:在 `GEOGRAPHY` 对象上使用 Snowflake 原生的 `ST_DISTANCE` 与 `SEDONA.ST_DistanceSphere`、`SEDONA.ST_DistanceSpheroid` 给出的结果相近:
+
+```sql
+SELECT
+    SEDONA.ST_DistanceSphere(
+        pointdf.pointshape,
+        pointdf2.pointshape
+    ) SEDONA_ST_DistanceSphere,
+    --
+    SEDONA.ST_DistanceSpheroid(
+        pointdf.pointshape,
+        pointdf2.pointshape
+    ) SEDONA_ST_DistanceSpheroid,
+    --
+    ST_DISTANCE(
+        TO_GEOGRAPHY(SEDONA.st_astext(pointdf.pointshape)),
+        TO_GEOGRAPHY(SEDONA.st_astext(pointdf2.pointshape) )
+    ) SFKL_ST_DISTANCE
+FROM pointdf, pointdf2
+```
+
+输出:
+
+| SEDONA_ST_DISTANCESPHERE | SEDONA_ST_DISTANCESPHEROID | SFKL_ST_DISTANCE |
+| ------------------------ | -------------------------- | ---------------- |
+| 78626.28640698           | 78451.248031239            | 78626.311089506  |
+
+## 基于 Google S2 的近似等值连接
+
+可以使用 Sedona 内置的 Google S2 函数来执行近似等值连接。该方法借助 Snowflake 内置的等值连接算法,可以选择跳过 refinement 步骤来牺牲精度换取性能。Sedona 的 S2 函数与 Snowflake 原生的 H3、Geohash 函数互为补充。
+
+操作步骤如下:
+
+### 1. 为两张表生成 S2 ID
+
+使用 [SEDONA.ST_S2CellIds](../../api/snowflake/vector-data/Spatial-Indexing/ST_S2CellIDs.md) 为每个几何对象生成 cell ID,单个几何对象可能产生多个 ID。
+
+```sql
+SELECT * FROM lefts, TABLE(FLATTEN(SEDONA.ST_S2CellIDs(lefts.geom, 15))) s1
+```
+
+```sql
+SELECT * FROM rights, TABLE(FLATTEN(SEDONA.ST_S2CellIDs(rights.geom, 15))) s2
+```
+
+### 2. 执行等值连接
+
+按 S2 cellId 对两张表做等值连接:
+
+```sql
+SELECT lcs.id AS lcs_id, lcs.geom AS lcs_geom, lcs.name AS lcs_name, rcs.id AS rcs_id, rcs.geom AS rcs_geom, rcs.name AS rcs_name
+FROM lcs JOIN rcs ON lcs.cellId = rcs.cellId
+```
+
+### 3. 可选:refine 结果
+
+由于 S2 cellId 的特性,连接结果可能存在少量假阳性,具体程度取决于 S2 level:level 越小,cell 越大,展开行数越少,但假阳性越多。
+
+为保证正确性,可使用任一 [空间谓词](../../api/snowflake/vector-data/Geometry-Functions.md#predicates) 过滤掉假阳性。将下面的查询替换步骤 2 中的查询:
+
+```sql
+SELECT lcs.id AS lcs_id, lcs.geom AS lcs_geom, lcs.name AS lcs_name, rcs.id AS rcs_id, rcs.geom AS rcs_geom, rcs.name AS rcs_name
+FROM lcs, rcs
+WHERE lcs.cellId = rcs.cellId AND ST_Contains(lcs.geom, rcs.geom)
+```
+
+可以看到,相比步骤 2 多了一个 `ST_Contains` 过滤来剔除假阳性,也可以使用 `ST_Intersects` 等其他谓词。
+
+!!!tip
+	如果不要求 100% 准确度且希望更快的查询速度,可以跳过此步骤。
+
+### 4. 可选:去重
+
+由于生成 S2 cellId 时使用了 `Flatten`,结果 DataFrame 中可能出现 `<lcs_geom, rcs_geom>` 重复匹配。可通过 GroupBy 去重:
+
+```sql
+SELECT lcs_id, rcs_id, ANY_VALUE(lcs_geom), ANY_VALUE(lcs_name), ANY_VALUE(rcs_geom), ANY_VALUE(rcs_name)
+FROM joinresult
+GROUP BY (lcs_id, rcs_id)
+```
+
+`ANY_VALUE` 用于在多个重复值中取一个。
+
+如果没有为每个几何对象提供唯一 ID,也可以直接按几何分组:
+
+```sql
+SELECT lcs_geom, rcs_geom, ANY_VALUE(lcs_name), ANY_VALUE(rcs_name)
+FROM joinresult
+GROUP BY (lcs_geom, rcs_geom)
+```
+
+!!!note
+	做点-多边形 join 时不会出现该问题,可以放心忽略;只有 polygon-polygon、polygon-linestring、linestring-linestring 等连接才会遇到此问题。
+
+### 5. 完整示例
+
+下面的查询创建了 2 个感兴趣区域(AOI)和 5 种空间查询(用经纬度边界框表示),分别为两张表生成 S2 覆盖,再以 S2 cell ID 进行合并。可以叠加空间过滤来保证连接结果的精确性。
+
+下例中的几何对象使用 Snowflake 原生 `ST_GeogFromText`(被视作 geography),用 `ST_GeomFromText` 也是可行的。注意 `SEDONA.ST_S2CellIDs` 接受 Snowflake `GEOGRAPHY` 或 `GEOMETRY` 对象以及一个整数 S2 精度。
+
+```sql
+-- lng/lat 顺序:无需翻转坐标
+-- lefts 是感兴趣区域(AOI)
+with lefts AS (
+  SELECT index AS poly_id_left, value AS wkt FROM TABLE(
+      SPLIT_TO_TABLE (
+          'POLYGON ((-74.64966372842101805 44.92318068906040196, -73.05513946490677313 44.92318068906040196, -73.05513946490677313 45.9127817308399031, -74.64966372842101805 45.9127817308399031, -74.64966372842101805 44.92318068906040196))|POLYGON ((-71.72125014775386376 46.58534825561803672, -70.72763860520016976 46.58534825561803672, -70.72763860520016976 47.26007441306773416, -71.72125014775386376 47.26007441306773416, -71.72125014775386376 46.58534825561803672))', '|'
+          )
+      )
+
+),
+-- rights 是查询多边形
+-- 第 1 个多边形与两个 AOI 都相交
+-- 第 2 个多边形包含两个 AOI
+-- 第 3 个多边形被 AOI 1 包含
+-- 第 4 个多边形与 AOI 1 接触
+-- 第 5 个多边形与两个 AOI 都不相交
+rights AS (
+  SELECT index AS poly_id_right, value AS wkt FROM TABLE(
+      SPLIT_TO_TABLE (
+          'POLYGON ((-73.51160030163114811 45.54300066590783302, -71.31736631503980561 45.54300066590783302, -71.31736631503980561 46.82515071005796869, -73.51160030163114811 46.82515071005796869, -73.51160030163114811 45.54300066590783302))|POLYGON ((-75.26522832 44.23585380, -69.77500453509208 44.23585380, -69.77500453509208 47.59180373699041411, -75.26522832 47.59180373699041411, -75.26522832 44.23585380))|POLYGON ((-73.82001807503861812 45.0759163125215423, -73.34011383205873358 45.0 [...]
+          )
+      )
+),
+-- 为两张表的多边形分别计算 S2 cell 覆盖
+-- S2 会对多边形进行离散化,分辨率越高结果越精确,但计算开销也越大
+-- 两张表必须使用相同 level 进行离散化,本例为 10
+lefts_s2 AS (
+    SELECT * FROM lefts, TABLE(FLATTEN(SEDONA.ST_S2CellIDs(ST_GeogFromText(lefts.wkt), 10)))
+),
+rights_s2 AS (
+    SELECT * FROM rights, TABLE(FLATTEN(SEDONA.ST_S2CellIDs(ST_GeogFromText(rights.wkt), 10)))
+)
+-- 按 S2 索引(int)合并,并 group by 以恢复原多边形而非 S2 cell
+-- 加上空间谓词可保证精确性;如果更看重速度可以省略
+-- 预期除第 5 个查询外都会匹配
+-- 期望结果共 6 行:1(接触)+ 1(被包含)+ 2(与两者相交)+ 2(包含两者)
+-- AOI 1(poly_id_left 1)应出现 4 次,AOI 2(poly_id_left 2)应出现 2 次
+SELECT rights_s2.wkt ,  lefts_s2.wkt, LISTAGG(DISTINCT poly_id_right::TEXT) poly_id_right, LISTAGG(DISTINCT poly_id_left::TEXT) poly_id_left
+FROM lefts_s2,rights_s2
+WHERE rights_s2.value = lefts_s2.value AND NOT ST_DISJOINT(ST_GeogFromText(rights_s2.wkt) , ST_GeogFromText( lefts_s2.wkt ) )
+GROUP BY rights_s2.wkt ,  lefts_s2.wkt
+
+```
+
+本例中省略 `not ST_DISJOINT(ST_GeogFromText(rights_s2.wkt) , ST_GeogFromText( lefts_s2.wkt ) )` 也会得到相同的结果。
+
+### 距离连接中的 S2 用法
+
+S2 同样适用于距离连接。先使用 `SEDONA.ST_Buffer(geometry, distance)` 把其中一列原始几何对象包裹起来。如果原始几何是点,`SEDONA.ST_Buffer` 会把它们变成半径为 `distance` 的圆。注意:Snowflake 没有原生的 `ST_Buffer` 函数。
+
+由于坐标位于经纬度系统,`distance` 的单位应为度而不是米或英里。可以通过 `METER_DISTANCE/111000.0` 做近似换算,再过滤掉假阳性。靠近极地或反子午线的数据可能会因此产生不准确的结果。
+
+简而言之,先在左表上跑下面这条查询(替换 `METER_DISTANCE` 为米值),然后在步骤 1 中基于 `buffered_geom` 列生成 S2 ID,再在原始 `geom` 列上执行步骤 2、3、4:
+
+```sql
+SELECT id, geom, SEDONA.ST_Buffer(geom, METER_DISTANCE/111000.0) AS buffered_geom, name
+FROM lefts
+```
+
+## Sedona 独有的函数
+
+Sedona 实现了 200 多个地理空间矢量与栅格函数,远多于 Snowflake 原生函数。例如:
+
+* [SEDONA.ST_3DDistance](../../api/snowflake/vector-data/Measurement-Functions/ST_3DDistance.md)
+* [SEDONA.ST_Force2D](../../api/snowflake/vector-data/Geometry-Editors/ST_Force_2D.md)
+* [SEDONA.ST_GeometryN](../../api/snowflake/vector-data/Geometry-Accessors/ST_GeometryN.md)
+* [SEDONA.ST_MakeValid](../../api/snowflake/vector-data/Geometry-Validation/ST_MakeValid.md)
+* [SEDONA.ST_Multi](../../api/snowflake/vector-data/Geometry-Editors/ST_Multi.md)
+* [SEDONA.ST_NumGeometries](../../api/snowflake/vector-data/Geometry-Accessors/ST_NumGeometries.md)
+* [SEDONA.ST_ReducePrecision](../../api/snowflake/vector-data/Geometry-Processing/ST_ReducePrecision.md)
+* [SEDONA.ST_SubdivideExplode](../../api/snowflake/vector-data/Overlay-Functions/ST_SubDivideExplode.md)
+
+可点击上面的链接深入了解这些函数。更多函数请参考 [SedonaSQL API](../../api/snowflake/vector-data/Overview.md)。
+
+## 与 Snowflake 原生函数互通
+
+Sedona 可以与 Snowflake 原生函数无缝互通,主要有两种方式:
+
+* 使用 `Sedona 函数` 创建 Geometry 列,然后使用 Snowflake 原生函数与 Sedona 函数共同查询;
+* 使用 `Snowflake 原生函数` 创建 Geometry/Geography 列,然后使用 Snowflake 原生函数与 Sedona 函数共同查询。
+
+下面分别进行演示。
+
+### 由 Sedona 几何构造器创建的几何
+
+这种情况下 Sedona 使用 EWKB 作为几何对象的输入/输出类型。如果数据集中已是内置的 Snowflake GEOMETRY/GEOGRAPHY 类型,可以通过该函数轻松转换为 EWKB。
+
+#### 从 Snowflake 原生函数到 Sedona 函数
+
+下例中 `SEDONA.ST_X` 是 Sedona 函数,`ST_GeommetryFromWkt` 与 `ST_AsEWKB` 是 Snowflake 原生函数:
+
+```sql
+SELECT SEDONA.ST_X(ST_AsEWKB(ST_GeometryFromWkt('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))'))) FROM {{geometry_table}};
+```
+
+#### 从 Sedona 函数到 Snowflake 原生函数
+
+下例中 `SEDONA.ST_GeomFromText` 是 Sedona 函数,`ST_AREA` 与 `to_geometry` 是 Snowflake 原生函数:
+
+```sql
+SELECT ST_AREA(to_geometry(SEDONA.ST_GeomFromText('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))')));
+```
+
+#### 优点:
+
+Sedona 的几何构造器比 Snowflake 原生函数更强大,主要优势如下:
+
+* Sedona 提供了更多构造器,尤其是用于 3D(XYZ)几何对象的构造器,Snowflake 原生函数不具备。
+* WKB 序列化更高效。如果需要使用多个 Sedona 函数,建议采用此方式,可能带来 2 倍左右的性能提升。
+* 几何对象的 SRID 信息会被保留。下面这种方式会丢失 SRID 信息。
+
+### 由 Snowflake 几何构造器创建的 Geometry / Geography
+
+这种情况下 Sedona 使用 Snowflake 原生 GEOMETRY/GEOGRAPHY 类型作为输入/输出类型,序列化格式为 GeoJSON 字符串。
+
+```sql
+SELECT ST_AREA(SEDONA.ST_Buffer(ST_GeometryFromWkt('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))'), 1));
+```
+
+下例中 `SEDONA.ST_Buffer` 是 Sedona 函数,`ST_GeommetryFromWkt` 与 `ST_AREA` 是 Snowflake 原生函数。
+
+可以看到,Sedona 函数与 Snowflake 原生函数可以混用而无需显式转换。
+
+#### 优点:
+
+* 无需显式转换几何类型,使用更方便。
+
+注意:Snowflake 原生会把 Geometry 类型数据序列化为 GeoJSON 字符串再传给 UDF。GeoJSON 规范不包含 SRID。因此,如果直接混用 Snowflake 函数与 Sedona 函数而不使用 `WKB`,SRID 信息会丢失。
+
+下例中 SRID=4326 信息会丢失:
+
+```sql
+SELECT ST_AsEWKT(SEDONA.ST_SetSRID(ST_GeometryFromWKT('POINT(1 2)'), 4326))
+```
+
+输出:
+
+```
+SRID=0;POINT(1 2)
+```
+
+## 已知问题
+
+1. Sedona Snowflake 不支持 `M` 维度,原因是 WKB 序列化的限制。Sedona Spark 与 Sedona Flink 由于使用了内部专有序列化格式,因此支持 XYZM。Sedona Snowflake 中虽然存在与 `M` 相关的函数,但所有 `M` 值会被忽略。
+2. Sedona H3 函数尚不可用,因为 Snowflake 不允许在 UDF 中嵌入 C 代码。
+3. 由于 Snowflake 当前限制(`Data type GEOMETRY is not supported in non-SQL UDTF return type`),所有用户自定义表函数(UDTF)只能配合 Sedona 构造器创建的几何对象使用,包括:
+   	* SEDONA.ST_MinimumBoundingRadius
+   	* SEDONA.ST_Intersection_Aggr
+   	* SEDONA.ST_SubDivideExplode
+   	* SEDONA.ST_Envelope_Aggr
+   	* SEDONA.ST_Union_Aggr
+   	* SEDONA.ST_Collect
+   	* SEDONA.ST_Dump
+4. Snowflake 中只提供 Sedona 的 ST 函数,栅格函数(RS 函数)暂未支持。


(sedona) 04/12: [GH-2910] Translate Setup / Install section to Chinese (#2924)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 58fde4148ec77f68852c6ff4112c01e89331d5ce
Author: Jia Yu <ji...@apache.org>
AuthorDate: Thu May 7 23:17:05 2026 -0700

    [GH-2910] Translate Setup / Install section to Chinese (#2924)
    
    (cherry picked from commit 7f2efd9137298f639813a1a8f99854bda105b2e5)
---
 docs/setup/azure-synapse-analytics.zh.md | 248 ++++++++++++++++++++
 docs/setup/cluster.zh.md                 |  51 +++++
 docs/setup/compile.zh.md                 | 193 ++++++++++++++++
 docs/setup/databricks.zh.md              | 194 ++++++++++++++++
 docs/setup/docker.zh.md                  | 179 +++++++++++++++
 docs/setup/emr.zh.md                     |  80 +++++++
 docs/setup/fabric.zh.md                  | 134 +++++++++++
 docs/setup/flink/install-python.zh.md    |  34 +++
 docs/setup/flink/install-scala.zh.md     |  33 +++
 docs/setup/flink/modules.zh.md           |  33 +++
 docs/setup/flink/platform.zh.md          |  27 +++
 docs/setup/glue.zh.md                    | 107 +++++++++
 docs/setup/install-python.zh.md          | 122 ++++++++++
 docs/setup/install-scala.zh.md           |  94 ++++++++
 docs/setup/maven-coordinates.zh.md       | 382 +++++++++++++++++++++++++++++++
 docs/setup/modules.zh.md                 |  35 +++
 docs/setup/overview.zh.md                |  55 +++++
 docs/setup/platform.zh.md                |  49 ++++
 docs/setup/snowflake/install.zh.md       | 116 ++++++++++
 docs/setup/snowflake/modules.zh.md       |  32 +++
 docs/setup/wherobots.zh.md               |  26 +++
 docs/setup/zeppelin.zh.md                |  75 ++++++
 22 files changed, 2299 insertions(+)

diff --git a/docs/setup/azure-synapse-analytics.zh.md b/docs/setup/azure-synapse-analytics.zh.md
new file mode 100644
index 0000000000..2f2c67782b
--- /dev/null
+++ b/docs/setup/azure-synapse-analytics.zh.md
@@ -0,0 +1,248 @@
+<!--
+ 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.
+ -->
+
+本教程指引您在启用了数据外泄保护(Data Exfiltration Protection,DEP)或由于其他网络限制导致 Spark 池无法访问公网的情况下,在 Azure Synapse Analytics 中安装 Sedona。
+
+## 开始之前
+
+本教程主要演示如何在 Spark 3.4、Python 3.10 上跑通 Sedona 1.6.1。
+
+如果您希望运行更新的版本,请参考本文后半部分介绍的详细构建与诊断流程。
+
+## 强烈建议
+
+1. 从一个未安装其他包的干净 Spark 池开始,以避免依赖冲突。
+2. Apache Spark 池 -> Apache Spark 配置:使用默认配置。
+
+## Sedona 1.6.1 在 Spark 3.4、Python 3.10 上的安装
+
+### 步骤 1:下载 9 个包
+
+注意:版本必须严格匹配,最新并不总是最优。
+
+来自 Maven:
+
+- [sedona-spark-shaded-3.4_2.12-1.6.1.jar](https://mvnrepository.com/artifact/org.apache.sedona/sedona-spark-shaded-3.4_2.12/1.6.1)
+
+- [geotools-wrapper-1.6.1-28.2.jar](https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper/1.6.1-28.2)
+
+来自 PyPI:
+
+- [rasterio-1.4.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl](https://files.pythonhosted.org/packages/cd/ad/2d3a14e5a97ca827a38d4963b86071267a6cd09d45065cd753d7325699b6/rasterio-1.4.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl)
+
+- [shapely-2.0.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl](https://files.pythonhosted.org/packages/2b/a6/302e0d9c210ccf4d1ffadf7ab941797d3255dcd5f93daa73aaf116a4db39/shapely-2.0.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl)
+
+- [apache_sedona-1.6.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl](https://files.pythonhosted.org/packages/b6/71/09f7ca2b6697b2699c04d1649bb379182076d263a9849de81295d253220d/apache_sedona-1.6.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl)
+
+- [click_plugins-1.1.1-py2.py3-none-any.whl](https://files.pythonhosted.org/packages/e9/da/824b92d9942f4e472702488857914bdd50f73021efea15b4cad9aca8ecef/click_plugins-1.1.1-py2.py3-none-any.whl)
+
+- [cligj-0.7.2-py3-none-any.whl](https://files.pythonhosted.org/packages/73/86/43fa9f15c5b9fb6e82620428827cd3c284aa933431405d1bcf5231ae3d3e/cligj-0.7.2-py3-none-any.whl)
+
+- [affine-2.4.0-py3-none-any.whl](https://files.pythonhosted.org/packages/0b/f7/85273299ab57117850cc0a936c64151171fac4da49bc6fba0dad984a7c5f/affine-2.4.0-py3-none-any.whl)
+
+- [numpy-2.1.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl](https://files.pythonhosted.org/packages/fb/25/ba023652a39a2c127200e85aed975fc6119b421e2c348e5d0171e2046edb/numpy-2.1.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl)
+
+### 步骤 2:将包上传到 Synapse 工作区
+
+https://learn.microsoft.com/en-us/azure/synapse-analytics/spark/apache-spark-manage-workspace-packages
+
+### 步骤 3:将包添加到 Spark 池
+
+本教程采用该页面中的第二种方式:**If you are updating from the Synapse Studio**
+
+https://learn.microsoft.com/en-us/azure/synapse-analytics/spark/apache-spark-manage-pool-packages#manage-packages-from-synapse-studio-or-azure-portal
+
+### 步骤 4:notebook
+
+在 notebook 起始处加入以下代码:
+
+```python
+from sedona.spark import SedonaContext
+
+config = (
+    SedonaContext.builder()
+    .config(
+        "spark.jars.packages",
+        "org.apache.sedona:sedona-spark-shaded-3.4_2.12-1.6.1,"
+        "org.datasyslab:geotools-wrapper-1.6.1-28.2",
+    )
+    .config("spark.serializer", "org.apache.spark.serializer.KryoSerializer")
+    .config(
+        "spark.kryo.registrator", "org.apache.sedona.core.serde.SedonaKryoRegistrator"
+    )
+    .config(
+        "spark.sql.extensions",
+        "org.apache.sedona.viz.sql.SedonaVizExtensions,org.apache.sedona.sql.SedonaSqlExtensions",
+    )
+    .getOrCreate()
+)
+
+sedona = SedonaContext.create(config)
+```
+
+跑一个测试:
+
+```python
+sedona.sql("SELECT ST_GeomFromEWKT('SRID=4269;POINT(40.7128 -74.0060)')").show()
+```
+
+如果看到点的输出,则说明安装成功,配置工作至此完成。
+
+## Sedona 1.6.0 在 Spark 3.4、Python 3.10 上需要的包
+
+```
+spark-xml_2.12-0.17.0.jar
+sedona-spark-shaded-3.4_2.12-1.6.0.jar
+
+click_plugins-1.1.1-py2.py3-none-any.whl
+affine-2.4.0-py3-none-any.whl
+apache_sedona-1.6.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
+cligj-0.7.2-py3-none-any.whl
+rasterio-1.3.10-cp310-cp310-manylinux2014_x86_64.whl
+shapely-2.0.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
+snuggs-1.4.7-py3-none-any.whl
+geotools-wrapper-1.6.0-28.2.jar
+```
+
+## 背景:如何为其他/未来版本的 Spark 与/或 Sedona 确定所需包
+
+警告:该流程需要相当的技术耐心与排错能力。
+
+整体步骤:用与已部署 Spark 池相同的镜像构建一台 Linux 虚拟机,按 Synapse 进行配置,安装 Sedona 包,再识别出在 Synapse 基线之上额外需要的包。
+
+下面是 Sedona 1.6.1 在 Spark 3.4、Python 3.10 上的实操过程(同一流程也用于 Sedona 1.6.0)。
+
+### 步骤 1:根据版本识别 Spark 池所用的 Linux 镜像
+
+https://learn.microsoft.com/en-us/azure/synapse-analytics/spark/apache-spark-34-runtime
+
+### 步骤 2:下载 ISO
+
+https://github.com/microsoft/azurelinux/tree/2.0
+
+### 步骤 3:构建虚拟机
+
+https://github.com/microsoft/azurelinux/blob/2.0/toolkit/docs/quick_start/quickstart.md#iso-image
+
+如使用 Hyper-V,需注意以下设置:
+
+- 启用 Secure Boot:Microsoft UEFI Certificate authority
+- CPU 核心数:2
+- 关闭动态内存(固定为 8GB)。忘记此设置会带来很多麻烦。
+
+### 步骤 4:更新虚拟机
+
+连接到虚拟机,注意首次启动会比预期更慢。
+
+```sh
+sudo dnf upgrade
+```
+
+### 步骤 5:可选但强烈推荐 —— 安装 ssh-server(以便复制粘贴)
+
+```sh
+sudo tdnf install -y openssh-server
+```
+
+启用 root 与密码认证:
+
+```sh
+sudo vi /etc/ssh/sshd_config
+-	PasswordAuthentication yes
+-	PermitRootLogin yes
+```
+
+启动 ssh-server:
+
+```bash
+sudo systemctl enable --now sshd.service
+```
+
+识别虚拟机 IP(这里在 Windows 10 桌面上使用 Hyper-V):
+
+```ps
+Get-VMNetworkAdapter -VMName "Synapse Spark 3.4 Python 3.10 Sedona 1.6.1" | Select-Object -ExpandProperty IPAddresses
+```
+
+### 步骤 6:安装 Miniconda
+
+```bash
+cd /tmp
+wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
+chmod +x Miniconda3-latest-Linux-x86_64.sh
+./Miniconda3-latest-Linux-x86_64.sh
+```
+
+### 步骤 7:安装编译器
+
+```sh
+sudo tdnf -y install gcc g++
+```
+
+### 步骤 8:创建 Synapse 基线虚拟环境
+
+下载虚拟环境定义文件:
+
+```bash
+wget -O Synapse-Python310-CPU.yml https://raw.githubusercontent.com/microsoft/synapse-spark-runtime/refs/heads/main/Synapse/spark3.4/Synapse-Python310-CPU.yml source
+```
+
+```bash
+conda env create -f Synapse-Python310-CPU.yml -n synapse
+```
+
+如果在 `fsspec_wrapper` 处报错,请从 yml 中移除 `fsspec_wrapper==0.1.13=py_3` 后重试。
+
+如果在上述修改之后仍出现来自 `pip` 的其他错误,可以忽略,仍可继续。
+
+### 步骤 9:安装 Sedona Python 包
+
+```bash
+conda activate synapse
+echo "apache-sedona==1.6.1" > requirements.txt
+pip install -r requirements.txt > pip-output.txt
+```
+
+### 步骤 10:识别需要下载的 Python 包
+
+```bash
+grep Downloading pip-output.txt
+```
+
+**该输出即为您需要从 PyPI 定位并下载的包列表。**
+
+输出示例:
+
+```
+Downloading apache_sedona-1.6.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (177 kB)
+Downloading shapely-2.0.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.5 MB)
+Downloading rasterio-1.4.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (22.2 MB)
+Downloading affine-2.4.0-py3-none-any.whl (15 kB)
+Downloading cligj-0.7.2-py3-none-any.whl (7.1 kB)
+Downloading click_plugins-1.1.1-py2.py3-none-any.whl (7.5 kB)
+```
+
+### 步骤 11:在已部署的 Azure Synapse Spark 池(真实环境,不是虚拟机)中识别包冲突
+
+- 将包上传到工作区
+- 将包加入您的(干净的!)Spark 池
+
+请仔细查看 Synapse 返回的错误信息,并逐一排查冲突。
+
+注意:在 Spark 3.4 上安装 Sedona 1.6.0 时未遇到问题,但 Sedona 1.6.1 及其支持包出现了与 `numpy` 相关的冲突,需要下载特定版本并加入包列表。`numpy` 并未出现在前面 grep 的输出中。
diff --git a/docs/setup/cluster.zh.md b/docs/setup/cluster.zh.md
new file mode 100644
index 0000000000..1529ee1bb8
--- /dev/null
+++ b/docs/setup/cluster.zh.md
@@ -0,0 +1,51 @@
+<!--
+ 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.
+ -->
+
+# 搭建您的 Apache Spark 集群
+
+请从 [Spark 下载页面](http://spark.apache.org/downloads.html) 下载 Spark 发行版。
+
+## 前置准备
+
+1. 在集群上配置免密 SSH。每对 master-worker 之间需要双向免密 SSH。
+2. 确保已安装 JRE 1.8 或更高版本。
+3. 将所有 worker 的 IP 地址列入 `./conf/slaves`。
+4. 除必要的 Spark 配置外,您可能还需要在 Spark 配置文件中加入以下设置以避免 Sedona 内存相关错误:
+
+在 `./conf/spark-defaults.conf` 中:
+
+```
+spark.driver.memory 10g
+spark.network.timeout 1000s
+spark.driver.maxResultSize 5g
+```
+
+* `spark.driver.memory` 用于为 driver 程序分配足够的内存。Sedona 需要在 driver 上构建全局网格文件(全局索引)。如果数据量较大(通常超过 100 GB),将该参数设为 2~5 GB 较为合适,否则可能出现 “out of memory” 错误。
+* `spark.network.timeout` 是所有网络交互的默认超时时间。空间连接查询有时需要更长的 shuffle 时间,调大此参数可让 Spark 有足够的耐心等待结果。
+* `spark.driver.maxResultSize` 是每个 Spark action 中所有分区的序列化结果总大小限制。空间查询的结果有时较大,`Collect` 操作可能会抛出错误。
+
+更多 Spark 参数细节请参阅 [Spark 官方文档](https://spark.apache.org/docs/latest/configuration.html)。
+
+## 启动集群
+
+进入解压后的 Apache Spark 目录的根目录,通过终端启动 Spark 集群:
+
+```
+./sbin/start-all.sh
+```
diff --git a/docs/setup/compile.zh.md b/docs/setup/compile.zh.md
new file mode 100644
index 0000000000..0c83337eff
--- /dev/null
+++ b/docs/setup/compile.zh.md
@@ -0,0 +1,193 @@
+<!--
+ 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.
+ -->
+
+# 编译 Sedona 源码
+
+## 编译 Scala / Java 源码
+
+Sedona Scala/Java 代码是一个多模块项目,每个模块都是 Scala/Java 混合工程,由 Apache Maven 3 管理。
+
+* 请确保您的 Linux/Mac 机器上已安装 Java 11/17、Apache Maven 3.3.1+ 与 Python 3.8+。Sedona 的编译尚未在 Windows 机器上测试。
+
+要编译所有模块,请确保位于所有模块的根目录,然后在终端运行以下命令:
+
+=== "不运行单元测试"
+	```bash
+	mvn clean install -DskipTests
+	```
+	该命令会先删除旧的二进制文件,并编译所有模块;编译过程会跳过单元测试。如果只编译单个模块,请进入对应模块的目录后运行同一命令。
+
+=== "运行单元测试"
+	```bash
+	mvn clean install
+	```
+	所有模块的 Maven 单元测试可能耗时长达 30 分钟。
+
+=== "打包 Geotools jar"
+	```bash
+	mvn clean install -DskipTests -Dgeotools
+	```
+	Geotools 相关 jar 会被打入生成的 fat jar 中。
+
+!!!note
+	默认情况下,该命令会针对 Spark 3.4 和 Scala 2.12 编译 Sedona。
+
+### 针对不同目标编译
+
+可使用 `-Dspark` 与 `-Dscala` 命令行参数指定不同的目标:
+
+* `-Dspark`:`{major}.{minor}`,例如 `-Dspark=3.4` 表示针对 Spark 3.4 编译。
+* `-Dscala`:`2.12` 或 `2.13`
+
+=== "Spark 3.4+ Scala 2.12"
+	```
+	mvn clean install -DskipTests -Dspark=3.4 -Dscala=2.12
+	```
+    若要针对更高 Spark 版本编译,请将 `3.4` 替换为对应的 Spark major.minor 版本。
+=== "Spark 3.4+ Scala 2.13"
+	```
+	mvn clean install -DskipTests -Dspark=3.4 -Dscala=2.13
+	```
+    若要针对更高 Spark 版本编译,请将 `3.4` 替换为对应的 Spark major.minor 版本。
+
+!!!tip
+	如需获取打包好所有 GeoTools jar 的 Sedona Spark Shaded jar,只需追加 `-Dgeotools` 选项,例如:`mvn clean install -DskipTests -Dscala=2.12 -Dspark=3.4 -Dgeotools`
+
+### 下载 staged jar
+
+Sedona 通过 GitHub Actions 在每次提交时自动生成 jar。您可以在 [此处](https://github.com/apache/sedona/actions/workflows/java.yml) 点击对应提交的 ==Artifacts== 标签下载这些 jar。
+
+## 运行 Python 测试
+
+1) 准备 Spark(如未安装则下载)并设置环境变量
+
+```bash
+export SPARK_VERSION=3.4.0   # 或其他受支持的版本
+wget https://archive.apache.org/dist/spark/spark-${SPARK_VERSION}/spark-${SPARK_VERSION}-bin-hadoop3.tgz
+tar -xvzf spark-${SPARK_VERSION}-bin-hadoop3.tgz
+rm spark-${SPARK_VERSION}-bin-hadoop3.tgz
+export SPARK_HOME=$PWD/spark-${SPARK_VERSION}-bin-hadoop3
+export PYTHONPATH=$SPARK_HOME/python
+```
+
+2) 将所需的 JAI jar 放入 $SPARK_HOME/jars
+
+```bash
+export JAI_CORE_VERSION="1.1.3"
+export JAI_CODEC_VERSION="1.1.3"
+export JAI_IMAGEIO_VERSION="1.1"
+wget -P $SPARK_HOME/jars/ https://repo.osgeo.org/repository/release/javax/media/jai_core/${JAI_CORE_VERSION}/jai_core-${JAI_CORE_VERSION}.jar
+wget -P $SPARK_HOME/jars/ https://repo.osgeo.org/repository/release/javax/media/jai_codec/${JAI_CODEC_VERSION}/jai_codec-${JAI_CODEC_VERSION}.jar
+wget -P $SPARK_HOME/jars/ https://repo.osgeo.org/repository/release/javax/media/jai_imageio/${JAI_IMAGEIO_VERSION}/jai_imageio-${JAI_IMAGEIO_VERSION}.jar
+```
+
+3) 构建包含 GeoTools shaded 的 Sedona Scala/Java jar(从仓库根目录执行)
+
+```bash
+mvn clean install -DskipTests -Dgeotools
+cp spark-shaded/target/sedona-spark-shaded-*.jar $SPARK_HOME/jars/
+```
+
+4) 准备 Python 开发环境
+
+Python 包使用 `pyproject.toml`(PEP 517/518)并以 setuptools 作为构建后端。推荐使用 [uv](https://docs.astral.sh/uv/) 管理虚拟环境与依赖。
+
+```bash
+cd python
+python -m pip install --upgrade uv
+uv venv --python 3.10   # 或其他受支持的版本(>=3.8)
+```
+
+5) 安装匹配的 PySpark 版本与其他依赖
+
+```bash
+cd python
+# 使用正确的 PySpark 版本,否则将默认安装最新版
+uv add pyspark==${SPARK_VERSION} --optional spark
+uv sync
+```
+
+6) 以可编辑模式安装 Sedona 并运行 Python 测试
+
+```bash
+cd python
+uv pip install -e .
+uv run pytest -v tests
+```
+
+## 编译文档
+
+文档网站会在每次提交后自动构建,构建产物可在以下位置下载:
+
+### MkDocs 网站
+
+文档网站源码以 Markdown 编写,由 MkDocs 编译,主题基于 [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/)。
+
+在 Sedona 仓库中,MkDocs 配置文件 ==mkdocs.yml== 位于根目录,所有文档源码位于 `docs` 目录。
+
+如需在本地编译源码并测试网站,请阅读 [MkDocs 教程](http://www.mkdocs.org/#installation) 与 [Materials for MkDocs 教程](https://squidfunk.github.io/mkdocs-material/getting-started/)。
+
+简而言之,需要运行:
+
+```
+python3 -m pip install uv
+uv sync --group docs
+```
+
+安装好 MkDocs 与 MkDocs-Material 后,在 Sedona 根目录运行:
+
+```
+uv run mkdocs build
+uv run mike deploy --update-aliases latest-snapshot -b website -p
+uv run mike serve
+```
+
+## pre-commit
+
+我们通过 GitHub Actions 运行 [pre-commit](https://pre-commit.com/),因此本地安装目前是可选的。
+
+pre-commit 的[配置文件](https://github.com/apache/sedona/blob/master/.pre-commit-config.yaml)位于仓库根目录。在运行钩子之前,需要先安装 pre-commit。
+
+钩子会在执行 `git commit` 时运行,也可以通过命令行 `pre-commit` 触发。部分钩子会在失败时自动修复代码,但大多数会输出 linter 错误信息。如果某个钩子失败,整个 commit 会失败,您需要修复问题后重新 `git add` 并提交。`git commit` 时钩子大多只针对修改过的文件运行;如果想对所有文件运行所有钩子,或者您正在新增钩子,应运行:
+
+`pre-commit run --all-files`
+
+有时您可能需要跳过某个钩子,例如该钩子阻碍了提交,或您本地缺少该钩子所需的依赖。`SKIP` 变量以英文逗号分隔多个钩子:
+
+`SKIP=codespell git commit -m "foo"`
+
+在直接运行 pre-commit 时同样适用:
+
+`SKIP=codespell pre-commit run --all-files`
+
+偶尔您在执行 `git commit` 时遇到更严重的问题,可以使用 `--no-verify` 跳过 pre-commit 检查直接提交,例如:
+
+`git commit --no-verify -m "foo"`
+
+如果只想运行某个钩子(例如 `markdownlint`),可使用:
+
+`pre-commit run markdownlint --all-files`
+
+仓库根目录下的 [Makefile](https://github.com/apache/sedona/blob/master/Makefile) 提供了三个与 pre-commit 相关的便捷命令。
+
+例如,可以运行以下命令将 pre-commit 安装为每次提交前自动运行的钩子:
+
+```
+make checkinstall
+```
diff --git a/docs/setup/databricks.zh.md b/docs/setup/databricks.zh.md
new file mode 100644
index 0000000000..afda58ff95
--- /dev/null
+++ b/docs/setup/databricks.zh.md
@@ -0,0 +1,194 @@
+<!--
+ 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.
+ -->
+
+您可以在 Databricks 中运行 Sedona,以充分利用 Sedona 提供的功能。下面是一个运行 Sedona 代码的 Databricks notebook 示例:
+
+![示例 notebook](../image/databricks/image1.png)
+
+由于平台限制,Sedona 并非在所有 Databricks 环境中都可用。本文将说明如何以及在哪些 Databricks 环境中运行 Sedona。
+
+## Databricks 与 Sedona 的版本要求
+
+Databricks 与 Sedona 都依赖 Spark、Scala 等多个库。
+
+例如,某个 Databricks Runtime 16.4 依赖 Scala 2.12 与 Spark 3.5。下表给出几个 Databricks 运行时的版本要求:
+
+![Databricks 运行时](../image/databricks/image2.png)
+
+如果使用基于 Spark 3.5 与 Scala 2.12 编译的 Databricks Runtime,那么也应使用基于 Spark 3.5 与 Scala 2.12 编译的 Sedona 版本。即使您只使用 Python 或 SQL API,Scala 版本也必须保持一致。
+
+## 在 Databricks 中安装 Sedona 库
+
+执行以下命令下载所需的 Sedona 包:
+
+```sh
+%sh
+# 为 Sedona 创建 JAR 目录
+mkdir -p /Workspace/Shared/sedona/{{ sedona.current_version }}
+
+# 从 Maven 下载依赖到 DBFS
+curl -o /Workspace/Shared/sedona/{{ sedona.current_version }}/geotools-wrapper-{{ sedona.current_geotools }}.jar "https://repo1.maven.org/maven2/org/datasyslab/geotools-wrapper/{{ sedona.current_geotools }}/geotools-wrapper-{{ sedona.current_geotools }}.jar"
+
+curl -o /Workspace/Shared/sedona/{{ sedona.current_version }}/sedona-spark-shaded-3.5_2.12-{{ sedona.current_version }}.jar "https://repo1.maven.org/maven2/org/apache/sedona/sedona-spark-shaded-3.5_2.12/{{ sedona.current_version }}/sedona-spark-shaded-3.5_2.12-{{ sedona.current_version }}.jar"
+```
+
+`sedona-spark-shaded-3.5_2.12-{{ sedona.current_version }}.jar` 的编译环境如下:
+
+* Spark 3.5
+* Scala 2.12
+* Sedona {{ sedona.current_version }}
+
+请确保使用与该 jar 兼容的 Databricks Runtime。
+
+下载完成后,您应在 Databricks 环境中看到这些文件:
+
+![已下载的 JAR](../image/databricks/image3.png)
+
+按以下方式创建一个初始化脚本:
+
+```
+%sh
+
+# 为 Sedona 创建初始化脚本目录
+mkdir -p /Workspace/Shared/sedona/
+
+# 创建初始化脚本
+cat > /Workspace/Shared/sedona/sedona-init.sh <<'EOF'
+#!/bin/bash
+#
+# File: sedona-init.sh
+#
+# 集群启动时,将 Sedona 的 jar 复制到集群默认的 jar 目录。
+
+# 可选:移除 Databricks 自带的 H3 JAR,以避免与 Sedona 的 H3 函数发生版本冲突。
+# Databricks 自带的是 H3 v3.x,与 Sedona 使用的 H3 v4.x API 不兼容。
+# 如果您需要使用 Sedona 的 H3 函数(如 ST_H3CellIDs),请取消下一行的注释。
+# rm -f /databricks/jars/*h3*.jar
+
+cp /Workspace/Shared/sedona/{{ sedona.current_version }}/*.jar /databricks/jars
+
+EOF
+```
+
+## 创建 Databricks 集群
+
+需要创建与 Sedona JAR 文件兼容的 Databricks 集群。如果使用基于 Scala 2.12 编译的 Sedona JAR,集群也必须运行 Scala 2.12。
+
+进入 compute 选项卡并配置集群:
+
+![集群配置](../image/databricks/image4.png)
+
+设置正确的集群配置:
+
+![Spark 配置](../image/databricks/image5.png)
+
+下面是方便复制粘贴的集群配置项列表:
+
+```
+spark.sql.extensions org.apache.sedona.viz.sql.SedonaVizExtensions,org.apache.sedona.sql.SedonaSqlExtensions
+spark.serializer org.apache.spark.serializer.KryoSerializer
+spark.kryo.registrator org.apache.sedona.core.serde.SedonaKryoRegistrator
+spark.sedona.enableParserExtension false
+```
+
+指定初始化脚本的路径:
+
+![初始化脚本](../image/databricks/image6.png)
+
+如果您创建的是 Shared 集群,则无法使用存放在 Workspace 中的 init 脚本与 jar,请改为存放到 volume 中。整体流程保持一致。
+
+在 Library 选项卡中加入所需依赖:
+
+![Python 库](../image/databricks/image7.png)
+
+完整库列表如下:
+
+```
+apache-sedona=={{ sedona.current_version }}
+geopandas==1.0.1
+keplergl==0.3.7
+pydeck==0.9.1
+```
+
+然后点击 “Create compute” 启动集群。
+
+## 创建 Databricks notebook
+
+新建一个 Databricks notebook 并连接到刚才创建的集群。验证可以运行包含 Sedona 函数的 Python 计算:
+
+![Python 计算](../image/databricks/image1.png)
+
+如果您希望使用 Sedona 的 Python 函数,例如 [DataFrame API](../api/sql/DataFrameAPI.md) 或 [StructuredAdapter](../tutorial/sql.md#spatialrdd-to-dataframe-with-spatial-partitioning),则需要按以下方式初始化 Sedona:
+
+```python
+from sedona.spark import *
+
+sedona = SedonaContext.create(spark)
+```
+
+也可以使用 SQL API:
+
+![SQL 计算](../image/databricks/image8.png)
+
+## 在 Databricks Delta Lake 表中保存几何对象
+
+下面演示如何创建带几何列的 Sedona DataFrame:
+
+```python
+df = sedona.createDataFrame(
+    [
+        ("a", "POLYGON((1.0 1.0,1.0 3.0,2.0 3.0,2.0 1.0,1.0 1.0))"),
+        ("b", "LINESTRING(4.0 1.0,4.0 2.0,6.0 4.0)"),
+        ("c", "POINT(9.0 2.0)"),
+    ],
+    ["id", "geometry"],
+)
+df = df.withColumn("geometry", expr("ST_GeomFromWKT(geometry)"))
+```
+
+将 Sedona DataFrame 写入 Delta Lake 表:
+
+```python
+df.write.saveAsTable("your_org.default.geotable")
+```
+
+读取该表的方式:`sedona.table("your_org.default.geotable").display()`
+
+在 Databricks 中的结果大致如下:
+
+![写表](../image/databricks/image9.png)
+
+## 已知问题
+
+为保证稳定性,建议使用当前在维护的长期支持(LTS)版本,例如 Databricks Runtime 16.4 LTS 或 15.4 LTS。部分 Databricks Runtime(如非 LTS 的 16.2)与 Apache Sedona 不兼容,原因是该运行时变更了 json4s 的依赖版本。
+
+### Databricks 上的 H3 函数报错
+
+Databricks Runtime 自带较旧的 H3 库(v3.x),与 Sedona 的 H3 函数(需要 H3 v4.x)不兼容。在调用 `ST_H3CellIDs`、`ST_H3CellDistance`、`ST_H3KRing`、`ST_H3ToGeom` 或其他 Sedona H3 函数时,如果出现类似报错:
+
+```
+java.lang.NoSuchMethodError: com.uber.h3core.H3Core.polygonToCells(...)
+```
+
+说明 Databricks 自带的 H3 库覆盖了 Sedona 携带的版本。
+
+上文提供的初始化脚本中包含一个可选修复:取消 `rm -f /databricks/jars/*h3*.jar` 这一行的注释,先移除 Databricks 自带的 H3 JAR,再复制 Sedona 的 JAR。这样就可以使用 Sedona 的 H3 v4.x。
+
+!!!note
+    移除 Databricks 自带的 H3 JAR 会导致 Databricks 内置的 H3 SQL 表达式(如 `h3_coverash3`、`h3_boundaryaswkt`)失效。Sedona 提供了等价的 H3 函数可作为替代。
diff --git a/docs/setup/docker.zh.md b/docs/setup/docker.zh.md
new file mode 100644
index 0000000000..cd5ce8847a
--- /dev/null
+++ b/docs/setup/docker.zh.md
@@ -0,0 +1,179 @@
+<!--
+ 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.
+ -->
+
+# Sedona JupyterLab Docker 镜像
+
+Sedona 的 Docker 镜像可在 [Sedona 官方 DockerHub 仓库](https://hub.docker.com/r/apache/sedona) 获取。
+
+我们提供了一个集成 Python JupyterLab、Apache Zeppelin,以及 1 个 master 节点和 1 个 worker 节点的 Apache Sedona Docker 镜像。
+
+## 使用方法
+
+### 从 DockerHub 拉取镜像
+
+格式:
+
+```bash
+docker pull apache/sedona:<sedona_version>
+```
+
+示例 1:拉取 Sedona master 分支的最新镜像
+
+```bash
+docker pull apache/sedona:latest
+```
+
+示例 2:拉取某个特定 Sedona 发布版本的镜像
+
+```bash
+docker pull apache/sedona:{{ sedona.current_version }}
+```
+
+### 启动容器
+
+格式:
+
+```bash
+docker run -d -e DRIVER_MEM=<driver_mem> -e EXECUTOR_MEM=<executor_mem> -p 8888:8888 -p 8080:8080 -p 8081:8081 -p 4040:4040 -p 8085:8085 apache/sedona:<sedona_version>
+```
+
+`driver_mem` 与 `executor_mem` 是可选项;如果未提供,容器将分别为 driver 和 executor 各分配 4GB 内存。`-d`(或 `--detach`)参数让容器以分离模式后台运行。
+
+示例 1:
+
+```bash
+docker run -d -e DRIVER_MEM=6g -e EXECUTOR_MEM=8g -p 8888:8888 -p 8080:8080 -p 8081:8081 -p 4040:4040 -p 8085:8085 apache/sedona:latest
+```
+
+该命令会启动一个使用 6GB driver 内存与 8GB executor 内存的容器,并使用最新的 Sedona 镜像;容器以分离模式运行。
+
+该命令会将容器的 8888、8080、8081、4040、8085 端口分别映射到宿主机的同名端口。
+
+示例 2:
+
+```bash
+docker run -d -e -p 8888:8888 -p 8080:8080 -p 8081:8081 -p 4040:4040 -p 8085:8085 apache/sedona:{{ sedona.current_version }}
+```
+
+该命令会启动一个 driver 与 executor 各使用 4GB 内存的容器,并使用 Sedona {{ sedona.current_version }} 镜像。
+
+容器的端口映射与示例 1 相同。
+
+示例 3:使用 Docker volume 持久化 `/opt`(Jupyter & Zeppelin 数据)
+
+为确保 **Jupyter 工作区、Zeppelin notebook 与配置不会丢失**,可以将 `/opt` 挂载为 **Docker volume**:
+
+```bash
+docker run -d -e DRIVER_MEM=6g -e EXECUTOR_MEM=8g \
+    -p 8888:8888 -p 8080:8080 -p 8081:8081 -p 4040:4040 -p 8085:8085 \
+    -v sedona_opt:/opt \
+    apache/sedona:latest
+```
+
+- `-v sedona_opt:/opt` 会**创建(若不存在)并挂载名为 `sedona_opt` 的 Docker volume** 到容器内的 `/opt` 目录。
+- 即使容器被停止或删除,**Jupyter 与 Zeppelin 的 notebook、配置和工作区也会持久保留**。
+
+### 开始编码
+
+打开浏览器访问 [http://localhost:8888/](http://localhost:8888/),即可在 Jupyter Notebook 中使用 Sedona 编码。也可以在浏览器中访问 [http://localhost:8085/classic/](http://localhost:8085/classic/) 来使用 Apache Zeppelin。
+
+### 注意事项
+
+- 该容器假设您的机器至少有 8GB 内存,并会占用所有 CPU 核心与 8GB 内存。1 个 worker 占用 4GB,Jupyter 程序占用剩余的 4GB。
+- 容器中的 Sedona 以集群模式运行,同一时间只能运行 1 个 notebook。如需运行其他 notebook,请先关闭当前 notebook 的内核([操作方法](https://jupyterlab.readthedocs.io/en/stable/user/running.html))。
+
+## 构建方法
+
+克隆 Sedona GitHub 仓库。
+
+### 针对某个 Sedona 发布版构建镜像
+
+要求:docker([安装方法](https://docs.docker.com/engine/install/))
+
+格式:
+
+```bash
+./docker/build.sh <spark_version> <sedona_version> <build_mode>
+```
+
+示例:
+
+```bash
+./docker/build.sh 3.4.1 {{ sedona.current_version }}
+```
+
+`build_mode` 为可选项。如果未提供或值为 `local`,脚本会在本地构建镜像;否则会启动跨平台编译并直接将镜像推送到 DockerHub。
+
+### 针对最新的 Sedona master 构建镜像
+
+要求:docker([安装方法](https://docs.docker.com/engine/install/))、JDK <= 19、maven3
+
+格式:
+
+```bash
+./docker/build.sh <spark_version> latest <build_mode>
+```
+
+示例:
+
+```bash
+./docker/build.sh 3.4.1 latest
+```
+
+`build_mode` 为可选项,含义与上文相同。
+
+### 注意事项
+
+该 Docker 镜像仅支持基于 Sedona 1.7.0+ 与 Spark 3.3+ 构建。
+
+## 集群配置
+
+### 软件
+
+- OS:Ubuntu 22.02
+- JDK:openjdk-19
+- Python:3.10
+- Spark 3.5.5
+
+### Web UI
+
+- JupyterLab:http://localhost:8888/
+- Spark master URL:spark://localhost:7077
+- Spark 作业 UI:http://localhost:4040
+- Spark master Web UI:http://localhost:8080/
+- Spark worker Web UI:http://localhost:8081/
+- Apache Zeppelin:http://localhost:8085/
+
+容器中已捆绑一份 Zeppelin 教程 notebook,详情请参阅 [Sedona-Zeppelin 教程](../tutorial/zeppelin.md)。
+
+## 如何推送到 DockerHub
+
+格式:
+
+```bash
+docker login
+./docker/build.sh <spark_version> <sedona_version> release
+```
+
+示例:
+
+```bash
+docker login
+./docker/build.sh 3.4.1 {{ sedona.current_version }} release
+```
diff --git a/docs/setup/emr.zh.md b/docs/setup/emr.zh.md
new file mode 100644
index 0000000000..a0f251ccac
--- /dev/null
+++ b/docs/setup/emr.zh.md
@@ -0,0 +1,80 @@
+<!--
+ 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.
+ -->
+
+在 EMR 上推荐使用 Sedona-1.3.1-incubating 及以上版本。本教程使用 AWS Elastic MapReduce (EMR) 6.9.0,已预装以下应用:Hadoop 3.3.3、JupyterEnterpriseGateway 2.6.0、Livy 0.7.1、Spark 3.3.0。
+
+本教程在带 EMR Studio(notebook)的 EMR on EC2 上完成测试。EMR on EC2 使用 YARN 进行资源管理。
+
+!!!note
+	如果您使用 Spark 3.4+ 与 Scala 2.12,请使用 `sedona-spark-shaded-3.4_2.12`。请注意 Spark 与 Scala 的版本后缀。
+
+## 准备初始化脚本
+
+在您的 S3 存储桶中添加一个内容如下的脚本:
+
+```bash
+#!/bin/bash
+
+# EMR 集群只有临时的本地存储,jar 放在哪个路径其实并不影响。
+sudo mkdir /jars
+
+# 下载 Sedona jar
+sudo curl -o /jars/sedona-spark-shaded-3.3_2.12-{{ sedona.current_version }}.jar "https://repo1.maven.org/maven2/org/apache/sedona/sedona-spark-shaded-3.3_2.12/{{ sedona.current_version }}/sedona-spark-shaded-3.3_2.12-{{ sedona.current_version }}.jar"
+
+# 下载 GeoTools jar
+sudo curl -o /jars/geotools-wrapper-{{ sedona.current_geotools }}.jar "https://repo1.maven.org/maven2/org/datasyslab/geotools-wrapper/{{ sedona.current_geotools }}/geotools-wrapper-{{ sedona.current_geotools }}.jar"
+
+# 安装必要的 Python 库
+sudo python3 -m pip install pandas
+sudo python3 -m pip install shapely
+sudo python3 -m pip install geopandas
+sudo python3 -m pip install keplergl==0.3.2
+sudo python3 -m pip install pydeck==0.8.0
+sudo python3 -m pip install attrs matplotlib descartes apache-sedona=={{ sedona.current_version }}
+```
+
+创建 EMR 集群时,在 `bootstrap action` 中指定该脚本的位置。
+
+## 添加软件配置
+
+创建 EMR 集群时,在软件配置(software configuration)中加入以下内容:
+
+```bash
+[
+  {
+    "Classification":"spark-defaults",
+    "Properties":{
+      "spark.yarn.dist.jars": "/jars/sedona-spark-shaded-3.3_2.12-{{ sedona.current_version }}.jar,/jars/geotools-wrapper-{{ sedona.current_geotools }}.jar",
+      "spark.serializer": "org.apache.spark.serializer.KryoSerializer",
+      "spark.kryo.registrator": "org.apache.sedona.core.serde.SedonaKryoRegistrator",
+      "spark.sql.extensions": "org.apache.sedona.viz.sql.SedonaVizExtensions,org.apache.sedona.sql.SedonaSqlExtensions"
+      }
+  }
+]
+```
+
+## 验证安装
+
+集群创建完成后,可在 Jupyter Notebook 中运行以下代码以验证安装:
+
+```python
+spark.sql("SELECT ST_Point(0, 0)").show()
+```
+
+注意:您不需要再调用 `SedonaRegistrator.registerAll(spark)` 或 `SedonaContext.create(spark)`,因为配置中的 `org.apache.sedona.sql.SedonaSqlExtensions` 已经为您完成了这些工作。
diff --git a/docs/setup/fabric.zh.md b/docs/setup/fabric.zh.md
new file mode 100644
index 0000000000..1a7acb9cfc
--- /dev/null
+++ b/docs/setup/fabric.zh.md
@@ -0,0 +1,134 @@
+<!--
+ 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.
+ -->
+
+本教程将指引您在 Microsoft Fabric Synapse Data Engineering 的 Spark 环境中安装 Sedona。
+
+## 步骤 1:打开 Microsoft Fabric Synapse Data Engineering
+
+进入 [Microsoft Fabric 门户](https://app.fabric.microsoft.com/),选择 `Data Engineering` 选项。
+
+![Microsoft Fabric 门户](../image/fabric/fabric-1.png)
+
+## 步骤 2:创建 Microsoft Fabric Data Engineering 环境
+
+在左侧点击 `My Workspace`,再点击 `+ New` 新建一个 `Environment`,命名为 `ApacheSedona`。
+
+![创建新的 Data Engineering 环境](../image/fabric/fabric-2.png)
+
+## 步骤 3:选择 Apache Spark 版本
+
+在 `Environment` 页面,点击 `Home` 选项卡并选择合适的 Apache Spark 版本。后续需要根据这个版本安装匹配的 Apache Sedona 版本。
+
+![在 Environment 页面 Home 选项卡中添加合适的 Apache Spark 版本](../image/fabric/fabric-3.png)
+
+## 步骤 4:安装 Sedona Python 包
+
+在 `Environment` 页面,点击 `Public libraries` 选项卡,输入 `apache-sedona`,并选择合适的 Apache Sedona 版本,来源(source)选择 `PyPI`。
+
+![在 Environment 页面的 Public libraries 中添加合适的 Apache Sedona 版本](../image/fabric/fabric-4.png)
+
+## 步骤 5:设置 Spark 配置项
+
+在 `Environment` 页面,点击 `Spark properties` 选项卡,新建以下 3 个配置项:
+
+- `spark.sql.extensions`:`org.apache.sedona.viz.sql.SedonaVizExtensions,org.apache.sedona.sql.SedonaSqlExtensions`
+- `spark.serializer`:`org.apache.spark.serializer.KryoSerializer`
+- `spark.kryo.registrator`:`org.apache.sedona.core.serde.SedonaKryoRegistrator`
+
+![在 Environment 页面 Spark properties 选项卡中添加 3 个配置项](../image/fabric/fabric-5.png)
+
+## 步骤 6:保存并发布环境
+
+依次点击 `Save` 与 `Publish` 按钮以保存并发布环境,环境随之创建并安装好 Apache Sedona Python 包。发布过程大约需要 10 分钟。
+
+![保存并发布环境](../image/fabric/fabric-6.png)
+
+## 步骤 7:找到 Sedona jar 的下载链接
+
+1. 阅读 [Sedona maven 坐标](maven-coordinates.md) 了解所需的 Sedona jar。
+2. 在 [Maven Central](https://search.maven.org/search?q=g:org.apache.sedona) 查找 `sedona-spark-shaded` jar。请注意 jar 的 Spark 与 Scala 版本:如果 Fabric 环境选择了 Spark 3.4,则应下载与 Spark 3.4 + Scala 2.12 对应的 jar,文件名形如 `sedona-spark-shaded-3.4_2.12-1.5.1.jar`。
+3. 在 [Maven Central](https://search.maven.org/search?q=g:org.datasyslab) 查找 `geotools-wrapper` jar。请注意 jar 与 Sedona 的版本对应关系:若使用 Sedona 1.5.1,则应下载 `geotools-wrapper` 1.5.1 版本,文件名形如 `geotools-wrapper-1.5.1-28.2.jar`。
+
+下载链接示例:
+
+```
+https://repo1.maven.org/maven2/org/apache/sedona/sedona-spark-shaded-3.4_2.12/1.5.1/sedona-spark-shaded-3.4_2.12-1.5.1.jar
+https://repo1.maven.org/maven2/org/datasyslab/geotools-wrapper/1.5.1-28.2/geotools-wrapper-1.5.1-28.2.jar
+```
+
+## 步骤 8:在带有 Sedona 环境的 notebook 中安装 jar
+
+在 notebook 页面,选择此前创建的 `ApacheSedona` 环境。
+
+![在带有 Sedona 环境的 notebook 中安装 jar](../image/fabric/fabric-9.png)
+
+可在 notebook 中运行以下代码安装 jar,请将 `jars` 替换为上一步的两个下载链接:
+
+```text
+%%configure -f
+{
+    "jars": ["https://repo1.maven.org/maven2/org/datasyslab/geotools-wrapper/1.5.1-28.2/geotools-wrapper-1.5.1-28.2.jar", "https://repo1.maven.org/maven2/org/apache/sedona/sedona-spark-shaded-3.4_2.12/1.5.1/sedona-spark-shaded-3.4_2.12-1.5.1.jar"]
+}
+```
+
+## 步骤 9:验证安装
+
+可在 notebook 中运行以下代码验证安装:
+
+```python
+from sedona.spark import *
+
+sedona = SedonaContext.create(spark)
+
+
+sedona.sql("SELECT ST_GeomFromEWKT('SRID=4269;POINT(40.7128 -74.0060)')").show()
+```
+
+如果看到点的输出,则说明安装成功。
+
+![验证安装](../image/fabric/fabric-10.png)
+
+## 可选:手动将 Sedona jar 上传到 Fabric 环境的 LakeHouse 存储
+
+如果集群无法访问公网,或您希望避免缓慢的实时下载,可以手动将 Sedona jar 上传到 Fabric 环境的 LakeHouse 存储。
+
+在 notebook 页面打开 `Explorer`,点击 `LakeHouses` 选项。如果还没有 LakeHouse,可先创建一个。然后选择 `Files`,将上一步下载的 2 个 jar 上传上去。
+
+上传完成后,您应能在 LakeHouse 存储中看到这 2 个 jar。复制它们的 `ABFS` 路径。本例中路径为:
+
+```angular2html
+abfss://9e9d4196-870a-4901-8fa5-e24841492ab8@onelake.dfs.fabric.microsoft.com/e15f3695-af7e-47de-979e-473c3caa9f5b/Files/sedona-spark-shaded-3.4_2.12-1.5.1.jar
+
+abfss://9e9d4196-870a-4901-8fa5-e24841492ab8@onelake.dfs.fabric.microsoft.com/e15f3695-af7e-47de-979e-473c3caa9f5b/Files/geotools-wrapper-1.5.1-28.2.jar
+```
+
+![Sedona notebook 中的 Lakehouses 数据源选项卡](../image/fabric/fabric-7.png)
+
+![从 Files 上传 jar 并复制其 ABFS 路径](../image/fabric/fabric-8.png)
+
+如使用此选项,notebook 中的配置代码应改为:
+
+```text
+%%configure -f
+{
+    "conf": {
+        "spark.jars": "abfss://XXX/Files/sedona-spark-shaded-3.4_2.12-1.5.1.jar,abfss://XXX/Files/geotools-wrapper-1.5.1-28.2.jar",
+    }
+}
+```
diff --git a/docs/setup/flink/install-python.zh.md b/docs/setup/flink/install-python.zh.md
new file mode 100644
index 0000000000..784b345fc3
--- /dev/null
+++ b/docs/setup/flink/install-python.zh.md
@@ -0,0 +1,34 @@
+<!--
+ 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.
+ -->
+
+安装 Apache Sedona Python,请按以下步骤操作:
+
+1. 安装所需的 Python 包。
+
+```
+pip install apache-sedona[flink] shapely attr
+```
+
+2. 从 Maven Central 下载所需的 JAR 文件:
+
+* sedona-flink-shaded_2.12:jar:{{ sedona.current_version }}
+* geotools-wrapper-{{ sedona.current_geotools }}.jar
+
+要将这些 JAR 文件安装到您的 Flink 集群或 PyFlink 应用中,请参阅 Flink 官方文档:
+https://nightlies.apache.org/flink/flink-docs-master/docs/dev/python/dependency_management/
diff --git a/docs/setup/flink/install-scala.zh.md b/docs/setup/flink/install-scala.zh.md
new file mode 100644
index 0000000000..13e50fbc0b
--- /dev/null
+++ b/docs/setup/flink/install-scala.zh.md
@@ -0,0 +1,33 @@
+<!--
+ 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.
+ -->
+
+在开始 Sedona 之旅之前,请确保您的 Apache Flink 集群已就绪。
+
+随后即可创建一个独立的 Scala / Java 项目。独立项目可以让您创建多个 Scala / Java 文件,并将复杂的逻辑集中实现。
+
+要在独立的 Flink 项目中使用 Sedona,只需在 `pom.xml` 或 `build.sbt` 中将 Sedona 添加为依赖。
+
+1. 关于如何添加 Sedona 依赖,请参阅 [Sedona Maven Central 坐标](../maven-coordinates.md)
+2. 阅读 [Sedona Flink 指南](../../tutorial/flink/sql.md),并使用 Sedona 模板项目快速上手:[Sedona 模板项目](../../tutorial/demo.md)
+3. 使用 Maven 编译您的项目,并确保得到打包了所有依赖的 fat jar。
+4. 将编译生成的 fat jar 提交到 Flink 集群。请确保位于 Flink 发行版的根目录,然后运行以下命令:
+
+```
+./bin/flink run /Path/To/YourJar.jar
+```
diff --git a/docs/setup/flink/modules.zh.md b/docs/setup/flink/modules.zh.md
new file mode 100644
index 0000000000..11bbf9aceb
--- /dev/null
+++ b/docs/setup/flink/modules.zh.md
@@ -0,0 +1,33 @@
+<!--
+ 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.
+ -->
+
+# Apache Flink 上的 Sedona 模块
+
+| 名称          | 介绍                                       |
+|---------------|--------------------------------------------|
+| flink         | 空间 Table 与 DataStream 实现              |
+| flink-shaded  | shaded 版本                                |
+
+## API 可用性
+
+|            | **DataStream** | **Table** |
+|:----------:|:------------:|:-----------------:|
+| Scala/Java |✅|✅|
+|   Python   |否|否|
+|      R     |否|否|
diff --git a/docs/setup/flink/platform.zh.md b/docs/setup/flink/platform.zh.md
new file mode 100644
index 0000000000..db98fb0859
--- /dev/null
+++ b/docs/setup/flink/platform.zh.md
@@ -0,0 +1,27 @@
+<!--
+ 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.
+ -->
+
+Sedona Flink 二进制版本由 Java 11/17 与 Scala 2.12 编译,已针对 Flink 1.12 - 1.19 进行测试。
+
+**Java 要求:**
+
+- Flink 1.12 - 1.18:Java 11
+- Flink 1.19+:Java 17
+
+**注意:** 自 Sedona 1.8.0 起不再支持 Java 8。
diff --git a/docs/setup/glue.zh.md b/docs/setup/glue.zh.md
new file mode 100644
index 0000000000..789cc4a9c3
--- /dev/null
+++ b/docs/setup/glue.zh.md
@@ -0,0 +1,107 @@
+<!--
+ 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.
+ -->
+
+本教程介绍如何配置 Glue notebook 与 Glue ETL 作业。本文假设您已具备 AWS Glue 作业的基础使用经验。
+
+教程中使用 Sedona {{ sedona.current_version }} 与 [Glue 5.0](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html),运行环境为 Spark 3.5.4、Java 17、Scala 2.12 和 Python 3.11。Glue 5.0 推荐使用 Sedona 1.8.0 及以上版本。
+
+!!!warning
+    **重要:** 自 Sedona 1.8.0 起不再支持 Java 8 与 Spark 3.3。Sedona 1.8.0+ 需要 Glue 5.0+(支持 Java 17 与 Spark 3.5+)。如果您必须停留在 Glue 4.0(Spark 3.3、Java 8),请使用 Sedona 1.7.1 或更低版本,并将下方的 `sedona-spark-shaded-3.5_2.12` artifact 替换为 `sedona-spark-shaded-3.3_2.12`。
+
+## 收集 Maven 链接
+
+您需要让 Glue 作业指向 Sedona 与 Geotools 的 jar。推荐直接使用 Maven 上发布的 jar。下面给出的链接是为 Glue 5.0 准备的。
+
+Sedona Jar:[Maven Central](https://repo1.maven.org/maven2/org/apache/sedona/sedona-spark-shaded-3.5_2.12/{{ sedona.current_version }}/sedona-spark-shaded-3.5_2.12-{{ sedona.current_version }}.jar)
+
+Geotools Jar:[Maven Central](https://repo1.maven.org/maven2/org/datasyslab/geotools-wrapper/{{ sedona.current_geotools }}/geotools-wrapper-{{ sedona.current_geotools }}.jar)
+
+!!!note
+    请务必选择 Scala 2.12 与 Spark 3.5 的版本。Scala 2.13 的 jar 与 Glue 5.0 不兼容。
+
+## 配置 Glue 作业
+
+获得 jar 链接后,您可以将它们与 apache-sedona Python 包一起配置到 Glue 作业中。notebook 类型与 script 类型的作业配置方式略有不同。
+
+!!!note
+    请务必保持 jar 与 Python 包的 Sedona 版本一致。
+
+### Notebook 作业
+
+在创建 sparkContext 或 glueContext 之前,添加以下 cell magic。第一行指向 jar,第二行直接通过 pip 安装 Sedona Python 包。
+
+```text
+# Sedona Config
+%extra_jars https://repo1.maven.org/maven2/org/apache/sedona/sedona-spark-shaded-3.5_2.12/{{ sedona.current_version }}/sedona-spark-shaded-3.5_2.12-{{ sedona.current_version }}.jar, https://repo1.maven.org/maven2/org/datasyslab/geotools-wrapper/{{ sedona.current_geotools }}/geotools-wrapper-{{ sedona.current_geotools }}.jar
+%additional_python_modules apache-sedona=={{ sedona.current_version }}
+```
+
+如果您使用 Glue 提供的示例 notebook,则第一个 cell 现在大致应是:
+
+```text
+%idle_timeout 2880
+%glue_version 5.0
+%worker_type G.1X
+%number_of_workers 5
+
+# Sedona Config
+%extra_jars https://repo1.maven.org/maven2/org/apache/sedona/sedona-spark-shaded-3.5_2.12/{{ sedona.current_version }}/sedona-spark-shaded-3.5_2.12-{{ sedona.current_version }}.jar, https://repo1.maven.org/maven2/org/datasyslab/geotools-wrapper/{{ sedona.current_geotools }}/geotools-wrapper-{{ sedona.current_geotools }}.jar
+%additional_python_modules apache-sedona=={{ sedona.current_version }}
+
+
+import sys
+from awsglue.transforms import *
+from awsglue.utils import getResolvedOptions
+from pyspark.context import SparkContext
+from awsglue.context import GlueContext
+from awsglue.job import Job
+
+sc = SparkContext.getOrCreate()
+glueContext = GlueContext(sc)
+spark = glueContext.spark_session
+job = Job(glueContext)
+```
+
+可以通过运行以下 cell 验证安装:
+
+```python
+from sedona.spark import *
+
+sedona = SedonaContext.create(spark)
+sedona.sql("SELECT ST_POINT(1., 2.) as geom").show()
+```
+
+### ETL 作业
+
+Glue 也将这种作业称为 Script 作业。在作业页面上切换到 “Job details” 选项卡,展开页面底部的 “Advanced properties” 部分。在 “Dependent JARs path” 字段中填入两个 jar 的链接,并以英文逗号分隔。
+
+要添加 Sedona Python 包,进入 “Job Parameters” 部分新增一个参数,键为 `--additional-python-modules`,值为 `apache-sedona=={{ sedona.current_version }}`。
+
+为验证安装,可在脚本中加入以下代码:
+
+```python
+from sedona.spark import *
+
+config = SedonaContext.builder().getOrCreate()
+sedona = SedonaContext.create(config)
+
+sedona.sql("SELECT ST_POINT(1., 2.) as geom").show()
+```
+
+将其加入脚本后保存并运行作业。如果作业运行成功,则说明安装成功。
diff --git a/docs/setup/install-python.zh.md b/docs/setup/install-python.zh.md
new file mode 100644
index 0000000000..af03ba19df
--- /dev/null
+++ b/docs/setup/install-python.zh.md
@@ -0,0 +1,122 @@
+<!--
+ 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.
+ -->
+
+Apache Sedona 扩展了 PySpark 函数,依赖以下库:
+
+* pyspark
+* shapely
+* attrs
+
+如果您的系统尚未安装这些包,请先安装。Sedona 现使用 [uv](https://docs.astral.sh/uv/) 管理 Python 依赖,详细依赖定义见 [pyproject.toml](https://github.com/apache/sedona/blob/master/python/pyproject.toml)。
+
+### 安装 sedona
+
+* 从 PyPI 仓库安装。最新版的 Sedona Python 可在 [PyPI](https://pypi.org/project/apache-sedona/) 找到。[Sedona v1.0.1 及更早版本存在已知问题](release-notes.md#known-issue)。
+
+```bash
+pip install apache-sedona
+```
+
+* 自 Sedona v1.1.0 起,pyspark 已成为 Sedona Python 的可选依赖,因为许多 Spark 平台都已预装 Spark。如需在安装 Sedona Python 时一并安装 pyspark,请使用 `spark` 附加项:
+
+```bash
+pip install apache-sedona[spark]
+```
+
+* 从 Sedona Python 源码安装
+
+克隆 Sedona GitHub 源码后运行以下命令:
+
+```bash
+cd python
+python3 -m pip install .
+```
+
+### 准备 sedona-spark jar
+
+Sedona Python 需要额外配套一个名为 `sedona-spark-shaded` 或 `sedona-spark` 的 jar 文件。请确保所选版本与您的 Spark 和 Scala 版本匹配。
+
+请在 artifact 名称中使用 Spark 的 major.minor 版本号。
+
+可通过以下方式之一获取该 jar:
+
+1. 如果您在 Databricks、AWS EMR 或其他云平台的 notebook 中运行 Sedona,请使用 `shaded jar`:从 Maven Central 下载 [sedona-spark-shaded jar](https://repo.maven.apache.org/maven2/org/apache/sedona/) 与 [geotools-wrapper jar](https://repo.maven.apache.org/maven2/org/datasyslab/geotools-wrapper/),并将其放入 `SPARK_HOME/jars/` 目录。
+2. 如果您在 IDE 或本地 Jupyter Notebook 中运行 Sedona,请使用 `unshaded jar`,并在 Python 程序中通过 [Maven Central 坐标](maven-coordinates.md) 引用,例如:
+
+==Sedona >= 1.4.1==
+
+```python
+from sedona.spark import *
+
+config = (
+    SedonaContext.builder()
+    .config(
+        "spark.jars.packages",
+        "org.apache.sedona:sedona-spark-3.3_2.12:{{ sedona.current_version }},"
+        "org.datasyslab:geotools-wrapper:{{ sedona.current_geotools }}",
+    )
+    .config(
+        "spark.jars.repositories",
+        "https://artifacts.unidata.ucar.edu/repository/unidata-all",
+    )
+    .getOrCreate()
+)
+sedona = SedonaContext.create(config)
+```
+
+==Sedona < 1.4.1==
+
+`SedonaRegistrator` 自 Sedona 1.4.1 起已被弃用,请改用上面的方式。
+
+```python
+from pyspark.sql import SparkSession
+from sedona.spark import SedonaRegistrator
+from sedona.spark import SedonaKryoRegistrator, KryoSerializer
+
+spark = (
+    SparkSession.builder.appName("appName")
+    .config("spark.serializer", KryoSerializer.getName)
+    .config("spark.kryo.registrator", SedonaKryoRegistrator.getName)
+    .config(
+        "spark.jars.packages",
+        "org.apache.sedona:sedona-spark-shaded-3.3_2.12:{{ sedona.current_version }},"
+        "org.datasyslab:geotools-wrapper:{{ sedona.current_geotools }}",
+    )
+    .getOrCreate()
+)
+SedonaRegistrator.registerAll(spark)
+```
+
+### 设置环境变量
+
+如果您手动将 sedona-spark-shaded jar 复制到 `SPARK_HOME/jars/` 目录,则需要设置两个环境变量:
+
+* SPARK_HOME。例如,在终端运行:
+
+```bash
+export SPARK_HOME=~/Downloads/spark-3.0.1-bin-hadoop2.7
+```
+
+* PYTHONPATH。例如,在终端运行:
+
+```bash
+export PYTHONPATH=$SPARK_HOME/python
+```
+
+之后即可体验 [Sedona Python Jupyter Notebook](../tutorial/jupyter-notebook.md)。
diff --git a/docs/setup/install-scala.zh.md b/docs/setup/install-scala.zh.md
new file mode 100644
index 0000000000..acec355b75
--- /dev/null
+++ b/docs/setup/install-scala.zh.md
@@ -0,0 +1,94 @@
+<!--
+ 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.
+ -->
+
+在开始 Sedona 之旅之前,请确保您的 Apache Spark 集群已就绪。
+
+在 Apache Spark 中使用 Scala/Java 库有两种方式,您可以任选其一来运行 Sedona:
+
+* Spark 交互式 Scala 或 SQL shell:上手简单,适合新手尝试简单的函数调用。
+* 独立的 Scala / Java 项目:包管理学习成本较高,但适合大型项目。
+
+## Spark Scala shell
+
+### 自动下载 Sedona jar
+
+1. 准备好 Spark 集群。
+
+2. 使用 `--packages` 选项启动 Spark shell。该命令会自动从 Maven Central 下载 Sedona jar。
+
+```
+./bin/spark-shell --packages MavenCoordinates
+```
+
+请参考 [Sedona Maven Central 坐标](maven-coordinates.md),根据您的 Spark 版本选择对应的 Sedona 包。
+
+    * 本地模式:无需搭建集群即可测试 Sedona
+    ```
+    ./bin/spark-shell --packages org.apache.sedona:sedona-spark-shaded-3.3_2.12:{{ sedona.current_version }},org.datasyslab:geotools-wrapper:{{ sedona.current_geotools }}
+    ```
+
+    * 集群模式:需要指定 Spark Master IP
+    ```
+    ./bin/spark-shell --master spark://localhost:7077 --packages org.apache.sedona:sedona-spark-shaded-3.3_2.12:{{ sedona.current_version }},org.datasyslab:geotools-wrapper:{{ sedona.current_geotools }}
+    ```
+
+### 手动下载 Sedona jar
+
+1. 准备好 Spark 集群。
+
+2. 下载 Sedona jar:
+	* 从 [Sedona Releases](../download.md) 下载预编译 jar
+	* 下载 / git clone Sedona 源码并自行编译(参见 [编译 Sedona](compile.md))
+3. 使用 `--jars` 选项启动 Spark shell。
+
+```
+./bin/spark-shell --jars /Path/To/SedonaJars.jar
+```
+
+请使用文件名中包含 Spark major.minor 版本号的 jar,例如 `sedona-spark-shaded-3.3_2.12-{{ sedona.current_version }}`。
+
+    * 本地模式:无需搭建集群即可测试 Sedona
+    ```
+    ./bin/spark-shell --jars /path/to/sedona-spark-shaded-3.3_2.12-{{ sedona.current_version }}.jar,/path/to/geotools-wrapper-{{ sedona.current_geotools }}.jar
+    ```
+
+    * 集群模式:需要指定 Spark Master IP
+    ```
+    ./bin/spark-shell --master spark://localhost:7077 --jars /path/to/sedona-spark-shaded-3.3_2.12-{{ sedona.current_version }}.jar,/path/to/geotools-wrapper-{{ sedona.current_geotools }}.jar
+    ```
+
+## Spark SQL shell
+
+请参阅 [在纯 SQL 环境中使用 Sedona](../tutorial/sql-pure-sql.md)。
+
+## 独立的 Spark 项目
+
+独立项目可以让您创建多个 Scala / Java 文件,并将复杂的逻辑集中实现。要在独立的 Spark 项目中使用 Sedona,只需在 `pom.xml` 或 `build.sbt` 中将 Sedona 添加为依赖。
+
+1. 关于如何添加 Sedona 依赖,请参阅 [Sedona Maven Central 坐标](maven-coordinates.md)
+2. 使用 Sedona 模板项目快速上手:[Sedona 模板项目](../tutorial/demo.md)
+3. 使用 SBT 编译您的项目,并确保得到打包了所有依赖的 fat jar。
+4. 将编译生成的 fat jar 提交到 Spark 集群。请确保位于 Spark 发行版的根目录,然后运行以下命令:
+
+```
+./bin/spark-submit --master spark://YOUR-IP:7077 /Path/To/YourJar.jar
+```
+
+!!!note
+	关于 spark-submit 的详细说明请参见 [Spark 官方文档](https://spark.apache.org/docs/latest/submitting-applications.html)。
diff --git a/docs/setup/maven-coordinates.zh.md b/docs/setup/maven-coordinates.zh.md
new file mode 100644
index 0000000000..96ae59b6a0
--- /dev/null
+++ b/docs/setup/maven-coordinates.zh.md
@@ -0,0 +1,382 @@
+<!--
+ 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.
+ -->
+
+# Maven 坐标
+
+## 使用 Sedona shaded(fat)jar
+
+!!!warning
+	对于 Scala/Java/Python 用户,这是在您的环境中使用 Sedona 最常见的方式。除非确认确实不需要 shaded jar,否则不要使用单独的 Sedona jar。
+
+!!!warning
+	对于 R 用户,这是在您的环境中使用 Sedona 的唯一方式。
+
+Apache Sedona 针对每个受支持的 Spark 版本提供了不同的包。
+
+请使用 artifact 名称中包含 Spark major.minor 版本号的 artifact。例如,对于 Spark 3.4,应使用 `sedona-spark-shaded-3.4_2.12`。
+
+如果使用基于 Scala 2.13 编译的 Spark,则应使用对应的 Scala 2.13 版本,其后缀为 `_2.13`。
+
+可选的 GeoTools 库仅在使用栅格算子时才需要。矢量 CRS 转换(ST_Transform)现在默认使用内置的 proj4sedona,无需 GeoTools。该 wrapper 库是 GeoTools 官方 jar 的再分发,目的仅是把 GeoTools jar 从 OSGEO 仓库带入 Maven Central。该库基于 GNU Lesser General Public License (LGPL) 协议,因此无法打包进 Sedona 官方发行版中。
+
+!!! abstract "Sedona 与 Apache Spark + Scala 2.12"
+
+	=== "Spark 3.4 与 Scala 2.12"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-shaded-3.4_2.12</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+	=== "Spark 3.5 与 Scala 2.12"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-shaded-3.5_2.12</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+	=== "Spark 4.0 与 Scala 2.12"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-shaded-4.0_2.12</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+!!! abstract "Sedona 与 Apache Spark + Scala 2.13"
+
+	=== "Spark 3.4 与 Scala 2.13"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-shaded-3.4_2.13</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+	=== "Spark 3.5 与 Scala 2.13"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-shaded-3.5_2.13</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+	=== "Spark 4.0 与 Scala 2.13"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-shaded-4.0_2.13</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+	=== "Spark 4.1 与 Scala 2.13"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-shaded-4.1_2.13</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+!!! abstract "Sedona 与 Apache Flink"
+
+	=== "Flink 1.12+ 与 Scala 2.12"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-flink-shaded_2.12</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+!!! abstract "Sedona 与 Snowflake"
+
+	=== "Snowflake 7.0+(2023 年及以后)"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-snowflake</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<!-- 可选:https://mvnrepository.com/artifact/org.datasyslab/geotools-wrapper -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+## 使用 Sedona unshaded jar
+
+!!!warning
+	Scala、Java、Python 用户仅在同时满足以下条件时才考虑使用下面的 jar:(1) 您知道如何在复杂应用中排除传递依赖;(2) 您的环境可以访问公网;(3) 您正在使用某种 Maven 包解析器,或 pom.xml/build.sbt,它通常以 `GroupID:ArtifactID:Version` 的形式接收输入。如果您不清楚以上含义,那么下面的 jar 不适合您。
+
+Apache Sedona 针对每个受支持的 Spark 版本提供了不同的包。
+
+请使用 artifact 名称中包含 Spark major.minor 版本号的 artifact。例如,对于 Spark 3.4,应使用 `sedona-spark-3.4_2.12`。
+
+如果使用基于 Scala 2.13 编译的 Spark,则应使用对应的 Scala 2.13 版本(后缀为 `_2.13`)。
+
+可选的 GeoTools 库仅在使用栅格算子时才需要。矢量 CRS 转换(ST_Transform)现在默认使用内置的 proj4sedona,无需 GeoTools。该 wrapper 库是 GeoTools 官方 jar 的再分发,目的仅是把 GeoTools jar 从 OSGEO 仓库带入 Maven Central。该库基于 GNU Lesser General Public License (LGPL) 协议,因此无法打包进 Sedona 官方发行版中。
+
+!!! abstract "Sedona 与 Apache Spark + Scala 2.12"
+
+	=== "Spark 3.4 与 Scala 2.12"
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-3.4_2.12</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+	=== "Spark 3.5 与 Scala 2.12"
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-3.5_2.12</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+	=== "Spark 4.0 与 Scala 2.12"
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-4.0_2.12</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+!!! abstract "Sedona 与 Apache Spark + Scala 2.13"
+
+	=== "Spark 3.4 与 Scala 2.13"
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-3.4_2.13</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+	=== "Spark 3.5 与 Scala 2.13"
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-3.5_2.13</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+	=== "Spark 4.0 与 Scala 2.13"
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-4.0_2.13</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+	=== "Spark 4.1 与 Scala 2.13"
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-spark-4.1_2.13</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+!!! abstract "Sedona 与 Apache Flink"
+
+	=== "Flink 1.12+ 与 Scala 2.12"
+
+		```xml
+		<dependency>
+		  <groupId>org.apache.sedona</groupId>
+		  <artifactId>sedona-flink_2.12</artifactId>
+		  <version>{{ sedona.current_version }}</version>
+		</dependency>
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>geotools-wrapper</artifactId>
+		    <version>{{ sedona.current_geotools }}</version>
+		</dependency>
+		```
+
+Sedona Snowflake 没有 unshaded 版本。
+
+### netCDF-Java 5.4.2
+
+仅当您希望使用 `RS_FromNetCDF` 读取 HDF/NetCDF 文件时才需要此依赖。注意该 JAR 并未发布到 Maven Central,需要在 pom.xml 或 build.sbt 中加入对应仓库,或在 Spark 配置 `spark.jars.repositories` / `spark-submit --repositories` 中指定其 URL。
+
+许可协议:BSD 3-clause(与 Apache 2.0 兼容)。
+
+!!! abstract "添加 HDF/NetCDF 依赖"
+
+	=== "Sedona 1.3.1+"
+
+		在 pom.xml 中加入 unidata 仓库:
+
+		```
+		<repositories>
+		    <repository>
+		        <id>unidata-all</id>
+		        <name>Unidata All</name>
+		        <url>https://artifacts.unidata.ucar.edu/repository/unidata-all/</url>
+		    </repository>
+		</repositories>
+		```
+
+		然后将 cdm-core 添加到 POM 依赖中:
+
+		```xml
+		<dependency>
+		    <groupId>edu.ucar</groupId>
+		    <artifactId>cdm-core</artifactId>
+		    <version>5.4.2</version>
+		</dependency>
+		```
+
+	=== "Sedona 1.3.1 之前"
+
+		```xml
+		<!-- https://mvnrepository.com/artifact/org.datasyslab/sernetcdf -->
+		<dependency>
+		    <groupId>org.datasyslab</groupId>
+		    <artifactId>sernetcdf</artifactId>
+		    <version>0.1.0</version>
+		</dependency>
+		```
+
+## SNAPSHOT 版本
+
+有时 Sedona 会为即将发布的版本提供 SNAPSHOT 版本。其命名规则与正式版相同,仅在版本号中以 “SNAPSHOT” 作为后缀,例如 `{{ sedona_create_release.current_snapshot }}`。
+
+要下载 SNAPSHOT,需要在 pom.xml 或 build.sbt 中添加以下仓库:
+
+### build.sbt
+
+resolvers +=
+  "Apache Software Foundation Snapshots" at "https://repository.apache.org/content/groups/snapshots"
+
+### pom.xml
+
+```xml
+<repositories>
+    <repository>
+        <id>snapshots-repo</id>
+        <url>https://repository.apache.org/content/groups/snapshots</url>
+        <releases><enabled>false</enabled></releases>
+        <snapshots><enabled>true</enabled></snapshots>
+    </repository>
+</repositories>
+```
diff --git a/docs/setup/modules.zh.md b/docs/setup/modules.zh.md
new file mode 100644
index 0000000000..ed3fa07255
--- /dev/null
+++ b/docs/setup/modules.zh.md
@@ -0,0 +1,35 @@
+<!--
+ 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.
+ -->
+
+# Apache Spark 上的 Sedona 模块
+
+| 名称           |  API                  |  介绍                                                |
+|----------------|-----------------------|------------------------------------------------------|
+| spark          | RDD / SQL / DataFrame | SpatialRDD 与空间 DataFrame                          |
+| spark-shaded   |                       | Shaded 版本                                          |
+| python         |                       | SpatialRDD 与空间 DataFrame 的 Python 接口           |
+| Zeppelin       | Apache Zeppelin       | 适用于 Apache Zeppelin 0.8.1+ 的插件                 |
+
+## API 可用性
+
+|            | **Core/RDD** | **DataFrame/SQL** | **Viz RDD/SQL** |
+|:----------:|:------------:|:-----------------:|:---------------:|
+| Scala/Java |✅|✅|✅|
+|   Python   |✅|✅|仅 SQL|
+|      R     |✅|✅|✅|
diff --git a/docs/setup/overview.zh.md b/docs/setup/overview.zh.md
new file mode 100644
index 0000000000..7dfbea071f
--- /dev/null
+++ b/docs/setup/overview.zh.md
@@ -0,0 +1,55 @@
+<!--
+ 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.
+ -->
+
+# 下载统计
+
+| 下载统计                  | **Maven**  | **PyPI**                                                                                                                                                                                                                                                                                                                                     | Conda-forge                                                                                                            [...]
+|----------------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------ [...]
+| Apache Sedona              | 33 万次/月 | [![PyPI - Downloads](https://img.shields.io/pypi/dm/apache-sedona)](https://pepy.tech/project/apache-sedona) [![Downloads](https://static.pepy.tech/personalized-badge/apache-sedona?period=total&units=international_system&left_color=black&right_color=brightgreen&left_text=total%20downloads)](https://pepy.tech/project/apache-sedona) | [![Anaconda-Server Badge](https://anaconda.org/conda-forge/apache-sedona/badges/downloads.svg)](https://anaconda.org [...]
+| 已归档的 GeoSpark 版本     | 1 万次/月  | [![PyPI - Downloads](https://img.shields.io/pypi/dm/geospark)](https://pepy.tech/project/geospark)[![Downloads](https://static.pepy.tech/personalized-badge/geospark?period=total&units=international_system&left_color=black&right_color=brightgreen&left_text=total%20downloads)](https://pepy.tech/project/geospark)                      |                                                                                                                            [...]
+
+# Sedona 能做什么?
+
+## 分布式空间数据集
+
+- [x] Spark 上的空间 RDD
+- [x] Spark 上的空间 DataFrame/SQL
+- [x] Flink 上的空间 DataStream
+- [x] Flink 上的空间 Table/SQL
+- [x] Snowflake 上的空间 SQL
+
+## 复杂空间对象
+
+- [x] 矢量几何对象 / 轨迹
+- [x] 支持地图代数(Map Algebra)的栅格图像
+- [x] 多种输入格式:CSV、TSV、WKT、WKB、GeoJSON、Shapefile、GeoTIFF、ArcGrid、NetCDF/HDF
+
+## 分布式空间查询
+
+- [x] 空间查询:范围查询、范围连接查询、距离连接查询、K 最近邻查询
+- [x] 空间索引:R-Tree、Quad-Tree
+
+## 丰富的空间分析工具
+
+- [x] 坐标参考系(CRS)/ 空间参考系(SRS)转换
+- [x] Apache Zeppelin 仪表盘集成
+- [X] 与 Jupyter Notebook、GeoPandas、Shapely 等多种 Python 工具集成
+- [X] 与 KeplerGL、DeckGL 等多种可视化工具集成
+- [x] 高分辨率、可扩展的地图生成:[可视化空间 DataFrame/RDD](../tutorial/viz.md)
+- [x] 支持 Scala、Java、Python、R
diff --git a/docs/setup/platform.zh.md b/docs/setup/platform.zh.md
new file mode 100644
index 0000000000..0c51162b14
--- /dev/null
+++ b/docs/setup/platform.zh.md
@@ -0,0 +1,49 @@
+<!--
+ 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.
+ -->
+
+Sedona 二进制版本由 Java 11/17 与 Scala 2.12/2.13 编译,并在以下环境中经过测试:
+
+**Java 要求:**
+
+- Spark 3.4 与 3.5:Java 11
+- Spark 4.0 与 4.1:Java 17
+
+**注意:** 自 Sedona 1.8.0 起不再支持 Java 8。自 Sedona 1.8.0 起不再支持 Spark 3.3。
+
+=== "Sedona Scala/Java"
+
+	|             | Spark 3.4| Spark 3.5 | Spark 4.0 | Spark 4.1 |
+	|:---------:|:---------:|:---------:|:---------:|:---------:|
+	| Scala 2.12 |✅ |✅ |✅ | |
+	| Scala 2.13 |✅ |✅ |✅ |✅ |
+
+=== "Sedona Python"
+
+    |             | Spark 3.4 (Scala 2.12)|Spark 3.5 (Scala 2.12)| Spark 4.0 (Scala 2.13)| Spark 4.1 (Scala 2.13)|
+    |:---------:|:---------:|:---------:|:---------:|:---------:|
+    | Python 3.7  |  ✅  |  ✅  | | |
+    | Python 3.8 |  ✅  |  ✅  |  | |
+    | Python 3.9 |  ✅  |  ✅  | ✅  | ✅ |
+    | Python 3.10 |  ✅  |  ✅  | ✅  | ✅ |
+
+=== "Sedona R"
+
+	|             | Spark 3.4 | Spark 3.5 | Spark 4.0 | Spark 4.1 |
+	|:---------:|:---------:|:---------:|:---------:|:---------:|
+	| Scala 2.12 | ✅ | ✅ | ✅ | |
diff --git a/docs/setup/snowflake/install.zh.md b/docs/setup/snowflake/install.zh.md
new file mode 100644
index 0000000000..48d83bd87a
--- /dev/null
+++ b/docs/setup/snowflake/install.zh.md
@@ -0,0 +1,116 @@
+<!--
+ 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.
+ -->
+
+!!! note
+    本教程介绍如何在 Snowflake 上手动安装 Sedona。如果您不希望手动安装,可以使用由 [Wherobots](https://wherobots.com/) 发布的免费 [SedonaSnow](https://app.snowflake.com/marketplace/listing/GZTYZF0RTY3/wherobots-sedonasnow) 原生应用。
+
+## 前置条件
+
+要在 Snowflake 上安装 Sedona,需要准备一个 Snowflake 账号,以及一位至少能访问一个 `DATABASE` 并能运行至少一个 `WAREHOUSE` 的 Snowflake 用户。然后按照以下步骤进行安装。
+
+如何创建 DATABASE 可参阅 [Snowflake 官方文档](https://docs.snowflake.com/en/sql-reference/sql/create-database)。
+
+本教程使用如下 SQL 语句创建数据库;当然您也可以使用任意其他数据库:
+
+```sql
+CREATE DATABASE SEDONA_TEST;
+```
+
+## 步骤 1:在数据库中创建 stage
+
+stage 是 Snowflake 中映射到云存储位置(如 Amazon S3、Azure Blob Storage、Google Cloud Storage)的对象,可用于将数据加载到表中或从表中卸载数据。
+
+这里我们在上一步创建的数据库的 `public` schema 下创建一个名为 `ApacheSedona` 的 stage,用于上传 Sedona 的 JAR 文件。我们选择 `Snowflake managed` 类型的 stage。
+
+![在数据库中创建 stage](../../image/snowflake/snowflake-1.png)
+
+创建后,您应能在数据库中看到该 stage:
+
+![在数据库中查看 stage](../../image/snowflake/snowflake-2.png)
+
+如何创建 stage 可参阅 [Snowflake 官方文档](https://docs.snowflake.com/en/sql-reference/sql/create-stage.html)。
+
+## 步骤 2:将 Sedona 的 JAR 文件上传到 stage
+
+需要下载以下 2 个 JAR 文件:
+
+* sedona-snowflake-{{ sedona.current_version }}.jar:[Sedona 在 Maven Central 的仓库](https://central.sonatype.com/artifact/org.apache.sedona/sedona-snowflake/versions)
+* geotools-wrapper-{{ sedona.current_geotools }}.jar:[GeoTools-wrapper 在 Maven Central 的仓库](https://central.sonatype.com/artifact/org.datasyslab/geotools-wrapper/versions)
+
+然后将这 2 个 JAR 文件上传到上一步创建的 stage 中。
+
+上传完成后,您应能在 stage 中看到这 2 个文件:
+
+![stage 中的 2 个 JAR 文件](../../image/snowflake/snowflake-3.png)
+
+如何向 stage 上传文件可参阅 [Snowflake 官方文档](https://docs.snowflake.com/en/sql-reference/sql/put.html)。
+
+## 步骤 3:在数据库中创建 schema
+
+schema 是 Snowflake 中映射到数据库的对象,可按业务功能或其他类别将表组织在一起。
+
+这里我们在上一步的数据库下创建一个名为 `SEDONA` 的 schema,用于承载 Sedona 的函数。
+
+![在数据库中创建 schema](../../image/snowflake/snowflake-4.png)
+
+随后即可在数据库中找到该 schema:
+
+![在数据库中查看 schema](../../image/snowflake/snowflake-5.png)
+
+如何创建 schema 可参阅 [Snowflake 官方文档](https://docs.snowflake.com/en/sql-reference/sql/create-schema.html)。
+
+## 步骤 4:获取创建 Sedona 函数的 SQL 脚本
+
+通过运行以下命令获取该 SQL 脚本:
+
+```bash
+java -jar sedona-snowflake-{{ sedona.current_version }}.jar --geotools-version {{ sedona.current_geotools }} > sedona-snowflake.sql
+```
+
+其中 sedona-snowflake-{{ sedona.current_version }}.jar 即步骤 2 中下载的 JAR 文件。
+
+## 步骤 5:运行 SQL 脚本以创建 Sedona 的函数
+
+我们在上一步的数据库下创建一个 worksheet,并运行该 SQL 脚本以创建 Sedona 的函数。
+
+这里我们选择 `Create Worksheet from SQL File` 选项。
+
+![从 SQL 文件创建 Worksheet](../../image/snowflake/snowflake-6.png)
+
+在 worksheet 中将数据库选择为 `SEDONA_TEST`,schema 选择为 `PUBLIC`。SQL 脚本应已加载到 worksheet 中。然后右键点击 worksheet 选择 `Run All`。Snowflake 大约会用 3 分钟时间创建 Sedona 的函数。
+
+![运行 SQL 脚本以创建 Sedona 函数](../../image/snowflake/snowflake-7.png)
+
+## 步骤 6:验证安装
+
+打开新的 worksheet,将数据库选为 `SEDONA_TEST`,schema 任意。然后运行以下 SQL 语句:
+
+```sql
+SELECT SEDONA.ST_AsEWKT(SEDONA.ST_SETSRID(SEDONA.ST_POINT(1, 2), 4326));
+```
+
+应能看到如下结果:
+
+```
+SRID=4326;POINT (1 2)
+```
+
+worksheet 应类似下图:
+
+![验证安装的 worksheet 输出](../../image/snowflake/snowflake-8.png)
diff --git a/docs/setup/snowflake/modules.zh.md b/docs/setup/snowflake/modules.zh.md
new file mode 100644
index 0000000000..b386a1dd99
--- /dev/null
+++ b/docs/setup/snowflake/modules.zh.md
@@ -0,0 +1,32 @@
+<!--
+ 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.
+ -->
+
+# Snowflake 上的 Sedona 模块
+
+| 名称              | 介绍                                          |
+|-------------------|-----------------------------------------------|
+| snowflake         | 适用于 Snowflake 的空间 SQL 函数              |
+| snowflake-tester  | Sedona Snowflake 函数的自动化测试器           |
+
+## API 可用性
+
+|            | **Table** |
+|:----------:|:-----------------:|
+| SnowSQL |✅|
+|   Snowpark   |✅|
diff --git a/docs/setup/wherobots.zh.md b/docs/setup/wherobots.zh.md
new file mode 100644
index 0000000000..a45f119717
--- /dev/null
+++ b/docs/setup/wherobots.zh.md
@@ -0,0 +1,26 @@
+<!--
+ 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.
+ -->
+
+## WherobotsDB
+
+Wherobots Cloud 提供了对 WherobotsDB 的完全托管、完全预配置的云服务。WherobotsDB 是一套全面的空间分析数据库系统,您可以在云端托管的 Jupyter Notebook 中使用 Python、Java 或 Scala 内核进行体验,无需任何安装。
+
+WherobotsDB 在公共 API 层面与 Apache Sedona 100% 兼容,并提供更丰富的功能与更优的性能。
+
+将现有的 Sedona 工作流迁移到 [Wherobots Cloud](https://www.wherobots.com) 非常简单。请前往 [此处](https://cloud.wherobots.com/) 注册以创建账号。
diff --git a/docs/setup/zeppelin.zh.md b/docs/setup/zeppelin.zh.md
new file mode 100644
index 0000000000..9101edb471
--- /dev/null
+++ b/docs/setup/zeppelin.zh.md
@@ -0,0 +1,75 @@
+<!--
+ 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.
+ -->
+
+# 安装 Sedona-Zeppelin
+
+!!!warning
+	**已知问题**:由于 Leaflet JS 的限制,Sedona 在 Zeppelin 地图上只能将每个几何对象(点、线串和多边形)以点的形式绘制。如需可扩展且功能完整的可视化,请使用 SedonaViz 在 Zeppelin 地图上绘制散点图与热力图。
+
+## 兼容性
+
+Apache Spark 2.3+
+
+Apache Zeppelin 0.8.1+
+
+Sedona 1.0.0+:Sedona-core、Sedona-SQL、Sedona-Viz
+
+## 安装
+
+!!!note
+	仅当您在 Zeppelin Helium 包列表中找不到 [Apache-sedona](https://www.npmjs.com/package/apache-sedona) 或 [GeoSpark Zeppelin](https://www.npmjs.com/package/geospark-zeppelin) 时,才需要执行步骤 1 和 2。
+
+### 创建 Helium 文件夹(可选)
+
+在 Zeppelin 根目录下创建一个名为 `helium` 的文件夹。
+
+### 添加 Sedona-Zeppelin 描述(可选)
+
+在该文件夹中创建一个名为 `sedona-zeppelin.json` 的文件,并写入以下内容。请注意修改 artifact 路径!
+
+```
+{
+  "type": "VISUALIZATION",
+  "name": "sedona-zeppelin",
+  "description": "Zeppelin visualization support for Sedona",
+  "artifact": "/Absolute/Path/sedona/zeppelin",
+  "license": "BSD-2-Clause",
+  "icon": "<i class='fa fa-globe'></i>"
+}
+```
+
+### 启用 Sedona-Zeppelin
+
+重启 Zeppelin,然后打开 Zeppelin Helium 界面并启用 Sedona-Zeppelin。
+
+![Enable Package](../image/enable-helium.gif)
+
+### 在 Zeppelin Spark 解释器中添加 Sedona 依赖
+
+![add-geospark](../image/add-geospark-interpreter.gif)
+
+### 可视化 SedonaSQL 结果
+
+![sql-zeppelin](../image/sql-zeppelin.gif)
+
+### 展示 SedonaViz 结果
+
+![viz-zeppelin](../image/viz-zeppelin.gif)
+
+至此安装完成!请阅读 [Sedona-Zeppelin 教程](../tutorial/zeppelin.md) 查看完整的实操示例。


(sedona) 05/12: [GH-2911] Translate Tutorial / Programming Guide (part 1) to Chinese (#2931)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 30523d8aec98851c5e8cd75d788cc2b48b6fa20e
Author: Jia Yu <ji...@apache.org>
AuthorDate: Thu May 7 23:38:43 2026 -0700

    [GH-2911] Translate Tutorial / Programming Guide (part 1) to Chinese (#2931)
    
    (cherry picked from commit b3bdd1d53c3c3b79a9c61e7e717dae4bab6c82a4)
---
 .../Advanced-Tutorial-Tune-your-Application.zh.md  |  86 +++++++
 docs/tutorial/benchmark.zh.md                      |  25 ++
 docs/tutorial/concepts/clustering-algorithms.zh.md | 136 ++++++++++
 docs/tutorial/concepts/distance-spark.zh.md        | 275 +++++++++++++++++++++
 docs/tutorial/demo.zh.md                           |  62 +++++
 .../tutorial/files/csv-geometry-sedona-spark.zh.md | 192 ++++++++++++++
 docs/tutorial/files/geojson-sedona-spark.zh.md     | 248 +++++++++++++++++++
 docs/tutorial/files/geopackage-sedona-spark.zh.md  | 198 +++++++++++++++
 .../files/geotiffmetadata-sedona-spark.zh.md       | 186 ++++++++++++++
 docs/tutorial/files/shapefiles-sedona-spark.zh.md  | 219 ++++++++++++++++
 docs/tutorial/flink/pyflink-sql.zh.md              |  72 ++++++
 docs/tutorial/jupyter-notebook.zh.md               |  58 +++++
 docs/tutorial/sql-pure-sql.zh.md                   | 101 ++++++++
 docs/tutorial/storing-blobs-in-parquet.zh.md       |  67 +++++
 docs/tutorial/viz-gallery.zh.md                    |  24 ++
 docs/tutorial/viz.zh.md                            | 247 ++++++++++++++++++
 docs/tutorial/zeppelin.zh.md                       |  85 +++++++
 17 files changed, 2281 insertions(+)

diff --git a/docs/tutorial/Advanced-Tutorial-Tune-your-Application.zh.md b/docs/tutorial/Advanced-Tutorial-Tune-your-Application.zh.md
new file mode 100644
index 0000000000..e22c5b1794
--- /dev/null
+++ b/docs/tutorial/Advanced-Tutorial-Tune-your-Application.zh.md
@@ -0,0 +1,86 @@
+<!--
+ 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.
+ -->
+
+# 进阶教程:调优您的 Sedona RDD 应用
+
+在进入这篇进阶教程之前,请确保您已经在本机尝试过若干 Sedona 函数。
+
+## 选择合适的 Sedona 版本
+
+Sedona 的版本号包含三级(例如 0.8.1)。
+
+第一级表示该版本进行了较大的结构重设计,可能带来显著的 API 变化与性能差异。
+
+第二级(如 0.8)表明该版本包含显著的性能提升、重要的新功能以及 API 变化。如果您是 Sedona 老用户并希望升级到这种版本,需要谨慎对待 API 变更。升级前请阅读 [Sedona 版本发布说明](../setup/release-notes.md),确认能接受相应的 API 变化。
+
+第三级(如 0.8.1)则只包含 bug 修复、少量小的新特性以及轻微的性能提升,不会包含任何 API 变化。升级到此类版本是安全的。我们强烈建议同一二级版本下的所有 Sedona 用户都升级到该级别的最新版本。
+
+## 选择合适的 Spatial RDD 构造方式
+
+Sedona 为每种 SpatialRDD(PointRDD、PolygonRDD、LineStringRDD)提供了多种构造方式。一般来说,您可以从两种入口开始:
+
+1. 从 HDFS、S3 等数据源初始化 SpatialRDD。一个典型示例如下:
+
+```java
+public PointRDD(JavaSparkContext sparkContext, String InputLocation, Integer Offset, FileDataSplitter splitter, boolean carryInputData, Integer partitions, StorageLevel newLevel)
+```
+
+2. 从已有 RDD 初始化 SpatialRDD。一个典型示例如下:
+
+```java
+public PointRDD(JavaRDD<Point> rawSpatialRDD, StorageLevel newLevel)
+```
+
+可以注意到这些构造函数都接受一个 `StorageLevel` 参数。这是为了让 Spark 缓存 SpatialRDD 的一个属性 `rawSpatialRDD`。Sedona 这样做是因为它需要通过若干 Spark “Action” 计算数据集边界与近似总数;这些信息在执行 Spatial Join Query 与 Distance Join Query 时非常有用。
+
+但有时您对自己的数据集十分了解,那么可以手动提供这些信息,调用如下形式的 Spatial RDD 构造函数:
+
+```java
+public PointRDD(JavaSparkContext sparkContext, String InputLocation, Integer Offset, FileDataSplitter splitter, boolean carryInputData, Integer partitions, Envelope datasetBoundary, Integer approximateTotalCount) {
+```
+
+手动提供数据集边界与近似总数能让 Sedona 在初始化时跳过若干较慢的 “Action”。
+
+## 缓存被反复使用的 Spatial RDD
+
+每个 SpatialRDD(PointRDD、PolygonRDD、LineStringRDD)都包含 4 个 RDD 属性:
+
+1. rawSpatialRDD:由 SpatialRDD 构造方法生成的 RDD。
+2. spatialPartitionedRDD:基于 rawSpatialRDD 进行空间分区后的 RDD。注意:该 RDD 中存在被复制的空间对象。
+3. indexedRawRDD:基于 rawSpatialRDD 建索引后的 RDD。
+4. indexedRDD:基于 spatialPartitionedRDD 建索引后的 RDD。注意:该 RDD 中存在被复制的空间对象。
+
+这 4 个 RDD 不会同时存在,所以无需担心内存问题。
+它们在不同查询中分别被调用:
+
+1. Spatial Range Query / KNN Query,未启用索引:使用 rawSpatialRDD。
+2. Spatial Range Query / KNN Query,启用索引:使用 indexedRawRDD。
+3. Spatial Join Query / Distance Join Query,未启用索引:使用 spatialPartitionedRDD。
+4. Spatial Join Query / Distance Join Query,启用索引:使用 indexedRDD。
+
+因此,如果您会多次执行上述某种查询,最好将对应的 RDD 缓存到内存中。常见的使用场景包括:
+
+1. 在 Spatial Autocorrelation、Spatial Co-location Pattern Mining 等空间数据挖掘任务中,可能需要迭代地执行 Spatial Join / Spatial Self-join 来计算邻接矩阵。这种情况下请缓存被反复查询的 spatialPartitionedRDD/indexedRDD。
+2. 在 [Livy](https://github.com/cloudera/livy)、[Spark Job Server](https://github.com/spark-jobserver/spark-jobserver) 等 Spark RDD 共享应用中,多名用户可能在同一份 Spatial RDD 上以不同谓词执行 Spatial Range Query / KNN Query,此时建议缓存 rawSpatialRDD/indexedRawRDD。
+
+## 留意 Spatial RDD 的分区数
+
+有时用户反映某些场景下执行时间较慢。第一步请始终考虑增加 SpatialRDD 的分区数(建议为原值的 2 - 8 倍),可以在初始化 SpatialRDD 时进行设置,这往往能显著提升性能。
+
+之后您可以再考虑调整 Spark 的其他参数,例如使用 Kryo 序列化器,或调整缓存到内存的 RDD 比例。
diff --git a/docs/tutorial/benchmark.zh.md b/docs/tutorial/benchmark.zh.md
new file mode 100644
index 0000000000..eab59e825e
--- /dev/null
+++ b/docs/tutorial/benchmark.zh.md
@@ -0,0 +1,25 @@
+<!--
+ 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.
+ -->
+
+## 基准测试
+
+我们欢迎大家将 Sedona 用于基准测试。为了获得最佳性能或体验 Sedona 的全部特性,请:
+
+* 始终使用最新版本,或者在基准测试中明确说明所用版本,便于我们追踪相关问题。
+* 启用 Sedona 的 Kryo 序列化器以减少内存占用。
diff --git a/docs/tutorial/concepts/clustering-algorithms.zh.md b/docs/tutorial/concepts/clustering-algorithms.zh.md
new file mode 100644
index 0000000000..06bdb2d918
--- /dev/null
+++ b/docs/tutorial/concepts/clustering-algorithms.zh.md
@@ -0,0 +1,136 @@
+<!--
+ 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.
+ -->
+
+# 在 Apache Spark 上使用 Apache Sedona 进行聚类
+
+聚类算法将相似的数据点划分到 “簇(cluster)” 中。Apache Sedona 可以在大规模几何数据集上运行聚类算法。
+
+注意 “cluster” 一词在此处有两种含义:
+
+* 计算集群(computation cluster)是一组协同执行算法的计算机网络
+* 聚类算法把数据点划分到不同的 “簇(cluster)” 中
+
+本页中的 “簇” 指聚类算法的输出结果。
+
+## 在 Spark 上使用 DBSCAN 进行聚类
+
+本页介绍如何使用 Apache Sedona 执行基于密度的带噪声空间聚类(DBSCAN,density-based spatial clustering of applications with noise)。
+
+DBSCAN 将密度较高区域中的几何对象聚为簇,同时把密度较低区域中的点标记为噪声/离群点。
+
+下面通过散点图来观察一份可被聚类的数据:
+
+![点的散点图](../../image/tutorial/concepts/dbscan-scatterplot-points.png)
+
+DBSCAN 的聚类结果如下:
+
+![带簇分组的散点图](../../image/tutorial/concepts/dbscan-clustering.png)
+
+* 簇 0 包含 5 个点
+* 簇 1 包含 4 个点
+* 4 个点为离群点
+
+下面使用这份数据创建 Spark DataFrame,并使用 Sedona 运行聚类。构造 DataFrame 的代码如下:
+
+```python
+df = (
+    sedona.createDataFrame(
+        [
+            (1, 8.0, 2.0),
+            (2, 2.6, 4.0),
+            (3, 2.5, 4.0),
+            (4, 8.5, 2.5),
+            (5, 2.8, 4.3),
+            (6, 12.8, 4.5),
+            (7, 2.5, 4.2),
+            (8, 8.2, 2.5),
+            (9, 8.0, 3.0),
+            (10, 1.0, 5.0),
+            (11, 8.0, 2.5),
+            (12, 5.0, 6.0),
+            (13, 4.0, 3.0),
+        ],
+        ["id", "x", "y"],
+    )
+).withColumn("point", ST_Point(col("x"), col("y")))
+```
+
+DataFrame 内容如下:
+
+```
++---+----+---+----------------+
+| id|   x|  y|           point|
++---+----+---+----------------+
+|  1| 8.0|2.0|     POINT (8 2)|
+|  2| 2.6|4.0|   POINT (2.6 4)|
+|  3| 2.5|4.0|   POINT (2.5 4)|
+|  4| 8.5|2.5| POINT (8.5 2.5)|
+|  5| 2.8|4.3| POINT (2.8 4.3)|
+|  6|12.8|4.5|POINT (12.8 4.5)|
+|  7| 2.5|4.2| POINT (2.5 4.2)|
+|  8| 8.2|2.5| POINT (8.2 2.5)|
+|  9| 8.0|3.0|     POINT (8 3)|
+| 10| 1.0|5.0|     POINT (1 5)|
+| 11| 8.0|2.5|   POINT (8 2.5)|
+| 12| 5.0|6.0|     POINT (5 6)|
+| 13| 4.0|3.0|     POINT (4 3)|
++---+----+---+----------------+
+```
+
+运行 DBSCAN 算法的方法如下:
+
+```python
+from sedona.spark.stats import dbscan
+
+dbscan(df, 1.0, 3).orderBy("id").show()
+```
+
+计算结果如下:
+
+```
++---+----+---+----------------+------+-------+
+| id|   x|  y|           point|isCore|cluster|
++---+----+---+----------------+------+-------+
+|  1| 8.0|2.0|     POINT (8 2)|  true|      0|
+|  2| 2.6|4.0|   POINT (2.6 4)|  true|      1|
+|  3| 2.5|4.0|   POINT (2.5 4)|  true|      1|
+|  4| 8.5|2.5| POINT (8.5 2.5)|  true|      0|
+|  5| 2.8|4.3| POINT (2.8 4.3)|  true|      1|
+|  6|12.8|4.5|POINT (12.8 4.5)| false|     -1|
+|  7| 2.5|4.2| POINT (2.5 4.2)|  true|      1|
+|  8| 8.2|2.5| POINT (8.2 2.5)|  true|      0|
+|  9| 8.0|3.0|     POINT (8 3)|  true|      0|
+| 10| 1.0|5.0|     POINT (1 5)| false|     -1|
+| 11| 8.0|2.5|   POINT (8 2.5)|  true|      0|
+| 12| 5.0|6.0|     POINT (5 6)| false|     -1|
+| 13| 4.0|3.0|     POINT (4 3)| false|     -1|
++---+----+---+----------------+------+-------+
+```
+
+可以看到 `cluster` 列表示每个几何对象所属的簇。
+
+要执行该操作,必须先设置 Spark 的检查点目录。检查点目录是查询中间结果写入的持久化临时缓存位置。
+
+可按如下方式设置检查点目录:
+
+```python
+sedona.sparkContext.setCheckpointDir(myPath)
+```
+
+`myPath` 必须能被所有 executor 访问。本机运行时使用本地路径即可;如有 HDFS,通常是更好的选择。某些运行时环境可能允许或要求使用块存储路径(如 Amazon S3、Google Cloud Storage)。部分环境可能已经预先设置了 Spark 检查点目录,这一步即可省略。
diff --git a/docs/tutorial/concepts/distance-spark.zh.md b/docs/tutorial/concepts/distance-spark.zh.md
new file mode 100644
index 0000000000..a2408d99ef
--- /dev/null
+++ b/docs/tutorial/concepts/distance-spark.zh.md
@@ -0,0 +1,275 @@
+<!--
+ 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.
+ -->
+
+# 在 Apache Spark 上使用 Sedona 计算距离
+
+本文介绍如何使用 Apache Sedona 与 Apache Spark 计算两个点或几何对象之间的距离。
+
+您将了解如何在二维笛卡尔平面上计算距离,以及如何为地理空间数据计算考虑地球曲率的距离。
+
+先看一个在二维笛卡尔平面上计算两点距离的示例。
+
+## 使用 Spark 与 Sedona 计算两点之间的距离
+
+假设您有 4 个点,希望分别计算 `point_a` 与 `point_b`、`point_c` 与 `point_d` 之间的距离。
+
+![两点之间的距离](../../image/tutorial/concepts/distance1.png)
+
+先创建一个包含这些点的 DataFrame:
+
+```python
+df = sedona.createDataFrame(
+    [
+        (Point(2, 3), Point(6, 4)),
+        (Point(6, 2), Point(9, 2)),
+    ],
+    ["start", "end"],
+)
+```
+
+`start` 与 `end` 列均为 `geometry` 类型。
+
+使用 `ST_Distance` 函数计算两点之间的距离:
+
+```python
+df.withColumn("distance", ST_Distance(col("start"), col("end"))).show()
+```
+
+结果如下:
+
+```
++-----------+-----------+-----------------+
+|      start|        end|         distance|
++-----------+-----------+-----------------+
+|POINT (2 3)|POINT (6 4)|4.123105625617661|
+|POINT (6 2)|POINT (9 2)|              3.0|
++-----------+-----------+-----------------+
+```
+
+借助 `ST_Distance`,在二维平面上计算两点之间的距离非常直观。
+
+## 使用 Spark 与 Sedona 计算两个经纬度点之间的距离
+
+下面创建两个经纬度点并计算它们之间的距离。先用经纬度构造 DataFrame:
+
+```python
+seattle = Point(-122.335167, 47.608013)
+new_york = Point(-73.935242, 40.730610)
+sydney = Point(151.2, -33.9)
+df = sedona.createDataFrame(
+    [
+        (seattle, new_york),
+        (seattle, sydney),
+    ],
+    ["place1", "place2"],
+)
+```
+
+计算这些点之间的距离:
+
+```python
+df.withColumn(
+    "st_distance_sphere", ST_DistanceSphere(col("place1"), col("place2"))
+).show()
+```
+
+结果如下:
+
+```
++--------------------+--------------------+--------------------+
+|              place1|              place2|  st_distance_sphere|
++--------------------+--------------------+--------------------+
+|POINT (-122.33516...|POINT (-73.935242...|  3870075.7867602874|
+|POINT (-122.33516...| POINT (151.2 -33.9)|1.2473172370818963E7|
++--------------------+--------------------+--------------------+
+```
+
+我们使用 `ST_DistanceSphere` 计算距离,它会考虑地球的曲率,返回值的单位为米。
+
+下面看如何使用椭球(spheroid)模型计算两点之间的距离。
+
+## 使用 Spark 与 Sedona 在椭球模型上计算两点距离
+
+复用前一节的 DataFrame,但改用椭球模型:
+
+```python
+res = df.withColumn(
+    "st_distance_spheroid", ST_DistanceSpheroid(col("place1"), col("place2"))
+)
+res.select("place1_name", "place2_name", "st_distance_spheroid").show()
+```
+
+结果如下:
+
+```
++-----------+-----------+--------------------+
+|place1_name|place2_name|st_distance_spheroid|
++-----------+-----------+--------------------+
+|    seattle|   new_york|  3880173.4858397646|
+|    seattle|     sydney|1.2456531875384018E7|
++-----------+-----------+--------------------+
+```
+
+`ST_DistanceSpheroid` 返回两地之间的距离(单位:米)。在椭球模型下计算的结果与把地球建模为球时差别不大,但椭球的结果会略微更精确。
+
+## 使用 Spark 与 Sedona 计算两个几何对象之间的距离
+
+下面看看如何计算一条折线与一个多边形之间的距离。假设有以下对象:
+
+![对象之间的距离](../../image/tutorial/concepts/distance2.png)
+
+两个多边形之间的距离定义为它们之间任意两点的最小欧氏距离。
+
+计算距离:
+
+```python
+res = df.withColumn("distance", ST_Distance(col("geom1"), col("geom2")))
+```
+
+结果如下:
+
+```
++---+---+--------+
+|id1|id2|distance|
++---+---+--------+
+|a  |b  |2.0     |
++---+---+--------+
+```
+
+可以从图中直观地看出两个多边形之间的最小距离。
+
+## 三维最小笛卡尔距离
+
+下面看如何在计算两点距离时把高度(elevation)也考虑进来。
+
+我们将比较站在帝国大厦顶端的人与站在海平面的人之间的距离。
+
+构造 DataFrame:
+
+```python
+empire_state_ground = Point(-73.9857, 40.7484, 0)
+empire_state_top = Point(-73.9857, 40.7484, 380)
+df = sedona.createDataFrame(
+    [
+        (empire_state_ground, empire_state_top),
+    ],
+    ["point_a", "point_b"],
+)
+```
+
+分别计算 2D 与 3D 距离:
+
+```python
+res = df.withColumn("distance", ST_Distance(col("point_a"), col("point_b"))).withColumn(
+    "3d_distance", ST_3DDistance(col("point_a"), col("point_b"))
+)
+```
+
+结果如下:
+
+```
++--------------------+--------------------+--------+-----------+
+|             point_a|             point_b|distance|3d_distance|
++--------------------+--------------------+--------+-----------+
+|POINT (-73.9857 4...|POINT (-73.9857 4...|     0.0|      380.0|
++--------------------+--------------------+--------+-----------+
+```
+
+`ST_Distance` 不考虑高度;`ST_3DDistance` 会把高度纳入计算。
+
+## 使用 Spark 与 Sedona 计算 Frechet 距离
+
+构造一个包含以下折线的 Sedona DataFrame:
+
+![Frechet 距离](../../image/tutorial/concepts/distance3.png)
+
+```python
+a = LineString([(1, 1), (1, 3), (2, 4)])
+b = LineString([(1.1, 1), (1.1, 3), (3, 4)])
+c = LineString([(7, 1), (7, 3), (6, 4)])
+df = sedona.createDataFrame(
+    [
+        (a, "a", b, "b"),
+        (a, "a", c, "c"),
+    ],
+    ["geometry1", "geometry1_id", "geometry2", "geometry2_id"],
+)
+```
+
+计算 Frechet 距离:
+
+```python
+res = df.withColumn(
+    "frechet_distance", ST_FrechetDistance(col("geometry1"), col("geometry2"))
+)
+```
+
+查看结果:
+
+```python
+res.select("geometry1_id", "geometry2_id", "frechet_distance").show()
+```
+
+```
++------------+------------+----------------+
+|geometry1_id|geometry2_id|frechet_distance|
++------------+------------+----------------+
+|           a|           b|             1.0|
+|           a|           c|             6.0|
++------------+------------+----------------+
+```
+
+下图直观展示了这些距离,便于理解算法:
+
+![Frechet 距离](../../image/tutorial/concepts/distance4.png)
+
+## 使用 Spark 与 Sedona 计算几何对象之间的最大距离
+
+假设有以下几何对象:
+
+![几何对象之间的距离](../../image/tutorial/concepts/distance5.png)
+
+计算其中一些几何对象之间的最大距离:
+
+```python
+res = df.withColumn("max_distance", ST_MaxDistance(col("geom1"), col("geom2")))
+```
+
+查看结果:
+
+```python
+res.select("id1", "id2", "max_distance").show(truncate=False)
+```
+
+```
++---+---+-----------------+
+|id1|id2|max_distance     |
++---+---+-----------------+
+|a  |b  |8.246211251235321|
+|a  |c  |7.615773105863909|
++---+---+-----------------+
+```
+
+由此可以方便地获得两个几何对象之间的最大距离。
+
+## 结论
+
+Sedona 支持多种类型的距离计算,包括基于不同地球模型的距离,以及考虑高度等更复杂的距离运算。
+
+请根据您的分析需求选择最合适的距离函数。
diff --git a/docs/tutorial/demo.zh.md b/docs/tutorial/demo.zh.md
new file mode 100644
index 0000000000..8f6824667f
--- /dev/null
+++ b/docs/tutorial/demo.zh.md
@@ -0,0 +1,62 @@
+<!--
+ 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.
+ -->
+
+# Scala 与 Java 示例
+
+[Scala 与 Java 示例](https://github.com/apache/sedona/tree/master/examples) 中包含了 Sedona Spark(RDD、SQL 与 Viz)以及 Sedona Flink 的模板项目,且这些模板项目已经做好了适当的配置。
+
+注意:尽管这些模板项目使用 Scala 编写,相同的 API 在 Java 中同样适用。
+
+## 目录结构
+
+仓库的目录结构如下:
+
+* spark-sql:Scala 模板,演示如何使用 Sedona 的 RDD、DataFrame 与 SQL API
+* flink-sql:Java 模板,演示如何通过 Flink Table API 使用 Sedona SQL
+
+## 编译与打包
+
+### 前置条件
+
+请确保您的本机已安装以下软件:
+
+* Scala 项目:Scala 2.12
+* Java 项目:JDK 1.8、Apache Maven 3
+
+### 编译
+
+在每个模板项目目录下运行 `mvn clean package`。
+
+### 提交 fat jar 到 Spark
+
+执行上述命令后,可在 `./target` 目录中看到生成的 fat jar,使用 `./bin/spark-submit` 提交即可。
+
+如此提交需要做以下调整:
+
+* 修改模板项目中的 Spark Master 地址,或者直接删除该配置。当前模板硬编码为 `local[*]`,表示在本地以全部核心运行。
+* 将 Apache Spark 依赖的打包范围从 `compile` 改为 `provided`。这是 Maven 与 SBT 中常见的打包策略,意为不要把 Spark 一并打入 fat jar,否则可能导致 jar 体积过大并引发版本冲突。
+* 确保 build.sbt 中的依赖版本与您的 Spark 版本一致。
+
+## 在本地运行模板项目
+
+强烈建议使用 IDE 在本机运行模板项目。Scala 推荐使用安装了 Scala 插件的 IntelliJ IDEA;Java 推荐使用 IntelliJ IDEA 或 Eclipse。借助 IDE,**您无需做任何额外准备**(甚至不需要下载和搭建 Spark)!只要安装好 Scala 与 Java,一切都能正常运行。
+
+### Scala
+
+将 Scala 模板项目以 SBT 项目形式导入,然后运行其中的 Main 文件。
diff --git a/docs/tutorial/files/csv-geometry-sedona-spark.zh.md b/docs/tutorial/files/csv-geometry-sedona-spark.zh.md
new file mode 100644
index 0000000000..e3d8f931cd
--- /dev/null
+++ b/docs/tutorial/files/csv-geometry-sedona-spark.zh.md
@@ -0,0 +1,192 @@
+<!--
+ 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.
+ -->
+
+# 使用 Spark 读写带几何对象的 Apache Sedona CSV
+
+本文展示如何使用 Sedona 与 Spark 读写带几何列的 CSV 文件。
+
+您将了解 CSV 在存储几何数据时的优缺点。
+
+先看如何写出带几何数据的 CSV。
+
+## 使用 Sedona 与 Spark 写出带几何对象的 CSV
+
+先用 Sedona 与 Spark 创建一个 DataFrame:
+
+```python
+df = sedona.createDataFrame(
+    [
+        ("a", "LINESTRING(2.0 5.0,6.0 1.0)"),
+        ("b", "POINT(1.0 2.0)"),
+        ("c", "POLYGON((7.0 1.0,7.0 3.0,9.0 3.0,7.0 1.0))"),
+    ],
+    ["id", "geometry"],
+)
+df = df.withColumn("geometry", ST_GeomFromText(col("geometry")))
+```
+
+DataFrame 的内容如下:
+
+```
++---+------------------------------+
+|id |geometry                      |
++---+------------------------------+
+|a  |LINESTRING (2 5, 6 1)         |
+|b  |POINT (1 2)                   |
+|c  |POLYGON ((7 1, 7 3, 9 3, 7 1))|
++---+------------------------------+
+```
+
+将 DataFrame 写入 CSV 文件:
+
+```python
+df = df.withColumn("geom_wkt", ST_AsText(col("geometry"))).drop("geometry")
+df.repartition(1).write.option("header", True).format("csv").mode("overwrite").save(
+    "/tmp/my_csvs"
+)
+```
+
+注意这里使用 `repartition(1)` 把 DataFrame 输出为单个文件。生产环境通常更建议并行输出多个文件以提升写入速度,这里仅为示例方便。
+
+CSV 文件内容如下:
+
+```
+id,geom_wkt
+a,"LINESTRING (2 5, 6 1)"
+b,POINT (1 2)
+c,"POLYGON ((7 1, 7 3, 9 3, 7 1))"
+```
+
+`geom_wkt` 列以纯文本保存,便于人工查看;它使用标准 WKT 格式,任何能解析 WKT 的引擎都能读取该列。
+
+## 使用 Sedona 与 Spark 读取带几何对象的 CSV
+
+将 CSV 文件读回 DataFrame:
+
+```python
+df = (
+    sedona.read.option("header", True)
+    .format("CSV")
+    .load("/tmp/my_csvs")
+    .withColumn("geometry", ST_GeomFromText(col("geom_wkt")))
+    .drop("geom_wkt")
+)
+```
+
+文件中的 `geom_wkt` 列保存为文本,因此读取时需用 `ST_GeomFromText` 转换为几何列。DataFrame 的内容如下:
+
+```
++---+------------------------------+
+|id |geometry                      |
++---+------------------------------+
+|a  |LINESTRING (2 5, 6 1)         |
+|b  |POINT (1 2)                   |
+|c  |POLYGON ((7 1, 7 3, 9 3, 7 1))|
++---+------------------------------+
+```
+
+确认 schema 正确:
+
+```
+root
+ |-- id: string (nullable = true)
+ |-- geometry: geometry (nullable = true)
+```
+
+## 使用 Extended Well-Known Text(EWKT)读写 CSV
+
+下面看如何把 DataFrame 以 EWKT 写入 CSV。先给几何列设置 SRID:
+
+```python
+df = df.withColumn("geometry", ST_SetSRID(col("geometry"), 4326))
+```
+
+然后将 DataFrame 以 EWKT 列写出:
+
+```python
+df = df.withColumn("geom_ewkt", ST_AsEWKT(col("geometry"))).drop("geometry")
+df.repartition(1).write.option("header", True).format("csv").mode("overwrite").save(
+    "/tmp/my_ewkt_csvs"
+)
+```
+
+CSV 文件内容如下:
+
+```
+id,geom_ewkt
+a,"SRID=4326;LINESTRING (2 5, 6 1)"
+b,SRID=4326;POINT (1 2)
+c,"SRID=4326;POLYGON ((7 1, 7 3, 9 3, 7 1))"
+```
+
+读回带 EWKT 列的 CSV:
+
+```python
+df = (
+    sedona.read.option("header", True)
+    .format("csv")
+    .load("/tmp/my_ewkt_csvs")
+    .withColumn("geometry", ST_GeomFromEWKT(col("geom_ewkt")))
+    .drop("geom_ewkt")
+)
+```
+
+DataFrame 的内容如下:
+
+```
++---+------------------------------+
+|id |geometry                      |
++---+------------------------------+
+|a  |LINESTRING (2 5, 6 1)         |
+|b  |POINT (1 2)                   |
+|c  |POLYGON ((7 1, 7 3, 9 3, 7 1))|
++---+------------------------------+
+```
+
+打印 Sedona DataFrame 时不会显示 SRID,但该元数据已在内部保留。
+
+## CSV 用于几何数据的优势
+
+使用 CSV 存储几何数据有以下优势:
+
+* 大多数引擎都支持 CSV
+* 人工可读
+* 借助 “扩展” 格式(EWKT)可保存 CRS 信息
+* 标准经历了长期考验
+
+但 CSV 也有不少劣势。
+
+## CSV 用于几何数据的劣势
+
+将几何数据存储为 CSV 文件有以下劣势:
+
+* CSV 是行式存储,引擎在读取时无法只挑选个别列。列式格式支持的列裁剪是重要的性能特性。
+* 行式特性也使得 CSV 难以高效压缩。
+* CSV 不包含 schema,引擎要么进行 schema 推断,要么用户在读取时手动指定。schema 推断容易出错,手动指定又繁琐。
+* CSV 不存储 row group 元数据,无法跳过 row group。
+* CSV 不存储文件级元数据,无法跳过整个文件。
+* 即使保留了 SRID 元数据,也只能写在 CSV 的每一行上,由于 CSV 不支持文件级元数据,这会造成不必要的空间浪费。
+
+## 结论
+
+Spark 与 Sedona 支持以 CSV 存储几何数据,但通常较慢,建议仅在必要时使用。
+
+如果您要构建地理空间数据湖,GeoParquet 几乎总是更好的选择。
+
+如果您要构建地理空间数据湖仓(lakehouse),Iceberg 也是不错的选项。
diff --git a/docs/tutorial/files/geojson-sedona-spark.zh.md b/docs/tutorial/files/geojson-sedona-spark.zh.md
new file mode 100644
index 0000000000..2894674159
--- /dev/null
+++ b/docs/tutorial/files/geojson-sedona-spark.zh.md
@@ -0,0 +1,248 @@
+<!--
+ 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.
+ -->
+
+# 在 Spark 上使用 Apache Sedona 处理 GeoJSON
+
+本文介绍如何使用 Apache Sedona 与 Spark 读写单行 GeoJSON 与多行 GeoJSON 文件。
+
+末尾给出 GeoJSON 在空间分析中的优缺点小结。
+
+GeoJSON 基于 JSON,支持以下类型:
+
+* Point
+* LineString
+* Polygon
+* MultiPoint
+* MultiLineString
+* MultiPolygon
+
+更多关于 [GeoJSON 格式的规范](https://datatracker.ietf.org/doc/html/rfc7946) 见此处。
+
+## 使用 Sedona 与 Spark 读取多行 GeoJSON
+
+读取多行 GeoJSON 的方式如下:
+
+```python
+df = (
+    sedona.read.format("geojson")
+    .option("multiLine", "true")
+    .load("data/multiline_geojson.json")
+    .selectExpr("explode(features) as features")
+    .select("features.*")
+    .withColumn("prop0", expr("properties['prop0']"))
+    .drop("properties")
+    .drop("type")
+)
+df.show(truncate=False)
+```
+
+输出如下:
+
+```
++---------------------------------------------+------+
+|geometry                                     |prop0 |
++---------------------------------------------+------+
+|POINT (102 0.5)                              |value0|
+|LINESTRING (102 0, 103 1, 104 0, 105 1)      |value1|
+|POLYGON ((100 0, 101 0, 101 1, 100 1, 100 0))|value2|
++---------------------------------------------+------+
+```
+
+该多行 GeoJSON 文件包含一个点、一个折线和一个多边形。原始文件内容如下:
+
+```json
+{ "type": "FeatureCollection",
+    "features": [
+      { "type": "Feature",
+        "geometry": {"type": "Point", "coordinates": [102.0, 0.5]},
+        "properties": {"prop0": "value0"}
+        },
+      { "type": "Feature",
+        "geometry": {
+          "type": "LineString",
+          "coordinates": [
+            [102.0, 0.0], [103.0, 1.0], [104.0, 0.0], [105.0, 1.0]
+            ]
+          },
+        "properties": {
+          "prop0": "value1",
+          "prop1": 0.0
+          }
+        },
+      { "type": "Feature",
+         "geometry": {
+           "type": "Polygon",
+           "coordinates": [
+             [ [100.0, 0.0], [101.0, 0.0], [101.0, 1.0],
+               [100.0, 1.0], [100.0, 0.0] ]
+             ]
+         },
+         "properties": {
+           "prop0": "value2",
+           "prop1": {"this": "that"}
+           }
+         }
+       ]
+}
+```
+
+注意整体结构是一个 `FeatureCollection`,每个 feature 都有几何类型、几何坐标与属性字段。
+
+也可以一次读取多个多行 GeoJSON 文件。假设有如下目录:
+
+```
+many_geojsons/
+  file1.json
+  file2.json
+```
+
+读取方法如下:
+
+```python
+df = (
+    sedona.read.format("geojson").option("multiLine", "true").load("data/many_geojsons")
+)
+```
+
+只需把包含 JSON 文件的目录传入即可。
+
+多行 GeoJSON 对人类阅读友好,但对机器低效。建议把 JSON 数据写在单行上。
+
+## 使用 Sedona 与 Spark 读取单行 GeoJSON
+
+读取单行 GeoJSON 的方式如下:
+
+```python
+df = (
+    sedona.read.format("geojson")
+    .load("data/singleline_geojson.json")
+    .withColumn("prop0", expr("properties['prop0']"))
+    .drop("properties")
+    .drop("type")
+)
+df.show(truncate=False)
+```
+
+结果如下:
+
+```
++---------------------------------------------+------+
+|geometry                                     |prop0 |
++---------------------------------------------+------+
+|POINT (102 0.5)                              |value0|
+|LINESTRING (102 0, 103 1, 104 0, 105 1)      |value1|
+|POLYGON ((100 0, 101 0, 101 1, 100 1, 100 0))|value2|
++---------------------------------------------+------+
+```
+
+数据如下:
+
+```
+{"type":"Feature","geometry":{"type":"Point","coordinates":[102.0,0.5]},"properties":{"prop0":"value0"}}
+{"type":"Feature","geometry":{"type":"LineString","coordinates":[[102.0,0.0],[103.0,1.0],[104.0,0.0],[105.0,1.0]]},"properties":{"prop0":"value1"}}
+{"type":"Feature","geometry":{"type":"Polygon","coordinates":[[[100.0,0.0],[101.0,0.0],[101.0,1.0],[100.0,1.0],[100.0,0.0]]]},"properties":{"prop0":"value2"}}
+```
+
+可以看出:多行 GeoJSON 使用一个 `FeatureCollection`,而单行 GeoJSON 中每行是独立的 `Feature`。
+
+单行 GeoJSON 文件更优——查询引擎可以对它进行 split。
+
+下面看如何用 Sedona 通过 DataFrame 写出 GeoJSON。
+
+## 使用 Sedona 与 Spark 写出 GeoJSON
+
+创建一个 Sedona DataFrame,再写出为 GeoJSON:
+
+```
+df = sedona.createDataFrame([
+    ("a", 'LINESTRING(2.0 5.0,6.0 1.0)'),
+    ("b", 'LINESTRING(7.0 4.0,9.0 2.0)'),
+    ("c", 'LINESTRING(1.0 3.0,3.0 1.0)'),
+], ["id", "geometry"])
+actual = df.withColumn("geometry", ST_GeomFromText(col("geometry")))
+actual.write.format("geojson").mode("overwrite").save("/tmp/a_thing")
+```
+
+写出的文件如下:
+
+```
+a_thing/
+  _SUCCESS
+  part-00000-856044c5-ae35-4306-bf7a-ae9c3cb25434-c000.json
+  part-00003-856044c5-ae35-4306-bf7a-ae9c3cb25434-c000.json
+  part-00007-856044c5-ae35-4306-bf7a-ae9c3cb25434-c000.json
+  part-00011-856044c5-ae35-4306-bf7a-ae9c3cb25434-c000.json
+```
+
+Sedona 会并行写出多个 GeoJSON 文件,比写单一文件更快。
+
+注意:写出操作要求 DataFrame 至少包含一个几何类型的列。Sedona 会按以下规则确定使用哪一列作为几何列:
+
+1. 如果存在名为 “geometry” 且类型为 geometry 的列,则使用该列;
+2. 否则使用根 schema 中找到的第一个几何列。
+
+也可以通过 `geometry.column` 选项手动指定使用哪一列:
+
+```python
+df.write.format("geojson").option("geometry.column", "geometry").save("/tmp/a_thing")
+```
+
+将这些 GeoJSON 文件再读回 DataFrame:
+
+```python
+df = sedona.read.format("geojson").load("/tmp/a_thing")
+df.show(truncate=False)
+```
+
+```
++---------------------+----------+-------+
+|geometry             |properties|type   |
++---------------------+----------+-------+
+|LINESTRING (1 3, 3 1)|{c}       |Feature|
+|LINESTRING (2 5, 6 1)|{a}       |Feature|
+|LINESTRING (7 4, 9 2)|{b}       |Feature|
++---------------------+----------+-------+
+```
+
+## GeoJSON 的优势
+
+GeoJSON 格式有以下优点:
+
+* 人工可读
+* 可以并行写出多个文件,便于并行处理引擎获得更快的 I/O。
+* 大量引擎都支持 GeoJSON / JSON 文件。
+
+不过 GeoJSON 也有不少缺点,使其在存储地理空间数据时并非最佳选择。
+
+## GeoJSON 的局限
+
+GeoJSON 在空间数据湖场景下可能存在以下性能问题:
+
+* GeoJSON 对象虽然可以包含 CRS,但 CRS 是可选的,这一关键信息可能丢失。
+* 行式存储,无法享受 GeoParquet 等列式格式的列裁剪等性能优化。
+* 不存储 row group 元数据,无法进行 row-group 过滤(这是 Parquet 的一项性能优化)。
+* 文件尾部不携带 schema,需手动提供或自动推断。
+* GeoJSON 规范要求固定的结构,对某些数据集而言比较僵硬。
+* 只能用于构建数据湖,无法用于构建数据湖仓(lakehouse)。
+
+## 结论
+
+GeoJSON 在空间数据分析中很常见,Apache Sedona 提供完整的读写支持是非常方便的。
+
+GeoJSON 受到广泛支持且可读性好,但相比 GeoParquet 等格式速度较慢。一般而言,进行空间数据分析时建议优先使用 GeoParquet 或 Iceberg 以获得更好的性能。
diff --git a/docs/tutorial/files/geopackage-sedona-spark.zh.md b/docs/tutorial/files/geopackage-sedona-spark.zh.md
new file mode 100644
index 0000000000..fe7cf48775
--- /dev/null
+++ b/docs/tutorial/files/geopackage-sedona-spark.zh.md
@@ -0,0 +1,198 @@
+<!--
+ 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.
+ -->
+
+# 在 Spark 上使用 Apache Sedona 处理 GeoPackage
+
+本文介绍如何使用 Apache Sedona 与 Spark 读取 GeoPackage 文件。
+
+您将了解 GeoPackage 文件格式的优缺点,以及如何在生产环境中使用它。
+
+下面先创建一个 GeoPackage 文件,再演示读取。
+
+## 使用 Sedona 与 Spark 读取 GeoPackage 文件
+
+先创建一个包含若干行数据的 GeoPackage 文件。
+
+首先构造一个 GeoPandas DataFrame:
+
+```python
+point1 = Point(0, 0)
+point2 = Point(1, 1)
+polygon1 = Polygon([(5, 5), (6, 6), (7, 5), (6, 4)])
+
+data = {
+    "name": ["Point A", "Point B", "Polygon A"],
+    "value": [10, 20, 30],
+    "geometry": [point1, point2, polygon1],
+}
+gdf = gpd.GeoDataFrame(data, geometry="geometry")
+```
+
+将 GeoPandas DataFrame 写入 GeoPackage 文件:
+
+```python
+gdf.to_file("/tmp/my_file.gpkg", layer="my_layer", driver="GPKG")
+```
+
+代码中将 driver 设为 `GPKG`,因此 GeoPandas 会以 GeoPackage 格式写出。
+
+可以把 layer 视作表名。
+
+接下来用 Apache Sedona 与 Spark 读取这个 GeoPackage 文件:
+
+```python
+df = (
+    sedona.read.format("geopackage")
+    .option("tableName", "my_layer")
+    .load("/tmp/my_file.gpkg")
+)
+df.show()
+```
+
+DataFrame 内容如下:
+
+```
++---+--------------------+---------+-----+
+|fid|                geom|     name|value|
++---+--------------------+---------+-----+
+|  1|         POINT (0 0)|  Point A|   10|
+|  2|         POINT (1 1)|  Point B|   20|
+|  3|POLYGON ((5 5, 6 ...|Polygon A|   30|
++---+--------------------+---------+-----+
+```
+
+几何列可以包含点、多边形等多种几何对象。
+
+也可以查看 GeoPackage 文件的元数据:
+
+```python
+df = (
+    sedona.read.format("geopackage")
+    .option("showMetadata", "true")
+    .load("/tmp/my_file.gpkg")
+)
+df.show()
+```
+
+输出如下:
+
+```
++----------+---------+----------+-----------+--------------------+-----+-----+-----+-----+------+
+|table_name|data_type|identifier|description|         last_change|min_x|min_y|max_x|max_y|srs_id|
++----------+---------+----------+-----------+--------------------+-----+-----+-----+-----+------+
+|  my_layer| features|  my_layer|           |2025-02-25 06:28:...|  0.0|  0.0|  7.0|  6.0| 99999|
++----------+---------+----------+-----------+--------------------+-----+-----+-----+-----+------+
+```
+
+## 使用 Sedona 与 Spark 读取多个 GeoPackage 文件
+
+Sedona 也支持读取多个 GeoPackage 文件。假设有以下文件结构:
+
+```
+gpkgs/
+  my_file1.gpkg
+  my_file2.gpkg
+```
+
+可以这样读取所有文件:
+
+```python
+df = sedona.read.format("geopackage").option("tableName", "my_layer").load("/tmp/gpkgs")
+df.show()
+```
+
+结果如下:
+
+```
++---+--------------------+---------+-----+
+|fid|                geom|     name|value|
++---+--------------------+---------+-----+
+|  1|         POINT (5 5)|  Point C|   30|
+|  2|POLYGON ((5 5, 6 ...|Polygon A|   40|
+|  1|         POINT (0 0)|  Point A|   10|
+|  2|         POINT (1 1)|  Point B|   20|
++---+--------------------+---------+-----+
+```
+
+只需指定包含 GeoPackage 文件的目录,Sedona 即可将它们全部加载到一个 DataFrame 中。
+
+由于 Sedona 可以并行读取与处理这些文件,因此非常适合分析大量 GeoPackage 文件。
+
+## 加载 GeoPackage 中的栅格数据
+
+也可以从 GeoPackage 中的栅格表加载数据。代码如下:
+
+```python
+df = (
+    sedona.read.format("geopackage")
+    .option("tableName", "raster_table")
+    .load("/path/to/geopackage")
+)
+```
+
+DataFrame 内容如下:
+
+```
++---+----------+-----------+--------+--------------------+
+| id|zoom_level|tile_column|tile_row|           tile_data|
++---+----------+-----------+--------+--------------------+
+|  1|        11|        428|     778|GridCoverage2D["c...|
+|  2|        11|        429|     778|GridCoverage2D["c...|
+|  3|        11|        428|     779|GridCoverage2D["c...|
+|  4|        11|        429|     779|GridCoverage2D["c...|
+|  5|        11|        427|     777|GridCoverage2D["c...|
++---+----------+-----------+--------+--------------------+
+```
+
+已知限制(v1.7.0):
+
+* 不支持 webp 栅格
+* 不支持 ewkb 几何
+* 不支持基于几何包络的过滤
+
+以上限制都将在后续版本中陆续解决,敬请关注!
+
+## GeoPackage 文件格式的优势
+
+GeoPackage 格式有许多优点:
+
+* 因为是开放格式,任何引擎都可以支持。
+* 与许多其他格式不同,它是可变的。
+* 不像某些格式,它会保存 CRS 信息。
+* 既可以存储矢量数据,也可以存储栅格数据。
+* GeoPandas、Sedona、SQLite 等众多引擎都能读取。
+
+但 GeoPackage 也存在不少不足。
+
+## GeoPackage 的劣势
+
+GeoPackage 文件格式有以下劣势:
+
+* 行式存储,无法享受列式格式的列裁剪优势。
+* 不支持多引擎并发事务。
+* 虽然支持 SQLite 事务,但跨引擎可靠事务很难实现。
+* 并非所有引擎都完整支持。
+
+## 结论
+
+如果您本身在使用 SQLite,GeoPackage 是非常稳健的格式选择。
+
+Sedona 能读取由 SQLite 分析生成的 GeoPackage 文件这一点非常有价值——可以并行读取这些文件,并对海量数据进行分析;同时也可以在集群上运行 Sedona。
+
+如果您还没有使用过 GeoPackage,那么使用 GeoParquet、Iceberg 这类格式通常会是更好的选择。
diff --git a/docs/tutorial/files/geotiffmetadata-sedona-spark.zh.md b/docs/tutorial/files/geotiffmetadata-sedona-spark.zh.md
new file mode 100644
index 0000000000..2d8603fb6e
--- /dev/null
+++ b/docs/tutorial/files/geotiffmetadata-sedona-spark.zh.md
@@ -0,0 +1,186 @@
+<!--
+ 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.
+ -->
+
+# GeoTiffMetadata - GeoTIFF 文件元数据
+
+`GeoTiffMetadata` 是 Spark 数据源,用于读取 GeoTIFF 文件的元数据,而不解码像素数据,行为类似于 [gdalinfo](https://gdal.org/en/stable/programs/gdalinfo.html)。它会为每个文件返回一行,包含尺寸、坐标系、波段信息、瓦片化、概览(overview)以及压缩等元数据。
+
+适用场景:
+
+* 对大批量栅格文件进行编目与盘点
+* 通过检查瓦片化与概览状态识别 Cloud Optimized GeoTIFF(COG)
+* 在加载完整栅格数据前先检查文件属性
+* 基于栅格文件集合构建空间索引
+
+![Schema 概览](../../image/geotiff_metadata/schema_overview.svg "geotiff.metadata 输出 schema")
+
+## 检测 COG
+
+Cloud Optimized GeoTIFF(COG)是带有内部瓦片与概览结构、面向云端访问优化过的 GeoTIFF 文件。`geotiff.metadata` 数据源会直接报告这些属性:
+
+![COG 结构](../../image/geotiff_metadata/cog_structure.svg "COG 属性如何映射到 geotiff.metadata 字段")
+
+```python
+df = sedona.read.format("geotiff.metadata").load("/path/to/rasters/")
+cogs = df.filter("isTiled AND size(overviews) > 0")
+cogs.select("path", "compression", "overviews").show(truncate=False)
+```
+
+## 读取 GeoTIFF 元数据
+
+=== "Scala"
+
+    ```scala
+    val df = sedona.read.format("geotiff.metadata").load("/path/to/rasters/")
+    df.show()
+    ```
+
+=== "Java"
+
+    ```java
+    Dataset<Row> df = sedona.read().format("geotiff.metadata").load("/path/to/rasters/");
+    df.show();
+    ```
+
+=== "Python"
+
+    ```python
+    df = sedona.read.format("geotiff.metadata").load("/path/to/rasters/")
+    df.show()
+    ```
+
+也支持 glob 通配符:
+
+```python
+df = sedona.read.format("geotiff.metadata").load("/path/to/rasters/*.tif")
+```
+
+或加载单个文件:
+
+```python
+df = sedona.read.format("geotiff.metadata").load("/path/to/image.tiff")
+```
+
+## 输出 schema
+
+每行代表一个 GeoTIFF 文件,包含以下列:
+
+| 列 | 类型 | 说明 |
+|--------|------|-------------|
+| `path` | String | 文件路径 |
+| `driver` | String | 格式驱动(`"GTiff"`) |
+| `fileSize` | Long | 文件大小(字节) |
+| `width` | Int | 图像宽度(像素) |
+| `height` | Int | 图像高度(像素) |
+| `numBands` | Int | 波段数 |
+| `srid` | Int | EPSG 编号(未知时为 0) |
+| `crs` | String | 以 WKT 表示的坐标参考系 |
+| `geoTransform` | Struct | 仿射变换参数 |
+| `cornerCoordinates` | Struct | 边界框 |
+| `bands` | Array[Struct] | 每个波段的元数据 |
+| `overviews` | Array[Struct] | 概览(金字塔)层级 |
+| `metadata` | Map[String, String] | 文件级 TIFF 元数据标签 |
+| `isTiled` | Boolean | 是否使用了内部瓦片化 |
+| `compression` | String | 压缩类型(如 `"LZW"`、`"Deflate"`) |
+
+### geoTransform 结构体
+
+| 字段 | 类型 | 说明 |
+|-------|------|-------------|
+| `upperLeftX` | Double | 世界坐标系下的原点 X |
+| `upperLeftY` | Double | 世界坐标系下的原点 Y |
+| `scaleX` | Double | X 方向的像素大小 |
+| `scaleY` | Double | Y 方向的像素大小 |
+| `skewX` | Double | X 方向的旋转/剪切 |
+| `skewY` | Double | Y 方向的旋转/剪切 |
+
+### cornerCoordinates 结构体
+
+| 字段 | 类型 | 说明 |
+|-------|------|-------------|
+| `minX` | Double | X 最小值(西) |
+| `minY` | Double | Y 最小值(南) |
+| `maxX` | Double | X 最大值(东) |
+| `maxY` | Double | Y 最大值(北) |
+
+### bands 数组元素
+
+| 字段 | 类型 | 说明 |
+|-------|------|-------------|
+| `band` | Int | 波段编号(从 1 开始) |
+| `dataType` | String | 数据类型(如 `"REAL_32BITS"`) |
+| `colorInterpretation` | String | 颜色解释(如 `"Gray"`、`"Red"`) |
+| `noDataValue` | Double | NoData 值(未设置时为 null) |
+| `blockWidth` | Int | 内部 tile/block 宽度 |
+| `blockHeight` | Int | 内部 tile/block 高度 |
+| `description` | String | 波段描述 |
+| `unit` | String | 单位(如 `"meters"`) |
+
+### overviews 数组元素
+
+| 字段 | 类型 | 说明 |
+|-------|------|-------------|
+| `level` | Int | 概览层级(1, 2, 3, ...) |
+| `width` | Int | 概览宽度(像素) |
+| `height` | Int | 概览高度(像素) |
+
+## 示例
+
+### 查看波段信息
+
+```python
+df = sedona.read.format("geotiff.metadata").load("/path/to/image.tif")
+df.selectExpr("path", "explode(bands) as band").selectExpr(
+    "path",
+    "band.band",
+    "band.dataType",
+    "band.noDataValue",
+    "band.blockWidth",
+    "band.blockHeight",
+).show()
+```
+
+### 按空间范围过滤
+
+```python
+df = sedona.read.format("geotiff.metadata").load("/path/to/rasters/")
+df.filter("cornerCoordinates.minX > -120 AND cornerCoordinates.maxX < -100").select(
+    "path", "width", "height", "srid"
+).show()
+```
+
+### 获取概览详情
+
+```python
+df = sedona.read.format("geotiff.metadata").load("/path/to/image.tif")
+df.selectExpr("path", "explode(overviews) as ovr").selectExpr(
+    "path", "ovr.level", "ovr.width", "ovr.height"
+).show()
+```
+
+### 仅选取需要的列
+
+```python
+df = (
+    sedona.read.format("geotiff.metadata")
+    .load("/path/to/rasters/")
+    .select("path", "width", "height", "numBands")
+)
+df.show()
+```
diff --git a/docs/tutorial/files/shapefiles-sedona-spark.zh.md b/docs/tutorial/files/shapefiles-sedona-spark.zh.md
new file mode 100644
index 0000000000..9ff7386c05
--- /dev/null
+++ b/docs/tutorial/files/shapefiles-sedona-spark.zh.md
@@ -0,0 +1,219 @@
+<!--
+ 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.
+ -->
+
+# 在 Spark 上使用 Apache Sedona 处理 Shapefile
+
+本文介绍如何使用 Apache Sedona 与 Spark 读取 Shapefile。
+
+Shapefile 是 “Esri 矢量数据存储格式,用于存储地理要素的位置、形状与属性”。Shapefile 格式由 Esri 私有,但 [规范是公开的](https://www.esri.com/content/dam/esrisites/sitecore-archive/Files/Pdfs/library/whitepapers/pdfs/shapefile.pdf)。
+
+Shapefile 有不少限制,但仍被广泛使用,因此 Sedona 能读取它非常有价值。
+
+下面看如何用 Sedona 与 Spark 读取 Shapefile。
+
+## 使用 Sedona 与 Spark 读取 Shapefile
+
+先用 GeoPandas 与 Shapely 创建一个 Shapefile:
+
+```python
+import geopandas as gpd
+from shapely.geometry import Point
+
+point1 = Point(0, 0)
+point2 = Point(1, 1)
+
+data = {"name": ["Point A", "Point B"], "value": [10, 20], "geometry": [point1, point2]}
+
+gdf = gpd.GeoDataFrame(data, geometry="geometry")
+gdf.to_file("/tmp/my_geodata.shp")
+```
+
+输出的文件如下:
+
+```
+/tmp/
+  my_geodata.cpg
+  my_geodata.dbf
+  my_geodata.shp
+  my_geodata.shx
+```
+
+Shapefile 并不是单一文件,其数据分散在多个文件中。
+
+将 Shapefile 读入由 Spark 驱动的 Sedona DataFrame:
+
+```python
+df = sedona.read.format("shapefile").load("/tmp/my_geodata.shp")
+df.show()
+```
+
+```
++-----------+-------+-----+
+|   geometry|   name|value|
++-----------+-------+-----+
+|POINT (0 0)|Point A|   10|
+|POINT (1 1)|Point B|   20|
++-----------+-------+-----+
+```
+
+也可以一并读取每行的唯一 record number:
+
+```python
+df = (
+    sedona.read.format("shapefile")
+    .option("key.name", "FID")
+    .load("/tmp/my_geodata.shp")
+)
+```
+
+```
++-----------+---+-------+-----+
+|   geometry|FID|   name|value|
++-----------+---+-------+-----+
+|POINT (0 0)|  1|Point A|   10|
+|POINT (1 1)|  2|Point B|   20|
++-----------+---+-------+-----+
+```
+
+几何列默认名为 `geometry`。可通过 `geometry.name` 选项修改。如果某个非空间属性恰好叫 `geometry`,则必须配置 `geometry.name` 以避免冲突:
+
+```python
+df = (
+    sedona.read.format("shapefile")
+    .option("geometry.name", "geom")
+    .load("/path/to/shapefile")
+)
+```
+
+字符串属性的字符编码会从 `.cpg` 文件推断。如果字符串字段出现乱码,可以通过 `charset` 选项手动指定正确的字符集,例如:
+
+=== "Scala/Java"
+
+    ```scala
+    val df = sedona.read.format("shapefile").option("charset", "UTF-8").load("/path/to/shapefile")
+    ```
+
+=== "Java"
+
+    ```java
+    Dataset<Row> df = sedona.read().format("shapefile").option("charset", "UTF-8").load("/path/to/shapefile")
+    ```
+
+=== "Python"
+
+    ```python
+    df = (
+        sedona.read.format("shapefile")
+        .option("charset", "UTF-8")
+        .load("/path/to/shapefile")
+    )
+    ```
+
+下面看如何在 Sedona DataFrame 中加载多个 Shapefile。
+
+## 使用 Sedona 加载多个 Shapefile
+
+假设有如下目录结构:
+
+```
+/tmp/shapefiles/
+  file1.cpg
+  file1.dbf
+  file1.shp
+  file1.shx
+  file2.cpg
+  file2.dbf
+  file2.shp
+  file2.shx
+```
+
+目录中包含 2 个 `.shp` 以及对应的辅助文件。
+
+可以这样把多个 Shapefile 加载到 Sedona DataFrame 中:
+
+```python
+df = sedona.read.format("shapefile").load("/tmp/shapefiles")
+df.show()
+```
+
+```
++-----------+-------+-----+
+|   geometry|   name|value|
++-----------+-------+-----+
+|POINT (0 0)|Point A|   10|
+|POINT (1 1)|Point B|   20|
+|POINT (2 2)|Point C|   10|
+|POINT (3 3)|Point D|   20|
++-----------+-------+-----+
+```
+
+只需将 Shapefile 所在目录传入,Sedona 即可识别加载。
+
+输入路径既可以是包含一个或多个 Shapefile 的目录,也可以是 `.shp` 文件本身:
+
+* 输入是目录时,会加载该目录下直接存在的所有 Shapefile。如果还需要加载子目录中的 Shapefile,请加上 `.option("recursiveFileLookup", "true")`。
+* 输入是 `.shp` 文件时,Sedona 会自动查找同名的 `.dbf`、`.shx` 等同伴文件并一并加载。
+
+## Shapefile 的优势
+
+Shapefile 与 Esri 生态深度集成,并被大量服务广泛使用。
+
+可以从 Esri 输出 Shapefile,再用 Sedona 等其他引擎读取。
+
+不过 Esri 在上世纪 90 年代初创建了 Shapefile 格式,因此存在不少局限。
+
+## Shapefile 的限制
+
+Shapefile 的部分缺点包括:
+
+* 不支持复杂几何类型
+* 不支持 NULL 值
+* 会对数字进行四舍五入
+* 对 Unicode 支持较差
+* 字段名不能太长
+* 单文件大小限制为 2GB
+* 空间索引相比其他方案较慢
+* 无法存储日期时间
+
+更多关于 [Shapefile 局限性的资料](http://switchfromshapefile.org/) 见此页。
+
+由于这些限制,建议考虑其他更现代的格式。
+
+## Shapefile 的替代方案
+
+适合存储几何数据的格式有很多:
+
+* Iceberg
+* [GeoParquet](geoparquet-sedona-spark.md)
+* FlatGeoBuf
+* [GeoPackage](geopackage-sedona-spark.md)
+* [GeoJSON](geojson-sedona-spark.md)
+* [CSV](csv-geometry-sedona-spark.md)
+* GeoTIFF
+
+## 为什么 Sedona 不支持写出 Shapefile
+
+Sedona 不写出 Shapefile 主要有两个原因:
+
+1. 每个 Shapefile 由多个文件组成,对分布式系统来说写出比较困难。
+2. Shapefile 单文件 2GB 的硬限制对一些空间数据来说不够用。
+
+## 结论
+
+Shapefile 是仍在许多生产应用中使用的遗留格式。但其限制颇多,除非需要兼容旧系统,否则在现代数据管道中并不是最佳选择。
diff --git a/docs/tutorial/flink/pyflink-sql.zh.md b/docs/tutorial/flink/pyflink-sql.zh.md
new file mode 100644
index 0000000000..e06d476feb
--- /dev/null
+++ b/docs/tutorial/flink/pyflink-sql.zh.md
@@ -0,0 +1,72 @@
+<!--
+ 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.
+ -->
+
+要在 Apache Sedona 中配置 PyFlink,请先按 [PyFlink](../../setup/flink/install-python.md) 指南完成安装。
+完成后,可以运行下面的代码以验证环境是否正常工作。
+
+```python
+from sedona.flink import SedonaContext
+from pyflink.datastream import StreamExecutionEnvironment
+from pyflink.table import EnvironmentSettings, StreamTableEnvironment
+
+stream_env = StreamExecutionEnvironment.get_execution_environment()
+flink_settings = EnvironmentSettings.in_streaming_mode()
+table_env = SedonaContext.create(stream_env, flink_settings)
+
+table_env.sql_query("SELECT ST_Point(1.0, 2.0)").execute()
+```
+
+PyFlink 不支持把 Scala 自定义类型(UDT)转换为 Python UDT。
+因此,如果想在 Python 中收集结果,需要使用 `ST_AsText` 或 `ST_ASBinary` 等函数把结果转换为字符串或二进制。
+
+```python
+from shapely.wkb import loads
+
+table_env.sql_query("SELECT ST_ASBinary(ST_Point(1.0, 2.0))").execute().collect()
+
+[loads(bytes(el[0])) for el in result]
+```
+
+```
+[<POINT (1 2)>]
+```
+
+用户自定义标量函数(UDF)也是类似的处理方式:
+
+```python
+from pyflink.table.udf import ScalarFunction, udf
+from shapely.wkb import loads
+
+
+class Buffer(ScalarFunction):
+    def eval(self, s):
+        geom = loads(s)
+        return geom.buffer(1).wkb
+
+
+table_env.create_temporary_function(
+    "ST_BufferPython", udf(Buffer(), result_type="Binary")
+)
+
+buffer_table = table_env.sql_query(
+    "SELECT ST_BufferPython(ST_ASBinary(ST_Point(1.0, 2.0))) AS buffer"
+)
+```
+
+更多 SQL 示例请参阅 FlinkSQL 章节:[FlinkSQL](sql.md)。
diff --git a/docs/tutorial/jupyter-notebook.zh.md b/docs/tutorial/jupyter-notebook.zh.md
new file mode 100644
index 0000000000..d727045da5
--- /dev/null
+++ b/docs/tutorial/jupyter-notebook.zh.md
@@ -0,0 +1,58 @@
+<!--
+ 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.
+ -->
+
+# Python Jupyter Notebook 示例
+
+Sedona Python 提供了一系列 [Jupyter Notebook 示例](https://github.com/apache/sedona/blob/master/docs/usecases/)。
+
+请按以下步骤使用 Pipenv 在本机运行 Jupyter Notebook:
+
+1. 克隆 Sedona GitHub 仓库或下载源代码
+2. 从 PyPI 或 GitHub 源码安装 Sedona Python:参考 [安装 Sedona Python](../setup/install-python.md#install-sedona)。
+3. 准备 spark-shaded jar:参考 [安装 Sedona Python](../setup/install-python.md#prepare-sedona-spark-jar)。
+4. 设置 Pipenv 的 Python 版本(请使用您所需的 Python 版本):
+
+```bash
+cd docs/usecases
+pipenv --python 3.8
+```
+
+5. 安装依赖:
+
+```bash
+cd docs/usecases
+pipenv install
+```
+
+6. 在 Pipenv 中安装 Jupyter Notebook 内核:
+
+```bash
+pipenv install ipykernel
+pipenv shell
+```
+
+7. 在 Pipenv shell 中执行:
+
+```bash
+python -m ipykernel install --user --name=apache-sedona
+```
+
+8. 如果之前未配置过,请设置环境变量 `SPARK_HOME` 与 `PYTHONPATH`,参考 [安装 Sedona Python](../setup/install-python.md/#setup-environment-variables)。
+9. 启动 Jupyter Notebook:`jupyter notebook`
+10. 选择 Sedona notebook,在 notebook 中依次选择 Kernel -> Change Kernel,选择刚才注册的内核。
diff --git a/docs/tutorial/sql-pure-sql.zh.md b/docs/tutorial/sql-pure-sql.zh.md
new file mode 100644
index 0000000000..de4b9b6dc3
--- /dev/null
+++ b/docs/tutorial/sql-pure-sql.zh.md
@@ -0,0 +1,101 @@
+<!--
+ 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.
+ -->
+
+从 ==Sedona v1.0.1== 开始,您可以在纯 Spark SQL 环境中使用 Sedona,示例代码均以 SQL 编写。
+
+SedonaSQL 支持 SQL/MM Part3 空间 SQL 标准。SedonaSQL 详细的 API 说明请参阅 [SedonaSQL API](../api/sql/Overview.md)。
+
+## 启动会话
+
+按以下方式启动 `spark-sql`(请将 `<VERSION>` 替换为实际版本,如 `{{ sedona.current_version }}`):
+
+!!! abstract "使用 Apache Sedona 启动 spark-sql"
+
+	=== "Spark 3.3+ 与 Scala 2.12"
+
+        ```sh
+        spark-sql --packages org.apache.sedona:sedona-spark-shaded-3.3_2.12:<VERSION>,org.datasyslab:geotools-wrapper:{{ sedona.current_geotools }} \
+          --conf spark.serializer=org.apache.spark.serializer.KryoSerializer \
+          --conf spark.kryo.registrator=org.apache.sedona.viz.core.Serde.SedonaVizKryoRegistrator \
+          --conf spark.sql.extensions=org.apache.sedona.viz.sql.SedonaVizExtensions,org.apache.sedona.sql.SedonaSqlExtensions
+        ```
+
+        请将 artifact 名称中的 `3.3` 替换为对应的 Spark major.minor 版本。
+
+这会注册 SedonaSQL 与 SedonaViz 的全部类型、函数与优化规则。
+
+## 加载数据
+
+下面使用 `examples/sql` 目录中的数据。从 CSV 文件加载数据需要执行以下两条命令:
+
+使用以下代码加载数据并创建原始 DataFrame:
+
+```sql
+CREATE TABLE IF NOT EXISTS pointraw (_c0 string, _c1 string)
+USING csv
+OPTIONS(header='false')
+LOCATION '<some path>/sedona/examples/sql/src/test/resources/testpoint.csv';
+
+CREATE TABLE IF NOT EXISTS polygonraw (_c0 string, _c1 string, _c2 string, _c3 string)
+USING csv
+OPTIONS(header='false')
+LOCATION '<some path>/sedona/examples/sql/src/test/resources/testenvelope.csv';
+
+```
+
+## 转换数据
+
+需要把点和多边形数据转换为对应的几何类型:
+
+```sql
+CREATE OR REPLACE TEMP VIEW pointdata AS
+  SELECT ST_Point(cast(pointraw._c0 as Decimal(24,20)), cast(pointraw._c1 as Decimal(24,20))) AS pointshape
+  FROM pointraw;
+
+CREATE OR REPLACE TEMP VIEW polygondata AS
+  select ST_PolygonFromEnvelope(cast(polygonraw._c0 as Decimal(24,20)),
+        cast(polygonraw._c1 as Decimal(24,20)), cast(polygonraw._c2 as Decimal(24,20)),
+        cast(polygonraw._c3 as Decimal(24,20))) AS polygonshape
+  FROM polygonraw;
+```
+
+## 处理数据
+
+例如,对多边形和点数据做一次连接:
+
+```sql
+SELECT * from polygondata, pointdata
+WHERE ST_Contains(polygondata.polygonshape, pointdata.pointshape)
+      AND ST_Contains(ST_PolygonFromEnvelope(1.0,101.0,501.0,601.0), polygondata.polygonshape)
+LIMIT 5;
+```
+
+## `GEOMETRY` 数据类型支持
+
+Sedona 提供了一个 Spark SQL 解析器扩展,使 DDL 语句中可以直接使用 `GEOMETRY` 数据类型。例如,可以在创建表时声明带几何列的 schema:
+
+```sql
+CREATE TABLE geom_table (id STRING, version INT, geometry GEOMETRY)
+USING geoparquet
+LOCATION '/path/to/geoparquet_geom_table';
+
+SELECT * FROM geom_table LIMIT 10;
+```
+
+该 SQL 解析器扩展默认启用。如果它与其他扩展存在冲突需要禁用,请在启动 `spark-sql` 时通过 `--conf spark.sedona.enableParserExtension=false` 关闭。
diff --git a/docs/tutorial/storing-blobs-in-parquet.zh.md b/docs/tutorial/storing-blobs-in-parquet.zh.md
new file mode 100644
index 0000000000..50a01b6564
--- /dev/null
+++ b/docs/tutorial/storing-blobs-in-parquet.zh.md
@@ -0,0 +1,67 @@
+<!--
+ 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.
+ -->
+
+# 在 Parquet 文件中存储大型栅格几何对象
+
+!!!warning
+    在保存栅格几何对象之前,务必先用 `RS_AsXXX` 函数将其转换为公认的标准格式。
+    虽然可以保存栅格几何对象的原始字节,但这是 Sedona 的内部格式,不保证跨版本稳定。
+
+Spark 的默认设置并不适合存储栅格几何对象这类大型二进制数据。
+为此投入时间调优和基准测试是非常值得的。
+使用默认设置写入大型二进制数据会得到结构很差、读取代价非常高的 Parquet 文件。
+做一些基本调优可以让读取性能提升数个数量级。
+
+## 背景
+
+Parquet 文件被划分为一个或多个 row group。
+每个 row group 中的每一列存储为一个 column chunk,
+每个 column chunk 又进一步划分为 page。
+page 在压缩与编码层面是不可分割的最小单位,默认大小为 1 MB。
+数据先在内存中缓冲,写满 page 后再落盘写入。
+对 page 大小的检查频率介于 `parquet.page.size.row.check.min` 与 `parquet.page.size.row.check.max` 之间(默认在 100 到 10000 行之间)。
+
+如果您按默认设置将 5 MB 的图像文件写入 Parquet,第一次 page 大小检查会在 100 行后才发生。
+这样得到的 page 会是 500 MB 而非 1 MB。
+读取这种文件会消耗大量内存,速度也会很慢。
+
+## 读取结构不佳的 Parquet 文件
+
+snappy 压缩对超大 page 尤为敏感。
+更合适的选择是不压缩或使用 zstd 压缩。
+您可以将 `spark.buffer.size` 设置为大于默认 64k 的值以提升读取性能。
+不过调大 `spark.buffer.size` 可能会让 Parquet 文件中的其他列承担额外的 I/O 开销。
+
+## 为大块二进制数据写出结构更佳的 Parquet 文件
+
+理想情况下,您希望以合理的 page 大小写出 Parquet 文件,从而在不同客户端读取时都能获得更好且更一致的性能。
+自 parquet-hadoop 1.12.0 起(Spark 3.2 内置该版本),可以通过 Hadoop 属性来控制 page 大小检查。
+更适合写大块数据的设置如下:
+
+```
+spark.sql.parquet.compression.codec=zstd
+spark.hadoop.parquet.page.size.row.check.min=2
+spark.hadoop.parquet.page.size.row.check.max=10
+```
+
+整体上 zstd 比 snappy 表现更好,对于大型 page 更是如此。
+第一次 page 大小检查会在 2 行后进行;如果 2 行后 page 仍未写满,下一次检查会在再写 2 到 10 行后发生(具体取决于已写入两行的字节数)。
+
+Spark 会把以 “spark.hadoop.” 为前缀的 Spark 属性映射成 Hadoop 属性。
+完整的 Parquet Hadoop 属性列表请参考:https://github.com/apache/parquet-mr/blob/master/parquet-hadoop/README.md
diff --git a/docs/tutorial/viz-gallery.zh.md b/docs/tutorial/viz-gallery.zh.md
new file mode 100644
index 0000000000..7c027dfffe
--- /dev/null
+++ b/docs/tutorial/viz-gallery.zh.md
@@ -0,0 +1,24 @@
+<!--
+ 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.
+ -->
+
+![美国铁路](../image/usrail.png)
+
+![美国推文](../image/ustweet.png)
+
+![纽约市热力图](../image/heatmapnycsmall.png)
diff --git a/docs/tutorial/viz.zh.md b/docs/tutorial/viz.zh.md
new file mode 100644
index 0000000000..e985f1db02
--- /dev/null
+++ b/docs/tutorial/viz.zh.md
@@ -0,0 +1,247 @@
+<!--
+ 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.
+ -->
+
+本页介绍如何使用 SedonaViz 可视化空间数据。==示例代码使用 Scala 编写,但同样适用于 Java==。
+
+SedonaViz 通过对 Sedona 处理大规模空间数据的能力进行扩展,原生支持通用的地图制图设计。它可以可视化空间 RDD 与空间查询,并以并行方式渲染超高分辨率图像。
+
+SedonaViz 提供了 Map Visualization SQL,使用户能更灵活地设计美观的地图可视化效果,包括散点图与热力图。同时也提供 SedonaViz RDD API。
+
+!!!note
+	SedonaViz 的 SQL/DataFrame API 全部说明请参阅 [SedonaViz API](../api/viz/sql.md)。
+
+## 为什么需要可扩展的地图可视化
+
+数据可视化让用户能够对数据进行总结、分析与推理。要在多个缩放级别上保证细致而准确的地理空间地图可视化,需要极高分辨率的地图。Google Maps、MapBox、ArcGIS 等传统方案受计算资源限制,对大规模地理空间数据生成地图需要花费大量时间。在大空间数据场景下,这类工具往往直接崩溃或长时间无法完成。
+
+SedonaViz 把地图可视化流程的主要步骤(如像素化、聚合、渲染)封装为一组可大规模并行的 GeoViz 算子,用户可以自由组合任意自定义样式。
+
+## 可视化 SpatialRDD
+
+本教程主要介绍 SQL/DataFrame API。
+
+## 配置依赖
+
+1. 阅读 [Sedona Maven Central 坐标](../setup/maven-coordinates.md)
+2. 添加 [Apache Spark core](https://mvnrepository.com/artifact/org.apache.spark/spark-core_2.11)、[Apache SparkSQL](https://mvnrepository.com/artifact/org.apache.spark/spark-sql)、Sedona-core、Sedona-SQL、Sedona-Viz 依赖
+
+## 创建 Sedona 配置
+
+在程序开头使用以下代码创建 Sedona 配置。如果您已经有了由 Wherobots / AWS EMR / Databricks 创建的 SparkSession(通常名为 `spark`),可跳过此步骤直接使用 `spark`。
+
+==Sedona >= 1.4.1===
+
+```scala
+val config = SedonaContext.builder()
+		.config("spark.kryo.registrator", classOf[SedonaVizKryoRegistrator].getName) // org.apache.sedona.viz.core.Serde.SedonaVizKryoRegistrator
+		.master("local[*]") // 集群模式下请删除此行
+		.appName("Sedona Viz") // 改成合适的名字
+		.getOrCreate()
+```
+
+==Sedona <1.4.1==
+
+下面这种方式自 Sedona 1.4.1 起已弃用,请改用上面的方式。
+
+```scala
+var sparkSession = SparkSession.builder()
+.master("local[*]") // 集群模式下请删除此行
+.appName("Sedona Viz") // 改成合适的名字
+// 启用 Sedona 自定义 Kryo 序列化器
+.config("spark.serializer", classOf[KryoSerializer].getName) // org.apache.spark.serializer.KryoSerializer
+.config("spark.kryo.registrator", classOf[SedonaVizKryoRegistrator].getName) // org.apache.sedona.viz.core.Serde.SedonaVizKryoRegistrator
+.getOrCreate()
+```
+
+## 初始化 SedonaContext
+
+在创建 Sedona 配置之后加上以下代码。如果您已经有了由 Wherobots / AWS EMR / Databricks 创建的 SparkSession(通常名为 `spark`),请改为调用 `SedonaContext.create(spark)`。
+
+==Sedona >= 1.4.1===
+
+```scala
+val sedona = SedonaContext.create(config)
+SedonaVizRegistrator.registerAll(sedona)
+```
+
+==Sedona <1.4.1==
+
+下面这种方式自 Sedona 1.4.1 起已弃用,请改用上面的方式创建 SedonaContext。
+
+```scala
+SedonaSQLRegistrator.registerAll(sparkSession)
+SedonaVizRegistrator.registerAll(sparkSession)
+```
+
+也可以通过在 `spark-submit` 或 `spark-shell` 中传入 `--conf spark.sql.extensions=org.apache.sedona.viz.sql.SedonaVizExtensions,org.apache.sedona.sql.SedonaSqlExtensions` 来一并注册。
+
+## 创建空间 DataFrame
+
+假设有如下 DataFrame:
+
+```
++----------+---------+
+|       _c0|      _c1|
++----------+---------+
+|-88.331492|32.324142|
+|-88.175933|32.360763|
+|-88.388954|32.357073|
+|-88.221102| 32.35078|
+```
+
+首先需要构造一列几何类型的列:
+
+```sql
+CREATE OR REPLACE TEMP VIEW pointtable AS
+SELECT ST_Point(cast(pointtable._c0 as Decimal(24,20)),cast(pointtable._c1 as Decimal(24,20))) as shape
+FROM pointtable
+```
+
+Sedona 提供了多种方式加载各种空间数据格式,详见 [编写空间 DataFrame 应用](sql.md)。
+
+## 生成单张图像
+
+大多数情况下,您只想从空间数据中得到一张图像。
+
+### 像素化空间对象
+
+要在地图图像上显示空间对象,先要把它们转换为像素。
+
+首先计算该列的空间边界:
+
+```sql
+CREATE OR REPLACE TEMP VIEW boundtable AS
+SELECT ST_Envelope_Aggr(shape) as bound FROM pointtable
+```
+
+然后用 ST_Pixelize 将其转换为像素。
+
+下面这段代码适用于 Sedona v1.0.1 之前。`ST_Pixelize` 继承自 Generator,因此可以直接展开数组而无需 **explode** 函数。
+
+```sql
+CREATE OR REPLACE TEMP VIEW pixels AS
+SELECT pixel, shape FROM pointtable
+LATERAL VIEW ST_Pixelize(ST_Transform(shape, 'epsg:4326','epsg:3857'), 256, 256, (SELECT ST_Transform(bound, 'epsg:4326','epsg:3857') FROM boundtable)) AS pixel
+```
+
+下面这段代码适用于 Sedona v1.0.1 及之后。`ST_Pixelize` 返回像素数组,需要使用 **explode** 展开:
+
+```sql
+CREATE OR REPLACE TEMP VIEW pixels AS
+SELECT pixel, shape FROM pointtable
+LATERAL VIEW explode(ST_Pixelize(ST_Transform(shape, 'epsg:4326','epsg:3857'), 256, 256, (SELECT ST_Transform(bound, 'epsg:4326','epsg:3857') FROM boundtable))) AS pixel
+```
+
+执行完本教程末尾的 `ST_Render` 后,将得到 256*256 分辨率的图像。
+
+!!!warning
+	强烈建议先用 `ST_Transform` 将坐标转换到适合可视化的坐标系(如 epsg:3857),否则地图可能出现变形。
+
+### 聚合像素
+
+许多对象可能被像素化到同一个像素位置。需要按空间聚合或按温度、湿度等空间观测值进行聚合:
+
+```sql
+CREATE OR REPLACE TEMP VIEW pixelaggregates AS
+SELECT pixel, count(*) as weight
+FROM pixels
+GROUP BY pixel
+```
+
+`weight` 表示空间聚合或空间观测的程度,后续会决定该像素的颜色。
+
+### 给像素上色
+
+运行以下命令为像素根据 weight 上色:
+
+```sql
+CREATE OR REPLACE TEMP VIEW pixelaggregates AS
+SELECT pixel, ST_Colorize(weight, (SELECT max(weight) FROM pixelaggregates)) as color
+FROM pixelaggregates
+```
+
+详细 API 说明请参阅 [ST_Colorize](../api/viz/sql.md#st_colorize)。
+
+### 渲染图像
+
+使用 `ST_Render` 把所有像素绘制到一张图像上:
+
+```sql
+CREATE OR REPLACE TEMP VIEW images AS
+SELECT ST_Render(pixel, color) AS image, (SELECT ST_AsText(bound) FROM boundtable) AS boundary
+FROM pixelaggregates
+```
+
+该 DataFrame 中将包含一列 Image 类型的列,且只有一张图像。
+
+### 将图像保存到磁盘
+
+从上面的 DataFrame 中取出图像:
+
+```
+var image = sedona.table("images").take(1)(0)(0).asInstanceOf[ImageSerializableWrapper].getImage
+```
+
+使用 Sedona Viz 的 `ImageGenerator` 把图像保存到磁盘:
+
+```scala
+var imageGenerator = new ImageGenerator
+imageGenerator.SaveRasterImageAsLocalFile(image, System.getProperty("user.dir")+"/target/points", ImageType.PNG)
+```
+
+## 生成地图瓦片
+
+如果您是地图相关从业者,可能需要为不同缩放级别生成地图瓦片,最终构建出地图瓦片图层。
+
+### 像素化与像素聚合
+
+请先用与单张图像生成相同的命令完成像素化与像素聚合。在 `ST_Pixelize` 中需要指定较高的分辨率,例如 1000*1000。注意:每个维度都应能被 2^zoom-level 整除。
+
+### 计算 tile name
+
+使用以下命令为每个像素计算 tile name:
+
+```sql
+CREATE OR REPLACE TEMP VIEW pixelaggregates AS
+SELECT pixel, weight, ST_TileName(pixel, 3) AS pid
+FROM pixelaggregates
+```
+
+其中 `3` 表示这些地图瓦片的缩放级别。
+
+### 像素上色
+
+使用与单张图像生成相同的命令进行上色。
+
+### 渲染地图瓦片
+
+把像素按 tile 分组,然后并行渲染各个瓦片图像:
+
+```sql
+CREATE OR REPLACE TEMP VIEW images AS
+SELECT ST_Render(pixel, color, 3) AS image
+FROM pixelaggregates
+GROUP BY pid
+```
+
+`3` 是这些地图瓦片的缩放级别。
+
+### 将地图瓦片保存到磁盘
+
+可以沿用单张图像生成中的命令,将所有地图瓦片逐一取出并保存。
diff --git a/docs/tutorial/zeppelin.zh.md b/docs/tutorial/zeppelin.zh.md
new file mode 100644
index 0000000000..8e8f70b3b7
--- /dev/null
+++ b/docs/tutorial/zeppelin.zh.md
@@ -0,0 +1,85 @@
+<!--
+ 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.
+ -->
+
+Sedona 提供了一个为 [Apache Zeppelin](https://zeppelin.apache.org/) 量身定制的 Helium 可视化插件,最终弥合了 Sedona 与 Zeppelin 之间的鸿沟。安装方法请参阅 [安装 Sedona-Zeppelin](../setup/zeppelin.md)。
+
+Sedona-Zeppelin 提供了两种在 Zeppelin 中可视化空间数据的方式。第一种方式使用 Zeppelin 在地图上绘制所有空间对象;第二种方式利用 SedonaViz 生成地图图像并叠加到地图上。
+
+## 小规模数据:不使用 SedonaViz
+
+!!! danger
+	Zeppelin 只是一个前端可视化框架,本方式不具备扩展性,对于大规模地理空间数据会失败。请向下阅读 SedonaViz 方案。
+
+可以使用 Apache Zeppelin 绘制少量空间对象,例如 1000 个点。假设您已经有一个空间 DataFrame,需要在 Zeppelin 的 Spark notebook 中通过 Scala paragraph 将几何列转换为 WKT 字符串列:
+
+```scala
+spark.sql(
+  """
+    |CREATE OR REPLACE TEMP VIEW wktpoint AS
+    |SELECT ST_AsText(shape) as geom
+    |FROM pointtable
+  """.stripMargin)
+```
+
+然后再创建一个 SQL paragraph 拉取数据:
+
+```sql
+%sql
+SELECT *
+FROM wktpoint
+```
+
+选择要可视化的几何列:
+
+![创建 SQL paragraph 并选择几何列](../image/sql-zeppelin.gif)
+
+## 大规模数据:使用 SedonaViz
+
+SedonaViz 是一个分布式可视化系统,能够大规模地可视化空间数据。请阅读 [如何使用 SedonaViz](viz.md)。
+
+可以借助 Sedona-Zeppelin 让 Zeppelin 把 SedonaViz 的图像叠加到地图上,从而轻松可视化 10 亿乃至更多的空间对象(取决于集群规模)。
+
+首先,在 Zeppelin Spark notebook 的 Scala paragraph 中对 SedonaViz DataFrame 中的图像进行编码:
+
+```
+spark.sql(
+  """
+    |CREATE OR REPLACE TEMP VIEW images AS
+    |SELECT ST_EncodeImage(image) AS image, (SELECT ST_AsText(bound) FROM boundtable) AS boundary
+    |FROM images
+  """.stripMargin)
+```
+
+然后创建 SQL paragraph 拉取数据:
+
+```sql
+%sql
+SELECT *, 'I am the map center!'
+FROM images
+```
+
+选择图像与对应的地理边界:
+
+![选择图像与边界](../image/viz-zeppelin.gif)
+
+## Zeppelin Spark notebook 演示
+
+我们提供了一个完整的 Zeppelin Spark notebook,演示了所有功能。请下载 [Sedona-Zeppelin notebook 模板](../image/geospark-zeppelin-demo.json) 与 [测试数据 - arealm.csv](../image/arealm.csv)。
+
+需要在 Zeppelin 中导入该 notebook JSON 文件,并修改 notebook 中的输入数据路径。


(sedona) 12/12: [GH-2867] Translate Stats, Viz, and SQL overview pages to Chinese (#2947)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 3f1023526f4a13dcaba58d4790be6fa9f2f06fd8
Author: Jia Yu <ji...@apache.org>
AuthorDate: Sun May 10 21:13:31 2026 -0700

    [GH-2867] Translate Stats, Viz, and SQL overview pages to Chinese (#2947)
    
    (cherry picked from commit 218a4e70fd47a6f6f3139e20dc4fd62cb281315a)
---
 docs/api/sql/CRS-Transformation.zh.md           | 451 ++++++++++++++++++++++++
 docs/api/sql/DataFrameAPI.zh.md                 |  98 +++++
 docs/api/sql/NearestNeighbourSearching.zh.md    | 203 +++++++++++
 docs/api/sql/Optimizer.zh.md                    | 418 ++++++++++++++++++++++
 docs/api/sql/Overview.zh.md                     |  97 +++++
 docs/api/sql/Parameter.zh.md                    |  84 +++++
 docs/api/sql/Raster-affine-transformation.zh.md |  85 +++++
 docs/api/sql/Raster-map-algebra.zh.md           | 145 ++++++++
 docs/api/sql/Reading-legacy-parquet.zh.md       |  72 ++++
 docs/api/sql/Spider.zh.md                       | 322 +++++++++++++++++
 docs/api/sql/Visualization-SedonaKepler.zh.md   |  96 +++++
 docs/api/sql/Visualization-SedonaPyDeck.zh.md   | 161 +++++++++
 docs/api/stats/sql.zh.md                        | 244 +++++++++++++
 docs/api/viz/java-api.zh.md                     |  22 ++
 docs/api/viz/sql.zh.md                          | 161 +++++++++
 15 files changed, 2659 insertions(+)

diff --git a/docs/api/sql/CRS-Transformation.zh.md b/docs/api/sql/CRS-Transformation.zh.md
new file mode 100644
index 0000000000..b8d4d28f3c
--- /dev/null
+++ b/docs/api/sql/CRS-Transformation.zh.md
@@ -0,0 +1,451 @@
+<!--
+ 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.
+ -->
+
+# CRS 转换
+
+Sedona 通过 `ST_Transform` 函数提供坐标参考系(CRS)转换功能。自 v1.9.0 起,Sedona 使用 proj4sedona 库 —— 一个纯 Java 实现,支持多种 CRS 输入格式以及基于网格的转换。
+
+## 支持的 CRS 格式
+
+Sedona 支持以下用于指定源 CRS 与目标 CRS 的格式:
+
+### 权威机构代码(Authority Code)
+
+最常见的指定 CRS 的方式是使用形如 `AUTHORITY:CODE` 的权威机构代码。Sedona 使用 [spatialreference.org](https://spatialreference.org/projjson_index.json) 作为开源的 CRS 数据库,支持多个权威机构:
+
+| Authority | 说明 | 示例 |
+|-----------|-------------|---------|
+| EPSG | European Petroleum Survey Group | `EPSG:4326`, `EPSG:3857` |
+| ESRI | Esri 坐标系 | `ESRI:102008`, `ESRI:54012` |
+| IAU | International Astronomical Union(行星 CRS) | `IAU:30100` |
+| SR-ORG | 用户贡献的定义 | `SR-ORG:6864` |
+
+```sql
+-- Transform from WGS84 (EPSG:4326) to Web Mercator (EPSG:3857)
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    'EPSG:4326',
+    'EPSG:3857'
+) AS transformed_point
+```
+
+输出:
+
+```
+POINT (-13627665.271218014 4548257.702387721)
+```
+
+```sql
+-- Transform using ESRI authority code (North America Albers Equal Area Conic)
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    'EPSG:4326',
+    'ESRI:102008'
+) AS transformed_point
+```
+
+```sql
+-- Transform from WGS84 to UTM Zone 10N (EPSG:32610)
+SELECT ST_Transform(
+    ST_GeomFromText('POLYGON((-122.5 37.5, -122.5 38.0, -122.0 38.0, -122.0 37.5, -122.5 37.5))'),
+    'EPSG:4326',
+    'EPSG:32610'
+) AS transformed_polygon
+```
+
+你可以在 [spatialreference.org](https://spatialreference.org/projjson_index.json) 或 [EPSG.io](https://epsg.io/) 上浏览可用的 CRS 代码。
+
+### WKT1(OGC Well-Known Text)
+
+WKT1 是 OGC 提供的 CRS 定义的 Well-Known Text 格式。投影 CRS 以 `PROJCS[...]` 开头,地理 CRS 以 `GEOGCS[...]` 开头。
+
+```sql
+-- Transform using WKT1 format for target CRS
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    'EPSG:4326',
+    'PROJCS["WGS 84 / Pseudo-Mercator",
+        GEOGCS["WGS 84",
+            DATUM["WGS_1984",
+                SPHEROID["WGS 84",6378137,298.257223563]],
+            PRIMEM["Greenwich",0],
+            UNIT["degree",0.0174532925199433]],
+        PROJECTION["Mercator_1SP"],
+        PARAMETER["central_meridian",0],
+        PARAMETER["scale_factor",1],
+        PARAMETER["false_easting",0],
+        PARAMETER["false_northing",0],
+        UNIT["metre",1],
+        AUTHORITY["EPSG","3857"]]'
+) AS transformed_point
+```
+
+### WKT2(ISO 19162:2019)
+
+WKT2 是现代的 ISO 19162:2019 标准格式。投影 CRS 以 `PROJCRS[...]` 开头,地理 CRS 以 `GEOGCRS[...]` 开头。
+
+```sql
+-- Transform using WKT2 format for target CRS
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    'EPSG:4326',
+    'PROJCRS["WGS 84 / UTM zone 10N",
+        BASEGEOGCRS["WGS 84",
+            DATUM["World Geodetic System 1984",
+                ELLIPSOID["WGS 84",6378137,298.257223563]]],
+        CONVERSION["UTM zone 10N",
+            METHOD["Transverse Mercator"],
+            PARAMETER["Latitude of natural origin",0],
+            PARAMETER["Longitude of natural origin",-123],
+            PARAMETER["Scale factor at natural origin",0.9996],
+            PARAMETER["False easting",500000],
+            PARAMETER["False northing",0]],
+        CS[Cartesian,2],
+            AXIS["easting",east],
+            AXIS["northing",north],
+        UNIT["metre",1],
+        ID["EPSG",32610]]'
+) AS transformed_point
+```
+
+### PROJ 字符串
+
+PROJ 字符串提供一种使用投影参数紧凑地定义 CRS 的方式。它以 `+proj=` 开头。
+
+```sql
+-- Transform using PROJ string for UTM Zone 10N
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    '+proj=longlat +datum=WGS84 +no_defs',
+    '+proj=utm +zone=10 +datum=WGS84 +units=m +no_defs'
+) AS transformed_point
+```
+
+```sql
+-- Transform using PROJ string for Lambert Conformal Conic
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    'EPSG:4326',
+    '+proj=lcc +lat_1=33 +lat_2=45 +lat_0=39 +lon_0=-96 +x_0=0 +y_0=0 +datum=NAD83 +units=m +no_defs'
+) AS transformed_point
+```
+
+### PROJJSON
+
+PROJJSON 是 CRS 的 JSON 表示形式,便于在基于 JSON 的工作流中使用。
+
+```sql
+-- Transform using PROJJSON for target CRS
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    'EPSG:4326',
+    '{
+        "type": "ProjectedCRS",
+        "name": "WGS 84 / UTM zone 10N",
+        "base_crs": {
+            "name": "WGS 84",
+            "datum": {
+                "type": "GeodeticReferenceFrame",
+                "name": "World Geodetic System 1984",
+                "ellipsoid": {
+                    "name": "WGS 84",
+                    "semi_major_axis": 6378137,
+                    "inverse_flattening": 298.257223563
+                }
+            },
+            "coordinate_system": {
+                "subtype": "ellipsoidal",
+                "axis": [
+                    {"name": "Longitude", "abbreviation": "lon", "direction": "east", "unit": "degree"},
+                    {"name": "Latitude", "abbreviation": "lat", "direction": "north", "unit": "degree"}
+                ]
+            }
+        },
+        "conversion": {
+            "name": "UTM zone 10N",
+            "method": {"name": "Transverse Mercator"},
+            "parameters": [
+                {"name": "Latitude of natural origin", "value": 0, "unit": "degree"},
+                {"name": "Longitude of natural origin", "value": -123, "unit": "degree"},
+                {"name": "Scale factor at natural origin", "value": 0.9996},
+                {"name": "False easting", "value": 500000, "unit": "metre"},
+                {"name": "False northing", "value": 0, "unit": "metre"}
+            ]
+        },
+        "coordinate_system": {
+            "subtype": "Cartesian",
+            "axis": [
+                {"name": "Easting", "abbreviation": "E", "direction": "east", "unit": "metre"},
+                {"name": "Northing", "abbreviation": "N", "direction": "north", "unit": "metre"}
+            ]
+        },
+        "id": {"authority": "EPSG", "code": 32610}
+    }'
+) AS transformed_point
+```
+
+## URL CRS Provider
+
+自 v1.9.0 起,Sedona 支持从远程 HTTP 服务器解析 CRS 定义。当你需要使用内置数据库中不包含的自定义或内部 CRS 定义,或希望使用你自己的 CRS 定义服务时,这一功能非常有用。
+
+配置后,URL 提供者会**先于**内置 CRS 数据库被查询。如果 URL 提供者返回了有效的 CRS 定义,则直接使用该定义。如果 URL 返回 404 或错误,Sedona 会回退到内置定义。
+
+### 托管 CRS 定义
+
+你可以将自定义 CRS 定义托管在任何 HTTP 可访问的位置。两种常见做法:
+
+- **GitHub 仓库**:把 CRS 定义文件放在一个公开的 GitHub 仓库中,并使用 raw 内容 URL。这种方式最容易上手 —— 无需自建服务器。
+- **公开的 S3 桶**:把 CRS 定义文件上传到具有公共读权限的 Amazon S3 桶,并使用 S3 静态网站 URL 或 CloudFront 分发地址。
+
+每个文件应包含一个 CRS 定义,其格式通过 `spark.sedona.crs.url.format` 指定(PROJJSON、PROJ 字符串、WKT1 或 WKT2)。
+
+### 配置
+
+在创建 Sedona 会话时设置以下 Spark 配置属性:
+
+```python
+config = (
+    SedonaContext.builder()
+    .config("spark.sedona.crs.url.base", "https://crs.example.com")
+    .config("spark.sedona.crs.url.pathTemplate", "/{authority}/{code}.json")
+    .config("spark.sedona.crs.url.format", "projjson")
+    .getOrCreate()
+)
+sedona = SedonaContext.create(config)
+```
+
+在默认的路径模板下,解析 `EPSG:4326` 时会请求:
+
+```
+https://crs.example.com/epsg/4326.json
+```
+
+只有 `spark.sedona.crs.url.base` 是必需的。另外两个属性都有合理的默认值(`/{authority}/{code}.json` 与 `projjson`)。
+
+### 支持的响应格式
+
+| Format 取值 | 说明 | 内容示例 |
+|-------------|-------------|----------------|
+| `projjson` | PROJJSON(默认) | `{"type": "GeographicCRS", ...}` |
+| `proj` | PROJ 字符串 | `+proj=longlat +datum=WGS84 +no_defs` |
+| `wkt1` | OGC WKT1 | `GEOGCS["WGS 84", ...]` |
+| `wkt2` | ISO 19162 WKT2 | `GEOGCRS["WGS 84", ...]` |
+
+### 示例:GitHub 仓库
+
+假设你有一个 GitHub 仓库 `myorg/crs-definitions`,结构如下:
+
+```
+crs-definitions/
+  epsg/
+    990001.proj
+    990002.proj
+```
+
+其中 `epsg/990001.proj` 包含一条 PROJ 字符串,例如:
+
+```
++proj=merc +a=6378137 +b=6378137 +lat_ts=0 +lon_0=0 +x_0=0 +y_0=0 +k=1 +units=m +no_defs
+```
+
+将 Sedona 指向 GitHub raw 内容 URL:
+
+```python
+config = (
+    SedonaContext.builder()
+    .config(
+        "spark.sedona.crs.url.base",
+        "https://raw.githubusercontent.com/myorg/crs-definitions/main",
+    )
+    .config("spark.sedona.crs.url.pathTemplate", "/epsg/{code}.proj")
+    .config("spark.sedona.crs.url.format", "proj")
+    .getOrCreate()
+)
+sedona = SedonaContext.create(config)
+
+# Resolves EPSG:990001 from:
+# https://raw.githubusercontent.com/myorg/crs-definitions/main/epsg/990001.proj
+sedona.sql("""
+    SELECT ST_Transform(
+        ST_GeomFromText('POINT(-122.4194 37.7749)'),
+        'EPSG:4326',
+        'EPSG:990001'
+    ) AS transformed_point
+""").show()
+```
+
+### 示例:自建 CRS 服务器
+
+```python
+config = (
+    SedonaContext.builder()
+    .config("spark.sedona.crs.url.base", "https://crs.mycompany.com")
+    .config("spark.sedona.crs.url.pathTemplate", "/epsg/{code}.proj")
+    .config("spark.sedona.crs.url.format", "proj")
+    .getOrCreate()
+)
+sedona = SedonaContext.create(config)
+
+# Now ST_Transform will try https://crs.mycompany.com/epsg/3857.proj
+# before falling back to built-in definitions
+sedona.sql("""
+    SELECT ST_Transform(
+        ST_GeomFromText('POINT(-122.4194 37.7749)'),
+        'EPSG:4326',
+        'EPSG:3857'
+    ) AS transformed_point
+""").show()
+```
+
+### 示例:自定义权威机构代码
+
+URL 提供者对于不存在于任何公开数据库中的自定义或内部权威机构代码尤其有用。使用默认的路径模板 `/{authority}/{code}.json` 时,`{authority}` 占位符会被 CRS 字符串中的权威机构名称(小写)替换:
+
+```python
+config = (
+    SedonaContext.builder()
+    .config("spark.sedona.crs.url.base", "https://crs.mycompany.com")
+    .config("spark.sedona.crs.url.format", "proj")
+    .getOrCreate()
+)
+sedona = SedonaContext.create(config)
+
+# Resolves MYORG:1001 from:
+# https://crs.mycompany.com/myorg/1001.json
+sedona.sql("""
+    SELECT ST_Transform(
+        ST_GeomFromText('POINT(-122.4194 37.7749)'),
+        'EPSG:4326',
+        'MYORG:1001'
+    ) AS transformed_point
+""").show()
+```
+
+### 示例:将几何对象的 SRID 与 URL 提供者一起使用
+
+如果几何对象已设置了 SRID(例如通过 `ST_SetSRID`),可以省略源 CRS 参数。此时源 CRS 会从几何对象的 SRID 推导为 EPSG 代码:
+
+```python
+config = (
+    SedonaContext.builder()
+    .config("spark.sedona.crs.url.base", "https://crs.mycompany.com")
+    .config("spark.sedona.crs.url.format", "proj")
+    .getOrCreate()
+)
+sedona = SedonaContext.create(config)
+
+# The source CRS is taken from the geometry's SRID (4326 → EPSG:4326).
+# Only the target CRS string is needed.
+sedona.sql("""
+    SELECT ST_Transform(
+        ST_SetSRID(ST_GeomFromText('POINT(-122.4194 37.7749)'), 4326),
+        'EPSG:3857'
+    ) AS transformed_point
+""").show()
+```
+
+### 禁用 URL 提供者
+
+要避免启用 URL 提供者,可以省略 `spark.sedona.crs.url.base` 或保持其为空字符串(默认值)。注意,一旦 URL 提供者已在某个 executor JVM 中注册,它在该 JVM 的生命周期内会一直保持激活。
+
+参见:[Configuration parameters](Parameter.md#crs-transformation) 中 URL CRS 提供者的完整配置列表。
+
+## 网格文件支持
+
+网格文件支持高精度的基准面(datum)转换,例如 NAD27 到 NAD83 或 OSGB36 到 ETRS89。Sedona 支持从多种来源加载网格文件。
+
+### 网格文件来源
+
+可以在 PROJ 字符串中通过 `+nadgrids` 参数指定网格文件:
+
+| 来源 | 格式 | 示例 |
+|--------|--------|---------|
+| 本地文件 | 绝对路径 | `+nadgrids=/path/to/grid.gsb` |
+| PROJ CDN | `@` 前缀 | `+nadgrids=@us_noaa_conus.tif` |
+| HTTPS URL | 完整 URL | `+nadgrids=https://cdn.proj.org/us_noaa_conus.tif` |
+
+使用 `@` 前缀时,网格文件会自动从 [PROJ CDN](https://cdn.proj.org/) 获取。
+
+### 可选网格与必需网格
+
+- **`@` 前缀(可选)**:如果该网格不可用,转换会继续进行。当网格能提升精度但并非必需时使用。
+- **无前缀(必需)**:如果找不到该网格文件,会抛出错误。
+
+### 使用网格文件的 SQL 示例
+
+```sql
+-- Transform NAD27 to NAD83 using PROJ CDN grid (optional)
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    '+proj=longlat +datum=NAD27 +no_defs +nadgrids=@us_noaa_conus.tif',
+    'EPSG:4269'
+) AS transformed_point
+```
+
+```sql
+-- Transform using mandatory grid file (error if not found)
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-122.4194 37.7749)'),
+    '+proj=longlat +datum=NAD27 +no_defs +nadgrids=us_noaa_conus.tif',
+    'EPSG:4269'
+) AS transformed_point
+```
+
+```sql
+-- Transform OSGB36 to ETRS89 using UK grid
+SELECT ST_Transform(
+    ST_GeomFromText('POINT(-0.1276 51.5074)'),
+    '+proj=longlat +datum=OSGB36 +nadgrids=@uk_os_OSTN15_NTv2_OSGBtoETRS.gsb +no_defs',
+    'EPSG:4258'
+) AS transformed_point
+```
+
+## 坐标顺序
+
+Sedona 期望几何对象使用 **经度/纬度(lon/lat)** 顺序。如果你的数据是 lat/lon 顺序,请在转换前使用 `ST_FlipCoordinates` 交换坐标。
+
+```sql
+-- If your data is in lat/lon order, flip first
+SELECT ST_Transform(
+    ST_FlipCoordinates(ST_GeomFromText('POINT(37.7749 -122.4194)')),
+    'EPSG:4326',
+    'EPSG:3857'
+) AS transformed_point
+```
+
+Sedona 会自动处理 CRS 定义中的坐标顺序,确保源 CRS 与目标 CRS 在内部都使用 lon/lat 顺序。
+
+## 使用几何对象的 SRID
+
+如果几何对象已经设置了 SRID,可以省略源 CRS 参数:
+
+```sql
+-- Set SRID on geometry and transform using only target CRS
+SELECT ST_Transform(
+    ST_SetSRID(ST_GeomFromText('POINT(-122.4194 37.7749)'), 4326),
+    'EPSG:3857'
+) AS transformed_point
+```
+
+## 参见
+
+- [ST_Transform](Spatial-Reference-System/ST_Transform.md) —— 函数参考
+- [ST_SetSRID](Spatial-Reference-System/ST_SetSRID.md) —— 设置几何对象的 SRID
+- [ST_SRID](Spatial-Reference-System/ST_SRID.md) —— 获取几何对象的 SRID
+- [ST_FlipCoordinates](Geometry-Editors/ST_FlipCoordinates.md) —— 交换 X 与 Y 坐标
diff --git a/docs/api/sql/DataFrameAPI.zh.md b/docs/api/sql/DataFrameAPI.zh.md
new file mode 100644
index 0000000000..e73f56ea1f
--- /dev/null
+++ b/docs/api/sql/DataFrameAPI.zh.md
@@ -0,0 +1,98 @@
+<!--
+ 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.
+ -->
+
+Sedona SQL 函数可以通过类似于 Spark 函数的 DataFrame 风格 API 使用。
+
+下列对象包含了对外暴露的函数:`org.apache.spark.sql.sedona_sql.expressions.st_functions`、`org.apache.spark.sql.sedona_sql.expressions.st_constructors`、`org.apache.spark.sql.sedona_sql.expressions.st_predicates` 以及 `org.apache.spark.sql.sedona_sql.expressions.st_aggregates`。
+
+每个函数都可以接收全为 `Column` 类型的参数。此外,重载形式通常还可以接收 `String` 和其他 Scala 类型(例如 `Double`)的混合参数。
+
+一般而言适用以下规则(不过具体函数请参考各自的文档以了解可能的例外):
+
+=== "Scala"
+	1. 每个函数都返回一个 `Column`,因此可以与 Spark 函数以及 `DataFrame` 的方法(如 `DataFrame.select` 或 `DataFrame.join`)互换使用。
+	2. 每个函数都有一种全部以 `Column` 作为参数的形式。
+	这种形式是最通用的。
+	3. 大多数函数都有一种以 `String` 参数与其他 Scala 类型混合使用的形式。
+
+=== "Python"
+
+	1. `Column` 类型的参数会被原样透传,并始终被接受。
+	2. `str` 类型的参数总是被视为列名,并会自动包装到 `Column` 中。
+	如果需要传递一个实际的字符串字面量,则需要使用 `pyspark.sql.functions.lit` 把它包装成 `Column`。
+	3. 其他类型的参数会按函数逐一检查。一般来说,能够合理对应 python 原生类型的参数会被接受并透传。	4. 目前所有函数都不接受 Shapely 的 `Geometry` 对象。
+
+允许的参数类型组合视具体函数而定。
+不过在这些情况下,所有 `String` 参数都会被视为列名,并自动包装成 `Column`。
+非 `String` 参数会被视为字面量并直接传给对应的 sedona 函数。如果你需要传递 `String` 类型的字面量,应使用 sedona 函数的全 `Column` 形式,并通过 Spark 的 `lit` 函数将该 `String` 字面量包装成 `Column`。
+
+下面是使用该 API 的一个简短示例(用到了 Spark 的 `array_min` 和 `array_max` 函数):
+
+=== "Scala"
+
+	```scala
+	val values_df = spark.sql("SELECT array(0.0, 1.0, 2.0) AS values")
+	val min_value = array_min("values")
+	val max_value = array_max("values")
+	val point_df = values_df.select(ST_Point(min_value, max_value).as("point"))
+	```
+
+=== "Python"
+
+	```python3
+	from pyspark.sql import functions as f
+
+	from sedona.spark import *
+
+	df = spark.sql("SELECT array(0.0, 1.0, 2.0) AS values")
+
+	min_value = f.array_min("values")
+	max_value = f.array_max("values")
+
+	df = df.select(ST_Point(min_value, max_value).alias("point"))
+	```
+
+上面的代码将生成如下 dataframe:
+
+```
++-----------+
+|point      |
++-----------+
+|POINT (0 2)|
++-----------+
+```
+
+某些函数会接受 python 的原生值并将其推断为字面量。
+例如:
+
+```python3
+from sedona.spark import *
+
+df = df.select(ST_Point(1.0, 3.0).alias("point"))
+```
+
+这会生成一个包含常量点的列:
+
+```
++-----------+
+|point      |
++-----------+
+|POINT (1 3)|
++-----------+
+```
diff --git a/docs/api/sql/NearestNeighbourSearching.zh.md b/docs/api/sql/NearestNeighbourSearching.zh.md
new file mode 100644
index 0000000000..15909cb58e
--- /dev/null
+++ b/docs/api/sql/NearestNeighbourSearching.zh.md
@@ -0,0 +1,203 @@
+
+<!--
+ 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.
+ -->
+
+Sedona 通过提供地理空间 k 近邻(kNN)连接方法来支持对地理空间数据进行最近邻搜索。该方法基于地理临近性识别给定空间点或区域的 k 个最近邻,通常使用空间坐标以及合适的距离度量(如欧氏距离或大圆距离)。
+
+## ST_KNN
+
+简介:用于在空间数据集中查找一个点或区域的 k 个最近邻的连接操作。
+
+格式:`ST_KNN(R: Table, S: Table, k: Integer, use_spheroid: Boolean)`
+
+其中 R 是查询侧表,S 是对象侧表,K 是邻居数量。use_spheroid 是一个布尔值,决定是否使用椭球距离。
+
+查询侧表包含用于在对象侧表中查找 k 近邻的几何对象。
+
+当查询数据或对象数据中存在非点几何(其他几何类型)时,会取每个几何对象的质心。
+
+当距离上出现并列时,只有在下面的 sedona 配置被设置为 true 时,结果才会包含所有并列的几何对象:
+
+**关于内连接的说明:**
+
+- `ST_KNN` 连接仅支持 left inner join。
+- 它只返回那些至少存在一个在 k 近邻范围内的匹配邻居的对。
+- 如果某个查询点没有有效邻居(例如 k 设得太大),它会被从结果中排除。
+
+```
+spark.sedona.join.knn.includeTieBreakers=true
+```
+
+### 谓词下推注意事项:
+
+在 ST_KNN 之后对结果 DataFrame 施加的过滤条件,部分可能会被下推到 kNN 连接的对象侧。这意味着这些过滤会在 kNN 连接执行之前应用到对象侧的读取阶段。如果你希望过滤在 kNN 连接之后再生效,请先将 kNN 连接的结果物化,然后再应用过滤条件。
+
+例如,可以使用以下方式:
+
+Scala 示例:
+
+```
+val knnResult = knnJoinDF.cache()
+val filteredResult = knnResult.filter(condition)
+```
+
+SQL 示例:
+
+```
+CREATE OR REPLACE TEMP VIEW knnResult AS
+SELECT * FROM (
+  -- Your KNN join SQL here
+) AS knnView;
+CACHE TABLE knnResult;
+SELECT * FROM knnResult WHERE condition;
+```
+
+### 优化屏障
+
+使用 `barrier` 函数可以阻止谓词下推,并在复杂的空间连接中控制谓词的求值顺序。该函数通过在运行时对布尔表达式求值来创建一个优化屏障。
+
+`barrier` 函数接收一个作为字符串的布尔表达式,之后是若干对变量名及其取值,这些取值会在该表达式中被替换:
+
+```sql
+barrier(expression, var_name1, var_value1, var_name2, var_value2, ...)
+```
+
+过滤条件相对于 KNN 连接的放置位置会改变查询的语义:
+
+- **在 KNN 之前过滤**:先对数据进行过滤,再在过滤后的子集上查找 K 个最近邻。回答的是“评分高的餐厅中,最近的 K 家是哪几家?”
+- **在 KNN 之后过滤**:先在全部数据中查找 K 个最近邻,再对结果进行过滤。回答的是“最近的 K 家餐厅中,哪几家是高评分的?”
+
+### 示例
+
+查找距离每家豪华酒店最近的 3 家高评分餐厅,并确保 KNN 连接先完成,再进行过滤。
+
+```sql
+SELECT
+    h.name AS hotel,
+    r.name AS restaurant,
+    r.rating
+FROM hotels AS h
+INNER JOIN restaurants AS r
+ON ST_KNN(h.geometry, r.geometry, 3, false)
+WHERE barrier('rating > 4.0 AND stars >= 4',
+              'rating', r.rating,
+              'stars', h.stars)
+```
+
+借助 barrier 函数,这条查询会先为每家酒店找到 3 家最近的餐厅(不考虑评分),随后再过滤,仅保留餐厅评分大于 4.0 且酒店星级不低于 4 的配对。如果不使用 barrier,优化器可能会将过滤下推,将查询改写为先过滤出高评分餐厅与豪华酒店,再在这些过滤后的子集中找最近的 3 个。
+
+### 在 ST_KNN 连接中处理 SQL 定义的表:
+
+在 Sedona 中,如果使用硬编码的 SQL select 语句创建 DataFrame,并随后在 `ST_KNN` 连接中使用它们,Sedona 可能会以绕过 kNN 连接逻辑的方式来优化查询。具体地说,如果你像下面这样用硬编码 SQL 创建 DataFrame:
+
+```scala
+val df1 = sedona.sql("SELECT ST_Point(0.0, 0.0) as geom1")
+val df2 = sedona.sql("SELECT ST_Point(0.0, 0.0) as geom2")
+
+val df = df1.join(df2, expr("ST_KNN(geom1, geom2, 1)"))
+```
+
+Sedona 可能会把这次连接优化为类似下面的形式:
+
+```sql
+SELECT ST_KNN(ST_Point(0.0, 0.0), ST_Point(0.0, 0.0), 1)
+```
+
+结果是,ST_KNN 函数被当作用户自定义函数(UDF)处理,而非一个连接操作,从而阻止 Sedona 走 kNN 连接的执行路径。与典型的 UDF 不同,ST_KNN 函数会跨 DataFrame 作用在多行上,而不是仅作用在单行上。当出现这种情况时,查询会以 UnsupportedOperationException 失败,提示不支持该 KNN 谓词。
+
+解决方法:
+
+为防止 Spark 的优化绕过 kNN 连接逻辑,必须先将由硬编码 SQL select 创建的 DataFrame 物化,再执行连接。可以通过缓存 DataFrame 告诉 Spark 不要进行这种不希望的优化:
+
+```scala
+val df1 = sedona.sql("SELECT ST_Point(0.0, 0.0) as geom1").cache()
+val df2 = sedona.sql("SELECT ST_Point(0.0, 0.0) as geom2").cache()
+
+val df = df1.join(df2, expr("ST_KNN(geom1, geom2, 1)"))
+```
+
+通过 `.cache()` 物化 DataFrame 后,Spark 逻辑计划中会走正确的 kNN 连接路径,避免将 ST_KNN 当成普通 UDF 处理的优化。
+
+### SQL 示例
+
+假设我们有两张表 `QUERIES` 与 `OBJECTS`,数据如下:
+
+QUERIES 表:
+
+```
+ID  GEOMETRY            NAME
+1   POINT(1 1)	        station1
+2   POINT(10 10)	    station2
+3   POINT(-0.5 -0.5)	station3
+```
+
+OBJECTS 表:
+
+```
+ID  GEOMETRY            NAME
+1	POINT(11 5)         bank1
+2	POINT(12 1)         bank2
+3	POINT(-1 -1)        bank3
+4	POINT(-3 5)         bank4
+5	POINT(9 8)          bank5
+6	POINT(4 3)          bank6
+7	POINT(-4 -5)        bank7
+8	POINT(4 -2)         bank8
+9	POINT(-3 1)         bank9
+10	POINT(-7 3)         bank10
+11	POINT(11 5)         bank11
+12	POINT(12 1)         bank12
+13	POINT(-1 -1)        bank13
+14	POINT(-3 5)         bank14
+15	POINT(9 8)          bank15
+16	POINT(4 3)          bank16
+17	POINT(-4 -5)        bank17
+18	POINT(4 -2)         bank18
+19	POINT(-3 1)         bank19
+20	POINT(-7 3)         bank20
+```
+
+```sql
+SELECT
+    QUERIES.ID AS QUERY_ID,
+    QUERIES.GEOMETRY AS QUERIES_GEOM,
+    OBJECTS.GEOMETRY AS OBJECTS_GEOM
+FROM QUERIES JOIN OBJECTS ON ST_KNN(QUERIES.GEOMETRY, OBJECTS.GEOMETRY, 4, FALSE)
+```
+
+输出:
+
+```
++--------+-----------------+-------------+
+|QUERY_ID|QUERIES_GEOM     |OBJECTS_GEOM |
++--------+-----------------+-------------+
+|3       |POINT (-0.5 -0.5)|POINT (-1 -1)|
+|3       |POINT (-0.5 -0.5)|POINT (-1 -1)|
+|3       |POINT (-0.5 -0.5)|POINT (-3 1) |
+|3       |POINT (-0.5 -0.5)|POINT (-3 1) |
+|1       |POINT (1 1)      |POINT (-1 -1)|
+|1       |POINT (1 1)      |POINT (-1 -1)|
+|1       |POINT (1 1)      |POINT (4 3)  |
+|1       |POINT (1 1)      |POINT (4 3)  |
+|2       |POINT (10 10)    |POINT (9 8)  |
+|2       |POINT (10 10)    |POINT (9 8)  |
+|2       |POINT (10 10)    |POINT (11 5) |
+|2       |POINT (10 10)    |POINT (11 5) |
++--------+-----------------+-------------+
+```
diff --git a/docs/api/sql/Optimizer.zh.md b/docs/api/sql/Optimizer.zh.md
new file mode 100644
index 0000000000..e9be8d04a4
--- /dev/null
+++ b/docs/api/sql/Optimizer.zh.md
@@ -0,0 +1,418 @@
+<!--
+ 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.
+ -->
+
+Sedona 的空间算子完全支持 Apache SparkSQL 的查询优化器。它具备以下查询优化特性:
+
+* 自动优化范围连接查询和距离连接查询。
+* 自动执行谓词下推。
+
+!!! tip
+	Sedona 连接的性能受分区数影响很大。如果连接性能不理想,请在创建原始 DataFrame 之后执行 `df.repartition(XXX)` 以增加分区数。
+
+## 范围连接(Range join)
+
+简介:从 A 与 B 中查找满足某个谓词的几何对象配对。SedonaSQL 支持的大多数谓词都可以触发范围连接。
+
+SQL 示例
+
+```sql
+SELECT *
+FROM polygondf, pointdf
+WHERE ST_Contains(polygondf.polygonshape,pointdf.pointshape)
+```
+
+```sql
+SELECT *
+FROM polygondf, pointdf
+WHERE ST_Intersects(polygondf.polygonshape,pointdf.pointshape)
+```
+
+```sql
+SELECT *
+FROM pointdf, polygondf
+WHERE ST_Within(pointdf.pointshape, polygondf.polygonshape)
+```
+
+```sql
+SELECT *
+FROM pointdf, polygondf
+WHERE ST_DWithin(pointdf.pointshape, polygondf.polygonshape, 10.0)
+```
+
+Spark SQL 物理计划:
+
+```
+== Physical Plan ==
+RangeJoin polygonshape#20: geometry, pointshape#43: geometry, false
+:- Project [st_polygonfromenvelope(cast(_c0#0 as decimal(24,20)), cast(_c1#1 as decimal(24,20)), cast(_c2#2 as decimal(24,20)), cast(_c3#3 as decimal(24,20)), mypolygonid) AS polygonshape#20]
+:  +- *FileScan csv
++- Project [st_point(cast(_c0#31 as decimal(24,20)), cast(_c1#32 as decimal(24,20)), myPointId) AS pointshape#43]
+   +- *FileScan csv
+
+```
+
+!!!note
+	SedonaSQL 中所有的连接查询都是内连接
+
+## 距离连接(Distance join)
+
+简介:从 A 与 B 中查找彼此之间的距离小于或等于某个阈值的几何对象配对。支持平面欧氏距离计算器 `ST_Distance`、`ST_HausdorffDistance`、`ST_FrechetDistance`,以及基于米制的大地测量距离计算器 `ST_DistanceSpheroid` 与 `ST_DistanceSphere`。
+
+平面欧氏距离的 Spark SQL 示例:
+
+*仅考虑==完全位于某个距离之内==*
+
+```sql
+SELECT *
+FROM pointdf1, pointdf2
+WHERE ST_Distance(pointdf1.pointshape1,pointdf2.pointshape2) < 2
+```
+
+```sql
+SELECT *
+FROM pointDf, polygonDF
+WHERE ST_HausdorffDistance(pointDf.pointshape, polygonDf.polygonshape, 0.3) < 2
+```
+
+```sql
+SELECT *
+FROM pointDf, polygonDF
+WHERE ST_FrechetDistance(pointDf.pointshape, polygonDf.polygonshape) < 2
+```
+
+*考虑==与某个距离范围相交==*
+
+```sql
+SELECT *
+FROM pointdf1, pointdf2
+WHERE ST_Distance(pointdf1.pointshape1,pointdf2.pointshape2) <= 2
+```
+
+```sql
+SELECT *
+FROM pointDf, polygonDF
+WHERE ST_HausdorffDistance(pointDf.pointshape, polygonDf.polygonshape) <= 2
+```
+
+```sql
+SELECT *
+FROM pointDf, polygonDF
+WHERE ST_FrechetDistance(pointDf.pointshape, polygonDf.polygonshape) <= 2
+```
+
+Spark SQL 物理计划:
+
+```
+== Physical Plan ==
+DistanceJoin pointshape1#12: geometry, pointshape2#33: geometry, 2.0, true
+:- Project [st_point(cast(_c0#0 as decimal(24,20)), cast(_c1#1 as decimal(24,20)), myPointId) AS pointshape1#12]
+:  +- *FileScan csv
++- Project [st_point(cast(_c0#21 as decimal(24,20)), cast(_c1#22 as decimal(24,20)), myPointId) AS pointshape2#33]
+   +- *FileScan csv
+```
+
+!!!warning
+	如果使用 `ST_Distance`、`ST_HausdorffDistance` 或 `ST_FrechetDistance` 等平面欧氏距离函数作为谓词,Sedona 不会管理距离的单位(度或米),它与几何对象保持一致。如果坐标位于经纬度系统下,`distance` 的单位应是度,而不是米或英里。若想更换几何对象的单位,请将坐标参考系转换到基于米的坐标系。参见 [ST_Transform](Spatial-Reference-System/ST_Transform.md)。如果不想转换数据,请考虑使用 `ST_DistanceSpheroid` 或 `ST_DistanceSphere`。
+
+基于米制大地测量距离 `ST_DistanceSpheroid` 的 Spark SQL 示例(对 `ST_DistanceSphere` 同样适用):
+
+*==小于某个距离==*
+
+```sql
+SELECT *
+FROM pointdf1, pointdf2
+WHERE ST_DistanceSpheroid(pointdf1.pointshape1,pointdf2.pointshape2) < 2
+```
+
+*==小于等于某个距离==*
+
+```sql
+SELECT *
+FROM pointdf1, pointdf2
+WHERE ST_DistanceSpheroid(pointdf1.pointshape1,pointdf2.pointshape2) <= 2
+```
+
+!!!warning
+	如果使用 `ST_DistanceSpheroid` 或 `ST_DistanceSphere` 作为谓词,距离单位为米。目前,使用大地测量距离计算器的距离连接对点数据效果最好。对于非点数据,仅会考虑它们的质心。
+
+## 空间左连接(Spatial Left Join)
+
+简介:以范围连接或距离连接的空间性能来执行左连接。
+这样既可以找到 A 与 B 中满足连接条件的几何对象配对,同时还能保留 A 中那些在 B 中找不到任何匹配几何的记录。
+
+范围连接与距离连接==不支持==如下所示的 LEFT JOIN:
+
+```sql
+SELECT a.*, b.* FROM a
+LEFT JOIN b ON ST_INTERSECTS(a.geometry, b.geometry)
+```
+
+这会导致使用 **BroadcastIndexJoin**,在两个大数据集上会非常低效。
+否则就会触发 **BroadcastNestedLoopJoin**,这是最慢的选项。
+
+为了利用 Sedona 的空间连接性能,可以通过将一次 INNER JOIN 与一次 LEFT JOIN 组合,来生成左连接的结果。
+
+1. 通过内连接,我们收集左侧的 ID 以及右侧所有需要的列(把结果视为 **A'**)
+2. 第二步,将左侧 A 与内连接结果 **A'** 合并。
+   A 中的所有记录被原样保留,而右侧 B 的记录通过 **A'** 传递出来。
+
+```sql
+WITH inner_join AS (
+    SELECT
+        dfA.a_id
+        , dfB.b_id
+    FROM dfA, dfB
+    WHERE ST_INTERSECTS(dfA.geometry, dfB.geometry)
+)
+
+SELECT
+    dfA.*,
+    inner_join.b_id
+FROM dfA
+LEFT JOIN inner_join
+   ON dfA.a_id = inner_join.a_id;
+```
+
+!!!note
+	可以将这种策略定义为一个存储过程或 DBT 宏,以避免重复编写相同的代码。
+
+## 广播索引连接(Broadcast index join)
+
+简介:执行范围连接或距离连接,但将其中一侧广播。这样可以保留非广播侧的分区,避免 shuffle。
+
+Sedona 会在被广播的表上构建空间索引。
+
+只有当正确的一侧带有 broadcast 提示时,Sedona 才会使用广播连接。
+支持的连接类型——广播侧组合如下:
+
+* Inner —— 两侧任一,如果两侧都带有提示则优先广播左侧
+* Left semi —— 广播右侧
+* Left anti —— 广播右侧
+* Left outer —— 广播右侧
+* Right outer —— 广播左侧
+
+```scala
+pointDf.alias("pointDf").join(broadcast(polygonDf).alias("polygonDf"), expr("ST_Contains(polygonDf.polygonshape, pointDf.pointshape)"))
+```
+
+在 SQL 中指定 broadcast 提示,使用以下语法:
+
+```sql
+SELECT /*+ BROADCAST(polygonDf) */
+  pointDf.*,
+  polygonDf.*
+FROM pointDf
+JOIN polygonDf
+  ON ST_Contains(polygonDf.polygonshape, pointDf.pointshape);
+```
+
+Spark SQL 物理计划:
+
+```
+== Physical Plan ==
+BroadcastIndexJoin pointshape#52: geometry, BuildRight, BuildRight, false ST_Contains(polygonshape#30, pointshape#52)
+:- Project [st_point(cast(_c0#48 as decimal(24,20)), cast(_c1#49 as decimal(24,20))) AS pointshape#52]
+:  +- FileScan csv
++- SpatialIndex polygonshape#30: geometry, QUADTREE, [id=#62]
+   +- Project [st_polygonfromenvelope(cast(_c0#22 as decimal(24,20)), cast(_c1#23 as decimal(24,20)), cast(_c2#24 as decimal(24,20)), cast(_c3#25 as decimal(24,20))) AS polygonshape#30]
+      +- FileScan csv
+```
+
+这同样适用于使用 `ST_Distance`、`ST_DistanceSpheroid`、`ST_DistanceSphere`、`ST_HausdorffDistance` 或 `ST_FrechetDistance` 的距离连接:
+
+```scala
+pointDf1.alias("pointDf1").join(broadcast(pointDf2).alias("pointDf2"), expr("ST_Distance(pointDf1.pointshape, pointDf2.pointshape) <= 2"))
+```
+
+Spark SQL 物理计划:
+
+```
+== Physical Plan ==
+BroadcastIndexJoin pointshape#52: geometry, BuildRight, BuildLeft, true, 2.0 ST_Distance(pointshape#52, pointshape#415) <= 2.0
+:- Project [st_point(cast(_c0#48 as decimal(24,20)), cast(_c1#49 as decimal(24,20))) AS pointshape#52]
+:  +- FileScan csv
++- SpatialIndex pointshape#415: geometry, QUADTREE, [id=#1068]
+   +- Project [st_point(cast(_c0#48 as decimal(24,20)), cast(_c1#49 as decimal(24,20))) AS pointshape#415]
+      +- FileScan csv
+```
+
+注意:如果 distance 是一个表达式,它只会在 ST_Distance 的第一个参数(上例中的 `pointDf1`)上求值。
+
+## 自动广播索引连接
+
+当参与空间连接的某张表小于阈值时,Sedona 会自动选择广播索引连接而不是 Sedona 优化连接。当前阈值由 [sedona.join.autoBroadcastJoinThreshold](Parameter.md) 控制,默认与 `spark.sql.autoBroadcastJoinThreshold` 保持一致。
+
+## 栅格连接(Raster join)
+
+空间连接的优化同样适用于栅格谓词,例如 `RS_Intersects`、`RS_Contains` 与 `RS_Within`。
+
+SQL 示例:
+
+```sql
+-- Raster-geometry join
+SELECT df1.id, df2.id, RS_Value(df1.rast, df2.geom) FROM df1 JOIN df2 ON RS_Intersects(df1.rast, df2.geom)
+
+-- Raster-raster join
+SELECT df1.id, df2.id FROM df1 JOIN df2 ON RS_Intersects(df1.rast, df2.rast)
+```
+
+这些查询可被规划为 RangeJoin 或 BroadcastIndexJoin。下面是一个使用 RangeJoin 的物理计划示例:
+
+```
+== Physical Plan ==
+*(1) Project [id#14, id#25]
++- RangeJoin rast#13: raster, geom#24: geometry, INTERSECTS,  **org.apache.spark.sql.sedona_sql.expressions.RS_Intersects**
+   :- LocalTableScan [rast#13, id#14]
+   +- LocalTableScan [geom#24, id#25]
+```
+
+## 基于 Google S2 的近似等值连接
+
+如果 Sedona 优化连接性能不理想(可能由复杂且相互重叠的几何对象导致),可以借助 Sedona 内置的、基于 Google S2 的近似等值连接。该等值连接利用 Spark 内部的等值连接算法,并且如果你愿意牺牲一些查询精度跳过精化步骤,性能可能更佳。
+
+请按以下步骤操作:
+
+### 1. 为两张表生成 S2 id
+
+使用 [ST_S2CellIDs](Spatial-Indexing/ST_S2CellIDs.md) 生成 cell ID。每个几何对象可能产生一个或多个 ID。
+
+```sql
+SELECT id, geom, name, explode(ST_S2CellIDs(geom, 15)) as cellId
+FROM lefts
+```
+
+```sql
+SELECT id, geom, name, explode(ST_S2CellIDs(geom, 15)) as cellId
+FROM rights
+```
+
+### 2. 执行等值连接
+
+通过两张表的 S2 cellId 进行连接
+
+```sql
+SELECT lcs.id as lcs_id, lcs.geom as lcs_geom, lcs.name as lcs_name, rcs.id as rcs_id, rcs.geom as rcs_geom, rcs.name as rcs_name
+FROM lcs JOIN rcs ON lcs.cellId = rcs.cellId
+```
+
+### 3. 可选:精化结果
+
+由于 S2 Cellid 的特性,依据所选 S2 层级的不同,等值连接结果中可能会有少量误报。层级越小,cell 越大,膨胀(exploded)后的行数越少,但误报越多。
+
+为保证正确性,可以使用 [空间谓词](Geometry-Functions.md#predicates) 之一来过滤掉误报。使用下面的查询替换第 2 步中的查询。
+
+```sql
+SELECT lcs.id as lcs_id, lcs.geom as lcs_geom, lcs.name as lcs_name, rcs.id as rcs_id, rcs.geom as rcs_geom, rcs.name as rcs_name
+FROM lcs, rcs
+WHERE lcs.cellId = rcs.cellId AND ST_Contains(lcs.geom, rcs.geom)
+```
+
+如你所见,相比第 2 步的查询,我们额外加了一个过滤条件 `ST_Contains`,用于去除误报。也可以使用 `ST_Intersects` 等其他谓词。
+
+!!!tip
+	如果不需要 100% 的精度并希望获得更快的查询速度,可以跳过该步骤。
+
+### 4. 可选:去重
+
+由于在生成 S2 Cell Ids 时使用了 explode 函数,结果 DataFrame 中可能会有若干重复的 <lcs_geom, rcs_geom> 匹配。可以通过 GroupBy 查询移除它们。
+
+```sql
+SELECT lcs_id, rcs_id, first(lcs_geom), first(lcs_name), first(rcs_geom), first(rcs_name)
+FROM joinresult
+GROUP BY (lcs_id, rcs_id)
+```
+
+`first` 函数用于在一组重复值中取第一个。
+
+如果你没有每个几何对象的唯一 id,也可以按几何对象本身分组。见下:
+
+```sql
+SELECT lcs_geom, rcs_geom, first(lcs_name), first(rcs_name)
+FROM joinresult
+GROUP BY (lcs_geom, rcs_geom)
+```
+
+!!!note
+	如果你做的是 point-in-polygon 连接,则不存在此问题,可以放心忽略。该问题仅在 polygon-polygon、polygon-linestring、linestring-linestring 连接中出现。
+
+### S2 用于距离连接
+
+这也适用于距离连接。你需要先用 `ST_Buffer(geometry, distance)` 包装其中一个原始几何列。如果原始几何列是点,这次 `ST_Buffer` 会将它们变成半径为 `distance` 的圆。
+
+由于坐标位于经纬度系统下,`distance` 的单位应是度而非米或英里。可以通过 `METER_DISTANCE/111000.0` 得到近似值,然后过滤掉误报。注意,当数据接近极点或反子午线时,这种做法可能导致不准确的结果。
+
+简而言之,在第 1 步之前先对左表运行下面的查询。请将 `METER_DISTANCE` 替换为以米为单位的距离。在第 1 步中,基于 `buffered_geom` 列生成 S2 ID。然后在原始的 `geom` 列上运行第 2、3、4 步。
+
+```sql
+SELECT id, geom, ST_Buffer(geom, METER_DISTANCE/111000.0) as buffered_geom, name
+FROM lefts
+```
+
+## 常规空间谓词下推
+
+简介:当同一个 WHERE 子句中同时包含一个连接查询和一个谓词时,先将谓词作为过滤条件执行,再执行连接查询。
+
+SQL 示例
+
+```sql
+SELECT *
+FROM polygondf, pointdf
+WHERE ST_Contains(polygondf.polygonshape,pointdf.pointshape)
+AND ST_Contains(ST_PolygonFromEnvelope(1.0,101.0,501.0,601.0), polygondf.polygonshape)
+```
+
+Spark SQL 物理计划:
+
+```
+== Physical Plan ==
+RangeJoin polygonshape#20: geometry, pointshape#43: geometry, false
+:- Project [st_polygonfromenvelope(cast(_c0#0 as decimal(24,20)), cast(_c1#1 as decimal(24,20)), cast(_c2#2 as decimal(24,20)), cast(_c3#3 as decimal(24,20)), mypolygonid) AS polygonshape#20]
+:  +- Filter  **org.apache.spark.sql.sedona_sql.expressions.ST_Contains$**
+:     +- *FileScan csv
++- Project [st_point(cast(_c0#31 as decimal(24,20)), cast(_c1#32 as decimal(24,20)), myPointId) AS pointshape#43]
+   +- *FileScan csv
+```
+
+## 将空间谓词下推到 GeoParquet
+
+Sedona 支持对 GeoParquet 文件进行空间谓词下推。当对由 GeoParquet 文件支撑的 dataframe 应用空间过滤时,Sedona 会利用
+[元数据中的 `bbox` 属性](https://github.com/opengeospatial/geoparquet/blob/v1.0.0-beta.1/format-specs/geoparquet.md#bbox)
+来判断该文件中的全部数据是否会被该空间谓词过滤掉。当 GeoParquet 数据集按空间临近性进行分区时,
+这种优化可以减少需要扫描的文件数量。
+
+为了最大化 Sedona 对 GeoParquet 的过滤下推性能,建议按几何对象的 geohash 值(参见 [ST_GeoHash](Geometry-Output/ST_GeoHash.md))对数据排序后再保存为 GeoParquet 文件。示例如下:
+
+```
+SELECT col1, col2, geom, ST_GeoHash(geom, 5) as geohash
+FROM spatialDf
+ORDER BY geohash
+```
+
+下图展示了一个 GeoParquet 数据集的可视化。所有 GeoParquet 文件的 `bbox` 以蓝色矩形绘制,查询窗口以红色矩形绘制。Sedona 只会扫描 6 个文件中的 1 个就能
+回答类似 `SELECT * FROM geoparquet_dataset WHERE ST_Intersects(geom, <query window>)` 的查询,因此只需要扫描浅绿色矩形覆盖的部分数据。
+
+![Visualization of a GeoParquet dataset](../../image/geoparquet-pred-pushdown.png "Visualization of a GeoParquet dataset")
+
+我们可以对比启用与不启用空间谓词时查询 GeoParquet 数据集的指标,可以观察到使用空间谓词时扫描的行数明显减少。
+
+| 不使用空间谓词                                                                       | 使用空间谓词 |
+|-------------------------------------------------------------------------------------------------| ----------- |
+| ![Scan geoparquet without spatial predicate](../../image/scan-parquet-without-spatial-pred.png) | ![Scan geoparquet with spatial predicate](../../image/scan-parquet-with-spatial-pred.png) |
+
+将空间谓词下推到 GeoParquet 默认启用。用户可以通过将 Spark 配置 `spark.sedona.geoparquet.spatialFilterPushDown` 设置为 `false` 来手动禁用。
diff --git a/docs/api/sql/Overview.zh.md b/docs/api/sql/Overview.zh.md
new file mode 100644
index 0000000000..a72e8e5a16
--- /dev/null
+++ b/docs/api/sql/Overview.zh.md
@@ -0,0 +1,97 @@
+<!--
+ 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.
+ -->
+
+# 简介
+
+## 函数列表
+
+SedonaSQL 支持 SQL/MM Part3 空间 SQL 标准,包含以下四种 SQL 算子。所有这些算子都可以通过下面的方式直接调用:
+
+```scala
+var myDataFrame = sedona.sql("YOUR_SQL")
+```
+
+此外,也可以使用 `expr` 和 `selectExpr` 调用:
+
+```scala
+myDataFrame.withColumn("geometry", expr("ST_*")).selectExpr("ST_*")
+```
+
+* 构造函数(Constructor):根据输入的字符串或坐标构造一个 Geometry
+	* 示例:ST_GeomFromWKT (string)。根据 WKT 字符串创建一个 Geometry。
+	* 文档:[点击查看](Geometry-Functions.md)
+* 函数(Function):在指定的一列或多列上执行某个函数
+	* 示例:ST_Distance (A, B)。给定两个 Geometry A 和 B,返回 A 与 B 的欧氏距离。
+	* 文档:函数按类别组织。参见 [Geometry Accessors](Geometry-Functions.md)、[Geometry Editors](Geometry-Functions.md)、[Measurement Functions](Geometry-Functions.md#measurement-functions)、[Geometry Processing](Geometry-Functions.md)、[Overlay Functions](Geometry-Functions.md#overlay-functions),以及侧边栏中的其他分类。
+* 聚合函数(Aggregate function):对给定列返回聚合后的值
+	* 示例:ST_Envelope_Aggr (Geometry column)。给定一个 Geometry 列,计算该列所有几何对象的总外接包络。
+	* 文档:[点击查看](Geometry-Functions.md#aggregate-functions)
+* 谓词(Predicate):在给定的列上执行逻辑判断,返回 true 或 false
+	* 示例:ST_Contains (A, B)。检查 A 是否完全包含 B。如果是则返回 "True",否则返回 "False"。
+	* 文档:[点击查看](Geometry-Functions.md#predicates)
+
+Sedona 还提供了一个 Adapter 用于在 SpatialRDD 与 DataFrame 之间相互转换。详见 [Adapter Scaladoc](../../scaladoc/spark/org/apache/sedona/sql/utils/index.html)
+
+SedonaSQL 支持 SparkSQL 查询优化器,相关文档见[此处](Optimizer.md)
+
+## 栅格函数列表
+
+SedonaSQL 同样支持栅格数据处理。栅格函数以 `RS_` 为前缀。所有栅格算子的调用方式与矢量算子相同:
+
+```scala
+var myDataFrame = sedona.sql("YOUR_SQL")
+```
+
+* 构造函数(Constructor):根据输入的文件或参数构造一个 Raster
+	* 示例:RS_FromGeoTiff (binary)。从一个 GeoTiff 二进制数据创建一个 Raster。
+	* 文档:[点击查看](Raster-Functions.md#raster-constructors)
+* 函数(Function):在指定的一列或多列 Raster 上执行某个函数
+	* 示例:RS_Value (raster, point)。给定一个 Raster 和一个 Point 几何对象,返回该位置上的像元值。
+	* 文档:函数按类别组织。参见 [Raster Accessors](Raster-Functions.md#raster-accessors)、[Raster Operators](Raster-Functions.md#raster-operators)、[Raster Band Accessors](Raster-Functions.md#raster-band-accessors)、[Raster Output](Raster-Functions.md#raster-output),以及侧边栏中的其他分类。
+* 聚合函数(Aggregate function):对给定的 Raster 列返回聚合后的值
+	* 示例:RS_Union_Aggr (Raster column)。给定一个 Raster 列,将所有 Raster 合并为单个多波段栅格。
+	* 文档:[点击查看](Raster-Functions.md#raster-aggregate-functions)
+* 谓词(Predicate):在给定的列上执行逻辑判断,返回 true 或 false
+	* 示例:RS_Intersects (raster, geometry)。判断一个栅格是否与一个几何对象相交。如果是则返回 "True",否则返回 "False"。
+	* 文档:[点击查看](Raster-Functions.md#raster-predicates)
+
+## 栅格快速入门
+
+详细说明请参见[编写栅格 DataFrame/SQL 应用](../../tutorial/raster.md)。
+
+## 快速入门
+
+详细说明请参见[编写 SQL/DataFrame 应用](../../tutorial/sql.md)。
+
+1. 在你的项目 pom.xml 或 build.sbt 中加入 Sedona-core 和 Sedona-SQL
+2. 如果需要定制 SparkSession,创建你自己的 Sedona 配置。
+
+```scala
+import org.apache.sedona.spark.SedonaContext
+val config = SedonaContext.builder().
+    master("local[*]").appName("SedonaSQL")
+    .getOrCreate()
+```
+
+3. 在 Sedona context 声明之后加上以下代码:
+
+```scala
+import org.apache.sedona.spark.SedonaContext
+val sedona = SedonaContext.create(config)
+```
diff --git a/docs/api/sql/Parameter.zh.md b/docs/api/sql/Parameter.zh.md
new file mode 100644
index 0000000000..2d71f8f9b8
--- /dev/null
+++ b/docs/api/sql/Parameter.zh.md
@@ -0,0 +1,84 @@
+<!--
+ 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.
+ -->
+
+## 使用方式
+
+SedonaSQL 支持多种参数。修改它们的取值有以下几种方式:
+
+1. 通过 SparkConf 设置:
+
+```scala
+sparkSession = SparkSession.builder().
+      config("spark.serializer","org.apache.spark.serializer.KryoSerializer").
+      config("spark.kryo.registrator", "org.apache.sedona.core.serde.SedonaKryoRegistrator").
+      config("sedona.global.index","true")
+      master("local[*]").appName("mySedonaSQLdemo").getOrCreate()
+```
+
+2. 查看当前的 SedonaSQL 配置:
+
+```scala
+val sedonaConf = new SedonaConf(sparkSession.conf)
+println(sedonaConf)
+```
+
+3. Sedona 参数可以在运行时动态修改:
+
+```scala
+sparkSession.conf.set("sedona.global.index","false")
+```
+
+此外,你也可以在参数名前添加 `spark` 前缀,例如:
+
+```scala
+sparkSession.conf.set("spark.sedona.global.index","false")
+```
+
+不过,所有通过 `spark` 前缀设置的参数都会被 Spark 所识别,这意味着你可以提前通过 `spark-defaults.conf` 或 Spark on Kubernetes 的配置来设定这些参数。
+
+如果同一个参数同时通过 `sedona` 和 `spark.sedona` 两种前缀进行设置,则 `sedona` 前缀设置的值会覆盖 `spark.sedona` 前缀设置的值。
+
+## 通用参数
+
+| 参数 | 说明 | 默认值 | 可选值 |
+| :--- | :--- | :--- | :--- |
+| `sedona.global.index` | 是否启用空间索引(目前仅支持 SQL 范围连接与 SQL 距离连接) | `true` | `true`, `false` |
+| `sedona.global.indextype` | 空间索引类型,仅在 `sedona.global.index` 为 true 时生效 | `rtree` | `rtree`, `quadtree` |
+| `spark.sedona.enableParserExtension` | 启用解析器扩展,用于在 SQL DDL 语句中解析 GEOMETRY 数据类型 | `true` | `true`, `false` |
+
+## 连接(Join)相关参数
+
+| 参数 | 说明 | 默认值 | 可选值 |
+| :--- | :--- | :--- | :--- |
+| `sedona.join.autoBroadcastJoinThreshold` | 执行连接时,将被广播到所有工作节点的表的最大字节大小。设为 -1 可禁用自动广播。 | 与 `spark.sql.autoBroadcastJoinThreshold` 相同 | 带有字节后缀的整数,例如 `10MB` 或 `512KB` |
+| `sedona.join.gridtype` | 连接查询使用的空间分区网格类型 | `kdbtree` | `quadtree`, `kdbtree` |
+| `spark.sedona.join.knn.includeTieBreakers` | KNN 连接结果是否包含所有并列项,可能返回多于 k 个结果 | `false` | `true`, `false` |
+| `sedona.join.indexbuildside` | **(高级)** Sedona 在哪一侧构建空间索引 | `left` | `left`, `right` |
+| `sedona.join.numpartition` | **(高级)** 连接查询双方的分区数 | `-1`(使用现有分区数) | 任意整数 |
+| `sedona.join.spatitionside` | **(高级)** 空间分区阶段的主导侧 | `left` | `left`, `right` |
+| `sedona.join.optimizationmode` | **(高级)** Sedona 何时优化空间连接 SQL 查询 | `nonequi` | `all`(始终优化,包括等值连接),`none`(禁用优化),`nonequi`(仅优化非等值连接) |
+
+## CRS 转换参数
+
+| 参数 | 说明 | 默认值 | 可选值 | 起始版本 |
+| :--- | :--- | :--- | :--- | :--- |
+| `spark.sedona.crs.geotools` | 控制 ST_Transform 中 CRS 转换所使用的库 | `raster` | `none`(全部使用 proj4sedona),`raster`(矢量使用 proj4sedona,栅格使用 GeoTools),`all`(全部使用 GeoTools —— 旧版行为) | v1.9.0 |
+| `spark.sedona.crs.url.base` | CRS 定义服务器的基础 URL,用于通过 HTTP 解析权威机构代码(如 EPSG)。设置后,ST_Transform 会先查询该 URL 提供者,再回退到内置定义。 | _(空 —— 禁用)_ | 例如 `https://crs.example.com` | v1.9.0 |
+| `spark.sedona.crs.url.pathTemplate` | 附加在 `spark.sedona.crs.url.base` 之后的 URL 路径模板。占位符 `{authority}` 和 `{code}` 会在运行时被替换。 | `/{authority}/{code}.json` | 例如 `/epsg/{code}.json` | v1.9.0 |
+| `spark.sedona.crs.url.format` | URL 提供者返回的 CRS 定义格式 | `projjson` | `projjson`、`proj`、`wkt1`(OGC WKT1)、`wkt2`(ISO 19162 WKT2) | v1.9.0 |
diff --git a/docs/api/sql/Raster-affine-transformation.zh.md b/docs/api/sql/Raster-affine-transformation.zh.md
new file mode 100644
index 0000000000..c29430e097
--- /dev/null
+++ b/docs/api/sql/Raster-affine-transformation.zh.md
@@ -0,0 +1,85 @@
+<!--
+ 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.
+ -->
+
+本页介绍 Sedona Raster 中仿射变换(Affine Transformation)的基本概念。
+
+![Raster_Affine_Transformation](../../image/Raster_Affine_Transformation/Raster_Affine_Transformation.svg "Raster Affine Transformation")
+
+## 仿射变换
+
+仿射变换是计算机图形学、几何与图像处理中的一个基础概念,指以保持直线性与平行性(但不一定保持距离与角度)的方式对对象进行变换。这类变换是一种线性变换叠加上一次平移,因此能够在不改变点、线、面相对排列的前提下,对对象进行平移、缩放、旋转与剪切。
+
+### 仿射变换的组成
+
+仿射变换可以表示为矩阵运算。在二维空间中,典型的仿射变换矩阵是一个 3x3 矩阵,如下所示:
+
+```
+| ScaleX  SkewX   TranslationX |
+| SkewY   ScaleY  TranslationY |
+| 0       0       1            |
+```
+
+这里,`ScaleX、ScaleY、SkewX、SkewY、TranslationX` 和 `TranslationY` 是定义该变换的参数:
+
+- `ScaleX` 和 `ScaleY` 分别是 x 轴和 y 轴方向的缩放因子。
+- `SkewX` 和 `SkewY` 引入剪切效果,使形状产生“倾斜”。
+- `TranslationX` 和 `TranslationY` 是平移参数,分别将形状沿 x 与 y 方向移动。
+
+### 仿射变换的类型
+
+1. **平移(Translation)**:将图形或空间中的每个点沿指定方向移动相同的距离。主要影响 `TranslationX` 与 `TranslationY` 分量。
+
+2. **缩放(Scaling)**:将每个点的坐标乘以一个常数(x 轴方向使用 ScaleX,y 轴方向使用 ScaleY),从而放大或缩小其尺寸。缩放可以是均匀的(两个轴使用相同因子),也可以是非均匀的(两轴因子不同)。
+
+3. **旋转(Rotation)**:围绕某一点(通常是原点或指定点)对对象进行旋转。可以通过 `ScaleX、ScaleY、SkewX` 与 `SkewY` 的组合来表示,这些参数由旋转角的余弦和正弦推导得到。
+
+4. **剪切(Shearing)**:将平行线变换为仍然平行的直线,但移动它们的位置,使其不再垂直于原来的方向。影响 `SkewX` 与 `SkewY` 分量。
+
+5. **反射(Reflection)**:沿指定轴翻转对象,可通过缩放与旋转的组合来实现。
+
+### 数学性质
+
+- **共线性与共点性**:仿射变换保持点的共线性(点位于同一直线上)以及直线的共点性(直线的交点)。
+- **线段比例**:仿射变换还保持同一直线上各点之间距离的比例。
+
+## 仿射变换的组成
+
+在仿射变换中(这是处理图形、图像与几何数据的基础),**ScaleX**、**ScaleY**、**SkewX** 和 **SkewY** 这几个术语分别指代会改变对象形状与位置的特定变换:
+
+### ScaleX 与 ScaleY
+
+- **ScaleX**:表示沿 x 轴的缩放因子。它改变图像或对象的宽度。大于 1 的取值会增大宽度,小于 1 的取值会减小宽度,负值则会在缩放的同时将对象沿 x 轴反射。
+
+- **ScaleY**:表示沿 y 轴的缩放因子。它影响对象的高度。与 ScaleX 类似,大于 1 的取值会沿垂直方向放大对象,小于 1 的取值会缩小对象,负值则会沿 y 轴翻转对象。
+
+### SkewX 与 SkewY
+
+- **SkewX**:用于沿 x 轴方向对对象进行剪切或扭曲。它按每个点的 y 坐标的比例平移其 x 坐标,从而产生倾斜效果。该变换可用于在 2D 表达中营造深度或透视的视觉效果。
+
+- **SkewY**:与 SkewX 相对应,SkewY 沿 y 轴方向对对象进行剪切。它根据每个点的 x 坐标改变其 y 坐标,同样产生倾斜效果,但方向是垂直的。
+
+这些变换通常组合在一个变换矩阵中使用,使它们能够以协同且一致的方式作用于对象。下面是这种矩阵的典型表达:
+
+```
+| ScaleX  SkewX   TranslationX |
+| SkewY   ScaleY  TranslationY |
+| 0       0       1            |
+```
+
+这些参数可以以不同方式组合,从而在 2D 与 3D 图形应用中对图像或形状执行旋转、平移、缩放与剪切等复杂变换。
diff --git a/docs/api/sql/Raster-map-algebra.zh.md b/docs/api/sql/Raster-map-algebra.zh.md
new file mode 100644
index 0000000000..eb5b6e35c5
--- /dev/null
+++ b/docs/api/sql/Raster-map-algebra.zh.md
@@ -0,0 +1,145 @@
+<!--
+ 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.
+ -->
+
+## 地图代数(Map Algebra)
+
+地图代数是一种使用数学表达式来执行栅格计算的方法。表达式可以是简单的算术运算,也可以是多种运算的复杂组合。该表达式可以作用在单个栅格波段,也可以作用在多个栅格波段上。表达式的结果是一个新的栅格。
+
+!!!tip
+    要在 Jupyter notebook 中直观地查看地图代数运算的结果,可以使用 `SedonaUtils.display_image(df)`。它会自动识别栅格列并以图像形式渲染。详情请参阅 [Raster Output 文档](Raster-Functions.md#raster-output)。
+
+Apache Sedona 提供了两种执行地图代数运算的方法:
+
+1. 使用 `RS_MapAlgebra` 函数。
+2. 使用 `RS_BandAsArray` 及基于数组的地图代数函数,例如 `RS_Add`、`RS_Multiply` 等。
+
+一般来说,`RS_MapAlgebra` 函数更灵活,可用于执行更复杂的运算。该函数接收 3 到 4 个参数:
+
+```sql
+RS_MapAlgebra(rast: Raster, pixelType: String, script: String, [noDataValue: Double])
+```
+
+* `rast`:要应用地图代数表达式的栅格。
+* `pixelType`:输出栅格的数据类型。可选值为 `D`(double)、`F`(float)、`I`(integer)、`S`(short)、`US`(unsigned short)或 `B`(byte)。如果指定为 `NULL`,则输出栅格与输入栅格使用相同的数据类型。
+* `script`:地图代数脚本。[格式的更多说明请参见此处。](https://github.com/geosolutions-it/jai-ext/wiki/Jiffle)
+* `noDataValue`:(可选)输出栅格的 nodata 值。
+
+从 `v1.5.1` 版本起,`RS_MapAlgebra` 函数支持两个栅格列输入,并支持多波段栅格。该函数接受 5 个参数:
+
+```sql
+RS_MapAlgebra(rast0: Raster, rast1: Raster, pixelType: String, script: String, noDataValue: Double)
+```
+
+* `rast0`:第一个要应用地图代数表达式的栅格。
+* `rast1`:第二个要应用地图代数表达式的栅格。
+* `pixelType`:输出栅格的数据类型。可选值为 `D`(double)、`F`(float)、`I`(integer)、`S`(short)、`US`(unsigned short)或 `B`(byte)。如果指定为 `NULL`,则输出栅格与输入栅格使用相同的数据类型。
+* `script`:地图代数脚本。[格式的更多说明请参见此处。](https://github.com/geosolutions-it/jai-ext/wiki/Jiffle)
+* `noDataValue`:(非可选)输出栅格的 nodata 值,允许传 `null`。
+
+双栅格输入的 `RS_MapAlgebra` 的 Spark SQL 示例:
+
+```sql
+RS_MapAlgebra(rast0, rast1, 'D', 'out = rast0[0] * 0.5 + rast1[0] * 0.5;', null)
+```
+
+`RS_MapAlgebra` 的性能也很不错,因为它由 [Jiffle](https://github.com/geosolutions-it/jai-ext/wiki/Jiffle) 提供支持,可以被编译为 Java 字节码以
+执行。下面我们将演示如何用这两种方式实现常见的地图代数运算。
+
+!!!Note
+    `RS_MapAlgebra` 函数可以将输出栅格转换为 `pixelType` 指定的另一种数据类型:
+
+    - 如果 `pixelType` 比输入栅格的数据类型更小,会执行窄化转换,可能导致数据丢失。
+
+    - 如果 `pixelType` 更大,会执行扩宽转换,从而保留数据精度。
+
+    - 如果 `pixelType` 与输入栅格的数据类型一致,则不进行任何转换。
+
+    这使得用户可以控制输出像素的数据类型。在强制转换为较小类型时,应注意可能带来的精度影响。
+
+### NDVI
+
+归一化植被指数(NDVI, Normalized Difference Vegetation Index)是一种简单的图形化指标,可用于分析遥感测量数据(通常但并非必然来自太空平台),评估目标区域是否含有活的绿色植被。NDVI 已成为判断给定区域是否含有活绿色植被的事实标准。NDVI 的计算公式如下:
+
+```
+NDVI = (NIR - Red) / (NIR + Red)
+```
+
+其中 NIR 表示近红外波段,Red 表示红光波段。
+
+假设我们有若干个 4 波段的栅格,分别对应红、绿、蓝、近红外四个波段。我们希望为每个栅格计算 NDVI。可以使用 `RS_MapAlgebra` 函数来实现:
+
+```sql
+SELECT RS_MapAlgebra(rast, 'D', 'out = (rast[3] - rast[0]) / (rast[3] + rast[0]);') as ndvi FROM raster_table
+```
+
+这里的 Jiffle 脚本是 `out = (rast[3] - rast[0]) / (rast[3] + rast[0]);`。`rast` 变量始终绑定到输入栅格,
+而 `out` 变量绑定到输出栅格。Jiffle 会迭代输入栅格的每个像素,并为每个像素执行该脚本。`rast[3]` 与 `rast[0]`
+分别指代当前像素中近红外波段和红光波段的取值,`out` 变量则是当前的输出像素值。
+
+`RS_MapAlgebra` 函数的结果是一个单波段栅格。由于我们将 `pixelType` 指定为 `D`,该波段的类型为 double。
+
+也可以使用基于数组的地图代数函数实现相同的 NDVI 计算:
+
+```sql
+SELECT RS_Divide(
+        RS_Subtract(RS_BandAsArray(rast, 1), RS_BandAsArray(rast, 4)),
+        RS_Add(RS_BandAsArray(rast, 1), RS_BandAsArray(rast, 4))) as ndvi FROM raster_table
+```
+
+`RS_BandAsArray` 函数会将输入栅格中指定的波段提取为一个 double 数组,而 `RS_Add`、`RS_Subtract` 与 `RS_Divide` 函数则在数组上执行算术运算。使用基于数组的地图代数函数的代码相对更冗长。不过,还有一个 `RS_NormalizedDifference` 函数可以更简洁地计算 NDVI:
+
+```sql
+SELECT RS_NormalizedDifference(RS_BandAsArray(rast, 1), RS_BandAsArray(rast, 4)) as ndvi FROM raster_table
+```
+
+基于数组的地图代数函数的结果是一个 double 数组。用户可以使用 `RS_AddBandFromArray` 将该数组作为新的波段添加到栅格中。
+
+### AWEI
+
+自动水体提取指数(AWEI, Automated Water Extraction Index)是一种光谱指数,可用于从遥感影像中提取水体。AWEI 的计算公式如下:
+
+```
+AWEI = 4 * (Green - SWIR2) - (0.25 * NIR + 2.75 * SWIR1)
+```
+
+使用 `RS_MapAlgebra` 可以很容易地实现 AWEI:
+
+```sql
+-- Assume that the raster includes all 13 Sentinel-2 bands
+SELECT RS_MapAlgebra(rast, 'D', 'out = 4 * (rast[2] - rast[11]) - (0.25 * rast[7] + 2.75 * rast[12]);') as awei FROM raster_table
+```
+
+也可以使用基于数组的地图代数函数实现同样的 AWEI 计算,代码看起来更冗长:
+
+```sql
+SELECT RS_Subtract(
+    RS_Add(RS_MultiplyFactor(band_nir, 0.25), RS_MultiplyFactor(band_swir1, 2.75)),
+    RS_MultiplyFactor(RS_Subtract(band_swir2, band_green), 4)) as awei
+FROM (
+SELECT RS_BandAsArray(rast, 3) AS band_green,
+       RS_BandAsArray(rast, 12) AS band_swir2,
+       RS_BandAsArray(rast, 13) AS band_swir1,
+       RS_BandAsArray(rast, 8) AS band_nir
+FROM raster_table) t
+```
+
+### 延伸阅读
+
+* [Jiffle language summary](https://github.com/geosolutions-it/jai-ext/wiki/Jiffle---language-summary)
+* [Raster operators](Raster-Functions.md#raster-operators)
diff --git a/docs/api/sql/Reading-legacy-parquet.zh.md b/docs/api/sql/Reading-legacy-parquet.zh.md
new file mode 100644
index 0000000000..8c66199d54
--- /dev/null
+++ b/docs/api/sql/Reading-legacy-parquet.zh.md
@@ -0,0 +1,72 @@
+<!--
+ 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.
+ -->
+
+由于 Apache Sedona 1.4.0 对 `GeometryUDT` 的 SQL 类型
+([SEDONA-205](https://issues.apache.org/jira/browse/SEDONA-205))以及几何值的序列化格式
+([SEDONA-207](https://issues.apache.org/jira/browse/SEDONA-207))引入了破坏性变更,因此由 Apache Sedona 1.3.1 或更早版本写出的、包含几何列的 Parquet 文件无法被 Apache Sedona 1.4.0 或更高版本直接读取。
+
+对于在 Apache Sedona 1.3.1-incubating 或更早版本下、使用 `"parquet"` 格式写出的 parquet 文件:
+
+```python
+df.write.format("parquet").save("path/to/parquet/files")
+```
+
+如果用 Apache Sedona 1.4.0 或更高版本通过 `spark.read.format("parquet").load("path/to/parquet/files")` 来读取这些文件,将会抛出异常:
+
+```
+24/01/08 12:52:56 ERROR Executor: Exception in task 0.0 in stage 12.0 (TID 11)
+org.apache.spark.sql.AnalysisException: Invalid Spark read type: expected required group geom (LIST) {
+  repeated group list {
+    required int32 element (INTEGER(8,true));
+  }
+} to be list type but found Some(BinaryType)
+	at org.apache.spark.sql.execution.datasources.parquet.ParquetSchemaConverter$.checkConversionRequirement(ParquetSchemaConverter.scala:745)
+	at org.apache.spark.sql.execution.datasources.parquet.ParquetToSparkSchemaConverter.$anonfun$convertGroupField$3(ParquetSchemaConverter.scala:343)
+	at scala.Option.fold(Option.scala:251)
+	at org.apache.spark.sql.execution.datasources.parquet.ParquetToSparkSchemaConverter.convertGroupField(ParquetSchemaConverter.scala:324)
+	at org.apache.spark.sql.execution.datasources.parquet.ParquetToSparkSchemaConverter.convertField(ParquetSchemaConverter.scala:188)
+	at org.apache.spark.sql.execution.datasources.parquet.ParquetToSparkSchemaConverter.$anonfun$convertInternal$3(ParquetSchemaConverter.scala:147)
+	at org.apache.spark.sql.execution.datasources.parquet.ParquetToSparkSchemaConverter.$anonfun$convertInternal$3$adapted(ParquetSchemaConverter.scala:117)
+	at scala.collection.TraversableLike.$anonfun$map$1(TraversableLike.scala:286)
+	at scala.collection.immutable.Range.foreach(Range.scala:158)
+	at scala.collection.TraversableLike.map(TraversableLike.scala:286)
+	at scala.collection.TraversableLike.map$(TraversableLike.scala:279)
+	at scala.collection.AbstractTraversable.map(Traversable.scala:108)
+	...
+```
+
+自 v1.5.1 起,GeoParquet 支持读取旧版 Parquet 文件。你可以使用 `"geoparquet"` 格式,并加上 `.option("legacyMode", "true")` 选项。示例如下:
+
+=== "Scala/Java"
+
+	```scala
+	val df = sedona.read.format("geoparquet").option("legacyMode", "true").load("path/to/legacy-parquet-files")
+	```
+
+=== "Java"
+
+	```java
+	Dataset<Row> df = sedona.read.format("geoparquet").option("legacyMode", "true").load("path/to/legacy-parquet-files")
+	```
+
+=== "Python"
+
+	```python
+	df = sedona.read.format("geoparquet").option("legacyMode", "true").load("path/to/legacy-parquet-files")
+	```
diff --git a/docs/api/sql/Spider.zh.md b/docs/api/sql/Spider.zh.md
new file mode 100644
index 0000000000..0e0726dca1
--- /dev/null
+++ b/docs/api/sql/Spider.zh.md
@@ -0,0 +1,322 @@
+<!--
+ 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.
+ -->
+
+Sedona 提供了一个名为 Spider 的空间数据生成器。它是一个数据源,可以根据用户指定的参数生成随机的空间数据。
+
+## 快速入门
+
+在[创建好 `SedonaContext` 对象](Overview.md#quick-start)之后,你可以使用 `spider` 数据源创建一个 DataFrame。
+
+```python
+df_random_points = sedona.read.format("spider").load(n=1000, distribution="uniform")
+df_random_boxes = sedona.read.format("spider").load(
+    n=1000, distribution="gaussian", geometryType="box", maxWidth=0.05, maxHeight=0.05
+)
+df_random_polygons = sedona.read.format("spider").load(
+    n=1000,
+    distribution="bit",
+    geometryType="polygon",
+    minSegment=3,
+    maxSegment=5,
+    maxSize=0.1,
+)
+```
+
+现在我们得到了三个包含随机空间数据的 DataFrame。可以查看 `df_random_points` DataFrame 的前 3 行,确认数据已被正确生成。
+
+```python
+df_random_points.show(3, False)
+```
+
+输出:
+
+```
++---+---------------------------------------------+
+|id |geometry                                     |
++---+---------------------------------------------+
+|1  |POINT (0.8781393502074886 0.5925787985028703)|
+|2  |POINT (0.3159498147172185 0.1907316577342276)|
+|3  |POINT (0.2618294441170143 0.3623164670133922)|
++---+---------------------------------------------+
+only showing top 3 rows
+```
+
+生成的 DataFrame 有两列:`id` 和 `geometry`。`id` 列是每条记录的唯一标识,`geometry` 列是随机生成的空间数据。
+
+我们可以使用下面的代码绘制出全部 3 个 DataFrame:
+
+```python
+import matplotlib.pyplot as plt
+import geopandas as gpd
+
+# Convert DataFrames to GeoDataFrames
+gdf_random_points = gpd.GeoDataFrame(df_random_points.toPandas(), geometry="geometry")
+gdf_random_boxes = gpd.GeoDataFrame(df_random_boxes.toPandas(), geometry="geometry")
+gdf_random_polygons = gpd.GeoDataFrame(
+    df_random_polygons.toPandas(), geometry="geometry"
+)
+
+# Create a figure and a set of subplots
+fig, axes = plt.subplots(1, 3, figsize=(15, 5))
+
+# Plot each GeoDataFrame on a different subplot
+gdf_random_points.plot(ax=axes[0], color="blue", markersize=5)
+axes[0].set_title("Random Points")
+
+gdf_random_boxes.boundary.plot(ax=axes[1], color="red")
+axes[1].set_title("Random Boxes")
+
+gdf_random_polygons.boundary.plot(ax=axes[2], color="green")
+axes[2].set_title("Random Polygons")
+
+# Adjust the layout
+plt.tight_layout()
+
+# Show the plot
+plt.show()
+```
+
+输出:
+
+![Random Spatial Data](../../image/spider/spider-quickstart.png)
+
+你可以浏览 [SpiderWeb](https://spider.cs.ucr.edu/) 网站调试参数,观察它们对生成数据的影响。当你确定满意的参数后,便可以在自己的 Spider DataFrame 创建代码中使用它们。下面的章节会详细介绍各项参数。
+
+## 通用参数
+
+下列参数对所有分布都适用。
+
+| 参数 | 说明 | 默认值 |
+| --------- | ----------- | ------------- |
+| n         | 生成的记录数量 | 100 |
+| distribution | 分布类型。详见 [Distributions](#distributions)。 | `uniform` |
+| numPartitions | 生成的数据所使用的分区数 | 你的 Spark Context 的默认并行度 |
+| seed | 随机种子 | 当前时间戳(毫秒) |
+
+!!! warning
+    在不同的 Java 版本或 Sedona 版本下,相同的 `seed` 参数可能产生不同的结果。
+
+## 分布(Distributions)
+
+Spider 支持在多种分布下生成随机的点、矩形与多边形。你可以通过访问 [SpiderWeb](https://spider.cs.ucr.edu/) 网站来探索 Spider 的能力。可以通过 `distribution` 参数来指定分布类型。下面列出了各分布的参数。
+
+### 均匀分布(Uniform Distribution)
+
+均匀分布会在单位正方形 `[0, 1] x [0, 1]` 内生成随机几何对象。通过将 `distribution` 参数设为 `uniform` 即可选择该分布。
+
+| 参数 | 说明 | 默认值 |
+| --------- | ----------- | ------------- |
+| geometryType | 几何类型,可选 `point`、`box` 或 `polygon` | `point` |
+| maxWidth | 生成的矩形的最大宽度 | 0.01 |
+| maxHeight | 生成的矩形的最大高度 | 0.01 |
+| minSegment | 生成的多边形的最少边数 | 3 |
+| maxSegment | 生成的多边形的最多边数 | 3 |
+| maxSize | 生成的多边形的最大尺寸 | 0.01 |
+
+示例:
+
+```python
+import geopandas as gpd
+
+df = sedona.read.format("spider").load(
+    n=300, distribution="uniform", geometryType="box", maxWidth=0.05, maxHeight=0.05
+)
+gpd.GeoDataFrame(df.toPandas(), geometry="geometry").boundary.plot()
+```
+
+![Uniform Distribution](../../image/spider/spider-uniform.png)
+
+### 高斯分布(Gaussian Distribution)
+
+高斯分布在均值为 `[0.5, 0.5]`、标准差为 `[0.1, 0.1]` 的高斯分布下生成随机几何对象。通过将 `distribution` 参数设为 `gaussian` 即可选择该分布。
+
+| 参数 | 说明 | 默认值 |
+| --------- | ----------- | ------------- |
+| geometryType | 几何类型,可选 `point`、`box` 或 `polygon` | `point` |
+| maxWidth | 生成的矩形的最大宽度 | 0.01 |
+| maxHeight | 生成的矩形的最大高度 | 0.01 |
+| minSegment | 生成的多边形的最少边数 | 3 |
+| maxSegment | 生成的多边形的最多边数 | 3 |
+| maxSize | 生成的多边形的最大尺寸 | 0.01 |
+
+示例:
+
+```python
+import geopandas as gpd
+
+df = sedona.read.format("spider").load(
+    n=300, distribution="gaussian", geometryType="polygon", maxSize=0.05
+)
+gpd.GeoDataFrame(df.toPandas(), geometry="geometry").boundary.plot()
+```
+
+![Gaussian Distribution](../../image/spider/spider-gaussian.png)
+
+### 位分布(Bit Distribution)
+
+位分布按一种 bit 分布生成随机几何对象。通过将 `distribution` 参数设为 `bit` 即可选择该分布。
+
+| 参数 | 说明 | 默认值 |
+| --------- | ----------- | ------------- |
+| geometryType | 几何类型,可选 `point`、`box` 或 `polygon` | `point` |
+| probability | 设置某一位为 1 的概率 | 0.2 |
+| digits | 生成数据中的位数 | 10 |
+| maxWidth | 生成的矩形的最大宽度 | 0.01 |
+| maxHeight | 生成的矩形的最大高度 | 0.01 |
+| minSegment | 生成的多边形的最少边数 | 3 |
+| maxSegment | 生成的多边形的最多边数 | 3 |
+| maxSize | 生成的多边形的最大尺寸 | 0.01 |
+
+示例:
+
+```python
+import geopandas as gpd
+
+df = sedona.read.format("spider").load(
+    n=300, distribution="bit", geometryType="point", probability=0.2, digits=10
+)
+gpd.GeoDataFrame(df.toPandas(), geometry="geometry").plot(markersize=1)
+```
+
+![Bit Distribution](../../image/spider/spider-bit.png)
+
+### 对角分布(Diagonal Distribution)
+
+对角分布在对角线 `y = x` 上生成随机几何对象,对不完全落在对角线上的几何对象施加一定的离散。通过将 `distribution` 参数设为 `diagonal` 即可选择该分布。
+
+| 参数 | 说明 | 默认值 |
+| --------- | ----------- | ------------- |
+| geometryType | 几何类型,可选 `point`、`box` 或 `polygon` | `point` |
+| percentage | 恰好落在对角线上的记录所占比例 | 0.5 |
+| buffer | 对未完全落在对角线上的点,其离散范围(缓冲)大小 | 0.5 |
+| maxWidth | 生成的矩形的最大宽度 | 0.01 |
+| maxHeight | 生成的矩形的最大高度 | 0.01 |
+| minSegment | 生成的多边形的最少边数 | 3 |
+| maxSegment | 生成的多边形的最多边数 | 3 |
+| maxSize | 生成的多边形的最大尺寸 | 0.01 |
+
+示例:
+
+```python
+import geopandas as gpd
+
+df = sedona.read.format("spider").load(
+    n=300, distribution="diagonal", geometryType="point", percentage=0.5, buffer=0.5
+)
+gpd.GeoDataFrame(df.toPandas(), geometry="geometry").plot(markersize=1)
+```
+
+![Diagonal Distribution](../../image/spider/spider-diagonal.png)
+
+### 谢尔宾斯基分布(Sierpinski Distribution)
+
+谢尔宾斯基分布在一个谢尔宾斯基三角形上分布地生成随机几何对象。通过将 `distribution` 参数设为 `sierpinski` 即可选择该分布。
+
+| 参数 | 说明 | 默认值 |
+| --------- | ----------- | ------------- |
+| geometryType | 几何类型,可选 `point`、`box` 或 `polygon` | `point` |
+| maxWidth | 生成的矩形的最大宽度 | 0.01 |
+| maxHeight | 生成的矩形的最大高度 | 0.01 |
+| minSegment | 生成的多边形的最少边数 | 3 |
+| maxSegment | 生成的多边形的最多边数 | 3 |
+| maxSize | 生成的多边形的最大尺寸 | 0.01 |
+
+示例:
+
+```python
+import geopandas as gpd
+
+df = sedona.read.format("spider").load(
+    n=2000, distribution="sierpinski", geometryType="point"
+)
+gpd.GeoDataFrame(df.toPandas(), geometry="geometry").plot(markersize=1)
+```
+
+![Sierpinski Distribution](../../image/spider/spider-sierpinski.png)
+
+### 地块分布(Parcel Distribution)
+
+该生成器生成类似地块的矩形。其工作方式是沿最长维度递归地切分输入域(单位正方形),然后随机抖动(dither)每个生成的矩形以增加随机性。该生成器仅能生成矩形。通过将 `distribution` 参数设为 `parcel` 即可选择该分布。
+
+| 参数 | 说明 | 默认值 |
+| --------- | ----------- | ------------- |
+| dither | 抖动量,以边长的比例表示。允许范围 [0, 1] | 0.5 |
+| splitRange | 切分矩形时允许的范围。允许范围 [0.0, 0.5]。0.0 表示允许任意切分值,0.5 表示总是从中间切分。 | 0.5 |
+
+示例:
+
+```python
+import geopandas as gpd
+
+df = sedona.read.format("spider").load(
+    n=300, distribution="parcel", dither=0.5, splitRange=0.5
+)
+gpd.GeoDataFrame(df.toPandas(), geometry="geometry").boundary.plot()
+```
+
+![Parcel Distribution](../../image/spider/spider-parcel.png)
+
+!!!note
+    `parcel` 分布生成的分区数始终是 4 的幂。这是为了保证所生成数据的质量。如果指定的 `numPartitions` 不是 4 的幂,会被自动调整为不大于指定值的、最接近的 4 的幂。
+
+## 仿射变换
+
+Spider 生成的随机空间数据多数位于单位正方形 `[0, 1] x [0, 1]` 中。如果你希望在不同的区域内生成随机空间数据,可以通过指定仿射变换参数对数据进行缩放和平移,将其转换到目标区域。
+
+下面的代码展示了如何通过仿射变换在不同区域内生成随机空间数据。
+
+仿射变换的参数如下:
+
+| 参数 | 说明 | 默认值 |
+| --------- | ----------- | ------------- |
+| translateX | 水平方向平移数据 | 0 |
+| translateY | 垂直方向平移数据 | 0 |
+| scaleX | 水平方向缩放数据 | 1 |
+| scaleY | 垂直方向缩放数据 | 1 |
+| skewX | 水平方向剪切数据 | 0 |
+| skewY | 垂直方向剪切数据 | 0 |
+
+仿射变换按如下方式作用于生成的数据:
+
+```
+x' = translateX + scaleX * x + skewX * y
+y' = translateY + skewY * x + scaleY * y
+```
+
+示例:
+
+```python
+import geopandas as gpd
+
+df_random_points = sedona.read.format("spider").load(
+    n=1000, distribution="uniform", translateX=0.5, translateY=0.5, scaleX=2, scaleY=2
+)
+gpd.GeoDataFrame(df_random_points.toPandas(), geometry="geometry").plot(markersize=1)
+```
+
+此时数据位于区域 `[0.5, 2.5] x [0.5, 2.5]` 内。
+
+![Affine Transformation](../../image/spider/spider-uniform-affine.png)
+
+## 参考资料
+
+- Puloma Katiyar, Tin Vu, Sara Migliorini, Alberto Belussi, Ahmed Eldawy. "SpiderWeb: A Spatial Data Generator on the Web", ACM SIGSPATIAL 2020, Seattle, WA
+- Beast Spatial Data Generator: https://bitbucket.org/bdlabucr/beast/src/master/doc/spatial-data-generator.md
+- SpiderWeb: A Spatial Data Generator on the Web: https://spider.cs.ucr.edu/
+- SpiderWeb YouTube Video: https://www.youtube.com/watch?v=h0xCG6Swdqw
diff --git a/docs/api/sql/Visualization-SedonaKepler.zh.md b/docs/api/sql/Visualization-SedonaKepler.zh.md
new file mode 100644
index 0000000000..06b2c7dce8
--- /dev/null
+++ b/docs/api/sql/Visualization-SedonaKepler.zh.md
@@ -0,0 +1,96 @@
+<!--
+ 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.
+ -->
+
+SedonaKepler 提供了一组 API,便于在 Jupyter notebook/lab 环境中对地理空间数据进行快速、交互式的可视化。
+
+要开始使用 SedonaKepler,只需通过下面的方式导入 Sedona:
+
+```python
+from sedona.spark import *
+```
+
+也可以使用以下方式导入:
+
+```python
+from sedona.spark import SedonaKepler
+```
+
+下面是 SedonaKepler 暴露的所有 API 的详细说明:
+
+### **使用 SedonaKepler.create_map 创建地图对象**
+
+SedonaKepler 暴露的 create_map API 的签名如下:
+
+```python
+def create_map(
+    df: SedonaDataFrame = None, name: str = "unnamed", config: dict = None
+) -> map: ...
+```
+
+参数 'name' 用于在地图对象中关联传入的 SedonaDataFrame,应用到该地图上的任何配置都会与该名称绑定。建议为 dataframe 传入唯一的标识符。
+
+如果没有传入 SedonaDataFrame 对象,会返回一个空地图(如果传入了 config 则会应用该 config)。之后可以通过 `add_df` 方法添加 SedonaDataFrame。
+
+也可以可选地传入一个 map config,对地图进行预设的定制。
+
+!!!Note
+    map config 是按显示的 SedonaDataFrame 的名称来引用每一项定制配置的,如果名称不匹配,则该 config 不会被应用到地图对象上。
+
+!!! abstract "示例用法(参考自 Sedona Jupyter 示例)"
+
+	=== "Python"
+		```python
+		map = SedonaKepler.create_map(df=groupedresult, name="AirportCount")
+		map
+		```
+
+### **使用 SedonaKepler.add_df 向地图对象添加 SedonaDataFrame**
+
+SedonaKepler 暴露的 add_df API 的签名如下:
+
+```python
+def add_df(map, df: SedonaDataFrame, name: str = "unnamed"): ...
+```
+
+该 API 可用于向已经创建的地图对象添加一个 SedonaDataFrame。传入的 map 对象会被直接修改,不返回任何值。
+
+参数 name 的约束条件与 'create_map' 相同。
+
+!!!Tip
+    可以通过该方法向一个地图对象添加多个 dataframe,从而在同一张地图上一起可视化。
+
+!!! abstract "示例用法(参考自 Sedona Jupyter 示例)"
+    === "Python"
+    ```python
+    map = SedonaKepler.create_map()
+    SedonaKepler.add_df(map, groupedresult, name="AirportCount")
+    map
+    ```
+
+### **通过地图设置配置**
+
+由 SedonaKepler 创建的地图对象在被访问渲染时,会附带一个 config 面板,可用于自定义地图
+
+### **保存与设置 config**
+
+可以通过访问地图对象的 'config' 属性(如 `map.config`)来获取其当前 config。如果每次都需要渲染完全相同的地图,可以将该 config 保存下来以备后续使用,或在不同 notebook 之间复用。
+
+!!!Note
+    map config 是按 dataframe 的名称来引用每一项已应用的定制配置的,因此它只在使用相同 dataframe 名称的地图上生效。
+    更多细节请参见 keplerGl 文档:[这里](https://docs.kepler.gl/docs/keplergl-jupyter#6.-match-config-with-data)
diff --git a/docs/api/sql/Visualization-SedonaPyDeck.zh.md b/docs/api/sql/Visualization-SedonaPyDeck.zh.md
new file mode 100644
index 0000000000..443f41e044
--- /dev/null
+++ b/docs/api/sql/Visualization-SedonaPyDeck.zh.md
@@ -0,0 +1,161 @@
+<!--
+ 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.
+ -->
+
+SedonaPyDeck 提供了一组 API,便于在 Jupyter notebook/lab 环境中对地理空间数据进行快速、交互式的可视化。
+
+要开始使用 SedonaPyDeck,只需通过下面的方式导入 Sedona:
+
+```python
+from sedona.spark import *
+```
+
+也可以使用以下方式导入:
+
+```python
+from sedona.spark import SedonaPyDeck
+```
+
+!!!Note
+    关于可选参数的更多说明,请访问 [PyDeck 文档](https://deckgl.readthedocs.io/en/latest/deck.html)。
+
+    当用户为 `map_style` 选择 'salellite' 选项时,SedonaPyDeck 默认假定地图提供方为 Mapbox。
+
+下面是 SedonaPyDeck 暴露的所有 API 的详细说明:
+
+### **几何对象地图(Geometry Map)**
+
+```python
+def create_geometry_map(
+    df,
+    fill_color="[85, 183, 177, 255]",
+    line_color="[85, 183, 177, 255]",
+    elevation_col=0,
+    initial_view_state=None,
+    map_style=None,
+    map_provider=None,
+    api_keys=None,
+    stroked=True,
+): ...
+```
+
+参数 `fill_color` 可以传入一组 RGB/RGBA 值的列表,也可以传入一个根据某列值生成 RGB/RGBA 取值的字符串,用于为地图中的多边形或点几何对象着色。
+
+参数 `line_color` 可以传入一组 RGB/RGBA 值的列表,也可以传入一个根据某列值生成 RGB/RGBA 取值的字符串,用于为地图中的线几何对象着色。
+
+参数 `elevation_col` 可以传入一个静态高程值,也可以像 `fill_color` 一样基于列值给出高程;仅对地图中的多边形几何对象生效。
+
+参数 `stroked` 决定是否在多边形和点周围绘制描边,接受布尔值。更多信息请参阅 [deck.gl 的相关文档](https://deck.gl/docs/api-reference/layers/geojson-layer#:~:text=%27circle%27.-,stroked,-(boolean%2C%20optional))。
+
+可选地,可以传入 `initial_view_state`、`map_style`、`map_provider`、`api_keys` 等参数,按用户喜好配置地图。
+关于参数及其默认值的更多信息,可以在 PyDeck 网站,以及 deck.gl 的[相关页面](https://github.com/visgl/deck.gl/blob/8.9-release/docs/api-reference/layers/geojson-layer.md)中找到。
+
+### **分级统计地图(Choropleth Map)**
+
+```python
+def create_choropleth_map(
+    df,
+    fill_color=None,
+    plot_col=None,
+    initial_view_state=None,
+    map_style=None,
+    map_provider=None,
+    api_keys=None,
+    elevation_col=0,
+    stroked=True,
+): ...
+```
+
+参数 `fill_color` 可以传入一组 RGB/RGBA 值的列表,也可以传入一个根据某列值生成 RGB/RGBA 取值的字符串。
+
+参数 `stroked` 决定是否在多边形和点周围绘制描边,接受布尔值。更多信息请参阅 [deck.gl 的相关文档](https://deck.gl/docs/api-reference/layers/geojson-layer#:~:text=%27circle%27.-,stroked,-(boolean%2C%20optional))。
+
+例如,下面这些都是 fill_color 的合法取值:
+
+```python
+fill_color = [255, 12, 250]
+fill_color = [0, 12, 250, 255]
+fill_color = (
+    "[0, 12, 240, AirportCount * 10]"  ## AirportCount is a column in the passed df
+)
+```
+
+除传入 `fill_color` 参数外,也可以传入 'plot_col',指定用于决定分级统计的列。
+随后 SedonaPyDeck 会根据该列的取值创建一个默认的配色方案。
+
+参数 `elevation_col` 可以传入数值,或包含列名(及其上的运算)的字符串值,用于为所绘制的多边形(如有)设置 3D 高程。
+
+可选地,可以传入 `initial_view_state`、`map_style`、`map_provider`、`api_keys` 等参数,按用户喜好配置地图。
+关于参数及其默认值的更多信息可以在 PyDeck 网站上找到。
+
+### **散点图(Scatterplot)**
+
+```python
+def create_scatterplot_map(
+    df,
+    fill_color="[255, 140, 0]",
+    radius_col=1,
+    radius_min_pixels=1,
+    radius_max_pixels=10,
+    radius_scale=1,
+    initial_view_state=None,
+    map_style=None,
+    map_provider=None,
+    api_keys=None,
+): ...
+```
+
+参数 `fill_color` 可以传入一组 RGB/RGBA 值的列表,也可以传入一个根据某列值生成 RGB/RGBA 取值的字符串。
+
+参数 `radius_col` 可以传入数值,或包含列名上各种运算的字符串值,用于指定绘制点的半径。
+
+参数 `radius_min_pixels` 可以传入数值,用于设定以像素为单位的最小半径。可以防止在缩小时绘制的圆变得过小。
+
+参数 `radius_max_pixels` 可以传入数值,用于设定以像素为单位的最大半径。可以防止在放大时圆变得过大。
+
+参数 `radius_scale` 可以传入数值,作用于所有点的全局半径乘数。
+
+可选地,可以传入 `initial_view_state`、`map_style`、`map_provider`、`api_keys` 等参数,按用户喜好配置地图。
+关于参数及其默认值的更多信息,可以在 PyDeck 网站,以及 deck.gl 的[相关页面](https://github.com/visgl/deck.gl/blob/8.9-release/docs/api-reference/layers/scatterplot-layer.md)中找到。
+
+### **热力图(Heatmap)**
+
+```python
+def create_heatmap(
+    df,
+    color_range=None,
+    weight=1,
+    aggregation="SUM",
+    initial_view_state=None,
+    map_style=None,
+    map_provider=None,
+    api_keys=None,
+): ...
+```
+
+参数 `color_range` 可以可选地传入一组 RGB 值的列表,SedonaPyDeck 默认使用 `6-class YlOrRd` 作为 color_range。
+更多示例可参见 [colorbrewer](https://colorbrewer2.org/#type=sequential&scheme=YlOrRd&n=6)。
+
+参数 `weight` 可以传入数值,或包含列名及其上运算的字符串值,用于在绘制热力图时确定每个点的权重。
+默认情况下,SedonaPyDeck 将每个点的权重设为 1。
+
+参数 `aggregation` 可用于定义热力图在缩小(聚合到更低分辨率)时所采用的聚合策略。
+可选 "MEAN" 或 "SUM"。SedonaPyDeck 默认使用 "MEAN" 作为聚合策略。
+
+可选地,可以传入 `initial_view_state`、`map_style`、`map_provider`、`api_keys` 等参数,按用户喜好配置地图。
+关于参数及其默认值的更多信息,可以在 PyDeck 网站,以及 deck.gl 的[相关页面](https://github.com/visgl/deck.gl/blob/8.9-release/docs/api-reference/aggregation-layers/heatmap-layer.md)中找到。
diff --git a/docs/api/stats/sql.zh.md b/docs/api/stats/sql.zh.md
new file mode 100644
index 0000000000..6f248775db
--- /dev/null
+++ b/docs/api/stats/sql.zh.md
@@ -0,0 +1,244 @@
+<!--
+ 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.
+ -->
+
+## 概述
+
+Sedona 的 stats 模块为带有空间列的 dataframe 提供了用于地理空间
+统计分析的 Scala 和 Python 函数。
+stats 模块构建在 core 模块之上,提供了一组可用于
+对这些 dataframe 进行空间分析的函数。stats 模块设计上配合 core 模块以及
+viz 模块共同使用,从而提供一套完整的地理空间分析工具。
+
+## 使用 DBSCAN
+
+DBSCAN 函数在 scala/java 中位于 `org.apache.sedona.stats.clustering.DBSCAN.dbscan`,在 python 中位于 `sedona.stats.clustering.dbscan.dbscan`。
+
+该函数使用 DBSCAN 算法为 dataframe 的每一条记录标注一个聚类标签。
+dataframe 应至少包含一列 `GeometryType` 类型的列。各行必须唯一。如果仅有一列
+几何列,会自动使用该列。如果有两列,会使用名为
+'geometry' 的那一列。如果有多于一列且没有任何一列名为 'geometry',则
+必须显式提供列名。新增列将命名为 'cluster'。
+
+### 参数
+
+括号中的名字是 python 中的变量名
+
+- dataframe —— 待聚类的 dataframe。必须包含至少一列 GeometryType 列
+- epsilon —— DBSCAN 算法的最小距离参数
+- minPts (min_pts) —— DBSCAN 算法的最小点数参数
+- geometry —— 几何列的列名
+- includeOutliers (include_outliers) —— 是否在输出中包含离群点。默认为 false
+- useSpheroid (use_spheroid) —— 是否使用椭球距离计算(而非笛卡尔距离)。默认为 false
+
+输出是输入 DataFrame,每一行新增了聚类标签。如果包含离群点,离群点的聚类值为 -1。
+
+## 使用局部离群因子(LOF)
+
+LOF 函数在 scala/java 中位于 `org.apache.sedona.stats.outlierDetection.LocalOutlierFactor.localOutlierFactor`,在 python 中位于 `sedona.stats.outlier_detection.local_outlier_factor.local_outlier_factor`。
+
+该函数为 dataframe 的每一条记录新增一列,记录其局部离群因子。
+dataframe 应至少包含一列 `GeometryType` 类型的列。各行必须唯一。如果仅有一列
+几何列,会自动使用该列。如果有两列,会使用名为
+'geometry' 的那一列。如果有多于一列且没有任何一列名为 'geometry',则
+必须显式提供列名。
+
+### 参数
+
+括号中的名字是 python 中的变量名
+
+- dataframe —— 包含点几何对象的 dataframe
+- k —— 计算 LOF 时考虑的最近邻居的数量
+- geometry —— 几何列的列名
+- handleTies (handle_ties) —— 是否在 k 距离计算中处理并列情形。默认为 false
+- useSpheroid (use_spheroid) —— 是否使用椭球距离计算(而非笛卡尔距离)。默认为 false
+
+输出是输入 DataFrame,每一行新增了 lof 值。
+
+## 使用 Getis-Ord Gi(*)
+
+G Local 函数在 scala/java 中位于 `org.apache.sedona.stats.hotspotDetection.GetisOrd.gLocal`,在 python 中位于 `sedona.stats.hotspot_detection.getis_ord.g_local`。
+
+对 dataframe 的 x 列执行 Gi 或 Gi* 统计。
+
+权重应为本行的邻居。权重元素应为包含 value 列与 neighbor 列的结构体。neighbor 列的内容应是
+与父行同类型的邻居(但不再包含 neighbors)。生成此列的方法请参见 _Using the Distance
+Weighting Function_ 一节。要计算 Gi*
+统计量,请确保焦点观测值位于邻居数组中(即本行本身出现在 weights 列中)且 `star=true`。显著性通过 z 分数计算。
+
+### 参数
+
+- dataframe —— 用于执行 G 统计的 dataframe
+- x —— 要执行热点分析的列名
+- weights —— 包含邻居数组的列名。neighbor 列的内容应是与父行同类型的邻居(但不再包含 neighbors)。你可以使用 `Weighting` 类的函数来生成该列。
+- star —— 焦点观测值是否包含在邻居数组中。若为 true 则计算 Gi*,否则计算 Gi
+
+输出是输入 DataFrame,每一行新增以下列:G、E[G]、V[G]、Z、P。
+
+## 使用距离加权函数
+
+Weighting 相关函数在 scala/java 中位于 `org.apache.sedona.stats.Weighting`,在 python 中位于 `sedona.stats.weighting`。
+
+该函数会新增一列,包含一组由 value 列和 neighbor 列构成的结构体数组。
+
+通用的 `addDistanceBandColumn`(python 中为 `add_distance_band_column`)函数会为 dataframe 添加一个 weights 列,包含距离阈值内的其他记录及其权重。
+
+dataframe 应至少包含一列 `GeometryType` 类型的列。各行必须唯一。如果仅有一列
+几何列,会自动使用该列。如果有两列,会使用名为
+'geometry' 的那一列。如果有多于一列且没有任何一列名为 'geometry',则
+必须显式提供列名。新增列将命名为 'cluster'。
+
+### 参数
+
+#### addDistanceBandColumn
+
+括号中的名字是 python 中的变量名
+
+- dataframe —— 包含几何列的 DataFrame
+- threshold —— 判定邻居的距离阈值
+- binary —— 邻居使用二进制权重还是反距离权重(dist^alpha)
+- alpha —— 反距离权重使用的 alpha 值,当 binary 为 true 时忽略
+- includeZeroDistanceNeighbors (include_zero_distance_neighbors) —— 是否包含距离为 0 的邻居。若包含且 binary 为 false,按浮点规范(除以 0),其值会是无穷大
+- includeSelf (include_self) —— 是否将自身包含在邻居列表中
+- selfWeight (self_weight) —— 自身权重的取值
+- geometry —— 几何列的列名
+- useSpheroid (use_spheroid) —— 是否使用椭球距离计算(而非笛卡尔距离)。默认为 false
+
+#### addBinaryDistanceBandColumn
+
+括号中的名字是 python 中的变量名
+
+- dataframe —— 包含几何列的 DataFrame
+- threshold —— 判定邻居的距离阈值
+- includeZeroDistanceNeighbors (include_zero_distance_neighbors) —— 是否包含距离为 0 的邻居。若包含且 binary 为 false,按浮点规范(除以 0),其值会是无穷大
+- includeSelf (include_self) —— 是否将自身包含在邻居列表中
+- selfWeight (self_weight) —— 自身权重的取值
+- geometry —— 几何列的列名
+- useSpheroid (use_spheroid) —— 是否使用椭球距离计算(而非笛卡尔距离)。默认为 false
+
+以上两种函数的输出均为输入 DataFrame,每一行新增 weights 列。
+
+## Moran I
+
+Moran I 是一种空间自相关算法,它同时使用空间
+位置和非空间属性。当取值接近 1 时
+表示存在空间相关性;当取值接近 0 时
+表示不存在相关性,数据随机分布;当
+MoranI 自相关值接近 -1 时表示存在负
+相关。负相关意味着邻近的取值彼此差异较大。
+
+下图展示了不同空间相关性的取值
+
+- 左侧为负相关(-1)
+- 中间为正相关(1)
+- 右侧相关性接近 0,数据是随机的。
+
+![moranI.png](../../image/moranI.png)
+
+Moran 统计可以作为 Scala/Java 与 Python 函数使用。
+该输入函数需要一个 weight DataFrame。你可以用
+Apache Sedona 的加权函数来构造该 weight DataFrame。需要注意的是,
+你的输入必须包含一个唯一标识要素的 id 列以及一个 value 字段。MoranI Apache Sedona 函数
+所需的最简 schema 如下:
+
+```
+ |-- id: integer (nullable = true)
+ |-- value: double (nullable = true)
+ |-- weights: array (nullable = false)
+ |    |-- element: struct (containsNull = false)
+ |    |    |-- neighbor: struct (nullable = false)
+ |    |    |    |-- id: integer (nullable = true)
+ |    |    |    |-- value: double (nullable = true)
+ |    |    |-- value: double (nullable = true)
+```
+
+你可以通过函数参数控制 value 列的列名和 id。
+
+要使用 [Apache Sedona 权重函数](#adddistancebandcolumn),需要把 id 列和 value 列传给保留参数。
+
+=== "Scala"
+
+    ```scala
+    val weights = Weighting.addDistanceBandColumn(
+          positiveCorrelationFrame,
+          1.0,
+          savedAttributes = Seq("id", "value")
+    )
+
+    val moranResult = Moran.getGlobal(weights, idColumn = "id")
+
+    // result fields
+    moranResult.getPNorm
+    moranResult.getI
+    moranResult.getZNorm
+    ```
+
+=== "Python"
+
+    ```python
+    from sedona.spark.stats.autocorrelation.moran import Moran
+    from sedona.spark.stats.weighting import add_binary_distance_band_column
+
+    result = add_binary_distance_band_column(df, 1.0, saved_attributes=["id", "value"])
+
+    moran_i_result = Moran.get_global(result)
+
+    ## result fields
+    moran_i_result.p_norm
+    moran_i_result.i
+    moran_i_result.z_norm
+    ```
+
+结果中会得到 Z norm、P norm 以及 Moran I 值。
+
+下面是函数的完整签名
+
+=== "Scala"
+
+    ```scala
+    def getGlobal(
+      dataframe: DataFrame,
+      twoTailed: Boolean = true,
+      idColumn: String = ID_COLUMN,
+      valueColumnName: String = VALUE_COLUMN): MoranResult
+
+    // java interface
+    public interface MoranResult {
+        public double getI();
+        public double getPNorm();
+        public double getZNorm();
+    }
+    ```
+
+=== "Python"
+
+    ```python
+    def get_global(
+        df: DataFrame,
+        two_tailed: bool = True,
+        id_column: str = "id",
+        value_column: str = "value",
+    ) -> MoranResult: ...
+
+
+    @dataclass
+    class MoranResult:
+        i: float
+        p_norm: float
+        z_norm: float
+    ```
diff --git a/docs/api/viz/java-api.zh.md b/docs/api/viz/java-api.zh.md
new file mode 100644
index 0000000000..e1b26ab735
--- /dev/null
+++ b/docs/api/viz/java-api.zh.md
@@ -0,0 +1,22 @@
+<!--
+ 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.
+ -->
+
+请阅读 [Javadoc](../../javadoc/spark/)
+
+注意:Scala 可以无缝调用 Java API。这意味着 Scala 用户与 Java 用户使用相同的 API。
diff --git a/docs/api/viz/sql.zh.md b/docs/api/viz/sql.zh.md
new file mode 100644
index 0000000000..3d633aab36
--- /dev/null
+++ b/docs/api/viz/sql.zh.md
@@ -0,0 +1,161 @@
+<!--
+ 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.
+ -->
+
+## 快速入门
+
+详细说明请参见:[可视化空间 DataFrame/RDD](../../tutorial/viz.md)。
+
+1. 在你的项目 pom.xml 或 build.sbt 中加入 Sedona-core、Sedona-SQL、Sedona-Viz
+2. 声明你的 Spark Session
+
+```scala
+sparkSession = SparkSession.builder().
+config("spark.serializer","org.apache.spark.serializer.KryoSerializer").
+config("spark.kryo.registrator", "org.apache.sedona.viz.core.Serde.SedonaVizKryoRegistrator").
+master("local[*]").appName("mySedonaVizDemo").getOrCreate()
+```
+
+3. 在 SparkSession 声明之后加上以下代码:
+
+```scala
+SedonaSQLRegistrator.registerAll(sparkSession)
+SedonaVizRegistrator.registerAll(sparkSession)
+```
+
+## 常规函数
+
+### ST_Colorize
+
+简介:根据像素的权重返回对应的颜色。权重可以是空间对象的空间聚合值,也可以是诸如温度、湿度等空间观测值。
+
+!!!note
+	该颜色在 DataFrame 中被编码为 Integer 类型的数值。当你打印它时,看到的会是一些看似无意义的数字。可以直接把它们当作 GeoSparkViz 中的颜色处理。
+
+格式:
+
+```
+ST_Colorize (weight: Double, maxWeight: Double, mandatory color: String (Optional))
+```
+
+起始版本:`v1.0.0`
+
+#### 生成不同颜色 —— 热力图
+
+该函数会根据所有像素中的最大权重对当前权重做归一化,从而让不同像素得到不同的颜色。
+
+SQL 示例
+
+```sql
+SELECT pixels.px, ST_Colorize(pixels.weight, 999) AS color
+FROM pixels
+```
+
+#### 生成统一颜色 —— 散点图
+
+如果将一个强制颜色名作为第三个输入参数传入,该函数会直接输出该颜色,而忽略权重。这种情况下,所有像素都使用同一个颜色。
+
+SQL 示例
+
+```sql
+SELECT pixels.px, ST_Colorize(pixels.weight, 999, 'red') AS color
+FROM pixels
+```
+
+下面是一些可输入的颜色名示例:
+
+```
+"firebrick"
+"#aa38e0"
+"0x40A8CC"
+"rgba(112,36,228,0.9)"
+```
+
+预定义颜色的完整列表请参见 [AWT Colors](https://static.javadoc.io/org.beryx/awt-color-factory/1.0.0/org/beryx/awt/color/ColorFactory.html)。
+
+### ST_EncodeImage
+
+简介:返回一个 Java PNG BufferedImage 的 base64 字符串表示。该函数主要用于服务端—客户端环境,例如将 base64 字符串从 GeoSparkViz 传输到 Apache Zeppelin。
+
+格式:`ST_EncodeImage (A: Image)`
+
+起始版本:`v1.0.0`
+
+SQL 示例
+
+```sql
+SELECT ST_EncodeImage(images.img)
+FROM images
+```
+
+### ST_Pixelize
+
+简介:在给定的分辨率下,将一个几何对象转换成像素数组
+
+你应当与 `Lateral View` 和 `Explode` 一起使用该函数。
+
+格式:
+
+```
+ST_Pixelize (A: Geometry, ResolutionX: Integer, ResolutionY: Integer, Boundary: Geometry)
+```
+
+起始版本:`v1.0.0`
+
+SQL 示例
+
+```sql
+SELECT ST_Pixelize(shape, 256, 256, (ST_Envelope_Aggr(shape) FROM pointtable))
+FROM polygondf
+```
+
+### ST_TileName
+
+简介:返回给定缩放级别下的地图瓦片名称。请参阅 [OpenStreetMap ZoomLevel](http://wiki.openstreetmap.org/wiki/Zoom_levels) 和 [OpenStreetMap tile name](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)。
+
+!!!note
+	瓦片名称的格式为 "Z-X-Y" 字符串。Z 为缩放级别,X 为 X 轴上的瓦片坐标,Y 为 Y 轴上的瓦片坐标。
+
+格式:`ST_TileName (A: Pixel, ZoomLevel: Integer)`
+
+起始版本:`v1.0.0`
+
+SQL 示例
+
+```sql
+SELECT ST_TileName(pixels.px, 3)
+FROM pixels
+```
+
+## 聚合函数
+
+### ST_Render
+
+简介:给定一组像素及其颜色,返回一个 Java PNG BufferedImage。第 3 个参数为可选的缩放级别。当你需要渲染瓦片而不是单张图像时,应当使用该缩放级别参数。
+
+格式:`ST_Render (A: Pixel, B: Color, C: Integer - optional zoom level)`
+
+起始版本:`v1.0.0`
+
+SQL 示例
+
+```sql
+SELECT tilename, ST_Render(pixels.px, pixels.color) AS tileimg
+FROM pixels
+GROUP BY tilename
+```


(sedona) 03/12: [GH-2867] Replace EN/中文 pill with 文A icon dropdown in header (#2923)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit d7d91f1b04e7ba03718f529b35e7a8b3d94f626a
Author: Jia Yu <ji...@apache.org>
AuthorDate: Thu May 7 22:39:25 2026 -0700

    [GH-2867] Replace EN/中文 pill with 文A icon dropdown in header (#2923)
    
    (cherry picked from commit e13ba37d2fdbc6043e53d7d911f822cdb74fc937)
---
 .../stylesheets/components/_lang-switch.scss       | 111 +++++++++++++++------
 docs-overrides/partials/alternate.html             |  33 +++---
 docs-overrides/partials/header.html                |   4 +-
 3 files changed, 102 insertions(+), 46 deletions(-)

diff --git a/docs-overrides/assets/stylesheets/components/_lang-switch.scss b/docs-overrides/assets/stylesheets/components/_lang-switch.scss
index df515fa9c8..a6b177038b 100644
--- a/docs-overrides/assets/stylesheets/components/_lang-switch.scss
+++ b/docs-overrides/assets/stylesheets/components/_lang-switch.scss
@@ -1,50 +1,99 @@
 .sd-lang-switch {
+  position: relative;
   display: inline-flex;
-  align-items: stretch;
-  margin: 0 0.4rem;
-  padding: 2px;
-  border: 1px solid rgba(255, 255, 255, 0.45);
-  border-radius: 999px;
-  background: rgba(255, 255, 255, 0.08);
-  font-size: 0.72rem;
-  line-height: 1;
-
-  &__item {
+  align-items: center;
+  margin: 0 0.2rem;
+
+  // Hide the default disclosure marker on summary
+  &__trigger::-webkit-details-marker { display: none; }
+  &__trigger { list-style: none; }
+
+  &__trigger {
     display: inline-flex;
     align-items: center;
-    padding: 0.28rem 0.7rem;
-    color: rgba(255, 255, 255, 0.85);
-    text-decoration: none;
+    justify-content: center;
+    min-width: 1.7rem;
+    height: 1.7rem;
+    padding: 0 0.32rem;
     border-radius: 999px;
-    font-weight: 600;
-    letter-spacing: 0.02em;
+    color: rgba(255, 255, 255, 0.85);
+    cursor: pointer;
     transition: background-color 120ms ease, color 120ms ease;
 
     &:hover,
-    &:focus {
+    &:focus-visible {
       color: #ffffff;
       background-color: rgba(255, 255, 255, 0.18);
+      outline: none;
     }
+  }
 
-    &--active {
-      color: #ca463a;
-      background-color: #ffffff;
+  &__glyph {
+    display: inline-flex;
+    align-items: baseline;
+    font-family: -apple-system, "Helvetica Neue", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
+    font-weight: 600;
+    line-height: 1;
+    letter-spacing: -0.02em;
+  }
 
-      &:hover,
-      &:focus {
-        color: #ca463a;
-        background-color: #ffffff;
-      }
-    }
+  &__glyph-cn {
+    font-size: 0.95rem;
+    margin-right: 0.05rem;
   }
-}
 
-@media (max-width: 600px) {
-  .sd-lang-switch {
-    font-size: 0.68rem;
+  &__glyph-en {
+    font-size: 0.7rem;
+    transform: translateY(-0.18rem);
+    font-weight: 700;
+  }
 
-    &__item {
-      padding: 0.22rem 0.55rem;
+  &[open] &__trigger {
+    color: #ffffff;
+    background-color: rgba(255, 255, 255, 0.22);
+  }
+
+  &__menu {
+    position: absolute;
+    top: calc(100% + 0.35rem);
+    right: 0;
+    min-width: 8rem;
+    margin: 0;
+    padding: 0.3rem 0;
+    list-style: none;
+    background: #ffffff;
+    border-radius: 4px;
+    box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18);
+    z-index: 100;
+
+    li { margin: 0; padding: 0; }
+  }
+
+  &__link {
+    display: block;
+    padding: 0.4rem 0.9rem;
+    color: rgba(0, 0, 0, 0.78);
+    text-decoration: none;
+    font-size: 0.72rem;
+    font-weight: 500;
+    line-height: 1.3;
+    white-space: nowrap;
+
+    &:hover,
+    &:focus {
+      color: #ca463a;
+      background-color: rgba(202, 70, 58, 0.08);
+      outline: none;
+    }
+
+    &--active {
+      color: #ca463a;
+      font-weight: 700;
     }
   }
 }
+
+// The native <details> element stays open until the user clicks the
+// summary again. We accept that behavior here; clicking elsewhere on
+// the page does not auto-close the menu. Keeping it pure HTML/CSS
+// means the dropdown works without any JS dependency.
diff --git a/docs-overrides/partials/alternate.html b/docs-overrides/partials/alternate.html
index e038aad5c4..513dcb4f9c 100644
--- a/docs-overrides/partials/alternate.html
+++ b/docs-overrides/partials/alternate.html
@@ -1,15 +1,22 @@
 {% if config.extra.alternate and config.extra.alternate | length > 1 %}
-<nav class="sd-lang-switch" aria-label="{{ lang.t('select.language') }}">
-  {% for alt in config.extra.alternate %}
-    {%- set is_active = (alt.lang == config.theme.language) -%}
-    <a
-      href="{{ alt.link | url }}"
-      hreflang="{{ alt.lang }}"
-      lang="{{ alt.lang }}"
-      target="_self"
-      class="sd-lang-switch__item{% if is_active %} sd-lang-switch__item--active{% endif %}"
-      {% if is_active %}aria-current="true"{% endif %}
-    >{{ alt.name }}</a>
-  {% endfor %}
-</nav>
+<details class="sd-lang-switch">
+  <summary class="sd-lang-switch__trigger" aria-label="{{ lang.t('select.language') }}" title="{{ lang.t('select.language') }}">
+    <span class="sd-lang-switch__glyph" aria-hidden="true"><span class="sd-lang-switch__glyph-cn">文</span><span class="sd-lang-switch__glyph-en">A</span></span>
+  </summary>
+  <ul class="sd-lang-switch__menu">
+    {% for alt in config.extra.alternate %}
+      {%- set is_active = (alt.lang == config.theme.language) -%}
+      <li>
+        <a
+          href="{{ alt.link | url }}"
+          hreflang="{{ alt.lang }}"
+          lang="{{ alt.lang }}"
+          target="_self"
+          class="sd-lang-switch__link{% if is_active %} sd-lang-switch__link--active{% endif %}"
+          {% if is_active %}aria-current="true"{% endif %}
+        >{{ alt.name }}</a>
+      </li>
+    {% endfor %}
+  </ul>
+</details>
 {% endif %}
diff --git a/docs-overrides/partials/header.html b/docs-overrides/partials/header.html
index 948b752ffd..d6ca6f4d48 100644
--- a/docs-overrides/partials/header.html
+++ b/docs-overrides/partials/header.html
@@ -84,13 +84,13 @@
         {% if not config.theme.palette is mapping %}
         {% include "partials/javascripts/palette.html" %}
         {% endif %}
+      </div>
+      <div class="right-part">
 
         <!-- Site language selector -->
         {% if config.extra.alternate %}
         {% include "partials/alternate.html" %}
         {% endif %}
-      </div>
-      <div class="right-part">
 
         <!-- Button to open search modal -->
         {% if "material/search" in config.plugins %}


(sedona) 11/12: [GH-2867] Strip mike canonical-version prefix from language switcher links (#2945)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 42ba95942c643bee581413049222ed78f843ff6a
Author: Jia Yu <ji...@apache.org>
AuthorDate: Sun May 10 20:26:40 2026 -0700

    [GH-2867] Strip mike canonical-version prefix from language switcher links (#2945)
    
    (cherry picked from commit c67892ab95a88d71766c75793aa3760ad33a889e)
---
 docs-overrides/partials/alternate.html | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/docs-overrides/partials/alternate.html b/docs-overrides/partials/alternate.html
index 0056fe9e2c..8e5344b9ab 100644
--- a/docs-overrides/partials/alternate.html
+++ b/docs-overrides/partials/alternate.html
@@ -5,16 +5,27 @@
   </summary>
   <ul class="sd-lang-switch__menu">
     {#-
-      mkdocs-static-i18n stores `alt.link` as a server-absolute path like
-      `/zh/sedonaspark/`. Passing that directly to `| url` keeps the leading
-      slash, so the link bypasses any deployment prefix added by mike (e.g.
-      `/latest-snapshot/`) and lands at the wrong version. Strip the leading
-      slash so `| url` resolves against the docs root and stays inside the
-      current mike version.
+      mkdocs-static-i18n derives `alt.link` from `urlsplit(site_url).path`, so
+      when mike rewrites site_url to include its canonical_version (e.g.
+      `https://sedona.apache.org/latest`) the alt links get that prefix baked
+      in — yielding paths like `/latest/zh/sedonaspark/`. Feeding that through
+      `| url` from a different mike alias (`/latest-snapshot/`) produces
+      broken targets like `/latest-snapshot/latest/zh/`. Strip the mike
+      canonical prefix, then any remaining leading slash, so `| url`
+      resolves against the docs root of the version actually being served.
     -#}
+    {%- set mike_prefix = '' -%}
+    {%- if 'mike' in config.plugins and config.plugins.mike.config.canonical_version -%}
+      {%- set mike_prefix = '/' ~ config.plugins.mike.config.canonical_version ~ '/' -%}
+    {%- endif -%}
     {% for alt in config.extra.alternate %}
       {%- set is_active = (alt.lang == config.theme.language) -%}
-      {%- set alt_link = alt.link[1:] if alt.link.startswith('/') else alt.link -%}
+      {%- set alt_link = alt.link -%}
+      {%- if mike_prefix and alt_link.startswith(mike_prefix) -%}
+        {%- set alt_link = alt_link[mike_prefix|length:] -%}
+      {%- elif alt_link.startswith('/') -%}
+        {%- set alt_link = alt_link[1:] -%}
+      {%- endif -%}
       <li>
         <a
           href="{{ alt_link | url }}"


(sedona) 10/12: [GH-2912] Translate Community & ASF section to Chinese (#2937)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 0df937c198d5f8179de363838cd65020fb789397
Author: Jia Yu <ji...@apache.org>
AuthorDate: Fri May 8 14:29:11 2026 -0700

    [GH-2912] Translate Community & ASF section to Chinese (#2937)
    
    (cherry picked from commit bf66a7e3c67f5d2f89044fca1c008ec2af2a9a9a)
---
 docs/asf/asf.zh.md                   |  22 ++
 docs/asf/telemetry.zh.md             |  30 ++
 docs/community/contact.zh.md         |  65 ++++
 docs/community/contributor.zh.md     | 300 ++++++++++++++++
 docs/community/develop.zh.md         | 189 ++++++++++
 docs/community/geopandas.zh.md       |  85 +++++
 docs/community/publication.zh.md     |  70 ++++
 docs/community/publish.zh.md         | 658 +++++++++++++++++++++++++++++++++++
 docs/community/release-manager.zh.md | 170 +++++++++
 docs/community/rule.zh.md            |  75 ++++
 docs/community/snapshot.zh.md        |  73 ++++
 docs/community/vote.zh.md            | 128 +++++++
 12 files changed, 1865 insertions(+)

diff --git a/docs/asf/asf.zh.md b/docs/asf/asf.zh.md
new file mode 100644
index 0000000000..93a1a9190d
--- /dev/null
+++ b/docs/asf/asf.zh.md
@@ -0,0 +1,22 @@
+<!--
+ 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.
+ -->
+
+# 版权
+
+Apache Sedona、Sedona、Apache、Apache 羽毛 logo,以及 Apache Sedona 项目 logo,均为 Apache 软件基金会在美国及其他国家的注册商标或商标。本页提及的其他商标或注册商标均归各自所有者所有。详情请访问 <a href="http://www.apache.org/">Apache 软件基金会</a>。
diff --git a/docs/asf/telemetry.zh.md b/docs/asf/telemetry.zh.md
new file mode 100644
index 0000000000..e82db91745
--- /dev/null
+++ b/docs/asf/telemetry.zh.md
@@ -0,0 +1,30 @@
+<!--
+ 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.
+ -->
+
+## Scarf
+
+Apache Sedona 使用 Scarf 收集匿名使用数据,以便帮助我们了解软件的使用情况以及未来的改进方向。您可以通过在本机或集群 driver 节点上将环境变量 `SCARF_NO_ANALYTICS` 或 `DO_NOT_TRACK` 设为 `true` 来选择不参与遥测数据收集。
+
+Scarf 完全符合 GDPR,并在 [Apache 软件基金会隐私政策](https://privacy.apache.org/faq/committers.html) 中获许使用。Scarf 的隐私政策见 [https://about.scarf.sh/privacy-policy](https://about.scarf.sh/privacy-policy)。
+
+## Matomo
+
+Apache Sedona 使用 Matomo 收集匿名使用数据,以便更好地了解用户对系统、网站与文档的使用方式,进而决定接下来重点改进的方向。
+
+Matomo 在 [Apache 软件基金会隐私政策](https://privacy.apache.org/faq/committers.html) 中获许使用。
diff --git a/docs/community/contact.zh.md b/docs/community/contact.zh.md
new file mode 100644
index 0000000000..c9c1a14612
--- /dev/null
+++ b/docs/community/contact.zh.md
@@ -0,0 +1,65 @@
+<!--
+ 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.
+ -->
+
+# 社区
+
+每一个志愿者项目都从参与其中的人那里汲取力量。我们邀请您按照自己希望的程度参与进来。
+
+您可以通过以下方式参与社区:
+
+* 使用我们的项目并提供反馈。
+* 向我们提供使用案例。
+* 报告 bug 并提交补丁。
+* 贡献代码与文档。
+
+## 社区活动
+
+欢迎大家加入我们的社区活动。我们每 4 周举办一次社区例会,可在以下链接报名要参加的活动:https://bit.ly/3UBmxFY
+
+## Sedona 在 LinkedIn
+
+[Apache Sedona@LinkedIn](https://www.linkedin.com/company/apache-sedona)
+
+## Sedona 在 X
+
+[Apache Sedona@X](https://X.com/ApacheSedona)
+
+## Discord 服务器
+
+[![Apache Sedona Community Discord Server](https://dcbadge.limes.pink/api/server/https://discord.gg/9A3k5dEBsY)](https://discord.gg/9A3k5dEBsY)
+
+## 寻求帮助
+
+您可以寻求帮助或为项目做出贡献。提交 issue 之前,请:
+
+* 确认 bug 确实存在。
+* 在 issue tracker 中搜索,确认尚无其他人报告同一 bug。
+* 考虑在 Sedona 源码中自行定位该 bug,并在提交 bug 报告时附上相应补丁。这能为 Sedona 开发者节省大量时间,并有助于尽快修复 bug。
+
+我们也欢迎对新功能的增强建议。建议越具体、越有理有据,被纳入未来发布版本的可能性就越大。
+
+* [Sedona JIRA](https://issues.apache.org/jira/projects/SEDONA):bug 报告与功能请求
+* [Sedona GitHub Issues](https://github.com/apache/sedona/issues?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen):bug 报告与功能请求
+* [Sedona GitHub Discussion](https://github.com/apache/sedona/discussions):项目开发与一般性问题
+* [Sedona 邮件列表](https://lists.apache.org/list.html?sedona.apache.org):[dev@sedona.apache.org](https://lists.apache.org/list.html?dev@sedona.apache.org),项目开发与一般性问题。
+
+发送邮件前请先订阅邮件列表。订阅方式:发送一封邮件(标题与正文均可留空)至 [dev-subscribe@sedona.apache.org](mailto:dev-subscribe@sedona.apache.org?subject=Subscribe&body=Subscribe)。
+
+!!!tip
+    投票等所有正式讨论只在邮件列表上进行,包括对每个发布候选版本或项目重大变更的投票。请关注邮件列表!
diff --git a/docs/community/contributor.zh.md b/docs/community/contributor.zh.md
new file mode 100644
index 0000000000..14bad69c36
--- /dev/null
+++ b/docs/community/contributor.zh.md
@@ -0,0 +1,300 @@
+<!--
+ 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.
+ -->
+
+Sedona 收到了来自社区的诸多帮助。本页列出了 Apache Sedona 的 Committers 与项目管理委员会成员(PMC)。
+本页人员按姓氏排序。
+
+## Committers
+
+向 Sedona 贡献了足够多代码的贡献者会被晋升为 committer。Committer 拥有 Sedona 主仓库的写权限。
+
+## 项目管理委员会(PMC)
+
+当社区认为某位 committer 能够至少负责本项目的一个主要组件时,他/她会被晋升为 PMC 成员。
+
+当前 Sedona PMC 成员如下:
+
+|         姓名         |  GitHub ID   |        Apache ID        |
+|:--------------------:|:------------:|:-----------------------:|
+|     Adam Binford     |  Kimahriman  |  kimahriman@apache.org  |
+|  Kanchan Chowdhury   |  kanchanchy  |  kanchanchy@apache.org  |
+|  Kristin Cowalcijk   | Kontinuation | kontinuation@apache.org |
+|     Furqaan Khan     | furqaankhan  |   furqaan@apache.org    |
+|    Paweł Kociński    |   Imbruced   |   imbruced@apache.org   |
+|       Yitao Li       |   yitao-li   |   yitaoli@apache.org    |
+|    Netanel Malka     |  netanel246  |    malka@apache.org     |
+|    Mohamed Sarwat    |    Sarwat    |   mosarwat@apache.org   |
+|      Kengo Seki      |    sekikn    |    sekikn@apache.org    |
+|     Sachio Wakai     |   SW186000   |    swakai@apache.org    |
+|      Jinxuan Wu      |   jinxuan    |   jinxuanw@apache.org   |
+|        Jia Yu        |   jiayuasu   |    jiayu@apache.org     |
+|      Feng Zhang      | zhangfengcdt |  fengzhang@apache.org   |
+|     Zongsi Zhang     | zongsizhang  | zongsizhang@apache.org  |
+|     Felix Cheung     |              | felixcheung@apache.org  |
+|     Von Gosling      |              |  vongosling@apache.org  |
+|    Sunil Govindan    |              |    sunilg@apache.org    |
+| Jean-Baptiste Onofré |              |   jbonofre@apache.org   |
+|   George Percivall   |              |  percivall@apache.org   |
+
+## 成为 Committer
+
+开始为 Sedona 做贡献,请阅读 [如何贡献](rule.md) —— 任何人都可以向项目提交补丁、文档与示例。
+
+PMC 会根据贡献情况,定期把活跃的贡献者晋升为新的 committer。新 committer 的资格条件包括:
+
+* 对 Sedona 的持续贡献:committer 应当对 Sedona 有持续的重大贡献。
+* 贡献的质量:committer 比社区中的其他成员更应提交简洁、经过良好测试、设计良好的补丁,同时具备评审补丁的能力。
+* 社区参与度:committer 应在所有社区互动中保持建设性、友好的态度,活跃在 dev 邮件列表与 Discord,并帮助引导新贡献者与新用户。
+
+PMC 也会增加新的 PMC 成员。PMC 成员需履行 Apache 指南中所规定的 PMC 职责,包括参与发布投票、维护 Apache 项目商标、对法律与许可问题负责、确保项目遵循 Apache 项目规范等。PMC 会定期把已展示出对上述职责的理解与执行能力的 committer 加入 PMC。
+
+当前 Sedona Committers 如下:
+
+|       姓名       |  GitHub ID  |        Apache ID        |
+|:----------------:|:-----------:|:-----------------------:|
+|   John Bampton   |  jbampton   |   johnbam@apache.org    |
+| Dewey Dunnington | paleolimbot | paleolimbot@apache.org  |
+|  Nilesh Gajwani  |   iGN5117   |    nilesh@apache.org    |
+|   Peter Nguyen   |  petern48   |    petern@apache.org    |
+|   Pranav Toggi   |  prantogg   |   prantogg@apache.org   |
+
+## 提名 Committer 或 PMC 成员
+
+步骤如下:
+
+1. 发起投票(templates/committerVote.txt)。
+2. 投票结束。如果结果为正,发出邀请给新 committer。
+
+### 发起投票
+
+我们在 private@sedona.apache.org 进行投票与讨论,以便进行坦诚的交流。
+
+让 Vote 邮件运行一周。当达到 Consensus Approval(至少 3 个 +1 投票且无反对票)即视为通过。
+
+#### PMC 投票模板
+
+下面这封邮件用于发起对新 PMC 候选人的投票。新 PMC 成员需要先由现有 PMC 投票通过,再由董事会批准。
+
+```
+To: private@sedona.apache.org
+Subject: [VOTE] New PMC candidate: [New PMC NAME]
+
+[ 在此填写您提名该候选人的理由 ]
+
+Voting ends one week from today, or until at least 3 +1 votes are cast.
+
+```
+
+### 关闭投票
+
+下面这封邮件用于结束投票并向项目报告结果:
+
+```
+To: private@sedona.apache.org
+Subject: [VOTE][RESULT] New PMC candidate: [New PMC NAME]
+
+The vote has now closed: [paste the vote thread on https://lists.apache.org/list.html?private@sedona.apache.org]. The results are:
+
+Binding Votes:
+
++1 [TOTAL BINDING +1 VOTES]
+ 0 [TOTAL BINDING +0/-0 VOTES]
+-1 [TOTAL BINDING -1 VOTES]
+
+The vote is ***successful/not successful***
+```
+
+### 通知 ASF Board
+
+提名人需向 ASF Board(board@apache.org)发送一封邮件,附上投票结果链接,格式如下:
+
+```
+To: board at apache.org
+CC: private at sedona.apache.org
+Subject: [NOTICE] New PMC NAME for Apache Sedona PMC
+Body:
+
+New PMC NAME has been voted as a new member of the Apache Sedona PMC. The vote thread is at: *link to the vote result thread*
+```
+
+### 发送邀请
+
+```
+To: New PMC Email address
+CC: private@sedona.apache.org
+
+Hello [New PMC NAME],
+
+The Sedona Project Management Committee (PMC)
+hereby offers you committer privileges to the project
+[as well as membership in the PMC]. These privileges are
+offered on the understanding that you'll use them
+reasonably and with common sense. We like to work on trust
+rather than unnecessary constraints.
+
+Being a committer enables you to more easily make
+changes without needing to go through the patch
+submission process. Being a PMC member enables you
+to guide the direction of the project.
+
+Being a committer does not require you to
+participate any more than you already do. It does
+tend to make one even more committed. You will
+probably find that you spend more time here.
+
+Of course, you can decline and instead remain as a
+contributor, participating as you do now.
+
+A. This personal invitation is a chance for you to
+accept or decline in private. Either way, please
+let us know in reply to the private@sedona.apache.org
+address only.
+
+B. If you accept, the next step is to register an iCLA:
+    1. Details of the iCLA and the forms are found
+    through this link: https://www.apache.org/licenses/#clas
+
+    2. Instructions for its completion and return to
+    the Secretary of the ASF are found at
+    https://www.apache.org/licenses/#submitting
+
+    3. When you transmit the completed iCLA, request
+    to notify the Apache Sedona project and choose a
+    unique Apache ID. Look to see if your preferred
+    ID is already taken at
+    https://people.apache.org/committer-index.html
+    This will allow the Secretary to notify the PMC
+    when your iCLA has been recorded.
+
+When recording of your iCLA is noted, you will
+receive a follow-up message with the next steps for
+establishing you as a committer.
+
+```
+
+### PMC 接受邀请与 ICLA 说明
+
+```
+To: New PMC Email address
+Cc: private@sedona.apache.org
+Subject: Re: invitation to become Apache Sedona PMC
+
+Welcome. Here are the next steps in becoming a project committer. After that we will make an announcement to the dev@sedona.apache.org
+
+1. You need to send a Contributor License Agreement to the ASF.
+Normally you would send an Individual CLA. If you also make
+contributions done in work time or using work resources,
+see the Corporate CLA. Ask us if you have any issues.
+https://www.apache.org/licenses/#clas.
+
+You need to choose a preferred ASF user name and alternatives.
+In order to ensure it is available you can view a list of taken IDs at
+https://people.apache.org/committer-index.html
+
+Please notify us when you have submitted the CLA and by what means
+you did so. This will enable us to monitor its progress.
+
+We will arrange for your Apache user account when the CLA has
+been recorded.
+
+2. After that is done, please use your ASF email to subscribe to the dev@sedona.apache.org
+and private@sedona.apache.org by sending an email to dev-subscribe@sedona.apache.org and
+private-subscribe@sedona.apache.org. We generally discuss everything on the dev list and
+keep the private@sedona.apache.org list for occasional matters which must be private.
+
+The developer section of the website describes roles within the ASF and provides other
+resources:
+  https://www.apache.org/foundation/how-it-works.html
+  https://www.apache.org/dev/
+
+Just as before you became a committer, participation in any ASF community
+requires adherence to the ASF Code of Conduct:
+  https://www.apache.org/foundation/policies/conduct.html
+
+Yours,
+The Apache Sedona PMC
+```
+
+### 创建 ASF 账户
+
+ICLA 提交后,使用 [ASF New Account Request 表单](https://whimsy.apache.org/officers/acreq) 提交申请。Sedona 的 mentor 会请求账号。
+
+Sedona 毕业后,由 PMC 主席(Chair)来发起请求。
+
+### 加入到系统
+
+新 PMC 用其 ASF 账号订阅 Sedona 邮件列表后,PMC 中的某位成员需把新成员加入 Whimsy 系统(https://whimsy.apache.org/roster/pmc/sedona)。
+
+### PMC 公告
+
+账号创建完成后,下面这封邮件用于在 sedona-dev 列表中宣布新 committer:
+
+```
+To: dev@sedona.apache.org
+Subject: new committer: ###New PMC NAME
+
+The Project Management Committee (PMC) for Apache Sedona
+has invited New PMC NAME to become a committer and we are pleased
+to announce that they have accepted.
+
+### add specific details here ###
+
+Being a committer enables easier contribution to the
+project since there is no need to go via the patch
+submission process. This should enable better productivity.
+A PMC member helps manage and guide the direction of the project.
+```
+
+### Committer Done 模板
+
+在 committer 账号建立完成后:
+
+```
+To: New Committer Email
+CC: private@sedona.apache.org
+Subject: account request: New Committer NAME
+
+New Committer NAME, as you know, the ASF Infrastructure has set up your
+committer account with the username '####'.
+
+You have commit access to specific sections of the
+ASF repository, as follows:
+https://github.com/apache/sedona
+
+You need to link your ASF Account with your GitHub account.
+
+Here are the steps
+
+1. Verify you have a GitHub ID enabled with 2FA
+	* https://help.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/
+2. Enter your GitHub ID into your Apache ID profile https://id.apache.org/
+3. Merge your Apache and GitHub accounts using
+	* GitBox (Apache Account Linking utility) https://gitbox.apache.org/setup/
+	* You should see 3 green checks in GitBox.
+	* Wait at least 30  minutes for an email inviting you to Apache GitHub Organization and accept invitation
+4. After accepting the GitHub Invitation verify that you are a
+member of the team https://github.com/orgs/apache/teams/sedona-committers
+
+Optionally, if you want, please follow the instructions to set up your GitHub, SSH, svn password, svn configuration, email forwarding, etc.
+https://www.apache.org/dev/#committers
+
+Additionally, if you have been elected to the Sedona
+ Project Mgmt. Committee (PMC): Verify you are part of the LDAP sedona
+  pmc https://whimsy.apache.org/roster/pmc/sedona
+```
diff --git a/docs/community/develop.zh.md b/docs/community/develop.zh.md
new file mode 100644
index 0000000000..f8f9fc5607
--- /dev/null
+++ b/docs/community/develop.zh.md
@@ -0,0 +1,189 @@
+<!--
+ 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.
+ -->
+
+# 开发 Sedona
+
+## Scala/Java 开发者
+
+### IDE
+
+推荐使用安装了 Scala 插件的 [Intellij IDEA](https://www.jetbrains.com/idea/)。请确认项目的 SDK 设置为 JDK 1.8。
+
+### 导入项目
+
+#### 选择 `Open`
+
+![点击 Open 导入项目](../image/ide-java-1.png)
+
+#### 进入 Sedona 根目录(不是子模块目录)并选择 `open`
+
+![打开 Sedona 根目录](../image/ide-java-2.png)
+
+#### IDE 可能会显示错误
+
+IDE 通常难以理解 Sedona 中较为复杂的项目结构。
+
+![IDE 通常难以理解项目](../image/ide-java-4.png)
+
+#### 通过修改 `pom.xml` 修复错误
+
+需要在根目录的 `pom.xml` 中注释掉以下几行。==注意:请勿把这一改动提交到 Sedona。==
+
+```xml
+<!--    <parent>-->
+<!--        <groupId>org.apache</groupId>-->
+<!--        <artifactId>apache</artifactId>-->
+<!--        <version>23</version>-->
+<!--        <relativePath />-->
+<!--    </parent>-->
+```
+
+#### 重新加载 `pom.xml`
+
+确保重新加载 `pom.xml` 或重新加载整个 Maven 项目。IDE 会询问是否移除一些模块,请选择 `yes`。
+
+![重新加载 Maven 项目](../image/ide-java-5.png)
+
+#### 最终的项目结构应该是这样:
+
+![最终正确的项目结构](../image/ide-java-3.png)
+
+### 运行单元测试
+
+#### 运行所有单元测试
+
+在终端中进入 Sedona 根目录运行 `mvn clean install`。全部测试需要超过 15 分钟。如果只想构建 jar,运行 `mvn clean install -DskipTests`。
+
+!!!Note
+    `mvn clean install` 默认基于 Spark 3.3、Scala 2.12 编译 Sedona。如果 $SPARK_HOME 中是不同版本的 Spark,请通过 `-Dspark` 命令行参数指定。例如基于 Spark 3.4 与 Scala 2.12 编译:`mvn clean install -Dspark=3.4 -Dscala=2.12`。
+
+更多细节请参阅 [编译 Sedona](../setup/compile.md)。
+
+#### 运行单个单元测试
+
+在 IDE 中右键点击某个测试用例即可运行。
+
+![右键点击测试用例运行](../image/ide-java-6.png)
+
+运行 Scala 编写的测试用例时,IDE 可能会提示 “Path does not exist”,如下:
+
+![Path does not exist](../image/ide-java-7.png)
+
+进入 `Edit Configuration`:
+
+![Edit Configuration](../image/ide-java-8.png)
+
+把 `Working Directory` 的值改为 `$MODULE_WORKING_DIR$`:
+
+![修改 working directory](../image/ide-java-9.png)
+
+重新运行该测试用例。**不要**右键再次运行,请点击下图所示的按钮:
+
+![点击按钮重新运行测试用例](../image/ide-java-10.png)
+
+如果不想每次都修改 `Working Directory`,可以在 `Run/Debug Configurations` 窗口中修改 `Working Directory` 的默认值。点击 `Edit configuration templates...`,把 ScalaTest 的 `Working Directory` 设为 `$MODULE_WORKING_DIR$`。
+
+![Run/Debug Configurations 中点击 Edit configuration templates](../image/ide-java-11.png)
+![设置 ScalaTest 的 Working Directory](../image/ide-java-12.png)
+
+之后新建的 ScalaTest run configuration 都会自动使用正确的 `Working Directory`。
+
+### 使用 Java 11 时的 IDE 配置
+
+如果使用 Java 11,运行测试时可能遇到如下错误:
+
+```
+/path/to/sedona/common/src/main/java/org/apache/sedona/common/geometrySerde/UnsafeGeometryBuffer.java
+package sun.misc does not exist
+sun.misc.Unsafe
+```
+
+可在 IDE 设置中关闭 `Use '--release' option for cross-compilation` 来解决。
+
+![使用 Java 11 时关闭 “Use '--release' option for cross-compilation”](../image/ide-java-13.png)
+
+### 在不同 Spark/Scala 版本下运行测试
+
+如需在不同 Spark/Scala 版本下测试改动,可在 Maven 面板中选择对应的 Spark 与 Scala profile。选择后请重新加载 sedona-parent 项目,参考下图。
+
+!!!Note
+    Profile 切换不会自动更新 IDE 中的模块名。如果模块名仍带有 `-3.3-2.12` 等后缀,不必感到困惑。
+
+!!!Note
+    并非所有 Spark 与 Scala 的组合都受支持,部分组合会编译失败。
+
+![选择 Spark 与 Scala profile](../image/ide-java-14.png)
+
+## Python 开发者
+
+### IDE
+
+推荐使用 [PyCharm](https://www.jetbrains.com/pycharm/)。
+
+### 运行测试
+
+#### 运行所有 Python 测试
+
+按照 [此处](../setup/compile.md#run-python-test) 的步骤完成环境配置。
+
+环境就绪后,在 python 目录下运行:
+
+```bash
+cd python
+uv run pytest -v tests
+```
+
+#### 运行单个测试
+
+如需运行某个特定的 Python 测试文件,传入 `.py` 路径即可。
+
+例如运行 `python/tests/sql/test_function.py` 中的所有测试:
+
+```bash
+cd python
+uv run pytest -v tests/sql/test_function.py
+```
+
+要运行某个文件中的特定测试,向 `pytest` 传入 `file_name::class_name::test_name`。
+
+例如运行 `sql/test_predicate.py` 中关于 `ST_Contains` 的测试:
+
+```bash
+cd python
+uv run pytest -v tests/sql/test_predicate.py::TestPredicate::test_st_contains
+```
+
+### 构建包
+
+下面的命令会在 `dist` 目录中生成 sdist 与 whl 包:
+
+```bash
+cd python
+uv build
+```
+
+## R 开发者
+
+更多内容稍后补充。
+
+### IDE
+
+推荐使用 [RStudio](https://posit.co/products/open-source/rstudio/)。
+
+### 导入项目
diff --git a/docs/community/geopandas.zh.md b/docs/community/geopandas.zh.md
new file mode 100644
index 0000000000..950707f495
--- /dev/null
+++ b/docs/community/geopandas.zh.md
@@ -0,0 +1,85 @@
+<!--
+ 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.
+ -->
+
+# 在 Sedona 上的 Geopandas
+
+本指南列出了在 Apache Sedona 的 GeoPandas 组件上以开发者身份贡献变更时需要注意的若干重要事项。请再次注意:**本指南面向贡献者**;面向用户的官方文档另有侧重。
+
+**总体思路**:本组件构建在 PySpark Pandas API 之上。`GeoDataFrame` 与 `GeoSeries` 类分别继承自 pyspark pandas 的 `ps.DataFrame` 与 `ps.Series`。在可能的情况下,应尽量复用 pyspark pandas 已有的实现并在其基础上扩展(即尽量通过 `super()` 调用,而不是把现有逻辑复制过来)。代码组织结构与 [Geopandas 仓库](https://github.com/geopandas/geopandas) 类似。
+
+**惰性求值**:Spark 使用惰性求值。Spark 的分布式与惰性特性有时会让我们无法完全照搬原版 GeoPandas 的实现方式。例如 GeoPandas 在多处对非法 CRS 做了校验(如 `GeoSeries.__init__()`、`set_crs()` 等)。Sedona 当前获取 `crs` 的实现相比 GeoPandas 较为昂贵,因为它需要跑一次立即求值的 `ST_SRID()` 查询。如果在每次 `GeoSeries` 初始化时都立即查询 CRS,那么所有函数调用(如 `.area()` 等)也会变成立即求值,性能会明显下降,用户体验变差。
+
+**保留顺序**:由于 Spark 使用分布式数据,在多次操作之间保留顺序需要付出额外的时间和精力。某些操作维持顺序意义不大,此时跳过额外的 sort 是合理的,否则会带来不必要的性能开销。文档中应说明这种行为。例如 `sjoin` 在执行连接后并不会保持传统 pandas DataFrame 的顺序,这与传统 PySpark Pandas 保持一致。用户随时可以通过 `sort_index()` 等额外函数后排序,但默认实现应避免不必要的排序。
+
+**约定**:Sedona Geopandas 包的常用别名是 `sgpd`,与 geopandas 的别名 `gpd` 类似,仅多了一个 `s` 前缀。相邻包的常用别名见下:
+
+```python
+import pandas as pd
+import geopandas as gpd
+import pyspark.pandas as ps
+import sedona.spark.geopandas as sgpd
+```
+
+**转换方法**:Sedona 的 Geopandas 实现提供了在多种 DataFrame 之间互转的便捷方法。下列方法对 `GeoDataFrame` 与 `GeoSeries` 都可用:
+
+- `to_geopandas()`:Sedona Geo(DataFrame/Series) 转为 Geopandas
+- `to_geoframe()`:Sedona GeoSeries 转为 Sedona GeoDataFrame
+- `to_spark_pandas()`:Sedona Geo(DataFrame/Series) 转为 Pandas on PySpark
+- `to_spark()`(继承):Sedona GeoDataFrame 转为 Spark DataFrame
+- `to_frame()`(继承):Sedona GeoSeries 转为 PySpark Pandas DataFrame
+
+**GeoSeries 函数**:Geopandas 中的几何操作大多是 GeoSeries 函数,但也可以从 `GeoDataFrame` 对象上调用,作用在其活动几何列(active geometry column)上。我们在 `GeoSeries` 类中实现这些函数;同时在 `base.py` 中加上 `_delegate_to_geometry_column()` 调用,让 `GeoDataFrame` 也可以在自己的活动几何列上执行该函数。我们把函数的 docstring 写在 `base.py` 而不是 `GeoSeries`,这样 `GeoDataFrame` 与 `GeoSeries` 都能继承同一份 docstring(避免重复)。
+
+**查看查询计划**:由于这些 DataFrame 抽象建立在 Spark 之上,可以通过 `.spark.explain()` 方法获取一次操作的查询计划。
+
+示例:
+
+```python
+geoseries = GeoSeries([Polygon([(0, 0), (1, 0), (1, 1), (0, 0)])])
+# PySpark pandas Series 目前没有 spark.explain() 方法,可先转为 DataFrame 再调用
+print(geoseries.area.to_frame().spark.explain(extended=True))
+```
+
+```
+== Parsed Logical Plan ==
+Project [__index_level_0__#19L, 0#27 AS None#31]
++- Project [ **org.apache.spark.sql.sedona_sql.expressions.ST_Area**   AS 0#27, __index_level_0__#19L, __natural_order__#23L]
+   +- Project [__index_level_0__#19L, 0#20, monotonically_increasing_id() AS __natural_order__#23L]
+      +- LogicalRDD [__index_level_0__#19L, 0#20], false
+
+== Analyzed Logical Plan ==
+...
+
+== Optimized Logical Plan ==
+...
+
+== Physical Plan ==
+Project [__index_level_0__#19L,  **org.apache.spark.sql.sedona_sql.expressions.ST_Area**   AS None#31]
++- *(1) Scan ExistingRDD[__index_level_0__#19L,0#20]
+```
+
+## 推荐阅读
+
+- [PySpark Pandas Best Practices](https://spark.apache.org/docs/latest/api/python/tutorial/pandas_on_spark/best_practices.html) —— 其中提到了一些值得注意的细节,比如为什么不支持 `__iter__()`。
+- [Geopandas 用户指南](https://geopandas.org/en/stable/docs/user_guide/data_structures.html) —— 特别有助于理解 GeoDataFrame 中 “活动几何列(active geometry column)” 的概念。
+
+## 其他参考
+
+- [Pandas API on Spark 公开 API 页面](https://spark.apache.org/docs/latest/api/python/reference/pyspark.pandas/index.html)
+- [Geopandas API 页面](https://geopandas.org/en/stable/docs/reference.html)
diff --git a/docs/community/publication.zh.md b/docs/community/publication.zh.md
new file mode 100644
index 0000000000..4e0c693234
--- /dev/null
+++ b/docs/community/publication.zh.md
@@ -0,0 +1,70 @@
+<!--
+ 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.
+ -->
+
+# 论文与出版物
+
+Apache Sedona 前身名为 GeoSpark,由亚利桑那州立大学 [Data Systems Lab](https://www.datasyslab.org/) 发起。
+
+## 主要论文
+
+**"Spatial Data Management in Apache Spark: The GeoSpark Perspective and Beyond"** 是介绍整个 GeoSpark 生态系统的完整研究论文。如果您的工作引用 GeoSpark 核心系统,请引用本文。
+
+**"GeoSparkViz: A Scalable Geospatial Data Visualization Framework in the Apache Spark Ecosystem"** 是介绍 GeoSpark 中地图可视化系统的完整研究论文。如果您的工作引用 GeoSpark 可视化系统,请引用本文。
+
+**"Building A Microscopic Road Network Traffic Simulator in Apache Spark"** 是介绍 GeoSpark 中交通仿真器的完整研究论文。如果您的工作引用 GeoSparkSim 交通仿真器,请引用本文。
+
+## 第三方评估
+
+GeoSpark 曾被发表在数据库顶会的论文评估过。值得一提的是,我们与这些论文的作者并无任何合作关系。
+
+* SIGMOD 2020 论文 ["Architecting a Query Compiler for Spatial Workloads"](https://dl.acm.org/doi/abs/10.1145/3318464.3389701) Ruby Y. Tahboub, Tiark Rompf(普渡大学)。
+
+> 在图 16a 中,1 - 24 核机器上 GeoSpark 距离连接查询比 Simba(Spark 的一个空间扩展)快约 7x - 9x。
+
+* PVLDB 2018 论文 ["How Good Are Modern Spatial Analytics Systems?"](http://www.vldb.org/pvldb/vol11/p1661-pandey.pdf) Varun Pandey、Andreas Kipf、Thomas Neumann、Alfons Kemper(慕尼黑工业大学),原文摘录如下:
+
+> GeoSpark 已接近一个完整的空间分析系统,并在大多数情况下具有最佳性能。
+
+## 完整论文列表
+
+### GeoSpark 生态系统
+
+["Spatial Data Management in Apache Spark: The GeoSpark Perspective and Beyond"](https://jiayuasu.github.io/files/paper/GeoSpark_Geoinformatica_2018.pdf)(研究论文)。Jia Yu, Zongsi Zhang, Mohamed Sarwat. Geoinformatica Journal 2019。
+
+["A Demonstration of GeoSpark: A Cluster Computing Framework for Processing Big Spatial Data"](https://jiayuasu.github.io/files/paper/GeoSpark_DemoPaper.pdf)(演示论文)。Jia Yu, Jinxuan Wu, Mohamed Sarwat. IEEE International Conference on Data Engineering ICDE 2016, Helsinki, FI, May 2016。
+
+["GeoSpark: A Cluster Computing Framework for Processing Large-Scale Spatial Data"](https://jiayuasu.github.io/files/paper/GeoSpark_ShortPaper.pdf)(短论文)。Jia Yu, Jinxuan Wu, Mohamed Sarwat. ACM International Conference on Advances in Geographic Information Systems ACM SIGSPATIAL GIS 2015, Seattle, WA, USA, November 2015。
+
+### GeoSparkViz 可视化系统
+
+["GeoSparkViz in Action: A Data System with built-in support for Geospatial Visualization"](https://jiayuasu.github.io/files/paper/geosparkviz-icde2019-demo.pdf)(演示论文)Jia Yu, Anique Tahir, Mohamed Sarwat. International Conference on Data Engineering, ICDE, 2019。
+
+["GeoSparkViz: A Scalable Geospatial Data Visualization Framework in the Apache Spark Ecosystem"](https://jiayuasu.github.io/files/paper/geosparkviz-ssdbm-2018.pdf)(研究论文)。Jia Yu, Zongsi Zhang, Mohamed Sarwat. International Conference on Scientific and Statistical Database Management, SSDBM 2018, Bolzano-Bozen, Italy, July 2018。
+
+### GeoSparkSim 交通仿真器
+
+["Dissecting GeoSparkSim: a scalable microscopic road network traffic simulator in Apache Spark"](https://link.springer.com/article/10.1007/s10619-020-07306-x)(期刊论文)Jia Yu, Zishan Fu, Mohamed Sarwat. Distributed Parallel Databases 38(4): 963-994 (2020)。
+
+["Demonstrating GeoSparkSim: A Scalable Microscopic Road Network Traffic Simulator Based on Apache Spark"](https://jiayuasu.github.io/files/paper/geosparksim_sstd2019_demopaper.pdf). Zishan Fu, Jia Yu, Mohamed Sarwat. International Symposium on Spatial and Temporal Databases, SSTD, 2019。
+
+["Building A Microscopic Road Network Traffic Simulator in Apache Spark"](https://jiayuasu.github.io/files/paper/geosparksim_mdm2019_fullpaper.pdf)(研究论文)Zishan Fu, Jia Yu, Mohamed Sarwat. International Conference on Mobile Data Management, MDM, 2019。
+
+### Spark 上的地理空间数据管理教程
+
+["Geospatial Data Management in Apache Spark: A Tutorial"](https://jiayuasu.github.io/files/talk/jia-icde19-tutorial.pdf)(Tutorial)Jia Yu and Mohamed Sarwat. International Conference on Data Engineering, ICDE, 2019。
diff --git a/docs/community/publish.zh.md b/docs/community/publish.zh.md
new file mode 100644
index 0000000000..d554dde930
--- /dev/null
+++ b/docs/community/publish.zh.md
@@ -0,0 +1,658 @@
+<!--
+ 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.
+ -->
+
+# 发布 Sedona 版本
+
+本页面面向 Sedona PMC,用于发布 Sedona 版本。
+
+!!!warning
+    本页所有脚本都应在本地 Sedona Git 仓库 master 分支下,通过单一脚本文件运行。
+
+## 0. 准备一个空脚本文件
+
+1. 在本地 Sedona Git 仓库 master 分支下运行:
+
+```bash
+echo '#!/bin/bash' > create-release.sh
+chmod 777 create-release.sh
+```
+
+2. 用您喜欢的 GUI 文本编辑器打开 `create-release.sh`。
+3. 不断把本页上的脚本复制粘贴到该文件中,覆盖原有内容。
+4. 不要直接将脚本复制粘贴到终端,因为 `clipboard.js` 的一个 bug 会在这种情形下产生换行符问题。
+5. 每次更新该脚本后运行 `./create-release.sh` 来执行。
+
+## 1. 检查所有文件头中的 ASF 版权声明
+
+1. 运行以下脚本:
+
+```bash
+#!/bin/bash
+wget -q https://archive.apache.org/dist/creadur/apache-rat-0.15/apache-rat-0.15-bin.tar.gz
+tar -xvf  apache-rat-0.15-bin.tar.gz
+git clone --shared --branch master https://github.com/apache/sedona.git sedona-src
+java -jar apache-rat-0.15/apache-rat-0.15.jar -d sedona-src > report.txt
+```
+
+2. 阅读生成的 report.txt 文件,确保所有源代码文件都包含 ASF 版权声明。
+3. 删除生成的报告与克隆的源码:
+
+```bash
+#!/bin/bash
+rm -rf apache-rat-0.15
+rm -rf sedona-src
+rm report.txt
+```
+
+## 2. 更新 Sedona Python、R 与 Zeppelin 的版本号
+
+请确认以下文件中的 Sedona 版本均为 {{ sedona_create_release.current_version }}:
+
+1. https://github.com/apache/sedona/blob/master/python/sedona/version.py
+2. https://github.com/apache/sedona/blob/master/python/pyproject.toml(`[project]` 下的 `version` 字段)
+3. https://github.com/apache/sedona/blob/master/R/DESCRIPTION
+4. https://github.com/apache/sedona/blob/99239524f17389fc4ae9548ea88756f8ea538bb9/R/R/dependencies.R#L42
+5. https://github.com/apache/sedona/blob/master/zeppelin/package.json
+
+!!!warning
+    `python/pyproject.toml` 中的 `version` 字段是 `setuptools` 在构建 Python sdist 与 wheel 时使用的版本号。如果该字段未更新,即便 `python/sedona/version.py` 已更新,发布到 PyPI 的 artifact 仍会带有旧版本号。
+
+## 3. 更新发布说明
+
+在 cut release candidate 之前,请确保 `docs/setup/release-notes.md` 已包含 {{ sedona_create_release.current_version }} 的条目,总结自上一版本以来的所有变更。该文件会被投票邮件与公告邮件直接引用,因此必须出现在发布 tag 中。
+
+## 4. 更新 mkdocs.yml
+
+* 把 `mkdocs.yml` 中的以下变量改为本次要发布的版本:
+    * `sedona_create_release.current_version`
+    * `sedona_create_release.current_rc`
+    * `sedona_create_release.current_git_tag`
+    * `sedona_create_release.current_snapshot`
+* 然后通过 `mkdocs serve` 编译网站,本地浏览器中即可看到本页生成的脚本。
+* 如有需要,也可以发布该网站,发布步骤见本文末尾。
+
+## 5. 暂存并上传 release candidate
+
+```bash
+#!/bin/bash
+
+git checkout master
+git pull
+
+rm -f release.*
+rm -f pom.xml.*
+
+echo "*****Step 1. Stage the Release Candidate to GitHub."
+
+mvn -B clean release:prepare -Dtag={{ sedona_create_release.current_git_tag }} -DreleaseVersion={{ sedona_create_release.current_version }} -DdevelopmentVersion={{ sedona_create_release.current_snapshot }} -Dresume=false -Penable-all-submodules -Darguments="-DskipTests"
+mvn -B release:clean -Penable-all-submodules
+
+echo "*****Step 2: Upload the Release Candidate to https://repository.apache.org."
+
+## 注意:这里使用 maven-release-plugin 2.3.2 而非更新的版本(如 3.0.1),是为了规避一个会阻止我们使用 -Dtag=<tag> clone Git 仓库的 bug。
+## 详细信息见 https://issues.apache.org/jira/browse/MRELEASE-933 与 https://issues.apache.org/jira/browse/SCM-729。
+##
+## 同时请注意:系统属性 `-Dspark` 与 `-Dscala` 必须同时传给 release:perform 与 `-Darguments` 中的实际构建参数,
+## 因为 release:perform 任务激活的 build profile 会同时影响实际构建任务。最稳妥的做法是两处都明确指定。
+
+# 仓库信息
+REPO_URL="https://github.com/apache/sedona.git"
+RC_VERSION="{{ sedona_create_release.current_rc }}"
+SEDONA_VERSION="{{ sedona_create_release.current_version }}"
+TAG="sedona-${RC_VERSION}"
+LOCAL_DIR="sedona-release"
+
+# 如果已存在则先删除,然后克隆仓库
+rm -rf $LOCAL_DIR && git clone --depth 1 --branch $TAG $REPO_URL $LOCAL_DIR && cd $LOCAL_DIR
+
+# Maven release 插件版本
+MAVEN_PLUGIN_VERSION="2.3.2"
+
+# Spark 与 Scala 版本
+declare -a SPARK_VERSIONS=("3.4" "3.5" "4.0" "4.1")
+declare -a SCALA_VERSIONS=("2.12" "2.13")
+
+# 根据 Spark 版本确定所需 Java 版本
+get_java_version() {
+  local spark_version=$1
+  if [[ "$spark_version" == "4."* ]]; then
+    echo "17"
+  else
+    echo "11"
+  fi
+}
+
+# 查找 Maven 安装路径
+find_maven_path() {
+  # 通过多种方式定位 Maven
+  local mvn_path=""
+
+  # 方法 1:检查 mvn 是否在 PATH 中
+  if command -v mvn >/dev/null 2>&1; then
+    mvn_path=$(command -v mvn)
+  fi
+
+  # 方法 2:检查常见的 Homebrew 路径
+  if [[ -z "$mvn_path" ]]; then
+    for version_dir in /opt/homebrew/Cellar/maven/*/libexec/bin/mvn; do
+      if [[ -x "$version_dir" ]]; then
+        mvn_path="$version_dir"
+        break
+      fi
+    done
+  fi
+
+  # 方法 3:检查 /usr/local(旧版本 Homebrew)
+  if [[ -z "$mvn_path" ]]; then
+    for version_dir in /usr/local/Cellar/maven/*/libexec/bin/mvn; do
+      if [[ -x "$version_dir" ]]; then
+        mvn_path="$version_dir"
+        break
+      fi
+    done
+  fi
+
+  # 方法 4:检查系统路径
+  if [[ -z "$mvn_path" ]]; then
+    for path in /usr/bin/mvn /usr/local/bin/mvn; do
+      if [[ -x "$path" ]]; then
+        mvn_path="$path"
+        break
+      fi
+    done
+  fi
+
+  if [[ -z "$mvn_path" ]]; then
+    echo "ERROR: Could not find Maven installation" >&2
+    echo "Please ensure Maven is installed and available in PATH or in standard locations" >&2
+    exit 1
+  fi
+
+  echo "$mvn_path"
+}
+
+# 创建一个使用指定 Java 版本的 Maven 包装脚本
+create_mvn_wrapper() {
+  local java_version=$1
+  local mvn_wrapper="/tmp/mvn-java${java_version}"
+  local mvn_path=$(find_maven_path)
+
+  echo "Using Maven at: $mvn_path" >&2
+
+  # 创建包装脚本:先设置 JAVA_HOME 再执行 Maven
+  cat > "$mvn_wrapper" << EOF
+#!/bin/bash
+JAVA_HOME="\${JAVA_HOME:-\$(/usr/libexec/java_home -v ${java_version})}" exec "${mvn_path}" "\$@"
+EOF
+
+  chmod +x "$mvn_wrapper"
+  echo "$mvn_wrapper"
+}
+
+# 校验 Maven 包装脚本所用的 Java 版本
+verify_java_version() {
+  local mvn_wrapper=$1
+  local expected_java_version=$2
+
+  echo "Verifying Java version with Maven wrapper..."
+  local mvn_java_version=$($mvn_wrapper --version | grep "Java version" | sed 's/.*Java version: \([0-9]*\).*/\1/')
+  if [[ "$mvn_java_version" != "$expected_java_version" ]]; then
+    echo "ERROR: Maven wrapper is using Java $mvn_java_version, but expected Java $expected_java_version"
+    echo "Please ensure the correct Java version is installed"
+    exit 1
+  fi
+  echo "✓ Verified: Maven wrapper is using Java $mvn_java_version"
+}
+
+# 遍历 Spark 与 Scala 版本组合
+for SPARK in "${SPARK_VERSIONS[@]}"; do
+  for SCALA in "${SCALA_VERSIONS[@]}"; do
+    # Spark 4.0+ 与 Scala 2.12 不兼容,跳过
+    if [[ "$SPARK" == "4."* && "$SCALA" == "2.12" ]]; then
+      echo "Skipping Spark $SPARK with Scala $SCALA (not supported)"
+      continue
+    fi
+
+    JAVA_VERSION=$(get_java_version $SPARK)
+    echo "Running release:perform for Spark $SPARK and Scala $SCALA with Java $JAVA_VERSION..."
+
+    # 用合适的 Java 版本创建 Maven 包装脚本
+    MVN_WRAPPER=$(create_mvn_wrapper $JAVA_VERSION)
+    echo "Created Maven wrapper: $MVN_WRAPPER"
+
+    # 校验 Java 版本
+    verify_java_version $MVN_WRAPPER $JAVA_VERSION
+
+    # 通过包装脚本执行 Maven
+    $MVN_WRAPPER org.apache.maven.plugins:maven-release-plugin:$MAVEN_PLUGIN_VERSION:perform \
+      -DconnectionUrl=scm:git:file://$(pwd) \
+      -Dtag=$TAG \
+      -Dresume=false \
+      -Darguments="-DskipTests -Dspark=$SPARK -Dscala=$SCALA" \
+      -Dspark=$SPARK \
+      -Dscala=$SCALA
+
+    # 清理包装脚本
+    rm -f $MVN_WRAPPER
+  done
+done
+
+echo "*****Step 3: Upload Release Candidate on ASF SVN: https://dist.apache.org/repos/dist/dev/sedona"
+
+echo "Creating ${RC_VERSION} folder on SVN..."
+
+svn mkdir -m "Adding folder" https://dist.apache.org/repos/dist/dev/sedona/${RC_VERSION}
+
+echo "Creating release files locally..."
+
+# 回到上层目录进行后续文件操作
+cd ../..
+
+echo "Downloading source code..."
+
+wget https://github.com/apache/sedona/archive/refs/tags/sedona-${RC_VERSION}.tar.gz
+tar -xvf sedona-${RC_VERSION}.tar.gz
+mkdir apache-sedona-${SEDONA_VERSION}-src
+cp -r sedona-sedona-${RC_VERSION}/* apache-sedona-${SEDONA_VERSION}-src/
+tar czf apache-sedona-${SEDONA_VERSION}-src.tar.gz apache-sedona-${SEDONA_VERSION}-src
+rm sedona-${RC_VERSION}.tar.gz
+rm -rf sedona-sedona-${RC_VERSION}
+
+# 为源码包生成校验和与签名
+shasum -a 512 apache-sedona-${SEDONA_VERSION}-src.tar.gz > apache-sedona-${SEDONA_VERSION}-src.tar.gz.sha512
+gpg -ab apache-sedona-${SEDONA_VERSION}-src.tar.gz
+
+echo "Uploading source files..."
+
+# 先上传源码相关文件
+svn import -m "Adding file" apache-sedona-${SEDONA_VERSION}-src.tar.gz https://dist.apache.org/repos/dist/dev/sedona/${RC_VERSION}/apache-sedona-${SEDONA_VERSION}-src.tar.gz
+svn import -m "Adding file" apache-sedona-${SEDONA_VERSION}-src.tar.gz.asc https://dist.apache.org/repos/dist/dev/sedona/${RC_VERSION}/apache-sedona-${SEDONA_VERSION}-src.tar.gz.asc
+svn import -m "Adding file" apache-sedona-${SEDONA_VERSION}-src.tar.gz.sha512 https://dist.apache.org/repos/dist/dev/sedona/${RC_VERSION}/apache-sedona-${SEDONA_VERSION}-src.tar.gz.sha512
+
+echo "Compiling the source code..."
+
+mkdir apache-sedona-${SEDONA_VERSION}-bin
+
+# 根据 Spark 版本确定所需 Java 版本
+get_java_version() {
+  local spark_version=$1
+  if [[ "$spark_version" == "4."* ]]; then
+    echo "17"
+  else
+    echo "11"
+  fi
+}
+
+# 查找 Maven 安装路径
+find_maven_path() {
+  # 通过多种方式定位 Maven
+  local mvn_path=""
+
+  # 方法 1:检查 mvn 是否在 PATH 中
+  if command -v mvn >/dev/null 2>&1; then
+    mvn_path=$(command -v mvn)
+  fi
+
+  # 方法 2:检查常见的 Homebrew 路径
+  if [[ -z "$mvn_path" ]]; then
+    for version_dir in /opt/homebrew/Cellar/maven/*/libexec/bin/mvn; do
+      if [[ -x "$version_dir" ]]; then
+        mvn_path="$version_dir"
+        break
+      fi
+    done
+  fi
+
+  # 方法 3:检查 /usr/local(旧版本 Homebrew)
+  if [[ -z "$mvn_path" ]]; then
+    for version_dir in /usr/local/Cellar/maven/*/libexec/bin/mvn; do
+      if [[ -x "$version_dir" ]]; then
+        mvn_path="$version_dir"
+        break
+      fi
+    done
+  fi
+
+  # 方法 4:检查系统路径
+  if [[ -z "$mvn_path" ]]; then
+    for path in /usr/bin/mvn /usr/local/bin/mvn; do
+      if [[ -x "$path" ]]; then
+        mvn_path="$path"
+        break
+      fi
+    done
+  fi
+
+  if [[ -z "$mvn_path" ]]; then
+    echo "ERROR: Could not find Maven installation" >&2
+    echo "Please ensure Maven is installed and available in PATH or in standard locations" >&2
+    exit 1
+  fi
+
+  echo "$mvn_path"
+}
+
+# 创建一个使用指定 Java 版本的 Maven 包装脚本
+create_mvn_wrapper() {
+  local java_version=$1
+  local mvn_wrapper="/tmp/mvn-java${java_version}"
+  local mvn_path=$(find_maven_path)
+
+  echo "Using Maven at: $mvn_path" >&2
+
+  # 创建包装脚本:先设置 JAVA_HOME 再执行 Maven
+  cat > "$mvn_wrapper" << EOF
+#!/bin/bash
+JAVA_HOME="\${JAVA_HOME:-\$(/usr/libexec/java_home -v ${java_version})}" exec "${mvn_path}" "\$@"
+EOF
+
+  chmod +x "$mvn_wrapper"
+  echo "$mvn_wrapper"
+}
+
+# 校验 Maven 包装脚本所用的 Java 版本
+verify_java_version() {
+  local mvn_wrapper=$1
+  local expected_java_version=$2
+
+  echo "Verifying Java version with Maven wrapper..."
+  local mvn_java_version=$($mvn_wrapper --version | grep "Java version" | sed 's/.*Java version: \([0-9]*\).*/\1/')
+  if [[ "$mvn_java_version" != "$expected_java_version" ]]; then
+    echo "ERROR: Maven wrapper is using Java $mvn_java_version, but expected Java $expected_java_version"
+    echo "Please ensure the correct Java version is installed"
+    exit 1
+  fi
+  echo "✓ Verified: Maven wrapper is using Java $mvn_java_version"
+}
+
+# 使用 Java 11 编译 Spark 3.4
+JAVA_VERSION=$(get_java_version "3.4")
+MVN_WRAPPER=$(create_mvn_wrapper $JAVA_VERSION)
+verify_java_version $MVN_WRAPPER $JAVA_VERSION
+
+echo "Compiling for Spark 3.4 with Scala 2.12 using Java $JAVA_VERSION..."
+cd apache-sedona-${SEDONA_VERSION}-src && $MVN_WRAPPER clean && $MVN_WRAPPER install -DskipTests -Dspark=3.4 -Dscala=2.12 && cd ..
+cp apache-sedona-${SEDONA_VERSION}-src/spark-shaded/target/sedona-*${SEDONA_VERSION}.jar apache-sedona-${SEDONA_VERSION}-bin/
+
+echo "Compiling for Spark 3.4 with Scala 2.13 using Java $JAVA_VERSION..."
+cd apache-sedona-${SEDONA_VERSION}-src && $MVN_WRAPPER clean && $MVN_WRAPPER install -DskipTests -Dspark=3.4 -Dscala=2.13 && cd ..
+cp apache-sedona-${SEDONA_VERSION}-src/spark-shaded/target/sedona-*${SEDONA_VERSION}.jar apache-sedona-${SEDONA_VERSION}-bin/
+
+# 使用 Java 11 编译 Spark 3.5
+JAVA_VERSION=$(get_java_version "3.5")
+MVN_WRAPPER=$(create_mvn_wrapper $JAVA_VERSION)
+verify_java_version $MVN_WRAPPER $JAVA_VERSION
+
+echo "Compiling for Spark 3.5 with Scala 2.12 using Java $JAVA_VERSION..."
+cd apache-sedona-${SEDONA_VERSION}-src && $MVN_WRAPPER clean && $MVN_WRAPPER install -DskipTests -Dspark=3.5 -Dscala=2.12 && cd ..
+cp apache-sedona-${SEDONA_VERSION}-src/spark-shaded/target/sedona-*${SEDONA_VERSION}.jar apache-sedona-${SEDONA_VERSION}-bin/
+
+echo "Compiling for Spark 3.5 with Scala 2.13 using Java $JAVA_VERSION..."
+cd apache-sedona-${SEDONA_VERSION}-src && $MVN_WRAPPER clean && $MVN_WRAPPER install -DskipTests -Dspark=3.5 -Dscala=2.13 && cd ..
+cp apache-sedona-${SEDONA_VERSION}-src/spark-shaded/target/sedona-*${SEDONA_VERSION}.jar apache-sedona-${SEDONA_VERSION}-bin/
+
+# 使用 Java 17 编译 Spark 4.0
+JAVA_VERSION=$(get_java_version "4.0")
+MVN_WRAPPER=$(create_mvn_wrapper $JAVA_VERSION)
+verify_java_version $MVN_WRAPPER $JAVA_VERSION
+
+echo "Compiling for Spark 4.0 with Scala 2.13 using Java $JAVA_VERSION..."
+cd apache-sedona-${SEDONA_VERSION}-src && $MVN_WRAPPER clean && $MVN_WRAPPER install -DskipTests -Dspark=4.0 -Dscala=2.13 && cd ..
+cp apache-sedona-${SEDONA_VERSION}-src/spark-shaded/target/sedona-*${SEDONA_VERSION}.jar apache-sedona-${SEDONA_VERSION}-bin/
+
+# 使用 Java 17 编译 Spark 4.1
+JAVA_VERSION=$(get_java_version "4.1")
+MVN_WRAPPER=$(create_mvn_wrapper $JAVA_VERSION)
+verify_java_version $MVN_WRAPPER $JAVA_VERSION
+
+echo "Compiling for Spark 4.1 with Scala 2.13 using Java $JAVA_VERSION..."
+cd apache-sedona-${SEDONA_VERSION}-src && $MVN_WRAPPER clean && $MVN_WRAPPER install -DskipTests -Dspark=4.1 -Dscala=2.13 && cd ..
+cp apache-sedona-${SEDONA_VERSION}-src/spark-shaded/target/sedona-*${SEDONA_VERSION}.jar apache-sedona-${SEDONA_VERSION}-bin/
+
+# 清理 Maven 包装脚本
+rm -f /tmp/mvn-java11 /tmp/mvn-java17
+
+tar czf apache-sedona-${SEDONA_VERSION}-bin.tar.gz apache-sedona-${SEDONA_VERSION}-bin
+
+# 为二进制包生成校验和与签名
+shasum -a 512 apache-sedona-${SEDONA_VERSION}-bin.tar.gz > apache-sedona-${SEDONA_VERSION}-bin.tar.gz.sha512
+gpg -ab apache-sedona-${SEDONA_VERSION}-bin.tar.gz
+
+echo "Uploading binary files..."
+
+# 上传二进制相关文件
+svn import -m "Adding file" apache-sedona-${SEDONA_VERSION}-bin.tar.gz https://dist.apache.org/repos/dist/dev/sedona/${RC_VERSION}/apache-sedona-${SEDONA_VERSION}-bin.tar.gz
+svn import -m "Adding file" apache-sedona-${SEDONA_VERSION}-bin.tar.gz.asc https://dist.apache.org/repos/dist/dev/sedona/${RC_VERSION}/apache-sedona-${SEDONA_VERSION}-bin.tar.gz.asc
+svn import -m "Adding file" apache-sedona-${SEDONA_VERSION}-bin.tar.gz.sha512 https://dist.apache.org/repos/dist/dev/sedona/${RC_VERSION}/apache-sedona-${SEDONA_VERSION}-bin.tar.gz.sha512
+
+echo "Removing local release files..."
+
+rm apache-sedona-${SEDONA_VERSION}-src.tar.gz
+rm apache-sedona-${SEDONA_VERSION}-src.tar.gz.asc
+rm apache-sedona-${SEDONA_VERSION}-src.tar.gz.sha512
+rm apache-sedona-${SEDONA_VERSION}-bin.tar.gz
+rm apache-sedona-${SEDONA_VERSION}-bin.tar.gz.asc
+rm apache-sedona-${SEDONA_VERSION}-bin.tar.gz.sha512
+rm -rf apache-sedona-${SEDONA_VERSION}-src
+rm -rf apache-sedona-${SEDONA_VERSION}-bin
+
+```
+
+## 6. 在 dev sedona.apache.org 邮件列表上投票
+
+### 投票邮件
+
+如有需要,请在邮件末尾追加变更说明:
+
+```
+Subject: [VOTE] Release Apache Sedona {{ sedona_create_release.current_rc }}
+
+Hi all,
+
+This is a call for vote on Apache Sedona {{ sedona_create_release.current_rc }}. Please refer to the changes listed at the bottom of this email.
+
+Release notes:
+https://github.com/apache/sedona/blob/{{ sedona_create_release.current_git_tag }}/docs/setup/release-notes.md
+
+Build instructions:
+https://github.com/apache/sedona/blob/{{ sedona_create_release.current_git_tag }}/docs/setup/compile.md
+
+GitHub tag:
+https://github.com/apache/sedona/releases/tag/{{ sedona_create_release.current_git_tag }}
+
+GPG public key to verify the Release:
+https://downloads.apache.org/sedona/KEYS
+
+Source code and binaries:
+https://dist.apache.org/repos/dist/dev/sedona/{{ sedona_create_release.current_rc }}/
+
+The vote will be open for at least 72 hours or until at least 3 "+1" PMC votes are cast
+
+Instruction for checking items on the checklist: https://sedona.apache.org/latest/community/vote/
+
+We recommend you use this Jupyter notebook on MyBinder to perform this task: https://mybinder.org/v2/gh/jiayuasu/sedona-tools/HEAD?labpath=binder%2Fverify-release.ipynb
+
+**Please vote accordingly and you must provide your checklist for your vote**.
+
+
+[ ] +1 approve
+
+[ ] +0 no opinion
+
+[ ] -1 disapprove with the reason
+
+Checklist:
+
+[ ] Download links are valid.
+
+[ ] Checksums and PGP signatures are valid.
+
+[ ] Source code artifacts have correct names matching the current release.
+
+For a detailed checklist  please refer to:
+https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Release+Checklist
+
+------------
+
+Changes according to the comments on the previous release
+Original comment (Permalink from https://lists.apache.org/list.html):
+
+
+```
+
+### 投票通过邮件
+
+请统计票数,并在邮件末尾加上投票邮件的 Permalink:
+
+```
+Subject: [RESULT][VOTE] Release Apache Sedona {{ sedona_create_release.current_rc }}
+
+Dear all,
+
+The vote closes now as 72hr have passed. The vote PASSES with
+
++? (binding): NAME1, NAME2, NAME3
++? (non-binding): NAME4
+No -1 votes
+
+The vote thread (Permalink from https://lists.apache.org/list.html):
+
+I will make an announcement soon.
+
+```
+
+### 公告邮件
+
+1. 该邮件应发送至 dev@sedona.apache.org。
+2. 请加上投票邮件的 permalink。
+3. 请加上投票结果邮件的 permalink。
+
+```
+Subject: [ANNOUNCE] Apache Sedona {{ sedona_create_release.current_version }} released
+
+Dear all,
+
+We are happy to report that we have released Apache Sedona {{ sedona_create_release.current_version }}. Thank you again for your help.
+
+Apache Sedona is a cluster computing system for processing large-scale spatial data.
+
+
+Vote thread (Permalink from https://lists.apache.org/list.html):
+
+
+Vote result thread (Permalink from https://lists.apache.org/list.html):
+
+
+Website:
+https://sedona.apache.org/
+
+Release notes:
+https://github.com/apache/sedona/blob/sedona-{{ sedona_create_release.current_version }}/docs/setup/release-notes.md
+
+Download links:
+https://github.com/apache/sedona/releases/tag/sedona-{{ sedona_create_release.current_version }}
+
+Additional resources:
+Mailing list: dev@sedona.apache.org
+Twitter: https://twitter.com/ApacheSedona
+Gitter: https://gitter.im/apache/sedona
+
+Regards,
+Apache Sedona Team
+```
+
+## 7. 投票失败
+
+如果投票未通过:
+
+1. 在投票邮件中说明我们将创建另一个 release candidate。
+2. 从第 4 步 `更新 mkdocs.yml` 重新开始。请把 release candidate ID 递增(如 `{{ sedona_create_release.current_version}}-rc2`),并相应更新 `mkdocs.yml` 中的 `sedona_create_release.current_rc` 与 `sedona_create_release.current_git_tag` 来生成本页脚本。
+
+## 8. 发布源码与 Maven 包
+
+### 上传发布版本
+
+```bash
+#!/bin/bash
+
+echo "Move all files in https://dist.apache.org/repos/dist/dev/sedona to https://dist.apache.org/repos/dist/release/sedona, using svn"
+svn mkdir -m "Adding folder" https://dist.apache.org/repos/dist/release/sedona/{{ sedona_create_release.current_version }}
+wget https://dist.apache.org/repos/dist/dev/sedona/{{ sedona_create_release.current_rc }}/apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz
+wget https://dist.apache.org/repos/dist/dev/sedona/{{ sedona_create_release.current_rc }}/apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz.asc
+wget https://dist.apache.org/repos/dist/dev/sedona/{{ sedona_create_release.current_rc }}/apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz.sha512
+wget https://dist.apache.org/repos/dist/dev/sedona/{{ sedona_create_release.current_rc }}/apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz
+wget https://dist.apache.org/repos/dist/dev/sedona/{{ sedona_create_release.current_rc }}/apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz.asc
+wget https://dist.apache.org/repos/dist/dev/sedona/{{ sedona_create_release.current_rc }}/apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz.sha512
+svn import -m "Adding file" apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz https://dist.apache.org/repos/dist/release/sedona/{{ sedona_create_release.current_version }}/apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz
+svn import -m "Adding file" apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz.asc https://dist.apache.org/repos/dist/release/sedona/{{ sedona_create_release.current_version }}/apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz.asc
+svn import -m "Adding file" apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz.sha512 https://dist.apache.org/repos/dist/release/sedona/{{ sedona_create_release.current_version }}/apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz.sha512
+svn import -m "Adding file" apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz https://dist.apache.org/repos/dist/release/sedona/{{ sedona_create_release.current_version }}/apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz
+svn import -m "Adding file" apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz.asc https://dist.apache.org/repos/dist/release/sedona/{{ sedona_create_release.current_version }}/apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz.asc
+svn import -m "Adding file" apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz.sha512 https://dist.apache.org/repos/dist/release/sedona/{{ sedona_create_release.current_version }}/apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz.sha512
+rm apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz
+rm apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz.asc
+rm apache-sedona-{{ sedona_create_release.current_version }}-src.tar.gz.sha512
+rm apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz
+rm apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz.asc
+rm apache-sedona-{{ sedona_create_release.current_version }}-bin.tar.gz.sha512
+```
+
+### 手动 close 并 release Maven 包
+
+1. 在 https://repository.apache.org 的 `staging repository` 中找到 Sedona 暂存仓库,点击 `Close`。
+2. staging repo close 完成后,再点击 `Release`。
+
+## 9. 发布 Sedona Python
+
+创建 GitHub release 后,Sedona GitHub CI 会自动把 wheel 文件发布到 PyPI。
+
+## 10. 发布 Sedona Zeppelin
+
+```bash
+#!/bin/bash
+
+wget https://github.com/apache/sedona/archive/refs/tags/{{ sedona_create_release.current_git_tag}}.tar.gz
+tar -xvf {{ sedona_create_release.current_git_tag}}.tar.gz
+mkdir apache-sedona-{{ sedona_create_release.current_version }}-src
+cp -r sedona-{{ sedona_create_release.current_git_tag}}/* apache-sedona-{{ sedona_create_release.current_version }}-src/
+
+rm -rf apache-{{ sedona_create_release.current_git_tag}}
+
+cd apache-sedona-{{ sedona_create_release.current_version }}-src/zeppelin && npm publish && cd ..
+rm -rf apache-sedona-{{ sedona_create_release.current_version }}-src
+```
+
+## 11. 将 Sedona R 发布到 CRAN
+
+```bash
+#!/bin/bash
+R CMD build .
+R CMD check --as-cran apache.sedona_*.tar.gz
+```
+
+然后通过 [此网页表单](https://xmpalantir.wu.ac.at/cransubmit/) 提交到 CRAN。
+
+## 12. 发布文档网站
+
+1. 在本地仓库中把 {{ sedona_create_release.current_version }} 的 Git tag check out 到名为 `branch-{{ sedona_create_release.current_version }}` 的分支。
+2. 把下载链接添加到 [Download 页面](../download.md)。
+3. 把新闻添加到 `docs/index.md`。
+4. 将该分支的更改推送到 GitHub。
+5. GitHub CI 会自动捕捉这些更改并部署到 `website` 分支。
+6. 通常 [此仓库](https://github.com/jiayuasu/sedona-sync-action) 会按日自动发布该网站。
diff --git a/docs/community/release-manager.zh.md b/docs/community/release-manager.zh.md
new file mode 100644
index 0000000000..08659d37ec
--- /dev/null
+++ b/docs/community/release-manager.zh.md
@@ -0,0 +1,170 @@
+<!--
+ 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.
+ -->
+
+# 成为发布经理
+
+只有第一次担任发布经理时,才需要执行下面这些步骤。
+
+## 0. 软件要求
+
+* JDK 11/17:`brew install openjdk@11` 或 `brew install openjdk@17`
+* Maven 3.X,且 Maven 必须指向 JDK 11 或 17。可通过 `mvn --version` 检查。
+* Git 与 SVN
+
+如果 `mvn --version` 显示 Maven 当前指向其他 JDK 版本,您必须把它切换到 JDK 11 或 17。步骤如下:
+
+1. 列出本机所有已安装的 Java 版本:`/usr/libexec/java_home -V`。应能看到包含 JDK 11 与 17 的多个版本。
+2. 运行 `whereis mvn` 获取 Maven 的安装位置。结果是一个指向真实位置的符号链接。
+3. 在终端中打开该文件(必要时使用 `sudo`)。内容大致如下:
+
+```
+#!/bin/bash
+JAVA_HOME="${JAVA_HOME:-$(/usr/libexec/java_home)}" exec "/usr/local/Cellar/maven/3.6.3/libexec/bin/mvn" "$@"
+```
+
+4. 将 `JAVA_HOME:-$(/usr/libexec/java_home)}` 改为 `JAVA_HOME:-$(/usr/libexec/java_home -v 11)}` 或 `JAVA_HOME:-$(/usr/libexec/java_home -v 17)}`。修改后大致如下:
+
+```
+#!/bin/bash
+JAVA_HOME="${JAVA_HOME:-$(/usr/libexec/java_home -v 11)}" exec "/usr/local/Cellar/maven/3.6.3/libexec/bin/mvn" "$@"
+```
+
+5. 再次运行 `mvn --version`,此时应已指向 JDK 11 或 17。
+
+## 1. 获得 Sedona GitHub 仓库的写权限
+
+1. 确认您的 GitHub 账号已启用 2FA:https://help.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/
+2. 在 Apache ID 资料中填写您的 GitHub ID:https://id.apache.org/
+3. 通过 GitBox(Apache 账号关联工具)合并 Apache 与 GitHub 账号:https://gitbox.apache.org/setup/
+	* GitBox 中应能看到 5 个绿色对勾。
+	* 等待至少 30 分钟,您会收到一封邀请加入 Apache GitHub 组织的邮件,点击接受邀请即可。
+4. 接受邀请后,确认您已在团队中:https://github.com/orgs/apache/teams/sedona-committers
+5. 此外,如果您当选为 Sedona PMC 成员,还应确认自己出现在 LDAP 的 Sedona PMC 列表中:https://whimsy.apache.org/roster/pmc/sedona
+
+## 2. 准备 GPG 私钥
+
+1. 如果尚未安装 GNUPG,请先安装。Mac 上:`brew install gnupg gnupg2`。
+2. 生成一个私钥,必须是 RSA4096(4096 位)。
+   * 运行 `gpg --full-generate-key`;如果不可用,运行 `gpg --default-new-key-algo rsa4096 --gen-key`。
+   * 提示选择密钥类型时:选 `RSA`,按 `enter`。
+   * 提示选择密钥长度时:输入 `4096`。
+   * 提示选择密钥有效期时:直接 `enter`,让密钥永不过期。
+   * 确认所选项无误。
+   * 输入用户身份信息:使用真实姓名与 Apache 邮箱。
+   * 设置一个安全的口令(passphrase),请记住,后续会用到。
+   * 运行 `gpg --list-secret-keys --keyid-format=long` 查看长格式的 GPG key 列表。
+   * 从中复制您要使用的 key ID 长格式(如 `3AA5C34371567BD2`)。
+   * 运行 `gpg --export --armor 3AA5C34371567BD2`,替换为您的 key ID。
+   * 复制 `-----BEGIN PGP PUBLIC KEY BLOCK-----` 与 `-----END PGP PUBLIC KEY BLOCK-----` 之间的内容(即 armored key)。
+   * `-----BEGIN PGP PUBLIC KEY BLOCK-----` 与实际 key 之间必须有一空行。
+3. 将 armored key 发布到主流 key server:https://keyserver.pgp.com/
+
+## 3. 使用 SVN 更新 KEYS
+
+通过 SVN 将您的 armored 公钥追加到下面这两个 `KEYS` 文件中:
+
+   * https://dist.apache.org/repos/dist/dev/sedona/KEYS
+   * https://dist.apache.org/repos/dist/release/sedona/KEYS
+
+1. 分别 check out 两个 KEYS 文件:
+
+```bash
+svn checkout https://dist.apache.org/repos/dist/dev/sedona/ sedona-dev --depth files
+svn checkout https://dist.apache.org/repos/dist/release/sedona/ sedona-release --depth files
+```
+
+2. 使用您喜欢的文本编辑器打开 `sedona-dev/KEYS` 与 `sedona-release/KEYS`。
+3. 把 armored key 粘贴到这两个文件末尾。注意:`-----BEGIN PGP PUBLIC KEY BLOCK-----` 与实际 key 之间必须有一空行。
+4. 提交两个 KEYS。SVN 可能会要求输入您的 ASF ID 与密码——请输入,以便 SVN 在本地保存您的凭据。
+
+```bash
+svn commit -m "Update KEYS" sedona-dev/KEYS
+svn commit -m "Update KEYS" sedona-release/KEYS
+```
+
+5. 然后删除两个 svn 工作目录:
+
+```bash
+rm -rf sedona-dev
+rm -rf sedona-release
+```
+
+## 4. 添加 GPG_TTY 环境变量
+
+在 `~/.bashrc` 中加入下列内容,然后重启终端:
+
+```bash
+GPG_TTY=$(tty)
+export GPG_TTY
+```
+
+## 5. 获取 GitHub Personal Access Token(classic)
+
+您需要创建一个 GitHub Personal Access Token(classic),可参考 [GitHub 官方文档](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token#creating-a-personal-access-token-classic)。
+
+简要步骤:
+
+1. 在 GitHub 界面进入 Settings。
+2. 在左侧栏点击 Developer settings。
+3. 在左侧栏的 Personal access tokens 下点击 Tokens (classic)。
+4. 选择 Generate new token,然后点击 Generate new token (classic)。
+5. 给 token 起一个有描述性的名字。
+6. 设置 token 的过期时间——选择 Expiration 下拉菜单时,请设置为 `No expiration`。
+7. 选择该 token 的权限范围。要从命令行访问仓库,请勾选 `repo` 与 `admin:org`。
+8. 点击 `Generate token`。
+9. 请把 token 保存好,下一步会用到。
+
+## 6. 配置 Maven 凭据
+
+在 `~/.m2/settings.xml` 中加入以下内容;如果该文件或 `.m2` 目录不存在,请先创建。
+
+请将所有大写文本替换为您自己的 ID 与密码。
+
+```
+<settings>
+  <servers>
+    <server>
+      <id>github</id>
+      <username>YOUR_GITHUB_USERNAME</username>
+      <password>YOUR_GITHUB_TOKEN</password>
+    </server>
+    <server>
+      <id>apache.snapshots.https</id>
+      <username>YOUR_ASF_ID</username>
+      <password>YOUR_ASF_PASSWORD</password>
+    </server>
+    <server>
+      <id>apache.releases.https</id>
+      <username>YOUR_ASF_ID</username>
+      <password>YOUR_ASF_PASSWORD</password>
+    </server>
+  </servers>
+  <profiles>
+    <profile>
+      <id>gpg</id>
+      <properties>
+        <gpg.passphrase>YOUR_GPG_PASSPHRASE</gpg.passphrase>
+      </properties>
+    </profile>
+  </profiles>
+  <activeProfiles>
+    <activeProfile>gpg</activeProfile>
+  </activeProfiles>
+</settings>
+```
diff --git a/docs/community/rule.zh.md b/docs/community/rule.zh.md
new file mode 100644
index 0000000000..b7e2c2f514
--- /dev/null
+++ b/docs/community/rule.zh.md
@@ -0,0 +1,75 @@
+<!--
+ 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.
+ -->
+
+# 为 Apache Sedona 贡献
+
+本项目欢迎贡献。您可以在 [Sedona GitHub 仓库](https://github.com/apache/sedona) 上提交 Pull Request 来贡献代码或文档。
+
+下面简述完成一次贡献的工作流程。
+
+## 选取/公示任务
+
+在开始贡献之前,确认贡献内容是否会被接受很重要。请先通过工单(ticket)告知社区您的意图。Sedona 同时接受 [GitHub issues](https://github.com/apache/sedona/issues?q=sort%3Aupdated-desc+is%3Aissue+is%3Aopen) 与 [JIRA](https://issues.apache.org/jira/projects/SEDONA)。新建 JIRA 工单时,会自动发送邮件通知 `dev@sedona.apache.org`。
+
+## 编写代码贡献
+
+代码贡献应包括:
+
+* 类与方法的详尽文档。
+* 用于证明代码正确性、并能在后续维护中保持的单元测试。对于 bug 修复,单元测试应能在没有该修复时复现 bug(如适用)。单元测试可以是 JUnit 测试或 Scala 测试。部分 Sedona 函数需要在 Scala 与 Java 两侧分别测试。
+* 必要时更新对应的 Sedona 文档。
+
+代码贡献必须在每个文件顶部包含 Apache 2.0 许可声明。
+
+提交 PR 前请运行 `mvn spotless:apply` 来格式化代码。如果您修改了某个特定 Spark 版本的代码(例如 `spark/spark-3.5/` 下的源文件),请追加对应的 Maven CLI 参数:`mvn spotless:apply -Dscala=2.12 -Dspark=3.5`。
+
+## 编写文档贡献
+
+文档贡献应满足以下要求:
+
+* 详细的解释与示例。
+* 把新增文档放在合适的目录下。
+* 必要时修改 ==mkdocs.yml==。
+
+!!!note
+	请阅读 [编译源码](../setup/compile.md#compile-the-documentation) 了解如何编译 Sedona 网站。
+
+## 提交 Pull Request
+
+完成贡献之后,最简单也最直观的提交方式是向 [GitHub 仓库](https://github.com/apache/sedona) 提交 Pull Request(PR)。
+
+**请在 PR 名称中使用 JIRA 工单 ID 或 GitHub issue ID,例如 "[SEDONA-1] my subject" 或 "[GH-1] my subject"。**
+
+创建 PR 时,请回答 PR 模板中的问题。
+
+提交 PR 之后,GitHub Action 会自动检查构建是否正确。请关注 PR 状态并修复其中的所有问题。
+
+## 评审 Pull Request
+
+* 每个 PR 需要满足:(1) 至少有 1 名 committer 批准;(2) 没有 committer 表示反对。任何人都欢迎参与评审,但最终决定由 committer 做出。
+* 其他评审者(包括社区成员与 committer)可以评论变更并建议修改。可以直接向同一分支推送更多 commit 来追加修改。
+* 即使最终结果可能是拒绝整个变更,社区也鼓励大家进行积极、礼貌、迅速的技术讨论。
+* 请注意:对 Sedona 关键部分(如 Sedona core、空间连接算法)的改动会接受更严格的评审,可能需要更多测试与正确性证明。
+* 有时其他变更被合并后,会与您的 PR 产生冲突。冲突解决前 PR 无法合并。请手动解决冲突,并把结果推送到您的分支。
+
+## 行为准则
+
+请阅读 [Apache 软件基金会行为准则](https://www.apache.org/foundation/policies/conduct.html)。
+
+凡正式或非正式参与 Apache 社区、声称与基金会有任何关联、参与任何与基金会相关的活动(尤其是以任何身份代表 ASF)的人员,都需遵守这一准则。
diff --git a/docs/community/snapshot.zh.md b/docs/community/snapshot.zh.md
new file mode 100644
index 0000000000..a904ba5c94
--- /dev/null
+++ b/docs/community/snapshot.zh.md
@@ -0,0 +1,73 @@
+<!--
+ 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.
+ -->
+
+# 发布 SNAPSHOT 版本
+
+本步骤用于将 Maven SNAPSHOT 发布到 https://repository.apache.org
+
+对于发布经理(release manager)来说,这是检验自己凭据配置的良好实践。
+
+详细要求见 [ASF Infra 网站](https://infra.apache.org/publishing-maven-artifacts.html)。
+
+!!!warning
+    本页所有脚本都应在本地 Sedona Git 仓库的 master 分支下,通过单一脚本文件运行。
+
+## 0. 准备一个空脚本文件
+
+1. 在本地 Sedona Git 仓库 master 分支下运行:
+
+```bash
+echo '#!/bin/bash' > create-release.sh
+chmod 777 create-release.sh
+```
+
+2. 用您喜欢的 GUI 文本编辑器打开 `create-release.sh`。
+3. 然后不断把本页上的脚本复制粘贴到该文件中,覆盖原内容。
+4. 不要直接将脚本复制粘贴到终端,因为 `clipboard.js` 的一个 bug 会在这种情形下产生换行符问题。
+5. 每次更新该脚本后,运行 `./create-release.sh` 执行它。
+
+## 1. 上传 snapshot 版本
+
+在您的 Sedona GitHub 仓库中运行:
+
+```bash
+#!/bin/bash
+
+git checkout master
+git pull
+
+rm -f release.*
+rm -f pom.xml.*
+
+# 校验 POM 与凭据配置
+mvn -q -B clean release:prepare -Dtag={{ sedona_create_release.current_git_tag }} -DreleaseVersion={{ sedona_create_release.current_version }} -DdevelopmentVersion={{ sedona_create_release.current_snapshot }} -Dresume=false -DdryRun=true -Penable-all-submodules -Darguments="-DskipTests"
+mvn -q -B release:clean -Penable-all-submodules
+
+# Spark 3.3 与 Scala 2.12
+mvn -q deploy -DskipTests -Dspark=3.3 -Dscala=2.12
+
+# Spark 3.3 与 Scala 2.13
+mvn -q deploy -DskipTests -Dspark=3.3 -Dscala=2.13
+
+# Spark 3.4 与 Scala 2.12
+mvn -q deploy -DskipTests -Dspark=3.4 -Dscala=2.12
+
+# Spark 3.4 与 Scala 2.13
+mvn -q deploy -DskipTests -Dspark=3.4 -Dscala=2.13
+```
diff --git a/docs/community/vote.zh.md b/docs/community/vote.zh.md
new file mode 100644
index 0000000000..2b480c050c
--- /dev/null
+++ b/docs/community/vote.zh.md
@@ -0,0 +1,128 @@
+<!--
+ 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.
+ -->
+
+# 投票发布 Sedona 版本
+
+本页面面向 Sedona 社区,用于对 Sedona 发布版本进行投票。下面的脚本已在 macOS 上测试通过。
+
+要对 Sedona 发布版本投票,您需要在投票邮件中提供至少包含以下条目的检查清单:
+
+* 下载链接有效
+* 校验和与 PGP 签名有效
+* 已包含 DISCLAIMER 与 NOTICE
+* 源码 artifact 名称与当前发布版本一致
+* 项目能从源码成功编译
+
+为方便您完成校验,我们提供了一份基于 MyBinder 的 [在线 Jupyter Notebook](https://github.com/jiayuasu/sedona-tools)。点击下方按钮即可打开 notebook 进行校验:[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jiayuasu/sedona-tools/HEAD?labpath=binder%2Fverify-release.ipynb)。校验通过后,即可在投票邮件中投 `+1`。
+
+如果您更愿意在本机执行这些步骤,请阅读下方的步骤说明。如果能成功完成所有步骤,则上述检查清单都会得到满足,您即可在投票邮件中投 `+1` 并附上检查清单。
+
+## 安装必要软件
+
+1. GPG:在 Mac 上 `brew install gnupg gnupg2`。可在终端中通过 `gpg --version` 检查。
+2. JDK 1.8 或 1.11。Mac 上可能安装了多种 Java 版本,可以尝试当前版本,但不保证一定能通过。可在终端通过 `java --version` 检查。
+3. Apache Maven 3.3.1+。在 Mac 上 `brew install maven`。可在终端通过 `mvn -version` 检查。
+4. Python3:macOS 默认带有 Python3。可在终端通过 `python3 --version` 检查。
+
+如果您之前已安装过这些软件,可跳过本步骤。
+
+## 运行校验脚本
+
+请将 SEDONA\_CURRENT\_RC 与 SEDONA\_CURRENT\_VERSION 替换为正确的版本号,然后把内容粘贴到名为 `verify.sh` 的脚本中,并将输出重定向到文件。运行方式:
+
+```bash
+#!/bin/bash
+
+## 修改脚本权限为可执行
+chmod 777 verify.sh
+
+## 运行并把输出重定向到文件
+./verify.sh &> verify.out
+```
+
+`verify.sh` 内容如下。==如果直接复制下方内容,长行可能会被自动加上换行,请在本地脚本中将其去掉。==
+
+```bash
+#!/bin/bash
+
+SEDONA_CURRENT_RC={{ sedona_create_release.current_rc }}
+SEDONA_CURRENT_VERSION={{ sedona_create_release.current_version }}
+
+## 下载 Sedona 发布
+wget -q https://downloads.apache.org/sedona/KEYS
+wget -q https://dist.apache.org/repos/dist/dev/sedona/$SEDONA_CURRENT_RC/apache-sedona-$SEDONA_CURRENT_VERSION-src.tar.gz
+wget -q https://dist.apache.org/repos/dist/dev/sedona/$SEDONA_CURRENT_RC/apache-sedona-$SEDONA_CURRENT_VERSION-src.tar.gz.asc
+wget -q https://dist.apache.org/repos/dist/dev/sedona/$SEDONA_CURRENT_RC/apache-sedona-$SEDONA_CURRENT_VERSION-src.tar.gz.sha512
+wget -q https://dist.apache.org/repos/dist/dev/sedona/$SEDONA_CURRENT_RC/apache-sedona-$SEDONA_CURRENT_VERSION-bin.tar.gz
+wget -q https://dist.apache.org/repos/dist/dev/sedona/$SEDONA_CURRENT_RC/apache-sedona-$SEDONA_CURRENT_VERSION-bin.tar.gz.asc
+wget -q https://dist.apache.org/repos/dist/dev/sedona/$SEDONA_CURRENT_RC/apache-sedona-$SEDONA_CURRENT_VERSION-bin.tar.gz.sha512
+
+## 校验签名与校验和
+gpg --import KEYS
+gpg --verify apache-sedona-$SEDONA_CURRENT_VERSION-src.tar.gz.asc
+gpg --verify apache-sedona-$SEDONA_CURRENT_VERSION-bin.tar.gz.asc
+shasum -a 512 apache-sedona-$SEDONA_CURRENT_VERSION-src.tar.gz
+cat apache-sedona-$SEDONA_CURRENT_VERSION-src.tar.gz.sha512
+shasum -a 512 apache-sedona-$SEDONA_CURRENT_VERSION-bin.tar.gz
+cat apache-sedona-$SEDONA_CURRENT_VERSION-bin.tar.gz.sha512
+
+## 解压源码包
+tar -xvf apache-sedona-$SEDONA_CURRENT_VERSION-src.tar.gz
+
+## 从源码编译项目
+(cd apache-sedona-$SEDONA_CURRENT_VERSION-src;mvn clean install -DskipTests)
+
+```
+
+* 如果运行成功,输出文件中应能看到与下面类似的信息,并包含 `Good signature from`,最后 4 行应是两对相互匹配的校验和:
+
+```
+gpg: key 3A79A47AC26FF4CD: "Jia Yu <ji...@apache.org>" not changed
+gpg: key 6C883CA80E7FD299: "PawelKocinski <im...@apache.org>" not changed
+gpg: Total number processed: 2
+gpg:              unchanged: 2
+gpg: assuming signed data in 'apache-sedona-1.2.0-incubating-src.tar.gz'
+gpg: Signature made Mon Apr  4 11:48:31 2022 PDT
+gpg:                using RSA key 949DD6275C69AB954B1872FC6C883CA80E7FD299
+gpg:                issuer "imbruced@apache.org"
+gpg: Good signature from "PawelKocinski <im...@apache.org>" [unknown]
+gpg: WARNING: The key's User ID is not certified with a trusted signature!
+gpg:          There is no indication that the signature belongs to the owner.
+Primary key fingerprint: 949D D627 5C69 AB95 4B18  72FC 6C88 3CA8 0E7F D299
+gpg: assuming signed data in 'apache-sedona-1.2.0-incubating-bin.tar.gz'
+gpg: Signature made Mon Apr  4 11:48:42 2022 PDT
+gpg:                using RSA key 949DD6275C69AB954B1872FC6C883CA80E7FD299
+gpg:                issuer "imbruced@apache.org"
+gpg: Good signature from "PawelKocinski <im...@apache.org>" [unknown]
+gpg: WARNING: The key's User ID is not certified with a trusted signature!
+gpg:          There is no indication that the signature belongs to the owner.
+Primary key fingerprint: 949D D627 5C69 AB95 4B18  72FC 6C88 3CA8 0E7F D299
+d3bdfd4d870838ebe63f21cb93634d2421ec1ac1b8184636206a5dc0d89a78a88257798b1f17371ad3cfcc3b1eb79c69e1410afdefeb4d9b52fc8bb5ea18dd2e  apache-sedona-1.2.0-incubating-src.tar.gz
+d3bdfd4d870838ebe63f21cb93634d2421ec1ac1b8184636206a5dc0d89a78a88257798b1f17371ad3cfcc3b1eb79c69e1410afdefeb4d9b52fc8bb5ea18dd2e  apache-sedona-1.2.0-incubating-src.tar.gz
+64cea38dd3ca171ee4e2a7365dbce999773862f2a11599bd0f27e9551d740659a519a9b976b3e7b0826088010967093e6acc9462f7073e9737c24b007a2df846  apache-sedona-1.2.0-incubating-bin.tar.gz
+64cea38dd3ca171ee4e2a7365dbce999773862f2a11599bd0f27e9551d740659a519a9b976b3e7b0826088010967093e6acc9462f7073e9737c24b007a2df846  apache-sedona-1.2.0-incubating-bin.tar.gz
+```
+
+* 如果源码编译成功,您还会在输出末尾看到 `BUILD SUCCESS`。如果该步骤失败,可联系 Sedona PMC 询问是否仅是您本地环境的问题。
+
+## 手动检查文件
+
+1. 检查下载的文件版本号是否正确。
+
+2. 解压源码目录后,检查 DISCLAIMER 与 NOTICE 文件是否存在且为最新。


(sedona) 02/12: [GH-2909] Translate documentation landing pages to Chinese (#2922)

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit c4613115cf5453050aa0592d11f3df1647b8ec46
Author: Jia Yu <ji...@apache.org>
AuthorDate: Thu May 7 11:53:02 2026 -0700

    [GH-2909] Translate documentation landing pages to Chinese (#2922)
    
    (cherry picked from commit 304859290cc85e12a82015ec746a4025ba1e067e)
---
 .../stylesheets/components/_lang-switch.scss       |  50 +++
 docs-overrides/assets/stylesheets/extra.scss       |   1 +
 docs-overrides/main.html                           | 360 ++++++++++++++-------
 docs-overrides/partials/alternate.html             |  15 +
 docs/download.zh.md                                |  63 ++++
 docs/sedonaflink.zh.md                             | 111 +++++++
 docs/sedonasnow.zh.md                              |  55 ++++
 docs/sedonaspark.zh.md                             | 135 ++++++++
 8 files changed, 680 insertions(+), 110 deletions(-)

diff --git a/docs-overrides/assets/stylesheets/components/_lang-switch.scss b/docs-overrides/assets/stylesheets/components/_lang-switch.scss
new file mode 100644
index 0000000000..df515fa9c8
--- /dev/null
+++ b/docs-overrides/assets/stylesheets/components/_lang-switch.scss
@@ -0,0 +1,50 @@
+.sd-lang-switch {
+  display: inline-flex;
+  align-items: stretch;
+  margin: 0 0.4rem;
+  padding: 2px;
+  border: 1px solid rgba(255, 255, 255, 0.45);
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.08);
+  font-size: 0.72rem;
+  line-height: 1;
+
+  &__item {
+    display: inline-flex;
+    align-items: center;
+    padding: 0.28rem 0.7rem;
+    color: rgba(255, 255, 255, 0.85);
+    text-decoration: none;
+    border-radius: 999px;
+    font-weight: 600;
+    letter-spacing: 0.02em;
+    transition: background-color 120ms ease, color 120ms ease;
+
+    &:hover,
+    &:focus {
+      color: #ffffff;
+      background-color: rgba(255, 255, 255, 0.18);
+    }
+
+    &--active {
+      color: #ca463a;
+      background-color: #ffffff;
+
+      &:hover,
+      &:focus {
+        color: #ca463a;
+        background-color: #ffffff;
+      }
+    }
+  }
+}
+
+@media (max-width: 600px) {
+  .sd-lang-switch {
+    font-size: 0.68rem;
+
+    &__item {
+      padding: 0.22rem 0.55rem;
+    }
+  }
+}
diff --git a/docs-overrides/assets/stylesheets/extra.scss b/docs-overrides/assets/stylesheets/extra.scss
index 632f78effe..ff3d71722b 100644
--- a/docs-overrides/assets/stylesheets/extra.scss
+++ b/docs-overrides/assets/stylesheets/extra.scss
@@ -13,6 +13,7 @@
 @import "components/footer";
 @import "components/sidebar";
 @import "components/search-tags";
+@import "components/lang-switch";
 
 // Pages
 @import "pages/page-home";
diff --git a/docs-overrides/main.html b/docs-overrides/main.html
index 652d9c4d85..1098300f0b 100644
--- a/docs-overrides/main.html
+++ b/docs-overrides/main.html
@@ -1,9 +1,17 @@
 {% extends "base.html" %}
 
+{# Locale shared across all blocks below. Detected once via mkdocs-static-i18n's
+   reconfigure_material flag, which sets config.theme.language per build. #}
+{%- set cur_lang = config.theme.language if config.theme.language in ['en', 'zh'] else 'en' -%}
+
 {% block outdated %}
-You're not viewing the latest stable version.
+{%- set outdated_msg = {
+    'en': ['You\'re not viewing the latest stable version.', 'Click here to go to the latest stable version.'],
+    'zh': ['您当前查看的不是最新稳定版本。', '点击此处跳转到最新稳定版本。']
+} -%}
+{{ outdated_msg[cur_lang][0] }}
 <a href="{{ '../' ~ base_url }}">
-  <strong>Click here to go to the latest stable version.</strong>
+  <strong>{{ outdated_msg[cur_lang][1] }}</strong>
 </a>
 {% endblock %}
 
@@ -20,14 +28,146 @@ You're not viewing the latest stable version.
 {% endblock %}
 
 {% block header %}
+  {%- set announcement = {
+      'en': 'Apache Sedona 1.9.0 is out now, featuring Spark 4.1 support, proj4sedona CRS transformation, Bing Tile functions, and more!',
+      'zh': 'Apache Sedona 1.9.0 已正式发布,新增 Spark 4.1 支持、proj4sedona 坐标系转换、Bing Tile 函数等众多特性!'
+  } -%}
   <div style="background: #CA463A; color: white; text-align: center; padding: 0.5rem;">
-    <a href="setup/release-notes/" title="Announcement">Apache Sedona 1.9.0 is out now, featuring Spark 4.1 support, proj4sedona CRS transformation, Bing Tile functions, and more!</a>
+    <a href="{{ 'setup/release-notes/' | url }}" title="Announcement">{{ announcement[cur_lang] }}</a>
   </div>
   {{ super() }} {# This renders the original header below your test bar #}
 {% endblock %}
 
 {% block container %}
-    {% if page.is_homepage %}
+    {% set is_home = page.is_homepage or (page.file and page.file.src_uri in ['index.md', 'index.zh.md']) %}
+    {% if is_home %}
+    {%- set i18n = {
+        'en': {
+            'hero_subtitle': 'Apache Sedona™ makes it easy to process spatial datasets of any scale.',
+            'hero_cta': 'Get Started',
+            'global_scale_title_1': 'QUERY and JOIN',
+            'global_scale_title_2': 'from local to global scale',
+            'typed_gps': 'GPS points',
+            'typed_buildings': 'buildings',
+            'typed_parcels': 'parcels',
+            'typed_trips': 'trips',
+            'typed_places': 'places',
+            'typed_businesses': 'businesses',
+            'typed_land': 'land',
+            'typed_vegetation': 'vegetation',
+            'typed_rasters': 'rasters',
+            'typed_vectors': 'vectors',
+            'typed_tabular': 'tabular tables',
+            'get_started_title': 'Get started in seconds',
+            'get_started_desc': 'Install SedonaDB, or run Sedona on distributed systems when you need additional scale.',
+            'install_sedonadb_cta': 'Install SedonaDB',
+            'deploy_title': 'Deploy Sedona where you need it',
+            'deploy_desc': 'Choose the right runtime for your infrastructure, from local setups to distributed and cloud-native systems.',
+            'tag_local': 'Local',
+            'tag_batch': 'Batch',
+            'tag_streaming': 'Streaming',
+            'tag_cloud': 'Cloud',
+            'sedonadb_desc': 'Standalone runtime for local processing and development.',
+            'sedonaspark_desc': 'Distributed batch processing on Apache Spark clusters.',
+            'sedonaflink_desc': 'Real-time spatial analytics using Apache Flink.',
+            'sedonasnow_desc': 'Native spatial support inside Snowflake environments.',
+            'sedona_cloud_title': 'Sedona in the Cloud',
+            'sedona_cloud_desc': 'Integrated spatial support in your preferred cloud environment',
+            'sedona_cloud_cta': 'Explore the ecosystem',
+            'industries_title': 'Want to share your Sedona use case?',
+            'industries_subtitle': 'Join our Discord or create a GitHub Discussion so we can collaborate.',
+            'industry_mobility': 'Mobility',
+            'industry_telecom': 'Telecom',
+            'industry_data': 'Data and map production',
+            'industry_logistics': 'Logistics',
+            'industry_energy': 'Energy',
+            'industry_finance': 'Finance',
+            'features_title': 'Apache Sedona at a glance',
+            'features_desc': 'Core features that define Sedona’s geospatial performance',
+            'feature_scalable_title': 'Scalable',
+            'feature_scalable_desc': 'Works with small or large datasets with Spark, Flink, or locally.',
+            'feature_complete_title': 'Feature Complete',
+            'feature_complete_desc': '300+ spatial functions, support for spatial file formats, and compatible with lakehouses and databases.',
+            'feature_raster_title': 'Raster and Vector Support',
+            'feature_raster_desc': 'Analyze both raster and vector datasets.',
+            'feature_portable_title': 'Portable',
+            'feature_portable_desc': 'Easy to run locally, in the cloud, or with any data platform.',
+            'feature_fast_title': 'Fast',
+            'feature_fast_desc': 'Optimized execution for single node or distributed cluster environments.',
+            'feature_fast_cta': 'See the benchmarks',
+            'feature_familiar_title': 'Familiar',
+            'feature_familiar_desc': 'Supports many programming languages and runnable in the environment where you feel most comfortable.',
+            'community_title': 'Join the community',
+            'community_desc': 'Discover what our community has to say about their Apache Sedona experience.',
+            'events_title': 'Monthly community meetings and programming conferences',
+            'events_cta': 'Find Events',
+            'events_decor_pre': 'Sedona ',
+            'events_decor_strong': 'Events'
+        },
+        'zh': {
+            'hero_subtitle': 'Apache Sedona™ 让处理任意规模的空间数据变得轻而易举。',
+            'hero_cta': '立即开始',
+            'global_scale_title_1': '查询与连接',
+            'global_scale_title_2': '从本地到全球规模',
+            'typed_gps': 'GPS 轨迹点',
+            'typed_buildings': '建筑',
+            'typed_parcels': '地块',
+            'typed_trips': '出行',
+            'typed_places': '场所',
+            'typed_businesses': '商户',
+            'typed_land': '土地',
+            'typed_vegetation': '植被',
+            'typed_rasters': '栅格',
+            'typed_vectors': '矢量',
+            'typed_tabular': '表格数据',
+            'get_started_title': '几秒钟即可上手',
+            'get_started_desc': '安装 SedonaDB,或在需要更大规模时将 Sedona 部署到分布式系统。',
+            'install_sedonadb_cta': '安装 SedonaDB',
+            'deploy_title': '在任何需要的地方部署 Sedona',
+            'deploy_desc': '从本地环境到分布式与云原生系统,选择最适合您基础设施的运行时。',
+            'tag_local': '本地',
+            'tag_batch': '批处理',
+            'tag_streaming': '流处理',
+            'tag_cloud': '云端',
+            'sedonadb_desc': '面向本地处理与开发的独立运行时。',
+            'sedonaspark_desc': '在 Apache Spark 集群上的分布式批处理。',
+            'sedonaflink_desc': '基于 Apache Flink 的实时空间分析。',
+            'sedonasnow_desc': '在 Snowflake 环境中提供原生空间支持。',
+            'sedona_cloud_title': '云端的 Sedona',
+            'sedona_cloud_desc': '在您所选的云环境中集成空间能力',
+            'sedona_cloud_cta': '探索生态系统',
+            'industries_title': '想分享您的 Sedona 应用案例?',
+            'industries_subtitle': '加入我们的 Discord,或在 GitHub Discussions 发起讨论,与我们协作。',
+            'industry_mobility': '出行',
+            'industry_telecom': '电信',
+            'industry_data': '数据与地图生产',
+            'industry_logistics': '物流',
+            'industry_energy': '能源',
+            'industry_finance': '金融',
+            'features_title': 'Apache Sedona 概览',
+            'features_desc': '定义 Sedona 地理空间性能的核心特性',
+            'feature_scalable_title': '可扩展',
+            'feature_scalable_desc': '可在 Spark、Flink 或本地处理小型或大型数据集。',
+            'feature_complete_title': '功能完备',
+            'feature_complete_desc': '300+ 空间函数,支持多种空间文件格式,并与数据湖仓和数据库兼容。',
+            'feature_raster_title': '同时支持栅格与矢量',
+            'feature_raster_desc': '可同时分析栅格与矢量数据集。',
+            'feature_portable_title': '可移植',
+            'feature_portable_desc': '易于在本地、云端或任何数据平台上运行。',
+            'feature_fast_title': '高性能',
+            'feature_fast_desc': '面向单节点或分布式集群环境的优化执行。',
+            'feature_fast_cta': '查看基准测试',
+            'feature_familiar_title': '熟悉易用',
+            'feature_familiar_desc': '支持多种编程语言,可在您最熟悉的环境中使用。',
+            'community_title': '加入社区',
+            'community_desc': '听听社区对 Apache Sedona 使用体验的分享。',
+            'events_title': '每月社区会议与技术大会',
+            'events_cta': '查看活动',
+            'events_decor_pre': 'Sedona ',
+            'events_decor_strong': '活动'
+        }
+    } -%}
+    {%- set t = i18n[cur_lang] -%}
     <div class="page-home">
 
       <!-- Section Hero -->
@@ -35,24 +175,24 @@ You're not viewing the latest stable version.
         <div class="container">
 
           <div class="logo-wrap">
-            <img src="image/home/hero/logo.svg" alt="" class="logo">
+            <img src="{{ "image/home/hero/logo.svg" | url }}" alt="" class="logo">
             <h1 class="page-title">Apache Sedona</h1>
           </div>
 
           <div class="section-description editor">
-            Apache Sedona™ makes it easy to process spatial datasets of any scale.
+            {{ t.hero_subtitle }}
           </div>
 
           <div class="btn-group">
             <a href="{{ page.next_page.url | url }}" title="{{ page.next_page.title | striptags }}" class="btn btn-black">
-              Get Started
+              {{ t.hero_cta }}
             </a>
           </div>
 
         </div>
 
         <div class="img-bg-wrap">
-          <img src="image/home/hero/mountains-desktop.svg" alt="" class="img-bg">
+          <img src="{{ "image/home/hero/mountains-desktop.svg" | url }}" alt="" class="img-bg">
         </div>
       </section>
 
@@ -63,24 +203,24 @@ You're not viewing the latest stable version.
 
             <div class="col-left">
               <div class="section-title">
-                <div>QUERY and JOIN</div>
+                <div>{{ t.global_scale_title_1 }}</div>
 
                 <p class="typed-wrap"><span class="typed"></span></p>
                 <div class="typed-strings">
-                  <p>GPS points</p>
-                  <p>buildings</p>
-                  <p>parcels</p>
-                  <p>trips</p>
-                  <p>places</p>
-                  <p>businesses</p>
-                  <p>land</p>
-                  <p>vegetation</p>
-                  <p>rasters</p>
-                  <p>vectors</p>
-                  <p>tabular tables</p>
+                  <p>{{ t.typed_gps }}</p>
+                  <p>{{ t.typed_buildings }}</p>
+                  <p>{{ t.typed_parcels }}</p>
+                  <p>{{ t.typed_trips }}</p>
+                  <p>{{ t.typed_places }}</p>
+                  <p>{{ t.typed_businesses }}</p>
+                  <p>{{ t.typed_land }}</p>
+                  <p>{{ t.typed_vegetation }}</p>
+                  <p>{{ t.typed_rasters }}</p>
+                  <p>{{ t.typed_vectors }}</p>
+                  <p>{{ t.typed_tabular }}</p>
                 </div>
 
-                <div>from local to global scale</div>
+                <div>{{ t.global_scale_title_2 }}</div>
               </div>
               <div class="section-description editor"></div>
             </div>
@@ -163,15 +303,15 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
             </div>
             <div class="col-right">
               <h2 class="section-title">
-                Get started in seconds
+                {{ t.get_started_title }}
               </h2>
               <div class="section-description editor">
-                Install SedonaDB, or run Sedona on distributed systems when you need additional scale.
+                {{ t.get_started_desc }}
               </div>
               <div class="bth-group">
                 <a href="/sedonadb" class="btn btn-red">
                      <span class="caption">
-                   Install SedonaDB
+                   {{ t.install_sedonadb_cta }}
                   </span>
                 </a>
               </div>
@@ -183,19 +323,19 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
       <!-- Section Deploy -->
       <section class="section-deploy">
         <div class="container">
-          <h2 class="section-title">Deploy Sedona where you need it</h2>
-          <div class="section-description editor">Choose the right runtime for your infrastructure, from local setups to distributed and cloud-native systems.</div>
+          <h2 class="section-title">{{ t.deploy_title }}</h2>
+          <div class="section-description editor">{{ t.deploy_desc }}</div>
           <div class="info-grid">
 
             <div class="info-item">
               <div class="info-item__tag">
-                <img src="image/home/deploy/desktop.svg" alt="" class="">
+                <img src="{{ "image/home/deploy/desktop.svg" | url }}" alt="" class="">
                 <div class="caption">
-                  Local
+                  {{ t.tag_local }}
                 </div>
               </div>
               <h3 class="info-item__title">SedonaDB</h3>
-              <div class="info-item__description editor">Standalone runtime for local processing and development.</div>
+              <div class="info-item__description editor">{{ t.sedonadb_desc }}</div>
               <div class="info-item__cta">
                 <a href="/sedonadb" class="btn-link">
                   <span class="caption">SedonaDB</span>
@@ -211,13 +351,13 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
 
             <div class="info-item">
               <div class="info-item__tag">
-                <img src="image/home/deploy/database.svg" alt="" class="">
+                <img src="{{ "image/home/deploy/database.svg" | url }}" alt="" class="">
                 <div class="caption">
-                  Batch
+                  {{ t.tag_batch }}
                 </div>
               </div>
               <h3 class="info-item__title">SedonaSpark</h3>
-              <div class="info-item__description editor">Distributed batch processing on Apache Spark clusters.</div>
+              <div class="info-item__description editor">{{ t.sedonaspark_desc }}</div>
               <div class="info-item__cta">
                 <a href="sedonaspark" class="btn-link">
                   <span class="caption">SedonaSpark</span>
@@ -233,13 +373,13 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
 
             <div class="info-item">
               <div class="info-item__tag">
-                <img src="image/home/deploy/signal.svg" alt="" class="">
+                <img src="{{ "image/home/deploy/signal.svg" | url }}" alt="" class="">
                 <div class="caption">
-                  Streaming
+                  {{ t.tag_streaming }}
                 </div>
               </div>
               <h3 class="info-item__title">SedonaFlink</h3>
-              <div class="info-item__description editor">Real-time spatial analytics using Apache Flink.</div>
+              <div class="info-item__description editor">{{ t.sedonaflink_desc }}</div>
               <div class="info-item__cta">
                 <a href="sedonaflink" class="btn-link">
                   <span class="caption">SedonaFlink</span>
@@ -255,14 +395,14 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
 
             <div class="info-item">
               <div class="info-item__tag">
-                <img src="image/home/deploy/snowflake.svg" alt="" class="">
+                <img src="{{ "image/home/deploy/snowflake.svg" | url }}" alt="" class="">
                 <div class="caption">
-                    Batch
+                    {{ t.tag_batch }}
                 </div>
               </div>
               <h3 class="info-item__title">SedonaSnow</h3>
               <div class="info-item__description editor">
-                Native spatial support inside Snowflake environments.
+                {{ t.sedonasnow_desc }}
               </div>
               <div class="info-item__cta">
                 <a href="sedonasnow" class="btn-link">
@@ -279,16 +419,16 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
 
             <div class="info-item info-item--wide">
               <div class="info-item__tag">
-                <img src="image/home/deploy/cloud.svg" alt="" class="">
+                <img src="{{ "image/home/deploy/cloud.svg" | url }}" alt="" class="">
                 <div class="caption">
-                  Cloud
+                  {{ t.tag_cloud }}
                 </div>
               </div>
-              <h3 class="info-item__title">Sedona in the Cloud</h3>
-              <div class="info-item__description editor">Integrated spatial support in your preferred cloud environment</div>
+              <h3 class="info-item__title">{{ t.sedona_cloud_title }}</h3>
+              <div class="info-item__description editor">{{ t.sedona_cloud_desc }}</div>
               <div class="info-item__cta">
                 <a href="setup/overview/" class="btn-link">
-                  <span class="caption">Explore the ecosystem</span>
+                  <span class="caption">{{ t.sedona_cloud_cta }}</span>
                   <span class="icon">
                         <svg width="19" height="19" viewBox="0 0 19 19" fill="none" xmlns="http://www.w3.org/2000/svg">
     <path d="M3.95831 9.5H15.0416" stroke="#CA463A" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" />
@@ -309,10 +449,10 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
         <div class="container">
           <div class="content-box">
 
-            <h2 class="section-title">Want to share your Sedona use case?</h2>
+            <h2 class="section-title">{{ t.industries_title }}</h2>
 
             <div class="section__subtitle editor">
-              Join our Discord or create a GitHub Discussion so we can collaborate.
+              {{ t.industries_subtitle }}
             </div>
 
             <div class="industries-tabs">
@@ -320,22 +460,22 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
               <div class="industries-tabs__head-wrap">
                 <div class="industries-tabs__head">
                   <div class="industries-tabs__head-item active">
-                    Mobility
+                    {{ t.industry_mobility }}
                   </div>
                   <div class="industries-tabs__head-item ">
-                    Telecom
+                    {{ t.industry_telecom }}
                   </div>
                   <div class="industries-tabs__head-item">
-                    Data and map production
+                    {{ t.industry_data }}
                   </div>
                   <div class="industries-tabs__head-item">
-                    Logistics
+                    {{ t.industry_logistics }}
                   </div>
                   <div class="industries-tabs__head-item">
-                    Energy
+                    {{ t.industry_energy }}
                   </div>
                   <div class="industries-tabs__head-item">
-                    Finance
+                    {{ t.industry_finance }}
                   </div>
                 </div>
               </div>
@@ -345,63 +485,63 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
                 <div data-tab="Mobility" class="industries-tabs__body-item active">
                   <div class="industries-grid">
                     <div class="grid-item">
-                      <img src="image/home/industries/bmw.svg" alt="" class="">
+                      <img src="{{ "image/home/industries/bmw.svg" | url }}" alt="" class="">
                     </div>
                     <div class="grid-item">
-                      <img src="image/home/industries/gm.svg" alt="" class="">
+                      <img src="{{ "image/home/industries/gm.svg" | url }}" alt="" class="">
                     </div>
                     <div class="grid-item">
-                      <img src="image/home/industries/placer-ai.svg" alt="" class="">
+                      <img src="{{ "image/home/industries/placer-ai.svg" | url }}" alt="" class="">
                     </div>
                     <div class="grid-item">
-                      <img src="image/home/industries/arity.svg" alt="" class="">
+                      <img src="{{ "image/home/industries/arity.svg" | url }}" alt="" class="">
                     </div>
                   </div>
                 </div>
 
                 <div data-tab="Telecom" class="industries-tabs__body-item">
                   <div class="industries-grid">
-                    <div class="grid-item"><img src="image/home/industries/comcast.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/at&t.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/telus.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/t-mobile.svg" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/comcast.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/at&t.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/telus.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/t-mobile.svg" | url }}" alt="" class=""></div>
                   </div>
                 </div>
 
                 <div data-tab="Data and map production" class="industries-tabs__body-item">
                   <div class="industries-grid">
-                    <div class="grid-item"><img src="image/home/industries/space-x.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/maxar.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/mapbox.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/tom-tom.svg" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/space-x.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/maxar.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/mapbox.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/tom-tom.svg" | url }}" alt="" class=""></div>
                   </div>
                 </div>
 
                 <div data-tab="Logistics" class="industries-tabs__body-item">
                   <div class="industries-grid">
-                    <div class="grid-item"><img src="image/home/industries/instacart.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/uber.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/UnitedAirlines.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/Boeing.svg" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/instacart.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/uber.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/UnitedAirlines.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/Boeing.svg" | url }}" alt="" class=""></div>
                   </div>
                 </div>
 
                 <div data-tab="Energy" class="industries-tabs__body-item">
                   <div class="industries-grid">
-                    <div class="grid-item"><img src="image/home/industries/shell.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/DukeEnergy.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/PG&E.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/Southern_Company.svg" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/shell.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/DukeEnergy.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/PG&E.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/Southern_Company.svg" | url }}" alt="" class=""></div>
                   </div>
                 </div>
 
                 <div data-tab="Finance" class="industries-tabs__body-item">
                   <div class="industries-grid">
-                    <div class="grid-item"><img src="image/home/industries/Allstate.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/CapitalOne.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/cigna.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/JPMorganChase.svg" alt="" class=""></div>
-                    <div class="grid-item"><img src="image/home/industries/StateFarm.svg" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/Allstate.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/CapitalOne.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/cigna.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/JPMorganChase.svg" | url }}" alt="" class=""></div>
+                    <div class="grid-item"><img src="{{ "image/home/industries/StateFarm.svg" | url }}" alt="" class=""></div>
                   </div>
                 </div>
 
@@ -427,51 +567,51 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
       <!-- Section Features -->
       <section class="section-features">
         <div class="container">
-          <h2 class="section-title">Apache Sedona at a glance</h2>
-          <div class="section-description editor">Core features that define Sedona’s geospatial performance</div>
+          <h2 class="section-title">{{ t.features_title }}</h2>
+          <div class="section-description editor">{{ t.features_desc }}</div>
           <div class="features-grid">
 
             <div class="feature-item">
               <div class="feature-item__icon">
-                <img src="image/home/features/scalable.svg" alt="" class="">
+                <img src="{{ "image/home/features/scalable.svg" | url }}" alt="" class="">
               </div>
-              <h3 class="feature-item__title">Scalable</h3>
-              <div class="feature-item__description editor">Works with small or large datasets with Spark, Flink, or locally.</div>
+              <h3 class="feature-item__title">{{ t.feature_scalable_title }}</h3>
+              <div class="feature-item__description editor">{{ t.feature_scalable_desc }}</div>
             </div>
 
             <div class="feature-item">
               <div class="feature-item__icon">
-                <img src="image/home/features/waves.svg" alt="" class="">
+                <img src="{{ "image/home/features/waves.svg" | url }}" alt="" class="">
               </div>
-              <h3 class="feature-item__title">Feature Complete</h3>
-              <div class="feature-item__description editor">300+ spatial functions, support for spatial file formats, and compatible with lakehouses and databases.</div>
+              <h3 class="feature-item__title">{{ t.feature_complete_title }}</h3>
+              <div class="feature-item__description editor">{{ t.feature_complete_desc }}</div>
             </div>
 
             <div class="feature-item">
               <div class="feature-item__icon">
-                <img src="image/home/features/picture.svg" alt="" class="">
+                <img src="{{ "image/home/features/picture.svg" | url }}" alt="" class="">
               </div>
-              <h3 class="feature-item__title">Raster and Vector Support</h3>
-              <div class="feature-item__description editor">Analyze both raster and vector datasets.</div>
+              <h3 class="feature-item__title">{{ t.feature_raster_title }}</h3>
+              <div class="feature-item__description editor">{{ t.feature_raster_desc }}</div>
             </div>
 
             <div class="feature-item">
               <div class="feature-item__icon">
-                <img src="image/home/features/cloud.svg" alt="" class="">
+                <img src="{{ "image/home/features/cloud.svg" | url }}" alt="" class="">
               </div>
-              <h3 class="feature-item__title">Portable</h3>
-              <div class="feature-item__description editor">Easy to run locally, in the cloud, or with any data platform.</div>
+              <h3 class="feature-item__title">{{ t.feature_portable_title }}</h3>
+              <div class="feature-item__description editor">{{ t.feature_portable_desc }}</div>
             </div>
 
             <div class="feature-item">
               <div class="feature-item__icon">
-                <img src="image/home/features/rocket.svg" alt="" class="">
+                <img src="{{ "image/home/features/rocket.svg" | url }}" alt="" class="">
               </div>
-              <h3 class="feature-item__title">Fast</h3>
-              <div class="feature-item__description editor">Optimized execution for single node or distribute cluster environments.</div>
+              <h3 class="feature-item__title">{{ t.feature_fast_title }}</h3>
+              <div class="feature-item__description editor">{{ t.feature_fast_desc }}</div>
               <div class="feature-item__cta">
                 <a href="https://github.com/apache/sedona-spatialbench" class="btn-link">
-                  <span class="caption">See the benchmarks</span>
+                  <span class="caption">{{ t.feature_fast_cta }}</span>
                   <span class="icon">
                         <svg width="19" height="19" viewBox="0 0 19 19" fill="none" xmlns="http://www.w3.org/2000/svg">
     <path d="M3.95831 9.5H15.0416" stroke="#CA463A" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" />
@@ -484,10 +624,10 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
 
             <div class="feature-item">
               <div class="feature-item__icon">
-                <img src="image/home/features/code.svg" alt="" class="">
+                <img src="{{ "image/home/features/code.svg" | url }}" alt="" class="">
               </div>
-              <h3 class="feature-item__title">Familiar</h3>
-              <div class="feature-item__description editor">Supports many programming languages and runnable in the environment where you feel most comfortable.</div>
+              <h3 class="feature-item__title">{{ t.feature_familiar_title }}</h3>
+              <div class="feature-item__description editor">{{ t.feature_familiar_desc }}</div>
             </div>
 
 
@@ -510,8 +650,8 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
       <!-- Section Community -->
       <section class="section-community">
         <div class="container">
-          <h2 class="section-title">Join the community</h2>
-          <div class="section-description editor">Discover what our community has to say about their Apache Sedona experience.</div>
+          <h2 class="section-title">{{ t.community_title }}</h2>
+          <div class="section-description editor">{{ t.community_desc }}</div>
           <div class="btn-group">
             <a href="https://github.com/apache/sedona/discussions" class="btn btn-light-red">
                   <span class="caption">
@@ -546,7 +686,7 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
             <div class="community-card">
               <div class="community-card__author">
                 <div class="author-avatar">
-                  <img src="image/home/community/author.jpg" alt="" class="">
+                  <img src="{{ "image/home/community/author.jpg" | url }}" alt="" class="">
                 </div>
                 <div class="author-info">
                   <div class="author-name">Sean Rose</div>
@@ -560,7 +700,7 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
             <div class="community-card">
               <div class="community-card__author">
                 <div class="author-avatar">
-                  <img src="image/home/community/author.jpg" alt="" class="">
+                  <img src="{{ "image/home/community/author.jpg" | url }}" alt="" class="">
                 </div>
                 <div class="author-info">
                   <div class="author-name">Sean Rose</div>
@@ -574,7 +714,7 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
             <div class="community-card">
               <div class="community-card__author">
                 <div class="author-avatar">
-                  <img src="image/home/community/author.jpg" alt="" class="">
+                  <img src="{{ "image/home/community/author.jpg" | url }}" alt="" class="">
                 </div>
                 <div class="author-info">
                   <div class="author-name">Sean Rose</div>
@@ -588,7 +728,7 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
             <div class="community-card">
               <div class="community-card__author">
                 <div class="author-avatar">
-                  <img src="image/home/community/author.jpg" alt="" class="">
+                  <img src="{{ "image/home/community/author.jpg" | url }}" alt="" class="">
                 </div>
                 <div class="author-info">
                   <div class="author-name">Sean Rose</div>
@@ -602,7 +742,7 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
             <div class="community-card">
               <div class="community-card__author">
                 <div class="author-avatar">
-                  <img src="image/home/community/author.jpg" alt="" class="">
+                  <img src="{{ "image/home/community/author.jpg" | url }}" alt="" class="">
                 </div>
                 <div class="author-info">
                   <div class="author-name">Sean Rose</div>
@@ -627,21 +767,21 @@ docker run -d -p 8888:8888 -p 8085:8085 apache/sedona:latest
           <div class="content-box">
             <div class="content-box__inner">
               <h2 class="section-title">
-                Monthly community meetings and programming conferences
+                {{ t.events_title }}
               </h2>
               <div class="btn-group">
                 <a href="community/contact/" class="btn btn-red">
                      <span class="caption">
-                    Find Events
+                    {{ t.events_cta }}
                   </span>
                 </a>
               </div>
             </div>
-            <img src="image/home/events/corner-mountains.svg" alt="" class="corner-img">
+            <img src="{{ "image/home/events/corner-mountains.svg" | url }}" alt="" class="corner-img">
             <div class="events-line">
-              <div>Sedona <strong>Events</strong></div>
-              <div>Sedona <strong>Events</strong></div>
-              <div>Sedona <strong>Events</strong></div>
+              <div>{{ t.events_decor_pre }}<strong>{{ t.events_decor_strong }}</strong></div>
+              <div>{{ t.events_decor_pre }}<strong>{{ t.events_decor_strong }}</strong></div>
+              <div>{{ t.events_decor_pre }}<strong>{{ t.events_decor_strong }}</strong></div>
             </div>
           </div>
         </div>
diff --git a/docs-overrides/partials/alternate.html b/docs-overrides/partials/alternate.html
new file mode 100644
index 0000000000..e038aad5c4
--- /dev/null
+++ b/docs-overrides/partials/alternate.html
@@ -0,0 +1,15 @@
+{% if config.extra.alternate and config.extra.alternate | length > 1 %}
+<nav class="sd-lang-switch" aria-label="{{ lang.t('select.language') }}">
+  {% for alt in config.extra.alternate %}
+    {%- set is_active = (alt.lang == config.theme.language) -%}
+    <a
+      href="{{ alt.link | url }}"
+      hreflang="{{ alt.lang }}"
+      lang="{{ alt.lang }}"
+      target="_self"
+      class="sd-lang-switch__item{% if is_active %} sd-lang-switch__item--active{% endif %}"
+      {% if is_active %}aria-current="true"{% endif %}
+    >{{ alt.name }}</a>
+  {% endfor %}
+</nav>
+{% endif %}
diff --git a/docs/download.zh.md b/docs/download.zh.md
new file mode 100644
index 0000000000..585535de18
--- /dev/null
+++ b/docs/download.zh.md
@@ -0,0 +1,63 @@
+<!--
+ 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.
+ -->
+
+## GitHub 代码仓库
+
+最新源代码:[GitHub 代码仓库](https://github.com/apache/sedona/)
+
+历史 GeoSpark 版本:[GitHub Releases](https://github.com/apache/sedona/releases)
+
+每次提交到 master 分支后自动构建的二进制 JAR 包:[GitHub Action](https://github.com/apache/sedona/actions/workflows/java.yml)
+
+## 校验完整性
+
+[公钥](https://downloads.apache.org/sedona/KEYS)
+
+[校验说明](https://www.apache.org/info/verification.html)
+
+## 版本
+
+### 1.9.0
+
+| |                                    从 ASF 下载                                     |                                         校验和                                          |                                      签名                                      |
+|:-----------------:|:----------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------:|
+|    源代码    | [src](https://www.apache.org/dyn/closer.lua/sedona/1.9.0/apache-sedona-1.9.0-src.tar.gz) | [sha512](https://downloads.apache.org/sedona/1.9.0/apache-sedona-1.9.0-src.tar.gz.sha512) | [asc](https://downloads.apache.org/sedona/1.9.0/apache-sedona-1.9.0-src.tar.gz.asc) |
+|       二进制      | [bin](https://www.apache.org/dyn/closer.lua/sedona/1.9.0/apache-sedona-1.9.0-bin.tar.gz) | [sha512](https://downloads.apache.org/sedona/1.9.0/apache-sedona-1.9.0-bin.tar.gz.sha512) | [asc](https://downloads.apache.org/sedona/1.9.0/apache-sedona-1.9.0-bin.tar.gz.asc) |
+
+### 1.8.1
+
+| |                                    从 ASF 下载                                     |                                         校验和                                          |                                      签名                                      |
+|:-----------------:|:----------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------:|
+|    源代码    | [src](https://www.apache.org/dyn/closer.lua/sedona/1.8.1/apache-sedona-1.8.1-src.tar.gz) | [sha512](https://downloads.apache.org/sedona/1.8.1/apache-sedona-1.8.1-src.tar.gz.sha512) | [asc](https://downloads.apache.org/sedona/1.8.1/apache-sedona-1.8.1-src.tar.gz.asc) |
+|       二进制      | [bin](https://www.apache.org/dyn/closer.lua/sedona/1.8.1/apache-sedona-1.8.1-bin.tar.gz) | [sha512](https://downloads.apache.org/sedona/1.8.1/apache-sedona-1.8.1-bin.tar.gz.sha512) | [asc](https://downloads.apache.org/sedona/1.8.1/apache-sedona-1.8.1-bin.tar.gz.asc) |
+
+### 1.7.2
+
+| |                                    从 ASF 下载                                     |                                         校验和                                          |                                      签名                                      |
+|:-----------------:|:----------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------:|
+|    源代码    | [src](https://www.apache.org/dyn/closer.lua/sedona/1.7.2/apache-sedona-1.7.2-src.tar.gz) | [sha512](https://downloads.apache.org/sedona/1.7.2/apache-sedona-1.7.2-src.tar.gz.sha512) | [asc](https://downloads.apache.org/sedona/1.7.2/apache-sedona-1.7.2-src.tar.gz.asc) |
+|       二进制      | [bin](https://www.apache.org/dyn/closer.lua/sedona/1.7.2/apache-sedona-1.7.2-bin.tar.gz) | [sha512](https://downloads.apache.org/sedona/1.7.2/apache-sedona-1.7.2-bin.tar.gz.sha512) | [asc](https://downloads.apache.org/sedona/1.7.2/apache-sedona-1.7.2-bin.tar.gz.asc) |
+
+### 历史版本
+
+历史版本的 Sedona 已归档,可在以下位置找到:[Apache 归档](https://archive.apache.org/dist/sedona/)(1.2.1-incubating 及之后的版本)。
+
+## 安全
+
+如有安全相关问题,请参阅 https://www.apache.org/security/
diff --git a/docs/sedonaflink.zh.md b/docs/sedonaflink.zh.md
new file mode 100644
index 0000000000..0888e4825e
--- /dev/null
+++ b/docs/sedonaflink.zh.md
@@ -0,0 +1,111 @@
+<!--
+ 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.
+ -->
+
+# SedonaFlink
+
+SedonaFlink 将地理空间函数集成到 Apache Flink 中,是构建依赖地理空间数据的流式管道的理想选择。
+
+以下是 SedonaFlink 的一些典型应用场景:
+
+* 从 Kafka 读取地理空间数据并写入 Iceberg
+* [实时分析交通密度](https://www.alibabacloud.com/help/en/flink/realtime-flink/use-cases/analyze-traffic-density-with-flink-and-apache-sedona)
+* 电信行业的实时网络规划与优化
+
+下面是一些示例代码片段:
+
+=== "Java"
+
+    ```java
+    sedona.createTemporaryView("myTable", tbl)
+    Table geomTbl = sedona.sqlQuery("SELECT ST_GeomFromWKT(geom_polygon) as geom_polygon, name_polygon FROM myTable")
+    geomTbl.execute().print()
+    ```
+
+=== "PyFlink"
+
+    ```python
+    table_env.sql_query("SELECT ST_ASBinary(ST_Point(1.0, 2.0))").execute().collect()
+    ```
+
+## 主要特性
+
+* **实时地理空间流处理**,满足低延迟处理需求。
+* **可扩展**,适用于大规模流式管道。
+* 基于 Flink 的时间窗口实现**事件时间处理**。
+* 提供**精确一次(Exactly Once)**处理保证。
+* **可移植**,易于在任何 Flink 运行时中部署。
+* **开源**,遵循 Apache 软件基金会的准则进行管理。
+
+## 为什么在 Flink 上使用 Sedona?
+
+Flink 是为流式数据而设计的,Sedona 在此基础上为其加入了地理空间处理能力。
+
+大多数地理空间处理发生在 Spark 或 PostGIS 这类批处理系统中,对于延迟要求不高的场景这没有问题。
+
+而当需要实时处理地理空间数据时,Sedona on Flink 的优势就会显现出来。
+
+Flink 可以为地理空间查询提供毫秒级的延迟。
+
+Flink 拥有完善的容错机制,即使在故障发生时,地理空间管道也不会丢失数据。
+
+Sedona on Flink 可以在 Flink 支持的任何环境中运行,包括 Kubernetes、YARN 以及独立集群。
+
+## 工作原理
+
+Sedona 直接集成到 Flink 的 Table API 和 SQL 引擎中。
+
+在搭建 Flink 环境时注册 Sedona 的空间函数,即可在 SQL 查询中使用 `ST_Point`、`ST_Contains`、`ST_Distance` 等函数。
+
+Sedona 同时支持 Flink 的 DataStream API 与 Table API,可根据自身工作流程选用。
+
+空间运算作为 Flink 分布式执行的一部分运行,因此地理空间计算会自动在集群中并行执行。
+
+Sedona 在 Flink 内部以二进制方式存储几何对象,从而保持较低的内存占用与较高的处理速度。
+
+执行空间连接时,Sedona 在底层使用空间索引,使查询能够快速完成。
+
+容错由 Flink 的检查点(checkpoint)机制处理。如果某个节点崩溃,地理空间状态可以从最近一次检查点恢复。
+
+通常的流程是:从 Kafka 或文件系统等数据源读取地理空间数据,使用 Sedona 的空间函数进行处理,然后将结果写入 Iceberg 等数据汇。
+
+整条 SedonaFlink 管道持续运行,新事件会实时流过空间转换逻辑。
+
+## 与其他方案的对比
+
+对于较小的数据集,可能并不需要分布式集群,使用 SedonaDB 即可。
+
+对于大规模批处理管道,可以使用 SedonaSpark。
+
+下面是 SedonaFlink 与几种流式方案的直接对比。
+
+**SedonaFlink 与 Sedona on Spark Structured Streaming**
+
+Spark Streaming 采用微批(micro-batch)模式,而 Flink 是逐事件处理。在某些工作流中,这能让 Flink 的延迟更低。
+
+Flink 的状态管理也更为成熟。
+
+如果已经深度使用 Spark 生态,且 Spark Structured Streaming 的延迟可以满足需求,可以选择 Spark;如果对延迟有非常严苛的要求,建议选择 Flink。
+
+**Sedona on Flink 与 PostGIS**
+
+PostGIS 非常适合用于 OLTP 工作负载下的地理空间数据存储与查询,但它并不是为流式处理而设计的。
+
+如果使用 PostGIS 处理流式工作负载,需要持续从流处理器中查询数据库,这会增加延迟,并对数据库造成压力。
+
+SedonaFlink 在数据流转过程中即对地理空间数据进行处理,从而避免了与数据库之间的往返开销。
diff --git a/docs/sedonasnow.zh.md b/docs/sedonasnow.zh.md
new file mode 100644
index 0000000000..fbaa56f5ea
--- /dev/null
+++ b/docs/sedonasnow.zh.md
@@ -0,0 +1,55 @@
+<!--
+ 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.
+ -->
+
+# SedonaSnow
+
+SedonaSnow 将 Apache Sedona 的 200 多个地理空间函数直接引入到 Snowflake 环境中,作为 Snowflake 原生空间函数的有力补充。
+
+## 主要优势
+
+* **200+ 空间函数**:例如 3D 距离、几何对象校验、精度归约等
+* **高性能空间连接**:Sedona 针对空间连接做了专门优化
+* **无缝集成**:与 Snowflake 原生函数协同工作
+* **数据无需移动**:所有处理都在 Snowflake 内部完成
+
+## 快速上手
+
+下面是一个使用 SedonaSnow 在 Snowflake 表上执行查询的示例。
+
+```sql
+USE DATABASE SEDONASNOW;
+
+SELECT SEDONA.ST_GeomFromWKT(wkt) AS geom
+FROM your_table;
+
+SELECT SEDONA.ST_3DDistance(geom1, geom2) FROM spatial_data;
+```
+
+下面是一个空间连接的示例:
+
+```sql
+SELECT * FROM lefts, rights
+WHERE lefts.cellId = rights.cellId;
+```
+
+可以看出,SedonaSnow 能够无缝地接入现有的 Snowflake 环境。
+
+## 后续步骤
+
+如果您正在 Snowflake 中进行严肃的空间分析工作,SedonaSnow 是一个非常合适的选择。它运行速度快,并提供了丰富的空间函数。SedonaSnow 在不需要将数据迁移到其他平台的前提下,突破了 Snowflake 内置空间函数的能力限制。
diff --git a/docs/sedonaspark.zh.md b/docs/sedonaspark.zh.md
new file mode 100644
index 0000000000..cb3db6198e
--- /dev/null
+++ b/docs/sedonaspark.zh.md
@@ -0,0 +1,135 @@
+<!--
+ 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.
+ -->
+
+# SedonaSpark
+
+SedonaSpark 在 Apache Spark 之上扩展了一套丰富、开箱即用的分布式空间数据集和函数,能够在多台机器之间高效地加载、处理和分析大规模空间数据。当数据集规模超过单机处理能力时,SedonaSpark 是一个非常合适的选择。
+
+=== "SQL"
+
+    ```sql
+    SELECT superhero.name
+    FROM city, superhero
+    WHERE ST_Contains(city.geom, superhero.geom)
+    AND city.name = 'Gotham'
+    ```
+
+=== "PySpark"
+
+    ```python
+    sedona.sql("""
+        SELECT superhero.name
+        FROM city, superhero
+        WHERE ST_Contains(city.geom, superhero.geom)
+        AND city.name = 'Gotham'
+    """)
+    ```
+
+=== "Java"
+
+    ```java
+    Dataset<Row> result = spark.sql(
+    "SELECT superhero.name " +
+    "FROM city, superhero " +
+    "WHERE ST_Contains(city.geom, superhero.geom) " +
+    "AND city.name = 'Gotham'"
+    );
+    ```
+
+=== "Scala"
+
+    ```scala
+    sedona.sql("""
+        SELECT superhero.name
+        FROM city, superhero
+        WHERE ST_Contains(city.geom, superhero.geom)
+        AND city.name = 'Gotham'
+    """)
+    ```
+
+=== "R"
+
+    ```r
+    result <- sql("
+    SELECT superhero.name
+    FROM city, superhero
+    WHERE ST_Contains(city.geom, superhero.geom)
+    AND city.name = 'Gotham'
+    ")
+    ```
+
+## 主要特性
+
+* **极致性能**:SedonaSpark 在集群中的多个节点上并行执行计算,使大规模计算能够快速完成。
+* 支持**多种文件格式**,包括 GeoJSON、Shapefile、GeoParquet、STAC、JDBC、OSM PBF、CSV 和 PostGIS。
+* 提供多种**语言 API**,包括 SQL、Python、Java、Scala 和 R。
+* **可扩展**:可根据数据规模水平扩展到数十、数百乃至数千个节点,使用 SedonaSpark 处理海量空间数据集。
+* **可移植**:易于在自定义环境中运行,可在本地或云端(如 AWS EMR、Microsoft Fabric、Google DataProc)部署。
+* **可扩展定制**:可以使用自定义逻辑对 SedonaSpark 进行扩展,以满足特定的地理空间数据分析需求。
+* **开源**:Apache Sedona 是一个开源项目,遵循 Apache 软件基金会的相关准则进行管理。
+* 提供更多扩展能力,例如 [最近邻搜索](https://sedona.apache.org/latest/api/sql/NearestNeighbourSearching/) 以及诸如 [DBSCAN](https://sedona.apache.org/latest/tutorial/sql/#cluster-with-dbscan) 等空间统计算法。
+
+## 可移植性
+
+SedonaSpark 易于在本地、Docker 中或主流云平台上运行。
+
+SedonaSpark 设计为可在任何能运行 Spark 的环境中运行。许多云厂商都提供 Spark 运行时,Sedona 可以作为依赖库添加进去。
+
+在本地运行 Sedona 也很方便,可以在将代码部署到生产数据集之前快速迭代。
+
+## 使用 Spark 和 Sedona 处理矢量数据的示例
+
+下面看一下如何使用 Spark 和 Sedona 在矢量数据集上完成一次完整的工作流程。
+
+我们使用 Overture Maps Foundation 提供的基础水体数据,将纽约市地区的所有水体绘制到地图上。首先读取数据并创建视图:
+
+```
+base_water = sedona.table("open_data.overture_maps_foundation.base_water")
+base_water.createOrReplaceTempView("base_water_view")
+```
+
+然后过滤出纽约市地区范围内的水体:
+
+```python
+spot = "POLYGON ((-74.174194 40.509623, -73.635864 40.509623, -73.635864 40.93634, -74.174194 40.93634, -74.174194 40.509623))"
+query = f"""
+select id, geometry from base_water_view
+where ST_Contains(ST_GeomFromWKT('{spot}'), geometry)
+"""
+res = sedona.sql(query)
+```
+
+Sedona 与主流的可视化库无缝集成,可以轻松地从 Sedona DataFrame 创建地图。仅需两行代码即可生成一张地图:
+
+```python
+kepler_map = SedonaKepler.create_map()
+SedonaKepler.add_df(kepler_map, df=res, name="Tri-state water")
+```
+
+地图效果非常出色!
+
+![New York City water](image/nyc_base_water.png)
+
+通过这张地图,可以清晰地看到纽约市地区的所有河流、湖泊乃至游泳池。
+
+## 有疑问?
+
+欢迎在 GitHub Discussions 发起讨论,或者加入 Discord 社区向开发者提问。
+
+我们期待与您协作!