This extension integrates with the PostGIS geometry type. Namely Point, Polygon and MultiPolygon geometries are supported.

To see the functions implemented in this extension please refer to the SQL API.

Compile H3 as a shared library. The source is available on github, there are also detailed instructions for building H3 available in that repository, but to make H3 work with this extension there are are two addtiional build flags required:

cmake -DBUILD_SHARED_LIBS=1 -DCMAKE_INSTALL_PREFIX:PATH=/usr
make
sudo make install

In case you have set up your LD_LIBRARY_PATH for PostgreSQL to also look in /usr/local for libraries, you can ommit the -DCMAKE_INSTALL_PREFIX:PATH=/usr switch.

Compile the pgh3 extension:

make
sudo make install

Run the tests (this is an optional step):

make installcheck

Before using this extension, it needs to be added to the databses using postgresqls CREATE EXTENSION command:

create extension postgis; -- dependency of pgh3, must be created first
create extension pgh3;

For usage examples see the unittests in the sql/*_test.sql files.

• Implement more parts of the H3 API
• Use the numeric-type for H3 indexes?

This software is licensed under the Apache 2.0 License.

(c) 2018 German Aerospace Center (DLR); German Remote Sensing Data Center; Department: Geo-Risks and Civil Security