카테고리:

지리공간 함수

H3_TRY_GRID_PATH

두 셀 사이의 선을 나타내는 H3 셀의 IDs가 포함된 VARIANT 값으로 구성된 배열의 반환을 시도할 때 오류가 발생하면 NULL을 반환하는 H3_GRID_PATH 의 특수 버전입니다.

구문

H3_TRY_GRID_PATH( <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 값입니다.

반환

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

  • 함수가 계산에 성공하면 cell_id_1 및 cell_id_2 로 지정된 셀 사이의 라인을 나타내는 H3 셀의 IDs를 포함하는 VARIANT 값으로 구성된 배열을 반환합니다. IDs 형식에 대한 내용은 H3_GRID_PATH 섹션을 참조하십시오.

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

사용법 노트

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

예

다음 예제에서는 두 셀 사이의 라인을 반환하려고 시도합니다. 셀이 인접하지 않은 베이스 셀에 속하기 때문에 이 함수는 라인 반환에 실패하고 NULL을 반환합니다.

SELECT H3_TRY_GRID_PATH('813d7ffffffffff', '81343ffffffffff');
Copy
+--------------------------------------------------------+
| H3_TRY_GRID_PATH('813D7FFFFFFFFFF', '81343FFFFFFFFFF') |
|--------------------------------------------------------|
| NULL                                                   |
+--------------------------------------------------------+

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

언어: 한국어