> For the complete documentation index, see [llms.txt](https://docs.tibero.com/tibero-manuals/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tibero.com/tibero-manuals/7.2.6.manuals/spatial-reference-guide/spatial-functions.md).

# Spatial 함수

Tibero Spatial에서 제공되는 함수에 대해 설명합니다.

## 개요

Spatial 함수는 기본적으로 제공되는 함수들이 있고, 특정 환경(c++11 이상, linux, x86, 64bit)에서만 제공되는 함수들이 있습니다. 또한 기본적으로 제공되지만, 위 환경에서 SRID를 인자로 줘서 좌표계를 고려한 연산을 제공하는 함수들도 있습니다.

본 안내서에서는 특정 환경에서만 제공되는 함수들은 함수명 뒤에 '#' 기호를, 기본적으로 제공되지만 특정 환경에서 좌표계를 고려한 연산을 추가 제공하는 함수들은 함수명 뒤에 '$' 기호를 붙여서 표기합니다.

※ 예제에서 사용되는 `GIS` 테이블 생성문은 공간 인덱스 문서에 수록되어 있습니다.

### ST\_AGGR\_ASTWKB(#)

**ST\_AGGR\_ASTWKB**는 GEOMETRY 객체를 TWKB(Tiny Well Known Binary) 형태로 반환하는 집합 함수입니다. GEOMETRY 객체마다 식별자를 포함한 집합의 TWKB를 반환합니다.

ST\_AGGR\_ASTWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/JRvd7vrc6ST27ZNg4KeS/Spatial%201.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="153">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom_expr</td><td>GEOMETRY 객체를 나타내는 임의의 연산식</td></tr><tr><td>num_expr</td><td>geom_expr 객체 각각에 해당하는 식별자</td></tr><tr><td>num1</td><td><ul><li>TWKB로 표현될 좌표의 소수점 이하 유효숫자의 개수</li><li>기본값으로 0이 설정되어 있음</li></ul></td></tr><tr><td>num2</td><td><ul><li>반환될 TWKB에 인코딩된 GEOMETRY 객체의 길이 요소를 포함할지를 결정하는 인자</li><li>1을 넣을 경우 반환되는 TWKB가 길이를 포함하게 됩니다. 기본 설정은 길이를 포함하지 않음</li></ul></td></tr><tr><td>num3</td><td><ul><li>반환될 TWKB에 GEOMETRY 객체의 경계상자를 포함할지를 결정하는 인자</li><li>1을 넣을 경우 반환되는 TWKB가 경계 상자를 포함하게 됨</li><li>기본 설정은 경계 상자를 포함하지 않음</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_AGGR\_ASTWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_AGGR_ASTWKB(GEOM, ID) FROM GIS;

ST_AGGR_ASTWKB(GEOM,ID)
-----------------------------------------------------------------------------------
07040ACA01CC01CE01D001D201D401D601D801DA01DC010100020204000202020202020002020202
02050002020202020202020202040300010502020200000201000001030003050000001818000017
1700050C14000206000001050005000D000606000005050006000201050202020000020100000101
05040400040400000303000700020100020202000204040202071007000201000202020002040402
02
```

```
SQL> SELECT ST_AGGR_ASTWKB(GEOM, ID, 3, 1, 1) FROM GIS;

ST_AGGR_ASTWKB(GEOM,ID,3,1,1)
-----------------------------------------------------------------------------------
6707DB0200C0BB0100C0BB010ACA01CC01CE01D001D201D401D601D801DA01DC0161030AD00F00D0
0F00D00FD00F640311D00FD00FD00FD00F02D00FD00FD00FD00F620311D00FD00FD00FD00F02D00F
D00FD00FD00F65031BD00FF02ED00FC03E0202D00FD00FD00FD00F02D00FD00FD00FA01F63031AD0
0FD00FD00FD00F0105D00FD00FD00F0000D00FCF0F0000CF0F63033E00C0BB0100C0BB0103050000
00C0BB01C0BB010000BFBB01BFBB010005E05DA09C0100D00FF02E0000CF0FEF2E000500AF6D00F0
2EF02E0000EF2EEF2E0066032DD00FC03ED00FC03E020105D00FD00FD00F0000D00FCF0F0000CF0F
0105A01FA01F00A01FA01F00009F1F9F1F0067032AD00FA01FD00FA01F0261030AD00F00D00F00D0
0FD00F620311A01FD00FA01FD00F02A01FA01FD00FD00F67120067032AD00FA01FD00FA01F026103
0AD00F00D00F00D00FD00F620311A01FD00FA01FD00F02A01FA01FD00FD00F
```

### ST\_AREA($)

**ST\_AREA**은 GEOMETRY 객체의 면적을 반환하는 함수입니다. POLYGON 객체에 대해 면적을 계산하여 반환합니다. POINT, LINESTRING에 대해서는 0을 반환합니다. MULTI 타입의 GEOMETRY 객체에 대해서는 내부의 GEOMETRY들의 계산 결과의 합을 값을 반환합니다.

좌표계 정보가 회전체인 경우, 평방미터 단위로 해당 객체의 곡면의 면적을 구합니다. 회전타원체에 대한 연산이 기본 설정이며, 더 빠른 계산을 원하면 구면좌표계에 대한 연산으로 바꿀 수 있습니다.

ST\_AREA의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/EOQA1GSMp6rylf4oi8wH/Spatial%202.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="144">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>default</td><td><ul><li>연산 방식을 설정</li><li>좌표계 정보가 회전체 좌표계인 경우 기본으로 회전타원체에 대한 연산으로 설정되어 있고, 0을 인자로 주면 구면좌표계에 대해 연산</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_AREA 함수를 사용하는 예입니다.

```
SQL> SELECT ST_AREA(GEOM), ST_ASTEXT(GEOM) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'MULTIPOLYGON';

ST_AREA(GEOM)
--------------
ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
            5
MULTIPOLYGON(((1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3)))
```

### ST\_ASBINARY

**ST\_ASBINARY**는 GEOMETRY 객체를 WKB(Well Known Binary)형태로 반환하는 함수입니다.

ST\_ASBINARY의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/myGv7MDb9xrswVTLPuK2/Spatial%203.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="138">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ASBINARY 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM), ST_ASBINARY(GEOM) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POINT';
ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
ST_ASBINARY(GEOM)
-----------------------------------------------------------------------------------
POINT(1 1)
0101000000000000000000F03F000000000000F03F
```

### ST\_ASGEOJSON

**ST\_ASGEOJSON**는 GEOMETRY 객체를 GEOJSON 형태로 반환하는 함수입니다.

ST\_ASGEOJSON의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/QQKwW0yPX4Kd9pD9l6il/Spatial%204.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="130">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>num1</td><td><ul><li>좌표의 유효숫자의 갯수를 입력</li><li>기본값으로 9가 설정되어 있음</li></ul></td></tr><tr><td>num2</td><td><ul><li>반환될 GEOJASON 형식의 옵션을 설정</li><li><p>기본값으로 8이 설정되어 있음</p><ul><li>0 : 아무 옵션도 추가하지 않음</li><li>1 : 해당 GEOMETRY의 최소 경계 사각형을 추가</li><li>2 : Short CRS 형식으로 좌표를 출력(예 EPSG:4326)</li><li>4 : Long CRS 형식으로 좌표를 출력<br>(예: urn:ogc:def:crs:EPSG::4326)</li><li>8 : SRID가 4326이 아닌 경우 Short CRS 형식으로 좌표를 출력<br>(기본값)</li></ul></li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_ASGEOJSON 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASGEOJSON(GEOM) FROM GIS;

ST_ASGEOJSON(GEOM)
-----------------------------------------------------------------------------------
{"type":"Point","coordinates":[1,1]}
{"type":"MultiPoint","coordinates":[[1,1],[2,2]]}
{"type":"LineString","coordinates":[[1,1],[2,2]]}
{"type":"MultiLineString","coordinates":[[[1,1],[2,2]],[[3,3],[4,5]]]}
{"type":"Polygon","coordinates":[[[1,1],[2,1],[2,2],[1,2],[1,1]]]}
{"type":"Polygon","coordinates":[[[0,0],[0,12],[12,12],[12,0],[0,0]],[[6,10],[6,
11],[9,11],[9,10],[6,10]],[[6,3],[6,6],[9,6],[9,3],[6,3]]]}
{"type":"MultiPolygon","coordinates":[[[[1,1],[2,1],[2,2],[1,2],[1,1]]],[[[3,3],
[3,5],[5,5],[5,3],[3,3]]]]}
{"type":"GeometryCollection","geometries":[{"type":"Point","coordinates":[1,1]},
{"type":"LineString","coordinates":[[2,2],[3,3]]}]}
{"type":"GeometryCollection","geometries":[]}
{"type":"GeometryCollection","geometries":[{"type":"Point","coordinates":[1,1]},
{"type":"LineString","coordinates":[[2,2],[3,3]]}]}
```

### ST\_ASGML

**ST\_ASGML**는 GEOMETRY 객체를 GML 형태로 반환하는 함수입니다.

ST\_ASGML의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/vrFfmrXYON6cSYeXNhwy/Spatial%205.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="151">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>num1</td><td><ul><li>좌표의 유효숫자의 갯수를 입력</li><li>기본값으로 15가 설정되어 있음</li></ul></td></tr><tr><td>num2</td><td><ul><li>반환될 GML 형식의 옵션을 설정</li><li><p>기본값으로 0(Short CRS)이 설정되어 있음</p><ul><li>0 : Short CRS 형식으로 좌표를 출력 (기본값)</li><li>1 : Long CRS 형식으로 좌표를 출력</li></ul></li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_ASGML 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASGML(GEOM) FROM GIS;

ST_ASGML(GEOM)
-----------------------------------------------------------------------------------
<gml:Point><coordinates>1,1</coordinates></gml:Point>
<gml:MultiPoint><pointMember><gml:Point><coordinates>1,1</coordinates></gml:Poin
t></pointMember><pointMember><gml:Point><coordinates>2,2</coordinates></gml:Poin
t></pointMember></gml:MultiPoint>
<gml:LineString><coordinates>1,1 2,2</coordinates></gml:LineString>
<gml:MultiLineString><lineStringMember><gml:LineString><coordinates>1,1 2,2</coo
rdinates></gml:LineString></lineStringMember><lineStringMember><gml:LineString><
coordinates>3,3 4,5</coordinates></gml:LineString></lineStringMember></gml:Multi
LineString>
<gml:Polygon><outerBoundaryIs><LinearRing><coordinates>1,1 2,1 2,2 1,2 1,1</coor
dinates></LinearRing></outerBoundaryIs></gml:Polygon>
<gml:Polygon><outerBoundaryIs><LinearRing><coordinates>0,0 0,12 12,12 12,0 0,0</
coordinates></LinearRing></outerBoundaryIs><innerBoundaryIs><LinearRing><coordin
ates>6,10 6,11 9,11 9,10 6,10</coordinates></LinearRing></innerBoundaryIs><inner
BoundaryIs><LinearRing><coordinates>6,3 6,6 9,6 9,3 6,3</coordinates></LinearRin
g></innerBoundaryIs></gml:Polygon>
<gml:MultiPolygon><polygonMember><gml:Polygon><outerBoundaryIs><LinearRing><coor
dinates>1,1 2,1 2,2 1,2 1,1</coordinates></LinearRing></outerBoundaryIs></gml:Po
lygon></polygonMember><polygonMember><gml:Polygon><outerBoundaryIs><LinearRing><
coordinates>3,3 3,5 5,5 5,3 3,3</coordinates></LinearRing></outerBoundaryIs></gm
l:Polygon></polygonMember></gml:MultiPolygon>
<gml:MultiGeometry><geometryMember><gml:Point><coordinates>1,1</coordinates></gm
l:Point></geometryMember><geometryMember><gml:LineString><coordinates>2,2 3,3</c
oordinates></gml:LineString></geometryMember></gml:MultiGeometry>

<gml:MultiGeometry><geometryMember><gml:Point><coordinates>1,1</coordinates></gm
l:Point></geometryMember><geometryMember><gml:LineString><coordinates>2,2 3,3</c
oordinates></gml:LineString></geometryMember></gml:MultiGeometry>
```

### ST\_ASKML <a href="#bookmark53" id="bookmark53"></a>

**ST\_ASKML**는 GEOMETRY 객체를 KML 형태로 반환하는 함수입니다.

ST\_ASKML의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/cp9QHkLhD1TuD5rT5WvS/Spatial%206.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="144">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li><li>GEOMETRYCOLLECTION 타입의 객체가 올 경우 에러를 반환</li></ul></td></tr><tr><td>num</td><td><ul><li>좌표의 유효숫자의 갯수를 입력</li><li>기본값으로 15가 설정되어 있음</li></ul></td></tr><tr><td>str</td><td><ul><li>반환될 KML의 네임스페이스 접두사를 설정</li><li>기본 네임스페이스는 접두사를 쓰지 않음</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_ASKML 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASKML(ST_SETSRID(GEOM,4326)) FROM GIS WHERE ST_GEOMETRYTYPE(GEOM)
     NOT LIKE 'GEOMETRYCOLLECTION';
     
ST_ASKML(GEOM)
-----------------------------------------------------------------------------------
<Point><coordinates>1,1</coordinates></Point>
<MultiGeometry><Point><coordinates>1,1</coordinates></Point><Point><coordinates>
2,2</coordinates></Point></MultiGeometry>
<LineString><coordinates>1,1 2,2</coordinates></LineString>
<MultiGeometry><LineString><coordinates>1,1 2,2</coordinates></LineString><LineS
tring><coordinates>3,3 4,5</coordinates></LineString></MultiGeometry>
<Polygon><outerBoundaryIs><LinearRing><coordinates>1,1 2,1 2,2 1,2 1,1</coordina
tes></LinearRing></outerBoundaryIs></Polygon>
<Polygon><outerBoundaryIs><LinearRing><coordinates>0,0 0,12 12,12 12,0 0,0</coor
dinates></LinearRing></outerBoundaryIs><innerBoundaryIs><LinearRing><coordinates
>6,10 6,11 9,11 9,10 6,10</coordinates></LinearRing></innerBoundaryIs><innerBoun
daryIs><LinearRing><coordinates>6,3 6,6 9,6 9,3 6,3</coordinates></LinearRing></
innerBoundaryIs></Polygon>
<MultiGeometry><Polygon><outerBoundaryIs><LinearRing><coordinates>1,1 2,1 2,2 1,
2 1,1</coordinates></LinearRing></outerBoundaryIs></Polygon><Polygon><outerBound
aryIs><LinearRing><coordinates>3,3 3,5 5,5 5,3 3,3</coordinates></LinearRing></o
uterBoundaryIs></Polygon></MultiGeometry>
```

### ST\_ASTEXT <a href="#bookmark55" id="bookmark55"></a>

**ST\_ASTEXT**는 GEOMETRY 객체를 WKT(Well Known Text) 형태로 반환하는 함수입니다.

ST\_ASTEXT의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/kvCsHOIw0tM9Y0nTC0eI/Spatial%207.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="250">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ASTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM) FROM GIS;

ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
POINT(1 1)
MULTIPOINT((1 1),(2 2))
LINESTRING(1 1,2 2)
MULTILINESTRING((1 1,2 2),(3 3,4 5))
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
MULTIPOLYGON(((1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3)))
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
GEOMETRYCOLLECTION EMPTY
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
```

### ST\_ASTWKB(#) <a href="#bookmark57" id="bookmark57"></a>

**ST\_ASTWKB**는 GEOMETRY 객체를 TWKB(Tiny Well Known Binary) 형태로 반환하는 함수입니다.

ST\_ASTWKB의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/QeRnZSihWIWEX9aoNcQf/Spatial%208.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="158">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>num1</td><td><ul><li>TWKB로 표현될 좌표의 소수점 이하 유효숫자 개수</li><li>기본값으로 0이 설정되어 있음</li></ul></td></tr><tr><td>num2</td><td><ul><li>반환될 TWKB에 인코딩된 GEOMETRY 객체의 길이 요소를 포함할지를 결정하는 인자</li><li>1을 넣을 경우 반환되는 TWKB가 길이를 포함하게 됨</li><li>기본 설정은 길이를 포함하지 않음</li></ul></td></tr><tr><td>num3</td><td><ul><li>반환될 TWKB에 GEOMETRY 객체의 경계상자를 포함할지를 결정하는 인자</li><li>1을 넣을 경우 반환되는 TWKB가 경계 상자를 포함하게 됨</li><li>기본 설정은 경계 상자를 포함하지 않음</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_ASTWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTWKB(GEOM) FROM GIS;

ST_ASTWKB(GEOM)
-----------------------------------------------------------------------------------
01000202
04000202020202
02000202020202
05000202020202020202020204
0300010502020200000201000001
0300030500000018180000171700050C14000206000001050005000D0006060000050500
060002010502020200000201000001010504040004040000030300
0700020100020202000204040202
0710
0700020100020202000204040202
```

```
SQL> SELECT ST_ASTWKB(GEOM, 3, 1, 1) FROM GIS;

ST_ASTWKB(GEOM,3,1,1)
-----------------------------------------------------------------------------------
61030AD00F00D00F00D00FD00F
640311D00FD00FD00FD00F02D00FD00FD00FD00F
620311D00FD00FD00FD00F02D00FD00FD00FD00F
65031BD00FF02ED00FC03E0202D00FD00FD00FD00F02D00FD00FD00FA01F
63031AD00FD00FD00FD00F0105D00FD00FD00F0000D00FCF0F0000CF0F
63033E00C0BB0100C0BB010305000000C0BB01C0BB010000BFBB01BFBB010005E05DA09C0100D00F
F02E0000CF0FEF2E000500AF6D00F02EF02E0000EF2EEF2E00
66032DD00FC03ED00FC03E020105D00FD00FD00F0000D00FCF0F0000CF0F0105A01FA01F00A01FA0
1F00009F1F9F1F00
67032AD00FA01FD00FA01F0261030AD00F00D00F00D00FD00F620311A01FD00FA01FD00F02A01FA0
1FD00FD00F
671200
67032AD00FA01FD00FA01F0261030AD00F00D00F00D00FD00F620311A01FD00FA01FD00F02A01FA0
1FD00FD00F
```

### ST\_AZIMUTH($)

**ST\_AZIMUTH**은 POINT 객체 1과 POINT 객체 2를 잇는 선분과, POINT 객체 1의 수직 상방 선분이 이루는 각을 시계방향으로 측정하여 호도 단위로 반환합니다. 이는 회전체 좌표계 상에서 북극기준 방위각에 해당합니다.

회전체 좌표계 상의 GEOMETRY와 평면 좌표계 GEOMETRY를 인자로 받을 수 있습니다.\
POINT가 아닌 타입의 GEOMETRY 객체를 넣을 경우 예외를 반환합니다.

ST\_AZIMUTH의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/g4cTKgXttaPb5Tbt9E9q/Spatial%209.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="150">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>POINT 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>POINT 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_AZIMUTH 함수를 사용하는 예입니다.

```
SQL> SELECT ST_AZIMUTH(ST_GEOMFROMTEXT('POINT(1 1)', 4326),
     ST_GEOMFROMTEXT('POINT(1 0)',4326)) AZIMUTH FROM DUAL;
     
   AZIMUTH
----------
3.14159265
```

### ST\_BOUNDARY <a href="#bookmark61" id="bookmark61"></a>

**ST\_BOUNDARY**는 주어진 GEOMETRY 객체의 경계를 반환하는 함수입니다.\
GEOMETRY 객체의 타입이 GEOMETRYCOLLECTION일 경우 에러를 반환합니다.

ST\_BOUNDARY의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/45Usi9XCLTk9KtkbxV24/Spatial%2010.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="181">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_BOUNDARY 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM),ST_ASTEXT(ST_BOUNDARY(GEOM))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) NOT LIKE 'GEOMETRYCOLLECTION';
     
ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(ST_BOUNDARY(GEOM))
-----------------------------------------------------------------------------------
POINT(1 1)
GEOMETRYCOLLECTION EMPTY

MULTIPOINT((1 1),(2 2))
GEOMETRYCOLLECTION EMPTY

LINESTRING(1 1,2 2)
MULTIPOINT((1 1),(2 2))

MULTILINESTRING((1 1,2 2),(3 3,4 5))
MULTIPOINT((1 1),(2 2),(3 3),(4 5))

POLYGON((1 1,2 1,2 2,1 2,1 1))
LINESTRING(1 1,2 1,2 2,1 2,1 1)

POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
MULTILINESTRING((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9
6,9 3,6 3))

MULTIPOLYGON(((1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3)))
MULTILINESTRING((1 1,2 1,2 2,1 2,1 1),(3 3,3 5,5 5,5 3,3 3))
```

### ST\_BUFFER($) <a href="#bookmark63" id="bookmark63"></a>

**ST\_BUFFER**는 주어진 GEOMETRY 객체로부터 일정 거리 안에 있는 모든 점을 표현하는 GEOMETRY 객체를 반환하는 함수입니다. 좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다.

ST\_BUFFER의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/obbddy6rECbg6j5AKI5C/Spatial%2011.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="132">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>expr</td><td>임의의 연산식이며 주어진 GEOMETRY 객체로부터의 거리를 의미</td></tr></tbody></table>

* 예제

다음은 ST\_BUFFER 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM),ST_AREA(ST_BUFFER(GEOM,10))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POINT';
     
ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
ST_AREA(ST_BUFFER(GEOM,10))
--------------------------
POINT(1 1)
                312.144515
