[GIS] ST_NUMGEOMETRIES 함수 :: 멀티지오메트리(MultiGeometry) 객체의 요소 개수

ST_NUMGEOMETRIES는 Google BigQuery에서 사용되는 함수로, 주어진 GEOGRAPHY 객체에 포함된 개별 지리적 요소(geometry)의 개수를 반환합니다. 이 함수는 주로 멀티지오메트리(MultiGeometry) 객체에서 각 개별 요소의 수를 계산하는 데 유용합니다.

사용법

ST_NUMGEOMETRIES(geography)

• geography: 개별 지리적 요소의 개수를 계산할 GEOGRAPHY 타입의 객체입니다.

반환값

• ST_NUMGEOMETRIES 함수는 주어진 GEOGRAPHY 객체에 포함된 개별 지리적 요소의 개수를 나타내는 정수를 반환합니다. 단일 지리적 객체는 1을 반환하고, 멀티지오메트리 객체는 포함된 요소의 개수를 반환합니다.

예시

1. 단일 다각형 객체의 요소 개수 계산이 쿼리는 단일 다각형 객체의 요소 개수를 반환합니다. 결과는 1입니다.
2. SELECT ST_NUMGEOMETRIES(ST_GEOGFROMTEXT('POLYGON((30 10, 40 40, 20 40, 10 20, 30 10))')) AS num_geometries;
3. 멀티다각형 객체의 요소 개수 계산이 쿼리는 멀티다각형 객체에 포함된 다각형의 개수를 반환합니다. 결과는 2입니다.
4. SELECT ST_NUMGEOMETRIES(ST_GEOGFROMTEXT('MULTIPOLYGON(((30 10, 40 40, 20 40, 10 20, 30 10)), ((15 5, 25 25, 5 25, 15 5)))')) AS num_geometries;
5. 단일 선형 객체의 요소 개수 계산이 쿼리는 단일 선형 객체의 요소 개수를 반환합니다. 결과는 1입니다.
6. SELECT ST_NUMGEOMETRIES(ST_GEOGFROMTEXT('LINESTRING(-122.084 37.422, -122.085 37.423)')) AS num_geometries;
7. 멀티라인스트링 객체의 요소 개수 계산이 쿼리는 멀티라인스트링 객체에 포함된 선의 개수를 반환합니다. 결과는 2입니다.
8. SELECT ST_NUMGEOMETRIES(ST_GEOGFROMTEXT('MULTILINESTRING((-122.084 37.422, -122.085 37.423), (-122.086 37.424, -122.087 37.425))')) AS num_geometries;

주요 사항

• GEOGRAPHY 객체: ST_NUMGEOMETRIES 함수는 GEOGRAPHY 타입의 객체에 대해 작동합니다.
• 개별 지리적 요소: 이 함수는 주어진 GEOGRAPHY 객체에 포함된 개별 지리적 요소의 개수를 계산하여 반환합니다. 단일 지리적 객체는 1을 반환하고, 멀티지오메트리 객체는 포함된 요소의 개수를 반환합니다.
• 응용 분야: ST_NUMGEOMETRIES는 지리적 데이터를 분석할 때 각 개별 요소의 개수를 확인하는 데 유용합니다. 예를 들어, 멀티폴리곤 데이터의 각 다각형 개수를 분석하거나, 멀티라인스트링 데이터의 선 개수를 확인하는 데 사용할 수 있습니다.

ST_NUMGEOMETRIES 함수를 통해 GEOGRAPHY 객체에 포함된 개별 지리적 요소의 개수를 쉽게 계산할 수 있으며, 이를 통해 다양한 지리적 문제를 효율적으로 해결할 수 있습니다.