카테고리:

지리 공간 함수

H3_GRID_DISK

지정된 셀로부터 k 거리 내에 있는 H3 셀의 ID로 구성된 ARRAY를 반환합니다. 반환된 ARRAY의 ID는 INTEGER 값(INTEGER 값이 입력 ID으로 제공된 경우) 또는 16진수 ID를 포함하는 VARCHAR 값(16진수 ID가 입력 ID로 제공된 경우)입니다.

구문

H3_GRID_DISK( <cell_id> , <k_value> )
Copy

인자

cell_id

H3 셀 ID(인덱스)를 나타내는 INTEGER 또는 16진수 형식으로 셀 ID을 나타내는 VARCHAR입니다.

k_value

그리드 거리를 나타내는 INTEGER입니다. 음수가 아닌 값을 지정해야 합니다.

반환

cell_id 로 지정된 셀에서 거리 k_value 내에 있는 H3 셀의 ID로 구성된 ARRAY를 반환합니다. ID는 다음 중 한 가지 형식으로 되어 있습니다.

  • cell_id 가 INTEGER 값인 경우 이 함수는 ID를 INTEGER 값으로 반환합니다.

  • cell_id 가 16진수 ID를 포함한 VARCHAR 값인 경우 이 함수는 16진수 ID를 VARCHAR 값으로 반환합니다.

다음 예에서는 (INTEGER 값으로 지정된) ID 617540519050084351 이 있는 셀에서 1의 그리드 거리 내에 있는 H3 셀의 ID로 구성된 ARRAY를 반환합니다.

SELECT H3_GRID_DISK(617540519050084351, 1);
Copy
+-------------------------------------+
| H3_GRID_DISK(617540519050084351, 1) |
|-------------------------------------|
| [                                   |
|   617540519050084351,               |
|   617540519051657215,               |
|   617540519050608639,               |
|   617540519050870783,               |
|   617540519050346495,               |
|   617540519051395071,               |
|   617540519051132927                |
| ]                                   |
+-------------------------------------+

다음 예에서는 (VARCHAR 값으로 지정된) ID 891f1d48863ffff 가 있는 셀에서 1의 그리드 거리 내에 있는 H3 셀의 ID로 구성된 ARRAY를 반환합니다.

SELECT H3_GRID_DISK('891f1d48863ffff', 1);
Copy
+------------------------------------+
| H3_GRID_DISK('891F1D48863FFFF', 1) |
|------------------------------------|
| [                                  |
|   "891f1d48863ffff",               |
|   "891f1d4887bffff",               |
|   "891f1d4886bffff",               |
|   "891f1d4886fffff",               |
|   "891f1d48867ffff",               |
|   "891f1d48877ffff",               |
|   "891f1d48873ffff"                |
| ]                                  |
+------------------------------------+