```

### ST\_BUILDAREA(#) <a href="#bookmark65" id="bookmark65"></a>

**ST\_BUILDAREA**는 주어진 GEOMETRY의 선분 구성요소로 형성될 수 있는 POLYGON을 반환하는 함수입니다. 입력 GEOMETRY의 선분 구성요소가 POLYGON을 형성하지 못할 경우 NULL을 반환합니다.

ST\_BUILDAREA의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/3xuMNnDifYhqOA7f3fAV/Spatial%2012.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="151">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_BUILDAREA 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_BUILDAREA(GEOM))FROM GIS;

ST_ASTEXT(ST_BUILDAREA(GEOM))
-----------------------------------------------------------------------------------
GEOMETRYCOLLECTION EMPTY
GEOMETRYCOLLECTION EMPTY
GEOMETRYCOLLECTION EMPTY
GEOMETRYCOLLECTION EMPTY
POLYGON((1 1,1 2,2 2,2 1,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,9 10,9 11,6 11,6 10),(6 3,9 3,9 6,6 6,6 3))
MULTIPOLYGON(((1 1,1 2,2 2,2 1,1 1)),((3 3,3 5,5 5,5 3,3 3)))
GEOMETRYCOLLECTION EMPTY
POLYGON EMPTY
GEOMETRYCOLLECTION EMPTY
```

### ST\_CENTROID($) <a href="#bookmark67" id="bookmark67"></a>

**ST\_CENTROID**는 주어진 GEOMETRY 객체의 중심을 반환하는 함수입니다. 좌표계 정보를 통해 회전체 좌 표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다. 더 빠른 연산을 원하면 구면좌표계에 대한 연산으로 바꿀 수 있습니다.

ST\_CENTROID의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/m19z8eZiGuhsF9APLFn1/Spatial%2013.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="133">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>default</td><td><ul><li>연산 방식을 설정</li><li>좌표계 정보가 회전체 좌표계인 경우 기본으로 회전타원체에 대한 연산으로 설정되어 있고, 0을 인자로 주면 구면좌표계에 대해 연산</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_CENTROID 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM),ST_ASTEXT(ST_CENTROID(GEOM))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POLYGON';
     
ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(ST_CENTROID(GEOM))
-----------------------------------------------------------------------------------
POLYGON((1 1,2 1,2 2,1 2,1 1))
POINT(1.5 1.5)

POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
POINT(5.8636363636364 6)
```

### ST\_COLLECT <a href="#bookmark69" id="bookmark69"></a>

**ST\_COLLECT**는 GEOMETRY들을 MULTI 타입의 도형으로 묶어서 반환하는 집합 함수입니다. 집합 함수이므로 GEOMETRY 객체들을 한데 모은 집합에 대한 결과를 반환합니다. 변형된 형태로 두 GEOMETRY 객체를 인자로 받을 수 있습니다.

ST\_COLLECT의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/vNsfKuP38yiWNxrcyMWo/Spatial%2014.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="160">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom_expr</td><td>GEOMETRY 객체를 나타내는 임의의 연산식</td></tr></tbody></table>

* 예제

다음은 ST\_COLLECT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_COLLECT(A.GEOM, B.GEOM))
     FROM GIS A,GIS B WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'POINT'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'LINESTRING';

ST_ASTEXT(ST_COLLECT(A.GEOM,B.GEOM))
-----------------------------------------------------------------------------------
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(1 1,2 2))
```

* 예제

다음은ST\_COLLECT 함수에 Table의 geometry column을 인자로 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_COLLECT(GEOM)) FROM GIS;

ST_ASTEXT(ST_COLLECT(GEOM))
--------------------------------------------------------------------------------
GEOMETRYCOLLECTION(POINT(1 1),MULTIPOINT((1 1),(2 2)),LINESTRING(1 1,2 2),MULTIL
INESTRING((1 1,2 2),(3 3,4 5)),POLYGON((1 1,2 1,2 2,1 2,1 1)),POLYGON((0 0,0 12,
12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3)),MULTIPOLYGON((
(1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3))),GEOMETRYCOLLECTION(POINT(1 1),LI
NESTRING(2 2,3 3)),GEOMETRYCOLLECTION EMPTY,GEOMETRYCOLLECTION(POINT(1 1),LINEST
RING(2 2,3 3)))
```

### ST\_CONTAINS <a href="#bookmark71" id="bookmark71"></a>

**ST\_CONTAINS**는 GEOMETRY 객체 2가 GEOMETRY 객체 1의 외부에 존재하지 않고, 객체 1의 내부에 하나 이상의 점이 존재할 때만 1을 반환하는 함수입니다.

ST\_CONTAINS의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/sQzFDQvI52BRXXHhqwDQ/Spatial%2015.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="135">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>포함하는 GEOMETRY 객체를 나타내는 GEOMETRY 타입어어야 함</td></tr><tr><td>geom2</td><td>포함되는 GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_CONTAINS 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM)
     FROM GIS A,GIS B WHERE ST_CONTAINS(A.GEOM,B.GEOM) >0
     AND ST_GEOMETRYTYPE(A.GEOM) LIKE 'MULTILINESTRING'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'LINESTRING';
     
ST_ASTEXT(A.GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
-----------------------------------------------------------------------------------
MULTILINESTRING((1 1,2 2),(3 3,4 5))
LINESTRING(1 1,2 2)
```

### ST\_CONVEXHULL <a href="#bookmark73" id="bookmark73"></a>

**ST\_CONVEXHULL**은 주어진 GEOMETRY의 convex hull을 반환하는 함수입니다. Convex hull은 GEOMETRY 객체를 포함하는 제일 작은 볼록한 폐곡선을 의미합니다.

ST\_CONVEXHULL의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/JvoKGlQBGJfmAR5Hlcdw/Spatial%2016.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="167">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_CONVEXHULL 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM),ST_ASTEXT(ST_CONVEXHULL(GEOM))
    FROM GIS;
    
ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(ST_CONVEXHULL(GEOM))
-----------------------------------------------------------------------------------
POINT(1 1)
POINT(1 1)

MULTIPOINT((1 1),(2 2))
LINESTRING(1 1,2 2)

LINESTRING(1 1,2 2)
LINESTRING(1 1,2 2)


MULTILINESTRING((1 1,2 2),(3 3,4 5))
POLYGON((1 1,4 5,3 3,1 1))	


POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((1 1,1 2,2 2,2 1,1 1))

