ST_COVEREDBY

ST_COVEREDBY

한 지리 공간 객체의 어떤 점도 다른 지리 공간 객체 밖에 있지 않으면 TRUE를 돌려주는 공간 함수예요. ST_COVERS(g2, g1)과 동등한 관계예요.

출처: 공식 문서

본문

한 지리 공간 객체의 어떤 점도 다른 지리 공간 객체 밖에 있지 않으면 TRUE를 반환합니다. 다시 말해:

  • GEOGRAPHY 객체 g1이 GEOGRAPHY 객체 g2 밖에 있지 않습니다.
  • GEOMETRY 객체 g1이 GEOMETRY 객체 g2 밖에 있지 않습니다.

이것은 ST_COVERS(g2, g1)과 동등합니다.

ST_COVEREDBY와 ST_WITHIN은 비슷해 보일 수 있지만, 두 함수는 미묘한 차이가 있습니다. "covered by"와 "within"의 차이에 대한 자세한 내용은 Dimensionally Extended 9-Intersection Model (DE-9IM)을 참고하세요.

참고 이 함수는 입력 값으로 GeometryCollection이나 FeatureCollection을 지원하지 않습니다.

팁 검색 최적화 서비스(search optimization service)를 사용해 이 함수를 호출하는 쿼리의 성능을 개선할 수 있습니다. 자세한 내용은 Search optimization service를 참고하세요.

참고 (See also): ST_COVERS , ST_WITHIN

구문 (Syntax)

ST_COVEREDBY( <geography_expression_1> , <geography_expression_2> )

ST_COVEREDBY( <geometry_expression_1> , <geometry_expression_2> )

인자 (Arguments)

geography_expression_1

GeometryCollection이나 FeatureCollection이 아닌 GEOGRAPHY 객체.

geography_expression_2

GeometryCollection이나 FeatureCollection이 아닌 GEOGRAPHY 객체.

geometry_expression_1

GeometryCollection이나 FeatureCollection이 아닌 GEOMETRY 객체.

geometry_expression_2

GeometryCollection이나 FeatureCollection이 아닌 GEOMETRY 객체.

반환값 (Returns)

BOOLEAN.

사용 참고 (Usage notes)

  • GEOMETRY 객체의 경우, 두 입력 GEOMETRY 객체가 다른 SRID를 가지면 함수는 오류를 보고합니다.

예제 (Examples)

GEOGRAPHY 예제

ST_COVEREDBY 함수의 간단한 사용을 보여줍니다:

create table geospatial_table_01 (g1 GEOGRAPHY, g2 GEOGRAPHY);
insert into geospatial_table_01 (g1, g2) values
    ('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0))', 'POLYGON((1 1, 2 1, 2 2, 1 2, 1 1))');

SELECT ST_COVEREDBY(g1, g2)
    FROM geospatial_table_01;
+----------------------+
| ST_COVEREDBY(G1, G2) |
|----------------------|
| False                |
+----------------------+

더 알아보기 (Learn more)