H3_GRID_PATH
H3_GRID_PATH (H3 그리드 경로)
두 셀 사이의 선(line)을 나타내는 H3 셀들의 ID 배열을 반환해요. 반환된 ARRAY의 ID는 (입력 ID로 INTEGER 값을 제공했다면) INTEGER 값이거나, (입력 ID로 16진수 ID를 제공했다면) 16진수 ID를 담은 VARCHAR 값이에요.
본문
구문
H3_GRID_PATH( <cell_id_1> , <cell_id_2> )
인자
cell_id_1
H3 셀 ID(인덱스)를 나타내는 INTEGER, 또는 16진수 형식의 셀 ID를 나타내는 VARCHAR예요.
cell_id_2
H3 셀 ID(인덱스)를 나타내는 INTEGER, 또는 16진수 형식의 셀 ID를 나타내는 VARCHAR예요.
반환 값
cell_id_1과 cell_id_2로 지정된 셀들 사이의 선을 나타내는 H3 셀들의 ID 배열을 반환해요. ID는 다음 형식 중 하나예요.
-
cell_id_1과cell_id_2가 INTEGER 값이면, 함수는 ID를 INTEGER 값으로 반환해요. -
cell_id_1과cell_id_2가 16진수 ID를 담은 VARCHAR 값이면, 함수는 16진수 ID를 VARCHAR 값으로 반환해요.
사용 시 참고 사항
두 입력 셀 ID는 같은 해상도(resolution)를 사용해야 해요.
예시
다음 예시는 ID 617540519103561727과 617540519052967935(둘 다 INTEGER 값으로 지정)을 가진 셀들 사이의 선을 나타내는 H3 셀들 ID의 배열을 반환해요.
SELECT H3_GRID_PATH(617540519103561727, 617540519052967935);
+------------------------------------------------------+
| H3_GRID_PATH(617540519103561727, 617540519052967935) |
|------------------------------------------------------|
| [ |
| 617540519103561727, |
| 617540519046414335, |
| 617540519047462911, |
| 617540519044055039, |
| 617540519045103615, |
| 617540519052967935 |
| ] |
+------------------------------------------------------+
다음 예시는 ID 891f1d48b93ffff과 891f1d4888fffff(둘 다 VARCHAR 값으로 지정)을 가진 셀들 사이의 선을 나타내는 H3 셀들 ID의 배열을 반환해요.
SELECT H3_GRID_PATH('891f1d48b93ffff', '891f1d4888fffff');
+----------------------------------------------------+
| H3_GRID_PATH('891F1D48B93FFFF', '891F1D4888FFFFF') |
|----------------------------------------------------|
| [ |
| "891f1d48b93ffff", |
| "891f1d4882bffff", |
| "891f1d4883bffff", |
| "891f1d48807ffff", |
| "891f1d48817ffff", |
| "891f1d4888fffff" |
| ] |
+----------------------------------------------------+