POLYGON((0 0,0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
POLYGON((0 0,0 0,0 12,12 12,12 0,0 0))

MULTIPOLYGON(((1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3)))
POLYGON((1 1,1 2,3 5,5 5,5 3,2 1,1 1))

GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
LINESTRING(1 1,3 3)

GEOMETRYCOLLECTION EMPTY
GEOMETRYCOLLECTION EMPTY

GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
LINESTRING(1 1,3 3)
```

### ST\_CROSSES <a href="#bookmark75" id="bookmark75"></a>

**ST\_CROSSES**는 주어진 두 GEOMETRY 객체가 교차하면 1을 반환하는 함수입니다. 포함관계에 있거나, 경계가 닿아 있는 경우는 해당하지 않습니다.

ST\_CROSSES의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/PeydwbQxGas1y38uyPwQ/Spatial%2017.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="139">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_CROSSES 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM)
     FROM GIS A,GIS B WHERE ST_CROSSES(A.GEOM,B.GEOM) >0
     AND ST_GEOMETRYTYPE(A.GEOM) NOT LIKE 'GEOMETRYCOLLECTION'
     AND ST_GEOMETRYTYPE(B.GEOM) NOT LIKE 'GEOMETRYCOLLECTION';
     
ST_ASTEXT(A.GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
-----------------------------------------------------------------------------------
POLYGON((1 1,2 1,2 2,1 2,1 1))
MULTILINESTRING((1 1,2 2),(3 3,4 5))
MULTILINESTRING((1 1,2 2),(3 3,4 5))
POLYGON((1 1,2 1,2 2,1 2,1 1))
```

### ST\_COVEREDBY(#) <a href="#bookmark77" id="bookmark77"></a>

**ST\_COVEREDBY**는 GEOMETRY 객체 1의 어떤 점도 GEOMETRY 객체 2의 외부에 있지 않은 경우 1을 반환하는 함수입니다. 회전체 좌표계 상의 GEOMETRY만을 인자로 받으며, 그렇지 않은 경우 예외를 반환 합니다.

ST\_COVEREDBY의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/5bXAkrXf0F1l1ydNrcAq/Spatial%2018.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="133">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_COVEREDBY 함수를 사용하는 예입니다.

```
SQL> SELECT ST_COVEREDBY(ST_GEOMFROMTEXT('POINT(0 0)',4326),
     ST_BUFFER(ST_GEOMFROMTEXT('POINT(0 0)',4326),1)) COVEREDBY FROM DUAL;

COVEREDBY
---------
        1
```

### ST\_COVERS(#)

**ST\_COVERS**는 GEOMETRY 객체 2의 어떤 점도 GEOMETRY 객체 1의 외부에 있지 않은 경우 1을 반환하는 함수입니다. 회전체 좌표계 상의 GEOMETRY만을 인자로 받으며, 그렇지 않은 경우 예외를 반환합니다.

ST\_COVERS의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/lDgiO1bmC2KVuVhca467/Spatial%2019.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="138">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_COVERS 함수를 사용하는 예입니다.

```
SQL> SELECT ST_COVERS(ST_BUFFER(ST_GEOMFROMTEXT('POINT(0 0)',4326),1),
     ST_GEOMFROMTEXT('POINT(0 0)',4326)) COVERS FROM DUAL;
     
COVERS
------
     1
```

### ST\_DIFFERENCE($) <a href="#bookmark81" id="bookmark81"></a>

**ST\_DIFFERENCE**는 GEOMETRY 객체 2와 겹치지 않는 객체 1의 부분을 반환하는 함수입니다. 좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다.

ST\_DIFFERENCE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/4U7yRIrT7UUyYGI0dnOj/Spatial%2020.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="133">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_DIFFERENCE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM),
     ST_ASTEXT(ST_DIFFERENCE(A.GEOM,B.GEOM)) FROM GIS A,GIS B
     WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'LINESTRING'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'LINESTRING';

ST_ASTEXT(A.GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(ST_DIFFERENCE(A.GEOM,B.GEOM))
-----------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
LINESTRING(1 1,2 2)
GEOMETRYCOLLECTION EMPTY
```

### ST\_DIMENSION <a href="#bookmark83" id="bookmark83"></a>

**ST\_DIMENSION**은 GEOMETRY 객체의 차원을 반환하는 함수입니다.

ST\_DIMENSION의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/UmFupR9wQXIuSzUoeKQZ/Spatial%2021.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="150">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_DIMENSION 함수를 사용하는 예입니다.

```
SQL> SELECT ST_DIMENSION(GEOM), ST_ASTEXT(geom) FROM GIS;

ST_DIMENSION(GEOM)
----------------------
ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
                 0
POINT(1 1)
                 0
MULTIPOINT((1 1),(2 2))

                 1
LINESTRING(1 1,2 2)

                 1
MULTILINESTRING((1 1,2 2),(3 3,4 5))

                 2
POLYGON((1 1,2 1,2 2,1 2,1 1))

                 2
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))

                 2
MULTIPOLYGON(((1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3)))

                 1
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))

                 0
GEOMETRYCOLLECTION EMPTY

                 1
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))

```

### ST\_DISJOINT <a href="#bookmark85" id="bookmark85"></a>

**ST\_DISJOINT**는 두 GEOMETRY 객체가 어떤 영역도 공유하지 않을 때 1을 반환하는 함수입니다.

ST\_DISJOINT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/8qVUnqMgRxpRmNGODnUb/Spatial%2022.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="141">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_DISJOINT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_DISJOINT(A.GEOM,B.GEOM),
     ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM) FROM GIS A,GIS B
     WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'LINESTRING'
    AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'LINESTRING';

ST_DISJOINT(A.GEOM,B.GEOM)
----------------------------
ST_ASTEXT(A.GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
-----------------------------------------------------------------------------------
                        0
LINESTRING(1 1,2 2)
LINESTRING(1 1,2 2)
```

### ST\_DISTANCE($) <a href="#bookmark87" id="bookmark87"></a>

**ST\_DISTANCE**는 두 GEOMETRY 객체 사이의 최단 거리를 반환하는 함수입니다. 좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다. 더 빠른 연산을 원하면 구면좌표계에 대한 연산으로 바꿀 수 있습니다.

ST\_DISTANCE의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/1tYjKCjSEDnhPUeXgGaX/Spatial%2023.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="134">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>geom2</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>default</td><td><ul><li>연산 방식을 설정</li><li>좌표계 정보가 회전체 좌표계인 경우 기본으로 회전타원체에 대한 연산으로 설정되어 있고, 0을 인자로 주면 구면좌표계에 대해 연산</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_DISTANCE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_DISTANCE(ST_GEOMFROMTEXT('LINESTRING(2 2,0 0)'),
     ST_GEOMFROMTEXT('LINESTRING(4 2,6 0)')) DISTANCE FROM DUAL;
     
 DISTANCE
---------
       2
```

### ST\_DWITHIN # <a href="#bookmark89" id="bookmark89"></a>

**ST\_DWITHIN**는 두 GEOMETRY 객체가 지정된 거리안에 있는지 여부를 반환하는 함수입니다. 좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다. 더 빠른 연산을 원하면 구면좌표계에 대한 연산으로 바꿀 수 있습니다.

ST\_DWITHIN의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/aMUyzg40BuUOAre9Liin/Spatial%2024.png" alt=""><figcaption><p><strong>[그림 24] ST_DWITHIN 문법</strong></p></figcaption></figure>

* 구성요소

<table><thead><tr><th width="279">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>geom2</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>num</td><td><ul><li>지정된 거리를 입력</li><li>GEOMETRY의 경우 설정된 좌표계의 단위를, GEOGRAPHY의 경우 meter 단위를 사용</li></ul></td></tr><tr><td>default</td><td><ul><li>연산 방식을 설정</li><li>좌표계 정보가 회전체 좌표계인 경우 기본으로 회전타원체에 대한 연산으로 설정되어 있고, 0을 인자로 주면 구면좌표계에 대해 연산</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_DWITHIN 함수를 사용하는 예입니다.

```
SQL> SELECT ST_DWITHIN(ST_GEOMFROMTEXT('LINESTRING(2 2,0 0)'),
     ST_GEOMFROMTEXT('LINESTRING(4 2,6 0)'), 3) DWITHIN FROM DUAL;

DWITHIN
-------
      1
```

### ST\_ENDPOINT <a href="#bookmark91" id="bookmark91"></a>

**ST\_ENDPOINT**는 LINESTRING GEOMETRY 객체의 마지막 점을 POINT 객체로 반환하는 함수입니다. LINESTRING이 아닌 타입의 GEOMETRY 객체를 넣을 경우 NULL을 반환합니다.

ST\_ENDPOINT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/8zCCYiaXknxZWHuSTwf3/Spatial%2025.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="157">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>LINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ENDPOINT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM),ST_ASTEXT(ST_ENDPOINT(GEOM))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'LINESTRING';
     
ST_ASTEXT(GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(ST_ENDPOINT(GEOM))
-----------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
POINT(2 2)
```

### ST\_ENVELOPE <a href="#bookmark93" id="bookmark93"></a>

**ST\_ENVELOPE**는 주어진 GEOMETRY 객체를 둘러싸는 사각형을 POLYGON 형태로 반환하는 함수입니다.

ST\_ENVELOPE의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/YmBfQVHqVHWMTwhPmXbJ/Spatial%2026.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="155">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ENVELOPE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_ENVELOPE(GEOM)) FROM GIS;

ST_ASTEXT(ST_ENVELOPE(GEOM))
-----------------------------------------------------------------------------------
POLYGON((1 1,1 1,1 1,1 1,1 1))
POLYGON((1 1,1 2,2 2,2 1,1 1))
POLYGON((1 1,1 2,2 2,2	1,1 1))
POLYGON((1 1,1 5,4 5,4	1,1 1))
POLYGON((1 1,1 2,2 2,2	1,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0))
POLYGON((1 1,1 5,5 5,5 1,1 1))
POLYGON((1 1,1 3,3 3,3 1,1 1))
GEOMETRYCOLLECTION EMPTY
POLYGON((1 1,1 3,3 3,3 1,1 1))
```

### ST\_EQUALS <a href="#bookmark95" id="bookmark95"></a>

**ST\_EQUALS**는 두 GEOMETRY 객체가 같은 GEOMETRY를 표현하면 1을 반환하는 함수입니다.

ST\_EQUALS의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/sUPGIHg4NiIEmcftgkpB/Spatial%2027.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="168">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_EQUALS 함수를 사용하는 예입니다.

```
SQL> SELECT ST_EQUALS(A.GEOM,B.GEOM),
     ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM)
     FROM GIS A,GIS B WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'POINT'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'POINT';
     
ST_EQUALS(A.GEOM,B.GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(A.GEOM)
-----------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
-----------------------------------------------------------------------------------
POINT(1 1)
POINT(1 1)
```

### ST\_EXTERIORRING <a href="#bookmark97" id="bookmark97"></a>

**ST\_EXTERIORRING**은 POLYGON GEOMETRY 객체의 외부 링을 반환하는 함수입니다.

POLYGON이 아닌 타입의 GEOMETRY 객체를 넣을 경우 NULL을 반환합니다.

ST\_EXTERIORRING의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/C4QgzaeT570ZmaQn5oUC/Spatial%2028.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="146">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>POLYGON 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_EXTERIORRING 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_EXTERIORRING(GEOM)) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POLYGON';

ST_ASTEXT(ST_EXTERIORRING(GEOM))
-----------------------------------------------------------------------------------
LINESTRING(1 1,2 1,2 2,1 2,1 1)
LINESTRING(0 0,0 12,12 12,12 0,0 0)
```

### ST\_EXPAND <a href="#bookmark99" id="bookmark99"></a>

**ST\_EXPAND**은 입력 GEOMETRY를 모든 방향으로 확장한 경계 상자에 해당하는 POLYGON을 반환합니다.

비어있는 GEOMETRY 객체에 대해선 확장에 관계없이 NULL을 반환합니다.

ST\_EXPAND의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/E3ObiNdS5YgWrvQeS6oW/Spatial%2029.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="115">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>num1</td><td><ul><li>GEOMETRY 객체의 모든 축 방향으로 확장시킬 거리를 입력</li><li>입력한 거리만큼 확장된 POLYGON을 형성</li></ul></td></tr><tr><td>num2</td><td><ul><li>X 방향으로 확장시킬 거리를 입력</li><li>입력한 거리만큼 X 방향으로 확장된 POLYGON을 형성</li></ul></td></tr><tr><td>num3</td><td><ul><li>Y 방향으로 확장시킬 거리를 입력</li><li>입력한 거리만큼 Y 방향으로 확장된 POLYGON을 형성</li></ul></td></tr><tr><td>num4</td><td><ul><li>Z 방향으로 확장시킬 거리를 입력</li><li>입력한 거리만큼 Z 방향으로 확장된 POLYGON을 형성</li></ul></td></tr><tr><td>num5</td><td><ul><li>M 방향으로 확장시킬 거리를 입력</li><li>입력한 거리만큼 M 방향으로 확장된 POLYGON을 형성</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_EXPAND 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_EXPAND(GEOM,1,2)) FROM GIS;

ST_ASTEXT(ST_EXPAND(GEOM,1,2))
-----------------------------------------------------------------------------------
POLYGON((0 -1,0	3,2 3,2	-1,0 -1))
POLYGON((0 -1,0	4,3 4,3	-1,0 -1))
POLYGON((0 -1,0	4,3 4,3	-1,0 -1))
POLYGON((0 -1,0	7,5 7,5	-1,0 -1))
POLYGON((0 -1,0	4,3 4,3	-1,0-1))
POLYGON((-1 -2,-1 14,13	14,13 -2,-1 -2))
POLYGON((0 -1,0 7,6 7,6	-1,0 -1))
POLYGON((0 -1,0 5,4 5,4	-1,0 -1))
GEOMETRYCOLLECTION EMPTY
POLYGON((0 -1,0 5,4 5,4 -1,0 -1))
```

### ST\_EXTENT <a href="#bookmark101" id="bookmark101"></a>

**ST\_EXTENT**은 GEOMETRY를 포함하는 경계 상자에 해당하는 POLYGON을 반환하는 집합 함수입니다. 집합 함수이므로 GEOMETRY 객체들을 한데 모은 집합에 대한 결과를 반환합니다.

ST\_EXTENT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/jj9QdNxZVyUaQbLoaoOJ/Spatial%2030.png" alt=""><figcaption><p><strong>[그림 30] ST_EXTEN 문법</strong></p></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="156">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom_expr</td><td>GEOMETRY 객체를 나타내는 임의의 연산식</td></tr></tbody></table>

* 예제

다음은 ST\_EXTENT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_EXTENT(GEOM)) FROM GIS;

ST_ASTEXT(ST_EXTENT(GEOM))
-----------------------------------------------------------------------------------
POLYGON((0 0,0 12,12 12,12 0,0 0))
```

