Data Lake Analytics的Geospatial分析函数

﹏ヽ暗。殇╰゛Y 2022-03-07 15:26 175阅读 0赞

1.  简介

为满足部分客户在云上做Geometry数据的分析需求，阿里云Data Lake Analytics（以下简称：DLA）支持多种格式的地理空间数据处理函数，符合Open Geospatial Consortium’s (OGC) OpenGIS规范，支持的常用数据格式包括：

WKT  
WKB  
GeoJson  
ESRI Geometry Object Json  
ESRI Shape  
DLA采用4326坐标系标准，EPSG 4326使用经纬度坐标，属于地理坐标系。GPS采用的就是这个坐标系。

1.  WKT数据

详细描述：  
[https://en.wikipedia.org/wiki...][https_en.wikipedia.org_wiki...]  
[http://www.opengeospatial.org...][http_www.opengeospatial.org...]

支持类似如下的WKT相关字符串。

POINT (0 0)  
LINESTRING (0 0, 1 1, 1 2)  
POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1))  
MULTIPOINT (0 0, 1 2)  
MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))  
MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))  
GEOMETRYCOLLECTION (POINT (2 3), LINESTRING (2 3, 3 4))

1.  WKB数据

详细描述：[https://en.wikipedia.org/wiki...][https_en.wikipedia.org_wiki... 1]

上述WKT数据和WKB的对应示例：

WKT WKB  
POINT (0 0) 010100000000000000000000000000000000000000  
LINESTRING (0 0, 1 1, 1 2) 01020000000300000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F0000000000000040  
POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)) 01030000000200000005000000000000000000000000000000000000000000000000001040000000000000000000000000000010400000000000001040000000000000000000000000000010400000000000000000000000000000000005000000000000000000F03F000000000000F03F000000000000F03F0000000000000040000000000000004000000000000000400000000000000040000000000000F03F000000000000F03F000000000000F03F  
MULTIPOINT (0 0, 1 2) 0104000000020000000101000000000000000000000000000000000000000101000000000000000000F03F0000000000000040  
MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4)) 01050000000200000001020000000300000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F0000000000000040010200000003000000000000000000004000000000000008400000000000000840000000000000004000000000000014400000000000001040  
MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1))) 01060000000200000001030000000200000005000000000000000000000000000000000000000000000000001040000000000000000000000000000010400000000000001040000000000000000000000000000010400000000000000000000000000000000005000000000000000000F03F000000000000F03F000000000000F03F0000000000000040000000000000004000000000000000400000000000000040000000000000F03F000000000000F03F000000000000F03F01030000000100000005000000000000000000F0BF000000000000F0BF00000000000000C0000000000000F0BF00000000000000C000000000000000C0000000000000F0BF00000000000000C0000000000000F0BF000000000000F0BF  
GEOMETRYCOLLECTION (POINT (2 3), LINESTRING (2 3, 3 4)) 0107000000020000000101000000000000000000004000000000000008400102000000020000000000000000000040000000000000084000000000000008400000000000001040

1.  GeoJson数据

