This is an automated email from the ASF dual-hosted git repository.
jiayu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/sedona.git
The following commit(s) were added to refs/heads/master by this push:
new 7630403e66 [GH-1612] Add TopologyException workaround note to
ST_Intersection docs (#2623)
7630403e66 is described below
commit 7630403e66f7b96a6c08424e704a9b3953242537
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 7701a6d93b..2ea139bc9e 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 1e0a6ce7d8..dbd53e2980 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 3972ea3ffc..d769d1b851 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