### ST\_FILTER

**ST\_FILTER**는 공간적으로 상호작용할 가능성이 있는 객체 쌍을 식별할 때 사용하는 함수입니다. 두 GEOMETRY 객체의 최소 경계 사각형이 공유하는 부분이 있을 때 1을, 그렇지 않을 경우 0을 반환합니다. 두 GEOMETRY 객체의 좌표계가 동일해야 합니다.

ST\_FILTER의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/evqs7Ne3nMyXQFkBSQWR/blobs/kHCLhZS7VA6bmvQskMSa/ST_FILTER.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="151">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li><li>공간 인덱스가 빌드된 컬럼을 사용하는 것이 권장됨</li></ul></td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

```
SQL> SELECT ST_ASTEXT(GEOM) FROM GIS WHERE ST_FILTER(GEOM, ST_GEOMFROMTEXT( 'POLYGON((10 10,20 10,20 20,10 10))'))=1;

ST_ASTEXT(GEOM)
--------------------------------------------------------------------------------
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
```

### ST\_GEOMCOLLFROMTEXT <a href="#bookmark103" id="bookmark103"></a>

**ST\_GEOMCOLLFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 GEOMETRYCOLLECTION 객체를 반환하는 함수입니다.

ST\_GEOMCOLLFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/uAURDUXaNUREaaD8p7Dr/Spatial%2031.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="122">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td>GEOMETRYCOLLECTION 객체을 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</td></tr><tr><td>num</td><td><ul><li>GEOMETRYCOLLECTION 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_GEOMCOLLFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMCOLLFROMTEXT('GEOMETRYCOLLECTION(
     POINT(1 1),LINESTRING(2 2,3 3))')) GEOMCOLLFROMTEXT FROM DUAL;
     
GEOMCOLLFROMTEXT
-----------------------------------------------------------------------------------
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
```

### ST\_GEOMCOLLFROMWKB <a href="#bookmark105" id="bookmark105"></a>

**ST\_GEOMCOLLFROMWKB**는 주어진 WKB와 SRID를 바탕으로 GEOMETRYCOLLECTION 객체를 반환하는 함수입니다.

ST\_GEOMCOLLFROMWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/makuWOaquYX3FwYPzXk5/Spatial%2032.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="126">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td>GEOMETRYCOLLECTION 객체을 표현하기 위한 WKB 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</td></tr><tr><td>num</td><td><ul><li>EOMETRYCOLLECTION 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_GEOMCOLLFROMWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMCOLLFROMWKB(ST_ASBINARY(GEOM)))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'GEOMETRYCOLLECTION';
     
ST_ASTEXT(ST_GEOMCOLLFROMWKB(ST_ASBINARY(GEOM)))
-----------------------------------------------------------------------------------
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
GEOMETRYCOLLECTION EMPTY
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
```

### ST\_GEOMETRYFROMTEXT

**ST\_GEOMETRYFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 GEOMETRY 객체로 반환하는 함수입니다. 3차원을 표현하는 EWKT(Extended Well-Known Text) 형식의 TEXT도 지원합니다. ST\_GEOMFROMTEXT 와 동일합니다.

ST\_GEOMETRYFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/to9kNz1ZDyjeUKpe6oga/Spatial%2033.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="109">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td>GEOMETRY 객체를 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</td></tr><tr><td>num</td><td><ul><li>GEOMETRY 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경 우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_GEOMETRYFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMETRYFROMTEXT('MULTIPOINT(1 1,2 2)'))
     FROM DUAL;
     
ST_ASTEXT(ST_GEOMETRYFROMTEXT('MULTIPOINT(11,22)'))
-----------------------------------------------------------------------------------
MULTIPOINT((1 1),(2 2))
```

### ST\_GEOMETRYN <a href="#bookmark109" id="bookmark109"></a>

**ST\_GEOMETRYN**은 GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON 객체에서 N번째 GEOMETRY 객체를 반환하는 함수입니다. MULTI가 아닌 GEOMETRY를 인자로 넣을 경우, N이 1이면 인자로 넣어준 GEOMETRY 객체를 그대로 반환하고, 1이 아닌 N이 들어올 경우 NULL을 반환합니다.

N이 내부 GEOMETRY 개수의 범위를 벗어나는 경우에도 NULL을 반환합니다.

ST\_GEOMETRYN의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/Tne24iYeNNPVZK3lA0PL/Spatial%2034.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="143">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>num</td><td>N번째 객체를 지정</td></tr></tbody></table>

* 예제

다음은 ST\_GEOMETRYN 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMETRYN(GEOM,2)) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) IN
     ('MULTIPOLYGON','MULTILINESTRING','MULTIPOINT','GEOMETRYCOLLECTION');

ST_ASTEXT(ST_GEOMETRYN(GEOM,2))
-----------------------------------------------------------------------------------
POINT(2 2)
LINESTRING(3 3,4 5)
POLYGON((3 3,3 5,5 5,5 3,3 3))
LINESTRING(2 2,3 3)

LINESTRING(2 2,3 3)
```

### ST\_GEOMETRYTYPE <a href="#bookmark111" id="bookmark111"></a>

**ST\_GEOMETRYTYPE**은 GEOMETRY 객체의 타입을 반환하는 함수입니다.

ST\_GEOMETRYTYPE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/NWR9MCbszoTEFT0R7DDf/Spatial%2035.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="136">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_GEOMETRYTYPE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_GEOMETRYTYPE(GEOM) FROM GIS;

ST_GEOMETRYTYPE(GEOM)
-----------------------------------------------------------------------------------
POINT
MULTIPOINT
LINESTRING
MULTILINESTRING
POLYGON
POLYGON
MULTIPOLYGON
GEOMETRYCOLLECTION
GEOMETRYCOLLECTION
GEOMETRYCOLLECTION
```

### ST\_GEOMFROMGEOJSON <a href="#bookmark113" id="bookmark113"></a>

**ST\_GEOMFROMGEOJSON**는 주어진 GEOJSON 표현식으로부터 GEOMETRY 객체를 생성하여 반환하는 함수입니다. JSON 도형 조각만을 인자로 받을 수 있습니다. 완전한 JSON 문서는 인자로 받을 수 없습니다.

ST\_GEOMFROMGEOJSON의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/Ya9XSQAsJ4kI2NxDcZQe/Spatial%2036.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="126">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td>GEOMETRY 객체를 표현하는 GEOJSON 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</td></tr></tbody></table>

* 예제

다음은 ST\_GEOMFROMGEOJSON 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMFROMGEOJSON('{"type":
     "LineString","coordinates": [[30, 10], [10, 30], [40, 40]]}')) FROM DUAL;
     
     
     
ST_ASTEXT(ST_GEOMFROMGEOJSON('{"TYPE":"LINESTRING","COORDINATES":[[30,10],[10,30
-----------------------------------------------------------------------------------
LINESTRING(30 10,10 30,40 40)
```

### ST\_GEOMFROMGML <a href="#bookmark115" id="bookmark115"></a>

**ST\_GEOMFROMGML**는 주어진 GML 표현식으로부터 GEOMETRY 객체를 생성하여 반환하는 함수입니다. GML 도형 조각만을 인자로 받을 수 있습니다. 완전한 GML 문서는 인자로 받을 수 없습니다.

ST\_GEOMFROMGML의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/5g8zfIXomskCQP5ykFRm/Spatial%2037.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="131">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>GEOMETRY 객체를 표현하는 GML 형태의 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>GEOMETRY 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_GEOMFROMGML 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMFROMGML(
     '<gml:LineString><coordinates>1,1 2,2</coordinates></gml:LineString>'))
     FROM DUAL;

ST_ASTEXT(ST_GEOMFROMGML('<GML:LINESTRING><GML:COORDINATES>1,12,2</GML:
-----------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
```

### ST\_GEOMFROMKML

**ST\_GEOMFROMKML**는 주어진 KML 표현식으로부터 GEOMETRY 객체를 생성하여 반환하는 함수입니다. KML 도형 조각만을 인자로 받을 수 있습니다. 완전한 KML 문서는 인자로 받을 수 없습니다.

ST\_GEOMFROMKML의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/cHlZIuvpJeLeG2LYkDwN/Spatial%2038.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="132">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>GEOMETRY 객체를 표현하는 KML 형태의 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>GEOMETRY 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_GEOMFROMKML 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMFROMKML('<LineString>
     <coordinates>1,1 2,2</coordinates></LineString>')) FROM DUAL;
     
ST_ASTEXT(ST_GEOMFROMKML('<LINESTRING><COORDINATES>1,12,2</COORDINATES>
-----------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
```

### ST\_GEOMFROMTEXT <a href="#bookmark119" id="bookmark119"></a>

**ST\_GEOMFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 GEOMETRY 객체로 반환하는 함수입니다. 3차원을 표현하는 EWKT(Extended Well-Known Text) 형식의 TEXT도 지원합니다.

ST\_GEOMFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/3hBP2KnhFcJxe2pLvtoP/Spatial%2039.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="106">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>GEOMETRY 객체를 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>GEOMETRY 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경 우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_GEOMFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMFROMTEXT('MULTIPOINT(1 1,2 2)'))
     FROM DUAL;
     
ST_ASTEXT(ST_GEOMFROMTEXT('MULTIPOINT(11,22)'))
-----------------------------------------------------------------------------------
MULTIPOINT((1 1),(2 2))
```

### ST\_GEOMFROMTWKB(#) <a href="#bookmark121" id="bookmark121"></a>

**ST\_GEOMFROMTWKB**는 주어진 TWKB를 GEOMETRY 객체로 반환하는 함수입니다.

ST\_GEOMFROMTWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/tnXyplfcuXFuVmJY9Y8g/Spatial%2040.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="113">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>GEOMETRY 객체를 표현하기 위한 TWKB 형식이 저장되어 있는 바이너리 타입</li><li>(BLOB 또는 RAW) 값</li></ul></td></tr><tr><td>num</td><td><ul><li>GEOMETRY 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_GEOMFROMTWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMFROMTWKB('02000202020202'))
     FROM DUAL;
     
ST_ASTEXT(ST_GEOMFROMTWKB('02000202020202'))
----------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
```

### ST\_GEOMFROMWKB <a href="#bookmark123" id="bookmark123"></a>

**ST\_GEOMFROMWKB**는 주어진 WKB와 SRID를 GEOMETRY 객체로 반환하는 함수입니다.

ST\_GEOMFROMWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/AuI0VISb0UgBp7DIf47W/Spatial%2041.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="132">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>GEOMETRY 객체를 표현하기 위한 WKB 형식이 저장되어 있는 바이너리 타입</li><li>(BLOB 또는 RAW) 값</li></ul></td></tr><tr><td>num</td><td><ul><li>GEOMETRY 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_GEOMFROMWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_GEOMFROMWKB(ST_ASBINARY(GEOM)))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'MULTIPOINT';
     
ST_ASTEXT(ST_GEOMFROMWKB(ST_ASBINARY(GEOM)))
----------------------------------------------------------------------------------
MULTIPOINT((1 1),(2 2))
```

### ST\_INTERIORRINGN

**ST\_INTERIORRINGN**은 POLYGON 객체의 N번째 내부 링을 반환하는 함수입니다. POLYGON이 아닌 GEOMETRY를 인자로 넣을 경우 NULL을 반환합니다. N이 내부 RING의 개수의 범위를 벗어나는 경우에도 NULL을 반환합니다.

ST\_INTERIORRINGN의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/2ZF3kvyoZlB1lYSzBMlx/Spatial%2042.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="129">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>POLYGON 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>num</td><td>N번째 내부 링을 지정</td></tr></tbody></table>

* 예제

다음은 ST\_INTERIORRINGN 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_INTERIORRINGN(GEOM,1))FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POLYGON'
     AND ST_NUMINTERIORRING(GEOM) > 1;
     
ST_ASTEXT(ST_INTERIORRINGN(GEOM,1))
----------------------------------------------------------------------------------
LINESTRING(6 10,6 11,9 11,9 10,6 10)
```

### ST\_INTERSECTION($) <a href="#bookmark127" id="bookmark127"></a>

**ST\_INTERSECTION**은 GEOMETRY 객체 1과 GEOMETRY 객체 2가 공유하는 부분을 나타내는 GEOMETRY 객체를 반환하는 함수입니다. 좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다.

ST\_INTERSECTION의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/MDpTawF8oUgTxK2v6vHE/Spatial%2043.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="154">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_INTERSECTION 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM),
     ST_ASTEXT(ST_INTERSECTION(A.GEOM,B.GEOM))
     FROM GIS A,GIS B WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'POLYGON'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'POLYGON';
     
ST_ASTEXT(A.GEOM)
----------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
----------------------------------------------------------------------------------
ST_ASTEXT(ST_INTERSECTION(A.GEOM,B.GEOM))
----------------------------------------------------------------------------------

POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((2 1,1 1,1 2,2 2,2 1))


POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9	6,9 3,6 3))													
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((1 1,1 2,2 2,2 1,1 1))

POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9	6,9 3,6 3))
POLYGON((1 1,1 2,2 2,2 1,1 1))

POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9	6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9	6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 11,6 10,9 10,9 11,6 11),(6 6,6 3,9	3,9 6,6 6))
													
```

### ST\_INTERSECTS($)

**ST\_INTERSECTS**는 두 GEOMETRY 객체가 공유하는 부분이 있을 때 1을 반환하는 함수입니다. 좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다. GEOMETRY 인자로 GEOMETRYCOLLECTION 타입이 올 경우에는 런타임 오류를 발생시킵니다.

ST\_INTERSECTS의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/bggIQH3atoAekKWuOFp0/Spatial%2044.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="153">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_INTERSECTS 함수를 사용하는 예입니다.

```
SQL> SELECT ST_INTERSECTS(A.GEOM,B.GEOM),
     ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM) FROM GIS A,GIS B
     WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'POLYGON'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'POLYGON';

