카테고리:

지리공간 함수

H3_UNCOMPACT_CELLS_STRINGS

입력의 H3 셀과 동일한 영역을 차지하는 지정된 분해능의 H3 셀의 VARCHAR 16진수 IDs가 포함된 VARIANT 값으로 구성된 배열 을 반환합니다.

구문

H3_UNCOMPACT_CELLS_STRINGS( <array_of_cell_ids> , <target_resolution> )
Copy

인자

array_of_cell_ids

H3 셀 IDs(인덱스)를 나타내는 VARCHAR 16진수 값이 포함된 VARIANT 값으로 구성된 배열.

target_resolution

반환된 H3 셀에 사용할 H3 분해능 을 지정하는 0과 15(포함) 사이의 INTEGER 값입니다.

다른 INTEGER 값을 지정하면 오류가 발생합니다.

반환

ARRAY 데이터 타입 또는 NULL 값을 반환합니다.

  • 입력이 VARCHAR 16진수 값을 포함하는 VARIANT 값으로 구성된 배열인 경우, 지정된 분해능에서 H3 셀 집합을 나타내는 VARCHAR 16진수 값을 포함하는 VARIANT 값으로 구성된 배열을 반환합니다.

  • 입력값이 NULL이면 오류를 보고하지 않고 NULL을 반환합니다.

사용법 노트

  • 입력된 모든 VARCHAR 16진수 값은 유효한 H3 셀을 나타내야 합니다.

  • 입력 셀은 target_resolution 인자에 지정된 분해능보다 높은 분해능을 가질 수 없습니다.

다음 예제는 유효한 H3 셀 IDs와 목표 분해능인 10 을 나타내는 압축되지 않은 H3 셀 집합을 반환합니다.

SELECT H3_UNCOMPACT_CELLS_STRINGS(
  [
    '8a2a1072339ffff',
    '892a1072377ffff'
  ],
  10
) AS uncompacted;
Copy
+----------------------+
| UNCOMPACTED          |
|----------------------|
| [                    |
|   "8a2a1072339ffff", |
|   "8a2a10723747fff", |
|   "8a2a1072374ffff", |
|   "8a2a10723757fff", |
|   "8a2a1072375ffff", |
|   "8a2a10723767fff", |
|   "8a2a1072376ffff", |
|   "8a2a10723777fff"  |
| ]                    |
+----------------------+