geometry-expression.ST_AsSVG([ format])

ST_AsSVG メソッドは、SVG ビューアを使用してジオメトリをグラフィカルに表示するために使用できる完全または部分的な SVG ドキュメントを返します。Microsoft Internet Explorer を除く主要な Web ブラウザのほとんどに、組み込みの SVG ビューアが備えられています。

さまざまなオプションがサポートされており、オプションの format パラメータを使用して目的のフォーマットを選択します。format パラメータを指定しない場合、デフォルトは 'SVG' です。

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

format-name

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

parameter1=value1;parameter2=value2;...

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

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

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

• ST_Geometry タイプの ST_AsSVGAggr メソッド

次の例では、ランダムな色で塗りつぶされた多角形を含む完全な SVG ドキュメントを返します。

SELECT NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
		    .ST_AsSVG()

次の例では、塗りつぶしなしの多角形を含む完全な SVG ドキュメントを返し、座標の小数点以下の桁数を 3 桁に制限します。

SELECT NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
		    .ST_AsSVG( 'RandomFill=No;DecimalDigits=3' )

次の例では、青で塗りつぶされた多角形を含み、最大精度の座標を使用した完全な SVG ドキュメントを返します。

SELECT Shape.ST_AsSVG( 'Attribute=fill="blue";DecimalDigits=-1' ) 
FROM SpatialShapes

次の例では、小数点以下の桁数が 5 桁に制限された相対座標の SVG パスデータから完全な SVG ドキュメントを返します。

SELECT '<?xml version="1.0" standalone="no"?>
	<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
	"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
	<svg viewBox="-180 -90 360 180" xmlns="http://www.w3.org/2000/svg" 
	    version="1.1">
	    <path fill="lightblue" stroke="black" stroke-width="0.1%" d="' ||
    NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
	    .ST_AsSVG( 'PathDataOnly=Yes' ) ||
       '"/></svg>'

次の例では、小数点以下の桁数が 7 桁に制限された絶対座標を使用して SVG パスデータを返します。

SELECT NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
		    .ST_AsSVG( 'PathDataOnly=Yes;Relative=No;DecimalDigits=7' )