Fr

ee
Sa
PostGIS Essentials m

PostGIS Essentials
pl
e
PostGIS is one of the world's leading spatial databases,
What you will learn from this book
created as a geographic extension for PostgreSQL. With
it, users are able to manipulate and visualize spatial data  Install and configure PostGIS and other useful
incredibly effectively and efficiently. open source tools such as QGIS and GDAL
for working with spatial data

PostGIS Essentials introduces you to the fundamentals  Create spatial databases and tables from
of PostGIS, giving you easy access to one of the most scratch and develop spatial queries through
popular and powerful spatial databases available today. practical examples
You will begin by learning how to install and successfully
 Obtain useful spatial data from public and
set up PostGIS before covering how to create your first free sources and insert and manage this
spatial database. The book will then help you to develop data to be useful with your data tables
your skills further as you will learn how to insert GIS
objects as well as how to select and filter GIS queries  Familiarize yourself with the fundamental
concepts in PostGIS and spatial databases
with clear and practical information. You will then learn
how to display GIS data graphically and create effective  Visualize the data stored in your tables and C o m m u n i t y E x p e r i e n c e D i s t i l l e d
visualizations. The book concludes with tips, tricks, and combine it with other data sources to create
techniques to help you optimize PostGIS and improve beautiful graphical solutions using QGIS
the performance of your database.
 Use the GDAL spatial library to transform
and reproject from a wide range of data

PostGIS Essentials
formats such as vectorial and raster
Who this book is written for geospatial data formats
This book is a quick guide for anyone who wants to
get started with PostGIS and develop their very own GIS  Develop a complete GIS application from
scratch by implementing the concepts

Angel Marquez
projects quickly.
learned in the book

$ 44.99 US Learn how to build powerful spatial database solutions with

£ 29.99 UK
PostGIS quickly and efficiently
Prices do not include
community experience distilled local sales tax or VAT
P U B L I S H I N G where applicable

Visit www.PacktPub.com for books, eBooks,

code, downloads, and PacktLib. Angel Marquez
In this package, you will find:
 The author biography
 A preview chapter from the book, Chapter 8 'Developing a GIS
Web Application'
 A synopsis of the book’s content
 More information on PostGIS Essentials

About the Author

Angel Marquez is a software engineer with a master's degree in computing sciences. He
has been working with GIS and open source tools for more than a decade in both public
and private sectors, in his home country of Mexico.
PostGIS Essentials
PostGIS is basically an extension of PostgreSQL DBMS that allows it to manage
spatial datatypes. It was developed by Refractions Research Inc, a Canadian company,
and published under the GNU license. Through the years, PostGIS has been observed
to be a better solution than many of the other options on the market. A lot of these
solutions are proprietary.
This book's objective is to be a guide for those who are new to the field of spatial
databases; it covers some of the most basic and important concepts, while trying
to keep them simple. At the same time, it could be useful for those of you who are
advanced, have experience in this field, and are now looking for a way to graphically
show the results of its spatial queries and exploit the results. This may be because you
want to speed up your current queries. It might also be useful for developers who have
little or no knowledge about spatial databases, but want to build desktop or web
applications with spatial functionality, with only the basic concepts they have learned.
This book helps you in such a way that you either go through the first chapter
progressively until the end, or only focus on the chapters you're interested in without
reading any of the previous ones.
This book is not a complete or exhaustive reference of PostGIS, but is more like
a starting point where you will find the information that you need to start your projects,
in a consolidated and easy-to-digest manner. The practical exercises will also help you
brush up your knowledge along the way.
What This Book Covers
Chapter 1, Introducing PostGIS and Setting it Up, provides step-by-step instructions to
download, install, and configure the three basic tools needed for the rest of this book:
Postgres DBMS, the PostGIS extension, and QGIS for data visualization.
Chapter 2, Creating Your First Spatial Database, helps you to create your first GIS
database using both the command interface and graphical tools.
Chapter 3, Inserting GIS Objects, introduces you to the basics of GIS objects and data
manipulation sentences.
Chapter 4, Selecting and Filtering GIS Queries, introduces you to the making, selecting,
and filtering of spatial GIS queries.
Chapter 5, Displaying GIS Data Graphically, shows you how to display query results
graphically into an electronic map.
Chapter 6, Management of Vectorial and Raster Data with PostGIS, shows you how to
import and export vectorial and raster data into and from a database, to and from several
file formats.
Chapter 7, Performance Tuning, shows you how to speed up spatial queries by using
indexes or tuning the PostgreSQL configuration for PostGIS.
Chapter 8, Developing a GIS Web Application, shows you how to create a GIS web
application using open source tools.
Chapter 9, Developing a Desktop GIS Application, shows you how to create a GIS
desktop application using open source tools.
 Developing a GIS Web
