카테고리:

지리공간 함수

H3_TRY_GRID_DISTANCE

두 H3 셀 사이 거리의 반환을 시도할 때 오류가 발생하면 NULL을 반환하는 H3_GRID_DISTANCE 의 특수 버전입니다.

구문

H3_TRY_GRID_DISTANCE( <cell_id_1> , <cell_id_2> )
Copy

인자

cell_id_1

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

cell_id_2

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

반환

INTEGER 값 또는 NULL을 반환합니다.

  • 함수가 계산을 성공적으로 수행할 수 있으면 두 H3 셀 사이의 그리드 셀 거리를 나타내는 INTEGER 값을 반환합니다.

  • 그리드 거리를 계산할 수 없는 경우(예: 두 셀이 인접하지 않은 베이스 셀 에 속하는 경우) 오류를 보고하지 않고 NULL을 반환합니다.

사용법 노트

사용법 노트는 H3_GRID_DISTANCE 섹션을 참조하십시오.

예

다음 예제에서는 두 셀 사이의 거리를 계산해 보겠습니다. 셀이 인접하지 않은 베이스 셀에 속하기 때문에 이 함수는 거리 계산에 실패하고 NULL을 반환합니다.

SELECT H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719);
Copy
+--------------------------------------------------------------+
| H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719) |
|--------------------------------------------------------------|
|                                                         NULL |
+--------------------------------------------------------------+

두 H3 셀 사이의 거리를 성공적으로 계산한 예제는 H3_GRID_DISTANCE 섹션을 참조하십시오.

언어: 한국어