카테고리:

지리공간 함수

H3_TRY_COVERAGE

(GEOGRAPHY 오브젝트로 지정된) 도형을 완전히 덮는 H3 셀의 최소 세트를 식별하는 IDs(INTEGER 값)로 구성된 배열 의 반환을 시도할 때 오류가 발생하는 경우 NULL을 반환하는 H3_COVERAGE 의 특수 버전입니다.

구문

H3_TRY_COVERAGE( <geography_expression> , <target_resolution> )
Copy

인자

geography_expression

GEOGRAPHY 오브젝트입니다.

target_resolution

반환된 H3 셀에 사용하려는 H3 해상도 를 지정하는 0과 15(포함) 사이의 INTEGER입니다.

다른 INTEGER 값을 지정하면 오류가 발생합니다.

반환

INTEGER 값 또는 NULL로 구성된 배열을 반환합니다.

  • 함수가 성공적으로 계산을 수행할 수 있으면 지정된 입력 모양을 완전히 덮는 최소 H3 셀 집합의 IDs에 대한 INTEGER 값으로 구성된 배열을 반환합니다.

  • 함수가 계산을 성공적으로 수행할 수 없는 경우 오류를 보고하지 않고 NULL을 반환합니다.

사용법 노트

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

예

다음 예제는 (GEOGRAPHY 오브젝트로 지정된) 도형을 완전히 덮는 H3 셀의 최소 집합을 식별하는 IDs 배열을 반환하려고 시도합니다. 지정된 분해능에서 지정된 육각형을 덮는 셀이 있는 배열이 허용된 크기 제한을 초과하므로 함수는 NULL을 반환합니다.

SELECT H3_TRY_COVERAGE(
  TO_GEOGRAPHY('POLYGON((-108.959 40.948,
                         -109.015 37.077,
                         -102.117 36.956,
                         -102.134 40.953,
                         -108.959 40.948))'
              ), 15) AS set_of_h3_cells_covering_polygon;
Copy
+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| NULL                             |
+----------------------------------+

ID로 구성된 배열을 성공적으로 반환하는 예제는 H3_COVERAGE 섹션을 참조하십시오.

언어: 한국어