ST_AsGML

ST_AsGML
Prev	7.9.3. 其它格式	Next

Name

ST_AsGML — 将几何图形作为 GML 版本 2 或 3 元素返回。

Synopsis

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) 元素返回。版本参数（如果指定）可以是 2 或 3。如果未指定版本参数，则默认值为 2。 maxdecimaldigits 参数可用于减少输出中使用的最大小数位数（默认为 15））。


	使用 `maxdecimaldigits` 参数可能会导致输出几何图形无效。为了避免这种情况，首先使用 ST_ReducePrecision 和合适的网格大小。

GML 2指2.1.2版本，GML 3指3.1.1版本

“选项”参数是一个位字段。它可用于在 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 输出。因此，如果您设置它，它将交换坐标，因此顺序是 lat lon 而不是数据库 lon lat。
32：输出几何体的边框（最小外接矩形）。

“命名空间前缀”参数可用于指定自定义命名空间前缀或无前缀（如果为空）。如果使用 null 或省略 'gml' 前缀

可用性：1.3.2

可用性：1.5.0支持地理位置。

增强： 2.0.0 引入了前缀支持。引入了 GML3 的选项 4，以允许使用 LineString 而不是线条的 Curve 标记。引入了对多面体曲面和 TINS 的 GML3 支持。引入选项 32 来输出该框。

更改：2.0.0 使用默认命名参数

增强：针对 GML 3 引入了 2.1.0 id 支持。


	仅 ST_AsGML 版本 3 +支持多面体曲面和 TINS。

该方法实现了SQL/MM规范。 SQL-MM IEC 13249-3: 17.2

该函数支持 3d 并且不会丢失 z-index。

该函数支持多面体曲面。

此函数支持三角形和不规则三角网面 (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>

Prev	Up	Next
ST_AsGeoJSON	Home	ST_AsKML

Name

Synopsis

描述

示例：版本2

示例：版本3

相关信息