# PostGIS gets Spherical (Directors Cut)

03 Nov 2009**Update:** Installation instructions have changed slightly since this post was written.

For a business oriented discussion of the new `GEOGRAPHY`

type, see my post on the OpenGeo blog.

So you want to try the new `GEOGRAPHY`

type and see what it can do? Alright then!

If you are running Windows, please follow the directions on the Windows experimental binaries download page on the PostGIS site. Note that these builds might not be the absolute latest versions available.

If you are running Linux, fetch the latest code from SVN (svn checkout http://svn.osgeo.org/postgis/trunk postgis-svn) and then follow the install instructions.

After installing, you should find the usual `postgis.sql`

file which contains the old geometry and now the new geography features too. Install PostGIS and spatial reference information as usual:

```
createdb mydb
psql -d mydb -f postgis.sql
psql -d mydb -f spatial_ref_sys.sql
```

I find it useful for testing to load a shape file in the usual way, then add a geography column to it.

```
shp2pgsql -s 26910 -g geom taxlots.shp taxlots | psql mydb
psql mydb
```

Once you have a table to play with, it’s time to add a geography column, and build indexes. You have to transform the geometry into EPSG:4326 before casting to geography. When you build the index on the geography column, it builds a special index over the sphere which respects the poles and dateline.

How does this magic index work? The “trick” is to be as lazy as possible. I didn’t want to write a whole new indexing scheme, and I already had a serviceable R-Tree index. What I needed to do was convert the lat/lon coordinates to a domain where the problems of the singularities at the poles and dateline would go away. The answer is to convert from spherical coordinates (lat/lon) relative to Greenwich into geocentric coordinates (x/y/z) relative to the center of earth. It’s easy then to build a 3D R-Tree on the geocentric bounds of the features. Calculating the bounds in 3D is tricky, because the curvature of the features over the spherical surface must be respected, but once that is done, the index performs admirably.

Now you can compare properties calculated on the plane and on the spheroid.

Note that the units returned by the geography functions are metric. Square meters for area and linear meters for distances and lengths.

How about a quick spatial self-join, to test the indexes?

In testing, I have been finding the geography index slightly faster than the geometry index, which is perhaps because I was able to write the geography index binding from scratch, trying to apply the lessons I have taken from reviewing the existing geometry index. In PostGIS 1.5 (coming Christmastime or sooner) the geography and geometry types will coexist, but use different disk serializations and index bindings. In PostGIS 2.0 (fall 2010) the geometry will also be swapped over to a new serialization and index binding and should become as fast (faster) than the geography index.

Finally, try out the transparent integration of the `ST_Buffer()`

function from geometry with the geography type.

By carefully transforming geometries out to appropriate planar spatial reference systems, you can use the functions built for geometry to provide operations on geographies. The definition for `ST_Buffer(geography, double)`

looks like this:

Note that `ST_Transform()`

appears twice, once to transform from geographics to a planar system and again to transform back after the buffer operation is complete. Also note the `_ST_BestSRID()`

function, which analyzes the geography and provides a best guess planar system suitable for carrying out the operation. Right now the system picks an appropriate UTM zone, or a polar stereographic, or falls back to a mercator if there is no good choice.

**Acknowledgements:** Of course, top billing goes to the funder, who has chosen to remain anonymous. Also, it would have been impossible for me to build the `ST_Area()`

or `ST_Distance()`

functions on the sphere and spheroid without the contributions of David Skea (if you check the PostGIS source code, you’ll find he has contributed mathematical magic in the past also). And finally, Regina Obe who has been testing and documenting my work as it is committed, resulting in very effective on-the-spot debugging and fixing of issues as they occur. Thanks everyone!