描述

通过指定框应在两个轴上展开的单个距离，或通过指定每个轴的展开距离，返回从输入的边框展开的边框。使用双精度。可用于距离查询，或用于向查询添加边界框筛选器以利用空间索引。

除了接受和返回几何的ST_Expand版本之外，还提供了接受和返回的变体 框2d 和 方框3d 数据类型。

距离以输入的空间参考系为单位。

ST_Expand类似于 ST_Buffer ，除非缓冲在所有方向上扩展几何体，而ST_Expand则沿每个轴扩展边界框。

	在1.3版之前，ST_Expand与 ST_Distance 以执行可索引距离查询。例如, geom && ST_Expand('POINT(10 20)', 10) AND ST_Distance(geom, 'POINT(10 20)') < 10 。这已经被更简单、更高效的 ST_DWithin 功能。

可用性：1.5.0行为更改为输出双精度，而不是浮动4坐标。

增强：2.0.0引入了对多面体曲面、三角形和三角网的支持。

增强：增加2.3.0支持，可以在不同的维度以不同的数量扩展一个盒子。

This function supports Polyhedral surfaces.

This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).

示例

	下面的示例使用美国国家地图集等面积(SRID=2163)，这是一个米投影

--10 meter expanded box around bbox of a linestring
SELECT CAST(ST_Expand(ST_GeomFromText('LINESTRING(2312980 110676,2312923 110701,2312892 110714)', 2163),10) As box2d);
                                         st_expand
------------------------------------
 BOX(2312882 110666,2312990 110724)

--10 meter expanded 3D box of a 3D box
SELECT ST_Expand(CAST('BOX3D(778783 2951741 1,794875 2970042.61545891 10)' As box3d),10)
                                                          st_expand
-----------------------------------------------------
 BOX3D(778773 2951731 -9,794885 2970052.61545891 20)

 --10 meter geometry astext rep of a expand box around a point geometry
 SELECT ST_AsEWKT(ST_Expand(ST_GeomFromEWKT('SRID=2163;POINT(2312980 110676)'),10));
                                                                                        st_asewkt
-------------------------------------------------------------------------------------------------
 SRID=2163;POLYGON((2312970 110666,2312970 110686,2312990 110686,2312990 110666,2312970 110666))

                

另请参阅

ST_Buffer, ST_DWithin, ST_SRID