H3_COVERAGE

H3_COVERAGE

모양(GEOGRAPHY 객체로 지정)을 완전히 덮는 최소 H3 셀 집합을 식별하는 ID(INTEGER 값) 배열을 반환해요.

출처: Snowflake H3_COVERAGE 함수 문서

본문

참고 항목: H3_COVERAGE_STRINGS, H3_POLYGON_TO_CELLS

구문 (Syntax)

H3_COVERAGE(  ,  )

인자 (Arguments)

  • geography_expression — GEOGRAPHY 객체예요.
  • target_resolution — 반환되는 H3 셀에 사용할 H3 해상도를 지정하는 0~15(포함) 사이의 INTEGER예요. 다른 INTEGER 값을 지정하면 오류가 발생해요.

반환 값 (Returns)

지정된 입력 모양을 완전히 덮는 최소 H3 셀 집합의 ID에 대한 INTEGER 값의 ARRAY를 반환해요.

사용 노트 (Usage Notes)

  • 이 함수는 구형 근사(spherical approximation)를 사용하는데, 지구 표면의 점들을 직선이 아니라 호(arc)로 연결된 것처럼 취급해요. 평면 근사가 필요하면 H3_POLYGON_TO_CELLS를 대신 사용해요.
  • 셀의 경계가 입력 모양과 교차하면 그 셀은 결과 집합에 포함돼요.
  • 함수가 반환하는 ARRAY에 FLATTEN을 적용할 때 각 값을 명시적으로 정수로 캐스팅하세요.

예제 (Examples)

다음 예제는 지정된 Polygon을 완전히 덮는 최소 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;

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

더 알아보기