This is an automated email from the ASF dual-hosted git repository. jiayu pushed a commit to branch fix/1612-intersection-docs in repository https://gitbox.apache.org/repos/asf/sedona.git
commit 20139c0b039e45bd862e2312a68056a5b1f2cb20 Author: Jia Yu <[email protected]> AuthorDate: Sat Feb 7 13:36:54 2026 -0800 [GH-1612] Add TopologyException workaround note to ST_Intersection docs --- 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