Application
Now that we have developed our spatial database, the ability to see the data inside it,
and actually tuned it to achieve an optimal performance, it's time to develop a useful
application, which exploits everything that we have seen in the previous chapters.

When you develop an application, you have to be very clear about who your target
audience is; this means thinking about who the users of your application will be and
the role of this application in an organization. This fact is crucial when you define not
only the application's logic, but also the technology that will support this logic in the
best way. We will split the system into two applications:

• Web application: Its objective is to be a platform that consumers can use

to get information on properties that are available for sale, including the
location of them on a map.
• Desktop application: The objective of this application is to show a way to
manipulate the information on these properties in a visual and easy manner,
rather than just using SQL commands to add, remove, or edit data. This
information is provided to the managers of a spatial database.

We will use the example of the real estate company to illustrate both these approaches;
in this case, we will develop two applications. To provide you with a better
understanding, let's describe the roles of the two actors that we will use in the system:

• Consumer: A consumer might want information on available properties to

see which one fits his or her needs better.
• Manager: A manager's prerogative is to be able to manage a property's
information (add, remove, or edit it), and especially to set up the geographic
position of it in the simplest and most effective way, which will allow him or
her to focus on getting the work done.

[ 119 ]
Developing a GIS Web Application

To explain a system's dynamic nature better, take a look at the following figure:

There are a lot of options available when you have to choose the right technology
to develop your project. However, it would be impossible to cover all of them in this
chapter, though, we will try to cover two of the main development environments
you could choose for your application.

We will continue to use open source development tools (such as PHP, JavaScript,
and so on), but the examples shown to you will be crafted in a way that will help
you adapt them in case you want to use any other commercial language or platform.
The purpose of this book isn't to teach you a particular programming language or to
configure any web or desktop platform, therefore, we will focus on the interaction
with spatial data.

In this chapter, we will cover the following topics:

• Setting up the development environment for a web application using open

source tools
• Learning how to create a web application that uses spatial data in our
databases

[ 120 ]
 Chapter 8

Developing a web application

We can take an example where the management board of the real estate company
has decided to add a module to its website where potential clients can check the
available properties for sale online. The objective of this is to reinforce the sales
process and make the site more attractive and, therefore, the properties must be
placed on a map.

You, as chief of the development department, have decided to mount it in a separate

server, where you will have an Apache server with a PHP module. In the following
sections, we will cover the process that you have to follow in order to achieve the
companies' objective; we will touch on some installation aspects of the environment,
but in lesser detail, so that we can focus on the development.

Installing the web server

Installing and configuring an Apache web server is not really the objective of this
book, so we will cover a very simple and basic installation, which is enough to
prepare our environment. If you need more information on installing an Apache
web server, you can refer to Apache Tomcat 7 Essentials, Tanuj Khare, Packt Publishing
or PHP Application Development with NetBeans Beginner's Guide, M A Hossain Tonu,
Packt Publishing. We will assume that you have a Windows machine, actually I will
use a Windows 7 computer for the installation, and the process to install it in another
version of Windows is also very similar. To do this, perform the following steps:

