From: Regina Obe Date: Tue, 3 Nov 2009 05:19:52 +0000 (+0000) Subject: Document ST_Buffer for geography and caveats X-Git-Tag: 1.5.0b1~312 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=75ac24ba2fad5f7770bd714a7142b067660ea9c5;p=postgis Document ST_Buffer for geography and caveats git-svn-id: http://svn.osgeo.org/postgis/trunk@4721 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/reference.xml b/doc/reference.xml index 21700f7b9..af734dc52 100644 --- a/doc/reference.xml +++ b/doc/reference.xml @@ -12025,9 +12025,9 @@ SELECT ST_Buffer(ST_GeomFromText('POINT(50 50)'), 20) As smallc, ST_Buffer - Returns a geometry that represents all points whose distance + For geometry: Returns a geometry that represents all points whose distance from this Geometry is less than or equal to distance. Calculations - are in the Spatial Reference System of this Geometry. Introduced in 1.5 support for + are in the Spatial Reference System of this Geometry. For geography: Uses a planar transform wrapper. Introduced in 1.5 support for different end cap and mitre settings to control shape. buffer_style options: quad_segs=#,endcap=round|flat|square,join=round|mitre|bevel,mitre_limit=#.# @@ -12053,6 +12053,12 @@ SELECT ST_Buffer(ST_GeomFromText('POINT(50 50)'), 20) As smallc, float radius_of_buffer text buffer_style_parameters + + + geography ST_Buffer + geography g1 + float radius_of_buffer_in_meters + @@ -12060,17 +12066,22 @@ SELECT ST_Buffer(ST_GeomFromText('POINT(50 50)'), 20) As smallc, Description - Returns a geometry that represents all points whose distance - from this Geometry is less than or equal to distance. Calculations - are in the Spatial Reference System of this Geometry. Introduced in 1.5 support for + Returns a geometry/geography that represents all points whose distance + from this Geometry/geography is less than or equal to distance. para> + Geometry: Calculations + are in the Spatial Reference System of the geometry. Introduced in 1.5 support for different end cap and mitre settings to control shape. + Geography: For geography this is really a thin wrapper around the geometry implementation. It first determines the best SRID that + fits the bounding box of the geography object (favoring UTM and falling back on mercator in worst case scenario) and then buffers in that planar spatial ref and retransforms back to WGS84 geography. + + For geography this may not behave as expected if object is sufficiently large that it falls between two UTM zones and crosses the dateline + Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and join types. These are useful for example to convert road linestrings - into polygon roads with flat or square edges instead of rounded edges. - requires GEOS >= 3.2 to take advantage of advanced functionality. + into polygon roads with flat or square edges instead of rounded edges. Thin wrapper for geography was added. - requires GEOS >= 3.2 to take advantage of advanced functionality. - -The optional third parameter can either specify number of segments used to approximate a quarter circle (integer case, defaults to 8) or a list of blank-separated key=value pairs (string case) to tweak operations as follows: +The optional third parameter (currently only applies to geometry) can either specify number of segments used to approximate a quarter circle (integer case, defaults to 8) or a list of blank-separated key=value pairs (string case) to tweak operations as follows: 'quad_segs=#' : number of segments used to approximate a quarter circle (defaults to 8).