名称
ST_AsGML — 将几何图形作为 GML 版本 2 或 3 元素返回。
概要
text ST_AsGML(geometry geom, integer maxdecimaldigits=15, integer options=0);
text ST_AsGML(geography geog, integer maxdecimaldigits=15, integer options=0, text nprefix=null, text id=null);
text ST_AsGML(integer version, geometry geom, integer maxdecimaldigits=15, integer options=0, text nprefix=null, text id=null);
text ST_AsGML(integer version, geography geog, integer maxdecimaldigits=15, integer options=0, text nprefix=null, text id=null);
描述
将几何图形作为地理标记语言 (GML) 元素返回。如果指定了 version 参数，则它可以是 2 或 3。如果未指定 version 参数，则默认假定为 2。 maxdecimaldigits 参数可用于减少输出中使用的小数位数（默认为 15）。
![[Warning]](../images/warning.png)
|
|
|
使用 |
GML 2 指 2.1.2 版本，GML 3 指 3.1.1 版本
'options' 参数是一个位域。它可用于定义 GML 输出中的 CRS 输出类型，并声明数据为经纬度。
-
0：GML 短 CRS (例如 EPSG:4326)，默认值
-
1：GML 长 CRS（例如 urn:ogc:def:crs:EPSG::4326）
-
2：仅对于 GML 3，从输出中删除 srsDimension 属性。
-
4：仅对于 GML 3，对线条使用 <LineString> 而不是 <Curve> 标签。
-
16：声明数据为经纬度（例如 srid=4326）。默认是假设数据是平面的。此选项仅对 GML 3.1.1 输出有用，与轴顺序相关。因此，如果设置它，它将交换坐标，使顺序为纬度经度，而不是数据库的经度纬度。
-
32：输出几何图形的边界框（包络）。
'命名空间前缀' 参数可用于指定自定义命名空间前缀或无前缀（如果为空）。如果为 null 或省略，则使用 'gml' 前缀
可用性：1.3.2
可用性：1.5.0 引入了地理支持。
增强功能：2.0.0 引入了前缀支持。引入了 GML3 的选项 4，允许对线条使用 LineString 而不是 Curve 标签。引入了对多面体表面和 TIN 的 GML3 支持。引入了选项 32 来输出边界框。
已更改：2.0.0 使用默认命名参数
增强功能：2.1.0 引入了 GML 3 的 id 支持。
![[Note]](../images/note.png)
|
|
|
只有 ST_AsGML 的版本 3+ 支持多面体表面和 TIN。 |
此方法实现了 SQL/MM 规范。SQL-MM IEC 13249-3：17.2
此函数支持 3D，不会删除 z 索引。
此函数支持多面体表面。
此函数支持三角形和三角不规则网络表面 (TIN)。
示例：版本 2
SELECT ST_AsGML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
st_asgml
--------
<gml:Polygon srsName="EPSG:4326"><gml:outerBoundaryIs><gml:LinearRing><gml:coordinates>0,0 0,1 1,1 1,0 0,0</gml:coordinates></gml:LinearRing></gml:outerBoundaryIs></gml:Polygon>
示例：版本 3
-- Flip coordinates and output extended EPSG (16 | 1)--
SELECT ST_AsGML(3, ST_GeomFromText('POINT(5.234234233242 6.34534534534)',4326), 5, 17);
st_asgml
--------
<gml:Point srsName="urn:ogc:def:crs:EPSG::4326"><gml:pos>6.34535 5.23423</gml:pos></gml:Point>
-- Output the envelope (32) --
SELECT ST_AsGML(3, ST_GeomFromText('LINESTRING(1 2, 3 4, 10 20)',4326), 5, 32);
st_asgml
--------
<gml:Envelope srsName="EPSG:4326">
<gml:lowerCorner>1 2</gml:lowerCorner>
<gml:upperCorner>10 20</gml:upperCorner>
</gml:Envelope>
-- Output the envelope (32) , reverse (lat lon instead of lon lat) (16), long srs (1)= 32 | 16 | 1 = 49 --
SELECT ST_AsGML(3, ST_GeomFromText('LINESTRING(1 2, 3 4, 10 20)',4326), 5, 49);
st_asgml
--------
<gml:Envelope srsName="urn:ogc:def:crs:EPSG::4326">
<gml:lowerCorner>2 1</gml:lowerCorner>
<gml:upperCorner>20 10</gml:upperCorner>
</gml:Envelope>
-- Polyhedral Example --
SELECT ST_AsGML(3, ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
st_asgml
--------
<gml:PolyhedralSurface>
<gml:polygonPatches>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3">0 0 0 0 0 1 0 1 1 0 1 0 0 0 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3">0 0 0 0 1 0 1 1 0 1 0 0 0 0 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3">0 0 0 1 0 0 1 0 1 0 0 1 0 0 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3">1 1 0 1 1 1 1 0 1 1 0 0 1 1 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3">0 1 0 0 1 1 1 1 1 1 1 0 0 1 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3">0 0 1 1 0 1 1 1 1 0 1 1 0 0 1</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
</gml:polygonPatches>
</gml:PolyhedralSurface>