From: Olivier Courtin Date: Sun, 8 Nov 2009 06:42:33 +0000 (+0000) Subject: Complete ST_GeomFromGML documentation. Add ST_GMLToSQL documentation entry. (Please... X-Git-Tag: 1.5.0b1~272 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fdddd420e651d8d012d6658f7a91c03022e20f06;p=postgis Complete ST_GeomFromGML documentation. Add ST_GMLToSQL documentation entry. (Please tks to read back as my english grammar is far to be perfect) git-svn-id: http://svn.osgeo.org/postgis/trunk@4767 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/reference.xml b/doc/reference.xml index d1c73943b..cb332849a 100644 --- a/doc/reference.xml +++ b/doc/reference.xml @@ -1421,6 +1421,23 @@ SELECT ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 15 Requires compilation with libxml2 2.5+ + ST_GeomFromGML work only for GML Geometries fragments. It throw an error if you try to use it on a whole GML document. + + OGC GML versions supported: + + + GML 3.2.1 Namespace + + + GML 3.1.1 Simple Features profile SF-2 (with GML 3.1.0 and 3.0.0 backward compatibility) + + + GML 2.1.2 + + + OGC GML standards, cf: http://www.opengeospatial.org/standards/gml: + + Availability: 1.5 - requires libxml2 >= 2.5+ @@ -1428,24 +1445,80 @@ SELECT ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 15 This function supports 3d and will not drop the z-index. - + GML allow mixed dimensions (2D and 3D inside the same MultiGeometry for instance). As PostGIS geometries don't, ST_GeomFromGML convert the whole geometry to 2D if a missing Z dimension is found once. + + GML support mixed SRS inside the same MultiGeometry. As PostGIS geometries don't, ST_GeomFromGML, in this case, reproject all subgeometries to the SRS root node. If no srsName attribute available for the GML root node, the function throw an error. + + ST_GeomFromGML function is not pedantic about an explicit GML namespace. You could avoid to mention it explicitly for common usages. But you need it if you want to use XLink feature inside GML. + + ST_GeomFromGML function not support SQL/MM curves geometries. + + - Examples - SELECT ST_GeomFromGML('Examples - A single geometry with srsName + SELECT ST_GeomFromGML(' - -71.16028,42.258729 -71.160837,42.259112 -71.161143,42.25932 - + + -71.16028,42.258729 -71.160837,42.259112 -71.161143,42.25932 + ']]>); + + + Examples - XLink usage + + + 42.258729 -71.16028 + + 42.259112 -71.160837 + + + + ');]]>); + + + See Also + + + + ST_GMLToSQL + Return a specified ST_Geometry value from GML representation. This is an alias name for ST_GeomFromGML + + + + + geometry ST_GMLToSQL + text geomgml + + + + + Description + + + + + This method implements the SQL/MM specification: SQL-MM 3: 5.1.50 (except for curves support). + + + See Also + + + + + ST_GeomFromText