Data Lake Analytics的Geospatial分析函数

0. 简介

为满足部分客户在云上做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/Well-known_text
http://www.opengeospatial.org/standards/wkt-crs

支持类似如下的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))

2. WKB数据

详细描述：https://en.wikipedia.org/wiki/Well-known_text#Well-known_binary

上述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

3. GeoJson数据

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

4. ESRI Geometry Object Json数据

规范说明：http://resources.esri.com/help/9.3/arcgisserver/apis/REST/geometry.html

5. ESRI Shape二进制数据

规范说明：http://www.esri.com/LIBRARY/WHITEPAPERS/PDFS/SHAPEFILE.PDF

6. 函数列表

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/DE-9IM）矩阵字符串指定的条件。
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 仅适用于北半球：用作一个经纬度列和一个固定的坐标点的距离计算

7. 函数定义与示例

  • ST_asText
ST_asText(GEOMETRY) -> VARCHAR

将Geometry数据转成WKT格式的字符串数据。

示例：

select ST_asText(ST_LineFromText(‘LINESTRING (0 0, 1 1, 1 2)‘));

+----------------------------+
| _col0                      |
+----------------------------+
| LINESTRING (0 0, 1 1, 1 2) |
+----------------------------+
  • ST_LineFromText
ST_LineFromText(VARCHAR) -> GEOMETRY

输入WKT格式的Line字符串数据，生成Line的Geometry数据。

示例：

select ST_asText(ST_LineFromText(‘LINESTRING (0 0, 1 1, 1 2)‘));

+----------------------------+
| _col0                      |
+----------------------------+
| LINESTRING (0 0, 1 1, 1 2) |
+----------------------------+
  • ST_Point
ST_Point(DOUBLE, DOUBLE) -> GEOMETRY

从坐标系的坐标值（X, Y），生成对应的Point的Geometry数据。

示例：

select ST_asText(ST_Point(30.2741500000,120.1551500000));

+----------------------------+
| _col0                      |
+----------------------------+
| POINT (30.27415 120.15515) |
+----------------------------+
  • 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))‘));

+----------------------------------------------------------------+
| _col0                                                          |
+----------------------------------------------------------------+
| POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0), (1 1, 1 2, 2 2, 2 1, 1 1)) |
+----------------------------------------------------------------+
  • 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))‘));

+-------+
| _col0 |
+-------+
|  15.0 |
+-------+

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)))‘));

+-------+
| _col0 |
+-------+
|  16.0 |
+-------+
  • 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)))‘)));

+-----------------------+
| _col0                 |
+-----------------------+
| POINT (1.8125 1.8125) |
+-----------------------+

select ST_asText(ST_Centroid(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2)‘)));

+---------------+
| _col0         |
+---------------+
| POINT (0.5 1) |
+---------------+

select ST_asText(ST_Centroid(ST_GeometryFromText(‘POINT (0.5 1)‘)));

+---------------+
| _col0         |
+---------------+
| POINT (0.5 1) |
+---------------+

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))‘)));

+---------------------------------------------+
| _col0                                       |
+---------------------------------------------+
| POINT (2.033333333333333 2.033333333333333) |
+---------------------------------------------+
  • 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))‘));

+-------+
| _col0 |
+-------+
|     2 |
+-------+

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)))‘));

+-------+
| _col0 |
+-------+
|     2 |
+-------+

select st_coorddim(st_geometryfromtext(‘point Z (60.567222 -140.404 5959)‘));

+-------+
| _col0 |
+-------+
|     3 |
+-------+

select st_coorddim(st_geometryfromtext(‘point M (60.567222 -140.404 5250)‘));

+-------+
| _col0 |
+-------+
|     3 |
+-------+

select st_coorddim(st_geometryfromtext(‘point ZM (60.567222 -140.404 5959 5250)‘));

+-------+
| _col0 |
+-------+
|     4 |
+-------+
  • 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)))‘));

+-------+
| _col0 |
+-------+
|     2 |
+-------+
  • ST_IsClosed
ST_IsClosed(GEOMETRY) -> BOOLEAN

判断Line或者MultiLine是否闭合。

示例：

select ST_IsClosed(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2)‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+

select ST_IsClosed(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2, 0 0)‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+

