카테고리:

지리 공간 함수, 변환 함수

ST_GEOGRAPHYFROMWKT

WKT (well-known text) 또는 EWKT (extended well-known text) 입력을 구문 분석하고 GEOGRAPHY 형식의 값을 반환합니다.

별칭:

ST_GEOGFROMWKT , ST_GEOGRAPHYFROMEWKT , ST_GEOGFROMEWKT , ST_GEOGRAPHYFROMTEXT , ST_GEOGFROMTEXT

참고 항목:

TO_GEOGRAPHY

구문

ST_GEOGRAPHYFROMWKT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGFROMWKT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGRAPHYFROMEWKT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGFROMEWKT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGRAPHYFROMTEXT( <varchar_expression> [ , <allow_invalid> ] )

ST_GEOGFROMTEXT( <varchar_expression> [ , <allow_invalid> ] )
Copy

인자

필수:

varchar_expression

인자는 유효한 지리 공간 오브젝트를 나타내는 WKT 또는 EWKT의 문자열 식이어야 합니다.

선택 사항:

allow_invalid

TRUE인 경우 입력 도형이 유효하지 않고 복구할 수 없더라도 함수가 GEOGRAPHY 또는 GEOMETRY 오브젝트를 반환해야 하는 것으로 지정됩니다. 자세한 내용은 유효하지 않은 지리 공간 도형을 처리하는 방법 지정하기 섹션을 참조하십시오.

반환

함수는 GEOGRAPHY 형식의 값을 반환합니다.

사용법 노트

  • 입력을 WKT 또는 EWKT로 구문 분석할 수 없는 경우, 오류가 발생합니다.

  • 입력 형식이 EWKT이고 SRID가 4326이 아닌 경우, 오류가 발생합니다. EWKT 및 EWKB 처리에 관한 참고 사항 을 참조하십시오.

  • WKT, EWKT, GeoJSON에 있는 좌표의 경우, 경도가 위도 앞에 나타납니다(예: POINT(lon lat)).

예

다음 예는 WKT 형식으로 설명된 지리 공간 오브젝트에 대한 GEOGRAPHY 오브젝트를 반환합니다.

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';
Copy
select ST_GEOGRAPHYFROMWKT('POINT(-122.35 37.55)');
Copy
+---------------------------------------------+
| ST_GEOGRAPHYFROMWKT('POINT(-122.35 37.55)') |
|---------------------------------------------|
| POINT(-122.35 37.55)                        |
+---------------------------------------------+

다음 예는 WKT 형식으로 설명된 Z축을 가진 지리 공간 오브젝트에 대한 GEOGRAPHY 오브젝트를 반환합니다.

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';
Copy
select ST_GEOGRAPHYFROMWKT('POINTZ(-122.35 37.55 30)');
Copy
+-------------------------------------------------+
| ST_GEOGRAPHYFROMWKT('POINTZ(-122.35 37.55 30)') |
|-------------------------------------------------|
| POINTZ(-122.35 37.55 30)                        |
+-------------------------------------------------+

다음 예는 EWKT 형식으로 설명된 지리 공간 오브젝트에 대한 GEOGRAPHY 오브젝트를 반환합니다.

-- Set the output format to EWKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';
Copy
select ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)');
Copy
+--------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)') |
|--------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                         |
+--------------------------------------------------------+
언어: 한국어