diff --git a/docs/api/flink/Function.md b/docs/api/flink/Function.md index 36def857e0..49d33c59ae 100644 --- a/docs/api/flink/Function.md +++ b/docs/api/flink/Function.md @@ -1459,8 +1459,13 @@ Since: `v1.5.0` Example: ```sql -SELECT ST_LineMerge(geometry) -FROM df +SELECT ST_LineMerge(ST_GeomFromWKT('MULTILINESTRING ((-29 -27, -30 -29.7, -45 -33), (-45 -33, -46 -32))')) +``` + +Output: + +``` +LINESTRING (-29 -27, -30 -29.7, -45 -33, -46 -32) ``` ## ST_LineSubstring @@ -1472,17 +1477,15 @@ Format: `ST_LineSubstring (geom: geometry, startfraction: Double, endfraction: D Since: `v1.5.0` Example: + ```sql -SELECT ST_LineSubstring(ST_GeomFromWKT('LINESTRING(25 50, 100 125, 150 190)'), 0.333, 0.666) as Substring +SELECT ST_LineSubstring(ST_GeomFromWKT('LINESTRING(25 50, 100 125, 150 190)'), 0.333, 0.666) ``` Output: + ``` -+------------------------------------------------------------------------------------------------+ -|Substring | -+------------------------------------------------------------------------------------------------+ -|LINESTRING (69.28469348539744 94.28469348539744, 100 125, 111.70035626068274 140.21046313888758)| -+------------------------------------------------------------------------------------------------+ +LINESTRING (69.28469348539744 94.28469348539744, 100 125, 111.70035626068274 140.21046313888758) ``` ## ST_MakePolygon @@ -1495,24 +1498,17 @@ Since: `v1.5.0` Example: -Query: ```sql -SELECT - ST_MakePolygon( +SELECT ST_MakePolygon( ST_GeomFromText('LINESTRING(7 -1, 7 6, 9 6, 9 1, 7 -1)'), ARRAY(ST_GeomFromText('LINESTRING(6 2, 8 2, 8 1, 6 1, 6 2)')) - ) AS polygon + ) ``` -Result: +Output: ``` -+----------------------------------------------------------------+ -|polygon | -+----------------------------------------------------------------+ -|POLYGON ((7 -1, 7 6, 9 6, 9 1, 7 -1), (6 2, 8 2, 8 1, 6 1, 6 2))| -+----------------------------------------------------------------+ - +POLYGON ((7 -1, 7 6, 9 6, 9 1, 7 -1), (6 2, 8 2, 8 1, 6 1, 6 2)) ``` ## ST_MakeValid @@ -1554,8 +1550,16 @@ Format: `ST_MinimumBoundingCircle(geom: geometry, [Optional] quadrantSegments:in Since: `v1.5.0` Example: + ```sql -SELECT ST_MinimumBoundingCircle(ST_GeomFromText('POLYGON((1 1,0 0, -1 1, 1 1))')) +SELECT ST_MinimumBoundingCircle(ST_GeomFromWKT('LINESTRING(0 0, 0 1)')) +``` + +Output: + +``` +POLYGON ((0.5 0.5, 0.4997322937381828 0.4836404585891119, 0.4989294616193017 0.4672984353849285, 0.4975923633360985 0.4509914298352197, 0.4957224306869052 0.4347369038899742, 0.4933216660424395 0.4185522633027057, 0.4903926402016152 0.4024548389919359, 0.4869384896386668 0.3864618684828134, 0.4829629131445342 0.3705904774487396, 0.4784701678661044 0.3548576613727689, 0.4734650647475528 0.3392802673484192, 0.4679529633786629 0.3238749760393833, 0.4619397662556434 0.3086582838174551, 0.4554319124605879 0.2936464850978027, 0.4484363707663442 0.2788556548904993, 0.4409606321741775 0.2643016315870012, 0.4330127018922194 0.25, 0.4246010907632894 0.2359660746748161, 0.4157348061512726 0.2222148834901989, 0.4064233422958076 0.2087611515660989, 0.3966766701456176 0.1956192854956397, 0.3865052266813685 0.1828033579181773, 0.3759199037394887 0.1703270924499656, 0.3649320363489179 0.1582038489885644, 0.3535533905932738 0.1464466094067263, 0.3417961510114357 0.1350679636510822, 0.3296729075500345 0.1240800962605114, 0.3171966420818228 0.1134947733186316, 0.3043807145043603 0.1033233298543824, 0.2912388484339011 0.0935766577041924, 0.2777851165098012 0.0842651938487274, 0.264033925325184 0.0753989092367106, 0.2500000000000001 0.0669872981077807, 0.2356983684129989 0.0590393678258225, 0.2211443451095007 0.0515636292336559, 0.2063535149021975 0.0445680875394122, 0.1913417161825449 0.0380602337443566, 0.1761250239606168 0.0320470366213372, 0.1607197326515808 0.0265349352524472, 0.1451423386272312 0.0215298321338956, 0.1294095225512605 0.0170370868554659, 0.1135381315171867 0.0130615103613332, 0.0975451610080642 0.0096073597983848, 0.0814477366972944 0.0066783339575605, 0.0652630961100259 0.0042775693130948, 0.0490085701647804 0.0024076366639016, 0.0327015646150716 0.0010705383806983, 0.0163595414108882 0.0002677062618172, 0 0, -0.016359541410888 0.0002677062618172, -0.0327015646150715 0.0010705383806983, -0.0490085701647802 0.0024076366639015, -0.0652630961100257 0.0042775693130948, -0.0814477366972942 0.0066783339575605, -0.097545161008064 0.0096073597983847, -0.1135381315171866 0.0130615103613332, -0.1294095225512603 0.0170370868554658, -0.1451423386272311 0.0215298321338955, -0.1607197326515807 0.0265349352524472, -0.1761250239606166 0.0320470366213371, -0.1913417161825448 0.0380602337443566, -0.2063535149021973 0.044568087539412, -0.2211443451095006 0.0515636292336558, -0.2356983684129987 0.0590393678258224, -0.2499999999999999 0.0669872981077806, -0.264033925325184 0.0753989092367106, -0.277785116509801 0.0842651938487273, -0.291238848433901 0.0935766577041924, -0.3043807145043602 0.1033233298543823, -0.3171966420818227 0.1134947733186314, -0.3296729075500343 0.1240800962605111, -0.3417961510114356 0.1350679636510821, -0.3535533905932737 0.1464466094067262, -0.3649320363489177 0.1582038489885642, -0.3759199037394886 0.1703270924499655, -0.3865052266813683 0.1828033579181771, -0.3966766701456175 0.1956192854956396, -0.4064233422958076 0.2087611515660989, -0.4157348061512725 0.2222148834901987, -0.4246010907632894 0.235966074674816, -0.4330127018922192 0.2499999999999998, -0.4409606321741775 0.264301631587001, -0.4484363707663441 0.2788556548904991, -0.4554319124605878 0.2936464850978025, -0.4619397662556434 0.3086582838174551, -0.4679529633786628 0.3238749760393831, -0.4734650647475528 0.3392802673484191, -0.4784701678661044 0.3548576613727686, -0.4829629131445341 0.3705904774487395, -0.4869384896386668 0.3864618684828132, -0.4903926402016152 0.4024548389919357, -0.4933216660424395 0.4185522633027056, -0.4957224306869052 0.434736903889974, -0.4975923633360984 0.4509914298352196, -0.4989294616193017 0.4672984353849282, -0.4997322937381828 0.4836404585891118, -0.5 0.4999999999999999, -0.4997322937381828 0.5163595414108879, -0.4989294616193017 0.5327015646150715, -0.4975923633360985 0.5490085701647801, -0.4957224306869052 0.5652630961100257, -0.4933216660424395 0.5814477366972941, -0.4903926402016153 0.597545161008064, -0.4869384896386668 0.6135381315171865, -0.4829629131445342 0.6294095225512601, -0.4784701678661045 0.645142338627231, -0.4734650647475529 0.6607197326515806, -0.4679529633786629 0.6761250239606166, -0.4619397662556435 0.6913417161825446, -0.455431912460588 0.7063535149021972, -0.4484363707663442 0.7211443451095005, -0.4409606321741776 0.7356983684129986, -0.4330127018922194 0.7499999999999999, -0.4246010907632896 0.7640339253251838, -0.4157348061512727 0.777785116509801, -0.4064233422958078 0.7912388484339008, -0.3966766701456177 0.8043807145043602, -0.3865052266813686 0.8171966420818226, -0.3759199037394889 0.8296729075500342, -0.3649320363489179 0.8417961510114356, -0.353553390593274 0.8535533905932735, -0.3417961510114358 0.8649320363489177, -0.3296729075500345 0.8759199037394887, -0.317196642081823 0.8865052266813683, -0.3043807145043604 0.8966766701456175, -0.2912388484339011 0.9064233422958076, -0.2777851165098015 0.9157348061512725, -0.2640339253251843 0.9246010907632893, -0.2500000000000002 0.9330127018922192, -0.235698368412999 0.9409606321741775, -0.2211443451095007 0.9484363707663441, -0.2063535149021977 0.9554319124605877, -0.1913417161825452 0.9619397662556433, -0.176125023960617 0.9679529633786628, -0.1607197326515809 0.9734650647475528, -0.1451423386272312 0.9784701678661044, -0.1294095225512608 0.9829629131445341, -0.1135381315171869 0.9869384896386668, -0.0975451610080643 0.9903926402016152, -0.0814477366972945 0.9933216660424395, -0.0652630961100262 0.9957224306869051, -0.0490085701647807 0.9975923633360984, -0.0327015646150718 0.9989294616193017, -0.0163595414108883 0.9997322937381828, -0.0000000000000001 1, 0.0163595414108876 0.9997322937381828, 0.0327015646150712 0.9989294616193019, 0.04900857016478 0.9975923633360985, 0.0652630961100256 0.9957224306869052, 0.0814477366972943 0.9933216660424395, 0.0975451610080637 0.9903926402016153, 0.1135381315171863 0.9869384896386669, 0.1294095225512601 0.9829629131445342, 0.145142338627231 0.9784701678661045, 0.1607197326515807 0.9734650647475529, 0.1761250239606164 0.967952963378663, 0.1913417161825446 0.9619397662556435, 0.2063535149021972 0.955431912460588, 0.2211443451095005 0.9484363707663442, 0.2356983684129984 0.9409606321741777, 0.2499999999999997 0.9330127018922195, 0.2640339253251837 0.9246010907632896, 0.2777851165098009 0.9157348061512727, 0.291238848433901 0.9064233422958077, 0.3043807145043599 0.8966766701456179, 0.3171966420818225 0.8865052266813687, 0.3296729075500342 0.8759199037394889, 0.3417961510114355 0.8649320363489179, 0.3535533905932737 0.8535533905932738, 0.3649320363489175 0.841796151011436, 0.3759199037394885 0.8296729075500346, 0.3865052266813683 0.817196642081823, 0.3966766701456175 0.8043807145043604, 0.4064233422958076 0.7912388484339011, 0.4157348061512723 0.7777851165098015, 0.4246010907632893 0.7640339253251842, 0.4330127018922192 0.7500000000000002, 0.4409606321741774 0.735698368412999, 0.4484363707663439 0.7211443451095011, 0.4554319124605877 0.7063535149021978, 0.4619397662556433 0.6913417161825453, 0.4679529633786628 0.676125023960617, 0.4734650647475528 0.6607197326515809, 0.4784701678661043 0.6451423386272317, 0.482962913144534 0.6294095225512608, 0.4869384896386668 0.613538131517187, 0.4903926402016152 0.5975451610080643, 0.4933216660424395 0.5814477366972945, 0.4957224306869051 0.5652630961100262, 0.4975923633360984 0.5490085701647807, 0.4989294616193017 0.5327015646150718, 0.4997322937381828 0.5163595414108882, 0.5 0.5)) +``` ## ST_MinimumBoundingRadius @@ -1566,10 +1570,17 @@ Format: `ST_MinimumBoundingRadius(geom: geometry)` Since: `v1.5.0` Example: + ```sql SELECT ST_MinimumBoundingRadius(ST_GeomFromText('POLYGON((1 1,0 0, -1 1, 1 1))')) ``` +Output: + +``` +{POINT (0 1), 1.0} +``` + ## ST_Multi Introduction: Returns a MultiGeometry object based on the geometry input. @@ -1584,19 +1595,13 @@ Since: `v1.5.0` Example: ```sql -SELECT ST_Multi( - ST_GeomFromText('POINT(1 1)') -) AS geom +SELECT ST_Multi(ST_GeomFromText('POINT(1 1)')) ``` -Result: +Output: ``` -+---------------------------------------------------------------+ -|geom | -+---------------------------------------------------------------+ -|MULTIPOINT (1 1) | -+---------------------------------------------------------------+ +MULTIPOINT (1 1) ``` @@ -1613,31 +1618,33 @@ Since: `v1.3.0` Example: ```sql -SELECT ST_AsEWKT(ST_Normalize(ST_GeomFromWKT('POLYGON((0 1, 1 1, 1 0, 0 0, 0 1))'))) AS geom +SELECT ST_AsEWKT(ST_Normalize(ST_GeomFromWKT('POLYGON((0 1, 1 1, 1 0, 0 0, 0 1))'))) ``` Result: ``` -+-----------------------------------+ -|geom | -+-----------------------------------+ -|POLYGON ((0 0, 0 1, 1 1, 1 0, 0 0))| -+-----------------------------------+ +POLYGON ((0 0, 0 1, 1 1, 1 0, 0 0)) ``` ## ST_NPoints Introduction: Returns the number of points of the geometry -Since: `v1.3.0` - Format: `ST_NPoints (A:geometry)` +Since: `v1.3.0` + Example: + ```sql -SELECT ST_NPoints(polygondf.countyshape) -FROM polygondf +SELECT ST_NPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)')) +``` + +Output: + +``` +4 ``` ## ST_NDims @@ -1648,13 +1655,17 @@ Format: `ST_NDims(geom: geometry)` Since: `v1.3.1` -Spark SQL example with z co-rodinate: +Example with z coordinate: ```sql SELECT ST_NDims(ST_GeomFromEWKT('POINT(1 1 2)')) ``` -Output: `3` +Output: + +``` +3 +``` Example with x,y coordinate: @@ -1662,7 +1673,11 @@ Example with x,y coordinate: SELECT ST_NDims(ST_GeomFromText('POINT(1 1)')) ``` -Output: `2` +Output: + +``` +2 +``` ## ST_NRings @@ -1705,10 +1720,16 @@ Format: `ST_NumGeometries (A:geometry)` Since: `v1.3.0` -Example: +Example + ```sql -SELECT ST_NumGeometries(df.geometry) -FROM df +SELECT ST_NumGeometries(ST_GeomFromWKT('LINESTRING (-29 -27, -30 -29.7, -45 -33)')) +``` + +Output: + +``` +1 ``` ## ST_NumInteriorRings @@ -1720,11 +1741,16 @@ Format: `ST_NumInteriorRings(geom: geometry)` Since: `v1.3.0` Example: + ```sql SELECT ST_NumInteriorRings(ST_GeomFromText('POLYGON ((0 0, 0 5, 5 5, 5 0, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1))')) ``` -Output: `1` +Output: + +``` +1 +``` ## ST_NumPoints @@ -1742,11 +1768,16 @@ Format: `ST_NumPoints(geom: geometry)` Since: `v1.4.1` Example: + ```sql SELECT ST_NumPoints(ST_GeomFromText('LINESTRING(1 2, 1 3)')) ``` -Output: `2` +Output: + +``` +2 +``` ## ST_PointN diff --git a/docs/api/sql/Function.md b/docs/api/sql/Function.md index f24cd8c32d..9a91f0188b 100644 --- a/docs/api/sql/Function.md +++ b/docs/api/sql/Function.md @@ -1462,9 +1462,16 @@ Format: `ST_LineMerge (A:geometry)` Since: `v1.0.0` +Spark SQL example: + ```sql -SELECT ST_LineMerge(geometry) -FROM df +SELECT ST_LineMerge(ST_GeomFromWKT('MULTILINESTRING ((-29 -27, -30 -29.7, -45 -33), (-45 -33, -46 -32))')) +``` + +Output: + +``` +LINESTRING (-29 -27, -30 -29.7, -45 -33, -46 -32) ``` ## ST_LineSubstring @@ -1476,17 +1483,15 @@ Format: `ST_LineSubstring (geom: geometry, startfraction: Double, endfraction: D Since: `v1.0.1` Spark SQL example: + ```sql -SELECT ST_LineSubstring(ST_GeomFromWKT('LINESTRING(25 50, 100 125, 150 190)'), 0.333, 0.666) as Substring +SELECT ST_LineSubstring(ST_GeomFromWKT('LINESTRING(25 50, 100 125, 150 190)'), 0.333, 0.666) ``` Output: + ``` -+------------------------------------------------------------------------------------------------+ -|Substring | -+------------------------------------------------------------------------------------------------+ -|LINESTRING (69.28469348539744 94.28469348539744, 100 125, 111.70035626068274 140.21046313888758)| -+------------------------------------------------------------------------------------------------+ +LINESTRING (69.28469348539744 94.28469348539744, 100 125, 111.70035626068274 140.21046313888758) ``` ## ST_MakePolygon @@ -1499,24 +1504,17 @@ Since: `v1.1.0` Example: -Query: ```sql -SELECT - ST_MakePolygon( +SELECT ST_MakePolygon( ST_GeomFromText('LINESTRING(7 -1, 7 6, 9 6, 9 1, 7 -1)'), ARRAY(ST_GeomFromText('LINESTRING(6 2, 8 2, 8 1, 6 1, 6 2)')) - ) AS polygon + ) ``` -Result: +Output: ``` -+----------------------------------------------------------------+ -|polygon | -+----------------------------------------------------------------+ -|POLYGON ((7 -1, 7 6, 9 6, 9 1, 7 -1), (6 2, 8 2, 8 1, 6 1, 6 2))| -+----------------------------------------------------------------+ - +POLYGON ((7 -1, 7 6, 9 6, 9 1, 7 -1), (6 2, 8 2, 8 1, 6 1, 6 2)) ``` ## ST_MakeValid @@ -1563,8 +1561,15 @@ Format: `ST_MinimumBoundingCircle(geom: geometry, [Optional] quadrantSegments:in Since: `v1.0.1` Spark SQL example: + ```sql -SELECT ST_MinimumBoundingCircle(ST_GeomFromText('POLYGON((1 1,0 0, -1 1, 1 1))')) +SELECT ST_MinimumBoundingCircle(ST_GeomFromWKT('LINESTRING(0 0, 0 1)')) +``` + +Output: + +``` +POLYGON ((0.5 0.5, 0.4997322937381828 0.4836404585891119, 0.4989294616193017 0.4672984353849285, 0.4975923633360985 0.4509914298352197, 0.4957224306869052 0.4347369038899742, 0.4933216660424395 0.4185522633027057, 0.4903926402016152 0.4024548389919359, 0.4869384896386668 0.3864618684828134, 0.4829629131445342 0.3705904774487396, 0.4784701678661044 0.3548576613727689, 0.4734650647475528 0.3392802673484192, 0.4679529633786629 0.3238749760393833, 0.4619397662556434 0.3086582838174551, 0.4554319124605879 0.2936464850978027, 0.4484363707663442 0.2788556548904993, 0.4409606321741775 0.2643016315870012, 0.4330127018922194 0.25, 0.4246010907632894 0.2359660746748161, 0.4157348061512726 0.2222148834901989, 0.4064233422958076 0.2087611515660989, 0.3966766701456176 0.1956192854956397, 0.3865052266813685 0.1828033579181773, 0.3759199037394887 0.1703270924499656, 0.3649320363489179 0.1582038489885644, 0.3535533905932738 0.1464466094067263, 0.3417961510114357 0.1350679636510822, 0.3296729075500345 0.1240800962605114, 0.3171966420818228 0.1134947733186316, 0.3043807145043603 0.1033233298543824, 0.2912388484339011 0.0935766577041924, 0.2777851165098012 0.0842651938487274, 0.264033925325184 0.0753989092367106, 0.2500000000000001 0.0669872981077807, 0.2356983684129989 0.0590393678258225, 0.2211443451095007 0.0515636292336559, 0.2063535149021975 0.0445680875394122, 0.1913417161825449 0.0380602337443566, 0.1761250239606168 0.0320470366213372, 0.1607197326515808 0.0265349352524472, 0.1451423386272312 0.0215298321338956, 0.1294095225512605 0.0170370868554659, 0.1135381315171867 0.0130615103613332, 0.0975451610080642 0.0096073597983848, 0.0814477366972944 0.0066783339575605, 0.0652630961100259 0.0042775693130948, 0.0490085701647804 0.0024076366639016, 0.0327015646150716 0.0010705383806983, 0.0163595414108882 0.0002677062618172, 0 0, -0.016359541410888 0.0002677062618172, -0.0327015646150715 0.0010705383806983, -0.0490085701647802 0.0024076366639015, -0.0652630961100257 0.0042775693130948, -0.0814477366972942 0.0066783339575605, -0.097545161008064 0.0096073597983847, -0.1135381315171866 0.0130615103613332, -0.1294095225512603 0.0170370868554658, -0.1451423386272311 0.0215298321338955, -0.1607197326515807 0.0265349352524472, -0.1761250239606166 0.0320470366213371, -0.1913417161825448 0.0380602337443566, -0.2063535149021973 0.044568087539412, -0.2211443451095006 0.0515636292336558, -0.2356983684129987 0.0590393678258224, -0.2499999999999999 0.0669872981077806, -0.264033925325184 0.0753989092367106, -0.277785116509801 0.0842651938487273, -0.291238848433901 0.0935766577041924, -0.3043807145043602 0.1033233298543823, -0.3171966420818227 0.1134947733186314, -0.3296729075500343 0.1240800962605111, -0.3417961510114356 0.1350679636510821, -0.3535533905932737 0.1464466094067262, -0.3649320363489177 0.1582038489885642, -0.3759199037394886 0.1703270924499655, -0.3865052266813683 0.1828033579181771, -0.3966766701456175 0.1956192854956396, -0.4064233422958076 0.2087611515660989, -0.4157348061512725 0.2222148834901987, -0.4246010907632894 0.235966074674816, -0.4330127018922192 0.2499999999999998, -0.4409606321741775 0.264301631587001, -0.4484363707663441 0.2788556548904991, -0.4554319124605878 0.2936464850978025, -0.4619397662556434 0.3086582838174551, -0.4679529633786628 0.3238749760393831, -0.4734650647475528 0.3392802673484191, -0.4784701678661044 0.3548576613727686, -0.4829629131445341 0.3705904774487395, -0.4869384896386668 0.3864618684828132, -0.4903926402016152 0.4024548389919357, -0.4933216660424395 0.4185522633027056, -0.4957224306869052 0.434736903889974, -0.4975923633360984 0.4509914298352196, -0.4989294616193017 0.4672984353849282, -0.4997322937381828 0.4836404585891118, -0.5 0.4999999999999999, -0.4997322937381828 0.5163595414108879, -0.4989294616193017 0.5327015646150715, -0.4975923633360985 0.5490085701647801, -0.4957224306869052 0.5652630961100257, -0.4933216660424395 0.5814477366972941, -0.4903926402016153 0.597545161008064, -0.4869384896386668 0.6135381315171865, -0.4829629131445342 0.6294095225512601, -0.4784701678661045 0.645142338627231, -0.4734650647475529 0.6607197326515806, -0.4679529633786629 0.6761250239606166, -0.4619397662556435 0.6913417161825446, -0.455431912460588 0.7063535149021972, -0.4484363707663442 0.7211443451095005, -0.4409606321741776 0.7356983684129986, -0.4330127018922194 0.7499999999999999, -0.4246010907632896 0.7640339253251838, -0.4157348061512727 0.777785116509801, -0.4064233422958078 0.7912388484339008, -0.3966766701456177 0.8043807145043602, -0.3865052266813686 0.8171966420818226, -0.3759199037394889 0.8296729075500342, -0.3649320363489179 0.8417961510114356, -0.353553390593274 0.8535533905932735, -0.3417961510114358 0.8649320363489177, -0.3296729075500345 0.8759199037394887, -0.317196642081823 0.8865052266813683, -0.3043807145043604 0.8966766701456175, -0.2912388484339011 0.9064233422958076, -0.2777851165098015 0.9157348061512725, -0.2640339253251843 0.9246010907632893, -0.2500000000000002 0.9330127018922192, -0.235698368412999 0.9409606321741775, -0.2211443451095007 0.9484363707663441, -0.2063535149021977 0.9554319124605877, -0.1913417161825452 0.9619397662556433, -0.176125023960617 0.9679529633786628, -0.1607197326515809 0.9734650647475528, -0.1451423386272312 0.9784701678661044, -0.1294095225512608 0.9829629131445341, -0.1135381315171869 0.9869384896386668, -0.0975451610080643 0.9903926402016152, -0.0814477366972945 0.9933216660424395, -0.0652630961100262 0.9957224306869051, -0.0490085701647807 0.9975923633360984, -0.0327015646150718 0.9989294616193017, -0.0163595414108883 0.9997322937381828, -0.0000000000000001 1, 0.0163595414108876 0.9997322937381828, 0.0327015646150712 0.9989294616193019, 0.04900857016478 0.9975923633360985, 0.0652630961100256 0.9957224306869052, 0.0814477366972943 0.9933216660424395, 0.0975451610080637 0.9903926402016153, 0.1135381315171863 0.9869384896386669, 0.1294095225512601 0.9829629131445342, 0.145142338627231 0.9784701678661045, 0.1607197326515807 0.9734650647475529, 0.1761250239606164 0.967952963378663, 0.1913417161825446 0.9619397662556435, 0.2063535149021972 0.955431912460588, 0.2211443451095005 0.9484363707663442, 0.2356983684129984 0.9409606321741777, 0.2499999999999997 0.9330127018922195, 0.2640339253251837 0.9246010907632896, 0.2777851165098009 0.9157348061512727, 0.291238848433901 0.9064233422958077, 0.3043807145043599 0.8966766701456179, 0.3171966420818225 0.8865052266813687, 0.3296729075500342 0.8759199037394889, 0.3417961510114355 0.8649320363489179, 0.3535533905932737 0.8535533905932738, 0.3649320363489175 0.841796151011436, 0.3759199037394885 0.8296729075500346, 0.3865052266813683 0.817196642081823, 0.3966766701456175 0.8043807145043604, 0.4064233422958076 0.7912388484339011, 0.4157348061512723 0.7777851165098015, 0.4246010907632893 0.7640339253251842, 0.4330127018922192 0.7500000000000002, 0.4409606321741774 0.735698368412999, 0.4484363707663439 0.7211443451095011, 0.4554319124605877 0.7063535149021978, 0.4619397662556433 0.6913417161825453, 0.4679529633786628 0.676125023960617, 0.4734650647475528 0.6607197326515809, 0.4784701678661043 0.6451423386272317, 0.482962913144534 0.6294095225512608, 0.4869384896386668 0.613538131517187, 0.4903926402016152 0.5975451610080643, 0.4933216660424395 0.5814477366972945, 0.4957224306869051 0.5652630961100262, 0.4975923633360984 0.5490085701647807, 0.4989294616193017 0.5327015646150718, 0.4997322937381828 0.5163595414108882, 0.5 0.5)) ``` ## ST_MinimumBoundingRadius @@ -1576,10 +1581,17 @@ Format: `ST_MinimumBoundingRadius(geom: geometry)` Since: `v1.0.1` Spark SQL example: + ```sql SELECT ST_MinimumBoundingRadius(ST_GeomFromText('POLYGON((1 1,0 0, -1 1, 1 1))')) ``` +Output: + +``` +{POINT (0 1), 1.0} +``` + ## ST_Multi Introduction: Returns a MultiGeometry object based on the geometry input. @@ -1594,20 +1606,15 @@ Since: `v1.2.0` Example: ```sql -SELECT ST_Multi( - ST_GeomFromText('POINT(1 1)') -) AS geom +SELECT ST_Multi(ST_GeomFromText('POINT(1 1)')) ``` -Result: +Output: ``` -+---------------------------------------------------------------+ -|geom | -+---------------------------------------------------------------+ -|MULTIPOINT (1 1) | -+---------------------------------------------------------------+ +MULTIPOINT (1 1) ``` + ## ST_NDims Introduction: Returns the coordinate dimension of the geometry. @@ -1616,13 +1623,17 @@ Format: `ST_NDims(geom: geometry)` Since: `v1.3.1` -Spark SQL example with z co-rodinate: +Spark SQL example with z coordinate: ```sql SELECT ST_NDims(ST_GeomFromEWKT('POINT(1 1 2)')) ``` -Output: `3` +Output: + +``` +3 +``` Spark SQL example with x,y coordinate: @@ -1630,7 +1641,11 @@ Spark SQL example with x,y coordinate: SELECT ST_NDims(ST_GeomFromText('POINT(1 1)')) ``` -Output: `2` +Output: + +``` +2 +``` ## ST_Normalize @@ -1645,30 +1660,33 @@ Since: `v1.3.0` Example: ```sql -SELECT ST_AsEWKT(ST_Normalize(ST_GeomFromWKT('POLYGON((0 1, 1 1, 1 0, 0 0, 0 1))'))) AS geom +SELECT ST_AsEWKT(ST_Normalize(ST_GeomFromWKT('POLYGON((0 1, 1 1, 1 0, 0 0, 0 1))'))) ``` Result: ``` -+-----------------------------------+ -|geom | -+-----------------------------------+ -|POLYGON ((0 0, 0 1, 1 1, 1 0, 0 0))| -+-----------------------------------+ +POLYGON ((0 0, 0 1, 1 1, 1 0, 0 0)) ``` ## ST_NPoints Introduction: Return points of the geometry +Format: `ST_NPoints (A:geometry)` + Since: `v1.0.0` -Format: `ST_NPoints (A:geometry)` +Example: ```sql -SELECT ST_NPoints(polygondf.countyshape) -FROM polygondf +SELECT ST_NPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)')) +``` + +Output: + +``` +4 ``` ## ST_NRings @@ -1710,9 +1728,16 @@ Format: `ST_NumGeometries (A:geometry)` Since: `v1.0.0` +Example + ```sql -SELECT ST_NumGeometries(df.geometry) -FROM df +SELECT ST_NumGeometries(ST_GeomFromWKT('LINESTRING (-29 -27, -30 -29.7, -45 -33)')) +``` + +Output: + +``` +1 ``` ## ST_NumInteriorRings @@ -1724,11 +1749,16 @@ Format: `ST_NumInteriorRings(geom: geometry)` Since: `v1.0.0` Spark SQL example: + ```sql SELECT ST_NumInteriorRings(ST_GeomFromText('POLYGON ((0 0, 0 5, 5 5, 5 0, 0 0), (1 1, 2 1, 2 2, 1 2, 1 1))')) ``` -Output: `1` +Output: + +``` +1 +``` ## ST_NumPoints Introduction: Returns number of points in a LineString @@ -1739,16 +1769,22 @@ Introduction: Returns number of points in a LineString `SELECT ST_NumPoints(ST_GeomFromWKT('MULTIPOINT ((0 0), (1 1), (0 1), (2 2))'))` Output: `IllegalArgumentException: Unsupported geometry type: MultiPoint, only LineString geometry is supported.` + Format: `ST_NumPoints(geom: geometry)` Since: `v1.4.1` Spark SQL example: + ```sql SELECT ST_NumPoints(ST_GeomFromText('LINESTRING(0 1, 1 0, 2 0)')) ``` -Output: `3` +Output: + +``` +3 +``` ## ST_PointN @@ -1760,17 +1796,13 @@ Since: `v1.2.1` Spark SQL example: ```sql -SELECT ST_PointN(ST_GeomFromText("LINESTRING(0 0, 1 2, 2 4, 3 6)"), 2) AS geom +SELECT ST_PointN(ST_GeomFromText("LINESTRING(0 0, 1 2, 2 4, 3 6)"), 2) ``` Result: ``` -+---------------------------------------------------------------+ -|geom | -+---------------------------------------------------------------+ -|POINT (1 2) | -+---------------------------------------------------------------+ +POINT (1 2) ``` ## ST_PointOnSurface