select ST_IsClosed(ST_GeometryFromText(‘MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+
  • ST_IsEmpty
ST_IsEmpty(GEOMETRY) -> BOOLEAN

判断几何对象是否为空。

示例：

select ST_IsEmpty(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2, 0 0)‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+

select ST_IsEmpty(null);

+-------+
| _col0 |
+-------+
|  NULL |
+-------+

SELECT ST_IsEmpty(ST_GeometryFromText(‘GEOMETRYCOLLECTION EMPTY‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+

SELECT ST_IsEmpty(ST_GeometryFromText(‘POLYGON EMPTY‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+
  • ST_Length
ST_Length(GEOMETRY) -> DOUBLE

计算Line或者MultiLine的长度。

示例：

SELECT ST_Length(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2, 0 0)‘));

+-------------------+
| _col0             |
+-------------------+
| 4.650281539872885 |
+-------------------+

SELECT ST_Length(ST_GeometryFromText(‘MULTILINESTRING ((0 0, 1 1, 1 2), (2 3, 3 2, 5 4))‘));

+-------------------+
| _col0             |
+-------------------+
| 6.656854249492381 |
+-------------------+
  • 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))‘));

+-------+
| _col0 |
+-------+
|   5.0 |
+-------+

SELECT ST_XMax(ST_GeometryFromText(‘POINT (0.5 1)‘));

+-------+
| _col0 |
+-------+
|   0.5 |
+-------+
  • 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))‘));

+-------+
| _col0 |
+-------+
|   0.0 |
+-------+

SELECT ST_XMin(ST_GeometryFromText(‘POINT (0.5 1)‘));

+-------+
| _col0 |
+-------+
|   0.5 |
+-------+
  • 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))‘));

+-------+
| _col0 |
+-------+
|   4.0 |
+-------+

SELECT ST_YMax(ST_GeometryFromText(‘POINT (0.5 1)‘));

+-------+
| _col0 |
+-------+
|   1.0 |
+-------+
  • 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))‘));

+-------+
| _col0 |
+-------+
|   0.0 |
+-------+

SELECT ST_YMin(ST_GeometryFromText(‘POINT (0.5 1)‘));

+-------+
| _col0 |
+-------+
|   1.0 |
+-------+
  • 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))‘));

+-------+
| _col0 |
+-------+
|     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))‘));

+-------+
| _col0 |
+-------+
|     8 |
+-------+

SELECT ST_NumPoints(ST_GeometryFromText(‘POLYGON EMPTY‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+

SELECT ST_NumPoints(ST_GeometryFromText(‘POINT (0.5 1)‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+
  • ST_IsRing
ST_IsRing(GEOMETRY) -> BOOLEAN

以Line作为输入参数，判断是否是环（如Line是闭合的）。

示例：

select ST_IsRing(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2)‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+

select ST_IsRing(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2, 0 0)‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+
  • ST_StartPoint
ST_StartPoint(GEOMETRY) -> GEOMETRY

用于返回Line的第一个点。

示例：

select ST_asText(ST_StartPoint(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2, 0 0)‘)));

+-------------+
| _col0       |
+-------------+
| POINT (0 0) |
+-------------+
  • ST_EndPoint
ST_EndPoint(GEOMETRY) -> GEOMETRY

用于返回Line的最后一个点。

示例：

select ST_asText(ST_EndPoint(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2)‘)));

+-------------+
| _col0       |
+-------------+
| POINT (1 2) |
+-------------+
  • ST_X
ST_X(GEOMETRY) -> DOUBLE

返回Point的X坐标。

示例：

select ST_X(ST_GeometryFromText(‘POINT (0.5 1)‘));

+-------+
| _col0 |
+-------+
|   0.5 |
+-------+
  • ST_Y
ST_Y(GEOMETRY) -> DOUBLE

返回Point的Y坐标。

示例：

select ST_Y(ST_GeometryFromText(‘POINT (0.5 1)‘));

+-------+
| _col0 |
+-------+
|   1.0 |
+-------+
  • ST_Boundary
ST_Boundary(GEOMETRY) -> GEOMETRY

输入一个几何对象，然后以几何对象形式返回其组合边界。

示例：

select ST_asText(ST_Boundary(ST_GeometryFromText(‘POINT (0.5 1)‘)));

+-------------+
| _col0       |
+-------------+
| POINT EMPTY |
+-------------+

select ST_asText(ST_Boundary(ST_GeometryFromText(‘LINESTRING (0 0, 1 1, 1 2)‘)));

+---------------------------+
| _col0                     |
+---------------------------+
| MULTIPOINT ((0 0), (1 2)) |
+---------------------------+

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)))‘)));

