Documentation

The documentation set is generated daily from the documentation set in the SVN archive. The programmers references is still a little thin, but basic users documentation is passable. Have a look:

Documentation:

Other documentation:

Related Projects:

Other languages:

Case Studies

Read case studies about how PostGIS is being used by organizations around the world.

F.A.Q.

Who is using PostGIS?

Lots of people! We log about 800 downloads of the source code each month. People have told us about their PostGIS installations in Australia, Boston, British Columbia, Colorado, Portugal, Virginia, Georgia, Switzerland, Iowa, Oklahoma, Florida, Chile, Switzerland, Brazil, Montana, Sweden, Italy, Norway, New Zealand, Germany, and Sri Lanka. We expect there are many more which we do not even know about. Read the case studies.

Is there a precompiled Windows binary available?

Yes! As of version 8.0, PostgreSQL can be run in a Windows native form. That means it is now possible to have Windows binaries of PostGIS as well. Get it here: http://www.postgresql.org/download/.

What tools work with data in a PostGIS database?

There are now several open source tools which work with PostGIS. The uDig project is working on a full read/write desktop environment that can work with PostGIS directly. For internet mapping, the University of Minnesota Mapserver can use PostGIS as a data source. The GeoTools Java GIS toolkit has PostGIS support, as does the GeoServer Web Feature Server. GRASS supports PostGIS as a data source. The Open JUMP Java desktop GIS viewer has a simple plugin for reading PostGIS data, and the QGIS desktop has good PostGIS support. PostGIS data can be exported to several output GIS formats using the OGR C++ library and commandline tools (and of cource with the bundled Shape file dumper). And of course any language which can work with PostgreSQL can work with PostGIS -- the list includes Perl, PHP, Python, TCL, C, C++, Java, C#, and more.

Are there going to be more tools?

More every day! FreeGIS is an excellent compendium of ongoing open source GIS development. In addition, more proprietary viewing and editing software is becoming available all the time. For example, the Feature Manipulation Engine from Safe Software has support for PostGIS reading and writing. The Red Spider web service portal from Ionic can serve PostGIS data. And CadCorp SIS provides desktop read/write support for PostGIS.

Installation

You will need to install the following libraries before installing PostGIS:

  • PROJ4 4.8 (reprojection)
  • GEOS 3.3.3 (geometry)
  • GDAL 1.9 (raster)

Un-tar the PostGIS tar-ball, configure, build and install the software. You may need to use the --with-pgsql configure parameter if your PostgreSQL is in a non-standard location. You must have the PL/pgSQL prodedural language installed before installing PostGIS.

tar xvzf postgis-2.0.2.tar.gz
cd postgis-2.0.2
./configure
make
make install
createlang plpgsql yourtestdatabase
psql -d yourtestdatabase -f postgis.sql
psql -d yourtestdatabase -f spatial_ref_sys.sql