From: Regina Obe <lr@pcorp.us>
Date: Fri, 23 Oct 2009 13:26:33 +0000 (+0000)
Subject: Preliminary documentation for ST_GeomFromGML and logic to support gml input parameters
X-Git-Tag: 1.5.0b1~348
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=f81c7d5521eaf530986e7123ad8a3482afcc212a;p=postgis

Preliminary documentation for ST_GeomFromGML and logic to support gml input parameters

git-svn-id: http://svn.osgeo.org/postgis/trunk@4672 b70326c6-7e19-0410-871a-916f4a2858ee
---

diff --git a/doc/reference.xml b/doc/reference.xml
index 04e4f2ccc..e81ffebf5 100644
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -1399,6 +1399,52 @@ SELECT ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 15
 			<para><xref linkend="ST_GeomFromText" /></para>
 		  </refsection>
 	</refentry>
+	
+	<refentry id="ST_GeomFromGML">
+	  <refnamediv>
+		<refname>ST_GeomFromGML</refname>
+		<refpurpose>Takes as input GML representation of geometry and outputs a PostGIS geometry object</refpurpose>
+	  </refnamediv>
+
+	  <refsynopsisdiv>
+		<funcsynopsis>
+		  <funcprototype>
+			<funcdef>geometry <function>ST_GeomFromGML</function></funcdef>
+			<paramdef><type>text </type> <parameter>geomgml</parameter></paramdef>
+		  </funcprototype>
+		</funcsynopsis>
+	  </refsynopsisdiv>
+
+	  <refsection>
+		<title>Description</title>
+		<para>Constructs a PostGIS ST_Geometry object from the OGC GML representation.</para>
+		<note>
+			<para>The EWKB format is not an OGC standard, but a PostGIS specific format that includes the spatial reference system (SRID)
+			identifier</para>
+		</note>
+		<!-- Optionally mention 3d support -->
+		<para><inlinemediaobject>
+		<imageobject>
+		  <imagedata fileref="images/check.png" />
+		</imageobject>
+	  </inlinemediaobject> This function supports 3d and will not drop the z-index.</para>
+
+	  </refsection>
+
+	  <refsection>
+		<title>Examples</title>
+	<programlisting>SELECT ST_GeomFromGML('<![CDATA[
+		<gml:LineString srsName="EPSG:4269">
+		<gml:coordinates>-71.16028,42.258729 -71.160837,42.259112 -71.161143,42.25932
+		</gml:coordinates>
+		</gml:LineString>");']]>);
+		</programlisting>
+	  </refsection>
+	  <refsection>
+		<title>See Also</title>
+		<para><xref linkend="ST_AsGML" /></para>
+	  </refsection>
+	</refentry>
 
 	<refentry id="ST_GeomFromText">
 		  <refnamediv>
diff --git a/doc/xsl/postgis_gardentest.sql.xsl b/doc/xsl/postgis_gardentest.sql.xsl
index f4a18ddd9..72eef0a87 100644
--- a/doc/xsl/postgis_gardentest.sql.xsl
+++ b/doc/xsl/postgis_gardentest.sql.xsl
@@ -258,7 +258,7 @@ SELECT 'create,insert,drop Test: End Testing Geography <xsl:value-of select="@Ge
 				<xsl:variable name='fnname'><xsl:value-of select="funcdef/function"/></xsl:variable>
 				<xsl:variable name='fndef'><xsl:value-of select="funcdef"/></xsl:variable>
 				<xsl:variable name='numparams'><xsl:value-of select="count(paramdef/parameter)" /></xsl:variable>
-				<xsl:variable name='numparamgeoms'><xsl:value-of select="count(paramdef/type[contains(text(),'geometry') or contains(text(),'geography') or contains(text(),'box') or contains(text(), 'bytea')]) + count(paramdef/parameter[contains(text(),'WKT')])" /></xsl:variable>
+				<xsl:variable name='numparamgeoms'><xsl:value-of select="count(paramdef/type[contains(text(),'geometry') or contains(text(),'geography') or contains(text(),'box') or contains(text(), 'bytea')]) + count(paramdef/parameter[contains(text(),'WKT')]) + count(paramdef/parameter[contains(text(),'geomgml')])" /></xsl:variable>
 				<xsl:variable name='numparamgeogs'><xsl:value-of select="count(paramdef/type[contains(text(),'geography')] )" /></xsl:variable>
 				<!-- For each function prototype generate a test sql statement -->
 				<xsl:choose>
@@ -368,6 +368,9 @@ SELECT '<xsl:value-of select="$fnname" /><xsl:text> </xsl:text><xsl:value-of sel
 					<xsl:when test="(contains(parameter, 'version'))">
 						<xsl:value-of select="$var_version2" />
 					</xsl:when>
+					<xsl:when test="(contains(parameter,'geomgml'))">
+						<xsl:text>ST_AsGML(foo1.the_geom)</xsl:text>
+					</xsl:when>
 					<xsl:when test="(contains(type,'box') or type = 'geometry' or type = 'geometry ' or contains(type,'geometry set')) and (position() = 1 or count($func/paramdef/type[contains(text(),'geometry') or contains(text(),'box') or contains(text(), 'WKT') or contains(text(), 'bytea')]) = '1')">
 						<xsl:text>foo1.the_geom</xsl:text>
 					</xsl:when>
diff --git a/doc/xsl/postgis_gardentest_subset.sql.xsl b/doc/xsl/postgis_gardentest_subset.sql.xsl
index 2eda7cb38..b9bbaeee0 100644
--- a/doc/xsl/postgis_gardentest_subset.sql.xsl
+++ b/doc/xsl/postgis_gardentest_subset.sql.xsl
@@ -172,7 +172,7 @@
 				<xsl:variable name='fnname'><xsl:value-of select="funcdef/function"/></xsl:variable>
 				<xsl:variable name='fndef'><xsl:value-of select="funcdef"/></xsl:variable>
 				<xsl:variable name='numparams'><xsl:value-of select="count(paramdef/parameter)" /></xsl:variable>
-				<xsl:variable name='numparamgeoms'><xsl:value-of select="count(paramdef/type[contains(text(),'geometry') or contains(text(),'geography') or contains(text(),'box') or contains(text(), 'bytea')]) + count(paramdef/parameter[contains(text(),'WKT')])" /></xsl:variable>
+				<xsl:variable name='numparamgeoms'><xsl:value-of select="count(paramdef/type[contains(text(),'geometry') or contains(text(),'geography') or contains(text(),'box') or contains(text(), 'bytea')]) + count(paramdef/parameter[contains(text(),'WKT')]) + count(paramdef/parameter[contains(text(),'geomgml')])" /></xsl:variable>
 				<xsl:variable name='numparamgeogs'><xsl:value-of select="count(paramdef/type[contains(text(),'geography')] )" /></xsl:variable>
 				<!-- For each function prototype generate a test sql statement -->
 				<xsl:choose>
@@ -282,6 +282,9 @@ SELECT '<xsl:value-of select="$fnname" /><xsl:text> </xsl:text><xsl:value-of sel
 					<xsl:when test="(contains(parameter, 'version'))">
 						<xsl:value-of select="$var_version2" />
 					</xsl:when>
+					<xsl:when test="(contains(parameter,'geomgml'))">
+						<xsl:text>ST_AsGML(foo1.the_geom)</xsl:text>
+					</xsl:when>
 					<xsl:when test="(contains(type,'box') or type = 'geometry' or type = 'geometry ' or contains(type,'geometry set')) and (position() = 1 or count($func/paramdef/type[contains(text(),'geometry') or contains(text(),'box') or contains(text(), 'WKT') or contains(text(), 'bytea')]) = '1')">
 						<xsl:text>foo1.the_geom</xsl:text>
 					</xsl:when>