ST_GeomFromText
ST_GeomFromText는 입력 지오메트리의 WKT(Well-Known Text) 표현으로부터 지오메트리 객체를 구성합니다.
ST_GeomFromText는 3DZ, 3DM 및 4D를 허용합니다. 여기서 지오메트리 유형에는 각각 Z, M 또는 ZM 접두사가 붙습니다.
구문
ST_GeomFromText(wkt_string)
ST_GeomFromText(wkt_string, srid)
인수
- wkt_string
-
지오메트리의 WKT 표현인
VARCHAR
데이터 형식의 값입니다.WKT 키워드
EMPTY
를 사용하여 빈 점, 빈 점이 있는 다중 점 또는 빈 점이 있는 지오메트리 컬렉션을 지정할 수 있습니다. 다음 예에서는 하나의 빈 점과 하나의 비어 있지 않은 점이 있는 다중 점을 생성합니다.ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');
- srid
-
SRID(공간 참조 식별자)인
INTEGER
데이터 형식의 값입니다. SRID 값이 제공되면 반환된 지오메트리에 이 SRID 값이 있습니다. 그렇지 않으면 반환된 지오메트리의 SRID 값이 0으로 설정됩니다.
반환 타입
GEOMETRY
wkt_string 또는 srid가 null이면 null이 반환됩니다.
srid가 음수이면 null이 반환됩니다.
wkt_string이 유효하지 않으면 오류가 반환됩니다.
srid가 유효하지 않으면 오류가 반환됩니다.
예시
다음 SQL은 WKT 표현 및 SRID 값으로부터 지오메트리 객체를 구성합니다.
SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);
st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000