+-------------------------------------------------------------------------------------------------------------+
| _col0                                                                                                       |
+-------------------------------------------------------------------------------------------------------------+
| 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)) |
+-------------------------------------------------------------------------------------------------------------+
  • 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)))‘)));

+-------------------------------------------+
| _col0                                     |
+-------------------------------------------+
| POLYGON ((-2 -2, 4 -2, 4 4, -2 4, -2 -2)) |
+-------------------------------------------+
  • 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))‘)));

+--------------------------------------------------------------------------------------------------------------+
| _col0                                                                                                        |
+--------------------------------------------------------------------------------------------------------------+
| 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))) |
+--------------------------------------------------------------------------------------------------------------+

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)))‘)));

+--------------------+
| _col0              |
+--------------------+
| MULTIPOLYGON EMPTY |
+--------------------+
  • 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)))‘));

+-------+
| _col0 |
+-------+
|   0.0 |
+-------+

select ST_Distance(
  ST_GeometryFromText(‘POINT(0 0)‘),
  ST_GeometryFromText(‘POINT(1 1)‘));

+--------------------+
| _col0              |
+--------------------+
| 1.4142135623730951 |
+--------------------+
  • 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))‘)));

+--------------------------------------+
| _col0                                |
+--------------------------------------+
| LINESTRING (0 0, 4 0, 4 4, 0 4, 0 0) |
+--------------------------------------+
  • 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)))‘)));

+--------------------------------------------------------------------------------------------------------------+
| _col0                                                                                                        |
+--------------------------------------------------------------------------------------------------------------+
| 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))) |
+--------------------------------------------------------------------------------------------------------------+

select ST_asText(ST_Intersection(
  ST_GeometryFromText(‘POINT(0 0)‘),
  ST_GeometryFromText(‘POINT(1 1)‘)));

+--------------------+
| _col0              |
+--------------------+
| MULTIPOLYGON EMPTY |
+--------------------+
  • 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)))‘)));

+--------------------+
| _col0              |
+--------------------+
| MULTIPOLYGON EMPTY |
+--------------------+

select ST_asText(ST_SymDifference(
  ST_GeometryFromText(‘POINT(0 0)‘),
  ST_GeometryFromText(‘POINT(1 1)‘)));

+---------------------------+
| _col0                     |
+---------------------------+
| MULTIPOINT ((0 0), (1 1)) |
+---------------------------+

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

  • 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)))‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+

select ST_Contains(
  ST_GeometryFromText(‘POINT(0 0)‘),
  ST_GeometryFromText(‘POINT(1 1)‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+
  • 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)))‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+

select ST_Crosses(
  ST_GeometryFromText(‘LINESTRING(0 0, 2 2)‘),
  ST_GeometryFromText(‘LINESTRING(0 2, 2 0)‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+
  • 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)))‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+

select ST_Disjoint(
  ST_GeometryFromText(‘LINESTRING(0 0, 2 2)‘),
  ST_GeometryFromText(‘LINESTRING(0 2, 2 4)‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+
  • 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)))‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+

select ST_Equals(
  ST_GeometryFromText(‘LINESTRING(0 0, 2 2)‘),
  ST_GeometryFromText(‘LINESTRING(0 2, 2 4)‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+
  • 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)))‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+

select ST_Intersects(
  ST_GeometryFromText(‘LINESTRING(0 0, 2 2)‘),
  ST_GeometryFromText(‘LINESTRING(0 2, 2 4)‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+
  • 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)))‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+

select ST_Overlaps(
  ST_GeometryFromText(‘LINESTRING(1 1, 2 2)‘),
  ST_GeometryFromText(‘LINESTRING(0 0, 1.5 1.5)‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+
  • ST_Relate
ST_Relate(GEOMETRY, GEOMETRY, VARCHAR) -> BOOLEAN

比较两个几何对象，判断是否满足“DE-9IM”模式（https://en.wikipedia.org/wiki/DE-9IM）矩阵字符串指定的条件。

示例：

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‘);

+-------+
| _col0 |
+-------+
|     0 |
+-------+

select ST_Relate(
  ST_GeometryFromText(‘LINESTRING(1 1, 2 2)‘),
  ST_GeometryFromText(‘LINESTRING(0 0, 1.5 1.5)‘),
  ‘1*1***1**‘);

+-------+
| _col0 |
+-------+
|     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)))‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+

