지리공간 함수
지리공간 함수 (GeoSpatial Functions)
지리공간 데이터를 다루기 위해 Pinot은 기하 구성 요소 분석, 공간 관계 결정, 지오메트리 조작을 위한 함수 집합을 제공해요. 특히 ST_ 접두사로 시작하는 지리공간 함수는 SQL/MM 명세를 지원해요.
출처: 문서
본문
지리공간 데이터를 조작하기 위해 Pinot은 기하 구성 요소 분석, 공간 관계 결정, 지오메트리 조작을 위한 함수 집합을 제공해요. 특히 ST_ 접두사로 시작하는 지리공간 함수는 SQL/MM 명세를 지원해요.
다음 지리공간 함수는 Pinot에서 기본 제공돼요:
집계 (Aggregations)
ST_Union(geometry[] g1_array) → Geometry
이 집계 함수는 지오메트리 집합에서 MULTI 지오메트리 또는 NON-MULTI 지오메트리를 반환해요. NULL 지오메트리는 무시해요.
생성자 (Constructors)
ST_GeomFromText(String wkt) → Geometry
선택적 공간 시스템 참조와 함께 WKT 표현에서 지오메트리 타입 객체를 반환해요.
ST_GeomFromWKB(bytes wkb) → Geometry
WKB 표현에서 지오메트리 타입 객체를 반환해요.
ST_Point(double x, double y) → Point
주어진 좌표 값으로 지오메트리 타입 점 객체를 반환해요.
ST_Polygon(String wkt) → Polygon
WKT 표현에서 지오메트리 타입 다각형 객체를 반환해요.
ST_GeogFromWKB(bytes wkb) → Geography
Well-Known Binary 지오메트리 표현 (WKB)에서 지리(geography) 인스턴스를 생성해요.
ST_GeogFromText(String wkt) → Geography
Well-Known Text 표현 또는 확장형 (WKT)에서 지정한 지리 값을 반환해요.
측정 (Measurements)
ST_Area(Geometry/Geography g) → double
지오메트리 타입에 대해 지오메트리의 2D 유클리드 면적을 반환해요. 지리의 경우 지구의 구형 모델을 사용해 다각형 또는 다중 다각형의 면적을 제곱미터로 반환해요.
ST_Distance(Geometry/Geography g1, Geometry/Geography g2) → double
지오메트리 타입에 대해 두 지오메트리 사이의 2차원 데카르트 최소 거리(공간 참조 기반)를 투영 단위로 반환해요. 지리의 경우 두 SphericalGeography 점 사이의 대원 거리(great-circle distance)를 미터로 반환해요. g1, g2는 같은 타입이어야 해요.
ST_GeometryType(Geometry g) → String
지오메트리의 타입을 문자열로 반환해요. 예: ST_Linestring, ST_Polygon, ST_MultiPolygon 등.
출력 (Outputs)
ST_AsBinary(Geometry/Geography g) → bytes
지오메트리의 WKB 표현을 반환해요.
ST_AsText(Geometry/Geography g) → string
지오메트리/지리의 WKT 표현을 반환해요.
변환 (Conversion)
toSphericalGeography(Geometry g) → Geography
Geometry 객체를 구형 지리 객체로 변환해요.
toGeometry(Geography g) → Geometry
구형 지리 객체를 Geometry 객체로 변환해요.
관계 (Relationship)
ST_Contains(Geometry/Geography, Geometry/Geography) → boolean
두 번째 지오메트리/지리의 어떤 점도 첫 번째 지오메트리/지리의 외부에 있지 않고, 첫 번째 지오메트리의 내부 점이 적어도 하나는 두 번째 지오메트리의 내부에 있을 때만 true를 반환해요. 경고: Geography에 대한 ST_Contains는 근사치만 제공해요.
ST_Equals(Geometry, Geometry) → boolean
주어진 지오메트리가 같은 지오메트리/지리를 나타내면 true를 반환해요.
ST_Within(Geometry, Geometry) → boolean
첫 번째 지오메트리가 완전히 두 번째 지오메트리 안에 있으면 true를 반환해요.
추가 참고 페이지 (Additional Reference Pages)
| Function | Function |
|---|---|
| ST_Union | GridDistance |
| GridDisk | ST_AsGeoJSON |
| ST_GeogFromGeoJSON | ST_GeomFromGeoJSON |