1. Download the Apache web server from http://www.apachelounge.com/

download/:

2. Decompress and save it in a machine folder; in this case, we have saved it

in C:\Apache24. If you choose to install it on a different disk drive (maybe
D:), you will have to change the http.conf file content to redirect the path
installation.

[ 121 ]
Developing a GIS Web Application

3. Open a command line window and execute the following commands:

d c:\apache24\bin
httpd.exe –k install

This will install httpd.exe as a Window's service.

4. Create a shortcut on the desktop to C:\apache24\bin\ApacheMonitor.exe.

We will run this program to start and stop the web server.
5. Let's probe that everything is okay with the web server; to do this, open
your web browser and type: http://localhost/. A web page similar to the
following screenshot will be displayed:

Once we have the web server running, we must install and configure the PHP
module in order to generate the scripts that will access our database server. In this
case, we choose PHP as a language but you can choose any other and take this
example as a reference.

Installing a PHP module

Perform the following steps to install the PHP module:

1. Download the PHP module from http://windows.php.net/download/:

[ 122 ]
 Chapter 8

2. Decompress and save it in the machine folder; in this case, we have saved it
in C:\php.
3. Rename the file from C:\php\php.ini-production to php.in.
4. Edit the php.ini file setting for the following options:
doc_root = c:\apache24\htdocs
extension_dir = c:\php\ext

5. Go to the extension section and remove the ; character from the following
line:
;extension=php_pgsql.dll;

This way, you will able to allow PHP to connect to the database server.

6. Open the C:\apache24\conf\httpd.conffile and add the following

lines at the bottom of the file:
LoadModule php5_module "c:/php/php5apache2_4.dll"
AddHandler application/x-httpd-php .php
PHPIniDir "C:/php"

7. Save the file and restart the Apache web server, with this command:
httpd.exe –k restart

8. To probe that everything is working fine, open Notepad and type the
following line:
<?php phpinfo();?>

9. Save it in the C:\Apache24\htdocs folder as test.php.

10. Now, open your web browser again and load the test script by typing
http://localhost/test.php on the navigation bar. Once you do this,
you will see a page similar to the following screenshot:

[ 123 ]
Developing a GIS Web Application

Now that all the underlying services are installed, it's time to install the map
visualization component. We have chosen a component that reunites the features of
simplicity of usage and beautiful presentation; this component is called Leaflet. There
are other powerful options, such as OpenLayers and CesiumJS. Packt Publishing
books, such as OpenLayers Cookbook, Antonio Santiago Perez and OpenLayers 3 Beginner's
Guide, Thomas Gratier, Paul Spencer, Erik Hazzard give you information on these.

Installing Leaflet
Leaflet is a beautiful, light, open source, and free component based on JavaScript;
you can find it at http://leafletjs.com:

Now, we will see how to install it in order to use it to develop our website. To do
this, perform the following steps:

1. Go to the Download section.

2. Then, you will have to decompress the download file and copy the content
inside the web folder of your server. In this case, we have copied it in C:\
Apache24\htdocs\leaflet.

Implementing the web application

Now that the component is installed, we can develop our PHP script. We can use the
Notepad application to edit it or, if you prefer, any other editing tool, such as Eclipse
for PHP, Notepad2, Bluefish Editor, and so on.

Before we start, let's establish the overall structure of the application that we are
going to make:

1. First, we will connect our script to the spatial database using PHP.
2. Then, we will create a JavaScript object that will contain the map that the
user will see.

[ 124 ]
 Chapter 8

3. After this, we will read information on the database and, from it, we will
generate the code that will create the necessary JavaScript objects, which will
represent the positions of the properties.

We can show this graphically using the following image:

Now, let's start coding our application. Create a file named index.php in the
C:\Apache24\htdocs folder.