select ST_Touches(
  ST_GeometryFromText(‘LINESTRING(1 1, 2 2)‘),
  ST_GeometryFromText(‘LINESTRING(0 0, 1 1)‘));

+-------+
| _col0 |
+-------+
|     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)))‘));

+-------+
| _col0 |
+-------+
|     1 |
+-------+

select ST_Within(
  ST_GeometryFromText(‘LINESTRING(1 1, 2 2)‘),
  ST_GeometryFromText(‘LINESTRING(0 0, 1 1)‘));

+-------+
| _col0 |
+-------+
|     0 |
+-------+
  • ST_asBinary
ST_asBinary(GEOMETRY) -> VARBINARY

输入一个几何对象，然后返回其可识别的二进制WKB数据。

  • ST_GeometryFromWKBHexString
ST_GeometryFromWKBHexString(VARCHAR) -> GEOMETRY

输入WKB的HEX字符串数据，返回对应的几何对象。

示例：

select ST_ASTEXT(ST_GeometryFromWKBHexString(‘000000000140000000000000004010000000000000‘));

+-------------+
| _col0       |
+-------------+
| POINT (2 4) |
+-------------+
  • ST_pointFromWKBHexString
ST_pointFromWKBHexString(VARCHAR) -> GEOMETRY

输入Point的WKB的HEX字符串数据，返回对应的Point几何对象。

示例：

select ST_ASTEXT(ST_pointFromWKBHexString(‘000000000140000000000000004010000000000000‘));

+-------------+
| _col0       |
+-------------+
| POINT (2 4) |
+-------------+
  • 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‘));

+---------------------------+
| _col0                     |
+---------------------------+
| MULTIPOINT ((0 0), (1 2)) |
+---------------------------+
  • 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‘)));

+-------------+
| _col0       |
+-------------+
| POINT (2 4) |
+-------------+
  • ST_pointFromWKB
ST_pointFromWKB(VARBINARY) -> GEOMETRY

输入Point的WKB数据，返回对应的Point几何对象。

示例：

select ST_ASTEXT(ST_pointFromWKB(from_hex(‘000000000140000000000000004010000000000000‘)));

+-------------+
| _col0       |
+-------------+
| POINT (2 4) |
+-------------+
  • 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‘)));

+---------------------------+
| _col0                     |
+---------------------------+
| MULTIPOINT ((0 0), (1 2)) |
+---------------------------+
  • 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))‘));

+-----------------------------------------------------------------------------------------------+
| _col0                                                                                         |
+-----------------------------------------------------------------------------------------------+
| {"type":"MultiLineString","coordinates":[[[0,0],[1,1],[1,2]],[[2,3],[3,2],[5,4]]],"crs":null} |
+-----------------------------------------------------------------------------------------------+
  • 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))‘));

+-----------------------------------------------------+
| _col0                                               |
+-----------------------------------------------------+
| {"paths":[[[0,0],[1,1],[1,2]],[[2,3],[3,2],[5,4]]]} |
+-----------------------------------------------------+
  • 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;

+-----------------+------+
| name            | cnt  |
+-----------------+------+
| San Benito      |    8 |
| San Bernardino  |    7 |
| Riverside       |    6 |
| Inyo            |    5 |
| Imperial        |    3 |
| San Diego       |    2 |
| Kern            |    1 |
| Kings           |    1 |
| Monterey        |    1 |
| San Luis Obispo |    1 |
| Santa Clara     |    1 |
| Ventura         |    1 |
+-----------------+------+
  • 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;

+------+
| cnt  |
+------+
| 2858 |
+------+
  • 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;

+------+
| cnt  |
+------+
|   55 |
+------+
  • 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;

+------+
| cnt  |
+------+
| 2857 |
+------+

8. 更多参考

原文链接
更多技术干货 请关注阿里云云栖社区微信号 ：yunqiinsight

原文地址：https://www.cnblogs.com/zhaowei121/p/10412788.html

时间： 2024-10-30 11:01:08

Data Lake Analytics的Geospatial分析函数的相关文章

基于Data Lake Analytics的Serverless SQL大数据分析

摘要: TableStore(简称OTS)是阿里云的一款分布式表格系统,为用户提供schema-free的分布式表格服务.随着越来越多用户对OLAP有强烈的需求,我们提供在表格存储上接入Data Lake Analytics(简称DLA)服务的方式,提供一种快速的OLAP解决方案. 背景介绍TableStore(简称OTS)是阿里云的一款分布式表格系统,为用户提供schema-free的分布式表格服务.随着越来越多用户对OLAP有强烈的需求,我们提供在表格存储上接入Data Lake Analy

