데브러너 (DevRunner)

14.16.3 WKT 값으로부터 Geometry 값을 생성하는 함수

이 함수들은 인자로 Well-Known Text (WKT) 표현과 선택적으로 공간 참조 시스템 식별자(SRID)를 받습니다. 이들은 해당 geometry를 반환합니다. WKT 포맷에 대한 설명은 Well-Known Text (WKT) Format를 참조하십시오.

이 섹션의 함수들은 카테시안 또는 지리 공간 참조 시스템(SRS) 중 어느 것이든 인자에서 감지하고, 그 SRS에 적합한 결과를 반환합니다.

ST_GeomFromText()는 첫 번째 인자로 임의의 geometry 타입의 WKT 값을 허용합니다. 다른 함수들은 각 geometry 타입의 geometry 값을 생성하기 위한 타입별 생성 함수를 제공합니다.

ST_MPointFromText() 및 ST_GeomFromText()와 같이 MultiPoint 값의 WKT 포맷 표현을 허용하는 함수들은 값 내의 개별 포인트가 괄호로 둘러싸이는 것을 허용합니다. 예를 들어, 다음 두 함수 호출은 모두 유효합니다:

1ST_MPointFromText('MULTIPOINT (1 1, 2 2, 3 3)')
2ST_MPointFromText('MULTIPOINT ((1 1), (2 2), (3 3))')

ST_GeomFromText()처럼 WKT geometry 컬렉션 인자를 허용하는 함수들은 OpenGIS 'GEOMETRYCOLLECTION EMPTY' 표준 구문과 MySQL 'GEOMETRYCOLLECTION()' 비표준 구문을 모두 인식합니다. ST_AsWKT()처럼 WKT 값을 생성하는 함수들은 'GEOMETRYCOLLECTION EMPTY' 표준 구문을 생성합니다:

1mysql> SET @s1 = ST_GeomFromText('GEOMETRYCOLLECTION()');
2mysql> SET @s2 = ST_GeomFromText('GEOMETRYCOLLECTION EMPTY');
3mysql> SELECT ST_AsWKT(@s1), ST_AsWKT(@s2);
4+--------------------------+--------------------------+
5| ST_AsWKT(@s1)            | ST_AsWKT(@s2)            |
6+--------------------------+--------------------------+
7| GEOMETRYCOLLECTION EMPTY | GEOMETRYCOLLECTION EMPTY |
8+--------------------------+--------------------------+

별도로 명시되지 않는 한, 이 섹션의 함수들은 geometry 인자를 다음과 같이 처리합니다:

geometry 인자 중 하나라도 NULL 이거나 구문상 올바르게 형성된 geometry가 아니거나, SRID 인자가 NULL이면 반환 값은 NULL입니다.
기본적으로, 지리 좌표(latitude, longitude)는 geometry 인자의 공간 참조 시스템에서 지정한 순서대로 해석됩니다. 기본 축 순서를 재정의하기 위해 선택적인 options 인자를 줄 수 있습니다.
options는 쉼표로 구분된 key=value 리스트로 구성됩니다.
허용되는 key 값은 axis-order 하나뿐이며, 허용되는 값은 lat-long, long-lat, srid-defined(기본값)입니다.

options 인자가 NULL이면 반환 값은 NULL입니다. options 인자가 잘못된 경우, 그 이유를 나타내는 에러가 발생합니다.

SRID 인자가 정의되지 않은 공간 참조 시스템(SRS)을 참조하는 경우 ER_SRS_NOT_FOUND 에러가 발생합니다.
지리 SRS geometry 인자의 경우, 어떤 인자라도 경도 또는 위도가 범위를 벗어나면 에러가 발생합니다:
- 경도 값이 범위 (−180, 180]에 있지 않으면 ER_LONGITUDE_OUT_OF_RANGE 에러가 발생합니다.
- 위도 값이 범위 [−90, 90]에 있지 않으면 ER_LATITUDE_OUT_OF_RANGE 에러가 발생합니다.

표시된 범위는 도 단위입니다. SRS가 다른 단위를 사용하는 경우, 범위는 그 단위에서의 해당 값들을 사용합니다. 정확한 범위 한계는 부동소수점 산술 때문에 약간 달라집니다.

다음 함수들은 WKT 값으로부터 geometry를 생성하는 데 사용할 수 있습니다:

ST_GeomCollFromText(wkt [, srid [, options]]), ST_GeometryCollectionFromText(wkt [, srid [, options]]), ST_GeomCollFromTxt(wkt [, srid [, options]])

WKT 표현과 SRID를 사용하여 GeometryCollection 값을 생성합니다.

이들 함수는 이 섹션 서두에서 설명한 대로 인자를 처리합니다.

1mysql> SET @g = "MULTILINESTRING((10 10, 11 11), (9 9, 10 10))";
2mysql> SELECT ST_AsText(ST_GeomCollFromText(@g));
3+--------------------------------------------+
4| ST_AsText(ST_GeomCollFromText(@g))         |
5+--------------------------------------------+
6| MULTILINESTRING((10 10,11 11),(9 9,10 10)) |
7+--------------------------------------------+