geometry-expression.ST_AsKML([ format])

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

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

format-name

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

parameter1=value1;parameter2=value2;...

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

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

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

次の例では、結果として <Point><coordinates>1,2,3,4</coordinates></Point> を返します。

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

次の例では、結果として <Point><coordinates>1,2,3,4</coordinates></Point> を返します。

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

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

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

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

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

次の例では、結果として <Point xmlns="http://www.opengis.net/kml/2.2"><coordinates>1,2,3,4</coordinates></Point> を返します。デフォルトの xml ネームスペースが使用されています。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('KML(Version=2;Namespace=default)')

次の例では、結果として <Point><altitudeMode>absolute</altitudeMode><coordinates>1,2,3,4</coordinates></Point> を返します。出力に AltitudeMode サブ要素が含まれています。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('SubElement=<altitudeMode>absolute</altitudeMode>')