카테고리:

지리공간 함수

H3_TRY_POLYGON_TO_CELLS_STRINGS

(GEOGRAPHY 오브젝트로 지정된) 다각형이 포함된 중심을 가진 H3 셀에 대한 16진수 IDs의 VARCHAR 값으로 구성된 배열 을 반환하려고 할 때 오류가 발생하면 NULL를 반환하는 H3_POLYGON_TO_CELLS_STRINGS 의 특수 버전입니다.

구문

H3_TRY_POLYGON_TO_CELLS_STRINGS( <geography_polygon> , <target_resolution> )
Copy

인자

geography_polygon

다각형을 나타내는 GEOGRAPHY 오브젝트입니다.

target_resolution

반환된 H3 셀에 사용할 H3 분해능 을 지정하는 0과 15(포함) 사이의 INTEGER입니다.

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

반환

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

  • 함수가 성공적으로 계산을 수행할 수 있으면 지정된 입력 다각형에 포함된 중심을 가진 H3 셀의 16진수 IDs에 대한 VARCHAR 값으로 구성된 배열을 반환합니다.

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

사용법 노트

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

예

다음 예제는 (GEOGRAPHY 오브젝트로 지정된) 다각형에 도심이 포함되어 있는 H3 셀의 16진수 ID에 대한 VARCHAR 값으로 구성된 배열을 반환합니다. 지정된 분해능에서 지정된 육각형을 덮는 셀이 있는 배열이 허용된 크기 제한을 초과하므로 함수는 NULL을 반환합니다.

SELECT H3_TRY_POLYGON_TO_CELLS_STRINGS(
  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 h3_cells_in_polygon;
Copy
+---------------------+
| H3_CELLS_IN_POLYGON |
|---------------------|
| NULL                |
+---------------------+

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

언어: 한국어