ClickHouse/docs/zh/sql-reference/functions/geo.md
2020-10-13 20:23:29 +03:00

223 lines
7.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# GEO函数 {#geohan-shu}
## 大圆形距离 {#greatcircledistance}
使用[great-circle distance公式](https://en.wikipedia.org/wiki/Great-circle_distance)计算地球表面两点之间的距离。
``` sql
greatCircleDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg)
```
**输入参数**
- `lon1Deg` — 第一个点的经度,单位:度,范围: `[-180°, 180°]`。
- `lat1Deg` — 第一个点的纬度,单位:度,范围: `[-90°, 90°]`。
- `lon2Deg` — 第二个点的经度,单位:度,范围: `[-180°, 180°]`。
- `lat2Deg` — 第二个点的纬度,单位:度,范围: `[-90°, 90°]`。
正值对应北纬和东经,负值对应南纬和西经。
**返回值**
地球表面的两点之间的距离,以米为单位。
当输入参数值超出规定的范围时将抛出异常。
**示例**
``` sql
SELECT greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)
```
``` text
┌─greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)─┐
│ 14132374.194975413 │
└───────────────────────────────────────────────────────────────────┘
```
## 尖尖的人 {#pointinellipses}
检查指定的点是否至少包含在指定的一个椭圆中。
下述中的坐标是几何图形在笛卡尔坐标系中的位置。
``` sql
pointInEllipses(x, y, x₀, y₀, a₀, b₀,...,xₙ, yₙ, aₙ, bₙ)
```
**输入参数**
- `x, y` — 平面上某个点的坐标。
- `xᵢ, yᵢ` — 第i个椭圆的中心坐标。
- `aᵢ, bᵢ` — 以x, y坐标为单位的第i个椭圆的轴。
输入参数的个数必须是`2+4⋅n`,其中`n`是椭圆的数量。
**返回值**
如果该点至少包含在一个椭圆中,则返回`1`;否则,则返回`0`。
**示例**
``` sql
SELECT pointInEllipses(55.755831, 37.617673, 55.755831, 37.617673, 1.0, 2.0)
```
``` text
┌─pointInEllipses(55.755831, 37.617673, 55.755831, 37.617673, 1., 2.)─┐
│ 1 │
└─────────────────────────────────────────────────────────────────────┘
```
## pointInPolygon {#pointinpolygon}
检查指定的点是否包含在指定的多边形中。
``` sql
pointInPolygon((x, y), [(a, b), (c, d) ...], ...)
```
**输入参数**
- `(x, y)` — 平面上某个点的坐标。[元组](../../sql-reference/functions/geo.md)类型,包含坐标的两个数字。
- `[(a, b), (c, d) ...]` — 多边形的顶点。[阵列](../../sql-reference/functions/geo.md)类型。每个顶点由一对坐标`(a, b)`表示。顶点可以按顺时针或逆时针指定。顶点的个数应该大于等于3。同时只能是常量的。
- 该函数还支持镂空的多边形(切除部分)。如果需要,可以使用函数的其他参数定义需要切除部分的多边形。(The function does not support non-simply-connected polygons.)
**返回值**
如果坐标点存在在多边形范围内,则返回`1`。否则返回`0`。
如果坐标位于多边形的边界上,则该函数可能返回`1`,或可能返回`0`。
**示例**
``` sql
SELECT pointInPolygon((3., 3.), [(6, 0), (8, 4), (5, 8), (0, 2)]) AS res
```
``` text
┌─res─┐
│ 1 │
└─────┘
```
## geohashEncode {#geohashencode}
将经度和纬度编码为geohash-string请参阅http://geohash.org/,https://en.wikipedia.org/wiki/Geohash
``` sql
geohashEncode(longitude, latitude, [precision])
```
**输入值**
- longitude - 要编码的坐标的经度部分。其值应在`[-180°180°]`范围内
- latitude - 要编码的坐标的纬度部分。其值应在`[-90°90°]`范围内
- precision - 可选生成的geohash-string的长度默认为`12`。取值范围为`[1,12]`。任何小于`1`或大于`12`的值都会默认转换为`12`。
**返回值**
- 坐标编码的字符串使用base32编码的修改版本
**示例**
``` sql
SELECT geohashEncode(-5.60302734375, 42.593994140625, 0) AS res
```
``` text
┌─res──────────┐
│ ezs42d000000 │
└──────────────┘
```
## geohashDecode {#geohashdecode}
将任何geohash编码的字符串解码为经度和纬度。
**输入值**
- encoded string - geohash编码的字符串。
**返回值**
- (longitude, latitude) - 经度和纬度的`Float64`值的2元组。
**示例**
``` sql
SELECT geohashDecode('ezs42') AS res
```
``` text
┌─res─────────────────────────────┐
│ (-5.60302734375,42.60498046875) │
└─────────────────────────────────┘
```
## geoToH3 {#geotoh3}
计算指定的分辨率的[H3](https://uber.github.io/h3/#/documentation/overview/introduction)索引`(lon, lat)`。
``` sql
geoToH3(lon, lat, resolution)
```
**输入值**
- `lon` — 经度。 [Float64](../../sql-reference/functions/geo.md)类型。
- `lat` — 纬度。 [Float64](../../sql-reference/functions/geo.md)类型。
- `resolution` — 索引的分辨率。 取值范围为: `[0, 15]`。 [UInt8](../../sql-reference/functions/geo.md)类型。
**返回值**
- H3中六边形的索引值。
- 发生异常时返回0。
[UInt64](../../sql-reference/functions/geo.md)类型。
**示例**
``` sql
SELECT geoToH3(37.79506683, 55.71290588, 15) as h3Index
```
``` text
┌────────────h3Index─┐
│ 644325524701193974 │
└────────────────────┘
```
## geohashesInBox {#geohashesinbox}
计算在指定精度下计算最小包含指定的经纬范围的最小图形的geohash数组。
**输入值**
- longitude_min - 最小经度。其值应在`[-180°180°]`范围内
- latitude_min - 最小纬度。其值应在`[-90°90°]`范围内
- longitude_max - 最大经度。其值应在`[-180°180°]`范围内
- latitude_max - 最大纬度。其值应在`[-90°90°]`范围内
- precision - geohash的精度。其值应在`[1, 12]`内的`UInt8`类型的数字
请注意,上述所有的坐标参数必须同为`Float32`或`Float64`中的一种类型。
**返回值**
- 包含指定范围内的指定精度的geohash字符串数组。注意您不应该依赖返回数组中geohash的顺序。
- \[\] - 当传入的最小经纬度大于最大经纬度时将返回一个空数组。
请注意如果生成的数组长度超过10000时则函数将抛出异常。
**示例**
``` sql
SELECT geohashesInBox(24.48, 40.56, 24.785, 40.81, 4) AS thasos
```
``` text
┌─thasos──────────────────────────────────────┐
│ ['sx1q','sx1r','sx32','sx1w','sx1x','sx38'] │
└─────────────────────────────────────────────┘
```
[来源文章](https://clickhouse.tech/docs/en/query_language/functions/geo/) <!--hide-->