H3_COVERAGE_STRINGS
H3_COVERAGE_STRINGS
H3_COVERAGE_STRINGS는 GEOGRAPHY 객체로 지정된 모양을 완전히 덮는 최소 H3 셀 집합을 식별하는 16진수 ID(VARCHAR 값)의 배열을 반환하는 지리 공간 함수예요.
본문
카테고리: 지리 공간 함수
구문 (Syntax)
H3_COVERAGE_STRINGS( <geography_expression> , <target_resolution> )
인자 (Arguments)
<geography_expression> — GEOGRAPHY 객체예요.
<target_resolution> — 반환되는 H3 셀에 사용할 H3 해상도를 지정하는 0에서 15까지(포함)의 INTEGER예요. 다른 INTEGER 값을 지정하면 오류가 발생해요.
반환값 (Returns)
지정된 입력 모양을 완전히 덮는 최소 H3 셀 집합의 16진수 ID에 대한 VARCHAR 값 배열을 반환해요.
사용 시 유의사항 (Usage notes)
- 이 함수는 구면 근사(spherical approximation)를 사용해, 지구 표면의 점들이 직선이 아니라 호로 연결된 것처럼 취급해요. 평면 근사가 필요하다면 H3_POLYGON_TO_CELLS_STRINGS를 대신 사용해요.
- 셀의 경계가 입력 모양과 교차하면 그 셀은 결과 집합에 포함돼요.
예시 (Examples)
다음 예시는 지정된 Polygon을 완전히 덮는 최소 H3 셀 집합을 식별하는 16진수 ID 배열을 반환해요.
SELECT H3_COVERAGE_STRINGS(
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 |
|----------------------------------|
| [ |
| "882830870bfffff", |
| "8828308703fffff", |
| "8828308739fffff", |
| "8828308709fffff", |
| "8828308701fffff", |
| "8828308715fffff" |
| ] |
|----------------------------------|