카테고리:: 지리 공간 함수

H3_COVERAGE¶

(GEOGRAPHY 오브젝트로 지정된) 도형을 완전히 덮는 H3 셀의 최소 세트를 식별하는 ID(INTEGER 값)로 구성된 ARRAY를 반환합니다.

참고 항목:: H3_COVERAGE_STRINGS , H3_POLYGON_TO_CELLS

구문¶

H3_COVERAGE( <geography_expression> , <target_resolution> )

Copy

인자¶

geography_expression

GEOGRAPHY 오브젝트입니다.

target_resolution

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

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

반환¶

지정된 입력 도형을 완전히 포함하는 H3 셀의 최소 세트에 대한 ID의 INTEGER 값으로 구성된 ARRAY를 반환합니다.

사용법 노트¶

이 함수는 지표면상의 점을 직선이 아닌 호로 연결된 것처럼 처리하는 구형 근사를 사용합니다. 평면 근사가 필요하면 H3_POLYGON_TO_CELLS 를 대신 사용하십시오.
경계가 입력 도형과 교차하는 경우 셀이 결과 세트에 포함됩니다.
함수에서 반환된 ARRAY에 FLATTEN 을 적용할 때 각각의 값을 명시적으로 정수로 캐스트 하십시오.

예¶

다음 예에서는 지정된 다각형을 완전히 덮는 H3 셀의 최소 세트를 식별하는 ID로 구성된 ARRAY를 반환합니다.

SELECT H3_COVERAGE(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'),
  8) AS set_of_h3_cells_covering_polygon;

Copy

+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| [                                |
|   613196571542028287,            |
|   613196571548319743,            |
|   613196571598651391,            |
|   613196571539931135,            |
|   613196571560902655,            |
|   613196571550416895             |
| ]                                |
+----------------------------------+