지리적 위치의 H3 셀 토큰 문자열 값을 계산합니다.
H3 셀에 대해 자세히 알아보세요.
문법
geo_point_to_h3cell(
경도,위도, [ 해결 방법 ])
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| 경도 | real |
✔️ | 지리 공간 좌표, 경도 값(도) 유효한 값은 실수이며 범위 [-180, +180]입니다. |
| 위도 | real |
✔️ | 지리 공간적 좌표, 위도 값(도)입니다. 유효한 값은 실수이며 범위 [-90, +90]입니다. |
| 해상도 | int |
요청된 셀 해상도를 정의합니다. 지원되는 값은 [0, 15] 범위에 있습니다. 지정하지 않으면 기본값 6 이 사용됩니다. |
반품
지정된 지리적 위치의 H3 셀 토큰 문자열 값입니다. 좌표 또는 수준이 잘못된 경우 쿼리는 빈 결과를 생성합니다.
비고
- H3 셀은 유용한 지리 공간적 클러스터링 도구일 수 있습니다.
- H3 셀에는 16개 계층 구조 수준이 있으며, 가장 높은 수준 0에서 0.9m²의 가장 낮은 수준 15에서 4,250,547km²에 이르는 영역 범위가 있습니다.
- H3 셀에는 고유한 육각형 모양이 있으며 다음과 같은 몇 가지 고유한 속성이 있습니다.
- 육각형에는 6개의 이웃이 있습니다.
- 육각형을 사용하면 반경을 쉽게 근사화할 수 있으며 모든 이웃은 동등합니다.
- 육각형은 시각적으로 즐겁습니다.
- 드물게 도형은 펜타곤입니다.
- H3 셀에는 평면 표면에 사각형 영역이 있습니다.
- 경도 x 및 위도 y에서 계산된 H3 셀 토큰 문자열에서 geo_h3cell_to_central_point() 함수를 호출해도 x와 y가 반드시 반환되는 것은 아닙니다.
- 두 지리적 위치가 서로 매우 가깝지만 H3 셀 토큰이 서로 다를 수 있습니다.
H3 셀 해상도 값당 근사 영역 범위
| 레벨 | 평균 육각형 가장자리 길이 |
|---|---|
| 0 | 1108 km |
| 1 | 419 km |
| 2 | 158 km |
| 3 | 60 km |
| 4 | 23 km |
| 5 | 8 km |
| 6 | 3 km |
| 7 | 1 km |
| 8 (여덟) | 460 m |
| 9 | 174 m |
| 10 | 66 m |
| 11 | 25 m |
| 12 | 9 m |
| 13 | 3 m |
| 14 | 1미터 |
| 15 | 0.5 m |
테이블 원본은 이 H3 셀 통계 리소스에서 찾을 수 있습니다.
geo_point_to_s2cell(), geo_point_to_geohash()도 참조하세요.
사용 가능한 다른 그리드 시스템과 비교합니다. Kusto 쿼리 언어를 사용한 지리 공간적 클러스터링을 참조하세요.
예시
다음 예제에서는 지리적 위치의 H3 셀 토큰 문자열 값을 계산합니다.
print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)
출력
| h3cell |
|---|
| 862a1072fffffff |
다음 예제에서는 좌표 그룹을 찾습니다. 그룹의 모든 좌표 쌍은 평균 육각형 영역이 253km인 H3 셀에 상주합니다.
datatable(location_id:string, longitude:real, latitude:real)
[
"A", -73.956683, 40.807907,
"B", -73.916869, 40.818314,
"C", -73.989148, 40.743273,
]
| summarize count = count(), // Items per group count
locations = make_list(location_id) // Items in the group
by h3cell = geo_point_to_h3cell(longitude, latitude, 5) // H3 Cell of the group
출력
| h3cell | 세다 | 위치 |
|---|---|---|
| 852a100bfffffff | 2 | [ "A", "B" ] |
| 852a1073fffffff | 1 | [ "C" ] |
다음 예제에서는 잘못된 좌표 입력으로 인해 빈 결과를 생성합니다.
print h3cell = geo_point_to_h3cell(300,1,8)
출력
| h3cell |
|---|
다음 예제에서는 잘못된 수준 입력으로 인해 빈 결과를 생성합니다.
print h3cell = geo_point_to_h3cell(1,1,16)
출력
| h3cell |
|---|
다음 예제에서는 잘못된 수준 입력으로 인해 빈 결과를 생성합니다.
print h3cell = geo_point_to_h3cell(1,1,int(null))
출력
| h3cell |
|---|