资源说明: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
本源码包内暂不包含可直接显示的源代码文件,请下载源码包。