GeoJson的详细描述：[http://geojson.org/][http_geojson.org]

1.  ESRI Geometry Object Json数据

规范说明：[http://resources.esri.com/hel...][http_resources.esri.com_hel...]

1.  ESRI Shape二进制数据

规范说明：[http://www.esri.com/LIBRARY/W...][http_www.esri.com_LIBRARY_W...]

1.  函数列表

Name Description  
ST\_asText 将Geometry数据转成WKT格式的字符串数据。  
ST\_LineFromText 输入WKT格式的Line字符串数据，生成Line的Geometry数据。  
ST\_Point 从坐标系的坐标值（X, Y），生成对应的Point的Geometry数据。  
ST\_Polygon 输入WKT格式的Polygon字符串数据，生成Polygon的Geometry数据。  
ST\_Area 返回面或多面的面积。对于点、线，返回0.0。对于GeometryCollection，返回所有单个面积的和。  
ST\_GeometryFromText 输入WKT格式的字符串数据，生成Geometry数据。  
ST\_Buffer 获取几何对象和距离，然后返回表示围绕源对象的缓冲区的几何对象。  
ST\_Centroid 获取几何对象的中心点。  
ST\_CoordDim 返回几何对象的坐标值维度。  
ST\_Dimension 用于返回几何对象的维度。在这种情况下，维度是指长度和宽度。例如，点既没有长度也没有宽度，所以其维度为 0；而线只有长度却没有宽度，因此其维度为 1。  
ST\_IsClosed 判断Line或者MultiLine是否闭合。  
ST\_IsEmpty 判断几何对象是否为空。  
ST\_Length 计算Line或者MultiLine的长度。  
ST\_XMax 返回几何对象在坐标系中的最大X坐标值。  
ST\_XMin 返回几何对象在坐标系中的最小X坐标值。  
ST\_YMax 返回几何对象在坐标系中的最大Y坐标值。  
ST\_YMin 返回几何对象在坐标系中的最小Y坐标值。  
ST\_NumInteriorRing 以Polygon作为输入参数，并返回其内部环数。  
ST\_NumPoints 用于返回几何对象中的点（折点）数。  
ST\_IsRing 以Line作为输入参数，判断是否是环（如Line是闭合的）。  
ST\_StartPoint 用于返回Line的第一个点。  
ST\_EndPoint 用于返回Line的最后一个点。  
ST\_X 返回Point的X坐标。  
ST\_Y 返回Point的Y坐标。  
ST\_Boundary 输入一个几何对象，然后以几何对象形式返回其组合边界。  
ST\_Envelope 以多边形的形式返回几何对象的最小边界框。  
ST\_Difference 输入两个几何对象，然后返回表示两个源对象之差的几何对象。  
ST\_Distance 用于返回两个几何对象之间的距离。这一距离是两个几何对象的最近折点之间的距离。  
ST\_ExteriorRing 以Line形式返回面的外部环。  
ST\_Intersection 以两个几何对象作为输入参数，然后以二维几何对象的形式返回交集。  
ST\_SymDifference 返回表示两个几何对象间的点集对称差异的几何值对象。  
ST\_Contains 输入两个几何对象，判断第一个对象是否完全包含第二个对象。  
ST\_Crosses 以两个几何对象作为输入，如果这两个对象的交集生成的几何对象的维度小于两个源对象中的最大维度，则返回 1。交集对象所包含的点必须在两个源几何的内部，并且不等于其中任何一个源对象。否则，返回 0。  
ST\_Disjoint 输入两个几何对象，判断两个几何对象的交集是否为空集。  
ST\_Equals 判断两个几何对象是否完全相同。  
ST\_Intersects 判断两个几何对象的交集是否不生成空集。  
ST\_Overlaps 判断两个几何对象的交集生成的几何对象是否维度相同但不等于任一源对象。  
ST\_Relate 比较两个几何对象，判断是否满足“DE-9IM”模式（[https://en.wikipedia.org/wiki...][https_en.wikipedia.org_wiki... 2]）矩阵字符串指定的条件。  
ST\_Touches 判断两个几何对象的公共点是否都不与两个几何对象的内部相交。  
ST\_Within 判断第一个几何对象是否完全位于第二个几何对象的范围内。  
ST\_asBinary 输入一个几何对象，然后返回其可识别的二进制WKB数据。  
ST\_GeometryFromWKBHexString 输入WKB的HEX字符串数据，返回对应的几何对象。  
ST\_pointFromWKBHexString 输入Point的WKB的HEX字符串数据，返回对应的Point几何对象。  
ST\_lineFromWKBHexString 输入Line的WKB的HEX字符串数据，返回对应的Line几何对象。  
ST\_polyFromWKBHexString 输入Polygon的WKB的HEX字符串数据，返回对应的Polygon几何对象。  
ST\_MPointFromWKBHexString 输入MultiPoint的WKB的HEX字符串数据，返回对应的MultiPoint几何对象。  
ST\_MLineFromWKBHexString 输入MultiLine的WKB的HEX字符串数据，返回对应的MultiLine几何对象。  
ST\_MPolyFromWKBHexString 输入MultiPolygon的WKB的HEX字符串数据，返回对应的MultiPolygon几何对象。  
ST\_GeometryFromWKB 输入WKB数据，返回对应的几何对象。  
ST\_pointFromWKB 输入Point的WKB数据，返回对应的Point几何对象。  
ST\_lineFromWKB 输入Line的WKB数据，返回对应的Line几何对象。  
ST\_polyFromWKB 输入Polygon的WKB数据，返回对应的Polygon几何对象。  
ST\_MPointFromWKB 输入MultiPoint的WKB数据，返回对应的MultiPoint几何对象。  
ST\_MLineFromWKB 输入MultiLine的WKB数据，返回对应的MultiLine几何对象。  
ST\_MPolyFromWKB 输入MultiPolygon的WKB数据，返回对应的MultiPolygon几何对象。  
ST\_GeometryFromGeoJson 输入GeoJson的字符串数据，返回对应的几何对象。  
ST\_GeometryFromJson 输入ESRI Geometry Object Json的字符串数据，返回对应的几何对象。  
ST\_asGeoJson 把几何对象转成GeoJson格式输出。  
ST\_asJson 把几何对象转成ESRI Geometry Object Json格式输出。  
ST\_GeometryFromEsriShape 输入ESRI Shape的二进制数据，返回对应的几何对象。  
UDF\_SYS\_GEO\_IN\_CYCLE 仅适用于北半球：做基于地理位置的经纬度画圈  
UDF\_SYS\_GEO\_IN\_RECTANGLE 仅适用于北半球：用于做基于地理位置的经纬度画矩形  
UDF\_SYS\_GEO\_DISTANCE 仅适用于北半球：用作一个经纬度列和一个固定的坐标点的距离计算

1.  函数定义与示例

ST\_asText  
ST\_asText(GEOMETRY) -> VARCHAR  
将Geometry数据转成WKT格式的字符串数据。

示例：

select ST\_asText(ST\_LineFromText('LINESTRING (0 0, 1 1, 1 2)'));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>LINESTRING (0 0, 1 1, 1 2)</td> 
  </tr> 
 </tbody> 
</table>

ST\_LineFromText  
ST\_LineFromText(VARCHAR) -> GEOMETRY  
输入WKT格式的Line字符串数据，生成Line的Geometry数据。

示例：

select ST\_asText(ST\_LineFromText('LINESTRING (0 0, 1 1, 1 2)'));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>LINESTRING (0 0, 1 1, 1 2)</td> 
  </tr> 
 </tbody> 
</table>

ST\_Point  
ST\_Point(DOUBLE, DOUBLE) -> GEOMETRY  
从坐标系的坐标值（X, Y），生成对应的Point的Geometry数据。

示例：

select ST\_asText(ST\_Point(30.2741500000,120.1551500000));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (30.27415 120.15515)</td> 
  </tr> 
 </tbody> 
</table>

ST\_Polygon  
ST\_Polygon(VARCHAR) -> GEOMETRY  
输入WKT格式的Polygon字符串数据，生成Polygon的Geometry数据。

示例：

select ST\_asText(ST\_Polygon('POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))'));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 1 2, 2 2, 2 1, 1 1))</td> 
  </tr> 
 </tbody> 
</table>

ST\_Area  
ST\_Area(Geometry) -> DOUBLE  
返回面或多面的面积。对于点、线，返回0.0。对于GeometryCollection，返回所有单个面积的和。

示例：

select ST\_Area(ST\_Polygon('POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))'));

select ST\_Area(ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

ST\_GeometryFromText  
ST\_GeometryFromText(VARCHAR) -> GEOMETRY  
输入WKT格式的字符串数据，生成Geometry数据。

ST\_Buffer  
ST\_Buffer(GEOMETRY, DOUBLE) -> GEOMETRY  
获取几何对象和距离，然后返回表示围绕源对象的缓冲区的几何对象。

ST\_Centroid  
ST\_Centroid(GEOMETRY) -> GEOMETRY  
获取几何对象的中心点。

示例：

select ST\_asText(ST\_Centroid(ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (1.8125 1.8125)</td> 
  </tr> 
 </tbody> 
</table>

select ST\_asText(ST\_Centroid(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2)')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (0.5 1)</td> 
  </tr> 
 </tbody> 
</table>

select ST\_asText(ST\_Centroid(ST\_GeometryFromText('POINT (0.5 1)')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (0.5 1)</td> 
  </tr> 
 </tbody> 
</table>

select ST\_asText(ST\_Centroid(ST\_GeometryFromText('POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (2.033333333333333 2.033333333333333)</td> 
  </tr> 
 </tbody> 
</table>

ST\_CoordDim  
ST\_CoordDim(GEOMETRY) -> BIGINT  
返回几何对象的坐标值维度。

示例：

select ST\_CoordDim(ST\_GeometryFromText('POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))'));

select ST\_CoordDim(ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select st\_coorddim(st\_geometryfromtext('point Z (60.567222 -140.404 5959)'));

select st\_coorddim(st\_geometryfromtext('point M (60.567222 -140.404 5250)'));

select st\_coorddim(st\_geometryfromtext('point ZM (60.567222 -140.404 5959 5250)'));

ST\_Dimension  
ST\_Dimension(GEOMETRY) -> BIGINT  
用于返回几何对象的维度。在这种情况下，维度是指长度和宽度。例如，点既没有长度也没有宽度，所以其维度为 0；而线只有长度却没有宽度，因此其维度为 1。

示例：

select ST\_Dimension(ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

ST\_IsClosed  
ST\_IsClosed(GEOMETRY) -> BOOLEAN  
判断Line或者MultiLine是否闭合。

示例：

select ST\_IsClosed(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2)'));

select ST\_IsClosed(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2, 0 0)'));

select ST\_IsClosed(ST\_GeometryFromText('MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))'));

ST\_IsEmpty  
ST\_IsEmpty(GEOMETRY) -> BOOLEAN  
判断几何对象是否为空。

示例：

select ST\_IsEmpty(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2, 0 0)'));

select ST\_IsEmpty(null);

SELECT ST\_IsEmpty(ST\_GeometryFromText('GEOMETRYCOLLECTION EMPTY'));

SELECT ST\_IsEmpty(ST\_GeometryFromText('POLYGON EMPTY'));

ST\_Length  
ST\_Length(GEOMETRY) -> DOUBLE  
计算Line或者MultiLine的长度。

示例：

SELECT ST\_Length(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2, 0 0)'));

SELECT ST\_Length(ST\_GeometryFromText('MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))'));

ST\_XMax  
ST\_XMax(GEOMETRY) -> DOUBLE  
返回几何对象在坐标系中的最大X坐标值。

示例：

SELECT ST\_XMax(ST\_GeometryFromText('MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))'));

SELECT ST\_XMax(ST\_GeometryFromText('POINT (0.5 1)'));

ST\_XMin  
ST\_XMin(GEOMETRY) -> DOUBLE  
返回几何对象在坐标系中的最小X坐标值。

示例：

SELECT ST\_XMin(ST\_GeometryFromText('MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))'));

SELECT ST\_XMin(ST\_GeometryFromText('POINT (0.5 1)'));

ST\_YMax  
ST\_YMax(GEOMETRY) -> DOUBLE  
返回几何对象在坐标系中的最大Y坐标值。

示例：

SELECT ST\_YMax(ST\_GeometryFromText('MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))'));

SELECT ST\_YMax(ST\_GeometryFromText('POINT (0.5 1)'));

ST\_YMin  
ST\_YMin(GEOMETRY) -> DOUBLE  
返回几何对象在坐标系中的最小Y坐标值。

示例：

SELECT ST\_YMin(ST\_GeometryFromText('MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))'));

SELECT ST\_YMin(ST\_GeometryFromText('POINT (0.5 1)'));

ST\_NumInteriorRing  
ST\_NumInteriorRing(GEOMETRY) -> BIGINT  
以Polygon作为输入参数，并返回其内部环数。

示例：

SELECT ST\_NumInteriorRing(ST\_GeometryFromText('POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))'));

ST\_NumPoints  
ST\_NumPoints(GEOMETRY) -> BIGINT  
用于返回几何对象中的点（折点）数。

示例：

SELECT ST\_NumPoints(ST\_GeometryFromText('POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))'));

SELECT ST\_NumPoints(ST\_GeometryFromText('POLYGON EMPTY'));

SELECT ST\_NumPoints(ST\_GeometryFromText('POINT (0.5 1)'));

ST\_IsRing  
ST\_IsRing(GEOMETRY) -> BOOLEAN  
以Line作为输入参数，判断是否是环（如Line是闭合的）。

示例：

select ST\_IsRing(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2)'));

select ST\_IsRing(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2, 0 0)'));

ST\_StartPoint  
ST\_StartPoint(GEOMETRY) -> GEOMETRY  
用于返回Line的第一个点。

示例：

select ST\_asText(ST\_StartPoint(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2, 0 0)')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (0 0)</td> 
  </tr> 
 </tbody> 
</table>

ST\_EndPoint  
ST\_EndPoint(GEOMETRY) -> GEOMETRY  
用于返回Line的最后一个点。

示例：

select ST\_asText(ST\_EndPoint(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2)')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (1 2)</td> 
  </tr> 
 </tbody> 
</table>

ST\_X  
ST\_X(GEOMETRY) -> DOUBLE  
返回Point的X坐标。

示例：

select ST\_X(ST\_GeometryFromText('POINT (0.5 1)'));

ST\_Y  
ST\_Y(GEOMETRY) -> DOUBLE  
返回Point的Y坐标。

示例：

select ST\_Y(ST\_GeometryFromText('POINT (0.5 1)'));

ST\_Boundary  
ST\_Boundary(GEOMETRY) -> GEOMETRY  
输入一个几何对象，然后以几何对象形式返回其组合边界。

示例：

select ST\_asText(ST\_Boundary(ST\_GeometryFromText('POINT (0.5 1)')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT EMPTY</td> 
  </tr> 
 </tbody> 
</table>

select ST\_asText(ST\_Boundary(ST\_GeometryFromText('LINESTRING (0 0, 1 1, 1 2)')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTIPOINT ((0 0), (1 2))</td> 
  </tr> 
 </tbody> 
</table>

select ST\_asText(ST\_Boundary(ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTILINESTRING ((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 1 2, 2 2, 2 1, 1 1), (-1 -1, -2 -1, -2 -2, -1 -2, -1 -1))</td> 
  </tr> 
 </tbody> 
</table>

ST\_Envelope  
ST\_Envelope(GEOMETRY) -> GEOMETRY  
以多边形的形式返回几何对象的最小边界框。

示例：

select ST\_asText(ST\_Envelope(ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POLYGON ((-2 -2, 4 -2, 4 4, -2 4, -2 -2))</td> 
  </tr> 
 </tbody> 
</table>

ST\_Difference  
ST\_Difference(GEOMETRY, GEOMETRY) -> GEOMETRY  
输入两个几何对象，然后返回表示两个源对象之差的几何对象。

示例：

select ST\_asText(ST\_Difference(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTILINESTRING ((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 1 2, 2 2, 2 1, 1 1), (-1 -1, -2 -1, -2 -2, -1 -2, -1 -1))')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 1 2, 2 2, 2 1, 1 1)), ((-1 -1, -2 -1, -2 -2, -1 -2, -1 -1)))</td> 
  </tr> 
 </tbody> 
</table>

select ST\_asText(ST\_Difference(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTIPOLYGON EMPTY</td> 
  </tr> 
 </tbody> 
</table>

ST\_Distance  
ST\_Distance(GEOMETRY, GEOMETRY) -> DOUBLE  
用于返回两个几何对象之间的距离。这一距离是两个几何对象的最近折点之间的距离。

示例：

select ST\_Distance(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Distance(  
ST\_GeometryFromText('POINT(0 0)'),  
ST\_GeometryFromText('POINT(1 1)'));

ST\_ExteriorRing  
ST\_ExteriorRing(GEOMETRY) -> GEOMETRY  
以Line形式返回面的外部环。

示例：

select ST\_asText(ST\_ExteriorRing(ST\_GeometryFromText('POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>LINESTRING (0 0, 4 0, 4 4, 0 4, 0 0)</td> 
  </tr> 
 </tbody> 
</table>

ST\_Intersection  
ST\_Intersection(GEOMETRY, GEOMETRY) -> GEOMETRY  
以两个几何对象作为输入参数，然后以二维几何对象的形式返回交集。

示例：

select ST\_asText(ST\_Intersection(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))')));

select ST\_asText(ST\_Intersection(  
ST\_GeometryFromText('POINT(0 0)'),  
ST\_GeometryFromText('POINT(1 1)')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTIPOLYGON EMPTY</td> 
  </tr> 
 </tbody> 
</table>

ST\_SymDifference  
ST\_SymDifference(GEOMETRY, GEOMETRY) -> GEOMETRY  
返回表示两个几何对象间的点集对称差异的几何值对象。

示例：

select ST\_asText(ST\_SymDifference(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTIPOLYGON EMPTY</td> 
  </tr> 
 </tbody> 
</table>

select ST\_asText(ST\_SymDifference(  
ST\_GeometryFromText('POINT(0 0)'),  
ST\_GeometryFromText('POINT(1 1)')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTIPOINT ((0 0), (1 1))</td> 
  </tr> 
 </tbody> 
</table>

下图的阴影部分显示了对称差异的结果。对称差异为包括两个表面的多表面图形：其中一个表面包含位于正方形之内、圆形之外的所有点，另外一个表面包含位于圆形之内、正方形之外的所有点。

image.png | left | 223x166

ST\_Contains  
ST\_Contains(GEOMETRY, GEOMETRY) -> BOOLEAN  
输入两个几何对象，判断第一个对象是否完全包含第二个对象。

示例：

select ST\_Contains(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Contains(  
ST\_GeometryFromText('POINT(0 0)'),  
ST\_GeometryFromText('POINT(1 1)'));

ST\_Crosses  
ST\_Crosses(GEOMETRY, GEOMETRY) -> BOOLEAN  
以两个几何对象作为输入，如果这两个对象的交集生成的几何对象的维度小于两个源对象中的最大维度，则返回 1。交集对象所包含的点必须在两个源几何的内部，并且不等于其中任何一个源对象。否则，返回 0。

示例：

select ST\_Crosses(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Crosses(  
ST\_GeometryFromText('LINESTRING(0 0, 2 2)'),  
ST\_GeometryFromText('LINESTRING(0 2, 2 0)'));

ST\_Disjoint  
ST\_Disjoint(GEOMETRY, GEOMETRY) -> BOOLEAN  
输入两个几何对象，判断两个几何对象的交集是否为空集。

示例：

select ST\_Disjoint(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Disjoint(  
ST\_GeometryFromText('LINESTRING(0 0, 2 2)'),  
ST\_GeometryFromText('LINESTRING(0 2, 2 4)'));

ST\_Equals  
ST\_Equals(GEOMETRY, GEOMETRY) -> BOOLEAN  
判断两个几何对象是否完全相同。

示例：

select ST\_Equals(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Equals(  
ST\_GeometryFromText('LINESTRING(0 0, 2 2)'),  
ST\_GeometryFromText('LINESTRING(0 2, 2 4)'));

ST\_Intersects  
ST\_Intersects(GEOMETRY, GEOMETRY) -> BOOLEAN  
判断两个几何对象的交集是否不生成空集。

示例：

select ST\_Intersects(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Intersects(  
ST\_GeometryFromText('LINESTRING(0 0, 2 2)'),  
ST\_GeometryFromText('LINESTRING(0 2, 2 4)'));

ST\_Overlaps  
ST\_Overlaps(GEOMETRY, GEOMETRY) -> BOOLEAN  
判断两个几何对象的交集生成的几何对象是否维度相同但不等于任一源对象。

示例：

select ST\_Overlaps(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Overlaps(  
ST\_GeometryFromText('LINESTRING(1 1, 2 2)'),  
ST\_GeometryFromText('LINESTRING(0 0, 1.5 1.5)'));

ST\_Relate  
ST\_Relate(GEOMETRY, GEOMETRY, VARCHAR) -> BOOLEAN  
比较两个几何对象，判断是否满足“DE-9IM”模式（[https://en.wikipedia.org/wiki...][https_en.wikipedia.org_wiki... 2]）矩阵字符串指定的条件。

示例：

select ST\_Relate(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
'102101FF2');

select ST\_Relate(  
ST\_GeometryFromText('LINESTRING(1 1, 2 2)'),  
ST\_GeometryFromText('LINESTRING(0 0, 1.5 1.5)'),  
'1*1*1');

ST\_Touches  
ST\_Touches(GEOMETRY, GEOMETRY) -> BOOLEAN  
判断两个几何对象的公共点是否都不与两个几何对象的内部相交。

示例：

select ST\_Touches(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Touches(  
ST\_GeometryFromText('LINESTRING(1 1, 2 2)'),  
ST\_GeometryFromText('LINESTRING(0 0, 1 1)'));

ST\_Within  
ST\_Within(GEOMETRY, GEOMETRY) -> BOOLEAN  
判断第一个几何对象是否完全位于第二个几何对象的范围内。

示例：

select ST\_Within(  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'),  
ST\_GeometryFromText('MULTIPOLYGON (((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1)), ((-1 -1, -1 -2, -2 -2, -2 -1, -1 -1)))'));

select ST\_Within(  
ST\_GeometryFromText('LINESTRING(1 1, 2 2)'),  
ST\_GeometryFromText('LINESTRING(0 0, 1 1)'));

ST\_asBinary  
ST\_asBinary(GEOMETRY) -> VARBINARY  
输入一个几何对象，然后返回其可识别的二进制WKB数据。

ST\_GeometryFromWKBHexString  
ST\_GeometryFromWKBHexString(VARCHAR) -> GEOMETRY  
输入WKB的HEX字符串数据，返回对应的几何对象。

示例：

select ST\_ASTEXT(ST\_GeometryFromWKBHexString('000000000140000000000000004010000000000000'));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (2 4)</td> 
  </tr> 
 </tbody> 
</table>

ST\_pointFromWKBHexString  
ST\_pointFromWKBHexString(VARCHAR) -> GEOMETRY  
输入Point的WKB的HEX字符串数据，返回对应的Point几何对象。

示例：

select ST\_ASTEXT(ST\_pointFromWKBHexString('000000000140000000000000004010000000000000'));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (2 4)</td> 
  </tr> 
 </tbody> 
</table>

ST\_lineFromWKBHexString  
ST\_lineFromWKBHexString(VARCHAR) -> GEOMETRY  
输入Line的WKB的HEX字符串数据，返回对应的Line几何对象。

ST\_polyFromWKBHexString  
ST\_polyFromWKBHexString(VARCHAR) -> GEOMETRY  
输入Polygon的WKB的HEX字符串数据，返回对应的Polygon几何对象。

ST\_MPointFromWKBHexString  
ST\_MPointFromWKBHexString(VARCHAR) -> GEOMETRY  
输入MultiPoint的WKB的HEX字符串数据，返回对应的MultiPoint几何对象。

示例：

SELECT ST\_asText(ST\_MPointFromWKBHexString('0104000000020000000101000000000000000000000000000000000000000101000000000000000000F03F0000000000000040'));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTIPOINT ((0 0), (1 2))</td> 
  </tr> 
 </tbody> 
</table>

ST\_MLineFromWKBHexString  
ST\_MLineFromWKBHexString(VARCHAR) -> GEOMETRY  
输入MultiLine的WKB的HEX字符串数据，返回对应的MultiLine几何对象。

ST\_MPolyFromWKBHexString  
ST\_MPolyFromWKBHexString(VARCHAR) -> GEOMETRY  
输入MultiPolygon的WKB的HEX字符串数据，返回对应的MultiPolygon几何对象。

ST\_GeometryFromWKB  
ST\_GeometryFromWKB(VARBINARY) -> GEOMETRY  
输入WKB数据，返回对应的几何对象。

示例：

select ST\_ASTEXT(ST\_GeometryFromWKB(from\_hex('000000000140000000000000004010000000000000')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (2 4)</td> 
  </tr> 
 </tbody> 
</table>

ST\_pointFromWKB  
ST\_pointFromWKB(VARBINARY) -> GEOMETRY  
输入Point的WKB数据，返回对应的Point几何对象。

示例：

select ST\_ASTEXT(ST\_pointFromWKB(from\_hex('000000000140000000000000004010000000000000')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>POINT (2 4)</td> 
  </tr> 
 </tbody> 
</table>

ST\_lineFromWKB  
ST\_lineFromWKB(VARBINARY) -> GEOMETRY  
输入Line的WKB数据，返回对应的Line几何对象。

ST\_polyFromWKB  
ST\_polyFromWKB(VARBINARY) -> GEOMETRY  
输入Polygon的WKB数据，返回对应的Polygon几何对象。

ST\_MPointFromWKB  
ST\_MPointFromWKB(VARBINARY) -> GEOMETRY  
输入MultiPoint的WKB数据，返回对应的MultiPoint几何对象。

示例：

SELECT ST\_asText(ST\_MPointFromWKB(from\_hex('0104000000020000000101000000000000000000000000000000000000000101000000000000000000F03F0000000000000040')));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>MULTIPOINT ((0 0), (1 2))</td> 
  </tr> 
 </tbody> 
</table>

ST\_MLineFromWKB  
ST\_MLineFromWKB(VARBINARY) -> GEOMETRY  
输入MultiLine的WKB数据，返回对应的MultiLine几何对象。

ST\_MPolyFromWKB  
ST\_MPolyFromWKB(VARBINARY) -> GEOMETRY  
输入MultiPolygon的WKB数据，返回对应的MultiPolygon几何对象。

ST\_GeometryFromGeoJson  
ST\_GeometryFromGeoJson(VARCHAR) -> GEOMETRY  
输入GeoJson的字符串数据，返回对应的几何对象。

ST\_GeometryFromJson  
ST\_GeometryFromJson(VARCHAR) -> GEOMETRY  
输入ESRI Geometry Object Json的字符串数据，返回对应的几何对象。

ST\_asGeoJson  
ST\_asGeoJson(GEOMETRY) -> VARCHAR  
把几何对象转成GeoJson格式输出。

示例：

SELECT ST\_asGeoJson(ST\_GeometryFromText('MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))'));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>{"type":"MultiLineString","coordinates":[[[0,0],[1,1],[1,2]],[[2,3],[3,2],[5,4]]],"crs":null}</td> 
  </tr> 
 </tbody> 
</table>

ST\_asJson  
ST\_asJson(GEOMETRY) -> VARCHAR  
把几何对象转成ESRI Geometry Object Json格式输出。

示例：

SELECT ST\_asJson(ST\_GeometryFromText('MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))'));

<table> 
 <thead> 
  <tr> 
   <th>_col0</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>{"paths":[[[0,0],[1,1],[1,2]],[[2,3],[3,2],[5,4]]]}</td> 
  </tr> 
 </tbody> 
</table>

ST\_GeometryFromEsriShape  
ST\_GeometryFromEsriShape(VARBINARY) -> GEOMETRY  
输入ESRI Shape的二进制数据，返回对应的几何对象。

示例：

SELECT california\_counties.name,

COUNT(*) cnt

FROM california\_counties  
CROSS JOIN earthquakes  
WHERE ST\_CONTAINS (ST\_GeometryFromesrishape(california\_counties.boundaryshape), ST\_POINT(earthquakes.longitude, earthquakes.latitude))  
GROUP BY california\_counties.name  
ORDER BY cnt DESC, california\_counties.name;

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>cnt</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>San Benito</td> 
   <td>8</td> 
  </tr> 
  <tr> 
   <td>San Bernardino</td> 
   <td>7</td> 
  </tr> 
  <tr> 
   <td>Riverside</td> 
   <td>6</td> 
  </tr> 
  <tr> 
   <td>Inyo</td> 
   <td>5</td> 
  </tr> 
  <tr> 
   <td>Imperial</td> 
   <td>3</td> 
  </tr> 
  <tr> 
   <td>San Diego</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>Kern</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>Kings</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>Monterey</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>San Luis Obispo</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>Santa Clara</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>Ventura</td> 
   <td>1</td> 
  </tr> 
 </tbody> 
</table>

UDF\_SYS\_GEO\_IN\_CYCLE  
UDF\_SYS\_GEO\_IN\_CYCLE(longitude, latitude, point, radius) -> BOOLEAN

第一个参数为经度列名称， 类型FLOAT/DOUBLE  
第二个参数为纬度列名称， 类型FLOAT/DOUBLE  
第三个参数为圆圈中心点的位置，格式=>'经度,维度', =>'120.85979,30.011984'  
第四个参数为圆圈的半径，单位米  
判断longitude、latitude的点是否在以中心点point为圆心，半径为radius的圆内。

示例：

SELECT count(\*) as cnt FROM earthquakes  
WHERE UDF\_SYS\_GEO\_IN\_CYCLE(longitude,latitude, '120.85979,30.011984', 5000000000000) = true;

UDF\_SYS\_GEO\_IN\_RECTANGLE  
UDF\_SYS\_GEO\_IN\_RECTANGLE(longitude, latitude, pointA, pointB) -> BOOLEAN

第一个参数为经度列名称， 类型FLOAT/DOUBLE  
第二个参数为纬度列名称， 类型FLOAT/DOUBLE  
第三个参数为矩形的左下角坐标，格式=>'经度,维度', =>'120.85979,30.011984'  
第四个参数为矩形的右上角坐标，格式=>'经度,维度', =>'120.88450,31.21011'  
判断longitude、latitude的点是否在以2个斜角点构成的矩形内。

示例：

SELECT count(\*) as cnt FROM earthquakes  
WHERE UDF\_SYS\_GEO\_IN\_RECTANGLE(longitude, latitude, '69.037,36.5759', '142.018,67.8713')=true;

UDF\_SYS\_GEO\_DISTANCE  
UDF\_SYS\_GEO\_DISTANCE(longitude, latitude, pointA) -> INTEGER

第一个参数为经度列名称， 类型FLOAT/DOUBLE  
第二个参数为纬度列名称， 类型FLOAT/DOUBLE  
第三个参数为固定坐标点的经纬度，格式=>'经度,维度', =>'120.85979,30.011984'  
求longitude、latitude的点和pointA点的距离，单位：米。

示例：

SELECT count(\*) as cnt FROM earthquakes  
WHERE UDF\_SYS\_GEO\_DISTANCE(longitude, latitude, '69.037,36.5759') > 10000;

1.  更多参考

教程：Data Lake Analytics + OSS数据文件格式处理大全: [https://yq.aliyun.com/article...][https_yq.aliyun.com_article...]  
使用Data Lake Analytics从OSS清洗数据到AnalyticDB：[https://yq.aliyun.com/article...][https_yq.aliyun.com_article... 1]  
Data Lake Analytics使用场景：[https://help.aliyun.com/docum...][https_help.aliyun.com_docum...]  
OLAP on TableStore——基于Data Lake Analytics的Serverless SQL大数据分析[https://yq.aliyun.com/article...][https_yq.aliyun.com_article... 2]  
使用Data Lake Analytics 分析OSS数据：[https://help.aliyun.com/docum...][https_help.aliyun.com_docum... 1]  
Data Lake Analytics数据库的连接方式：[https://help.aliyun.com/docum...][https_help.aliyun.com_docum... 2]  
Data Lake Analytics分析RDS数据：[https://yq.aliyun.com/article...][https_yq.aliyun.com_article... 3]  
下一代企业级云上数据分析服务：Data Lake Analytics：[https://yq.aliyun.com/article...][https_yq.aliyun.com_article... 4]  
DLA相关技术文档：[https://yq.aliyun.com/search?...][https_yq.aliyun.com_search_...]

[https_en.wikipedia.org_wiki...]: https://en.wikipedia.org/wiki/Well-known_text
[http_www.opengeospatial.org...]: http://www.opengeospatial.org/standards/wkt-crs
[https_en.wikipedia.org_wiki... 1]: https://en.wikipedia.org/wiki/Well-known_text#Well-known_binary
[http_geojson.org]: http://geojson.org/
[http_resources.esri.com_hel...]: http://resources.esri.com/help/9.3/arcgisserver/apis/REST/geometry.html
[http_www.esri.com_LIBRARY_W...]: http://www.esri.com/LIBRARY/WHITEPAPERS/PDFS/SHAPEFILE.PDF
[https_en.wikipedia.org_wiki... 2]: https://en.wikipedia.org/wiki/DE-9IM
[https_yq.aliyun.com_article...]: https://yq.aliyun.com/articles/623246
[https_yq.aliyun.com_article... 1]: https://yq.aliyun.com/articles/623401
[https_help.aliyun.com_docum...]: https://help.aliyun.com/document_detail/70380.html
[https_yq.aliyun.com_article... 2]: https://yq.aliyun.com/articles/618501
[https_help.aliyun.com_docum... 1]: https://help.aliyun.com/document_detail/70387.html
[https_help.aliyun.com_docum... 2]: https://help.aliyun.com/document_detail/71074.htm
[https_yq.aliyun.com_article... 3]: https://yq.aliyun.com/articles/629046
[https_yq.aliyun.com_article... 4]: https://yq.aliyun.com/articles/635516
[https_yq.aliyun.com_search_...]: https://yq.aliyun.com/search?q=DLA&type=ARTICLE