H3_TRY_GRID_DISTANCE

H3_TRY_GRID_DISTANCE

두 H3 셀 사이의 거리를 반환하려고 시도할 때 오류가 발생하면 NULL을 반환하는 H3_GRID_DISTANCE의 특수 버전이에요.

출처: Snowflake SQL Reference - H3_TRY_GRID_DISTANCE

본문

구문

H3_TRY_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 값이에요.

반환 값

INTEGER 값 또는 NULL을 반환해요.

  • 계산에 성공하면 두 H3 셀 사이의 그리드 셀 단위 거리를 나타내는 INTEGER 값을 반환해요.
  • 그리드 거리를 계산할 수 없으면(예: 두 셀이 서로 이웃하지 않은 베이스 셀에 속한 경우) 오류를 보고하지 않고 NULL을 반환해요.

사용 시 참고 사항

사용 시 참고 사항은 H3_GRID_DISTANCE를 참고하세요.

예시

다음 예시는 두 셀 사이의 거리 계산을 시도해요. 두 셀이 서로 이웃하지 않은 베이스 셀에 속하기 때문에 함수는 거리 계산에 실패하고 NULL을 반환해요.

SELECT H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719);

+--------------------------------------------------------------+
| H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719) |
|--------------------------------------------------------------|
|                                                         NULL |
+--------------------------------------------------------------+

두 H3 셀 사이의 거리를 성공적으로 계산하는 예시는 H3_GRID_DISTANCE를 참고하세요.

더 알아보기