geo_h3cell_rings()

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

H3 셀 링 계산

H3 셀에 대해 자세히 알아보세요.

구문

geo_h3cell_rings(h3cell,거리)

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름	Type	필수	설명
h3cell	string	✔️	geo_point_to_h3cell()에서 계산한 H3 셀 토큰 값입니다.
distance	int	✔️	지정된 셀의 최대 링 거리를 정의합니다. 유효한 거리는 범위 [0, 142]입니다.

반품

첫 번째 링에 원래 셀이 들어 있고, 두 번째 링에 인접한 셀이 포함된 순서가 지정된 링 배열 배열입니다. H3 셀 또는 거리가 잘못된 경우 쿼리는 null 결과를 생성합니다.

참고 항목

• H3 셀 바로 인접 항목에 대해서만 geo_h3cell_neighbors()를 참조하세요.
• 펜타곤 왜곡이 발생한 경우 셀이 링에 없을 수 있습니다.

예제

다음 예제에서는 최대 거리 2까지의 링을 생성합니다.

쿼리 실행

print rings = geo_h3cell_rings('861f8894fffffff', 2)

출력

반지
[ ["861f8894fffffff"], ["861f88947ffffff","861f8895fffffff","861f88867ffffffff","861f8d497ffffffff","861f8d4b7ffffff","861f8896fffffff"], ["861f88967ffffff","861f88977ffffffff","861f88957ffffffff","861f8882fffffffff","861f88877ffffff","861f88847ffffffff",","861f8886fffffff","861f8d49fffffff","861f8d487ffffffff","861f8d4a7ffffffff","861f8d59fffffff","861f8d597ffffffff"] ]

다음 예제에서는 수준 1(모든 인접 항목)에서 모든 셀을 생성합니다.

쿼리 실행

print neighbors = geo_h3cell_rings('861f8894fffffff', 1)[1]

출력

이웃
["861f88947ffffff", "861f8895fffffff", "861f88867ffffffff", "861f8d497ffffffff", "861f8d4b7ffffffff","861f8896fffffffff"]

다음 예제에서는 모든 링에서 셀 목록을 생성합니다.

쿼리 실행

print rings = geo_h3cell_rings('861f8894fffffff', 1)
| mv-apply rings on 
(
  summarize cells = make_list(rings)
)

출력

셀
["861f8894fffffff","861f88947ffffffff","861f8895fffffff","861f88867ffffffff","861f8d497ffffff","861f8d4b7ffffff","861f8896fffffff"]

다음 예제에서는 모든 셀의 GeoJSON 기하 도형 컬렉션을 어셈블합니다.

쿼리 실행

print rings = geo_h3cell_rings('861f8894fffffff', 1)
| mv-apply rings on 
(
  summarize make_list(rings)
)
| mv-expand list_rings to typeof(string)
| project polygon = geo_h3cell_to_polygon(list_rings)
| summarize polygon_lst = make_list(polygon)
| project geojson = bag_pack(
    "type", "Feature",
    "geometry", bag_pack("type", "GeometryCollection", "geometries", polygon_lst),
    "properties", bag_pack("name", "H3 polygons collection"))

출력

geojson
{ "type": "Feature", "geometry": { "type": "GeometryCollection", "geometries": [ ... ... ]}, "properties": { "name": "H3 polygons collection" }}

다음 예제에서는 잘못된 셀 때문에 true를 반환합니다.

쿼리 실행

print is_null = isnull(geo_h3cell_rings('abc', 3))

출력

is_null
1

다음 예제에서는 잘못된 거리 때문에 true를 반환합니다.

쿼리 실행

print is_null = isnull(geo_h3cell_rings('861f8894fffffff', 150))

출력

is_null
1