ST_AsKML
戻る  7.9.3. その他の書式  次へ

名前

ST_AsKML — ジオメトリーを KML 要素として返します。

概要

text ST_AsKML(geometry geom, integer maxdecimaldigits=15, text nprefix=NULL);

text ST_AsKML(geography geog, integer maxdecimaldigits=15, text nprefix=NULL);

説明

ジオメトリーを Keyhole Markup Language (KML) 要素として返します。デフォルトの最大の小数点以下の桁数は 15で、デフォルトの名前空間はプリフィクス無しです。

[警告]

任意引数maxdecimaldigitsを使用することで、出力ジオメトリが不正になる可能性があります。これを回避するには、前もってST_ReducePrecisionに適切なグリッドサイズを与えてこれを使用します。

Availability: 1.2.2 - version パラメータが付く形式は 1.3.2からです。

Enhanced: 2.0.0 - プレフィクスの名前空間の追加、デフォルト値と名前付き引数の追加

Changed: 3.0.0 - "version"の付いた形式の削除

[注記]

PostGIS が Proj 対応でコンパイルされている必要があります。PostGIS_Full_Versionを使って Proj 対応でコンパイルされているか確認して下さい。
[注記]

AsKML 出力は SRID を持たないジオメトリーでは動作しません。

この関数は3次元に対応し、Z値を削除しません。

例

コード
SELECT ST_AsKML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))', 4326));
出力
<Polygon
><outerBoundaryIs
><LinearRing
><coordinates
>0,0 0,1 1,1 1,0 0,0</coordinates
></LinearRing
></outerBoundaryIs
></Polygon
>

この例では 3次元 LINESTRING を出力します。

コード
SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3,4 5 6)');
出力
<LineString
><coordinates
>1,2,3 4,5,6</coordinates
></LineString
>

関連情報

ST_AsSVG, ST_AsGML