First, we must set up the connection to our database server, specifying the connection
parameters:
// connecting to the database
$dbconnection = pg_connect("host=localhostdbname=Real-Estate
user=postgres password=123456") or die('couldn't connect! :
' . pg_last_error());

Now, let's throw a query to get all the registers saved in the spatial table:
$query = 'SELECT id, town, street, number, ST_X(the_geom),
ST_Y(the_geom) FROM tbl_properties ';
$result = pg_query($query) or die(Query fails!: ' .
pg_last_error());

[ 125 ]
Developing a GIS Web Application

$line = pg_fetch_row($result);
//We save the position of the first register in those two
variables
$longitudeView =$line[4];
$latitudeView=$line[5];

Let's put some extra attention on the ST_X and ST_Y functions; these extract the x and
y values from the geometric object whose values correspond to the longitude and
latitude of our spatial position. The purpose of doing this is to obtain the latitude and
longitude as separate values; this will allow us to store them on separate variables
and then use these variables to create the JavaScript code.

Now, it's time to add the html code of our script. Here, we will add the JavaScript
code that we will need to invoke the map component:
<!DOCTYPE html><html><head>
<title>Real Estate Web Page</title>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-
scale=1.0">
<linkrel="stylesheet" href="leaflet/leaflet.css" />
</head><body>
<div id="map" style="width: 600px; height: 400px"></div>
<scriptsrc="leaflet/leaflet.js"></script>

Here, we add the link to both the leaflet.css and leaflet.js files that our
application will need.

Now, we add the map object; this object will carry one or several layers of
information, and each of these layers gives you different kinds of information
on the piece of terrain that we are seeing:
<script>
var map = L.map('map');
L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png',
{ attribution: '&copy; <a
href="http://osm.org/copyright">OpenStreetMap</a> contributors'
}).addTo(map);

In this case, we have added an OpenStreetMap map layer. Here is some PHP code to
show the property's position as a marker on the map:
<?php $query = 'SELECT id, town, street, number, ST_X(the_geom),
ST_Y(the_geom) FROM tbl_properties';
$result = pg_query($query) or die(The query failed: ' .
pg_last_error());
while ($line =pg_fetch_row($result))

[ 126 ]
 Chapter 8

{
$longitude =$line[4];
$latitude=$line[5];
$address=$line[2]." ".$line[3];
echo "L.marker([".$latitude.", ".$longitude."]).addTo(map)";
echo ".bindPopup('<b>".$address."').openPopup();";
} ?>

We have added code that goes through the table, gives you the position of every
piece of property, and generates a market with that position. This market will have
a pop-up frame with the address of the property that will be shown when the user
clicks on the icon. Later, we will put the map's view as the first property on the table
with a zoom level of 16:
map.setView([<?php echo $latitudeView.",".$longitudeView ?>], 16);
</script>

Finally, let's draw a table with the data of the properties in it:
<?php
// Throwing a query to the properties table
$query = 'SELECT id, town, street, number FROM tbl_properties';
$result = pg_query($query) or die('La consultafallo: ' .
pg_last_error());
//Printing the results in a html table
echo "<table>\n";
while ($line = pg_fetch_row($result))
{
echo "\t<tr>\n";
echo "\t\t<td><a
href='index.php?id=".$line[0]."'>".$line[0]."</a></td>\n";
echo "\t\t<td>".$line[1]."</td>\n";
echo "\t\t<td>".$line[2]."</td>\n";
echo "\t\t<td>".$line[3]."</td>\n";
echo "\t</tr>\n";
}
echo "</table>\n";
//Freeing the result set
pg_free_result($result);
//closing the database connection
pg_close($dbconn);
?>
</body>
</html>

[ 127 ]
Developing a GIS Web Application

As you can see, we have added another cell to the table that contains a hyperlink.
This link has the ID of the selected register included as a part of it. This parameter
will help us make modifications to the script where it will zoom to the selected
property when the user clicks on it.

To get all this implemented we will add the following code at the sixth line of
our script:
$where="";
if( isset($_GET['id']))
$where=" where id=".$_GET['id'];

