카테고리:

지리공간 함수

ST_PERIMETER

GEOGRAPHY 또는 GEOMETRY 오브젝트에서 다각형의 둘레 길이를 반환합니다.

구문

ST_PERIMETER( <geography_or_geometry_expression> )

인자

geography_or_geometry_expression

인자는 GEOGRAPHY 또는 GEOMETRY 형식이어야 합니다.

반환

길이를 나타내는 REAL 값을 반환합니다.

  • GEOGRAPHY 오브젝트의 경우 길이는 미터 단위입니다.

  • GEOMETRY 오브젝트의 경우 길이는 좌표를 정의하는 데 사용되는 것과 동일한 단위로 계산됩니다.

사용법 노트

  • geography_or_geometry_expression 이 Polygon, MultiPolygon, 또는 Polygon을 포함하는 GeometryCollection이 아닌 경우, ST_PERIMETER는 0을 반환합니다.

  • geography_or_geometry_expression 이 GeometryCollection인 경우, ST_PERIMETER는 컬렉션에 있는 Polygon 둘레의 합계를 반환합니다.

  • ST_LENGTH 대신 이 함수를 사용하여 Polygon의 둘레를 구합니다.

예

GEOGRAPHY 예

아는 각 가장자리가 1도의 호이고 적도에 하나의 가장자리가 있는 다각형 둘레의 길이를 계산합니다.

SELECT ST_PERIMETER(TO_GEOGRAPHY('POLYGON((0 0, 1 0, 1 1, 0 1, 0 0))'));
+------------------------------------------------------------------+
| ST_PERIMETER(TO_GEOGRAPHY('POLYGON((0 0, 1 0, 1 1, 0 1, 0 0))')) |
|------------------------------------------------------------------|
|                                                 444763.468727621 |
+------------------------------------------------------------------+

GEOMETRY 예

다음 예제에서는 ST_PERIMETER 함수의 사용 방법을 보여줍니다.

SELECT ST_PERIMETER(g), ST_ASWKT(g)
FROM (SELECT TO_GEOMETRY(column1) AS g
  FROM VALUES ('POINT(1 1)'),
              ('LINESTRING(0 0, 1 1)'),
              ('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))'));

+-----------------+--------------------------------+
| ST_PERIMETER(G) | ST_ASWKT(G)                    |
|-----------------+--------------------------------|
|               0 | POINT(1 1)                     |
|               0 | LINESTRING(0 0,1 1)            |
|               4 | POLYGON((0 0,0 1,1 1,1 0,0 0)) |
+-----------------+--------------------------------+