diff --git a/.translation-init b/.translation-init index 6bd421e08d..6996b129a2 100644 --- a/.translation-init +++ b/.translation-init @@ -1 +1 @@ -Translation initialization: 2025-10-21T12:48:08.947129 +Translation initialization: 2025-10-21T11:32:59.283277 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/_category_.json b/docs/cn/sql-reference/20-sql-functions/09-geo-functions/_category_.json deleted file mode 100644 index e973617c5c..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/_category_.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "label": "地理函数" -} \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/index.md b/docs/cn/sql-reference/20-sql-functions/09-geo-functions/index.md deleted file mode 100644 index 1e85ad41cd..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/index.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: H3 函数 ---- - -本节提供 Databend 中 H3 函数的参考信息。H3 是一种地理空间索引系统,通过将地球划分为六边形单元,支持高效的空间分析与操作。 - -## 坐标转换 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [GEO_TO_H3](geo-to-h3) | 将经纬度转换为 H3 索引 | `GEO_TO_H3(37.7950, 55.7129, 15)` → `644325524701193974` | -| [H3_TO_GEO](h3-to-geo) | 将 H3 索引转换为经纬度 | `H3_TO_GEO(644325524701193974)` → `[37.7950, 55.7129]` | -| [H3_TO_STRING](h3-to-string) | 将 H3 索引转换为字符串表示 | `H3_TO_STRING(644325524701193974)` → `'8f2830828052d25'` | -| [STRING_TO_H3](string-to-h3) | 将字符串表示转换为 H3 索引 | `STRING_TO_H3('8f2830828052d25')` → `644325524701193974` | -| [GEOHASH_ENCODE](geohash-encode) | 将经纬度编码为 geohash 字符串 | `GEOHASH_ENCODE(37.7950, 55.7129, 12)` → `'ucfv0nzpt3s7'` | -| [GEOHASH_DECODE](geohash-decode) | 将 geohash 字符串解码为经纬度 | `GEOHASH_DECODE('ucfv0nzpt3s7')` → `[37.7950, 55.7129]` | - -## 六边形属性 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [H3_GET_RESOLUTION](h3-get-resolution) | 返回 H3 索引的分辨率 | `H3_GET_RESOLUTION(644325524701193974)` → `15` | -| [H3_GET_BASE_CELL](h3-get-base-cell) | 返回 H3 索引的基础单元编号 | `H3_GET_BASE_CELL(644325524701193974)` → `14` | -| [H3_IS_VALID](h3-is-valid) | 检查 H3 索引是否有效 | `H3_IS_VALID(644325524701193974)` → `TRUE` | -| [H3_IS_PENTAGON](h3-is-pentagon) | 检查 H3 索引是否为五边形 | `H3_IS_PENTAGON(644325524701193974)` → `FALSE` | -| [H3_IS_RES_CLASS_III](h3-is-res-class-iii) | 检查 H3 索引是否属于 III 类分辨率 | `H3_IS_RES_CLASS_III(644325524701193974)` → `FALSE` | -| [H3_GET_FACES](h3-get-faces) | 返回 H3 单元相交的二十面体面 | `H3_GET_FACES(644325524701193974)` → `[7]` | -| [H3_TO_PARENT](h3-to-parent) | 返回指定分辨率下 H3 索引的父级索引 | `H3_TO_PARENT(644325524701193974, 10)` → `622236721289822207` | -| [H3_TO_CHILDREN](h3-to-children) | 返回指定分辨率下 H3 索引的子级索引 | `H3_TO_CHILDREN(622236721289822207, 11)` → `[...]` | -| [H3_TO_CENTER_CHILD](h3-to-center-child) | 返回指定分辨率下 H3 索引的中心子级索引 | `H3_TO_CENTER_CHILD(622236721289822207, 11)` → `625561602857582591` | - -## 面积与边界 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [H3_CELL_AREA_M2](h3-cell-area-m2) | 返回 H3 单元面积(平方米) | `H3_CELL_AREA_M2(644325524701193974)` → `0.8953` | -| [H3_CELL_AREA_RADS2](h3-cell-area-rads2) | 返回 H3 单元面积(平方弧度) | `H3_CELL_AREA_RADS2(644325524701193974)` → `2.2e-14` | -| [H3_HEX_AREA_KM2](h3-hex-area-km2) | 返回指定分辨率的六边形平均面积(平方公里) | `H3_HEX_AREA_KM2(10)` → `0.0152` | -| [H3_HEX_AREA_M2](h3-hex-area-m2) | 返回指定分辨率的六边形平均面积(平方米) | `H3_HEX_AREA_M2(10)` → `15200` | -| [H3_TO_GEO_BOUNDARY](h3-to-geo-boundary) | 返回 H3 单元的边界坐标数组 | `H3_TO_GEO_BOUNDARY(644325524701193974)` → `[[lon1,lat1], [lon2,lat2], ...]` | -| [H3_NUM_HEXAGONS](h3-num-hexagons) | 返回指定分辨率的六边形数量 | `H3_NUM_HEXAGONS(2)` → `5882` | - -## 六边形关系 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [H3_DISTANCE](h3-distance) | 返回两个 H3 索引的网格距离 | `H3_DISTANCE(599119489002373119, 599119491149856767)` → `1` | -| [H3_INDEXES_ARE_NEIGHBORS](h3-indexes-are-neighbors) | 检查两个 H3 索引是否相邻 | `H3_INDEXES_ARE_NEIGHBORS(599119489002373119, 599119491149856767)` → `TRUE` | -| [H3_K_RING](h3-k-ring) | 返回原点 k 阶邻域内的所有 H3 索引 | `H3_K_RING(599119489002373119, 1)` → `[599119489002373119, 599119491149856767, ...]` | -| [H3_HEX_RING](h3-hex-ring) | 返回距离原点精确 k 阶的所有 H3 索引 | `H3_HEX_RING(599119489002373119, 1)` → `[599119491149856767, ...]` | - -## 边函数 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [H3_GET_UNIDIRECTIONAL_EDGE](h3-get-unidirectional-edge) | 返回相邻 H3 索引间的单向边索引 | `H3_GET_UNIDIRECTIONAL_EDGE(from_h3, to_h3)` → `edge_index` | -| [H3_UNIDIRECTIONAL_EDGE_IS_VALID](h3-unidirectional-edge-is-valid) | 检查 H3 边索引是否有效 | `H3_UNIDIRECTIONAL_EDGE_IS_VALID(edge_index)` → `TRUE` | -| [H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE](h3-get-origin-index-from-unidirectional-edge) | 从边索引获取起点 H3 索引 | `H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE(edge_index)` → `from_h3` | -| [H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE](h3-get-destination-index-from-unidirectional-edge) | 从边索引获取终点 H3 索引 | `H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE(edge_index)` → `to_h3` | -| [H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE](h3-get-indexes-from-unidirectional-edge) | 从边索引获取起点与终点 H3 索引 | `H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE(edge_index)` → `[from_h3, to_h3]` | -| [H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON](h3-get-unidirectional-edges-from-hexagon) | 返回 H3 索引发出的所有单向边 | `H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON(h3_index)` → `[edge1, edge2, ...]` | -| [H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY](h3-get-unidirectional-edge-boundary) | 返回 H3 边的边界坐标 | `H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY(edge_index)` → `[[lon1,lat1], [lon2,lat2]]` | - -## 测量 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [H3_EDGE_LENGTH_KM](h3-edge-length-km) | 返回指定分辨率的平均边长(千米) | `H3_EDGE_LENGTH_KM(10)` → `0.065` | -| [H3_EDGE_LENGTH_M](h3-edge-length-m) | 返回指定分辨率的平均边长(米) | `H3_EDGE_LENGTH_M(10)` → `65.91` | -| [H3_EXACT_EDGE_LENGTH_KM](h3-exact-edge-length-km) | 返回精确边长(千米) | `H3_EXACT_EDGE_LENGTH_KM(edge_index)` → `0.066` | -| [H3_EXACT_EDGE_LENGTH_M](h3-exact-edge-length-m) | 返回精确边长(米) | `H3_EXACT_EDGE_LENGTH_M(edge_index)` → `66.12` | -| [H3_EXACT_EDGE_LENGTH_RADS](h3-exact-edge-length-rads) | 返回精确边长(弧度) | `H3_EXACT_EDGE_LENGTH_RADS(edge_index)` → `0.00001` | -| [H3_EDGE_ANGLE](h3-edge-angle) | 返回两条边的夹角(弧度) | `H3_EDGE_ANGLE(edge1, edge2)` → `1.047` | - -## 通用工具 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [POINT_IN_POLYGON](point-in-polygon) | 检查点是否在多边形内 | `POINT_IN_POLYGON([lon, lat], [[p1_lon, p1_lat], [p2_lon, p2_lat], ...])` → `TRUE` | -| [H3_LINE](h3-line) | 返回两个 H3 索引间连线路径的索引 | `H3_LINE(from_h3, to_h3)` → `[from_h3, ..., to_h3]` | \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/_category_.json b/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/_category_.json deleted file mode 100644 index 6ae3e4ca64..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/_category_.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "label": "几何函数" -} \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/haversine.md b/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/haversine.md deleted file mode 100644 index fd06a6a5a1..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/haversine.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: HAVERSINE ---- -import FunctionDescription from '@site/src/components/FunctionDescription'; - - - -计算地球表面两点之间的大圆距离(以公里为单位),使用[Haversine公式](https://en.wikipedia.org/wiki/Haversine_formula)。这两点通过它们的纬度和经度(以度为单位)指定。 - -## 语法 - -```sql -HAVERSINE(, , , ) -``` - -## 参数 - -| 参数 | 描述 | -|-----------|------------------------------| -| `` | 第一个点的纬度。 | -| `` | 第一个点的经度。 | -| `` | 第二个点的纬度。 | -| `` | 第二个点的经度。 | - -## 返回类型 - -Double。 - -## 示例 - -```sql -SELECT - HAVERSINE(40.7127, -74.0059, 34.0500, -118.2500) AS distance - -┌────────────────┐ -│ distance │ -├────────────────┤ -│ 3936.390533556 │ -└────────────────┘ -``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/index.md b/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/index.md deleted file mode 100644 index 6b70221a5e..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/index.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: 几何函数(Geometry Functions) ---- - -本页面全面概述了 Databend 中的几何函数(Geometry Functions),按功能分类以便参考。 - -## 几何创建函数 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [ST_MAKEGEOMPOINT](st-makegeompoint.md) / [ST_GEOM_POINT](st-geom-point.md) | 构造点几何体 | `ST_MAKEGEOMPOINT(-122.35, 37.55)` → `POINT(-122.35 37.55)` | -| [ST_MAKELINE](st-makeline.md) / [ST_MAKE_LINE](st-make-line.md) | 基于点创建线字符串 | `ST_MAKELINE(ST_MAKEGEOMPOINT(-122.35, 37.55), ST_MAKEGEOMPOINT(-122.40, 37.60))` → `LINESTRING(-122.35 37.55, -122.40 37.60)` | -| [ST_MAKEPOLYGON](st-makepolygon.md) | 基于线字符串创建多边形 | `ST_MAKEPOLYGON(ST_MAKELINE(...))` → `POLYGON(...)` | -| [ST_POLYGON](st-polygon.md) | 创建多边形 | `ST_POLYGON(...)` → `POLYGON(...)` | - -## 几何转换函数 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [ST_GEOMETRYFROMTEXT](st-geometryfromtext.md) / [ST_GEOMFROMTEXT](st-geomfromtext.md) | 将 WKT 转换为几何体 | `ST_GEOMETRYFROMTEXT('POINT(-122.35 37.55)')` → `POINT(-122.35 37.55)` | -| [ST_GEOMETRYFROMWKB](st-geometryfromwkb.md) / [ST_GEOMFROMWKB](st-geomfromwkb.md) | 将 WKB 转换为几何体 | `ST_GEOMETRYFROMWKB(...)` → `POINT(...)` | -| [ST_GEOMETRYFROMEWKT](st-geometryfromewkt.md) / [ST_GEOMFROMEWKT](st-geomfromewkt.md) | 将 EWKT 转换为几何体 | `ST_GEOMETRYFROMEWKT('SRID=4326;POINT(-122.35 37.55)')` → `POINT(-122.35 37.55)` | -| [ST_GEOMETRYFROMEWKB](st-geometryfromewkb.md) / [ST_GEOMFROMEWKB](st-geomfromewkb.md) | 将 EWKB 转换为几何体 | `ST_GEOMETRYFROMEWKB(...)` → `POINT(...)` | -| [ST_GEOMFROMGEOHASH](st-geomfromgeohash.md) | 将 GeoHash 转换为几何体 | `ST_GEOMFROMGEOHASH('9q8yyk8')` → `POLYGON(...)` | -| [ST_GEOMPOINTFROMGEOHASH](st-geompointfromgeohash.md) | 将 GeoHash 转换为点 | `ST_GEOMPOINTFROMGEOHASH('9q8yyk8')` → `POINT(...)` | -| [TO_GEOMETRY](to-geometry.md) | 将多种格式转换为几何体 | `TO_GEOMETRY('POINT(-122.35 37.55)')` → `POINT(-122.35 37.55)` | - -## 几何输出函数 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [ST_ASTEXT](st-astext.md) | 将几何体转换为 WKT | `ST_ASTEXT(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'POINT(-122.35 37.55)'` | -| [ST_ASWKT](st-aswkt.md) | 将几何体转换为 WKT | `ST_ASWKT(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'POINT(-122.35 37.55)'` | -| [ST_ASBINARY](st-asbinary.md) / [ST_ASWKB](st-aswkb.md) | 将几何体转换为 WKB | `ST_ASBINARY(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `WKB representation` | -| [ST_ASEWKT](st-asewkt.md) | 将几何体转换为 EWKT | `ST_ASEWKT(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'SRID=4326;POINT(-122.35 37.55)'` | -| [ST_ASEWKB](st-asewkb.md) | 将几何体转换为 EWKB | `ST_ASEWKB(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `EWKB representation` | -| [ST_ASGEOJSON](st-asgeojson.md) | 将几何体转换为 GeoJSON | `ST_ASGEOJSON(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'{"type":"Point","coordinates":[-122.35,37.55]}'` | -| [ST_GEOHASH](st-geohash.md) | 将几何体转换为 GeoHash | `ST_GEOHASH(ST_MAKEGEOMPOINT(-122.35, 37.55), 7)` → `'9q8yyk8'` | -| [TO_STRING](to-string.md) | 将几何体转换为字符串 | `TO_STRING(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'POINT(-122.35 37.55)'` | - -## 几何属性 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [ST_DIMENSION](st-dimension.md) | 返回几何体的维度 | `ST_DIMENSION(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `0` | -| [ST_SRID](st-srid.md) | 返回几何体的 SRID | `ST_SRID(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `4326` | -| [ST_NPOINTS](st-npoints.md) / [ST_NUMPOINTS](st-numpoints.md) | 返回几何体中的点数 | `ST_NPOINTS(ST_MAKELINE(...))` → `2` | -| [ST_X](st-x.md) | 返回点的 X 坐标 | `ST_X(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `-122.35` | -| [ST_Y](st-y.md) | 返回点的 Y 坐标 | `ST_Y(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `37.55` | -| [ST_XMIN](st-xmin.md) | 返回最小 X 坐标 | `ST_XMIN(ST_MAKELINE(...))` → `-122.40` | -| [ST_XMAX](st-xmax.md) | 返回最大 X 坐标 | `ST_XMAX(ST_MAKELINE(...))` → `-122.35` | -| [ST_YMIN](st-ymin.md) | 返回最小 Y 坐标 | `ST_YMIN(ST_MAKELINE(...))` → `37.55` | -| [ST_YMAX](st-ymax.md) | 返回最大 Y 坐标 | `ST_YMAX(ST_MAKELINE(...))` → `37.60` | -| [ST_LENGTH](st-length.md) | 返回线字符串的长度 | `ST_LENGTH(ST_MAKELINE(...))` → `5.57` | - -## 几何访问器 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [ST_POINTN](st-pointn.md) | 从线字符串返回指定点 | `ST_POINTN(ST_MAKELINE(...), 1)` → `POINT(-122.35 37.55)` | -| [ST_STARTPOINT](st-startpoint.md) | 返回线字符串的起点 | `ST_STARTPOINT(ST_MAKELINE(...))` → `POINT(-122.35 37.55)` | -| [ST_ENDPOINT](st-endpoint.md) | 返回线字符串的终点 | `ST_ENDPOINT(ST_MAKELINE(...))` → `POINT(-122.40 37.60)` | - -## 空间操作 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [ST_DISTANCE](st-distance.md) | 返回两个几何体间的距离 | `ST_DISTANCE(ST_MAKEGEOMPOINT(-122.35, 37.55), ST_MAKEGEOMPOINT(-122.40, 37.60))` → `5.57` | -| [HAVERSINE](haversine.md) | 返回两点间的大圆距离 | `HAVERSINE(37.55, -122.35, 37.60, -122.40)` → `6.12` | -| [ST_CONTAINS](st-contains.md) | 判断几何体是否包含另一几何体 | `ST_CONTAINS(ST_MAKEPOLYGON(...), ST_MAKEGEOMPOINT(...))` → `TRUE` | -| [ST_TRANSFORM](st-transform.md) | 将几何体从某 SRID 转换至另一 SRID | `ST_TRANSFORM(ST_MAKEGEOMPOINT(-122.35, 37.55), 3857)` → `POINT(-13618288.8 4552395.0)` | -| [ST_SETSRID](st-setsrid.md) | 设置几何体的 SRID | `ST_SETSRID(ST_MAKEGEOMPOINT(-122.35, 37.55), 3857)` → `POINT(-122.35 37.55)` | \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromtext.md b/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromtext.md deleted file mode 100644 index 03d3d0dd2f..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromtext.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: ST_GEOMETRYFROMTEXT ---- - -[ST_GEOMETRYFROMWKT](st-geometryfromwkt.md) 的别名。 -{/*examples*/} \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-setsrid.md b/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-setsrid.md deleted file mode 100644 index 396a22df04..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-setsrid.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: ST_SETSRID ---- -import FunctionDescription from '@site/src/components/FunctionDescription'; - - - -返回一个GEOMETRY对象,其[SRID(空间参考系统标识符)](https://en.wikipedia.org/wiki/Spatial_reference_system#Identifier)设置为指定值。此函数仅更改SRID,而不影响对象的坐标。如果还需要将坐标更改为与新的SRS(空间参考系统)匹配,请改用[ST_TRANSFORM](st-transform.md)。 - -## 语法 - -```sql -ST_SETSRID(, ) -``` - -## 参数 - -| 参数 | 描述 | -|--------------|-------------------------------------------------------------| -| `` | 参数必须是GEOMETRY对象类型的表达式。 | -| `` | 要在返回的GEOMETRY对象中设置的SRID整数。 | - -## 返回类型 - -Geometry。 - -## 示例 - -```sql -SET GEOMETRY_OUTPUT_FORMAT = 'EWKT' - -SELECT ST_SETSRID(TO_GEOMETRY('POINT(13 51)'), 4326) AS geometry - -┌────────────────────────┐ -│ geometry │ -├────────────────────────┤ -│ SRID=4326;POINT(13 51) │ -└────────────────────────┘ - -``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/_category_.json b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/_category_.json new file mode 100644 index 0000000000..7fabdf10c6 --- /dev/null +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "地理空间函数", + "position": 16 +} \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/geo-to-h3.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geo-to-h3.md similarity index 89% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/geo-to-h3.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geo-to-h3.md index 1aaf669318..509780ad1c 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/geo-to-h3.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geo-to-h3.md @@ -1,23 +1,23 @@ ---- -title: GEO_TO_H3 ---- - -返回给定位置所在的六边形单元格的 [H3](https://eng.uber.com/h3/) 索引。返回 0 表示发生了错误。 - -## 语法 - -```sql -GEO_TO_H3(lon, lat, res) -``` - -## 示例 - -```sql -SELECT GEO_TO_H3(37.79506683, 55.71290588, 15); - -┌─────────────────────────────────────────┐ -│ geo_to_h3(37.79506683, 55.71290588, 15) │ -├─────────────────────────────────────────┤ -│ 644325524701193974 │ -└─────────────────────────────────────────┘ +--- +title: GEO_TO_H3 +--- + +返回给定位置所在的六边形单元格的 [H3](https://eng.uber.com/h3/) 索引。返回 0 表示发生错误。 + +## 语法 + +```sql +GEO_TO_H3(lon, lat, res) +``` + +## 示例 + +```sql +SELECT GEO_TO_H3(37.79506683, 55.71290588, 15); + +┌─────────────────────────────────────────┐ +│ geo_to_h3(37.79506683, 55.71290588, 15) │ +├─────────────────────────────────────────┤ +│ 644325524701193974 │ +└─────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/geohash-decode.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geohash-decode.md similarity index 75% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/geohash-decode.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geohash-decode.md index 24c95dbcd7..99401b8dca 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/geohash-decode.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geohash-decode.md @@ -1,23 +1,23 @@ ---- -title: GEOHASH_DECODE ---- - -将一个[Geohash](https://en.wikipedia.org/wiki/Geohash)编码的字符串转换为纬度/经度坐标。 - -## 语法 - -```sql -GEOHASH_DECODE('') -``` - -## 示例 - -```sql -SELECT GEOHASH_DECODE('ezs42'); - -┌─────────────────────────────────┐ -│ geohash_decode('ezs42') │ -├─────────────────────────────────┤ -│ (-5.60302734375,42.60498046875) │ -└─────────────────────────────────┘ +--- +title: GEOHASH_DECODE +--- + +将 [Geohash](https://en.wikipedia.org/wiki/Geohash) 编码的字符串转换为经纬度坐标。 + +## 语法 + +```sql +GEOHASH_DECODE('') +``` + +## 示例 + +```sql +SELECT GEOHASH_DECODE('ezs42'); + +┌─────────────────────────────────┐ +│ geohash_decode('ezs42') │ +├─────────────────────────────────┤ +│ (-5.60302734375,42.60498046875) │ +└─────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/geohash-encode.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geohash-encode.md similarity index 97% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/geohash-encode.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geohash-encode.md index eaef9138e1..7c71600571 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/geohash-encode.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/geohash-encode.md @@ -1,23 +1,23 @@ ---- -title: GEOHASH_ENCODE ---- - -将一对经纬度坐标转换为 [Geohash](https://en.wikipedia.org/wiki/Geohash) 编码的字符串。 - -## 语法 - -```sql -GEOHASH_ENCODE(lon, lat) -``` - -## 示例 - -```sql -SELECT GEOHASH_ENCODE(-5.60302734375, 42.593994140625); - -┌────────────────────────────────────────────────────┐ -│ geohash_encode((- 5.60302734375), 42.593994140625) │ -├────────────────────────────────────────────────────┤ -│ ezs42d000000 │ -└────────────────────────────────────────────────────┘ +--- +title: GEOHASH_ENCODE +--- + +将一对经纬度坐标转换为 [Geohash](https://en.wikipedia.org/wiki/Geohash) 编码的字符串。 + +## 语法 + +```sql +GEOHASH_ENCODE(lon, lat) +``` + +## 示例 + +```sql +SELECT GEOHASH_ENCODE(-5.60302734375, 42.593994140625); + +┌────────────────────────────────────────────────────┐ +│ geohash_encode((- 5.60302734375), 42.593994140625) │ +├────────────────────────────────────────────────────┤ +│ ezs42d000000 │ +└────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-cell-area-m2.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-cell-area-m2.md similarity index 87% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-cell-area-m2.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-cell-area-m2.md index dc86a85453..5bcb359e39 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-cell-area-m2.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-cell-area-m2.md @@ -1,23 +1,23 @@ ---- -title: H3_CELL_AREA_M2 ---- - -返回特定单元格的精确面积,单位为平方米。 - -## 语法 - -```sql -H3_CELL_AREA_M2(h3) -``` - -## 示例 - -```sql -SELECT H3_CELL_AREA_M2(599119489002373119); - -┌─────────────────────────────────────┐ -│ h3_cell_area_m2(599119489002373119) │ -├─────────────────────────────────────┤ -│ 127785582.60809991 │ -└─────────────────────────────────────┘ +--- +title: H3_CELL_AREA_M2 +--- + +返回指定 H3 单元格的精确面积,单位为平方米。 + +## 语法 + +```sql +H3_CELL_AREA_M2(h3) +``` + +## 示例 + +```sql +SELECT H3_CELL_AREA_M2(599119489002373119); + +┌─────────────────────────────────────┐ +│ h3_cell_area_m2(599119489002373119) │ +├─────────────────────────────────────┤ +│ 127785582.60809991 │ +└─────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-cell-area-rads2.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-cell-area-rads2.md similarity index 87% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-cell-area-rads2.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-cell-area-rads2.md index 1d063517fe..40c1abdf64 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-cell-area-rads2.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-cell-area-rads2.md @@ -1,23 +1,23 @@ ---- -title: H3_CELL_AREA_RADS2 ---- - -返回特定单元格的精确面积,单位为平方弧度。 - -## 语法 - -```sql -H3_CELL_AREA_RADS2(h3) -``` - -## 示例 - -```sql -SELECT H3_CELL_AREA_RADS2(599119489002373119); - -┌────────────────────────────────────────┐ -│ h3_cell_area_rads2(599119489002373119) │ -├────────────────────────────────────────┤ -│ 0.000003148224310427697 │ -└────────────────────────────────────────┘ +--- +title: H3_CELL_AREA_RADS2 +--- + +以平方弧度为单位,返回指定单元格的精确面积。 + +## 语法 + +```sql +H3_CELL_AREA_RADS2(h3) +``` + +## 示例 + +```sql +SELECT H3_CELL_AREA_RADS2(599119489002373119); + +┌────────────────────────────────────────┐ +│ h3_cell_area_rads2(599119489002373119) │ +├────────────────────────────────────────┤ +│ 0.000003148224310427697 │ +└────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-distance.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-distance.md similarity index 87% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-distance.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-distance.md index d4a6a3c737..80a69101c5 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-distance.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-distance.md @@ -1,23 +1,23 @@ ---- -title: H3_DISTANCE ---- - -返回两个给定的 [H3](https://eng.uber.com/h3/) 索引之间的网格距离。 - -## 语法 - -```sql -H3_DISTANCE(h3, a_h3) -``` - -## 示例 - -```sql -SELECT H3_DISTANCE(599119489002373119, 599119491149856767); - -┌─────────────────────────────────────────────────────┐ -│ h3_distance(599119489002373119, 599119491149856767) │ -├─────────────────────────────────────────────────────┤ -│ 1 │ -└─────────────────────────────────────────────────────┘ +--- +title: H3_DISTANCE +--- + +返回两个给定 [H3](https://eng.uber.com/h3/) 索引之间的网格距离(Grid Distance)。 + +## 语法 + +```sql +H3_DISTANCE(h3, a_h3) +``` + +## 示例 + +```sql +SELECT H3_DISTANCE(599119489002373119, 599119491149856767); + +┌─────────────────────────────────────────────────────┐ +│ h3_distance(599119489002373119, 599119491149856767) │ +├─────────────────────────────────────────────────────┤ +│ 1 │ +└─────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-angle.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-angle.md similarity index 83% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-angle.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-angle.md index 3be6439f50..5a76cd552c 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-angle.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-angle.md @@ -1,23 +1,23 @@ ---- -title: H3_EDGE_ANGLE ---- - -返回 H3 六边形边缘的平均长度,单位为度。 - -## 语法 - -```sql -H3_EDGE_ANGLE(res) -``` - -## 示例 - -```sql -SELECT H3_EDGE_ANGLE(10); - -┌───────────────────────┐ -│ h3_edge_angle(10) │ -├───────────────────────┤ -│ 0.0006822586214153981 │ -└───────────────────────┘ +--- +title: H3_EDGE_ANGLE +--- + +返回 H3 六边形边的平均长度(以度为单位)。 + +## 语法 + +```sql +H3_EDGE_ANGLE(res) +``` + +## 示例 + +```sql +SELECT H3_EDGE_ANGLE(10); + +┌───────────────────────┐ +│ h3_edge_angle(10) │ +├───────────────────────┤ +│ 0.0006822586214153981 │ +└───────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-length-km.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-length-km.md similarity index 77% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-length-km.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-length-km.md index c3b96cd7d0..3074fb0e2a 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-length-km.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-length-km.md @@ -1,23 +1,23 @@ ---- -title: H3_EDGE_LENGTH_KM ---- - -返回给定分辨率下六边形边的平均长度,单位为公里。不包括五边形。 - -## 语法 - -```sql -H3_EDGE_LENGTH_KM(res) -``` - -## 示例 - -```sql -SELECT H3_EDGE_LENGTH_KM(1); - -┌──────────────────────┐ -│ h3_edge_length_km(1) │ -├──────────────────────┤ -│ 483.0568390711111 │ -└──────────────────────┘ +--- +title: H3_EDGE_LENGTH_KM +--- + +返回指定分辨率下六边形的平均边长(单位:公里)。不包含五边形。 + +## 语法 + +```sql +H3_EDGE_LENGTH_KM(res) +``` + +## 示例 + +```sql +SELECT H3_EDGE_LENGTH_KM(1); + +┌──────────────────────┐ +│ h3_edge_length_km(1) │ +├──────────────────────┤ +│ 483.0568390711111 │ +└──────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-length-m.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-length-m.md similarity index 75% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-length-m.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-length-m.md index a89f9224c0..e17ce91e62 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-edge-length-m.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-edge-length-m.md @@ -1,21 +1,21 @@ ---- -title: H3_EDGE_LENGTH_M ---- - -返回给定分辨率下六边形边的平均长度,单位为米。不包括五边形。 - -## 语法 - -```sql -H3_EDGE_LENGTH_M(1) -``` - -## 示例 - -```sql -┌─────────────────────┐ -│ h3_edge_length_m(1) │ -├─────────────────────┤ -│ 483056.8390711111 │ -└─────────────────────┘ +--- +title: H3_EDGE_LENGTH_M +--- + +返回指定分辨率下六边形(hexagon)的平均边长,单位为米。不包含五边形(pentagon)。 + +## 语法 + +```sql +H3_EDGE_LENGTH_M(1) +``` + +## 示例 + +```sql +┌─────────────────────┐ +│ h3_edge_length_m(1) │ +├─────────────────────┤ +│ 483056.8390711111 │ +└─────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-km.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-km.md similarity index 90% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-km.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-km.md index d2c8d2c8c8..29ad2d27d5 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-km.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-km.md @@ -1,23 +1,23 @@ ---- -title: H3_EXACT_EDGE_LENGTH_KM ---- - -计算这条有向边的长度,单位为公里。 - -## 语法 - -```sql -H3_EXACT_EDGE_LENGTH_KM(h3) -``` - -## 示例 - -```sql -SELECT H3_EXACT_EDGE_LENGTH_KM(1319695429381652479); - -┌──────────────────────────────────────────────┐ -│ h3_exact_edge_length_km(1319695429381652479) │ -├──────────────────────────────────────────────┤ -│ 8.267326832647143 │ -└──────────────────────────────────────────────┘ +--- +title: H3_EXACT_EDGE_LENGTH_KM +--- + +计算该有向边的长度,单位为千米。 + +## 语法 + +```sql +H3_EXACT_EDGE_LENGTH_KM(h3) +``` + +## 示例 + +```sql +SELECT H3_EXACT_EDGE_LENGTH_KM(1319695429381652479); + +┌──────────────────────────────────────────────┐ +│ h3_exact_edge_length_km(1319695429381652479) │ +├──────────────────────────────────────────────┤ +│ 8.267326832647143 │ +└──────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-m.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-m.md similarity index 90% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-m.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-m.md index fc8efa8763..3f891a254c 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-m.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-m.md @@ -1,23 +1,23 @@ ---- -title: H3_EXACT_EDGE_LENGTH_M ---- - -计算这条有向边的长度,单位为米。 - -## 语法 - -```sql -H3_EXACT_EDGE_LENGTH_M(h3) -``` - -## 示例 - -```sql -SELECT H3_EXACT_EDGE_LENGTH_M(1319695429381652479); - -┌─────────────────────────────────────────────┐ -│ h3_exact_edge_length_m(1319695429381652479) │ -├─────────────────────────────────────────────┤ -│ 8267.326832647143 │ -└─────────────────────────────────────────────┘ +--- +title: H3_EXACT_EDGE_LENGTH_M +--- + +计算此有向边(Directed Edge)的长度,单位为米。 + +## 语法 + +```sql +H3_EXACT_EDGE_LENGTH_M(h3) +``` + +## 示例 + +```sql +SELECT H3_EXACT_EDGE_LENGTH_M(1319695429381652479); + +┌─────────────────────────────────────────────┐ +│ h3_exact_edge_length_m(1319695429381652479) │ +├─────────────────────────────────────────────┤ +│ 8267.326832647143 │ +└─────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-rads.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-rads.md similarity index 63% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-rads.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-rads.md index 08821d7f89..19ec8faa4f 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-exact-edge-length-rads.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-exact-edge-length-rads.md @@ -1,23 +1,23 @@ ---- -title: H3_EXACT_EDGE_LENGTH_RADS ---- - -计算这条有向边的长度,单位为弧度。 - -## 语法 - -```sql -H3_EXACT_EDGE_LENGTH_RADS(h3) -``` - -## 示例 - -```sql -SELECT H3_EXACT_EDGE_LENGTH_KM(1319695429381652479); - -┌──────────────────────────────────────────────┐ -│ h3_exact_edge_length_km(1319695429381652479) │ -├──────────────────────────────────────────────┤ -│ 8.267326832647143 │ -└──────────────────────────────────────────────┘ +--- +title: H3_EXACT_EDGE_LENGTH_RADS +--- + +计算此有向边的长度,单位为弧度。 + +## 语法 + +```sql +H3_EXACT_EDGE_LENGTH_RADS(h3) +``` + +## 示例 + +```sql +SELECT H3_EXACT_EDGE_LENGTH_RADS(1319695429381652479); + +┌─────────────────────────────────────────────────┐ +│ h3_exact_edge_length_rads(1319695429381652479) │ +├─────────────────────────────────────────────────┤ +│ 0.001297649871707212 │ +└─────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-base-cell.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-base-cell.md similarity index 85% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-base-cell.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-base-cell.md index ed90386506..250f58b45c 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-base-cell.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-base-cell.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_BASE_CELL ---- - -返回给定 [H3](https://eng.uber.com/h3/) 索引的基本单元格编号。 - -## 语法 - -```sql -H3_GET_BASE_CELL(h3) -``` - -## 示例 - -```sql -SELECT H3_GET_BASE_CELL(644325524701193974); - -┌──────────────────────────────────────┐ -│ h3_get_base_cell(644325524701193974) │ -├──────────────────────────────────────┤ -│ 8 │ -└──────────────────────────────────────┘ +--- +title: H3_GET_BASE_CELL +--- + +返回给定 [H3](https://eng.uber.com/h3/) 索引的基元格编号。 + +## 语法 + +```sql +H3_GET_BASE_CELL(h3) +``` + +## 示例 + +```sql +SELECT H3_GET_BASE_CELL(644325524701193974); + +┌──────────────────────────────────────┐ +│ h3_get_base_cell(644325524701193974) │ +├──────────────────────────────────────┤ +│ 8 │ +└──────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-destination-index-from-unidirectional-edge.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-destination-index-from-unidirectional-edge.md similarity index 93% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-destination-index-from-unidirectional-edge.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-destination-index-from-unidirectional-edge.md index e9c00b4168..6926234ac3 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-destination-index-from-unidirectional-edge.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-destination-index-from-unidirectional-edge.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE ---- - -返回从单向边缘 H3Index 的目标六边形索引。 - -## 语法 - -```sql -H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE(h3) -``` - -## 示例 - -```sql -SELECT H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE(1248204388774707199); - -┌────────────────────────────────────────────────────────────────────────┐ -│ h3_get_destination_index_from_unidirectional_edge(1248204388774707199) │ -├────────────────────────────────────────────────────────────────────────┤ -│ 599686043507097599 │ -└────────────────────────────────────────────────────────────────────────┘ +--- +title: H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE +--- + +从单向边 H3Index 返回目标六边形索引。 + +## 语法 + +```sql +H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE(h3) +``` + +## 示例 + +```sql +SELECT H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE(1248204388774707199); + +┌────────────────────────────────────────────────────────────────────────┐ +│ h3_get_destination_index_from_unidirectional_edge(1248204388774707199) │ +├────────────────────────────────────────────────────────────────────────┤ +│ 599686043507097599 │ +└────────────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-faces.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-faces.md similarity index 79% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-faces.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-faces.md index 3765fbad00..1d58281518 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-faces.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-faces.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_FACES ---- - -查找给定 [H3](https://eng.uber.com/h3/) 索引所相交的所有二十面体面。面以 0-19 的整数表示。 - -## 语法 - -```sql -H3_GET_FACES(h3) -``` - -## 示例 - -```sql -SELECT H3_GET_FACES(599119489002373119); - -┌──────────────────────────────────┐ -│ h3_get_faces(599119489002373119) │ -├──────────────────────────────────┤ -│ [0,1,2,3,4] │ -└──────────────────────────────────┘ +--- +title: H3_GET_FACES +--- + +查找与给定 [H3](https://eng.uber.com/h3/) 索引相交的所有二十面体面。面以 0–19 的整数表示。 + +## 语法 + +```sql +H3_GET_FACES(h3) +``` + +## 示例 + +```sql +SELECT H3_GET_FACES(599119489002373119); + +┌──────────────────────────────────┐ +│ h3_get_faces(599119489002373119) │ +├──────────────────────────────────┤ +│ [0,1,2,3,4] │ +└──────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-indexes-from-unidirectional-edge.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-indexes-from-unidirectional-edge.md similarity index 91% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-indexes-from-unidirectional-edge.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-indexes-from-unidirectional-edge.md index e3976ae071..cfb479328e 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-indexes-from-unidirectional-edge.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-indexes-from-unidirectional-edge.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE ---- - -从给定的单向边 H3Index 返回起始和目标六边形索引。 - -## 语法 - -```sql -H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE(h3) -``` - -## 示例 - -```sql -SELECT H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE(1248204388774707199); - -┌──────────────────────────────────────────────────────────────┐ -│ h3_get_indexes_from_unidirectional_edge(1248204388774707199) │ -├──────────────────────────────────────────────────────────────┤ -│ (599686042433355775,599686043507097599) │ -└──────────────────────────────────────────────────────────────┘ +--- +title: H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE +--- + +根据给定的单向边 H3Index(H3 索引)返回起点和终点的六边形索引。 + +## 语法 + +```sql +H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE(h3) +``` + +## 示例 + +```sql +SELECT H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE(1248204388774707199); + +┌──────────────────────────────────────────────────────────────┐ +│ h3_get_indexes_from_unidirectional_edge(1248204388774707199) │ +├──────────────────────────────────────────────────────────────┤ +│ (599686042433355775,599686043507097599) │ +└──────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-origin-index-from-unidirectional-edge.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-origin-index-from-unidirectional-edge.md similarity index 92% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-origin-index-from-unidirectional-edge.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-origin-index-from-unidirectional-edge.md index aaba4904b0..ffde253140 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-origin-index-from-unidirectional-edge.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-origin-index-from-unidirectional-edge.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE ---- - -返回单向边缘 H3Index 的起始六边形索引。 - -## 语法 - -```sql -H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE(h3) -``` - -## 示例 - -```sql -SELECT H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE(1248204388774707199); - -┌───────────────────────────────────────────────────────────────────┐ -│ h3_get_origin_index_from_unidirectional_edge(1248204388774707199) │ -├───────────────────────────────────────────────────────────────────┤ -│ 599686042433355775 │ -└───────────────────────────────────────────────────────────────────┘ +--- +title: H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE +--- + +从单向边 H3Index 返回起始六边形索引。 + +## 语法 + +```sql +H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE(h3) +``` + +## 示例 + +```sql +SELECT H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE(1248204388774707199); + +┌───────────────────────────────────────────────────────────────────┐ +│ h3_get_origin_index_from_unidirectional_edge(1248204388774707199) │ +├───────────────────────────────────────────────────────────────────┤ +│ 599686042433355775 │ +└───────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-resolution.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-resolution.md similarity index 96% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-resolution.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-resolution.md index 5eabecc35d..d9dcfa30c3 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-resolution.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-resolution.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_RESOLUTION ---- - -返回给定 [H3](https://eng.uber.com/h3/) 索引的分辨率。 - -## 语法 - -```sql -H3_GET_RESOLUTION(h3) -``` - -## 示例 - -```sql -SELECT H3_GET_RESOLUTION(644325524701193974); - -┌───────────────────────────────────────┐ -│ h3_get_resolution(644325524701193974) │ -├───────────────────────────────────────┤ -│ 15 │ -└───────────────────────────────────────┘ +--- +title: H3_GET_RESOLUTION +--- + +返回给定 [H3](https://eng.uber.com/h3/) 索引的分辨率。 + +## 语法 + +```sql +H3_GET_RESOLUTION(h3) +``` + +## 示例 + +```sql +SELECT H3_GET_RESOLUTION(644325524701193974); + +┌───────────────────────────────────────┐ +│ h3_get_resolution(644325524701193974) │ +├───────────────────────────────────────┤ +│ 15 │ +└───────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edge-boundary.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edge-boundary.md similarity index 95% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edge-boundary.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edge-boundary.md index 6bffe3de84..78e6e78cbf 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edge-boundary.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edge-boundary.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY ---- - -返回定义单向边的坐标。 - -## 语法 - -```sql -H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY(h3) -``` - -## 示例 - -```sql -SELECT H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY(1248204388774707199); - -┌─────────────────────────────────────────────────────────────────────────────────┐ -│ h3_get_unidirectional_edge_boundary(1248204388774707199) │ -├─────────────────────────────────────────────────────────────────────────────────┤ -│ [(37.42012867767778,-122.03773496427027),(37.33755608435298,-122.090428929044)] │ -└─────────────────────────────────────────────────────────────────────────────────┘ +--- +title: H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY +--- + +返回定义单向边(Unidirectional Edge)的坐标。 + +## 语法 + +```sql +H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY(h3) +``` + +## 示例 + +```sql +SELECT H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY(1248204388774707199); + +┌─────────────────────────────────────────────────────────────────────────────────┐ +│ h3_get_unidirectional_edge_boundary(1248204388774707199) │ +├─────────────────────────────────────────────────────────────────────────────────┤ +│ [(37.42012867767778,-122.03773496427027),(37.33755608435298,-122.090428929044)] │ +└─────────────────────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edge.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edge.md similarity index 92% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edge.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edge.md index 90ca64b7a1..f8f586fb88 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edge.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edge.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_UNIDIRECTIONAL_EDGE ---- - -返回给定两个 [H3](https://eng.uber.com/h3/) 索引之间的边。 - -## 语法 - -```sql -H3_GET_UNIDIRECTIONAL_EDGE(h3, a_h3) -``` - -## 示例 - -```sql -SELECT H3_GET_UNIDIRECTIONAL_EDGE(644325524701193897, 644325524701193754); - -┌────────────────────────────────────────────────────────────────────┐ -│ h3_get_unidirectional_edge(644325524701193897, 644325524701193754) │ -├────────────────────────────────────────────────────────────────────┤ -│ 1581074247194257065 │ -└────────────────────────────────────────────────────────────────────┘ +--- +title: H3_GET_UNIDIRECTIONAL_EDGE +--- + +返回两个给定 [H3](https://eng.uber.com/h3/) 索引之间的边。 + +## 语法 + +```sql +H3_GET_UNIDIRECTIONAL_EDGE(h3, a_h3) +``` + +## 示例 + +```sql +SELECT H3_GET_UNIDIRECTIONAL_EDGE(644325524701193897, 644325524701193754); + +┌────────────────────────────────────────────────────────────────────┐ +│ h3_get_unidirectional_edge(644325524701193897, 644325524701193754) │ +├────────────────────────────────────────────────────────────────────┤ +│ 1581074247194257065 │ +└────────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edges-from-hexagon.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edges-from-hexagon.md similarity index 95% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edges-from-hexagon.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edges-from-hexagon.md index e2dcbaa79a..f9202d5a71 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-get-unidirectional-edges-from-hexagon.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-get-unidirectional-edges-from-hexagon.md @@ -1,23 +1,23 @@ ---- -title: H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON ---- - -返回从提供的 H3Index 中获取的所有单向边。 - -## 语法 - -```sql -H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON(h3) -``` - -## 示例 - -```sql -SELECT H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON(644325524701193754); - -┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ -│ h3_get_unidirectional_edges_from_hexagon(644325524701193754) │ -├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ -│ [1292843871042545178,1364901465080473114,1436959059118401050,1509016653156328986,1581074247194256922,1653131841232184858] │ -└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ +--- +title: H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON +--- + +返回给定 H3 索引的所有单向边(Unidirectional Edge)。 + +## 语法 + +```sql +H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON(h3) +``` + +## 示例 + +```sql +SELECT H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON(644325524701193754); + +┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ +│ h3_get_unidirectional_edges_from_hexagon(644325524701193754) │ +├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ +│ [1292843871042545178,1364901465080473114,1436959059118401050,1509016653156328986,1581074247194256922,1653131841232184858] │ +└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-area-km2.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-area-km2.md similarity index 76% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-area-km2.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-area-km2.md index c128b9d6c7..2058a1ada6 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-area-km2.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-area-km2.md @@ -1,23 +1,23 @@ ---- -title: H3_HEX_AREA_KM2 ---- - -返回给定分辨率下六边形的平均面积,单位为平方公里。不包括五边形。 - -## 语法 - -```sql -H3_HEX_AREA_KM2(res) -``` - -## 示例 - -```sql -SELECT H3_HEX_AREA_KM2(1); - -┌────────────────────┐ -│ h3_hex_area_km2(1) │ -├────────────────────┤ -│ 609788.4417941332 │ -└────────────────────┘ +--- +title: H3_HEX_AREA_KM2 +--- + +返回指定分辨率(resolution)下平均六边形面积,单位为平方公里。不包含五边形。 + +## 语法 + +```sql +H3_HEX_AREA_KM2(res) +``` + +## 示例 + +```sql +SELECT H3_HEX_AREA_KM2(1); + +┌────────────────────┐ +│ h3_hex_area_km2(1) │ +├────────────────────┤ +│ 609788.4417941332 │ +└────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-area-m2.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-area-m2.md similarity index 75% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-area-m2.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-area-m2.md index d33514c1e0..be72a5b5b2 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-area-m2.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-area-m2.md @@ -1,23 +1,23 @@ ---- -title: H3_HEX_AREA_M2 ---- - -返回给定分辨率下六边形的平均面积,单位为平方米。不包括五边形。 - -## 语法 - -```sql -H3_HEX_AREA_M2(res) -``` - -## 示例 - -```sql -SELECT H3_HEX_AREA_M2(1); - -┌───────────────────┐ -│ h3_hex_area_m2(1) │ -├───────────────────┤ -│ 609788441794.1339 │ -└───────────────────┘ +--- +title: H3_HEX_AREA_M2 +--- + +返回指定分辨率(resolution)下六边形的平均面积,单位为平方米。不包含五边形。 + +## 语法 + +```sql +H3_HEX_AREA_M2(res) +``` + +## 示例 + +```sql +SELECT H3_HEX_AREA_M2(1); + +┌───────────────────┐ +│ h3_hex_area_m2(1) │ +├───────────────────┤ +│ 609788441794.1339 │ +└───────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-ring.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-ring.md similarity index 95% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-ring.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-ring.md index abd32d4e62..9661de7666 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-hex-ring.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-hex-ring.md @@ -1,23 +1,23 @@ ---- -title: H3_HEX_RING ---- - -返回距离给定 [H3](https://eng.uber.com/h3/) 索引恰好为网格距离 `k` 的六边形“空心”环。 - -## 语法 - -```sql -H3_HEX_RING(h3, k) -``` - -## 示例 - -```sql -SELECT H3_HEX_RING(599686042433355775, 2); - -┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ -│ h3_hex_ring(599686042433355775, 2) │ -├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ -│ [599686018811035647,599686034917163007,599686029548453887,599686032769679359,599686198125920255,599686040285872127,599686041359613951,599686039212130303,599686023106002943,599686027400970239,599686013442326527,599686012368584703] │ -└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ +--- +title: H3_HEX_RING +--- + +返回与给定 [H3](https://eng.uber.com/h3/) 索引的网格距离恰好为 `k` 的“空心”六边形环。 + +## 语法 + +```sql +H3_HEX_RING(h3, k) +``` + +## 示例 + +```sql +SELECT H3_HEX_RING(599686042433355775, 2); + +┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ +│ h3_hex_ring(599686042433355775, 2) │ +├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ +│ [599686018811035647,599686034917163007,599686029548453887,599686032769679359,599686198125920255,599686040285872127,599686041359613951,599686039212130303,599686023106002943,599686027400970239,599686013442326527,599686012368584703] │ +└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-indexes-are-neighbors.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-indexes-are-neighbors.md similarity index 91% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-indexes-are-neighbors.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-indexes-are-neighbors.md index 96564378c1..cedf904430 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-indexes-are-neighbors.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-indexes-are-neighbors.md @@ -1,23 +1,23 @@ ---- -title: H3_INDEXES_ARE_NEIGHBORS ---- - -判断提供的 [H3](https://eng.uber.com/h3/) 索引是否为邻居。 - -## 语法 - -```sql -H3_INDEXES_ARE_NEIGHBORS(h3, a_h3) -``` - -## 示例 - -```sql -SELECT H3_INDEXES_ARE_NEIGHBORS(644325524701193974, 644325524701193897); - -┌──────────────────────────────────────────────────────────────────┐ -│ h3_indexes_are_neighbors(644325524701193974, 644325524701193897) │ -├──────────────────────────────────────────────────────────────────┤ -│ true │ -└──────────────────────────────────────────────────────────────────┘ +--- +title: H3_INDEXES_ARE_NEIGHBORS +--- + +返回所提供的 [H3](https://eng.uber.com/h3/) 索引是否为相邻索引。 + +## 语法 + +```sql +H3_INDEXES_ARE_NEIGHBORS(h3, a_h3) +``` + +## 示例 + +```sql +SELECT H3_INDEXES_ARE_NEIGHBORS(644325524701193974, 644325524701193897); + +┌──────────────────────────────────────────────────────────────────┐ +│ h3_indexes_are_neighbors(644325524701193974, 644325524701193897) │ +├──────────────────────────────────────────────────────────────────┤ +│ true │ +└──────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-pentagon.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-pentagon.md similarity index 92% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-pentagon.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-pentagon.md index fe19c54d8f..a9fd687968 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-pentagon.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-pentagon.md @@ -1,23 +1,23 @@ ---- -title: H3_IS_PENTAGON ---- - -检查给定的 [H3](https://eng.uber.com/h3/) 索引是否表示一个五边形单元格。 - -## 语法 - -```sql -H3_IS_PENTAGON(h3) -``` - -## 示例 - -```sql -SELECT H3_IS_PENTAGON(599119489002373119); - -┌────────────────────────────────────┐ -│ h3_is_pentagon(599119489002373119) │ -├────────────────────────────────────┤ -│ true │ -└────────────────────────────────────┘ +--- +title: H3_IS_PENTAGON +--- + +检查给定的 [H3](https://eng.uber.com/h3/) 索引是否表示一个五边形单元。 + +## 语法 + +```sql +H3_IS_PENTAGON(h3) +``` + +## 示例 + +```sql +SELECT H3_IS_PENTAGON(599119489002373119); + +┌────────────────────────────────────┐ +│ h3_is_pentagon(599119489002373119) │ +├────────────────────────────────────┤ +│ true │ +└────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-res-class-iii.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-res-class-iii.md similarity index 97% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-res-class-iii.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-res-class-iii.md index 60f352e709..a3f843b6eb 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-res-class-iii.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-res-class-iii.md @@ -1,23 +1,23 @@ ---- -title: H3_IS_RES_CLASS_III ---- - -检查给定的 [H3](https://eng.uber.com/h3/) 索引是否具有 Class III 方向的分辨率。 - -## 语法 - -```sql -H3_IS_RES_CLASS_III(h3) -``` - -## 示例 - -```sql -SELECT H3_IS_RES_CLASS_III(635318325446452991); - -┌─────────────────────────────────────────┐ -│ h3_is_res_class_iii(635318325446452991) │ -├─────────────────────────────────────────┤ -│ true │ -└─────────────────────────────────────────┘ +--- +title: H3_IS_RES_CLASS_III +--- + +检查给定的 [H3](https://eng.uber.com/h3/) 索引是否具有 Class III 方向的分辨率。 + +## 语法 + +```sql +H3_IS_RES_CLASS_III(h3) +``` + +## 示例 + +```sql +SELECT H3_IS_RES_CLASS_III(635318325446452991); + +┌─────────────────────────────────────────┐ +│ h3_is_res_class_iii(635318325446452991) │ +├─────────────────────────────────────────┤ +│ true │ +└─────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-valid.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-valid.md similarity index 85% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-valid.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-valid.md index 77dde9ef10..5ce0d9c265 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-is-valid.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-is-valid.md @@ -1,23 +1,23 @@ ---- -title: H3_IS_VALID ---- - -检查给定的 [H3](https://eng.uber.com/h3/) 索引是否有效。 - -## 语法 - -```sql -H3_IS_VALID(h3) -``` - -## 示例 - -```sql -SELECT H3_IS_VALID(644325524701193974); - -┌─────────────────────────────────┐ -│ h3_is_valid(644325524701193974) │ -├─────────────────────────────────┤ -│ true │ -└─────────────────────────────────┘ +--- +title: H3_IS_VALID +--- + +检查给定的 [H3](https://eng.uber.com/h3/) 索引(Index)是否有效。 + +## 语法 + +```sql +H3_IS_VALID(h3) +``` + +## 示例 + +```sql +SELECT H3_IS_VALID(644325524701193974); + +┌─────────────────────────────────┐ +│ h3_is_valid(644325524701193974) │ +├─────────────────────────────────┤ +│ true │ +└─────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-k-ring.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-k-ring.md similarity index 90% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-k-ring.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-k-ring.md index 2a80b723f6..d1c8d6bca2 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-k-ring.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-k-ring.md @@ -1,23 +1,23 @@ ---- -title: H3_K_RING ---- - -返回一个包含围绕输入 H3 索引的 k-环六边形 [H3](https://eng.uber.com/h3/) 索引的数组。该数组中的每个元素都是一个 H3 索引。 - -## 语法 - -```sql -H3_K_RING(h3, k) -``` - -## 示例 - -```sql -SELECT H3_K_RING(644325524701193974, 1); - -┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ -│ h3_k_ring(644325524701193974, 1) │ -├────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ -│ [644325524701193974,644325524701193899,644325524701193869,644325524701193970,644325524701193968,644325524701193972,644325524701193897] │ -└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ +--- +title: H3_K_RING +--- + +返回一个数组,其中包含围绕输入 H3 索引的 k-ring 六边形的 [H3](https://eng.uber.com/h3/) 索引。此数组中的每个元素都是一个 H3 索引。 + +## 语法 + +```sql +H3_K_RING(h3, k) +``` + +## 示例 + +```sql +SELECT H3_K_RING(644325524701193974, 1); + +┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ +│ h3_k_ring(644325524701193974, 1) │ +├────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ +│ [644325524701193974,644325524701193899,644325524701193869,644325524701193970,644325524701193968,644325524701193972,644325524701193897] │ +└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-line.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-line.md similarity index 87% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-line.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-line.md index 8b0e149104..44e97f095c 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-line.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-line.md @@ -1,23 +1,23 @@ ---- -title: H3_LINE ---- - -返回两个给定 [H3](https://eng.uber.com/h3/) 索引之间的索引线。 - -## 语法 - -```sql -H3_LINE(h3, a_h3) -``` - -## 示例 - -```sql -SELECT H3_LINE(599119489002373119, 599119491149856767); - -┌─────────────────────────────────────────────────┐ -│ h3_line(599119489002373119, 599119491149856767) │ -├─────────────────────────────────────────────────┤ -│ [599119489002373119,599119491149856767] │ -└─────────────────────────────────────────────────┘ +--- +title: H3_LINE +--- + +返回两个给定 [H3](https://eng.uber.com/h3/) 索引(Index)之间的索引线。 + +## 语法 + +```sql +H3_LINE(h3, a_h3) +``` + +## 示例 + +```sql +SELECT H3_LINE(599119489002373119, 599119491149856767); + +┌─────────────────────────────────────────────────┐ +│ h3_line(599119489002373119, 599119491149856767) │ +├─────────────────────────────────────────────────┤ +│ [599119489002373119,599119491149856767] │ +└─────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-num-hexagons.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-num-hexagons.md similarity index 78% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-num-hexagons.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-num-hexagons.md index bbc218043c..10201bcb16 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-num-hexagons.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-num-hexagons.md @@ -1,23 +1,23 @@ ---- -title: H3_NUM_HEXAGONS ---- - -返回给定分辨率下唯一 [H3](https://eng.uber.com/h3/) 索引的数量。 - -## 语法 - -```sql -H3_NUM_HEXAGONS(res) -``` - -## 示例 - -```sql -SELECT H3_NUM_HEXAGONS(10); - -┌─────────────────────┐ -│ h3_num_hexagons(10) │ -├─────────────────────┤ -│ 33897029882 │ -└─────────────────────┘ +--- +title: H3_NUM_HEXAGONS +--- + +返回给定分辨率(resolution)下的唯一 [H3](https://eng.uber.com/h3/) 索引(indexes)数量。 + +## 语法 + +```sql +H3_NUM_HEXAGONS(res) +``` + +## 示例 + +```sql +SELECT H3_NUM_HEXAGONS(10); + +┌─────────────────────┐ +│ h3_num_hexagons(10) │ +├─────────────────────┤ +│ 33897029882 │ +└─────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-center-child.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-center-child.md similarity index 97% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-center-child.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-center-child.md index 954387d2c6..9b43d75d28 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-center-child.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-center-child.md @@ -1,23 +1,23 @@ ---- -title: H3_TO_CENTER_CHILD ---- - -返回指定分辨率下的中心子索引。 - -## 语法 - -```sql -H3_TO_CENTER_CHILD(h3, res) -``` - -## 示例 - -```sql -SELECT H3_TO_CENTER_CHILD(599119489002373119, 15); - -┌────────────────────────────────────────────┐ -│ h3_to_center_child(599119489002373119, 15) │ -├────────────────────────────────────────────┤ -│ 644155484202336256 │ -└────────────────────────────────────────────┘ +--- +title: H3_TO_CENTER_CHILD +--- + +返回指定分辨率下的中心子索引。 + +## 语法 + +```sql +H3_TO_CENTER_CHILD(h3, res) +``` + +## 示例 + +```sql +SELECT H3_TO_CENTER_CHILD(599119489002373119, 15); + +┌────────────────────────────────────────────┐ +│ h3_to_center_child(599119489002373119, 15) │ +├────────────────────────────────────────────┤ +│ 644155484202336256 │ +└────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-children.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-children.md similarity index 95% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-children.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-children.md index 683b2f4f5d..3fb8f98465 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-children.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-children.md @@ -1,23 +1,23 @@ ---- -title: H3_TO_CHILDREN ---- - -返回 `h3` 在分辨率 `child_res` 下包含的索引。 - -## 语法 - -```sql -H3_TO_CHILDREN(h3, child_res) -``` - -## 示例 - -```sql -SELECT H3_TO_CHILDREN(635318325446452991, 14); - -┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ -│ h3_to_children(635318325446452991, 14) │ -├────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ -│ [639821925073823431,639821925073823439,639821925073823447,639821925073823455,639821925073823463,639821925073823471,639821925073823479] │ -└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ +--- +title: H3_TO_CHILDREN +--- + +返回在分辨率 `child_res` 下由 `h3` 包含的所有索引。 + +## 语法 + +```sql +H3_TO_CHILDREN(h3, child_res) +``` + +## 示例 + +```sql +SELECT H3_TO_CHILDREN(635318325446452991, 14); + +┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ +│ h3_to_children(635318325446452991, 14) │ +├────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ +│ [639821925073823431,639821925073823439,639821925073823447,639821925073823455,639821925073823463,639821925073823471,639821925073823479] │ +└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-geo-boundary.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-geo-boundary.md similarity index 95% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-geo-boundary.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-geo-boundary.md index dbde25e780..1ac2616e49 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-geo-boundary.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-geo-boundary.md @@ -1,23 +1,23 @@ ---- -title: H3_TO_GEO_BOUNDARY ---- - -返回一个数组,包含与 [H3](https://eng.uber.com/h3/) 索引对应的六边形顶点的经纬度坐标。 - -## 语法 - -```sql -H3_TO_GEO_BOUNDARY(h3) -``` - -## 示例 - -```sql -SELECT H3_TO_GEO_BOUNDARY(644325524701193974); - -┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ -│ h3_to_geo_boundary(644325524701193974) │ -├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ -│ [(37.79505811173477,55.712900225355526),(37.79506506997187,55.71289713485417),(37.795073126539855,55.71289934095484),(37.795074224871684,55.71290463755745),(37.79506726663349,55.71290772805916),(37.79505921006456,55.712905521957914)] │ -└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ +--- +title: H3_TO_GEO_BOUNDARY +--- + +返回一个数组,其中包含与 [H3](https://eng.uber.com/h3/) 索引对应的六边形顶点的经纬度坐标。 + +## 语法 + +```sql +H3_TO_GEO_BOUNDARY(h3) +``` + +## 示例 + +```sql +SELECT H3_TO_GEO_BOUNDARY(644325524701193974); + +┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ +│ h3_to_geo_boundary(644325524701193974) │ +├───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ +│ [(37.79505811173477,55.712900225355526),(37.79506506997187,55.71289713485417),(37.795073126539855,55.71289934095484),(37.795074224871684,55.71290463755745),(37.79506726663349,55.71290772805916),(37.79505921006456,55.712905521957914)] │ +└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-geo.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-geo.md similarity index 84% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-geo.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-geo.md index 50f0745d2b..2e057179b8 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-geo.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-geo.md @@ -1,23 +1,23 @@ ---- -title: H3_TO_GEO ---- - -返回与给定 [H3](https://eng.uber.com/h3/) 索引相对应的经度和纬度。 - -## 语法 - -```sql -H3_TO_GEO(h3) -``` - -## 示例 - -```sql -SELECT H3_TO_GEO(644325524701193974); - -┌────────────────────────────────────────┐ -│ h3_to_geo(644325524701193974) │ -├────────────────────────────────────────┤ -│ (37.79506616830255,55.712902431456676) │ -└────────────────────────────────────────┘ +--- +title: H3_TO_GEO +--- + +返回给定 [H3](https://eng.uber.com/h3/) 索引对应的经度和纬度。 + +## 语法 + +```sql +H3_TO_GEO(h3) +``` + +## 示例 + +```sql +SELECT H3_TO_GEO(644325524701193974); + +┌────────────────────────────────────────┐ +│ h3_to_geo(644325524701193974) │ +├────────────────────────────────────────┤ +│ (37.79506616830255,55.712902431456676) │ +└────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-parent.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-parent.md similarity index 82% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-parent.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-parent.md index 0f3dd49e72..73cd0897d8 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-parent.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-parent.md @@ -1,23 +1,23 @@ ---- -title: H3_TO_PARENT ---- - -返回包含指定 `h3` 索引在 `parent_res` 分辨率下的父索引。返回 0 表示发生了错误。 - -## 语法 - -```sql -H3_TO_PARENT(h3, parent_res) -``` - -## 示例 - -```sql -SELECT H3_TO_PARENT(635318325446452991, 12); - -┌──────────────────────────────────────┐ -│ h3_to_parent(635318325446452991, 12) │ -├──────────────────────────────────────┤ -│ 630814725819082751 │ -└──────────────────────────────────────┘ +--- +title: H3_TO_PARENT +--- + +返回在分辨率 `parent_res` 下包含 `h3` 的父索引。返回 0 表示发生错误。 + +## 语法 + +```sql +H3_TO_PARENT(h3, parent_res) +``` + +## 示例 + +```sql +SELECT H3_TO_PARENT(635318325446452991, 12); + +┌──────────────────────────────────────┐ +│ h3_to_parent(635318325446452991, 12) │ +├──────────────────────────────────────┤ +│ 630814725819082751 │ +└──────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-string.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-string.md similarity index 86% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-string.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-string.md index 99fc55f2fa..94f215836a 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-to-string.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-to-string.md @@ -1,23 +1,23 @@ ---- -title: H3_TO_STRING ---- - -将给定的 [H3](https://eng.uber.com/h3/) 索引表示形式转换为字符串表示形式。 - -## 语法 - -```sql -H3_TO_STRING(h3) -``` - -## 示例 - -```sql -SELECT H3_TO_STRING(635318325446452991); - -┌──────────────────────────────────┐ -│ h3_to_string(635318325446452991) │ -├──────────────────────────────────┤ -│ 8d11aa6a38826ff │ -└──────────────────────────────────┘ +--- +title: H3_TO_STRING +--- + +将给定 [H3](https://eng.uber.com/h3/) 索引的表示形式转换为字符串表示形式。 + +## 语法 + +```sql +H3_TO_STRING(h3) +``` + +## 示例 + +```sql +SELECT H3_TO_STRING(635318325446452991); + +┌──────────────────────────────────┐ +│ h3_to_string(635318325446452991) │ +├──────────────────────────────────┤ +│ 8d11aa6a38826ff │ +└──────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-unidirectional-edge-is-valid.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-unidirectional-edge-is-valid.md similarity index 85% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-unidirectional-edge-is-valid.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-unidirectional-edge-is-valid.md index 845644d860..b7e239dd3d 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/h3-unidirectional-edge-is-valid.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/h3-unidirectional-edge-is-valid.md @@ -1,23 +1,23 @@ ---- -title: H3_UNIDIRECTIONAL_EDGE_IS_VALID ---- - -判断提供的 H3Index 是否为有效的单向边缘索引。如果是单向边缘,则返回 1,否则返回 0。 - -## 语法 - -```sql -H3_UNIDIRECTIONAL_EDGE_IS_VALID(h3) -``` - -## 示例 - -```sql -SELECT H3_UNIDIRECTIONAL_EDGE_IS_VALID(1248204388774707199); - -┌──────────────────────────────────────────────────────┐ -│ h3_unidirectional_edge_is_valid(1248204388774707199) │ -├──────────────────────────────────────────────────────┤ -│ true │ -└──────────────────────────────────────────────────────┘ +--- +title: H3_UNIDIRECTIONAL_EDGE_IS_VALID +--- + +判断提供的 H3Index 是否为有效的单向边索引(Unidirectional Edge Index)。如果是单向边,则返回 1,否则返回 0。 + +## 语法 + +```sql +H3_UNIDIRECTIONAL_EDGE_IS_VALID(h3) +``` + +## 示例 + +```sql +SELECT H3_UNIDIRECTIONAL_EDGE_IS_VALID(1248204388774707199); + +┌──────────────────────────────────────────────────────┐ +│ h3_unidirectional_edge_is_valid(1248204388774707199) │ +├──────────────────────────────────────────────────────┤ +│ true │ +└──────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/haversine.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/haversine.md new file mode 100644 index 0000000000..88a9cb2a39 --- /dev/null +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/haversine.md @@ -0,0 +1,40 @@ +--- +title: HAVERSINE +--- +import FunctionDescription from '@site/src/components/FunctionDescription'; + + + +使用 [Haversine formula(半正矢公式)](https://en.wikipedia.org/wiki/Haversine_formula) 计算地球表面两点之间的大圆距离(单位:公里)。这两个点由其纬度和经度(单位:度)指定。 + +## 语法 + +```sql +HAVERSINE(, , , ) +``` + +## 参数 + +| 参数 | 说明 | +|-----------|------------------------------------| +| `` | 第一个点的纬度。 | +| `` | 第一个点的经度。 | +| `` | 第二个点的纬度。 | +| `` | 第二个点的经度。 | + +## 返回类型 + +Double。 + +## 示例 + +```sql +SELECT + HAVERSINE(40.7127, -74.0059, 34.0500, -118.2500) AS distance + +┌────────────────┐ +│ distance │ +├────────────────┤ +│ 3936.390533556 │ +└────────────────┘ +``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/index.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/index.md new file mode 100644 index 0000000000..d0faef2899 --- /dev/null +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/index.md @@ -0,0 +1,134 @@ +--- +title: 地理空间函数 +--- + +Databend 内置两套互补的地理空间能力:PostGIS 风格的几何(Geometry)函数,用于构建与分析形状;以及 H3 实用工具,用于全球六边形索引。下表按任务对函数进行分组,方便您快速定位所需工具,布局方式与 Snowflake 文档类似。 + +## 几何构造函数 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [ST_MAKEGEOMPOINT](st-makegeompoint.md) / [ST_GEOM_POINT](st-geom-point.md) | 构造 Point(点)几何体 | `ST_MAKEGEOMPOINT(-122.35, 37.55)` → `POINT(-122.35 37.55)` | +| [ST_MAKELINE](st-makeline.md) / [ST_MAKE_LINE](st-make-line.md) | 由若干 Point 创建 LineString(线串) | `ST_MAKELINE(ST_MAKEGEOMPOINT(-122.35, 37.55), ST_MAKEGEOMPOINT(-122.40, 37.60))` → `LINESTRING(-122.35 37.55, -122.40 37.60)` | +| [ST_MAKEPOLYGON](st-makepolygon.md) | 由闭合 LineString 创建 Polygon(多边形) | `ST_MAKEPOLYGON(ST_MAKELINE(...))` → `POLYGON(...)` | +| [ST_POLYGON](st-polygon.md) | 由坐标环创建 Polygon | `ST_POLYGON(...)` → `POLYGON(...)` | + +## 几何转换 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [ST_GEOMETRYFROMTEXT](st-geometryfromtext.md) / [ST_GEOMFROMTEXT](st-geomfromtext.md) | 将 WKT 转换为几何体 | `ST_GEOMETRYFROMTEXT('POINT(-122.35 37.55)')` → `POINT(-122.35 37.55)` | +| [ST_GEOMETRYFROMWKB](st-geometryfromwkb.md) / [ST_GEOMFROMWKB](st-geomfromwkb.md) | 将 WKB 转换为几何体 | `ST_GEOMETRYFROMWKB(...)` → `POINT(...)` | +| [ST_GEOMETRYFROMEWKT](st-geometryfromewkt.md) / [ST_GEOMFROMEWKT](st-geomfromewkt.md) | 将 EWKT 转换为几何体 | `ST_GEOMETRYFROMEWKT('SRID=4326;POINT(-122.35 37.55)')` → `POINT(-122.35 37.55)` | +| [ST_GEOMETRYFROMEWKB](st-geometryfromewkb.md) / [ST_GEOMFROMEWKB](st-geomfromewkb.md) | 将 EWKB 转换为几何体 | `ST_GEOMETRYFROMEWKB(...)` → `POINT(...)` | +| [ST_GEOMFROMGEOHASH](st-geomfromgeohash.md) | 将 GeoHash 转换为几何体 | `ST_GEOMFROMGEOHASH('9q8yyk8')` → `POLYGON(...)` | +| [ST_GEOMPOINTFROMGEOHASH](st-geompointfromgeohash.md) | 将 GeoHash 转换为 Point 几何体 | `ST_GEOMPOINTFROMGEOHASH('9q8yyk8')` → `POINT(...)` | +| [TO_GEOMETRY](to-geometry.md) | 解析多种格式为几何体 | `TO_GEOMETRY('POINT(-122.35 37.55)')` → `POINT(-122.35 37.55)` | + +## 几何输出 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [ST_ASTEXT](st-astext.md) | 将几何体转换为 WKT | `ST_ASTEXT(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'POINT(-122.35 37.55)'` | +| [ST_ASWKT](st-aswkt.md) | 将几何体转换为 WKT | `ST_ASWKT(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'POINT(-122.35 37.55)'` | +| [ST_ASBINARY](st-asbinary.md) / [ST_ASWKB](st-aswkb.md) | 将几何体转换为 WKB | `ST_ASBINARY(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `WKB representation` | +| [ST_ASEWKT](st-asewkt.md) | 将几何体转换为 EWKT | `ST_ASEWKT(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'SRID=4326;POINT(-122.35 37.55)'` | +| [ST_ASEWKB](st-asewkb.md) | 将几何体转换为 EWKB | `ST_ASEWKB(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `EWKB representation` | +| [ST_ASGEOJSON](st-asgeojson.md) | 将几何体转换为 GeoJSON | `ST_ASGEOJSON(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'{"type":"Point","coordinates":[-122.35,37.55]}'` | +| [ST_GEOHASH](st-geohash.md) | 将几何体转换为 GeoHash | `ST_GEOHASH(ST_MAKEGEOMPOINT(-122.35, 37.55), 7)` → `'9q8yyk8'` | +| [TO_STRING](to-string.md) | 将几何体转换为字符串 | `TO_STRING(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `'POINT(-122.35 37.55)'` | + +## 几何访问器与属性 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [ST_DIMENSION](st-dimension.md) | 返回拓扑维度 | `ST_DIMENSION(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `0` | +| [ST_SRID](st-srid.md) | 返回几何体的 SRID | `ST_SRID(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `4326` | +| [ST_SETSRID](st-setsrid.md) | 为几何体设置 SRID | `ST_SETSRID(ST_MAKEGEOMPOINT(-122.35, 37.55), 3857)` → `POINT(-122.35 37.55)` | +| [ST_TRANSFORM](st-transform.md) | 将几何体转换到新的 SRID | `ST_TRANSFORM(ST_MAKEGEOMPOINT(-122.35, 37.55), 3857)` → `POINT(-13618288.8 4552395.0)` | +| [ST_NPOINTS](st-npoints.md) / [ST_NUMPOINTS](st-numpoints.md) | 统计几何体中的点数 | `ST_NPOINTS(ST_MAKELINE(...))` → `2` | +| [ST_POINTN](st-pointn.md) | 返回 LineString 中的指定点 | `ST_POINTN(ST_MAKELINE(...), 1)` → `POINT(-122.35 37.55)` | +| [ST_STARTPOINT](st-startpoint.md) | 返回 LineString 的起点 | `ST_STARTPOINT(ST_MAKELINE(...))` → `POINT(-122.35 37.55)` | +| [ST_ENDPOINT](st-endpoint.md) | 返回 LineString 的终点 | `ST_ENDPOINT(ST_MAKELINE(...))` → `POINT(-122.40 37.60)` | +| [ST_LENGTH](st-length.md) | 测量 LineString 的长度 | `ST_LENGTH(ST_MAKELINE(...))` → `5.57` | +| [ST_X](st-x.md) / [ST_Y](st-y.md) | 返回 Point 的 X 或 Y 坐标 | `ST_X(ST_MAKEGEOMPOINT(-122.35, 37.55))` → `-122.35` | +| [ST_XMIN](st-xmin.md) / [ST_XMAX](st-xmax.md) | 返回最小/最大 X 坐标 | `ST_XMIN(ST_MAKELINE(...))` → `-122.40` | +| [ST_YMIN](st-ymin.md) / [ST_YMAX](st-ymax.md) | 返回最小/最大 Y 坐标 | `ST_YMAX(ST_MAKELINE(...))` → `37.60` | + +## 空间关系 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [ST_CONTAINS](st-contains.md) | 测试一个几何体是否包含另一个几何体 | `ST_CONTAINS(ST_MAKEPOLYGON(...), ST_MAKEGEOMPOINT(...))` → `TRUE` | +| [POINT_IN_POLYGON](point-in-polygon.md) | 检查点是否位于多边形内部 | `POINT_IN_POLYGON([lon, lat], [[p1_lon, p1_lat], ...])` → `TRUE` | + +## 距离与测量 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [ST_DISTANCE](st-distance.md) | 测量几何体之间的距离 | `ST_DISTANCE(ST_MAKEGEOMPOINT(-122.35, 37.55), ST_MAKEGEOMPOINT(-122.40, 37.60))` → `5.57` | +| [HAVERSINE](haversine.md) | 计算坐标间的大圆距离 | `HAVERSINE(37.55, -122.35, 37.60, -122.40)` → `6.12` | + +## H3 索引与转换 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [GEO_TO_H3](geo-to-h3.md) | 将经度/纬度转换为 H3 索引 | `GEO_TO_H3(37.7950, 55.7129, 15)` → `644325524701193974` | +| [H3_TO_GEO](h3-to-geo.md) | 将 H3 索引转换为经度/纬度 | `H3_TO_GEO(644325524701193974)` → `[37.7950, 55.7129]` | +| [H3_TO_STRING](h3-to-string.md) | 将 H3 索引转换为字符串形式 | `H3_TO_STRING(644325524701193974)` → `'8f2830828052d25'` | +| [STRING_TO_H3](string-to-h3.md) | 将 H3 字符串转换为索引 | `STRING_TO_H3('8f2830828052d25')` → `644325524701193974` | +| [GEOHASH_ENCODE](geohash-encode.md) | 将经度/纬度编码为 GeoHash | `GEOHASH_ENCODE(37.7950, 55.7129, 12)` → `'ucfv0nzpt3s7'` | +| [GEOHASH_DECODE](geohash-decode.md) | 将 GeoHash 解码为经度/纬度 | `GEOHASH_DECODE('ucfv0nzpt3s7')` → `[37.7950, 55.7129]` | + +## H3 单元格属性 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [H3_GET_RESOLUTION](h3-get-resolution.md) | 返回 H3 索引的分辨率 | `H3_GET_RESOLUTION(644325524701193974)` → `15` | +| [H3_GET_BASE_CELL](h3-get-base-cell.md) | 返回基础单元格编号 | `H3_GET_BASE_CELL(644325524701193974)` → `14` | +| [H3_IS_VALID](h3-is-valid.md) | 检查 H3 索引是否有效 | `H3_IS_VALID(644325524701193974)` → `TRUE` | +| [H3_IS_PENTAGON](h3-is-pentagon.md) | 检查 H3 索引是否为五边形 | `H3_IS_PENTAGON(644325524701193974)` → `FALSE` | +| [H3_IS_RES_CLASS_III](h3-is-res-class-iii.md) | 检查 H3 索引是否为 III 类 | `H3_IS_RES_CLASS_III(644325524701193974)` → `FALSE` | +| [H3_GET_FACES](h3-get-faces.md) | 返回相交的二十面体面 | `H3_GET_FACES(644325524701193974)` → `[7]` | +| [H3_TO_PARENT](h3-to-parent.md) | 返回低一级分辨率的父索引 | `H3_TO_PARENT(644325524701193974, 10)` → `622236721289822207` | +| [H3_TO_CHILDREN](h3-to-children.md) | 返回高一级分辨率的子索引 | `H3_TO_CHILDREN(622236721289822207, 11)` → `[...]` | +| [H3_TO_CENTER_CHILD](h3-to-center-child.md) | 返回指定分辨率的中心子索引 | `H3_TO_CENTER_CHILD(622236721289822207, 11)` → `625561602857582591` | +| [H3_CELL_AREA_M2](h3-cell-area-m2.md) | 返回单元格面积(平方米) | `H3_CELL_AREA_M2(644325524701193974)` → `0.8953` | +| [H3_CELL_AREA_RADS2](h3-cell-area-rads2.md) | 返回单元格面积(平方弧度) | `H3_CELL_AREA_RADS2(644325524701193974)` → `2.2e-14` | +| [H3_HEX_AREA_KM2](h3-hex-area-km2.md) | 返回平均六边形面积(平方千米) | `H3_HEX_AREA_KM2(10)` → `0.0152` | +| [H3_HEX_AREA_M2](h3-hex-area-m2.md) | 返回平均六边形面积(平方米) | `H3_HEX_AREA_M2(10)` → `15200` | +| [H3_TO_GEO_BOUNDARY](h3-to-geo-boundary.md) | 返回单元格边界 | `H3_TO_GEO_BOUNDARY(644325524701193974)` → `[[lon1,lat1], ...]` | +| [H3_NUM_HEXAGONS](h3-num-hexagons.md) | 返回指定分辨率下的六边形数量 | `H3_NUM_HEXAGONS(2)` → `5882` | + +## H3 邻域 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [H3_DISTANCE](h3-distance.md) | 返回两个索引之间的网格距离 | `H3_DISTANCE(599119489002373119, 599119491149856767)` → `1` | +| [H3_INDEXES_ARE_NEIGHBORS](h3-indexes-are-neighbors.md) | 测试两个索引是否相邻 | `H3_INDEXES_ARE_NEIGHBORS(599119489002373119, 599119491149856767)` → `TRUE` | +| [H3_K_RING](h3-k-ring.md) | 返回 k 距离内的所有索引 | `H3_K_RING(599119489002373119, 1)` → `[599119489002373119, ...]` | +| [H3_HEX_RING](h3-hex-ring.md) | 返回恰好 k 步距离的索引 | `H3_HEX_RING(599119489002373119, 1)` → `[599119491149856767, ...]` | +| [H3_LINE](h3-line.md) | 返回路径上的索引 | `H3_LINE(from_h3, to_h3)` → `[from_h3, ..., to_h3]` | + +## H3 边操作 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [H3_GET_UNIDIRECTIONAL_EDGE](h3-get-unidirectional-edge.md) | 返回两个相邻单元格之间的边 | `H3_GET_UNIDIRECTIONAL_EDGE(from_h3, to_h3)` → `edge_index` | +| [H3_UNIDIRECTIONAL_EDGE_IS_VALID](h3-unidirectional-edge-is-valid.md) | 检查边索引是否有效 | `H3_UNIDIRECTIONAL_EDGE_IS_VALID(edge_index)` → `TRUE` | +| [H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE](h3-get-origin-index-from-unidirectional-edge.md) | 从边返回起始单元格 | `H3_GET_ORIGIN_INDEX_FROM_UNIDIRECTIONAL_EDGE(edge_index)` → `from_h3` | +| [H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE](h3-get-destination-index-from-unidirectional-edge.md) | 从边返回目标单元格 | `H3_GET_DESTINATION_INDEX_FROM_UNIDIRECTIONAL_EDGE(edge_index)` → `to_h3` | +| [H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE](h3-get-indexes-from-unidirectional-edge.md) | 返回边对应的两个单元格 | `H3_GET_INDEXES_FROM_UNIDIRECTIONAL_EDGE(edge_index)` → `[from_h3, to_h3]` | +| [H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON](h3-get-unidirectional-edges-from-hexagon.md) | 列出从单元格出发的所有边 | `H3_GET_UNIDIRECTIONAL_EDGES_FROM_HEXAGON(h3_index)` → `[edge1, edge2, ...]` | +| [H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY](h3-get-unidirectional-edge-boundary.md) | 返回边的边界 | `H3_GET_UNIDIRECTIONAL_EDGE_BOUNDARY(edge_index)` → `[[lon1,lat1], [lon2,lat2]]` | + +## H3 测量与角度 + +| 函数 | 描述 | 示例 | +|----------|-------------|---------| +| [H3_EDGE_LENGTH_KM](h3-edge-length-km.md) | 返回平均边长(千米) | `H3_EDGE_LENGTH_KM(10)` → `0.065` | +| [H3_EDGE_LENGTH_M](h3-edge-length-m.md) | 返回平均边长(米) | `H3_EDGE_LENGTH_M(10)` → `65.91` | +| [H3_EXACT_EDGE_LENGTH_KM](h3-exact-edge-length-km.md) | 返回精确边长(千米) | `H3_EXACT_EDGE_LENGTH_KM(edge_index)` → `0.066` | +| [H3_EXACT_EDGE_LENGTH_M](h3-exact-edge-length-m.md) | 返回精确边长(米) | `H3_EXACT_EDGE_LENGTH_M(edge_index)` → `66.12` | +| [H3_EXACT_EDGE_LENGTH_RADS](h3-exact-edge-length-rads.md) | 返回精确边长(弧度) | `H3_EXACT_EDGE_LENGTH_RADS(edge_index)` → `0.00001` | +| [H3_EDGE_ANGLE](h3-edge-angle.md) | 返回两条边之间的夹角(弧度) | `H3_EDGE_ANGLE(edge1, edge2)` → `1.047` | \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/point-in-polygon.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/point-in-polygon.md similarity index 79% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/point-in-polygon.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/point-in-polygon.md index 395fa44a2e..fa54068ed5 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/point-in-polygon.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/point-in-polygon.md @@ -1,23 +1,23 @@ ---- -title: POINT_IN_POLYGON ---- - -计算给定点是否位于由多个点连接形成的多边形内。多边形是由按顺序出现的坐标对连接而成的封闭形状。改变坐标对的顺序可能会形成不同的形状。 - -## 语法 - -```sql -POINT_IN_POLYGON((x,y), [(a,b), (c,d), (e,f) ... ]) -``` - -## 示例 - -```sql -SELECT POINT_IN_POLYGON((3., 3.), [(6, 0), (8, 4), (5, 8), (0, 2)]); - -┌────────────────────────────────────────────────────────────┐ -│ point_in_polygon((3, 3), [(6, 0), (8, 4), (5, 8), (0, 2)]) │ -├────────────────────────────────────────────────────────────┤ -│ 1 │ -└────────────────────────────────────────────────────────────┘ +--- +title: POINT_IN_POLYGON +--- + +判断给定点是否位于由多个点依次连接构成的多边形(Polygon)内部。多边形是由按出现顺序连接的坐标对形成的封闭图形;若改变坐标对的顺序,可能得到不同的形状。 + +## 语法 + +```sql +POINT_IN_POLYGON((x,y), [(a,b), (c,d), (e,f) ... ]) +``` + +## 示例 + +```sql +SELECT POINT_IN_POLYGON((3., 3.), [(6, 0), (8, 4), (5, 8), (0, 2)]); + +┌────────────────────────────────────────────────────────────┐ +│ point_in_polygon((3, 3), [(6, 0), (8, 4), (5, 8), (0, 2)]) │ +├────────────────────────────────────────────────────────────┤ +│ 1 │ +└────────────────────────────────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asbinary.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asbinary.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asbinary.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asbinary.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asewkb.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asewkb.md similarity index 82% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asewkb.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asewkb.md index d7a46c2c52..c184fa0d9c 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asewkb.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asewkb.md @@ -3,9 +3,9 @@ title: ST_ASEWKB --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -将一个 GEOMETRY 对象转换为 [EWKB(扩展已知二进制)](https://postgis.net/docs/ST_GeomFromEWKB.html) 格式的表示。 +将 GEOMETRY 对象转换为 [EWKB(Extended Well-Known Binary)](https://postgis.net/docs/ST_GeomFromEWKB.html) 格式表示。 ## 语法 @@ -15,13 +15,13 @@ ST_ASEWKB() ## 参数 -| 参数 | 描述 | -|--------------|--------------------------------------------------| -| `` | 参数必须是一个 GEOMETRY 类型的表达式。 | +| 参数 | 说明 | +|--------------|------------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 -二进制。 +Binary。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asewkt.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asewkt.md similarity index 84% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asewkt.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asewkt.md index 8349fcccd3..5bce9cfb55 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asewkt.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asewkt.md @@ -3,9 +3,9 @@ title: ST_ASEWKT --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -将一个 GEOMETRY 对象转换为 [EWKT(扩展已知文本)](https://postgis.net/docs/ST_GeomFromEWKT.html) 格式的表示。 +将 GEOMETRY 对象转换为 [EWKT(Extended Well-Known Text)](https://postgis.net/docs/ST_GeomFromEWKT.html) 格式的表示。 ## 语法 @@ -15,9 +15,9 @@ ST_ASEWKT() ## 参数 -| 参数 | 描述 | -|--------------|--------------------------------------------------| -| `` | 参数必须是 GEOMETRY 类型的表达式。 | +| 参数 | 描述 | +|--------------|------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asgeojson.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asgeojson.md similarity index 76% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asgeojson.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asgeojson.md index eded0fe94e..423f2f9b6a 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-asgeojson.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-asgeojson.md @@ -3,9 +3,9 @@ title: ST_ASGEOJSON --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -将一个 GEOMETRY 对象转换为 [GeoJSON](https://geojson.org/) 表示形式。 +将 GEOMETRY 对象转换为 [GeoJSON](https://geojson.org/) 表示形式。 ## 语法 @@ -15,9 +15,9 @@ ST_ASGEOJSON() ## 参数 -| 参数 | 描述 | -|--------------|------------------------------------------------| -| `` | 参数必须是一个 GEOMETRY 类型的表达式。 | +| 参数 | 描述 | +|--------------|------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-astext.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-astext.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-astext.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-astext.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-aswkb.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-aswkb.md similarity index 86% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-aswkb.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-aswkb.md index 2645625898..e5125fc2b8 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-aswkb.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-aswkb.md @@ -3,9 +3,9 @@ title: ST_ASWKB --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -将一个 GEOMETRY 对象转换为 [WKB(Well-known Binary)](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary) 格式的表示。 +将 GEOMETRY 对象转换为 [WKB(Well-Known Binary)](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary) 格式的表示。 ## 语法 @@ -19,13 +19,13 @@ ST_ASWKB() ## 参数 -| 参数 | 描述 | -|--------------|------------------------------------------------| -| `` | 参数必须是 GEOMETRY 类型的表达式。 | +| 参数 | 描述 | +|--------------|--------------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 -二进制。 +Binary。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-aswkt.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-aswkt.md similarity index 74% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-aswkt.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-aswkt.md index 0583b79aea..afefcd4853 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-aswkt.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-aswkt.md @@ -3,9 +3,9 @@ title: ST_ASWKT --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -将一个 GEOMETRY 对象转换为 [WKT(well-known-text)](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) 格式的表示。 +将 GEOMETRY 对象转换为 [WKT(Well-Known Text)](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) 格式的表示。 ## 语法 @@ -19,9 +19,9 @@ ST_ASWKT() ## 参数 -| 参数 | 描述 | -|--------------|------------------------------------------------| -| `` | 参数必须是一个 GEOMETRY 类型的表达式。 | +| 参数 | 说明 | +|--------------|----------------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-contains.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-contains.md similarity index 70% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-contains.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-contains.md index 8ae3bfd305..3c6465bd39 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-contains.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-contains.md @@ -3,7 +3,7 @@ title: ST_CONTAINS --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + 如果第二个 GEOMETRY 对象完全位于第一个 GEOMETRY 对象内部,则返回 TRUE。 @@ -15,18 +15,18 @@ ST_CONTAINS(, ) ## 参数 -| 参数 | 描述 | -|---------------|-----------------------------------------------------------------------------------------------| -| `` | 参数必须是类型为 GEOMETRY 对象的表达式,且不能是 GeometryCollection。 | -| `` | 参数必须是类型为 GEOMETRY 对象的表达式,且不能是 GeometryCollection。 | +| 参数 | 描述 | +|---------------|----------------------------------------------------------------------| +| `` | 参数必须是 GEOMETRY 对象类型的表达式,且不能是 GeometryCollection。 | +| `` | 参数必须是 GEOMETRY 对象类型的表达式,且不能是 GeometryCollection。 | :::note -- 如果两个输入的 GEOMETRY 对象具有不同的 SRID,函数会报告错误。 +- 如果两个输入的 GEOMETRY 对象具有不同的 SRID,则函数会报告错误。 ::: ## 返回类型 -布尔型。 +布尔值(Boolean)。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-dimension.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-dimension.md similarity index 78% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-dimension.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-dimension.md index ab32e82f65..245ca683f3 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-dimension.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-dimension.md @@ -3,15 +3,15 @@ title: ST_DIMENSION --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回几何对象的维度。几何对象的维度如下: +返回几何对象的维度。GEOMETRY 对象的维度如下: -| 地理空间对象类型 | 维度 | -|----------------------------|-------| -| 点 / 多点 | 0 | -| 线串 / 多线串 | 1 | -| 多边形 / 多多边形 | 2 | +| 地理空间对象类型 | 维度 | +|------------------------|------| +| Point / MultiPoint | 0 | +| LineString / MultiLineString | 1 | +| Polygon / MultiPolygon | 2 | ## 语法 @@ -21,9 +21,9 @@ ST_DIMENSION() ## 参数 -| 参数 | 描述 | -|--------------|------------------------------------------------| -| `` | 参数必须是 GEOMETRY 类型的表达式。 | +| 参数 | 描述 | +|--------------|-----------------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-distance.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-distance.md similarity index 69% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-distance.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-distance.md index 3f7ce1201f..3a956365c3 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-distance.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-distance.md @@ -3,9 +3,9 @@ title: ST_DISTANCE --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回两个 GEOMETRY 对象之间的最小 [欧几里得距离](https://en.wikipedia.org/wiki/Euclidean_distance)。 +返回两个 GEOMETRY 对象之间的最小[欧几里得距离](https://en.wikipedia.org/wiki/Euclidean_distance)。 ## 语法 @@ -15,10 +15,10 @@ ST_DISTANCE(, ) ## 参数 -| 参数 | 描述 | +| 参数 | 描述 | |---------------|-------------------------------------------------------------------------------| -| `` | 参数必须是 GEOMETRY 类型的表达式,并且必须包含一个点。 | -| `` | 参数必须是 GEOMETRY 类型的表达式,并且必须包含一个点。 | +| `` | 参数必须是 GEOMETRY 类型的表达式,并且必须包含一个点(Point)。 | +| `` | 参数必须是 GEOMETRY 类型的表达式,并且必须包含一个点(Point)。 | :::note - 如果一个或多个输入点为 NULL,则返回 NULL。 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-endpoint.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-endpoint.md similarity index 61% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-endpoint.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-endpoint.md index b02036ec32..14d5637081 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-endpoint.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-endpoint.md @@ -3,9 +3,9 @@ title: ST_ENDPOINT --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回 LineString 中的最后一个点。 +返回 LineString 的最后一个 Point。 ## 语法 @@ -15,13 +15,13 @@ ST_ENDPOINT() ## 参数 -| 参数 | 描述 | -|--------------|------------------------------------------------------------------------------------| -| `` | 参数必须是一个表示 LineString 的几何类型的 GEOMETRY 表达式。 | +| 参数 | 描述 | +|--------------|-----------------------------------------------------------------------------------| +| `` | 参数必须是表示 LineString 的 GEOMETRY 类型表达式。 | ## 返回类型 -几何类型。 +Geometry。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geohash.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geohash.md similarity index 53% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geohash.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geohash.md index f2fafdba39..ab11dc2fbf 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geohash.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geohash.md @@ -3,9 +3,9 @@ title: ST_GEOHASH --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回一个GEOMETRY对象的[geohash](https://en.wikipedia.org/wiki/Geohash)。Geohash是一个简短的base32字符串,用于标识包含世界中某个位置的测地矩形。可选的精度参数指定返回的geohash的`精度`。例如,传递5作为`精度`将返回一个较短的geohash(5个字符长),精度较低。 +返回 GEOMETRY 对象的 [geohash](https://en.wikipedia.org/wiki/Geohash)。geohash 是一个简短的 base32 字符串,用于标识地球上包含某个位置的测地矩形。可选的精度参数指定返回 geohash 的 `precision`(精度)。例如,将 `precision` 设为 5 会返回较短的 geohash(5 个字符),精度较低。 ## 语法 @@ -15,14 +15,14 @@ ST_GEOHASH( [, ]) ## 参数 -| 参数 | 描述 | -|-----------------|----------------------------------------------------------------------| -| `geometry` | 参数必须是GEOMETRY类型的表达式。 | -| `[precision]` | 可选。指定返回的geohash的精度,默认值为12。 | +| 参数 | 描述 | +|---|---| +| `geometry` | 参数必须是 GEOMETRY 类型的表达式。 | +| `[precision]` | 可选。指定返回 geohash 的精度,默认为 12。 | ## 返回类型 -字符串。 +String。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geom-point.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geom-point.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geom-point.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geom-point.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromewkb.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromewkb.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromewkb.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromewkb.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromewkt.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromewkt.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromewkt.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromewkt.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromtext.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromtext.md new file mode 100644 index 0000000000..7568d765ac --- /dev/null +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromtext.md @@ -0,0 +1,5 @@ +--- +title: ST_GEOMETRYFROMTEXT +--- + +[ST_GEOMETRYFROMWKT](st-geometryfromwkt.md) 的别名。 \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromwkb.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromwkb.md similarity index 65% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromwkb.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromwkb.md index d1a206e75d..b66455bbfb 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromwkb.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromwkb.md @@ -3,9 +3,9 @@ title: ST_GEOMETRYFROMWKB --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -解析一个[WKB(well-known-binary)](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary)或[EWKB(extended well-known-binary)](https://postgis.net/docs/ST_GeomFromEWKB.html)输入,并返回一个GEOMETRY类型的值。 +解析 [WKB(Well-Known Binary)](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary) 或 [EWKB(Extended Well-Known Binary)](https://postgis.net/docs/ST_GeomFromEWKB.html) 输入,并返回 GEOMETRY 类型的值。 ## 语法 @@ -22,15 +22,15 @@ ST_GEOMETRYFROMWKB(, []) ## 参数 -| 参数 | 描述 | -|-------------|----------------------------------------------------------------------| -| `` | 参数必须是一个十六进制格式的WKB或EWKB字符串表达式。 | -| `` | 参数必须是一个WKB或EWKB格式的二进制表达式。 | -| `` | 要使用的SRID的整数值。 | +| 参数 | 描述 | +|---|---| +| `` | 参数必须是十六进制格式的 WKB 或 EWKB 字符串表达式。 | +| `` | 参数必须是 WKB 或 EWKB 格式的二进制表达式。 | +| `` | 要使用的 SRID 整数值。 | ## 返回类型 -Geometry. +Geometry。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromwkt.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromwkt.md similarity index 76% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromwkt.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromwkt.md index ddc7fa1d07..a16f034a87 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geometryfromwkt.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geometryfromwkt.md @@ -3,9 +3,9 @@ title: ST_GEOMETRYFROMWKT --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -解析 [WKT(well-known-text)](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) 或 [EWKT(extended well-known-text)](https://postgis.net/docs/ST_GeomFromEWKT.html) 输入,并返回 GEOMETRY 类型的值。 +解析 [WKT(Well-Known Text)](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) 或 [EWKT(Extended Well-Known Text)](https://postgis.net/docs/ST_GeomFromEWKT.html) 输入,并返回 GEOMETRY 类型的值。 ## 语法 @@ -23,9 +23,9 @@ ST_GEOMETRYFROMWKT(, []) ## 参数 -| 参数 | 描述 | +| 参数 | 说明 | |-------------|-----------------------------------------------------------------| -| `` | 该参数必须是一个 WKT 或 EWKT 格式的字符串表达式。 | +| `` | 参数必须是 WKT 或 EWKT 格式的字符串表达式。 | | `` | 要使用的 SRID 的整数值。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromewkb.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromewkb.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromewkb.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromewkb.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromewkt.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromewkt.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromewkt.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromewkt.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromgeohash.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromgeohash.md similarity index 88% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromgeohash.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromgeohash.md index d4e9b4fb93..7044886e8d 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromgeohash.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromgeohash.md @@ -3,9 +3,9 @@ title: ST_GEOMFROMGEOHASH --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回一个表示 [geohash](https://en.wikipedia.org/wiki/Geohash) 边界的多边形的 GEOMETRY 对象。 +返回一个 GEOMETRY 对象,该对象为代表 [geohash](https://en.wikipedia.org/wiki/Geohash) 边界的多边形。 ## 语法 @@ -15,9 +15,9 @@ ST_GEOMFROMGEOHASH() ## 参数 -| 参数 | 描述 | -|-------------|--------------------------| -| `` | 参数必须是一个 geohash。 | +| 参数 | 描述 | +|-------------|---------------------------------| +| `` | 参数必须是 geohash。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromtext.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromtext.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromtext.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromtext.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromwkb.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromwkb.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromwkb.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromwkb.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromwkt.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromwkt.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geomfromwkt.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geomfromwkt.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geompointfromgeohash.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geompointfromgeohash.md similarity index 72% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geompointfromgeohash.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geompointfromgeohash.md index db39f2a048..10dbda0772 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-geompointfromgeohash.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-geompointfromgeohash.md @@ -3,9 +3,9 @@ title: ST_GEOMPOINTFROMGEOHASH --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回一个表示 [geohash](https://en.wikipedia.org/wiki/Geohash) 中心点的 GEOMETRY 对象。 +返回一个 GEOMETRY 对象,该对象表示 [geohash](https://en.wikipedia.org/wiki/Geohash) 中心点的几何形状。 ## 语法 @@ -15,9 +15,9 @@ ST_GEOMPOINTFROMGEOHASH() ## 参数 -| 参数 | 描述 | -|-------------|--------------------------| -| `` | 参数必须是一个 geohash。| +| 参数 | 描述 | +|-------------|---------------------------------| +| `` | 参数必须是一个 geohash。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-length.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-length.md similarity index 63% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-length.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-length.md index df95218634..ddac8aaeae 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-length.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-length.md @@ -3,9 +3,9 @@ title: ST_LENGTH --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回GEOMETRY对象中LineString的几何长度。 +返回 GEOMETRY 对象中 LineString 的欧几里得长度。 ## 语法 @@ -15,13 +15,13 @@ ST_LENGTH() ## 参数 -| 参数 | 描述 | -|--------------|---------------------------------------------------------------------| -| `` | 参数必须是包含linestrings的GEOMETRY类型的表达式。 | +| 参数 | 描述 | +|--------------|-----------------------------------------------------------------------------| +| `` | 参数必须是包含线串(linestrings)的 GEOMETRY 类型表达式。 | :::note -- 如果``不是`LineString`、`MultiLineString`或包含linestrings的`GeometryCollection`,则返回0。 -- 如果``是`GeometryCollection`,则返回集合中所有linestrings长度的总和。 +- 如果 `` 不是 `LineString`、`MultiLineString` 或包含线串(linestrings)的 `GeometryCollection`,则返回 0。 +- 如果 `` 是一个 `GeometryCollection`,则返回集合中所有线串(linestrings)的长度之和。 ::: ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-make-line.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-make-line.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-make-line.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-make-line.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makegeompoint.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makegeompoint.md similarity index 71% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makegeompoint.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makegeompoint.md index c3397744a5..074060ae87 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makegeompoint.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makegeompoint.md @@ -3,9 +3,9 @@ title: ST_MAKEGEOMPOINT --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -构造一个表示具有指定经度和纬度的点的 GEOMETRY 对象。 +构造一个 GEOMETRY 对象,表示具有指定经度(longitude)和纬度(latitude)的点(Point)。 ## 语法 @@ -19,10 +19,10 @@ ST_MAKEGEOMPOINT(, ) ## 参数 -| 参数 | 描述 | -|---------------|----------------------------------------| -| `` | 表示经度的 Double 值。 | -| `` | 表示纬度的 Double 值。 | +| 参数 | 描述 | +|---------------|------------------------------------| +| `` | 表示经度的 Double 值。 | +| `` | 表示纬度的 Double 值。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makeline.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makeline.md similarity index 65% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makeline.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makeline.md index 592698b750..244cc238cc 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makeline.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makeline.md @@ -3,9 +3,9 @@ title: ST_MAKELINE --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -构造一个表示连接输入的两个GEOMETRY对象中点的线的GEOMETRY对象。 +构造一个 GEOMETRY(几何对象),表示连接输入的两个 GEOMETRY(几何对象)中各点的线。 ## 语法 @@ -19,14 +19,14 @@ ST_MAKELINE(, ) ## 参数 -| 参数 | 描述 | -|---------------|-------------------------------------------------------------------------------------------------------------| -| `` | 包含要连接点的GEOMETRY对象。该对象必须是Point、MultiPoint或LineString。 | -| `` | 包含要连接点的GEOMETRY对象。该对象必须是Point、MultiPoint或LineString。 | +| 参数 | 描述 | +|---------------|--------------------------------------------------------------------------------------------------| +| `` | 一个包含要连接点的 GEOMETRY(几何对象)。该对象必须是 Point(点)、MultiPoint(多点)或 LineString(线串)。 | +| `` | 一个包含要连接点的 GEOMETRY(几何对象)。该对象必须是 Point(点)、MultiPoint(多点)或 LineString(线串)。 | ## 返回类型 -Geometry. +Geometry(几何对象)。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makepolygon.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makepolygon.md similarity index 67% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makepolygon.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makepolygon.md index 7c7ed9553f..674fa71176 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-makepolygon.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-makepolygon.md @@ -3,9 +3,9 @@ title: ST_MAKEPOLYGON --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -构造一个表示无孔多边形的GEOMETRY对象。该函数使用指定的LineString作为外部环。 +构造一个表示无孔多边形(Polygon)的 GEOMETRY(几何类型)对象。该函数使用指定的线串(LineString)作为外环。 ## 语法 @@ -19,13 +19,13 @@ ST_MAKEPOLYGON() ## 参数 -| 参数 | 描述 | -|--------------|--------------------------------------------------| -| `` | 参数必须是一个GEOMETRY类型的表达式。 | +| 参数 | 说明 | +|--------------|------------------------------------------------------| +| `` | 参数必须是 GEOMETRY(几何类型)类型的表达式。 | ## 返回类型 -Geometry. +Geometry(几何类型)。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-npoints.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-npoints.md similarity index 84% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-npoints.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-npoints.md index 6f2350fa1e..21b708d1d5 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-npoints.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-npoints.md @@ -3,9 +3,9 @@ title: ST_NPOINTS --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回一个 GEOMETRY 对象中的点数。 +返回 GEOMETRY 对象中的点数。 ## 语法 @@ -19,8 +19,8 @@ ST_NPOINTS() ## 参数 -| 参数 | 描述 | -|--------------|-------------------------------------------------------------| +| 参数 | 描述 | +|--------------|----------------------------------------| | `` | 参数必须是 GEOMETRY 对象类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-numpoints.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-numpoints.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-numpoints.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-numpoints.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-pointn.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-pointn.md similarity index 62% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-pointn.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-pointn.md index faeab953f3..d547c8d58b 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-pointn.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-pointn.md @@ -3,9 +3,9 @@ title: ST_POINTN --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回 LineString 中指定索引处的点。 +返回 LineString(线串)中指定索引处的 Point(点)。 ## 语法 @@ -15,18 +15,18 @@ ST_POINTN(, ) ## 参数 -| 参数 | 描述 | +| 参数 | 描述 | |--------------|-----------------------------------------------------------------------------------| -| `` | 参数必须是表示 LineString 的几何类型(GEOMETRY)的表达式。 | -| `` | 要返回的点的索引。 | +| `` | 参数必须是 GEOMETRY 类型的表达式,表示一个 LineString(线串)。 | +| `` | 要返回的 Point(点)的索引。 | :::note -索引是从1开始的,负索引表示从 LineString 末尾开始的偏移量。如果索引超出范围,函数将返回错误。 +索引从 1 开始,负索引表示从 LineString(线串)末尾开始的偏移量。如果索引越界,函数将返回错误。 ::: ## 返回类型 -几何类型(Geometry)。 +Geometry。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-polygon.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-polygon.md similarity index 100% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-polygon.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-polygon.md diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-srid.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-srid.md similarity index 81% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-srid.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-srid.md index fe9676f1ca..8c9b85948f 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-srid.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-srid.md @@ -3,9 +3,9 @@ title: ST_SRID --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回一个 GEOMETRY 对象的 SRID(空间参考系统标识符)。 +返回 GEOMETRY 对象的 SRID(Spatial Reference System Identifier,空间参考系统标识符)。 ## 语法 @@ -15,9 +15,9 @@ ST_SRID() ## 参数 -| 参数 | 描述 | -|--------------|--------------------------------------------------| -| `` | 参数必须是 GEOMETRY 类型的表达式。 | +| 参数 | 描述 | +|--------------|------------------------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-startpoint.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-startpoint.md similarity index 62% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-startpoint.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-startpoint.md index 66d36afe56..758e10ad82 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-startpoint.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-startpoint.md @@ -3,9 +3,9 @@ title: ST_STARTPOINT --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回 LineString 中的第一个点。 +返回 LineString(线串)中的第一个 Point(点)。 ## 语法 @@ -15,13 +15,13 @@ ST_STARTPOINT() ## 参数 -| 参数 | 描述 | -|--------------|----------------------------------------------------------------------------------| -| `` | 参数必须是一个表示 LineString 的几何类型的 GEOMETRY 表达式。 | +| 参数 | 说明 | +|--------------|-----------------------------------------------------------------------------------| +| `` | 参数必须是 GEOMETRY(几何类型)表达式,且表示一个 LineString(线串)。 | ## 返回类型 -Geometry。 +GEOMETRY(几何类型)。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-transform.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-transform.md similarity index 60% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-transform.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-transform.md index 014be1e553..77bf6033b8 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-transform.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-transform.md @@ -3,9 +3,9 @@ title: ST_TRANSFORM --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -将一个 GEOMETRY 对象从一个 [空间参考系统 (SRS)](https://en.wikipedia.org/wiki/Spatial_reference_system) 转换到另一个。如果只需要更改 SRID 而不改变坐标(例如,如果 SRID 不正确),请使用 [ST_SETSRID](st-setsrid.md) 代替。 +将 GEOMETRY 对象从一个[空间参考系统 (Spatial Reference System, SRS)](https://en.wikipedia.org/wiki/Spatial_reference_system) 转换到另一个。如果仅需更改 SRID 而不改变坐标(例如 SRID 设置错误),请改用 [ST_SETSRID](st-setsrid.md)。 ## 语法 @@ -15,15 +15,15 @@ ST_TRANSFORM( [, ], ) ## 参数 -| 参数 | 描述 | -|---------------|-------------------------------------------------------------------------------------------| -| `` | 参数必须是 GEOMETRY 对象类型的表达式。 | -| `` | 可选的 SRID,标识输入 GEOMETRY 对象的当前 SRS,如果省略此参数,则使用输入 GEOMETRY 对象中指定的 SRID。 | -| `` | 标识要使用的 SRS 的 SRID,将输入的 GEOMETRY 对象转换为使用此 SRS 的新对象。 | +| 参数 | 说明 | +|---------------|-------------------------------------------------------------------------------------------------------------------------------------------| +| `` | 参数必须是 GEOMETRY 对象类型的表达式。 | +| `` | 可选 SRID,用于标识输入 GEOMETRY 对象当前的 SRS;若省略,则使用输入 GEOMETRY 对象中已指定的 SRID。 | +| `` | 目标 SRID,用于标识转换后的 SRS;函数将输入 GEOMETRY 对象转换为使用该 SRS 的新对象。 | ## 返回类型 -Geometry. +Geometry。 ## 示例 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-x.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-x.md similarity index 64% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-x.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-x.md index 5dd6671ade..c1a919d2b2 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-x.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-x.md @@ -3,9 +3,9 @@ title: ST_X --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回由GEOMETRY对象表示的点的经度(X坐标)。 +返回由 GEOMETRY 对象表示的 Point 的经度(X 坐标)。 ## 语法 @@ -15,9 +15,9 @@ ST_X() ## 参数 -| 参数 | 描述 | -|--------------|-------------------------------------------------------------------------------| -| `` | 参数必须是一个GEOMETRY类型的表达式,并且必须包含一个点。 | +| 参数 | 描述 | +|--------------|-------------------------------------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式,并且必须包含一个 Point。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-xmax.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-xmax.md similarity index 72% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-xmax.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-xmax.md index 19677efcfd..74bf6eee1c 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-xmax.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-xmax.md @@ -3,9 +3,9 @@ title: ST_XMAX --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回指定GEOMETRY对象中所有点的最大经度(X坐标)。 +返回指定 GEOMETRY 对象中所有点的最大经度(X 坐标)。 ## 语法 @@ -15,9 +15,9 @@ ST_XMAX() ## 参数 -| 参数 | 描述 | -|--------------|--------------------------------------------------| -| `` | 参数必须是GEOMETRY类型的表达式。 | +| 参数 | 说明 | +|--------------|----------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-xmin.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-xmin.md similarity index 72% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-xmin.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-xmin.md index d26b02f28a..f9accec7ad 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-xmin.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-xmin.md @@ -3,9 +3,9 @@ title: ST_XMIN --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回指定GEOMETRY对象中所有点的最小经度(X坐标)。 +返回指定 GEOMETRY 对象中所有点的最小经度(X 坐标)。 ## 语法 @@ -15,9 +15,9 @@ ST_XMIN() ## 参数 -| 参数 | 描述 | -|--------------|--------------------------------------------------| -| `` | 参数必须是GEOMETRY类型的表达式。 | +| 参数 | 说明 | +|--------------|-----------------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-y.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-y.md similarity index 61% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-y.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-y.md index 3d9ba148e0..00183c4350 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-y.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-y.md @@ -3,9 +3,9 @@ title: ST_Y --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -返回由GEOMETRY对象表示的点的纬度(Y坐标)。 +返回由 GEOMETRY 对象表示的点(Point)的纬度(Y 坐标)。 ## 语法 @@ -15,9 +15,9 @@ ST_Y() ## 参数 -| 参数 | 描述 | +| 参数 | 说明 | |--------------|-------------------------------------------------------------------------------| -| `` | 参数必须是GEOMETRY类型的表达式,并且必须包含一个点。 | +| `` | 参数必须是 GEOMETRY 类型的表达式,并且必须包含一个点(Point)。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-ymax.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-ymax.md similarity index 77% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-ymax.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-ymax.md index 4c0b34513d..b9204d6046 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-ymax.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-ymax.md @@ -5,7 +5,7 @@ import FunctionDescription from '@site/src/components/FunctionDescription'; -返回指定GEOMETRY对象中所有点包含的最大纬度(Y坐标)。 +返回指定 GEOMETRY 对象中所有点的最大纬度(Y 坐标)。 ## 语法 @@ -15,9 +15,9 @@ ST_YMAX() ## 参数 -| 参数 | 描述 | -|--------------|--------------------------------------------------| -| `` | 参数必须是GEOMETRY类型的表达式。 | +| 参数 | 描述 | +|--------------|------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-ymin.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-ymin.md similarity index 77% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-ymin.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-ymin.md index f7d59810ea..8a821aeb4f 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/st-ymin.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/st-ymin.md @@ -5,7 +5,7 @@ import FunctionDescription from '@site/src/components/FunctionDescription'; -返回指定GEOMETRY对象中所有点的最小纬度(Y坐标)。 +返回指定 GEOMETRY 对象中所有点的最小纬度(Y 坐标)。 ## 语法 @@ -15,9 +15,9 @@ ST_YMIN() ## 参数 -| 参数 | 描述 | -|--------------|--------------------------------------------------| -| `` | 参数必须是GEOMETRY类型的表达式。 | +| 参数 | 描述 | +|--------------|------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/string-to-h3.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/string-to-h3.md similarity index 96% rename from docs/cn/sql-reference/20-sql-functions/09-geo-functions/string-to-h3.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/string-to-h3.md index 79fb4d5361..a7f475eb81 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geo-functions/string-to-h3.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/string-to-h3.md @@ -1,23 +1,23 @@ ---- -title: STRING_TO_H3 ---- - -将字符串表示形式转换为 [H3](https://eng.uber.com/h3/)(uint64)表示形式。 - -## 语法 - -```sql -STRING_TO_H3(h3) -``` - -## 示例 - -```sql -SELECT STRING_TO_H3('8d11aa6a38826ff'); - -┌─────────────────────────────────┐ -│ string_to_h3('8d11aa6a38826ff') │ -├─────────────────────────────────┤ -│ 635318325446452991 │ -└─────────────────────────────────┘ +--- +title: STRING_TO_H3 +--- + +将字符串表示形式转换为 [H3](https://eng.uber.com/h3/)(uint64)表示形式。 + +## 语法 + +```sql +STRING_TO_H3(h3) +``` + +## 示例 + +```sql +SELECT STRING_TO_H3('8d11aa6a38826ff'); + +┌─────────────────────────────────┐ +│ string_to_h3('8d11aa6a38826ff') │ +├─────────────────────────────────┤ +│ 635318325446452991 │ +└─────────────────────────────────┘ ``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/to-geometry.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/to-geometry.md similarity index 79% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/to-geometry.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/to-geometry.md index 02a643cc15..06bfdf5b27 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/to-geometry.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/to-geometry.md @@ -4,11 +4,11 @@ title_includes: TRY_TO_GEOMETRY --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -解析输入并返回一个 GEOMETRY 类型的值。 +解析输入并返回 GEOMETRY 类型的值。 -`TRY_TO_GEOMETRY` 在解析过程中发生错误时返回 NULL 值。 +若解析出错,`TRY_TO_GEOMETRY` 返回 NULL。 ## 语法 @@ -23,12 +23,12 @@ TRY_TO_GEOMETRY(, []) ## 参数 -| 参数 | 描述 | -|-------------|-----------------------------------------------------------------------------------------------------------| -| `` | 参数必须是 WKT、EWKT、WKB 或 EWKB 格式的十六进制字符串,或 GeoJSON 格式。 | -| `` | 参数必须是 WKB 或 EWKB 格式的二进制表达式。 | -| `` | 参数必须是 GeoJSON 格式的 JSON OBJECT。 | -| `` | 要使用的 SRID 的整数值。 | +| 参数 | 描述 | +|-------------|-------------------------------------------------------------------------------------------| +| `` | 须为 WKT、EWKT、十六进制 WKB/EWKB 或 GeoJSON 格式的字符串表达式。 | +| `` | 须为 WKB 或 EWKB 格式的二进制表达式。 | +| `` | 须为 GeoJSON 格式的 JSON 对象。 | +| `` | 所用 SRID 的整数值。 | ## 返回类型 diff --git a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/to-string.md b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/to-string.md similarity index 84% rename from docs/cn/sql-reference/20-sql-functions/09-geometry-functions/to-string.md rename to docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/to-string.md index b931201547..7e1c6468cd 100644 --- a/docs/cn/sql-reference/20-sql-functions/09-geometry-functions/to-string.md +++ b/docs/cn/sql-reference/20-sql-functions/09-geospatial-functions/to-string.md @@ -3,17 +3,17 @@ title: TO_STRING --- import FunctionDescription from '@site/src/components/FunctionDescription'; - + -将 GEOMETRY 对象转换为字符串表示形式。输出数据的显示格式由 `geometry_output_format` 设置控制,该设置包含以下类型: +将 GEOMETRY 对象转换为字符串(String)表示。输出数据的显示格式由 `geometry_output_format` 设置控制,该设置包含以下类型: -| 参数 | 描述 | -|-----------------|--------------------------------------------------------------| -| GeoJSON (默认) | GEOMETRY 结果以 GeoJSON 格式的 JSON 对象呈现。 | -| WKT | GEOMETRY 结果以 WKT 格式的字符串呈现。 | -| WKB | GEOMETRY 结果以 WKB 格式的二进制呈现。 | -| EWKT | GEOMETRY 结果以 EWKT 格式的字符串呈现。 | -| EWKB | GEOMETRY 结果以 EWKB 格式的二进制呈现。 | +| 参数 | 描述 | +|-------------------|---------------------------------------------------------------------| +| GeoJSON(默认) | GEOMETRY 结果以 GeoJSON 格式的 JSON 对象呈现。 | +| WKT | GEOMETRY 结果以 WKT 格式的字符串(String)呈现。 | +| WKB | GEOMETRY 结果以 WKB 格式的二进制(Binary)呈现。 | +| EWKT | GEOMETRY 结果以 EWKT 格式的字符串(String)呈现。 | +| EWKB | GEOMETRY 结果以 EWKB 格式的二进制(Binary)呈现。 | ## 语法 @@ -23,13 +23,13 @@ TO_STRING() ## 参数 -| 参数 | 描述 | -|--------------|------------------------------------------------| -| `` | 参数必须是 GEOMETRY 类型的表达式。 | +| 参数 | 描述 | +|--------------|------------------------------------------------------| +| `` | 参数必须是 GEOMETRY 类型的表达式。 | ## 返回类型 -字符串。 +字符串(String)。 ## 示例