H3_GRID_DISK
H3_GRID_DISK
주어진 셀에서 지정한 그리드 거리(k_value) 이내에 있는 H3 셀의 ID 배열을 반환해요. 그리드 거리는 H3 모델에서 흔히 k로 쓰이며, H3 그리드에서 셀 사이의 단계 수를 나타내요. 반환된 ARRAY의 ID는 INTEGER 값(입력 ID로 INTEGER 값이 제공된 경우) 또는 16진수 ID를 포함하는 VARCHAR 값(입력 ID로 16진수 ID가 제공된 경우)이에요.
본문
구문
H3_GRID_DISK( <cell_id> , <k_value> )
인자
- H3 셀 ID(인덱스)를 나타내는 INTEGER, 또는 16진수 형식의 셀 ID를 나타내는 VARCHAR예요.
- 그리드 거리 k를 나타내는 INTEGER예요. H3 그리드에서 셀 사이의 단계 수예요. 음이 아닌 값을 지정해야 해요. 예를 들어 0은 지정한 셀만 반환하고, 1은 그 셀과 바로 인접한 이웃을 반환해요.
반환 값
cell_id가 지정한 셀에서 k_value 거리 이내에 있는 H3 셀의 ID 배열을 반환해요. ID는 다음 형식 중 하나예요.
cell_id가 INTEGER 값이면 함수는 ID를 INTEGER 값으로 반환해요.cell_id가 16진수 ID를 포함하는 VARCHAR 값이면 함수는 16진수 ID를 VARCHAR 값으로 반환해요.
예시
다음 예시는 617540519050084351(INTEGER 값으로 지정) ID를 가진 셀에서 그리드 거리 1 이내의 H3 셀 ID 배열을 반환해요.
SELECT H3_GRID_DISK(617540519050084351, 1);
+-------------------------------------+
| H3_GRID_DISK(617540519050084351, 1) |
|-------------------------------------|
| [ |
| 617540519050084351, |
| 617540519051657215, |
| 617540519050608639, |
| 617540519050870783, |
| 617540519050346495, |
| 617540519051395071, |
| 617540519051132927 |
| ] |
+-------------------------------------+
다음 예시는 891f1d48863ffff(VARCHAR 값으로 지정) ID를 가진 셀에서 그리드 거리 1 이내의 H3 셀 ID 배열을 반환해요.
SELECT H3_GRID_DISK('891f1d48863ffff', 1);
+------------------------------------+
| H3_GRID_DISK('891F1D48863FFFF', 1) |
|------------------------------------|
| [ |
| "891f1d48863ffff", |
| "891f1d4887bffff", |
| "891f1d4886bffff", |
| "891f1d4886fffff", |
| "891f1d48867ffff", |
| "891f1d48877ffff", |
| "891f1d48873ffff" |
| ] |
+------------------------------------+