ST_INTERSECTS(A.GEOM,B.GEOM)
-----------------------------
ST_ASTEXT(A.GEOM)
----------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
----------------------------------------------------------------------------------
                           1
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((1 1,2 1,2 2,1 2,1 1))

                           1
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
POLYGON((1 1,2 1,2 2,1 2,1 1))

                           1
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))

                           1
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))													
```

### ST\_ISCLOSED <a href="#bookmark131" id="bookmark131"></a>

**ST\_ISCLOSED**는 LINESTRING 객체의 첫 점과 마지막 점이 동일할 때 1을 반환하는 함수입니다. POINT나 POLYGON 객체에 대해서는 항상 1을 반환합니다.\
MULTI 타입의 GEOMETRY 객체에 대해서는 내부 GEOMETRY가 모두 1일 경우 1을 반환합니다.

ST\_ISCLOSED의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/oSR8yKQBNZv8sWVOxm5F/Spatial%2045.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="162">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>LINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ISCLOSED 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ISCLOSED(GEOM), ST_ASTEXT(GEOM) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'LINESTRING';
     
ST_ISCLOSED(GEOM)
--------------------
ST_ASTEXT(GEOM)
----------------------------------------------------------------------------------
                0
LINESTRING(1 1,2 2)
```

### ST\_ISCOLLECTION

**ST\_ISCOLLECTION**는 GEOMETRY 객체가 GEOMETRYCOLLECTION, MULTI GEOMETRY 인 경우 1을 반환하는 함수입니다.

ST\_ISCOLLECTION의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/cQL8CmknPkE6ZA6wofIr/Spatial%2046.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="149">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ISCOLLECTION 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ISCOLLECTION(GEOM), ST_ASTEXT(GEOM) FROM GIS;

ST_ISCOLLECTION(GEOM)
----------------------
ST_ASTEXT(GEOM)
----------------------------------------------------------------------------------
                    0
POINT(1 1)

                    1
MULTIPOINT((1 1),(2 2))

                    0
LINESTRING(1 1,2 2)

                    1
MULTILINESTRING((1 1,2 2),(3 3,4 5))

                    0
POLYGON((1 1,2 1,2 2,1 2,1 1))

                    0
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))

                    1
MULTIPOLYGON(((1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3)))

                    1
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))

                    1
GEOMETRYCOLLECTION EMPTY

                    1
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
```

### ST\_ISEMPTY <a href="#bookmark135" id="bookmark135"></a>

**ST\_ISEMPTY**는 주어진 GEOMETRY 객체가 EMPTY 타입일 때 1을 반환하는 함수입니다.

ST\_ISEMPTY의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/Op814kLypgFAHJrTCirm/Spatial%2047.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="148">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ISEMPTY 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM)
     FROM GIS WHERE ST_ISEMPTY(GEOM) > 0;

ST_ASTEXT(GEOM)
----------------------------------------------------------------------------------
GEOMETRYCOLLECTION EMPTY
```

### ST\_ISRING <a href="#bookmark137" id="bookmark137"></a>

**ST\_ISRING**은 주어진 LINESTRING이 닫혀있고(첫 점과 마지막 점이 동일) 심플하면 1을 반환하는 함수입니다. LINESTRING이 아닌 타입의 GEOMETRY 객체를 넣을 경우 항상 0을 반환합니다.

ST\_ISRING의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/MK1TMMLsDvTlgklIy0Kg/Spatial%2048.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="136">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>LINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ISRING 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ISRING(GEOM),ST_ASTEXT(GEOM) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'LINESTRING';
     
ST_ISRING(GEOM)
------------------
ST_ASTEXT(GEOM)
----------------------------------------------------------------------------------
              0
LINESTRING(1 1,2 2)
```

### ST\_ISSIMPLE <a href="#bookmark139" id="bookmark139"></a>

**ST\_ISSIMPLE**은 GEOMETRY 객체가 자체 교차점이나 자체 접촉점을 가지지 않으면 1을 반환하는 함수입니다. GEOMETRYCOLLECTION에 대해서는 예외를 반환합니다.

ST\_ISSIMPLE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/GB8UOqWQQ287ghmAPBNl/Spatial%2049.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="145">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ISSIMPLE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ISSIMPLE(GEOM),ST_ASTEXT(GEOM) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) NOT LIKE 'GEOMETRYCOLLECTION';
     
ST_ISSIMPLE(GEOM)
--------------------
ST_ASTEXT(GEOM)
----------------------------------------------------------------------------------
                1
POINT(1 1)

                1
MULTIPOINT((1 1),(2 2))

                1
LINESTRING(1 1,2 2)

                1
MULTILINESTRING((1 1,2 2),(3 3,4 5))

                1
POLYGON((1 1,2 1,2 2,1 2,1 1))

                1
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))

                1
MULTIPOLYGON(((1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3)))
```

### ST\_ISVALID <a href="#bookmark141" id="bookmark141"></a>

**ST\_ISVALID**는 GEOMETRY 객체가 공간적으로 유효한지(well-formed 인지)를 검사하는 함수입니다. 공간적으로 유효하면 1, 아니면 0을 반환합니다. EMPTY 공간 객체에 대해서는 1을 반환합니다. 유효하지 않은 객체에 대해서는 추가로 유효하지 않은 이유와 위치를 반환합니다.

ST\_ISVALID의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/ktAjS50a5oZl2TekTe7J/Spatial%2050.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="278">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_ISVALID 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ISVALID(ST_GEOMFROMTEXT('POLYGON((0 0,1 1,0 1,1 0,0 0))'))
     FROM DUAL;
     
ST_ISVALID(ST_GEOMFROMTEXT('POLYGON((00,11,01,10,00))'))
--------------------------------------------------------
                                                      0
```

```
SQL> SELECT ST_ISVALID(ST_GEOMFROMTEXT('POLYGON((0 0,1 0,1 1,0 1,0 0))'))
     FROM DUAL;
     
ST_ISVALID(ST_GEOMFROMTEXT('POLYGON((00,10,11,01,00))'))
---------------------------------------------------------
                                                      1
```

### ST\_LENGTH($) <a href="#bookmark143" id="bookmark143"></a>

**SST\_LENGTH**는 LINESTRING 객체의 길이를 반환하는 함수입니다. POINT, POLYGON에 대해서는 0을 반환합니다. MULTI 타입의 GEOMETRY 객체에 대해서는 내부의 GEOMETRY들의 계산 결과의 합을 값을 반환합니다. 좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다. 더 빠른 연산을 원하면 구면좌표계에 대한 연산으로 바꿀 수 있습니다.

ST\_LENGTH의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/NoGRCYZQjzK4RZJadGuY/Spatial%2051.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="144">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td><ul><li>LINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>default</td><td><ul><li>연산 방식을 설정</li><li>좌표계 정보가 회전체 좌표계인 경우 기본으로 회전타원체에 대한 연산으로 설정되어 있고, 0을 인자로 주면 구면좌표계에 대해 연산</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_LENGTH 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM), ST_LENGTH(GEOM) FROM GIS
WHERE ST_GEOMETRYTYPE(GEOM) IN ('LINESTRING','MULTILINESTRING');

ST_ASTEXT(GEOM)
----------------------------------------------------------------------------------
ST_LENGTH(GEOM)
-------------------
LINESTRING(1 1,2 2)
     1.41421356
     
MULTILINESTRING((1 1,2 2),(3 3,4 5))
     3.65028154
```

### ST\_LINEFROMTEXT <a href="#bookmark145" id="bookmark145"></a>

**ST\_LINEFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 LINESTRING 객체로 반환하는 함수입니다.

ST\_LINEFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/mo32mKD5SUyze91G3iaK/Spatial%2052.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="108">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>LINESTRING 객체을 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>LINESTRING 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_LINEFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_LINEFROMTEXT('LINESTRING(1 1,2 2)'))
     FROM DUAL; 
     
ST_ASTEXT(ST_LINEFROMTEXT('LINESTRING(11,22)'))

----------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
```

### ST\_LINEFROMWKB

**ST\_LINEFROMWKB**는 주어진 WKB와 SRID를 바탕으로 LINESTRING 객체로 반환하는 함수입니다.

ST\_LINEFROMWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/fFUnNsGR2mP1rfDkbr43/image.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="123">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>LINESTRING 객체을 표현하기 위한 WKB 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>LINESTRING 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_LINEFROMWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_LINEFROMWKB(ST_ASBINARY(GEOM)))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'LINESTRING';
     
ST_ASTEXT(ST_LINEFROMWKB(ST_ASBINARY(GEOM)))

----------------------------------------------------------------------------------
LINESTRING(1 1,2 2)

```

### ST\_MAKEENVELOPE <a href="#bookmark149" id="bookmark149"></a>

**ST\_MAKEENVELOPE**는 주어진 최소값과 최대값으로 형성된 직사각형 POLYGON을 반환합니다.

ST\_MAKEENVELOPE의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/pBvqFvk3QH50ouLOujqP/Spatial%2054.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="147">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>num1</td><td>직사각형 POLYGON의 최소점(왼쪽 아래)의 x 좌표</td></tr><tr><td>num2</td><td>직사각형 POLYGON의 최소점(왼쪽 아래)의 y 좌표</td></tr><tr><td>num3</td><td>직사각형 POLYGON의 최대점(오른쪽 위)의 x 좌표</td></tr><tr><td>num4</td><td>직사각형 POLYGON의 최대점(오른쪽 위)의 y 좌표</td></tr></tbody></table>

* 예제

다음은 ST\_MAKEENVELOPE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MAKEENVELOPE(-1,1,2,3)) FROM DUAL;

ST_ASTEXT(ST_MAKEENVELOPE(-1,1,2,3))
----------------------------------------------------------------------------------
POLYGON((-1 1,-1 3,2 3,2 1,-1 1))
```

### ST\_MAKELINE <a href="#bookmark151" id="bookmark151"></a>

**ST\_MAKELINE**는 POINT, MULTIPOINT, LINESTRING을 입력받아 LINESTRING을 반환합니다.\
집합 함수 이므로 GEOMETRY 객체들을 한데 모은 집합에 대한 결과를 반환합니다.

ORDER BY 문구로 반환할 LINESTRING 객체의 형태를 설정할 수 있습니다.

ST\_MAKELINE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/mnc4a79EIP0KheveD24A/Spatial%2055.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="172">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom_expr</td><td><ul><li>GEOMETRY 객체를 나타내는 임의의 연산식</li><li>POINT, LINESTRING, MULTIPOINT 타입의 GEOMETRY 객체이어야 함</li></ul></td></tr><tr><td>order_by_clause</td><td><ul><li>GEOMETRY들을 어떻게 정렬할지를 명시</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_MAKELINE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MAKELINE(A.GEOM, B.GEOM)) FROM GIS A, GIS B
     WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'POINT'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'LINESTRING';
     
ST_ASTEXT(ST_MAKELINE(A.GEOM,B.GEOM))
----------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
```

* 예제

아래는 ST\_MAKELINE 함수에 Table의 geometry column을 인자로 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MAKELINE(GEOM)) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) IN ('POINT','MULTIPOINT','LINESTRING');

ST_ASTEXT(ST_MAKELINE(GEOM))
----------------------------------------------------------------------------------
LINESTRING(1 1,1 1,2 2,1 1,2 2)
```

* 예제

아래는 ST\_MAKELINE 함수에 order\_by\_clause를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MAKELINE(GEOM ORDER BY ID DESC))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) IN ('POINT','LINESTRING','MULTIPOINT');
     
ST_ASTEXT(ST_MAKELINE(GEOMORDERBYIDDESC))
----------------------------------------------------------------------------------
LINESTRING(1 1,2 2,1 1,2 2,1 1)
```

### ST\_MAKEPOINT <a href="#bookmark153" id="bookmark153"></a>

**ST\_MAKEPOINT**는 2D POINT 객체를 반환합니다.

ST\_MAKEPOINT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/G9F5bi9N62gjejxRxXUG/Spatial%2056.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="158">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>num1</td><td>POINT의 x 좌표를 나타냄</td></tr><tr><td>num2</td><td>POINT의 y 좌표를 나타냄</td></tr></tbody></table>

* 예제

다음은 ST\_MAKEPOINT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MAKEPOINT(1,2)) FROM DUAL;

ST_ASTEXT(ST_MAKEPOINT(1,2))
----------------------------------------------------------------------------------
POINT(1 2)
```

### ST\_MAKEPOLYGON <a href="#bookmark155" id="bookmark155"></a>

**ST\_MAKEPOLYGON**는 주어진 구조로 형성된 POLYGON을 반환합니다.

입력 도형이 닫힌 LINESTRING 이어야 합니다.

ST\_MAKEPOLYGON의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/xuEMCNBHk7OhF0yEBjdd/Spatial%2057.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="140">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td><ul><li>형성할 POLYGON의 SHELL을 나타내는 LINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr><tr><td>geom2</td><td><ul><li>형성할 POLYGON의 INTERIOR RING을 나타내는 LINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</li><li>INTERIOR RING이 다수인 경우 MULTILINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_MAKEPOLYGON 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MAKEPOLYGON(ST_GEOMFROMTEXT(
     'LINESTRING(0 0,1 0,1 1,0 1,0 0)'))) FROM DUAL;
     
ST_ASTEXT(ST_MAKEPOLYGON(ST_GEOMFROMTEXT('LINESTRING(00,10,11,01,00)')))
----------------------------------------------------------------------------------
POLYGON((0 0,1 0,1 1,0 1,0 0))
```

```
SQL> SELECT ST_ASTEXT(ST_MAKEPOLYGON(
     ST_GEOMFROMTEXT('LINESTRING(0 0,10 0,10 10,0 10,0 0)'),
     ST_GEOMFROMTEXT('MULTILINESTRING((0 0,4 0,4 4,0 4,0 0),(5 5,7 5,7 7,5 7,5 5))
     '))) MAKEPOLYGON FROM DUAL;
     
MAKEPOLYGON
----------------------------------------------------------------------------------
POLYGON((0 0,10 0,10 10,0 10,0 0),(0 0,4 0,4 4,0 4,0 0),(5 5,7 5,7 7,5 7,5 5))
```

### ST\_MAKEVALID(#) <a href="#bookmark157" id="bookmark157"></a>