Data Lake Analytics，大数据的ETL神器！

0. Data Lake Analytics(简称DLA)介绍 数据湖(Data Lake)是时下大数据行业热门的概念:https://en.wikipedia.org/wiki/Data_lake.基于数据湖做分析,可以不用做任何ETL.数据搬迁等前置过程,实现跨各种异构数据源进行大数据关联分析,从而极大的节省成本和提升用户体验.关于Data Lake的概念. 终于,阿里云现在也有了自己的数据湖分析产品:https://www.aliyun.com/product/datalakeanalyt

Data Lake Analytics账号和权限体系详细介绍

一.Data Lake Analytics介绍数据湖(Data Lake)是时下大数据行业热门的概念:https://en.wikipedia.org/wiki/Data_lake.基于数据湖做分析,可以不用做任何ETL.数据搬迁等前置过程,实现跨各种异构数据源进行大数据关联分析,从而极大的节省成本和提升用户体验. 阿里云数据湖分析产品Data Lake Analytics(简称DLA):https://www.aliyun.com/product/datalakeanalytics产品文档:h

【免费公测中】为数据赋予超能力，阿里云重磅推出Serverless数据分析引擎-Data Lake

摘要: 近日,阿里云重磅推出Serverless数据分析引擎-Data Lake Analytics,Data Lake Analytics,帮助更多不具备分析能力的存储服务,赋予其分析的能力. 近日,阿里云重磅推出Serverless数据分析引擎-Data Lake Analytics,Data Lake Analytics,帮助更多不具备分析能力的存储服务,赋予其分析的能力. 从生活中的购物交易,到工业上的生产制造,再到社交网络媒体信息.企业化管理决策等等,大数据成为当前经济社会最重要的前进

构建企业级数据湖？Azure Data Lake Storage Gen2不容错过（上）

背景 相较传统的重量级OLAP数据仓库,“数据湖”以其数据体量大.综合成本低.支持非结构化数据.查询灵活多变等特点,受到越来越多企业的青睐,逐渐成为了现代数据平台的核心和架构范式. 数据湖的核心功能,简单地可以分为数据存储与数据查询计算两个部分,在云端可以有多种的实现选择.在之前的文章中,我们曾介绍Azure上Azure Data Lake Storage (ADLS Gen1)和Azure Data Lake Analytics (ADLA)这一对可配合使用的服务.这对黄金搭档正是为数据湖而生

数据湖(Data Lake)前世今生解析(上)

EMC收购视频存储设备厂商Isilon Systems完善EMC在分布式Scale-Out架构NAS技术方面的不足,近几年isilon在媒资.大数据和HPC场景得到客户的一致认可,也在去年和另外一个产品线Povital Hadoop推出了数据湖解决方案,应对互联网浪潮下客户对半结构化和非结构化数据的处理.存储需求. 在讲数据湖之前,我们一起在回顾下数据库和数据仓库.数据库指在线交易数据系统.一般指OLTP事务处理,数据库中的数据也是进行了分类的:数据仓库一般指通过ETL工具抽取分类中的离线数据,

Commonly used terms in Data and Analytics

General terms Analytics as a Service (AaaS) The provision of analytics through Web-delivered technologies. These solutions offer businesses an alternative to developing internal hardware setups to perform business analytics. Artificial Intelligence (

DLA SQL分析函数：SQL语句审计与分析的利器

1. 简介 Data Lake Analytics(https://www.aliyun.com/product/datalakeanalytics)最新release一组SQL内置函数,用来进行SQL语句的分析.信息提取,方便用户对SQL语句进行语法层面的审计.分析,可以应用于很多安全.数据库日志分析等场景.参考DLA(Data Lake Analytics)之前的文档,只要您的SQL语句文本保存在DLA支持的数据源系统中,就能使用DLA的SQL分析函数,方便.快捷的进行SQL语句的审计和分析

Azure Resource Manager 简介

Azure Resource Manager 简介? 注意 您当前查看的页面是未经授权的转载!查看最新版本请前往:http://www.cnblogs.com/qin-nz/p/azrue-resource-manager-introduction.html. 提示 本文更新时间:2016年01月01日. Azure 资源管理器 ( Azure Resource Manager ) 是微软新提供的一种管理Azure资源的一种模式. 这种管理的思想不仅出现在命令行和PowerShell中,也出现在