12.15.7.5 Polygon プロパティー関数

これらの関数は、Polygon 値のプロパティーを返します。

• Area(poly)

  ST_Area() と Area() はシノニムです。詳細は、ST_Area() の説明を参照してください。

• ExteriorRing(poly)

  Polygon 値 poly の外側のリングを LineString として返します。

  mysql> SET @poly =
      -> 'Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1))';
  mysql> SELECT AsText(ExteriorRing(GeomFromText(@poly)));
  +-------------------------------------------+
  | AsText(ExteriorRing(GeomFromText(@poly))) |
  +-------------------------------------------+
  | LINESTRING(0 0,0 3,3 3,3 0,0 0)           |
  +-------------------------------------------+

• InteriorRingN(poly,N)

  Polygon 値 poly の N 番目の内側のリングを LineString として返します。リングの番号は 1 から始まります。

  mysql> SET @poly =
      -> 'Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1))';
  mysql> SELECT AsText(InteriorRingN(GeomFromText(@poly),1));
  +----------------------------------------------+
  | AsText(InteriorRingN(GeomFromText(@poly),1)) |
  +----------------------------------------------+
  | LINESTRING(1 1,1 2,2 2,2 1,1 1)              |
  +----------------------------------------------+

• NumInteriorRings(poly)

  Polygon 値 poly 内の内側のリングの数を返します。

  mysql> SET @poly =
      -> 'Polygon((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1))';
  mysql> SELECT NumInteriorRings(GeomFromText(@poly));
  +---------------------------------------+
  | NumInteriorRings(GeomFromText(@poly)) |
  +---------------------------------------+
  |                                     1 |
  +---------------------------------------+

• ST_Area(poly)

  空間参照システムで測定された引数の面積を示す倍精度数値を返します。次元 0 または 1 の引数の場合、結果は 0 です。

  mysql> SET @poly = 'Polygon((0 0,0 3,3 0,0 0),(1 1,1 2,2 1,1 1))';
  mysql> SELECT ST_Area(GeomFromText(@poly));
  +------------------------------+
  | ST_Area(GeomFromText(@poly)) |
  +------------------------------+
  |                            4 |
  +------------------------------+
  
  mysql> SET @mpoly =
      -> 'MultiPolygon(((0 0,0 3,3 3,3 0,0 0),(1 1,1 2,2 2,2 1,1 1)))';
  mysql> SELECT ST_Area(GeomFromText(@mpoly));
  +-------------------------------+
  | ST_Area(GeomFromText(@mpoly)) |
  +-------------------------------+
  |                             8 |
  +-------------------------------+

  ST_Area() と Area() はシノニムです。

  ST_Area() は、MySQL 5.6.1 で追加されました。