Final Report: Implement Geospatial Data Viewer in pgAdmin4 for PostGIS


I propose to implement a geospatial data viewer in pgAdmin4 that will allow users to view the tables in a spatial database and the results of queries executed. With the viewer I intend to develop, users can directly view geospatial data on a map within the pgAdmin4 GUI.

Status Before GSoC

pgAdmin is the GUI management tool for PostgreSQL. The latest version pgAdmin4 is web-based and written in Python and jQuery with Bootstrap, using the Flask framework. But currently there is no geospatial data viewer in pgAdmin4-3.1, and external applications, such as QGIS are required if we want to view the data on a map. The pgAdmin4 Data Output panel only allows the user to view the table with the encoded geometries in text format.

My Proposal and Work

With the geometry viewer I have created, users can now view individual geometry as well as all the geometries in the map. They can also view the properties of the geometries directly in the geometry viewer by clicking the specific geometry. Here are some screenshots:

Below are the default strategies for parsing data:

  • Supported data type: Geometry Viewer support 2d and 3dm geometries in EWKB format including Point, LineString, Polygon MultiPoint, MultiLineString, MultiPolygon, GeometryCollection.
  • About SRID: If there are geometries with different SRIDs in the same column, the viewer will render geometries with the same SRID in the map. If SRID=4326 the OSM tile layer will be added into the map.
  • About data size: For performance considerations, the viewer will render geometries no more than 100000, totaling up to 20MB.


Please test my code following the instructions below:

  1. Download the geoviewer branch.
  2. Build and run pgAdmin4 following in the repository.
  3. For unit test, run cd $PGADMIN4_SRC and make check-js.
  4. If you want to have a try or test manually, install PostGIS and import some geometry data (for example import this database using psql). Then execute query in the pgAdmin4 and view the results.

Future Work

The geometry viewer is functional and below are some suggestions for future work:

Optimize performance:

  • Cluster markers using Leaflet.markercluster and deflate lines and polygons to a marker when their screen size becomes too small using Leaflet.Deflate.
  • Enable vectortile layer using geojson-vt. Here is an example: leaflet-and-geojson-tiles.
  • PgAdmin4 only load 1000 records by default. When users click 'view' button in the column header, show the map firstly and load the other records in the background and then add the records dynamically.

New features:

  • Custom geometry style, e.g SELECT *, '#333333' as __fillcolor, '#232323' as __strokecolor, 0.5 as __strokewidth FROM xxx.
  • Custom background tile layer. Enable users to specify their own tilelayer url.
  • Highlight selected feature. Add 'zoom home extent' button.
Last modified 13 months ago Last modified on Aug 15, 2018 9:23:36 AM

Attachments (13)