postGIS 用户手册

1 Introduction 1 1.1 Project Steering Committee . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 Contributors Past and Present . . . . . . . . . . . . . . . 1 1.3 More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2 Installation 3 2.1 Short Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.3 Getting the Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.4 Installation . . . . . . . 4 2.4.1 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.4.2 Building . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.4.3 Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.4.4 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2.5 Create a spatially-enabled database . . . . . . . . . . . . . . . 8 2.6 Create a spatially-enabled database from a template . . . . . . 9 2.7 Upgrading . . . . . . . . 9 2.7.1 Soft upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2.7.2 Hard upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2.8 Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 2.9 JDBC . . . . . . . . . . 10 2.10 Loader/Dumper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 3 Frequently Asked Questions 12 4 Using PostGIS: Data Management and Queries 16 4.1 GIS Objects . . . . . . . 16 4.1.1 OpenGIS WKB and WKT . . . . . . . . . . . . . . . 16 4.1.2 PostGIS EWKB, EWKT and Canonical Forms . . . . . . . . . . . . . . . . 17 4.1.3 SQL-MM Part 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 4.2 PostGIS Geography Type . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 4.2.1 Geography Basics . . . . . . . . . . . . . . . . . . . . . . . . . . 19 4.2.2 When to use Geography Data type over Geometry data type . . . . . . . . . . . . . 20 4.2.3 Geography Advanced FAQ . . . . . . . . . . . . . . . 21 4.3 Using OpenGIS Standards . . . . . . . . . . . . . . . . . . . . . . . . . . 21 4.3.1 The SPATIAL_REF_SYS Table and Spatial Reference Systems . . . . . . . . . . . 22 4.3.2 The GEOMETRY_COLUMNS Table . . . . . . . . . . . . . . . . . . . . . . . .. . . . . 23 4.3.3 Creating a Spatial Table . . . . . . . . . . . . . . . . 23 4.3.4 Manually Registering Geometry Columns in geometry_columns . . . . . . . . . . . . . . . . . 24 4.3.5 Ensuring OpenGIS compliancy of geometries . . . . . . . . . . . . . . . . . . . . . . 25 4.3.6 Dimensionally Extended 9 Intersection Model (DE-9IM) . . . . . . . . . . . . . . . 29 4.3.6.1 Theory . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 4.4 Loading GIS Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 4.4.1 Using SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 4.4.2 Using the Loader . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 4.5 Retrieving GIS Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 4.5.1 Using SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 4.5.2 Using the Dumper . . . . . . . . . . . . . . . . . . . . . . . . . . 36 4.6 Building Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 4.6.1 GiST Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 4.6.2 Using Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 4.7 Complex Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 4.7.1 Taking Advantage of Indexes . . . . . . . . . . . . . . . . . . . . . . . . 38 4.7.2 Examples of Spatial SQL . . . . . . . . . . . . . . . . 39 5 Using PostGIS: Building Applications 42 5.1 Using MapServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 5.1.1 Basic Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 5.1.2 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . 43 5.1.3 Advanced Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 5.1.4 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 5.2 Java Clients (JDBC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 5.3 C Clients (libpq) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 5.3.1 Text Cursors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 5.3.2 Binary Cursors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 6 Performance tips 49 6.1 Small tables of large geometries . . . . . . . . . . . . . . . . 49 6.1.1 Problem description . . . . . . . . . . . . . . . 49 6.1.2 Workarounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 6.2 CLUSTERing on geometry indices . . . . . . . . . . . . . . . 50 6.3 Avoiding dimension conversion . . . . . . . . . . . . . . . . . 50 6.4 Tuning your configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 51 6.4.1 Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 6.4.2 Runtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 7 PostGIS Reference 52 7.1 PostgreSQL PostGIS Types . . . . . . . . . . . . . . . . . . . . . . . . . . 52 7.1.1 box2d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 7.1.2 box3d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 7.1.3 box3d_extent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 7.1.4 geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 7.1.5 geometry_dump . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 7.1.6 geography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 7.2 Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 7.2.1 AddGeometryColumn . . . . . . . . . . . . . . . . . 55 7.2.2 DropGeometryColumn . . . . . . . . . . . . . . . . . 56 7.2.3 DropGeometryTable . . . . . . . . . . . . . . . 57 7.2.4 PostGIS_Full_Version . . . . . . . . . . . . . . . . . 57 7.2.5 PostGIS_GEOS_Version . . . . . . . . . . . . . . . . 58 7.2.6 PostGIS_LibXML_Version . . . . . . . . . . . . . . . . . . . . . . . . 58 7.2.7 PostGIS_Lib_Build_Date . . . . . . . . . . . . . . . 59 7.2.8 PostGIS_Lib_Version . . . . . . . . . . . . . . . . . 59 7.2.9 PostGIS_PROJ_Version . . . . . . . . . . . . . . . . 60 7.2.10 PostGIS_Scripts_Build_Date . . . . . . . . . . . . . . . . 61 7.2.11 PostGIS_Scripts_Installed . . . . . . . . . . . . . . . 61 7.2.12 PostGIS_Scripts_Released . . . . . . . . . . . . . . . 62 7.2.13 PostGIS_Uses_Stats . . . . . . . . . . . . . . . 62 7.2.14 PostGIS_Version . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 7.2.15 Populate_Geometry_Columns . . . . . . . . . . . . . . . . 64 7.2.16 Probe_Geometry_Columns . . . . . . . . . . . . . . . 64 7.2.17 UpdateGeometrySRID . . . . . . . . . . . . . . . . . 65 7.3 Geometry Constructors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 7.3.1 ST_BdPolyFromText . . . . . . . . . . . . . . . 66 7.3.2 ST_BdMPolyFromText . . . . . . . . . . . . . . . . . 66 7.3.3 ST_GeogFromText . . . . . . . . . . . . . . . . . . . . . . . . . . 67 7.3.4 ST_GeographyFromText . . . . . . . . . . . . . . . . 68 7.3.5 ST_GeogFromWKB . . . . . . . . . . . . . . . 68 7.3.6 ST_GeomCollFromText . . . . . . . . . . . . . . . . 69 7.3.7 ST_GeomFromEWKB . . . . . . . . . . . . . . . . . 69 7.3.8 ST_GeomFromEWKT . . . . . . . . . . . . . . . . . 70 7.3.9 ST_GeometryFromText . . . . . . . . . . . . . . . . 72 7.3.10 ST_GeomFromGML . . . . . . . . . . . . . . . 72 7.3.11 ST_GeomFromKML . . . . . . . . . . . . . . . 73 7.3.12 ST_GMLToSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 7.3.13 ST_GeomFromText . . . . . . . . . . . . . . . 75 7.3.14 ST_GeomFromWKB . . . . . . . . . . . . . . . 76 7.3.15 ST_LineFromMultiPoint . . . . . . . . . . . . . . . . 77 7.3.16 ST_LineFromText . . . . . . . . . . . . . . . . . . . . . . . . . . 78 7.3.17 ST_LineFromWKB . . . . . . . . . . . . . . . 79 7.3.18 ST_LinestringFromWKB . . . . . . . . . . . . . . . 79 7.3.19 ST_MakeBox2D . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 7.3.20 ST_MakeBox3D . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 7.3.21 ST_MakeLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 7.3.22 ST_MakeEnvelope . . . . . . . . . . . . . . . . . . . . . . . . . . 83 7.3.23 ST_MakePolygon . . . . . . . . . . . . . . . . . . . . . . . . . . 83 7.3.24 ST_MakePoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 7.3.25 ST_MakePointM . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 7.3.26 ST_MLineFromText . . . . . . . . . . . . . . . 87 7.3.27 ST_MPointFromText . . . . . . . . . . . . . . . 88 7.3.28 ST_MPolyFromText . . . . . . . . . . . . . . . 89 7.3.29 ST_Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 7.3.30 ST_PointFromText . . . . . . . . . . . . . . . . . . . . . . . . . . 91 7.3.31 ST_PointFromWKB . . . . . . . . . . . . . . . 92 7.3.32 ST_Polygon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 7.3.33 ST_PolygonFromText . . . . . . . . . . . . . . . . . 94 7.3.34 ST_WKBToSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 7.3.35 ST_WKTToSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 7.4 Geometry Accessors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 7.4.1 GeometryType . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 7.4.2 ST_Boundary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 7.4.3 ST_CoordDim . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 7.4.4 ST_Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 7.4.5 ST_EndPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 7.4.6 ST_Envelope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 7.4.7 ST_ExteriorRing . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 7.4.8 ST_GeometryN . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 7.4.9 ST_GeometryType . . . . . . . . . . . . . . . . . . . . . . . . . . 103 7.4.10 ST_InteriorRingN . . . . . . . . . . . . . . . . . . . . . . . . . . 103 7.4.11 ST_IsClosed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 7.4.12 ST_IsEmpty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 7.4.13 ST_IsRing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 7.4.14 ST_IsSimple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 7.4.15 ST_IsValid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 7.4.16 ST_IsValidReason . . . . . . . . . . . . . . . . . . . . . . . . . . 109 7.4.17 ST_M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 7.4.18 ST_NDims . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 7.4.19 ST_NPoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 7.4.20 ST_NRings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 7.4.21 ST_NumGeometries . . . . . . . . . . . . . . . 113 7.4.22 ST_NumInteriorRings . . . . . . . . . . . . . . . . . 114 7.4.23 ST_NumInteriorRing . . . . . . . . . . . . . . . 114 7.4.24 ST_NumPoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 7.4.25 ST_PointN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 7.4.26 ST_SRID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 7.4.27 ST_StartPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 7.4.28 ST_Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 7.4.29 ST_X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 7.4.30 ST_Y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 7.4.31 ST_Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 7.4.32 ST_Zmflag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 7.5 Geometry Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 7.5.1 ST_AddPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 7.5.2 ST_Affine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 7.5.3 ST_Force_2D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 7.5.4 ST_Force_3D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 7.5.5 ST_Force_3DZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 7.5.6 ST_Force_3DM . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 7.5.7 ST_Force_4D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 7.5.8 ST_Force_Collection . . . . . . . . . . . . . . . 128 7.5.9 ST_ForceRHR . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 7.5.10 ST_LineMerge . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 7.5.11 ST_CollectionExtract . . . . . . . . . . . . . . . 131 7.5.12 ST_Multi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 7.5.13 ST_RemovePoint . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 7.5.14 ST_Reverse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 7.5.15 ST_Rotate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 7.5.16 ST_RotateX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 7.5.17 ST_RotateY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 7.5.18 ST_RotateZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 7.5.19 ST_Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 7.5.20 ST_Segmentize . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 7.5.21 ST_SetPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 7.5.22 ST_SetSRID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 7.5.23 ST_SnapToGrid . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 7.5.24 ST_Transform . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 7.5.25 ST_Translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 7.5.26 ST_TransScale . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 7.6 Geometry Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 7.6.1 ST_AsBinary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 7.6.2 ST_AsEWKB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 7.6.3 ST_AsEWKT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 7.6.4 ST_AsGeoJSON . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 7.6.5 ST_AsGML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 7.6.6 ST_AsHEXEWKB . . . . . . . . . . . . . . . . . . . . . . . . . . 152 7.6.7 ST_AsKML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 7.6.8 ST_AsSVG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 7.6.9 ST_GeoHash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 7.6.10 ST_AsText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 7.7 Operators . . . . . . . . 156 7.7.1 && . . . . . . . 156 7.7.2 &< . . . . . . . 157 7.7.3 &<| . . . . . . . 158 7.7.4 &> . . . . . . . 159 7.7.5 « . . . . . . . . 160 7.7.6 «| . . . . . . . . 161 7.7.7 = . . . . . . . . . . . . . . . 161 7.7.8 » . . . . . . . . . . . . . . . 163 7.7.9 @ . . . . . . . . . . . . . . . 163 7.7.10 |&> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 7.7.11 |» . . . . . . . . . . . . . . . 165 7.7.12 ~ . . . . . . . . . . . . . . . 166 7.7.13 ~= . . . . . . . . . . . . . . . 167 7.8 Spatial Relationships and Measurements . . . . . 167 7.8.1 ST_Area . . . . . . . . . . . . . . . 167 7.8.2 ST_Azimuth. . . . . . . . . . . . 169 7.8.3 ST_Centroid. . . . . . . . . . . . 170 7.8.4 ST_ClosestPoint. . . . . . . . . . 171 7.8.5 ST_Contains. . . . . . . . . . . . 172 7.8.6 ST_ContainsProperly. . . . . . . . 176 7.8.7 ST_Covers. . . . . . . . . . . . . 177 7.8.8 ST_CoveredBy. . . . . . . . . . . 179 7.8.9 ST_Crosses. . . . . . . . . . . . . 180 7.8.10 ST_LineCrossingDirection . . . . . . . . . . . . . . . 183 7.8.11 ST_Disjoint. . . . . . . . . . . . . 185 7.8.12 ST_Distance. . . . . . . . . . . . 187 7.8.13 ST_HausdorffDistance. . . . . . . 188 7.8.14 ST_MaxDistance. . . . . . . . . . 189 7.8.15 ST_Distance_Sphere. . . . . . . . 190 7.8.16 ST_Distance_Spheroid. . . . . . . 191 7.8.17 ST_DFullyWithin. . . . . . . . . . 191 7.8.18 ST_DWithin. . . . . . . . . . . . 192 7.8.19 ST_Equals. . . . . . . . . . . . . 193 7.8.20 ST_HasArc. . . . . . . . . . . . . 194 7.8.21 ST_Intersects. . . . . . . . . . . . 195 7.8.22 ST_Length. . . . . . . . . . . . . 196 7.8.23 ST_Length2D. . . . . . . . . . . . 198 7.8.24 ST_Length3D. . . . . . . . . . . . 198 7.8.25 ST_Length_Spheroid. . . . . . . . 199 7.8.26 ST_Length2D_Spheroid . . . . . . . . . . . . . . . . 200 7.8.27 ST_Length3D_Spheroid . . . . . . . . . . . . . . . . 201 7.8.28 ST_LongestLine. . . . . . . . . . 202 7.8.29 ST_OrderingEquals. . . . . . . . . 204 7.8.30 ST_Overlaps. . . . . . . . . . . . 205 7.8.31 ST_Perimeter. . . . . . . . . . . . 207 7.8.32 ST_Perimeter2D. . . . . . . . . . 208 7.8.33 ST_Perimeter3D. . . . . . . . . . 208 7.8.34 ST_PointOnSurface. . . . . . . . 209 7.8.35 ST_Relate . . . . . . . . . . . . . . . 210 7.8.36 ST_ShortestLine. . . . . . . . . . 212 7.8.37 ST_Touches. . . . . . . . . . . . . 213 7.8.38 ST_Within. . . . . . . . . . . . . 215 7.9 Geometry Processing Functions . . . . . . . . . . . . . . . . 217 7.9.1 ST_Buffer. . . . . . . . . . . . . 217 7.9.2 ST_BuildArea. . . . . . . . . . . 221 7.9.3 ST_Collect. . . . . . . . . . . . . 222 7.9.4 ST_ConvexHull. . . . . . . . . . . 224 7.9.5 ST_CurveToLine. . . . . . . . . . 225 7.9.6 ST_Difference. . . . . . . . . . . 228 7.9.7 ST_Dump . . . . . . . . . . . . . . . 229 7.9.8 ST_DumpPoints. . . . . . . . . . 230 7.9.9 ST_DumpRings. . . . . . . . . . 232 7.9.10 ST_Intersection. . . . . . . . . . . 233 7.9.11 ST_LineToCurve. . . . . . . . . . 235 7.9.12 ST_MemUnion. . . . . . . . . . . 236 7.9.13 ST_MinimumBoundingCircle . . . . . . . . . . . . . 237 7.9.14 ST_Polygonize. . . . . . . . . . . 238 7.9.15 ST_Shift_Longitude. . . . . . . . 239 7.9.16 ST_Simplify. . . . . . . . . . . . 240 7.9.17 ST_SimplifyPreserveTopology . . . . . . . . . . . . . 241 7.9.18 ST_SymDifference. . . . . . . . . 242 7.9.19 ST_Union . . . . . . . . . . . . . . . 244 7.10 Linear Referencing. . . . . . . . . . . . . 246 7.10.1 ST_Line_Interpolate_Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 7.10.2 ST_Line_Locate_Point. . . . . . . 248 7.10.3 ST_Line_Substring. . . . . . . . . 249 7.10.4 ST_Locate_Along_Measure . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . 250 7.10.5 ST_Locate_Between_Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 7.10.6 ST_LocateBetweenElevations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 7.10.7 ST_AddMeasure. . . . . . . . . . 253 7.11 Long Transactions Support. . . . . . . . . 254 7.11.1 AddAuth . . . . . . . . . . . . . . . 254 7.11.2 CheckAuth. . . . . . . . . . . . . 255 7.11.3 DisableLongTransactions . . . . . . . . . . . . . . . . . . . . . . . . . . 256 7.11.4 EnableLongTransactions . . . . . . . . . . . . . . . . . . . . . . . . . .6 7.11.5 LockRow . . . . . . . . . . . . . . . 257 7.11.6 UnlockRows. . . . . . . . . . . . 257 7.12 Miscellaneous Functions. . . . . . . . . . 258 7.12.1 ST_Accum. . . . . . . . . . . . . 258 7.12.2 Box2D . . . . . . . . . . . . . . . . 259 7.12.3 Box3D . . . . . . . . . . . . . . . . 260 7.12.4 ST_Estimated_Extent. . . . . . . 260 7.12.5 ST_Expand. . . . . . . . . . . . . 261 7.12.6 ST_Extent. . . . . . . . . . . . . 262 7.12.7 ST_Extent3D. . . . . . . . . . . . 264 7.12.8 Find_SRID. . . . . . . . . . . . . 265 7.12.9 ST_Mem_Size. . . . . . . . . . . 265 7.12.10 ST_Point_Inside_Circle . . . . . . . . . . . . . . . . . . . 267 7.12.11 ST_XMax . . . . . . . . . . . . . . . 267 7.12.12 ST_XMin . . . . . . . . . . . . . . . 268 7.12.13 ST_YMax . . . . . . . . . . . . . . . 269 7.12.14 ST_YMin . . . . . . . . . . . . . . . 270 7.12.15 ST_ZMax . . . . . . . . . . . . . . . 271 7.12.16 ST_ZMin . . . . . . . . . . . . . . . 272 7.13 Exceptional Functions. . . . . . . . . . . 273 7.13.1 PostGIS_AddBBox. . . . . . . . . 274 7.13.2 PostGIS_DropBBox. . . . . . . . 274 7.13.3 PostGIS_HasBBox. . . . . . . . . 275 8 PostGIS Special Functions Index 277 8.1 PostGIS Aggregate Functions. . . . . . . . 277 8.2 PostGIS SQL-MM Compliant Functions . . . . . . . . . . . . . . 277 8.3 PostGIS Geography Support Functions . . . . . . . . . . .. . . . . . . 281 8.4 PostGIS Geometry Dump Functions . . . . . . . . . . . . . . . . . . . . . 282 8.5 PostGIS Box Functions. . . . . . . . . . . 282 8.6 PostGIS Functions that support 3D . . . . . . . . . . . . . . . . . . . 283 8.7 PostGIS Curved Geometry Support Functions . . . . . .. . . . . . . . . . . . . . . . 286 8.8 PostGIS Function Support Matrix . . . . . . . . . . . . . . . . .. . . . . 288 8.9 New PostGIS Functions. . . . . . . . . . . 294 8.9.1 PostGIS Functions new, behavior changed, or enhanced in 1.5 . . . . . .9.2 PostGIS Functions new, behavior changed, or enhanced in 1.4 . . . . . . . . . . 296 8.9.3 PostGIS Functions new in 1.3 . . . . . . . . . . . . . . . . . . . . . . . . . 296 9 Reporting Problems 297 9.1 Reporting Software Bugs. . . . . . . . . . 297 9.2 Reporting Documentation Issues . . . . . . . . . . . . . . 297 A Appendix 298. . . . . . . . . . . . . . . 298 A.1.1 Bug Fixes . . . . . . . . . . . . . . . 298 A.2 Release 1.5.2 . . . . . . . . . . . . . . . . . 298 A.2.1 Bug Fixes . . . . . . . . . . . . . . . 299 A.3 Release 1.5.1 . . . . . . . . . . . . . . . . . 299 A.3.1 Bug Fixes . . . . . . . . . . . . . . . 299 A.4 Release 1.5.0 . . . . . . . . . . . . . . . . . 300 A.4.1 API Stability. . . . . . . . . . . . 300 A.4.2 Compatibility. . . . . . . . . . . . 300 A.4.3 New Features. . . . . . . . . . . . 300 A.4.4 Enhancements. . . . . . . . . . . 301 A.4.5 Bug fixes . . . . . . . . . . . . . . . 301 A.5 Release 1.4.0 . . . . . . . . . . . . . . . . . 301 A.5.1 API Stability. . . . . . . . . . . . 301 A.5.2 Compatibility. . . . . . . . . . . . 301 A.5.3 New Features. . . . . . . . . . . . 301 A.5.4 Enhancements. . . . . . . . . . . 302 A.5.5 Bug fixes . . . . . . . . . . . . . . . 302 A.6 Release 1.3.6 . . . . . . . . . . . . . . . . . 302 A.7 Release 1.3.5 . . . . . . . . . . . . . . . . . 302 A.8 Release 1.3.4 . . . . . . . . . . . . . . . . . 303 A.9 Release 1.3.3 . . . . . . . . . . . . . . . . . 303 A.10 Release 1.3.2 . . . . . . . . . . . . . . . . . 303 A.11 Release 1.3.1 . . . . . . . . . . . . . . . . . 303 A.12 Release 1.3.0 . . . . . . . . . . . . . . . . . 303 A.12.1 Added Functionality. . . . . . . . 303 A.12.2 Performance Enhancements . . . . . . . . 303 A.12.3 Other Changes. . . . . . . . . . . 304 A.13 Release 1.2.1 . . . . . . . . . . . . . . . . . 304 A.13.1 Changes . . . . . . . . . . . . . . . . 304 A.14 Release 1.2.0 . . . . . . . . . . . . . . . . . 304 A.14.1 Changes . . . . . . . . . . . . . . . . 304 A.15 Release 1.1.6 . . . . . . . . . . . . . . . . . 304 A.15.1 Upgrading. . . . . . . . . . . . . 304 A.15.2 Bug fixes . . . . . . . . . . . . . . . 305 A.15.3 Other changes. . . . . . . . . . . . 305 A.16 Release 1.1.5 . . . . . . . . . . . . . . . . . 305 A.16.1 Upgrading. . . . . . . . . . . . . 305 A.16.2 Bug fixes . . . . . . . . . . . . . . . 305 A.16.3 New Features. . . . . . . . . . . . 305 A.17 Release 1.1.4 . . . . . . . . . . . . . . . . . 305 A.17.1 Upgrading. . . . . . . . . . . . . 306 A.17.2 Bug fixes . . . . . . . . . . . . . . . 306 A.17.3 Java changes. . . . . . . . . . . . 306 A.18 Release 1.1.3 . . . . . . . . . . . . . . . . . 306 A.18.1 Upgrading. . . . . . . . . . . . . 306 A.18.2 Bug fixes / correctness. . . . . . . 306 A.18.3 New functionalities. . . . . . . . . 307 A.18.4 JDBC changes. . . . . . . . . . . 307 A.18.5 Other changes. . . . . . . . . . . . 307 A.19 Release 1.1.2 . . . . . . . . . . . . . . . . . 307 A.19.1 Upgrading. . . . . . . . . . . . . 307 A.19.2 Bug fixes . . . . . . . . . . . . . . . 307 A.19.3 New functionalities. . . . . . . . . 308 A.19.4 Other changes. . . . . . . . . . . . 308 A.20 Release 1.1.1 . . . . . . . . . . . . . . . . . 308 A.20.1 Upgrading. . . . . . . . . . . . . 308 A.20.2 Bug fixes . . . . . . . . . . . . . . . 308 A.20.3 New functionalities. . . . . . . . . 308 A.21 Release 1.1.0 . . . . . . . . . . . . . . . . . 309 A.21.1 Credits . . . . . . . . . . . . . . . . 309 A.21.2 Upgrading. . . . . . . . . . . . . 309 A.21.3 New functions. . . . . . . . . . . 309 A.21.4 Bug fixes . . . . . . . . . . . . . . . 310 A.21.5 Function semantic changes . . . . . . . 310 A.21.6 Performance improvements . . . . . . .. 310 A.21.7 JDBC2 works. . . . . . . . . . . . 310 A.21.8 Other new things. . . . . . . . . . 310 A.21.9 Other changes. . . . . . . . . . . . 310 A.22 Release 1.0.6 . . . . . . . . . . . . . . . . . 311 A.22.1 Upgrading. . . . . . . . . . . . . 311 A.22.2 Bug fixes . . . . . . . . . . . . . . . 311 A.22.3 Improvements. . . . . . . . . . . . 311 A.23 Release 1.0.5 . . . . . . . . . . . . . . . . . 311 A.23.1 Upgrading. . . . . . . . . . . . . 311 A.23.2 Library changes. . . . . . . . . . . 312 A.23.3 Loader changes. . . . . . . . . . . 312 A.23.4 Other changes. . . . . . . . . . . . 312 A.24 Release 1.0.4 . . . . . . . . . . . . . . . . . 312 A.24.1 Upgrading. . . . . . . . . . . . . 312 A.24.2 Bug fixes . . . . . . . . . . . . . . . 312 A.24.3 Improvements. . . . . . . . . . . . 313 A.25 Release 1.0.3 . . . . . . . . . . . . . . . . . 313 A.25.1 Upgrading. . . . . . . . . . . . . 313 A.25.2 Bug fixes . . . . . . . . . . . . . . . 313 A.25.3 Improvements. . . . . . . . . . . . 313 A.26 Release 1.0.2 . . . . . . . . . . . . . . . . . 313 A.26.1 Upgrading. . . . . . . . . . . . . 314 A.26.2 Bug fixes . . . . . . . . . . . . . . . 314 A.26.3 Improvements. . . . . . . . . . . . 314 A.27 Release 1.0.1 . . . . . . . . . . . . . . . . . 314 A.27.1 Upgrading. . . . . . . . . . . . . 314 A.27.2 Library changes. . . . . . . . . . . 314 A.27.3 Other changes/additions . . . . . 314 A.28 Release 1.0.0 . . . . . . . . . . . . . . . . . 315 A.28.1 Upgrading. . . . . . . . . . . . . 315 A.28.2 Library changes. . . . . . . . . . . 315 A.28.3 Other changes/additions . . . . . . . 315 A.29 Release 1.0.0RC6 . . . . . . . . . . . . . . . 315 A.29.1 Upgrading. . . . . . . . . . . . . 315 A.29.2 Library changes. . . . . . . . . . . 315 A.29.3 Scripts changes. . . . . . . . . . . 315 A.29.4 Other changes. . . . . . . . . . . . 316 A.30 Release 1.0.0RC5 . . . . . . . . . . . . . . . 316 A.30.1 Upgrading. . . . . . . . . . . . . 316 A.30.2 Library changes. . . . . . . . . . . 316 A.30.3 Other changes. . . . . . . . . . . . 316 A.31 Release 1.0.0RC4 . . . . . . . . . . . . . . . 316 A.31.1 Upgrading. . . . . . . . . . . . . 316 A.31.2 Library changes. . . . . . . . . . . 316 A.31.3 Scripts changes. . . . . . . . . . . 317 A.31.4 Other changes. . . . . . . . . . . . 317 A.32 Release 1.0.0RC3 . . . . . . . . . . . . . . . 317 A.32.1 Upgrading. . . . . . . . . . . . . 317 A.32.2 Library changes. . . . . . . . . . . 317 A.32.3 Scripts changes. . . . . . . . . . . 317 A.32.4 JDBC changes. . . . . . . . . . . 318 A.32.5 Other changes. . . . . . . . . . . . 318 A.33 Release 1.0.0RC2 . . . . . . . . . . . . . . . 318 A.33.1 Upgrading. . . . . . . . . . . . . 318 A.33.2 Library changes. . . . . . . . . . . 318 A.33.3 Scripts changes. . . . . . . . . . . 318 A.33.4 Other changes. . . . . . . . . . . . 319 A.34 Release 1.0.0RC1 . . . . . . . . . . . . . . . 319 A.34.1 Upgrading. . . . . . . . . . . . . 319 A.34.2 Changes . . . . . . . . . . . . . . . . 319