geometry-expression.ST_AsGML([ format])

ST_AsGML メソッドは、ジオメトリを表す GML 文字列を返します。さまざまなフォーマットが (関連付けられているオプションとともに) サポートされており、オプションの format パラメーターを使用して目的のフォーマットを選択します。format パラメーターを指定しない場合、デフォルトは 'GML' です。

フォーマット文字列では、出力フォーマットとそのフォーマットに対するパラメーターを定義します。フォーマット文字列のフォーマットは次のいずれかです。

format-name

format-name(parameter1=value1;parameter2=value2;...)

parameter1=value1;parameter2=value2;...

最初のフォーマットでは、フォーマット名を指定し、パラメーターは指定しません。すべてのフォーマットパラメーターでデフォルト値が使用されます。2 番目のフォーマットでは、フォーマット名と名前付きパラメーター値のリストを指定します。指定しないパラメーターでは、デフォルト値が使用されます。最後のフォーマットでは、パラメーター値のみを指定し、フォーマット名にはデフォルトの 'GML' を使用します。

次のフォーマット名を使用できます。

次のフォーマットパラメーターを指定できます。

次の例では、結果として <Point srsName="EPSG:4326"><pos>1 2 3 4</pos></Point> を返します。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsGML()

次の例では、結果として <Point srsName="EPSG:4326"><coordinates>1,2</coordinates></Point> を返します。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsGML('GML(Version=2)')

次の例では、結果として <gml:Point srsName="EPSG:4326"><gml:coordinates>1,2</gml:coordinates></gml:Point> を返します。Namespace=global パラメーターでは、指定した要素とそのサブ要素に対して専用の (gml) プレフィクスを設定します。これは、集約操作の中でクエリを使用し、ある最上位レベルの要素で "gml" プレフィクスのネームスペースが定義されるようにする場合に役立ちます。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsGML('GML(Version=2;Namespace=global)')

次の例では、結果として <Point srsName="EPSG:4326"><coordinates>1,2</coordinates></Point> を返します。出力にネームスペース情報は含まれません。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsGML('GML(Version=2;Namespace=none)')

次の例では、結果として <Point srsName="http://www.opengis.net/gml/srs/epsg.xml#4326"><coordinates>1,2</coordinates></Point> を返します。srsName 属性の long フォーマットが使用されています。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsGML('GML(Version=2;Namespace=none;SRSNameFormat=long)')

次の例では、結果として <Point srsName="urn:x-ogc:def:crs:EPSG:4326"><pos>1 2 3 4</pos></Point> を返します。srsName 属性の long フォーマットが使用され、バージョン 2 フォーマットとは異なるバージョン 3 フォーマットが使用されています。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsGML('GML(Version=3;Namespace=none;SRSNameFormat=long)')