类型 ST_Geometry 的 ST

geometry-expression.ST_AsGML([ format])

名称	类型	说明
format	VARCHAR(128)	定义将 geometry-expression 转换为 GML 表示时使用的参数的字符串。如果未指定，缺省值是 'GML'。

LONG VARCHAR 返回 geometry-expression 的 GML 表示。

ST_AsGML 方法返回表示几何的 GML 字符串。支持许多不同的格式（及其关联选项），使用可选 format 参数选择所需格式。如果未指定 format 参数，缺省值是 'GML'。

格式字符串定义输出格式和格式参数。格式字符串具有以下格式之一：

format-name

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

parameter1=value1;parameter2=value2;...

第一种格式指定格式名称，但不指定格式参数。所有格式参数均使用缺省值。第二种格式指定格式名称以及指定参数值列表。未提供参数值的参数使用缺省值。最后一种格式仅指定参数值，格式名称缺省为 'GML'。

可能使用以下格式名称：

GML 由 ISO 19136 和 OGC 定义的地理标记语言格式。

可以指定以下格式参数：

格式名称	参数名称	缺省值	允许值	说明
GML	Namespace	none	local 为给定元素（在本例中为点）及其子元素提供缺省命名空间属性。 global 为给定元素及其子元素提供专用前缀 ("gml")。在集合操作中使用查询时此参数值很有用，通过此参数值某些顶级元素可以定义 "gml" 前缀的命名空间。 none 不为给定元素（在本例中为点）及其子元素提供命名空间或前缀。	Namespace 参数可指定命名空间的输出格式约定。
GML	SRSNameFormat	short	short 使用空间参照系名称的短格式，例如 EPSG:4326。 long 使用空间参照系名称的长格式，例如 urn:x-ogc:def:crs:EPSG:4326。 none 几何不包括空间参照系名称属性。	SRSNameFormat 参数指定 srsName 属性的格式。
GML	SRSDimension	No	Yes 或 No	SRSDimension 参数指定给定几何的坐标值数。此参数仅适用于 GML(version=3)。
GML	SRSFillAll	No	Yes 或 No	SRSFillAll 参数指定是否将 SRS 属性传播到子几何元素。例如，MultiGeometry 或 MultiPolygon 会将属性传播到子几何。
GML	UseDeprecated	No	Yes 或 No	UseDeprecated 参数仅适用于 GML(version=3)。使用此参数时，只要可能就输出更早的 GML 表示。例如，如果几何中不包含 CircularString，则可以将 Surface 输出为 Polygon。
GML	Attribute	自动生成的可选属性	仅可以为顶级几何元素指定一个或多个属性。	可以指定任何合法的 XML 属性。
GML	SubElement	自动生成的 GML 子元素	仅可以为顶级几何元素指定一个或多个子元素。	可以指定任何合法的 XML 元素。

注意

缺省情况下，如果几何的原始格式可用，ST_AsGML 将使用该格式。否则使用内部格式。有关内部和原始格式的详细信息，请参见STORAGE FORMAT 子句，CREATE SPATIAL REFERENCE SYSTEM 语句。

SQL/MM (ISO/IEC 13249-3: 2006) 5.1.39

以下示例返回结果 [<Point srsName="EPSG:4326"><pos>1 2 3 4</pos></Point>]。

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

以下示例返回结果 [<Point srsName="EPSG:4326"><coordinates>1,2</coordinates></Point>]。

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

以下示例返回结果 [<gml:Point srsName="EPSG:4326"><gml:coordinates>1,2</gml:coordinates></gml:Point>]。Namespace=global 参数为给定元素及其子元素提供专用前缀 ("gml")。在集合操作中使用查询时此参数值很有用，通过此参数值某些顶级元素可以定义 "gml" 前缀的命名空间。

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

以下示例返回结果 [<Point srsName="EPSG:4326"><coordinates>1,2</coordinates></Point>]。输出中不包含命名空间信息。

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

以下示例返回结果 [<Point srsName="http://www.opengis.net/gml/srs/epsg.xml#4326"><coordinates>1,2</coordinates></Point>]。使用 srsName 属性的长格式。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsGML('GML(Version=2;Namespace=none;SRSNameFormat=long)')

以下示例返回结果 [<Point srsName="urn:x-ogc:def:crs:EPSG:4326"><pos>1 2 3 4</pos></Point>]。使用 srsName 属性的长格式，版本 3 格式与版本 2 格式不同。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsGML('GML(Version=3;Namespace=none;SRSNameFormat=long)')

类型 ST_Geometry 的 ST_AsGML 方法

语法

参数

返回值

注释

注意

标准和兼容性

示例