# 地理空间函数
# greatCircleDistance
使用大圆公式计算地球表面上两点之间的距离。
greatCircleDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg)
输入参数
lon1Deg— 第一个点的经度，以度为单位。范围：[-180°, 180°]。lat1Deg— 第一个点的纬度，以度为单位。范围：[-90°, 90°]。lon2Deg— 第二个点的经度，以度为单位。范围：[-180°, 180°]。lat2Deg— 第二个点的纬度，以度为单位。范围：[-90°, 90°]。- 正值对应北纬和东经，负值对应南纬和西经。
返回值
- 两点之间的地球表面距离，以米为单位。
- 当输入参数值超出范围时，会生成异常。
示例
SELECT greatCircleDistance(55.755831, 37.617673, 55.755831, 37.617673) AS greatCircleDistance
┌─greatCircleDistance─┐
│ 0 │
└─────────────────────┘
# geoDistance
与 greatCircleDistance 类似，但在计算距离时使用 WGS-84 椭球体而不是球体。这是对地球大地水准面的更精确近似。性能与 greatCircleDistance 相同（没有性能损失）。建议使用 geoDistance 来计算地球上的距离。
技术说明：对于足够接近的点，我们使用在坐标中点的切平面上的度量来计算距离。
geoDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg)
输入参数
lon1Deg— 第一个点的经度，以度为单位。范围：[-180°, 180°]。lat1Deg— 第一个点的纬度，以度为单位。范围：[-90°, 90°]。lon2Deg— 第二个点的经度，以度为单位。范围：[-180°, 180°]。lat2Deg— 第二个点的纬度，以度为单位。范围：[-90°, 90°]。- 正值对应北纬和东经，负值对应南纬和西经。
返回值
- 两点之间的地球表面距离，以米为单位。
- 当输入参数值超出范围时，会生成异常。
示例
SELECT geoDistance(38.8976, 77.0366, 39.9496, 75.1503) AS geoDistance
┌─geoDistance─┐
│ 212458.73 │
└─────────────┘
# H3
获取索引：https://wolf-h3-viewer.glitch.me (opens new window)
- (8831aa5039fffff)16 = (613363270285262847)10
检查有效性 h3IsValid(h3index)
SELECT h3IsValid(613363270285262847) AS h3IsValid;
┌─h3IsValid─┐
│ 1 │
└───────────┘
H3 索引转换为经度和纬度 h3ToGeo(h3Index)
SELECT h3ToGeo(613363270285262847) AS coordinates;
┌─coordinates───────────────────────────┐
│(116.29523629955709,39.984633235997315)│
└───────────────────────────────────────┘
转换为顶点数组 h3ToGeoBoundary
SELECT h3ToGeoBoundary(613363270285262847) AS coordinates;
┌─coordinates──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [(39.98791325592796,116.2925333574096),(39.98386803718472,116.29020686993137),(39.98058822646115,116.29290984546513),(39.98135339622932,116.297938782017),(39.98539816328819,116.30026548576008),(39.98867821224181,116.29756303675612)] │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
# h3IsValid
验证数字是否为有效的 H3 (opens new window) 索引。
h3IsValid(h3index)
参数
h3index — 六边形索引号。类型：UInt64。
返回值
- 1 — 数字是有效的 H3 索引。
- 0 — 数字不是有效的 H3 索引。
- 类型：UInt8。
示例
SELECT h3IsValid(617301318803390464) AS h3IsValid;
┌─h3IsValid─┐
│ 1 │
└───────────┘
# h3ToGeo
返回与提供的 H3 (opens new window) 索引对应的质心经度和纬度。
h3ToGeo(h3Index)
参数
h3Index — H3 索引。UInt64。
返回值
由两个值组成的元组：tuple(lon,lat)。lon — 经度。Float64。lat — 纬度。Float64。
示例
SELECT h3ToGeo(617301318803390464) AS coordinates;
┌─coordinates───────────────────────────┐
│ (35.537867206326645,54.20746993771632)│
└───────────────────────────────────────┘
# h3ToGeoBoundary
返回与提供的 H3 索引对应的边界的 (lon, lat) 数组。
h3ToGeoBoundary(h3Index)
参数
h3Index — H3 索引。类型：UInt64。
返回值
由 (lon, lat) 对组成的数组。类型：Array(Float64, Float64)。
示例
SELECT h3ToGeoBoundary(617301318803390464) AS coordinates;
┌─coordinates───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [(54.20668646205218,35.53529359582246),(54.20566163343774,35.537605905213915),(54.20644505711934,35.54017955058831),(54.208253376128475,35.54044097223983),(54.209278241418595,35.53812853031426),(54.20849475102178,35.535554799273164)] │
└────────────────────────────────────────────────────────────────