This is an automated email from the ASF dual-hosted git repository. jiayu pushed a commit to branch branch-1.8.1 in repository https://gitbox.apache.org/repos/asf/sedona.git
commit 77ec42229fc66af7fefd4e8c7c7433e863c57b24 Author: Jia Yu <[email protected]> AuthorDate: Sat Feb 7 15:15:45 2026 -0700 [GH-1612] Add TopologyException workaround note to ST_Intersection docs (#2623) --- docs/api/flink/Function.md | 9 +++++++++ docs/api/snowflake/vector-data/Function.md | 7 +++++++ docs/api/sql/Function.md | 10 ++++++++++ 3 files changed, 26 insertions(+) diff --git a/docs/api/flink/Function.md b/docs/api/flink/Function.md index d74552617f..019f91fed2 100644 --- a/docs/api/flink/Function.md +++ b/docs/api/flink/Function.md @@ -2136,6 +2136,15 @@ Format: `ST_Intersection (A: Geometry, B: Geometry)` Since: `v1.5.0` +!!!note + If you encounter a `TopologyException` with the message "found non-noded intersection", try enabling the OverlayNG algorithm by adding the following JVM flag: + + ``` + -Djts.overlay=ng + ``` + + The OverlayNG algorithm is more robust than the legacy overlay implementation in JTS and handles many edge cases that would otherwise cause errors. + Example: ```sql diff --git a/docs/api/snowflake/vector-data/Function.md b/docs/api/snowflake/vector-data/Function.md index 28eb433c3b..dd769d4dea 100644 --- a/docs/api/snowflake/vector-data/Function.md +++ b/docs/api/snowflake/vector-data/Function.md @@ -1535,6 +1535,13 @@ Introduction: Return the intersection geometry of A and B Format: `ST_Intersection (A:geometry, B:geometry)` +!!!note + If you encounter a `TopologyException` with the message "found non-noded intersection", this is a known issue with the legacy overlay implementation in JTS. The OverlayNG algorithm resolves this. To enable it, add the following JVM flag: + + ``` + -Djts.overlay=ng + ``` + SQL example: ```sql diff --git a/docs/api/sql/Function.md b/docs/api/sql/Function.md index 9c61520f6d..c6c5d7cb24 100644 --- a/docs/api/sql/Function.md +++ b/docs/api/sql/Function.md @@ -2266,6 +2266,16 @@ Format: `ST_Intersection (A: Geometry, B: Geometry)` Since: `v1.0.0` +!!!note + If you encounter a `TopologyException` with the message "found non-noded intersection", try enabling the OverlayNG algorithm by setting the following Spark configuration: + + ``` + spark.driver.extraJavaOptions=-Djts.overlay=ng + spark.executor.extraJavaOptions=-Djts.overlay=ng + ``` + + The OverlayNG algorithm is more robust than the legacy overlay implementation in JTS and handles many edge cases that would otherwise cause errors. + SQL Example ```sql
