카테고리:

지리 공간 함수

H3_POLYGON_TO_CELLS

(GEOGRAPHY 오브젝트로 지정된) 다각형에 도심이 포함되어 있는 H3 셀의 ID에 대한 INTEGER 값으로 구성된 ARRAY를 반환합니다.

참고 항목:

H3_POLYGON_TO_CELLS_STRINGS , H3_COVERAGE

구문

H3_POLYGON_TO_CELLS( <geography_polygon> , <target_resolution> )
Copy

인자

geography_polygon

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

target_resolution

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

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

반환

지정된 입력 다각형에 도심이 포함된 H3 셀의 ID에 대한 INTEGER 값으로 구성된 ARRAY를 반환합니다.

사용법 노트

  • 이 함수는 지표면상의 점을 곡선 호가 아닌 직선으로 연결된 것처럼 처리하는 평면 근사를 사용합니다. 구형 근사가 필요하면 H3_COVERAGE 를 대신 사용하십시오.

  • 도심이 다각형에 포함되어 있는 셀은 다각형 내에 있는 것으로 간주됩니다.

  • 함수에서 반환된 ARRAY에 FLATTEN 을 적용할 때 각각의 값을 명시적으로 정수로 캐스트 하십시오.

다음 예에서는 도심이 지정된 다각형에 포함된 H3 셀의 ID로 구성된 ARRAY를 반환합니다.

SELECT H3_POLYGON_TO_CELLS(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'
  ),
  9) AS h3_cells_in_polygon;
Copy
+-----------------------+
| H3_CELLS_IN_POLYGON   |
|-----------------------|
| [                     |
|   617700171176476671, |
|   617700171168874495, |
|   617700171177525247, |
|   617700171167563775, |
|   617700171225497599, |
|   617700171188011007, |
|   617700171168350207, |
|   617700171168612351, |
|   617700171167825919  |
| ]                     |
+-----------------------+