도형을 덮는 H3 인덱스
| 항목 | 값 |
|---|---|
| 화면 이름 | Get H3 indices covering a geometry |
| 식별자 | polygonToH3V1 |
| 지원 실행 방식 | Batch, Faster, Streaming |
| 범주 | 지리공간 (Geospatial) |
| 반환 자료형 | Array<H3 Index> |
도형을 해상도 0~15의 H3 인덱스 집합으로 변환합니다. 다각형에는 전체를 덮는 셀 집합, 내부에 완전히 포함되는 셀, 중심점이 내부에 있는 셀의 세 방식을 지원합니다. 예상 인덱스 수가 700만 개를 넘으면 null을 반환합니다.
입력 인자
| 이름 | 지정 여부 | 자료형 | 의미와 조건 |
|---|---|---|---|
Cover type | 필수 | Enum<Centroid, Inner, Outer> | 다각형에 적용할 H3 포함 방식입니다. |
Geometry | 필수 | Expression<Geometry> | 다각형, 선 또는 점 유형의 GeoJSON입니다. |
Resolution | 필수 | Expression<Byte | Integer | Long | Short> | H3 격자 해상도이며 0~15를 양 끝값까지 허용합니다. |
입출력 예시
예시 1: 기본 동작
인자 값:
Cover type:CENTROIDGeometry:polygonResolution: 5
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ 85283473fffffff ] |
| null | null |
| {"type":"Polygon","coordinates":[[]]} | [ ] |
| {"type":"Polygon","coordinates":[]} | null |
| {"type":"MultiPolygon","coordinates":[[]]} | null |
| {"type":"MultiPolygon","coordinates":[[[],[]]]} | [ ] |
| {"type":"MultiPolygon","coordinates":[]} | [ ] |
예시 2: 기본 동작
인자 값:
Cover type:CENTROIDGeometry:polygonResolution: 6
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ 862834707ffffff, 86283470fffffff, 862834717ffffff, 86283471fffffff, 862834727ffffff, 86283472fffffff, 862834737ffffff ] |
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866732],[-121.862223289025,37.35392645... | [ 862834707ffffff, 86283470fffffff, 862834717ffffff, 86283471fffffff, 862834727ffffff, 86283472fffffff, 862834737ffffff, 8628347a7ffffff ] |
예시 3: 기본 동작
인자 값:
Cover type:INNERGeometry:polygonResolution: 6
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ 862834707ffffff ] |
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866732],[-121.862223289025,37.35392645... | [ 862834707ffffff, 862834717ffffff ] |
예시 4: 기본 동작
인자 값:
Cover type:OUTERGeometry:polygonResolution: 6
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ 86283408fffffff, 86283409fffffff, 8628340d7ffffff, 8628340dfffffff, 86283444fffffff, 86283446fffff... |
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866732],[-121.862223289025,37.35392645... | [ 86283408fffffff, 86283409fffffff, 8628340d7ffffff, 8628340dfffffff, 86283444fffffff, 86283445fffff... |
예시 5: 기본 동작
인자 값:
Cover type:OUTERGeometry:polygonResolution: 2
| polygon | 출력 |
|---|---|
| {"type":"Polygon", "coordinates":[[[-112.943779561642,34.817254144594],[-112.943779561642,33.0067953... | [ 82264ffffffffff, 82265ffffffffff, 8226c7fffffffff, 8226cffffffffff, 8226d7fffffffff, 8226dffffffff... |
예시 6: 기본 동작
인자 값:
Cover type:INNERGeometry:polygonResolution: 5
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ 85283473fffffff ] |
| null | null |
| {"type":"Polygon","coordinates":[[]]} | [ ] |
| {"type":"Polygon","coordinates":[]} | null |
| {"type":"MultiPolygon","coordinates":[[]]} | null |
| {"type":"MultiPolygon","coordinates":[[[],[]]]} | [ ] |
| {"type":"MultiPolygon","coordinates":[]} | [ ] |
예시 7: 기본 동작
인자 값:
Cover type:CENTROIDGeometry:polygonResolution: 4
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ ] |
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866732],[-121.862223289025,37.35392645... | [ ] |
예시 8: 기본 동작
인자 값:
Cover type:INNERGeometry:polygonResolution: 4
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ ] |
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866732],[-121.862223289025,37.35392645... | [ ] |
예시 9: 기본 동작
인자 값:
Cover type:OUTERGeometry:polygonResolution: 4
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ 8428341ffffffff, 8428345ffffffff, 8428347ffffffff ] |
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866732],[-121.862223289025,37.35392645... | [ 8428341ffffffff, 8428345ffffffff, 8428347ffffffff ] |
예시 10: 기본 동작
인자 값:
Cover type:OUTERGeometry:polygonResolution: 5
| polygon | 출력 |
|---|---|
| null | null |
| {"type":"Polygon","coordinates":[[]]} | [ ] |
| {"type":"Polygon","coordinates":[]} | null |
| {"type":"MultiPolygon","coordinates":[[]]} | null |
| {"type":"MultiPolygon","coordinates":[[[],[]]]} | [ ] |
| {"type":"MultiPolygon","coordinates":[]} | [ ] |
| {"type":"Polygon","coordinates":[[[-121.915080327056,37.271355866731],[-121.862223289024,37.35392645... | [ 8528340bfffffff, 8528340ffffffff, 85283447fffffff, 85283463fffffff, 85283473fffffff, 85283477fffffff, 8528347bfffffff ] |
예시 11: 기본 동작
인자 값:
Cover type:CENTROIDGeometry:polygonResolution: 3
| polygon | 출력 |
|---|---|
| {"type":"MultiLineString","coordinates":[[[0,0],[15,15],[30,-15],[45,15],[60,0]],[[15,30],[-15,-15]]]} | [ 833f80fffffffff, 833f82fffffffff, 833f85fffffffff, 833f91fffffffff, 833f93fffffffff, 833faefffffff... |
예시 12: 기본 동작
인자 값:
Cover type:CENTROIDGeometry:polygonResolution: 4
| polygon | 출력 |
|---|---|
| {"type":"MultiPoint","coordinates":[[60,60],[60,58],[58,58],[58,60]]} | [ 8410c03ffffffff, 8410c47ffffffff, 8410ee7ffffffff, 8410eedffffffff ] |
예시 13: 기본 동작
인자 값:
Cover type:OUTERGeometry:polygonResolution: 10
| polygon | 출력 |
|---|---|
| {"type":"Polygon","coordinates":[[[-122.02869363438222,37.26184847647239],[-122.02805421389088,37.26... | [ 8a283408b2c7fff, 8a283408b2cffff, 8a283408b2dffff, 8a283408b2effff, 8a28340d6597fff, 8a28340d65b7fff, 8a2834725967fff ] |
예시 14: 기본 동작
인자 값:
Cover type:CENTROIDGeometry:polygonResolution: 4
| polygon | 출력 |
|---|---|
| {"coordinates":[[[[60,60],[60,58],[58,58],[58,60],[60,60]],[[59.5,59.7],[59.8,58.1],[58.1,58.2],[58.2,59.4],[59.5,59.7]]], [[[55,56],[55.5,55.7],[55.7,55.7],[55,57],[55,56]]]],"type":"MultiPolygon"} | [ 8410c01ffffffff, 8410c47ffffffff, 8410c57ffffffff, 8410e33ffffffff, 8410ee5ffffffff, 8410ee7ffffffff, 8410f23ffffffff ] |
예시 15: 기본 동작
인자 값:
Cover type:INNERGeometry:polygonResolution: 4
| polygon | 출력 |
|---|---|
| {"coordinates":[[[[60,60],[60,58],[58,58],[58,60],[60,60]],[[59.5,59.7],[59.8,58.1],[58.1,58.2],[58.2,59.4],[59.5,59.7]]], [[[55,56],[55.5,55.7],[55.7,55.7],[55,57],[55,56]]]],"type":"MultiPolygon"} | [ ] |
예시 16: 기본 동작
인자 값:
Cover type:OUTERGeometry:polygonResolution: 4
| polygon | 출력 |
|---|---|
| {"coordinates":[[[[60,60],[60,58],[58,58],[58,60],[60,60]],[[59.5,59.7],[59.8,58.1],[58.1,58.2],[58.2,59.4],[59.5,59.7]]], [[[55,56],[55.5,55.7],[55.7,55.7],[55,57],[55,56]]]],"type":"MultiPolygon"} | [ 8410c01ffffffff, 8410c03ffffffff, 8410c09ffffffff, 8410c0bffffffff, 8410c0dffffffff, 8410c1dffffff... |
예시 17: 기본 동작
인자 값:
Cover type:OUTERGeometry:polygonResolution: 3
| polygon | 출력 |
|---|---|
| {"coordinates":[[[60.0,60.0],[50.0,60.0],[50.0,50.0],[60.0,50.0],[60.0,60.0]],[[57.0,57.0],[55.0,52.0],[52.0,52.0],[50.0,57.0],[57.0,57.0]]],"type":"Polygon"} | [ 83100afffffffff, 831018fffffffff, 831019fffffffff, 83101afffffffff, 83101bfffffffff, 83101dfffffff... |
예시 18: 기본 동작
인자 값:
Cover type:CENTROIDGeometry:polygonResolution: 4
| polygon | 출력 |
|---|---|
| {"type":"MultiLineString","coordinates":[[[60,60],[60,58],[58,58],[58,60]],[[59.8,58.1],[58.1,58.2],[58.2,59.4],[59.5,59.7]],[[55,56],[55.5,55.7],[55.7,55.7],[55,57]]]} | [ 8410c01ffffffff, 8410c03ffffffff, 8410c09ffffffff, 8410c0bffffffff, 8410c0dffffffff, 8410c1dffffff... |
예시 19: 기본 동작
인자 값:
Cover type:OUTERGeometry:polygonResolution: 9
| polygon | 출력 |
|---|---|
| {"coordinates":[[[-110, 38], [-110,82],[-170,82],[-170,38],[-110, 38]]],"type":"Polygon"} | null |
긴 구조값 안의 줄임표는 생략한 내용을 나타냅니다.