**ST\_MAKEVALID**는 유효하지 않은 GEOMETRY를 점의 소실 없이 유효한 GEOMETRY로 변경하여 반환합니다. 이미 유효한 GEOMETRY의 경우 그대로 반환합니다.

ST\_MAKEVALID의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/JutOki5YVtQPCGJ9cxoK/Spatial%2058.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="154">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_MAKEVALID 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MAKEVALID(ST_GEOMFROMTEXT(
     'POLYGON((0 0,1 0,0 1,1 1,0 0))'))) FROM DUAL;
     
ST_ASTEXT(ST_MAKEVALID(ST_GEOMFROMTEXT('POLYGON((00,10,01,11,00))')))
----------------------------------------------------------------------------------
MULTIPOLYGON(((0.5 0.5,1 0,0 0,0.5 0.5)),((0.5 0.5,0 1,1 1,0.5 0.5)))
```

```
SQL> SELECT ST_ASTEXT(ST_MAKEVALID(ST_GEOMFROMTEXT(
     'POLYGON((0 0,1 0,1 1,0 1,0 0))'))) FROM DUAL;
     
ST_ASTEXT(ST_MAKEVALID(ST_GEOMFROMTEXT('POLYGON((00,10,11,01,00))')))
----------------------------------------------------------------------------------
POLYGON((0 0,1 0,1 1,0 1,0 0))
```

### ST\_MAXX <a href="#bookmark159" id="bookmark159"></a>

**ST\_MAXX**는 해당 공간 객체를 둘러싸는 최소 경계 사각형의 X 좌표값 중 큰 값을 반환하는 함수입니다.

ST\_MAXX의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/g3ypZfYI1JyPevMxyg3G/Spatial%2059.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="159">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_MAXX 함수를 사용하는 예입니다.

```
SQL> SELECT ST_MAXX(ST_GEOMFROMTEXT('LINESTRING(-1 0,3 2)')) FROM DUAL;

ST_MAXX(ST_GEOMFROMTEXT('LINESTRING(-10,32)'))
----------------------------------------------
                                             3
```

### ST\_MAXY <a href="#bookmark161" id="bookmark161"></a>

**ST\_MAXY**는 해당 공간 객체를 둘러싸는 최소 경계 사각형의 Y 좌표값 중 큰 값을 반환하는 함수입니다.

ST\_MAXY의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/iE5GykXP3ws5ryH9ztHn/Spatial%2060.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="162">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_MAXY 함수를 사용하는 예입니다.

```
SQL> SELECT ST_MAXY(ST_GEOMFROMTEXT('LINESTRING(-1 0,3 2)')) FROM DUAL;

ST_MAXY(ST_GEOMFROMTEXT('LINESTRING(-10,32)'))
----------------------------------------------
                                             2
```

### ST\_MINX <a href="#bookmark163" id="bookmark163"></a>

**ST\_MINX**는 해당 공간 객체를 둘러싸는 최소 경계 사각형의 X 좌표값 중 작은 값을 반환하는 함수입니다.

ST\_MINX 의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/i669CXiUe6hmuh3vtVfp/Spatial%2061.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="150">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_MINX 함수를 사용하는 예입니다.

```
SQL> SELECT ST_MINX(ST_GEOMFROMTEXT('LINESTRING(-1 0,3 2)')) FROM DUAL;

ST_MINX(ST_GEOMFROMTEXT('LINESTRING(-10,32)'))
----------------------------------------------
                                            -1
```

### ST\_MINY

**ST\_MINY**는 해당 공간 객체를 둘러싸는 최소 경계 사각형의 Y 좌표값 중 작은 값을 반환하는 함수입니다.

ST\_MINY 의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/gbcrW8eTCNd9vdMhgGdS/Spatial%2062.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="144">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_MINY 함수를 사용하는 예입니다.

```
SQL> SELECT ST_MINY(ST_GEOMFROMTEXT('LINESTRING(0 -1,3 2)')) FROM DUAL;

ST_MINY(ST_GEOMFROMTEXT('LINESTRING(0-1,32)'))
----------------------------------------------
                                            -1
```

### ST\_MLINEFROMTEXT <a href="#bookmark167" id="bookmark167"></a>

**ST\_MLINEFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 MULTILINESTRING 객체로 반환하는 함수입니다.

ST\_MLINEFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/nc5JUrlKRbwaxJnDyTlM/Spatial%2063.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="121">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>MULTILINESTRING 객체을 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>MULTILINESTRING 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_MLINEFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MLINEFROMTEXT(
     'MULTILINESTRING((1 1,2 2),(3 3,4 5))')) FROM DUAL;
     
ST_ASTEXT(ST_MLINEFROMTEXT('MULTILINESTRING((11,22),(33,45))'))
----------------------------------------------------------------------------------
MULTILINESTRING((1 1,2 2),(3 3,4 5))
```

### ST\_MLINEFROMWKB <a href="#bookmark169" id="bookmark169"></a>

**ST\_MLINEFROMWKB**는 주어진 WKB와 SRID를 바탕으로 MULTILINESTRING 객체로 반환하는 함수입니다.

ST\_MLINEFROMWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/JhRurjBtnHeGpOD7btN7/Spatial%2064.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="134">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>MULTILINESTRING 객체을 표현하기 위한 WKB 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>MULTILINESTRING 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_MLINEFROMWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MLINEFROMWKB(ST_ASBINARY(GEOM)))
      FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'MULTILINESTRING';

ST_ASTEXT(ST_MLINEFROMWKB(ST_ASBINARY(GEOM)))
----------------------------------------------------------------------------------
MULTILINESTRING((1 1,2 2),(3 3,4 5))
```

### ST\_MPOINTFROMTEXT

**ST\_MPOINTFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 MULTIPOINT 객체로 반환하는 함수입니다.

ST\_MPOINTFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/gj9NALQzgcDtEBkDHzfD/Spatial%2065.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="128">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>MULTIPOINT 객체을 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>MULTIPOINT 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경 우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_MPOINTFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MPOINTFROMTEXT('MULTIPOINT(10 10,20 20)'))
     FROM DUAL;
     
ST_ASTEXT(ST_MPOINTFROMTEXT('MULTIPOINT(1010,2020)'))
----------------------------------------------------------------------------------
MULTIPOINT((10 10),(20 20))
```

### ST\_MPOINTFROMWKB <a href="#bookmark173" id="bookmark173"></a>

**ST\_MPOINTFROMWKB**는 주어진 WKB와 SRID를 바탕으로 MULTIPOINT 객체로 반환하는 함수입니다.

ST\_MPOINTFROMWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/8bTukKyCVeskbyVDG7K2/Spatial%2066.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="126">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>MULTIPOINT 객체을 표현하기 위한 WKB 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>MULTIPOINT 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_MPOINTFROMWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MPOINTFROMWKB(ST_ASBINARY(GEOM)))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'MULTIPOINT';
     
ST_ASTEXT(ST_MPOINTFROMWKB(ST_ASBINARY(GEOM)))
----------------------------------------------------------------------------------
MULTIPOINT((1 1),(2 2))
```

### ST\_MPOLYFROMTEXT <a href="#bookmark175" id="bookmark175"></a>

**ST\_MPOLYFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 MULTIPOLYGON 객체로 반환하는 함수입니다.

ST\_MPOLYFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/KdUBGtuUGOShqPdOlJDS/Spatial%2067.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="105">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>MULTIPOLYGON 객체을 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>MULTIPOLYGON 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_MPOLYFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MPOLYFROMTEXT('MULTIPOLYGON
     (((10 10,10 20,20 20,20 15,10 10)), ((60 60,70 70,80 60,60 60)))'))
     MPOLYFROMTEXT FROM DUAL;
     
MPOLYFROMTEXT
----------------------------------------------------------------------------------
MULTIPOLYGON(((10 10,10 20,20 20,20 15,10 10)),((60 60,70 70,80 60,60 60)))
```

### ST\_MPOLYFROMWKB <a href="#bookmark177" id="bookmark177"></a>

**ST\_MPOLYFROMWKB**는 주어진 WKB와 SRID를 바탕으로 MULTIPOLYGON 객체로 반환하는 함수입니다.

ST\_MPOLYFROMWKB의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/TbfWAxlOKPEwfdEXailu/Spatial%2068.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="113">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>MULTIPOLYGON 객체을 표현하기 위한 WKB 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>MULTIPOLYGON 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_MPOLYFROMWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MPOLYFROMWKB(ST_ASBINARY(GEOM)))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'MULTIPOLYGON';

ST_ASTEXT(ST_MPOLYFROMWKB(ST_ASBINARY(GEOM)))
----------------------------------------------------------------------------------
MULTIPOLYGON(((1 1,2 1,2 2,1 2,1 1)),((3 3,3 5,5 5,5 3,3 3)))
```

### ST\_MULTI <a href="#bookmark179" id="bookmark179"></a>

**ST\_MULTI**는 GEOMETRY를 MULTI 타입의 GEOMETRY로 반환합니다. MULTI 타입의 객체를 인자로 넣을 경우 그대로 반환합니다.

ST\_MULTI의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/CRuqW3g988Fet69Cavtb/Spatial%2069.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="150">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_MULTI 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_MULTI(GEOM)) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'LINESTRING';
     
ST_ASTEXT(ST_MULTI(GEOM))
----------------------------------------------------------------------------------
MULTILINESTRING((1 1,2 2))
```

### ST\_NN($) <a href="#bookmark181" id="bookmark181"></a>

**ST\_NN**은 조건절에 사용되는 함수로, TABLE의 GEOMETRY 컬럼에 대해 입력으로 주어진 GEOMETRY 와 가장 가까운 GEOMETRY가 포함된 행들에 대해 1을 반환하는 함수입니다. 거리가 짧은 순으로 행들을 반환합니다.

ST\_NN의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/jlh9HTo2HAWFeD61kPZn/Spatial%2070.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="167">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom_expr</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li><li>RTREE가 빌드되어 있는 GEOMETRY TYPE의 컬럼이어야 함</li></ul></td></tr><tr><td>geom</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야</li></ul></td></tr><tr><td>str</td><td><ul><li>ST_NN에 대해 1을 반환할 행의 개수 등의 추가 정보를 주어진 양식에 맞도록 입력</li><li>WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나나</li><li>str 양식은 총 3가지로 구성되며 각각의 인자들은 콤마(,)로 구분하여 사용</li><li>res_num : GEOMETRY 컬럼들 가까운 순으로 선별할 GEOMETRY의 개수를 입력. 입력하지 않을 경우 전체 컬럼에 대해 전부 1을 반환.</li><li>batch_size : RTREE에서 탐색할 GEOMETRY의 개수 단위를 입력. 사용자가 특정 값에 대해 효율적인 연산이 가능하다고 판단한 값을 입력. 입력하지 않을 경우 시스템에서 설정한 기본값으로 동작.</li><li>distance : 병목으로 설정할 거리를 입력. 입력된 거리 이하에 있는 행들을 반환하게 됨.</li><li>unit : 병목으로 설정할 거리의 단위를 입력</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_NN 함수를 사용하는 예입니다.

```
SQL> SELECT ID FROM GIS WHERE ST_NN(GEOM,
     ST_GEOMFROMTEXT('POINT(0 0)'),'RES_NUM=3,BATCH_SIZE=10')=1;

         ID
------------
         106
         101
         102
```

### ST\_NPOINTS

**ST\_NPOINTS**는 GEOMETRY가 가지고 있는 POINT의 개수를 반환합니다.

ST\_NPOINTS의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/VdMEZHIypfiQbmbpJdeh/Spatial%2071.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="134">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_NPOINTS 함수를 사용하는 예입니다.

```
SQL> SELECT ST_NPOINTS(GEOM) FROM GIS;

ST_NPOINTS(GEOM)
----------------
              1
              2
              2
              4
              5
             15
             10
              3
              0
              3
```

### ST\_NUMGEOMETRIES <a href="#bookmark185" id="bookmark185"></a>

**ST\_NUMGEOMETRIES**는 GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON 객체에서 GEOMETRY 객체수를 반환하는 함수입니다. MULTI 타입이 아닌 타입의 GEOMETRY 객체를 넣을 경우 1을 반환합니다.

ST\_NUMGEOMETRIES의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/6vseM6oEt02bW4ocdr64/Spatial%2072.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="127">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>COLLECTION 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_NUMGEOMETRIES 함수를 사용하는 예입니다.

```
SQL> SELECT ST_NUMGEOMETRIES(GEOM),ST_ASTEXT(GEOM) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'GEOMETRYCOLLECTION';

ST_NUMGEOMETRIES(GEOM)
------------------------------
ST_ASTEXT(GEOM)
---------------------------------------------------------------------------------
                     2
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))

                     0
GEOMETRYCOLLECTION EMPTY

                     2
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(2 2,3 3))
```

### ST\_NUMINTERIORRING <a href="#bookmark187" id="bookmark187"></a>

**ST\_NUMINTERIORRING**은 POLYGON 객체의 내부 링 개수를 반환하는 함수입니다. POLYGON이 아닌 타입의 GEOMETRY 객체를 넣을 경우 NULL을 반환합니다.

ST\_NUMINTERIORRING의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/1V0mWcUh8c86Wtgjqats/Spatial%2073.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="139">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>POLYGON 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_NUMINTERIORRING 함수를 사용하는 예입니다.

```
SQL> SELECT ST_NUMINTERIORRING(GEOM), ST_ASTEXT(GEOM) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POLYGON';
     
ST_NUMINTERIORRING(GEOM)
------------------------------
ST_ASTEXT(GEOM)
---------------------------------------------------------------------------------
                     0
POLYGON((1 1,2 1,2 2,1 2,1 1))

                     2
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
```

### ST\_NUMPOINTS <a href="#bookmark189" id="bookmark189"></a>

**ST\_NUMPOINTS**는 GEOMETRY가 가지고 있는 POINT의 개수를 반환합니다.

ST\_NPOINTS와 같은 사양의 함수입니다.

ST\_NUMPOINTS의 세부 내용은 다음과 같습니다.

* 문법

<figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/UC8dgDYc0pUF5BI97sDc/Spatial%2074.png" alt=""><figcaption></figcaption></figure>