Now, we will have to modify the query in order to add the where clause:
$query = 'SELECT id, town, street, number, ST_X(the_geom),
ST_Y(the_geom) FROM tbl_properties '.$where;

Putting everything together, we get the following script:

<?php
//Connecting to the database
$dbconn = pg_connect("host=localhostdbname=Real-Estate
user=postgres password=123456") or die(Cant connect! '
.pg_last_error());
$where="";
if( isset($_GET['id']))
$where=" where id=".$_GET['id'];
$query = 'SELECT id, town, street, number, ST_X(the_geom),
ST_Y(the_geom) FROM tbl_properties '.$where;
$result = pg_query($query) or die(The query failed!! '
.pg_last_error());
$line = pg_fetch_row($result);
$longitudeView =$line[4];
$latitudeView=$line[5];
?>
<!DOCTYPE html>
<html>
<head>
<title>Real Estate Example</title>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-
scale=1.0">
<linkrel="stylesheet" href="leaflet/leaflet.css" />
</head>
<body>
<div id="map" style="width: 600px; height: 400px"></div>
<scriptsrc="leaflet/leaflet.js"></script>
<script>

[ 128 ]
 Chapter 8

var map = L.map('map');

L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png',
{ attribution: '&copy; <a
href="http://osm.org/copyright">OpenStreetMap</a> contributors'
}).addTo(map);
<?php
// Throwing a query to the properties table
$query = 'SELECT id, town, street, number, ST_X(the_geom), ST_Y(the_
geom) FROM tbl_properties';
$result = pg_query($query) or die(The query failed!' .
pg_last_error());
while ($line =pg_fetch_row($result))
{
$longitude =$line[4];
$latitude=$line[5];
$address=$line[2]." ".$line[3];
echo "L.marker([".$latitude.", ".$longitude."]).addTo(map)";
echo ".bindPopup('<b>".$address."').openPopup();";
}
?>
map.setView([<?php echo $latitudeView.",".$longitudeView ?>], 16);
</script>
<?php
// Throwing a query to the properties table
$query = 'SELECT id, town, street, number FROM tbl_properties';
$result = pg_query($query) or die(The query failed! '
.pg_last_error());
//Printing the results in a html table
echo "<table>\n";
while ($line = pg_fetch_row($result))
{
echo "\t<tr>\n";
echo "\t\t<td><a
href='index.php?id=".$line[0]."'>".$line[0]."</a></td>\n";
echo "\t\t<td>".$line[1]."</td>\n";
echo "\t\t<td>".$line[2]."</td>\n";
echo "\t\t<td>".$line[3]."</td>\n";
echo "\t</tr>\n"; }
echo "</table>\n";
//Freeing the result set
pg_free_result($result);
// Closing the connection
pg_close($dbconn); ?>
</body>
</html>

[ 129 ]
Developing a GIS Web Application

Now, we open our favorite web browser and see this result:

This is just a sample. You can easily add more functionality to the application in
case you want to add a private section where you can add extra information for
sales people, such as the price of the property, or you might want to add a picture
of the house in the pop-up.

Summary
Until now, we have learned how to install and configure an Apache web server with
the PHP module enabled and how to use it in conjunction with the Leaflet library to
create a web application, which shows the spatial data graphically to a user. For this,
we read the information that was already stored in the database; however, you might
ask, what if we need to update this information? In the next chapter, we will build a
desktop application for managers who can update this information. To achieve this
objective, we will use a beautiful and, of course, free and open source SDK called
WorldWind, which works with Java.

[ 130 ]
 Get more information PostGIS Essentials

Where to buy this book

You can buy PostGIS Essentials from the Packt Publishing website.
Alternatively, you can buy the book from Amazon, BN.com, Computer Manuals and most internet
book retailers.
Click here for ordering and shipping details.

www.PacktPub.com

Stay Connected: