H3_GRID_DISTANCE
H3_GRID_DISTANCE
ID로 지정한 두 H3 셀 사이의 거리를 반환해요.
본문
구문
H3_GRID_DISTANCE( <cell_id_1> , <cell_id_2> )
인자
cell_id_1
- H3 셀 ID(인덱스)를 나타내는 INTEGER, 또는 16진수 형식의 셀 ID를 나타내는 VARCHAR예요.
cell_id_2
- H3 셀 ID(인덱스)를 나타내는 INTEGER, 또는 16진수 형식의 셀 ID를 나타내는 VARCHAR예요.
반환 값
두 H3 셀 사이의 그리드 셀 단위 거리를 나타내는 INTEGER 값을 반환해요.
사용 시 참고 사항
두 입력 셀 ID는 같은 해상도를 사용해야 해요.
예시
다음 예시는 두 H3 셀 사이의 거리(그리드 셀 수 기준)를 반환해요. 예시에서는 H3 셀 ID를 INTEGER 값으로 지정해요.
SELECT H3_GRID_DISTANCE(617540519103561727, 617540519052967935);
+----------------------------------------------------------+
| H3_GRID_DISTANCE(617540519103561727, 617540519052967935) |
|----------------------------------------------------------|
| 5 |
+----------------------------------------------------------+
다음 예시는 H3 셀 ID의 16진수 값을 VARCHAR 값으로 지정해요.
SELECT H3_GRID_DISTANCE('891f1d48b93ffff', '891f1d4888fffff');
+--------------------------------------------------------+
| H3_GRID_DISTANCE('891F1D48B93FFFF', '891F1D4888FFFFF') |
|--------------------------------------------------------|
| 5 |
+--------------------------------------------------------+
더 알아보기
- Geospatial functions — 지리 공간 함수 모음
- H3 — H3 데이터 타입
- H3_TRY_GRID_DISTANCE — 오류 대신 NULL을 반환하는 거리 계산