* 구성요소

<table><thead><tr><th width="153">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_NUMPOINTS 함수를 사용하는 예입니다.

```
SQL> SELECT ST_NUMPOINTS(GEOM),ST_ASTEXT(GEOM) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'LINESTRING';

ST_NUMPOINTS(GEOM)
-------------------
ST_ASTEXT(GEOM)
---------------------------------------------------------------------------------
                 2
LINESTRING(1 1,2 2)
```

### ST\_OVERLAPS <a href="#bookmark191" id="bookmark191"></a>

**ST\_OVERLAPS**는 주어진 두 GEOMETRY 객체가 동일한 차원이고, 서로 겹치는 영역이 존재하며, 완전히 포함되지는 않을 경우 1을 반환하는 함수입니다.

ST\_OVERLAPS의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/crs9lz3iVCKtd3TEN72o/Spatial%2075.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="152">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_OVERLAPS 함수를 사용하는 예입니다.

```
SQL> SELECT ST_OVERLAPS(A.GEOM,B.GEOM), ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM)
     FROM GIS A,GIS B WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'LINESTRING'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'MULTILINESTRING';
     
ST_OVERLAPS(A.GEOM,B.GEOM)
----------------------------
ST_ASTEXT(A.GEOM)
---------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
---------------------------------------------------------------------------------
                         0
LINESTRING(1 1,2 2)
MULTILINESTRING((1 1,2 2),(3 3,4 5))
```

### ST\_POINT

**ST\_POINT**는 2D POINT 객체를 반환하는 함수입니다.

ST\_POINT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/iwL03wHPgHMIpEdGVtFb/Spatial%2076.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="150">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>num1</td><td>POINT의 x 좌표를 나타냄</td></tr><tr><td>num2</td><td>POINT의 y 좌표를 나타냄</td></tr></tbody></table>

* 예제

다음은 ST\_POINT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POINT(1,2)) FROM DUAL;

ST_ASTEXT(ST_POINT(1,2))
---------------------------------------------------------------------------------
POINT(1 2)
```

### ST\_POINTFROMTEXT <a href="#bookmark195" id="bookmark195"></a>

**ST\_POINTFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 POINT 객체로 반환하는 함수입니다.

ST\_POINTFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/q0y1K2amFHyGRb26dQWn/Spatial%2077.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="106">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>POINT 객체을 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>POINT 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_POINTFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POINTFROMTEXT('POINT(10 10)')) FROM DUAL;

ST_ASTEXT(ST_POINTFROMTEXT('POINT(1010)'))
---------------------------------------------------------------------------------
POINT(10 10)
```

### ST\_POINTFROMWKB <a href="#bookmark197" id="bookmark197"></a>

**ST\_POINTFROMWKB**는 주어진 WKB와 SRID를 바탕으로 POINT 객체로 반환하는 함수입니다.

ST\_POINTFROMWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/NQdg7RiffSeX6Z2wVBiN/Spatial%2078.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="122">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>POINT 객체을 표현하기 위한 WKB 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>POINT 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_POINTFROMWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POINTFROMWKB(ST_ASBINARY(GEOM))) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POINT';
     
ST_ASTEXT(ST_POINTFROMWKB(ST_ASBINARY(GEOM)))
---------------------------------------------------------------------------------
POINT(1 1)
```

### ST\_POINTN

**ST\_POINTN**은 LINESTRING 객체의 N번째 점을 POINT 객체로 반환하는 함수입니다. LINESTRING이 아닌 타입의 GEOMETRY 객체를 넣을 경우 NULL을 반환합니다. -1을 LINESTRING 객체의 마지막 POINT로 하여 반대 방향으로 셈하여 해당 음수 인자에 맞는 POINT 객체를 반환합니다.

ST\_POINTN의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/6vUIO6PpYEhRhaYk0Vrx/Spatial%2079.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="136">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>LINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>num</td><td>N번째 점을 지정</td></tr></tbody></table>

* 예제

다음은 ST\_POINTN 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM),ST_ASTEXT(ST_POINTN(GEOM,1)) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'LINESTRING';
     
ST_ASTEXT(GEOM)
---------------------------------------------------------------------------------
ST_ASTEXT(ST_POINTN(GEOM,1))
---------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
POINT(1 1)
```

### ST\_POINTONSURFACE <a href="#bookmark201" id="bookmark201"></a>

**ST\_POINTONSURFACE**는 해당 공간 객체 위에 놓이는 것이 보장되는 임의의 POINT 객체를 반환합니다.

ST\_POINTONSURFACE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/89iTBmq0Rt6iVYpk3VSj/Spatial%2080.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="141">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_POINTONSURFACE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POINTONSURFACE(GEOM)),ST_ASTEXT(GEOM)
     FROM GISWHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POLYGON';
     
ST_ASTEXT(ST_POINTONSURFACE(GEOM))
---------------------------------------------------------------------------------
ST_ASTEXT(GEOM)
---------------------------------------------------------------------------------
POINT(1.5 1.5)
POLYGON((1 1,2 1,2 2,1 2,1 1))

POINT(6 8)
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
```

### ST\_POLYFROMTEXT <a href="#bookmark203" id="bookmark203"></a>

**ST\_POLYFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 POLYGON 객체로 반환하는 함수입니다.

ST\_POLYFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/DQud7K1PyrBkmUxwqkt1/Spatial%2081.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="114">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>GEOMETRY POLYGON 객체를 표현하기 위한 WKT 형식으로 된 CHAR, VAR CHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>POLYGON 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_POLYFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POLYFROMTEXT('POLYGON((1 1,2 1,2 2,1 2,1 1))'))
     FROM DUAL;

ST_ASTEXT(ST_POLYFROMTEXT('POLYGON((11,21,22,12,11))')) \
---------------------------------------------------------------------------------
POLYGON((1 1,2 1,2 2,1 2,1 1))
```

### ST\_POLYFROMWKB <a href="#bookmark205" id="bookmark205"></a>

**ST\_POLYFROMWKB**는 주어진 WKB와 SRID를 바탕으로 POLYGON 객체로 반환하는 함수입니다.

ST\_POLYFROMWKB의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/eSl7R1CJjAJRZ22gJDWy/Spatial%2082.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="110">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>POLYGON 객체를 표현하기 위한 WKB 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>POLYGON 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정됨</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_POLYFROMWKB 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POLYFROMWKB(ST_ASBINARY(GEOM))) FROM GIS
     WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'POLYGON';
     
ST_ASTEXT(ST_POLYFROMWKB(ST_ASBINARY(GEOM)))
---------------------------------------------------------------------------------
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
```

### ST\_POLYGON

**ST\_POLYGON**는 주어진 LINESTRING과 SRID로 형성된 POLYGON을 반환합니다.\
입력 도형이 닫힌 LINESTRING이어야 합니다.

ST\_POLYGON의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/zAQwpxXNKn3oPAZUCEec/Spatial%2083.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="127">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td><ul><li>형성할 POLYGON의 외각 껍데기를 나타내는 LINESTRING 객체의 GEOMETRY 타입이어야 함</li><li>내부 구멍을 포함하고 있는 POLYGON 도형을 형성하려면 ST_MAKEPOLYGON을 사용</li></ul></td></tr><tr><td>num</td><td><ul><li>형성할 POLYGON의 좌표계 정보(SRID)를 입력</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_POLYGON 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POLYGON(ST_GEOMFROMTEXT(
     'LINESTRING(0 0,1 0,1 1,0 1,0 0)'), 4326)) FROM DUAL;
     
ST_ASTEXT(ST_POLYGON(ST_GEOMFROMTEXT('LINESTRING(00,10,11,01,00)'),4326))
---------------------------------------------------------------------------------
POLYGON((0 0,1 0,1 1,0 1,0 0))
```

### ST\_POLYGONFROMTEXT <a href="#bookmark209" id="bookmark209"></a>

**ST\_POLYGONFROMTEXT**는 주어진 WKT와 SRID를 바탕으로 POLYGON 객체로 반환하는 함수입니다.

ST\_POLYGONFROMTEXT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/RGmfHK7yZrOVvtShyTAu/Spatial%2084.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="114">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>str</td><td><ul><li>POLYGON 객체를 표현하기 위한 WKT 형식으로 된 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</li></ul></td></tr><tr><td>num</td><td><ul><li>POLYGON 객체의 좌표계 정보(SRID)를 입력</li><li>SRID를 입력하지 않을 경우 0(시스템 기본 좌표계)이 설정</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_POLYGONFROMTEXT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POLYGONFROMTEXT('POLYGON((1 1,2 1,2 2,1 2,1 1))'))
     FROM DUAL;
     
ST_ASTEXT(ST_POLYGONFROMTEXT('POLYGON((11,21,22,12,11))'))
---------------------------------------------------------------------------------
POLYGON((1 1,2 1,2 2,1 2,1 1))
```

### ST\_POLYGONIZE(#) <a href="#bookmark211" id="bookmark211"></a>

**ST\_POLYGONIZE**은 GEOMETRY 집합들의 선분 구성요소로부터 형성될 수 있는 POLYGON들을 반환하는 집합 함수입니다. 집합 함수이므로 GEOMETRY 객체들을 한데 모은 집합에 대한 결과를 반환합니다.

ST\_POLYGONIZE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/jzZ2dHmk6e6ETATUK4t4/Spatial%2085.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="159">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom_expr</td><td>GEOMETRY 객체를 나타내는 임의의 연산식</td></tr></tbody></table>

* 예제

다음은 ST\_POLYGONIZE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_POLYGONIZE(GEOM)) FROM GIS;

ST_ASTEXT(ST_POLYGONIZE(GEOM))
---------------------------------------------------------------------------------
GEOMETRYCOLLECTION(POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,9 10,9 11,6 11,6 10),
(6 3,9 3,9 6,6 6,6 3),(3 3,5 3,5 5,3 5,3 3)),POLYGON((6 10,6 11,9 11,9 10,6 10))
,POLYGON((6 3,6 6,9 6,9 3,6 3)),POLYGON((3 3,3 5,5 5,5 3,3 3)))
```

### ST\_PROJECT(#) <a href="#bookmark213" id="bookmark213"></a>

**ST\_PROJECT**은 POINT 객체에서부터 주어진 미터 단위 거리와 호도 단위 방향(방위각)으로 투영된 POINT 객체를 반환합니다. 호도의 방향이 방위각을 기준으로 설정되므로 동쪽은 π/2, 남쪽은 π, 서쪽은 3π/2로 표현됩니다. 회전체 좌표계 상의 GEOMETRY만을 인자로 받으며, 그렇지 않은 경우 예외를 반환합니다. POINT가 아닌 타입의 GEOMETRY 객체를 넣을 경우 예외를 반환합니다.

ST\_PROJECT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/VpPpfJ13l1lPsoDB0qn1/Spatial%2086.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="153">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>POINT 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>num1</td><td>미터 단위에 해당하는 거리를 입력</td></tr><tr><td>num2</td><td>호도 단위에 해당하는 방위각을 입력</td></tr></tbody></table>

* 예제

다음은 ST\_PROJECT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_PROJECT(
     ST_GEOMFROMTEXT('POINT(0 0)',4326),100000, 3.141592)) FROM DUAL;
     
ST_ASTEXT(ST_PROJECT(ST_GEOMFROMTEXT('POINT(00)',4326),100000,3.141592))
---------------------------------------------------------------------------------
POINT(5.87178138550817e-07 -0.90436872291257)
```

### ST\_RELATE <a href="#bookmark215" id="bookmark215"></a>

**ST\_RELATE**는 GEOMETRY 객체 1과 GEOMETRY 객체 2가 주어진 관계를 만족시키면 1을 반환하는 함수입니다. GEOMETRY 인자로 GEOMETRYCOLLECTION 타입이 올 경우에는 런타임 오류를 발생시킵니다.

ST\_RELATE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/3v4h1e7jtZNug3Yv4kCn/Spatial%2087.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="131">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>str</td><td>두 객체의 관계를 의미하는 문자열을 나타내는 CHAR, VARCHAR, NCHAR, NVARCHAR 타입 중 하나</td></tr></tbody></table>

* 예제

다음은 ST\_RELATE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_RELATE(A.GEOM,B.GEOM,'TTTTTTTTT'),
     ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM) FROM GIS A,GIS B
     WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'LINESTRING'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'LINESTRING';

ST_RELATE(A.GEOM,B.GEOM,'TTTTTTTTT')
-------------------------------------
ST_ASTEXT(A.GEOM)
---------------------------------------------------------------------------------
ST_ASTEXT(B.GEOM)
---------------------------------------------------------------------------------
                                   0
LINESTRING(1 1,2 2)
LINESTRING(1 1,2 2)
```

### ST\_REVERSE

**ST\_REVERSE**는 주어진 GEOMETRY 객체의 꼭지점의 순서가 반대인 GEOMETRY를 반환하는 함수입니다.

ST\_REVERSE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/0iDVIaTfSpSKbWAyCQ65/Spatial%2088.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="177">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_REVERSE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_REVERSE(GEOM)) FROM GIS;

ST_ASTEXT(ST_REVERSE(GEOM))
---------------------------------------------------------------------------------
POINT(1 1)
MULTIPOINT((1 1),(2 2))
LINESTRING(2 2,1 1)
MULTILINESTRING((2 2,1 1),(4 5,3 3))
POLYGON((1 1,1 2,2 2,2 1,1 1))
POLYGON((0 0,12 0,12 12,0 12,0 0),(6 10,9 10,9 11,6 11,6 10),(6 3,9 3,9 6,6 6,6 3))
MULTIPOLYGON(((1 1,1 2,2 2,2 1,1 1)),((3 3,5 3,5 5,3 5,3 3)))
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(3 3,2 2))
GEOMETRYCOLLECTION EMPTY
GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(3 3,2 2))
```

### ST\_SETSRID <a href="#bookmark219" id="bookmark219"></a>

**ST\_SETSRID**는 주어진 GEOMETRY 객체의 SRID를 설정하여 반환합니다.

ST\_SETSRID의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/TpIdemqXwTjlXokG2kES/Spatial%2089.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="155">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>num</td><td>설정할 좌표계 정보(SRID)를 입력</td></tr></tbody></table>

* 예제

다음은 ST\_SETSRID 함수를 사용하는 예입니다.

```
SQL> SELECT ST_SRID(ST_SETSRID(ST_GEOMFROMTEXT('POINT(0 0)'), 4326))
     FROM DUAL;
     
