このページは機械翻訳したものです。
これらの関数は、引数として Well-Known Text (WKT) 表現と、オプションで空間参照システム識別子 (SRID) を受け取ります。 これらは、対応するジオメトリを返します。 WKT 形式については、WKT (Well-Known Text) 形式を参照してください。
このセクションの関数は、デカルトまたは地理空間参照システム (SRS) の引数を検出し、SRS に適した結果を戻します。
ST_GeomFromText() は、ジオメトリタイプの WKT 値を最初の引数として受け入れます。 その他の関数は、各ジオメトリ型のジオメトリ値の構築のための型固有の構築関数を提供します。
MultiPoint 値の WKT 形式表現を受け入れるST_MPointFromText() やST_GeomFromText() などの関数では、値内の個々のポイントをカッコで囲むことができます。 たとえば、次の関数コールは両方とも有効です:
ST_MPointFromText('MULTIPOINT (1 1, 2 2, 3 3)')ST_MPointFromText('MULTIPOINT ((1 1), (2 2), (3 3))') WKT ジオメトリコレクション引数を受け入れるST_GeomFromText() などの関数は、OpenGIS'GEOMETRYCOLLECTION EMPTY'標準構文と MySQL'GEOMETRYCOLLECTION()'非標準構文の両方を理解します。 WKT 値を生成するST_AsWKT() などの関数は、'GEOMETRYCOLLECTION EMPTY'標準構文を生成します:
mysql> SET @s1 = ST_GeomFromText('GEOMETRYCOLLECTION()');mysql> SET @s2 = ST_GeomFromText('GEOMETRYCOLLECTION EMPTY');mysql> SELECT ST_AsWKT(@s1), ST_AsWKT(@s2);+--------------------------+--------------------------+| ST_AsWKT(@s1) | ST_AsWKT(@s2) |+--------------------------+--------------------------+| GEOMETRYCOLLECTION EMPTY | GEOMETRYCOLLECTION EMPTY |+--------------------------+--------------------------+特に指定がないかぎり、このセクションの関数はジオメトリ引数を次のように処理します:
ジオメトリ引数が
NULLの場合、構文的に整形式のジオメトリでない場合、または SRID 引数がNULLの場合、戻り値はNULLです。デフォルトでは、地理座標 (緯度、経度) は、ジオメトリ引数の空間参照システムで指定された順序で解釈されます。 オプションの
options引数を指定して、デフォルトの軸の順序をオーバーライドできます。optionsは、カンマ区切りのkey=valuekey値はaxis-orderのみで、lat-long、long-latおよびsrid-defined(デフォルト) の値が許可されています。options引数がNULLの場合、戻り値はNULLです。options引数が無効な場合は、理由を示すエラーが発生します。SRID 引数が未定義の空間参照システム (SRS) を参照すると、
ER_SRS_NOT_FOUNDエラーが発生します。地理 SRS ジオメトリ引数で、範囲外の経度または緯度を持つ引数がある場合、エラーが発生します:
経度の値が (−180, 180]の範囲にない場合は、
ER_LONGITUDE_OUT_OF_RANGEエラーが発生します。緯度の値が[−90, 90]の範囲にない場合は、
ER_LATITUDE_OUT_OF_RANGEエラーが発生します。
表示される範囲は度数です。 SRS で別の単位が使用されている場合、範囲ではその単位に対応する値が使用されます。 浮動小数点演算のため、正確な範囲制限はわずかに偏差します。
WKT 値からジオメトリを作成するには、次の関数を使用できます:
ST_GeomCollFromText(,wkt[,srid[,options]])ST_GeometryCollectionFromText(,wkt[,srid[,options]])ST_GeomCollFromTxt(wkt[,srid[,options]])WKT 表現と SRID を使用して
GeometryCollection値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
mysql> SET @g = "MULTILINESTRING((10 10, 11 11), (9 9, 10 10))";mysql> SELECT ST_AsText(ST_GeomCollFromText(@g));+--------------------------------------------+| ST_AsText(ST_GeomCollFromText(@g)) |+--------------------------------------------+| MULTILINESTRING((10 10,11 11),(9 9,10 10)) |+--------------------------------------------+ST_GeomFromText(,wkt[,srid[,options]])ST_GeometryFromText(wkt[,srid[,options]])WKT 表現と SRID を使用して任意の型のジオメトリ値を構築します。
これらの関数は、このセクションの概要で説明されているように、引数を処理します。
ST_LineFromText(,wkt[,srid[,options]])ST_LineStringFromText(wkt[,srid[,options]])WKT 表現と SRID を使用して
LineString値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
ST_MLineFromText(,wkt[,srid[,options]])ST_MultiLineStringFromText(wkt[,srid[,options]])WKT 表現と SRID を使用して
MultiLineString値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
ST_MPointFromText(,wkt[,srid[,options]])ST_MultiPointFromText(wkt[,srid[,options]])WKT 表現と SRID を使用して
MultiPoint値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
ST_MPolyFromText(,wkt[,srid[,options]])ST_MultiPolygonFromText(wkt[,srid[,options]])WKT 表現と SRID を使用して
MultiPolygon値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
ST_PointFromText(wkt[,srid[,options]])WKT 表現と SRID を使用して
Point値を構築します。ST_PointFromText()は、このセクションの概要で説明されているように引数を処理します。ST_PolyFromText(,wkt[,srid[,options]])ST_PolygonFromText(wkt[,srid[,options]])WKT 表現と SRID を使用して
Polygon値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。