[GH-2830] Adds Geography dual-dispatch to ST_NumGeometries

[zhangfengcdt]

Did you read the Contributor Guide?

• Yes, I have read the Contributor Rules and Contributor Development Guide

Is this PR related to a ticket?

• Yes, and the PR name follows the format [GH-XXX] my subject. Closes #<issue_number>

What changes were proposed in this PR?

• Adds Geography dual-dispatch to ST_NumGeometries — returns the count of sub-geometries for both Geometry and Geography inputs.
• Follow-up to [GH-2830] Improve Geography query support - core #2831; L1 tier (Geography path delegates to JTS via getJTSGeometry().getNumGeometries()).

How was this patch tested?

• mvn -pl common -am test -Dtest=FunctionTest
• New Spark SQL cases in GeographyFunctionTest

Did this PR include necessary documentation updates?

• Yes, I have updated the documentation.

[Copilot]

Pull request overview

Adds Geography support for ST_NumGeometries by dual-dispatching the Spark SQL expression to the Geography implementation in common, with accompanying unit/integration tests and Geography SQL docs.

Changes:

• Implement Geography numGeometries in common and add Java unit tests.
• Update Spark SQL ST_NumGeometries expression to resolve between Geometry vs Geography implementations.
• Add Spark SQL Geography integration tests and new Geography API docs page + index entry.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
spark/common/src/test/scala/org/apache/sedona/sql/geography/GeographyFunctionTest.scala	Adds Spark SQL test cases validating ST_NumGeometries on Geography inputs.
spark/common/src/main/scala/org/apache/spark/sql/sedona_sql/expressions/Functions.scala	Switches ST_NumGeometries to dual-dispatch (Geometry + Geography) using inferrableFunction1.
docs/api/sql/geography/Geography-Functions/ST_NumGeometries.md	Adds Geography-specific SQL documentation for ST_NumGeometries.
docs/api/sql/geography/Geography-Functions.md	Adds ST_NumGeometries to the Geography functions index table.
common/src/test/java/org/apache/sedona/common/Geography/FunctionTest.java	Adds Java unit tests for Geography numGeometries.
common/src/main/java/org/apache/sedona/common/geography/Functions.java	Introduces Geography numGeometries delegating to JTS.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[jiayuasu]

please resolve conflicts

[jiayuasu]

Conflict again