12.15.7.1 一般的な幾何プロパティー関数

このセクションに示されている関数では引数が制限されず、任意の型の幾何値が受け入れられます。

• Dimension(g)

  幾何値 g の固有の次元を返します。結果は、-1、0、1、2 のいずれかです。これらの値の意味は、セクション11.5.2.2「Geometry クラス」で指定されています。

  mysql> SELECT Dimension(GeomFromText('LineString(1 1,2 2)'));
  +------------------------------------------------+
  | Dimension(GeomFromText('LineString(1 1,2 2)')) |
  +------------------------------------------------+
  |                                              1 |
  +------------------------------------------------+

• Envelope(g)

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

• GeometryType(g)

  幾何インスタンス g がメンバーになっている幾何型の名前を示すバイナリ文字列を返します。この名前は、インスタンス化可能な Geometry サブクラスのいずれかに対応します。

  mysql> SELECT GeometryType(GeomFromText('POINT(1 1)'));
  +------------------------------------------+
  | GeometryType(GeomFromText('POINT(1 1)')) |
  +------------------------------------------+
  | POINT                                    |
  +------------------------------------------+

• IsEmpty(g)

  この関数は、すべての有効な幾何値に対しては 0、すべての無効な幾何値または NULL に対しては 1 を返すプレースホルダです。

  MySQL は、POINT EMPTY などの GIS の EMPTY 値をサポートしていません。

• IsSimple(g)

  幾何値 g に自己交差や自己接触などの異常な幾何点が含まれていない場合は 1 を返します。IsSimple() は、その引数が単純でない場合は 0 を、NULL である場合は NULL を返します。

  この章の最初の方で指定されているインスタンス化可能な各幾何クラスの説明には、そのクラスのインスタンスが単純でないとして分類される具体的な条件が含まれています。(セクション11.5.2.1「幾何クラスの階層」を参照してください。)

  MySQL 5.6.1 より前は、この関数は常に 0 を返します。

• SRID(g)

  幾何値 g の空間参照システム ID を示す整数を返します。

  MySQL では、SRID 値は幾何値に関連付けられた整数にすぎません。すべての計算はユークリッド (平面) 幾何学を前提にして実行されます。

  mysql> SELECT SRID(GeomFromText('LineString(1 1,2 2)',101));
  +-----------------------------------------------+
  | SRID(GeomFromText('LineString(1 1,2 2)',101)) |
  +-----------------------------------------------+
  |                                           101 |
  +-----------------------------------------------+

• ST_Envelope(g)

  幾何値 g の最小外接矩形 (MBR) を返します。結果は、その外接矩形の角の点によって定義された Polygon 値として返されます。

  POLYGON((MINX MINY, MAXX MINY, MAXX MAXY, MINX MAXY, MINX MINY))

  mysql> SELECT AsText(ST_Envelope(GeomFromText('LineString(1 1,2 2)')));
  +----------------------------------------------------------+
  | AsText(ST_Envelope(GeomFromText('LineString(1 1,2 2)'))) |
  +----------------------------------------------------------+
  | POLYGON((1 1,2 1,2 2,1 2,1 1))                           |
  +----------------------------------------------------------+

  ST_Envelope() と Envelope() はシノニムです。

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