ST_SRID(ST_SETSRID(ST_GEOMFROMTEXT('POINT(00)'),4326))
------------------------------------------------------
                                                4326
```

### ST\_SPLIT(#) <a href="#bookmark221" id="bookmark221"></a>

**ST\_SPLIT**는 GEOMETRY를 기준이 되는 GEOMETRY로 나누어서 나오는 GEOMETRYCOLLECTION을 반환합니다. LINESTRING은 (MULTI)POINT, (MULTI)LINESTRING, (MULTI)POLYGON에 의해 나누어질 수 있고, POLYGON은 (MULTI)LINESTRING에 의해 나누어질 수 있습니다.

ST\_SPLIT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/KDhlWIZ8Z30QLVtagUl5/Spatial%2090.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="135">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li><li>나누어질 GEOMETRY를 입력</li></ul></td></tr><tr><td>geom2</td><td><ul><li>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</li><li>나눌 기준이 되는 GEOMETRY를 입력</li></ul></td></tr></tbody></table>

* 예제

다음은 ST\_SPLIT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_SPLIT(ST_GEOMFROMTEXT(
     'LINESTRING(0 0,2 2)'),ST_GEOMFROMTEXT('POINT(1 1)'))) SPLIT FROM DUAL;

SPLIT
---------------------------------------------------------------------------------
GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(1 1,2 2))
```

### ST\_SRID <a href="#bookmark223" id="bookmark223"></a>

**ST\_SRID**는 주어진 GEOMETRY 객체의 SRID를 반환하는 함수입니다.

ST\_SRID의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/9UwmznDZv0GvCWxgkCko/Spatial%2091.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="147">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_SRID 함수를 사용하는 예입니다.

```
SQL> SELECT ID,ST_SRID(GEOM) FROM GIS;

         ID	ST_SRID(GEOM)
------------    --------------
         101		    0
         102		    0
         103		    0
         104		    0
         105		    0
         106		    0
         107		    0
         108		    0
         109		    0
         110		    0
```

### ST\_STARTPOINT

**ST\_STARTPOINT**는 LINESTRING 첫 POINT를 반환하는 함수입니다. LINESTRING이 아닌 타입의 GEOMETRY 객체를 넣을 경우 NULL을 반환합니다.

ST\_STARTPOINT의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/RVFIFYWJmafn5f4CHafO/Spatial%2092.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="158">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>LINESTRING 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_STARTPOINT 함수를 사용하는 예입니다.

```
SQL> SELECT ST_astext(geom),ST_ASTEXT(ST_STARTPOINT(GEOM))
     FROM GIS WHERE ST_GEOMETRYTYPE(GEOM) LIKE 'LINESTRING';
     
ST_ASTEXT(GEOM)
---------------------------------------------------------------------------------
ST_ASTEXT(ST_STARTPOINT(GEOM))
---------------------------------------------------------------------------------
LINESTRING(1 1,2 2)
POINT(1 1)
```

### ST\_SYMDIFFERENCE($) <a href="#bookmark227" id="bookmark227"></a>

**ST\_SYMDIFFERENCE**는 주어진 두 GEOMETRY 객체의 INTERSECTION을 제외한 영역을 나타내는 GEOMETRY 객체를 반환하는 함수입니다. 좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다.

ST\_SYMDIFFERENCE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/WtEuZLa0QqtCM5PepcHz/Spatial%2093.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="152">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_SYMDIFFERENCE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM),
     ST_ASTEXT(ST_SYMDIFFERENCE(A.GEOM,B.GEOM)) FROM GIS A,GIS B
     WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'POLYGON'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'POLYGON';

ST_ASTEXT(A.GEOM)
---------------------------------------------------------------------------------     
ST_ASTEXT(B.GEOM)
---------------------------------------------------------------------------------
ST_ASTEXT(ST_SYMDIFFERENCE(A.GEOM,B.GEOM))
---------------------------------------------------------------------------------

POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((1 1,2 1,2 2,1 2,1 1))
GEOMETRYCOLLECTION EMPTY	


POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3))													
POLYGON((1 1,2 1,2 2,1 2,1 1))										
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3)),(1 1,2 1,2 2,1 2,1 1)	



POLYGON((1 1,2 1,2 2,1 2,1 1))	
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(1 1,2 1,2 2,1 2,1 1),(6 10,9 10,9 11,6 11,6 1 0),(6 3,6 6,9 6,9 3,6 3)				

POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3))
GEOMETRYCOLLECTION EMPTY				
```

### ST\_TOUCHES

**ST\_TOUCHES**는 주어진 두 GEOMETRY 객체가 한 점 이상을 공유하지만 교차영역이 존재하지는 않을 때 1을 반환하는 함수입니다. GEOMETRY 인자로 GEOMETRYCOLLECTION 타입이 올 경우에는 런타임 오류를 발생시킵니다.

ST\_TOUCHES의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/Y0PJe8uHliliTYdOkgqe/Spatial%2094.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="159">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_TOUCHES 함수를 사용하는 예입니다.

```
SQL> SELECT ST_TOUCHES(A.GEOM,B.GEOM), ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM)
     FROM GIS A,GIS B WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'LINESTRING'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'POLYGON';
     
ST_TOUCHES(A.GEOM,B.GEOM)
---------------------------
ST_ASTEXT(A.GEOM)
--------------------------------------------------------------------------------- 
ST_ASTEXT(B.GEOM)
--------------------------------------------------------------------------------- 
                         0
LINESTRING(1 1,2 2)
POLYGON((1 1,2 1,2 2,1 2,1 1))

                         0
LINESTRING(1 1,2 2)
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
```

### ST\_TRANSFORM(#)

**ST\_TRANSFORM**는 입력 GEOMETRY의 좌표를 다른 공간 참조 시스템(Spatial reference)으로 변환시킨 GEOMETRY를 반환합니다. 인자로 SRID를 넣거나 PROJ4TEXT를 받습니다. ST\_TRANSFORM은 좌표를 변환하는 작업을 수행하지만 ST\_SETSRID는 좌표를 변환하지 않고 SRID만 설정합니다.

ST\_TRANSFORM의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/5ZkhooA4IA9YcHe3SUXJ/Spatial%2095.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

\- case1

<table><thead><tr><th width="143">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>num</td><td>변환될 좌표계 정보(SRID)를 입력</td></tr></tbody></table>

\- case2

<table><thead><tr><th width="146">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>str</td><td>변환될 좌표계 정보의 PROJ4TEXT를 입력</td></tr></tbody></table>

\- case3

<table><thead><tr><th width="150">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>str</td><td>변환되기 전 좌표계 정보의 PROJ4TEXT를 입력</td></tr><tr><td>str</td><td>변환할 좌표계 정보의 PROJ4TEXT를 입력</td></tr></tbody></table>

\- case4

<table><thead><tr><th width="152">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>str</td><td>변환되기 전 좌표계 정보의 PROJ4TEXT를 입력</td></tr><tr><td>num</td><td>변환할 좌표계 정보(SRID)를 입력</td></tr></tbody></table>

* 예제

다음은 ST\_TRANSFORM 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_TRANSFORM(ST_GEOMFROMTEXT(
     'LINESTRING(0 0,1 1)',4326),2249)) FROM DUAL;
     
ST_ASTEXT(ST_TRANSFORM(ST_GEOMFROMTEXT('LINESTRING(00,11)',4326),2249))
--------------------------------------------------------------------------------- 
LINESTRING(30250865.9714116 -610981.481754334,30214669.4455592 41989.5268075016)
```

```
SQL> SELECT ST_ASTEXT(ST_TRANSFORM(ST_GEOMFROMTEXT('LINESTRING(0 0,1 1)'),
     '+proj=longlat +ellps=WGS72 +towgs84=0,0,1.9,0,0,0.814,-0.38 +no_defs',2249))
     
     TRANSFORM FROM DUAL;
     
TRANSFORM
--------------------------------------------------------------------------------- 
LINESTRING(30250930.6174208 -610897.702286165,30214732.3446824 42073.100013002)

```

### ST\_TRANSLATE(#) <a href="#bookmark233" id="bookmark233"></a>

**ST\_TRANSLATE**는 주어진 오프셋만큼 이동한 GEOMETRY를 반환합니다.

ST\_TRANSLATE의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/wuZmjFWaKpNgO8lQFmgj/Spatial%2096.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="135">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>num1</td><td>X 방향으로 이동시킬 오프셋</td></tr><tr><td>num2</td><td>Y 방향으로 이동시킬 오프셋</td></tr><tr><td>num3</td><td>Z 방향으로 이동시킬 오프셋</td></tr></tbody></table>

* 예제

다음은 ST\_TRANSLATE 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(ST_TRANSLATE(
     ST_GEOMFROMTEXT('LINESTRING(0 0,1 0)'),1,2)) FROM DUAL;
     
ST_ASTEXT(ST_TRANSLATE(ST_GEOMFROMTEXT('LINESTRING(00,10)'),1,2))
--------------------------------------------------------------------------------- 
LINESTRING(1 2,2 2)
```

### ST\_UNION($) <a href="#bookmark235" id="bookmark235"></a>

**ST\_UNION**은 주어진 두 GEOMETRY 객체의 영역을 합한 GEOMETRY 객체를 반환하는 함수입니다.\
좌표계 정보를 통해 회전체 좌표계 상의 GEOMETRY 객체에 대한 연산이 가능합니다.

ST\_UNION의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/KggoAE0G4AfTT5ux5WZ7/Spatial%2097.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="163">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_UNION 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM),
     ST_ASTEXT(ST_UNION(A.GEOM,B.GEOM)) FROM GIS A,GIS B
     WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'POLYGON'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'POLYGON';
     
ST_ASTEXT(A.GEOM)
--------------------------------------------------------------------------------- 
ST_ASTEXT(B.GEOM)
--------------------------------------------------------------------------------- 
ST_ASTEXT(ST_UNION(A.GEOM,B.GEOM))
--------------------------------------------------------------------------------- 
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((2 1,1 1,1 2,2 2,2 1))

POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,9 10,9 11,6 11,6 10),(6 3,9 3,9 6,6 6,6 3))

POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,9 10,9 11,6 11,6 10),(6 3,9 3,9 6,6 6,6 3))

POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6 3,6 6,9 6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 11,6 10,9 10,9 11,6 11),(6 6,6 3,9 3,9 6,6 6))
```

### ST\_WITHIN <a href="#bookmark237" id="bookmark237"></a>

**SST\_WITHIN**은 GEOMETRY 객체 1이 GEOMETRY 객체 2 내부에 포함되면 1을 반환하는 함수입니다.

ST\_WITHIN의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/jh62XX8oCE9fdc2o9PPo/Spatial%2098.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="273">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>geom1</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr><tr><td>geom2</td><td>GEOMETRY 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_WITHIN 함수를 사용하는 예입니다.

```
SQL> SELECT ST_WITHIN(A.GEOM,B.GEOM), ST_ASTEXT(A.GEOM),ST_ASTEXT(B.GEOM)
     FROM GIS A,GIS B WHERE ST_GEOMETRYTYPE(A.GEOM) LIKE 'POLYGON'
     AND ST_GEOMETRYTYPE(B.GEOM) LIKE 'POLYGON';

ST_WITHIN(A.GEOM,B.GEOM)
------------------------ 
ST_ASTEXT(A.GEOM)
--------------------------------------------------------------------------------- 
ST_ASTEXT(B.GEOM)
--------------------------------------------------------------------------------- 
                       1
POLYGON((1 1,2 1,2 2,1 2,1 1))	
POLYGON((1 1,2 1,2 2,1 2,1 1))	
		
                       0		
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3))
POLYGON((1 1,2 1,2 2,1 2,1 1))
		
                       1	
POLYGON((1 1,2 1,2 2,1 2,1 1))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3))
		
                       1											
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3))
POLYGON((0 0,0 12,12 12,12 0,0 0),(6 10,6 11,9 11,9 10,6 10),(6	3,6 6,9	6,9 3,6 3))														
```

### ST\_X <a href="#bookmark239" id="bookmark239"></a>

**ST\_X**는 POINT 객체의 X 좌표를 반환하는 함수입니다.\
POINT가 아닌 타입의 GEOMETRY 객체를 넣을 경우 NULL을 반환합니다.

ST\_X의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/ur19afvzcKAnGiuL3H71/Spatial%2099.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="144">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>point</td><td>POINT 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_X 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM),ST_X(GEOM) FROM GIS WHERE ST_GEOMETRYTYPE(GEOM)
     LIKE 'POINT';
     
ST_ASTEXT(GEOM)
--------------------------------------------------------------------------------- 
ST_X(GEOM)
------------
POINT(1 1)
        1
```

### ST\_Y <a href="#bookmark241" id="bookmark241"></a>

**ST\_Y**는 POINT 객체의 Y 좌표를 반환하는 함수입니다.\
POINT가 아닌 타입의 GEOMETRY 객체를 넣을 경우 NULL을 반환합니다.

ST\_Y의 세부 내용은 다음과 같습니다.

* 문법

<div align="left"><figure><img src="https://content.gitbook.com/content/vsuQoLlX5q3tCygE0z24/blobs/KadhXqzYzcJoOp108nph/Spatial%20100.png" alt=""><figcaption></figcaption></figure></div>

* 구성요소

<table><thead><tr><th width="144">구성요소</th><th>설명</th></tr></thead><tbody><tr><td>point</td><td>POINT 객체를 나타내는 GEOMETRY 타입이어야 함</td></tr></tbody></table>

* 예제

다음은 ST\_Y 함수를 사용하는 예입니다.

```
SQL> SELECT ST_ASTEXT(GEOM),ST_Y(GEOM) FROM GIS WHERE ST_GEOMETRYTYPE(GEOM)
      LIKE 'POINT';
      
ST_ASTEXT(GEOM)
---------------------------------------------------------------------------------
ST_Y(GEOM)
-----------
POINT(1 1)
        1
```
