これらの関数は、引数として Well-Known Binary (WKB) 表現を含む BLOB と、オプションで空間参照システム識別子 (SRID) を受け取ります。 これらは、対応するジオメトリを返します。 WKB 形式については、WKB (Well-Known Binary) 形式を参照してください。
このセクションの関数は、デカルトまたは地理空間参照システム (SRS) の引数を検出し、SRS に適した結果を戻します。
ST_GeomFromWKB() は、ジオメトリタイプの WKB 値を最初の引数として受け入れます。 その他の関数は、各ジオメトリ型のジオメトリ値の構築のための型固有の構築関数を提供します。
MySQL 8.0 より前は、これらの関数は セクション12.17.5「ジオメトリ値を作成する MySQL 固有の関数」 の関数によって戻されたジオメトリオブジェクトも受け入れていました。 ジオメトリ引数は許可されなくなり、エラーが発生します。 ジオメトリ引数の使用から WKB 引数の使用にコールを移行するには、次のガイドラインに従います:
ST_GeomFromWKB(Point(0, 0))などの構成をPoint(0, 0)として書き換えます。ST_SRID(Point(0, 0), 4326)やST_GeomFromWKB(ST_AsWKB(Point(0, 0)), 4326)などのST_GeomFromWKB(Point(0, 0), 4326)の構成を書き換えます。
特に指定がないかぎり、このセクションの関数はジオメトリ引数を次のように処理します:
WKB または 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 で別の単位が使用されている場合、範囲ではその単位に対応する値が使用されます。 浮動小数点演算のため、正確な範囲制限はわずかに偏差します。
WKB 値からジオメトリを作成するには、次の関数を使用できます:
-
ST_GeomCollFromWKB(,wkb[,srid[,options]])ST_GeometryCollectionFromWKB(wkb[,srid[,options]])WKB 表現と SRID を使用して
GeometryCollection値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
-
ST_GeomFromWKB(,wkb[,srid[,options]])ST_GeometryFromWKB(wkb[,srid[,options]])WKB 表現と SRID を使用して任意の型のジオメトリ値を構築します。
これらの関数は、このセクションの概要で説明されているように、引数を処理します。
-
ST_LineFromWKB(,wkb[,srid[,options]])ST_LineStringFromWKB(wkb[,srid[,options]])WKB 表現と SRID を使用して
LineString値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
-
ST_MLineFromWKB(,wkb[,srid[,options]])ST_MultiLineStringFromWKB(wkb[,srid[,options]])WKB 表現と SRID を使用して
MultiLineString値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
-
ST_MPointFromWKB(,wkb[,srid[,options]])ST_MultiPointFromWKB(wkb[,srid[,options]])WKB 表現と SRID を使用して
MultiPoint値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
-
ST_MPolyFromWKB(,wkb[,srid[,options]])ST_MultiPolygonFromWKB(wkb[,srid[,options]])WKB 表現と SRID を使用して
MultiPolygon値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。
-
ST_PointFromWKB(wkb[,srid[,options]])WKB 表現と SRID を使用して
Point値を構築します。ST_PointFromWKB()は、このセクションの概要で説明されているように引数を処理します。 -
ST_PolyFromWKB(,wkb[,srid[,options]])ST_PolygonFromWKB(wkb[,srid[,options]])WKB 表現と SRID を使用して
Polygon値を構築します。これらの関数は、このセクションの概要で説明されているように、引数を処理します。