This is an automated email from the ASF dual-hosted git repository. jiayu pushed a commit to branch docs/individual-function-pages in repository https://gitbox.apache.org/repos/asf/sedona.git
commit 5bd443544222dfc5686a0bd729a944fd1ecf21af Author: Jia Yu <[email protected]> AuthorDate: Wed Feb 25 15:49:28 2026 -0800 Add introductory paragraphs about Geometry and Geography types - Geometry Functions pages (Spark/Flink/Snowflake): describe planar 2D Euclidean model - Geography Functions page (Spark): describe spherical geodesic model - Cross-link between Geometry and Geography pages in Spark docs --- docs/api/flink/Geometry-Functions.md | 2 ++ docs/api/snowflake/vector-data/Geometry-Functions.md | 2 ++ docs/api/sql/Geometry-Functions.md | 2 ++ docs/api/sql/geography/Geography-Functions.md | 2 ++ 4 files changed, 8 insertions(+) diff --git a/docs/api/flink/Geometry-Functions.md b/docs/api/flink/Geometry-Functions.md index 5f2cec7b80..eb90546dc0 100644 --- a/docs/api/flink/Geometry-Functions.md +++ b/docs/api/flink/Geometry-Functions.md @@ -19,6 +19,8 @@ # Geometry Functions +The `Geometry` type in Sedona represents planar (2D Euclidean) spatial objects such as points, lines, and polygons. All coordinates are treated as Cartesian (x, y) values, and spatial operations — distance, area, intersection, etc. — use flat-plane math. + ## Geometry Constructors These functions create geometry objects from various textual or binary formats, or from coordinate values. diff --git a/docs/api/snowflake/vector-data/Geometry-Functions.md b/docs/api/snowflake/vector-data/Geometry-Functions.md index 973384e179..aef0d640af 100644 --- a/docs/api/snowflake/vector-data/Geometry-Functions.md +++ b/docs/api/snowflake/vector-data/Geometry-Functions.md @@ -19,6 +19,8 @@ # Geometry Functions +The `Geometry` type in Sedona represents planar (2D Euclidean) spatial objects such as points, lines, and polygons. All coordinates are treated as Cartesian (x, y) values, and spatial operations — distance, area, intersection, etc. — use flat-plane math. + ## Geometry Constructors These functions create geometry objects from various textual or binary formats, or from coordinate values. diff --git a/docs/api/sql/Geometry-Functions.md b/docs/api/sql/Geometry-Functions.md index abacfc8066..2f299f2dc3 100644 --- a/docs/api/sql/Geometry-Functions.md +++ b/docs/api/sql/Geometry-Functions.md @@ -19,6 +19,8 @@ # Geometry Functions +The `Geometry` type in Sedona represents planar (2D Euclidean) spatial objects such as points, lines, and polygons. All coordinates are treated as Cartesian (x, y) values, and spatial operations — distance, area, intersection, etc. — use flat-plane math. If your data uses a geographic coordinate reference system (longitude/latitude), see [Geography Functions](geography/Geography-Functions.md) for geodesic operations that account for the curvature of the Earth. + ## Geometry Constructors These functions create geometry objects from various textual or binary formats, or from coordinate values. diff --git a/docs/api/sql/geography/Geography-Functions.md b/docs/api/sql/geography/Geography-Functions.md index 5f55bc6e1f..3b4b81bf2d 100644 --- a/docs/api/sql/geography/Geography-Functions.md +++ b/docs/api/sql/geography/Geography-Functions.md @@ -19,6 +19,8 @@ # Geography Functions +The `Geography` type in Sedona represents spatial objects on a spherical (geodesic) model of the Earth. Unlike the planar [Geometry](../Geometry-Functions.md) type, distance, area, and other measurements performed on `Geography` objects account for the curvature of the Earth and return results in real-world units (e.g., meters). Use `Geography` when your data is in longitude/latitude coordinates and you need accurate geodesic calculations. + ## Geography Constructors These functions create geography objects from various formats.
