geo_point_to_s2cell()
적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
지리적 위치의 S2 셀 토큰 문자열 값을 계산합니다.
S2 셀 계층 구조에 대해 자세히 알아보세요. S2 셀은 유용한 지리 공간적 클러스터링 도구일 수 있습니다. S2 셀은 구면 표면의 셀이며 측지 가장자리가 있습니다. S2 셀은 지구 표면을 나누는 계층 구조의 일부입니다. 셀이 세분화된 횟수를 정의하는 0부터 30까지의 최대 31개 수준이 있습니다. 수준은 85,011,012.19km²의 영역 범위와 수준 0에서 가장 큰 범위에서 수준 30에서 0.44 cm²의 가장 낮은 범위까지 다양합니다. S2 셀은 더 높은 수준에서 세분화되므로 셀 중심이 잘 유지됩니다. 두 지리적 위치는 서로 매우 가까울 수 있지만 서로 다른 S2 셀 토큰이 있습니다.
참고 항목
경도 x 및 위도 y에서 계산된 S2 셀 토큰 문자열에서 geo_s2cell_to_central_point() 함수를 호출하는 경우 함수가 반드시 x와 y를 반환하지는 않습니다.
S2 셀 계층 구조에 대해 자세히 알아보세요.
구문
geo_point_to_s2cell(경도, 위도, [ 수준 ])
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | Type | 필수 | 설명 |
|---|---|---|---|
| 경도 | real |
✔️ | 지리 공간 좌표, 경도 값(도) 유효한 값은 실수이며 범위 [-180, +180]입니다. |
| latitude | real |
✔️ | 지리 공간적 좌표, 위도 값(도)입니다. 유효한 값은 실수이며 범위 [-90, +90]입니다. |
| level | int |
요청된 셀 수준을 정의합니다. 지원되는 값은 [0, 30] 범위에 있습니다. 지정하지 않으면 기본값 11 이 사용됩니다. |
반품
지정된 지리적 위치의 S2 셀 토큰 문자열 값입니다. 좌표나 수준이 잘못된 경우 쿼리는 빈 결과를 생성합니다.
수준 값당 S2 셀 근사 영역 범위
모든 수준에서 S2 셀의 크기는 비슷하지만 정확히 같지는 않습니다. 근처의 셀 크기는 더 같은 경향이 있습니다.
| 수준 | 최소 임의 셀 가장자리 길이(영국) | 최대 임의 셀 가장자리 길이(미국) |
|---|---|---|
| 0 | 7842 km | 7842 km |
| 1 | 3921 km | 5004 km |
| 2 | 1825 km | 2489 km |
| 3 | 840 km | 1310 km |
| 4 | 432 km | 636 km |
| 5 | 210 km | 315 km |
| 6 | 108 km | 156 km |
| 7 | 54 km | 78 km |
| 8 | 27 km | 39 km |
| 9 | 14 km | 20 km |
| 10 | 7 km | 10 km |
| 11 | 3 km | 5 km |
| 12 | 1699 m | 2 km |
| 13 | 850 m | 1225 m |
| 14 | 425 m | 613 m |
| 15 | 212 m | 306 m |
| 16 | 106 m | 153 m |
| 17 | 53 m | 77 m |
| 18 | 27 m | 38 m |
| 19 | 13 m | 19 m |
| 20 | 7 m | 10분 |
| 21 | 3 m | 5분 |
| 22 | 166cm | 2분 |
| 23 | 83cm | 120cm |
| 24 | 41cm | 60cm |
| 25 | 21cm | 30cm |
| 26 | 10cm | 15cm |
| 27 | 5cm | 7cm |
| 28 | 2cm | 4cm |
| 29 | 12mm | 18mm |
| 30 | 6mm | 9mm |
테이블 원본은 이 S2 셀 통계 리소스에서 찾을 수 있습니다.
사용 가능한 다른 그리드 시스템과 비교하려면 Kusto 쿼리 언어 사용하여 지리 공간적 클러스터링을 참조하세요.
예제
S2 셀로 집계된 미국 폭풍 이벤트
다음 예제에서는 S2 셀로 집계된 미국 폭풍 이벤트를 찾습니다.
StormEvents
| project BeginLon, BeginLat
| summarize by hash=geo_point_to_s2cell(BeginLon, BeginLat, 5)
| project geo_s2cell_to_central_point(hash)
| render scatterchart with (kind=map)
출력
다음 예제에서는 S2 셀 ID를 계산합니다.
print s2cell = geo_point_to_s2cell(-80.195829, 25.802215, 8)
출력
| s2cell |
|---|
| 88d9b |
좌표 그룹 찾기
다음 예제에서는 좌표 그룹을 찾습니다. 그룹의 모든 좌표 쌍은 최대 면적이 1632.45km인 S2 셀에 상주합니다.
datatable(location_id:string, longitude:real, latitude:real)
[
"A", 10.1234, 53,
"B", 10.3579, 53,
"C", 10.6842, 53,
]
| summarize count = count(), // items per group count
locations = make_list(location_id) // items in the group
by s2cell = geo_point_to_s2cell(longitude, latitude, 8) // s2 cell of the group
출력
| s2cell | count | 위치 |
|---|---|---|
| 47b1d | 2 | ["A","B"] |
| 47ae3 | 1 | ["C"] |
빈 결과
다음 예제에서는 잘못된 좌표 입력으로 인해 빈 결과를 생성합니다.
print s2cell = geo_point_to_s2cell(300,1,8)
출력
| s2cell |
|---|
다음 예제에서는 잘못된 수준 입력으로 인해 빈 결과를 생성합니다.
print s2cell = geo_point_to_s2cell(1,1,35)
출력
| s2cell |
|---|
다음 예제에서는 잘못된 수준 입력으로 인해 빈 결과를 생성합니다.
print s2cell = geo_point_to_s2cell(1,1,int(null))
출력
| s2cell |
|---|