jiayuasu commented on code in PR #1246: URL: https://github.com/apache/sedona/pull/1246#discussion_r1498198362
########## docs/api/flink/Function.md: ########## @@ -476,6 +476,34 @@ Output: 3.141592653589793 ``` +## ST_BestSRID + +Introduction: Returns the estimated most appropriate Spatial Reference Identifier (SRID) for a given geometry, based on its spatial extent and location. It evaluates the geometry's bounding envelope and selects an SRID that optimally represents the geometry on the Earth's surface. The function prioritizes Universal Transverse Mercator (UTM), Lambert Azimuthal Equal Area (LAEA), or falls back to the Mercator projection. + +- For geometries in the Arctic or Antarctic regions, the Lambert Azimuthal Equal Area projection is used. +- For geometries that fit within a single UTM zone and do not cross the International Date Line (IDL), a corresponding UTM SRID is chosen. +- In cases where none of the above conditions are met, the function defaults to the Mercator projection. +- For Geometries that cross the IDL, `ST_BestSRID` defaults the SRID to Mercator. Currently, `ST_BestSRID` does not handle geometries crossing the IDL. + +!!!Warning + `ST_BestSRID` is designed to estimate a suitable SRID from a set of approximately 125 EPSG codes and works best for geometries that fit within the UTM zones. It should not be solely relied upon to determine the most accurate SRID, especially for specialized or high-precision spatial requirements. + +Format: `ST_BestSRID(geom: Geometry)` + +Since: `v1.6.0` + +Spark SQL Example: Review Comment: 1. Please call it `SQL Example` in all flink, spark, snowflake docs. 2. Please say that this ST_BestSRID functions takes a WGS84 geometry as input and the geometry should follow lon/lat order. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@sedona.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
