Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
bin
 
 
commonlib @ 0cf06dc
 
 
 
 
 
 
db
 
 
 
 
 
 
web
 
 
 
 
 
 
 
 
 
 

README

Gaze is a web service that can do the following:

* Find the population density at a particular point (using GPW data)
* Return the radius of a circle around a point containing a number of people
* Find placenames around a point, limited to population or distance.
* Perform a placename geocoding of a search query (using USGS and GEOnet Names data)
* Return the ISO country code for an IP address

It is used on e.g. FixMyStreet to work out how wide to search to show reports
for a particular map, or on PledgeBank for local search.

Installation
============

$ git clone git://github.com/mysociety/gaze.git
$ mkdir gaze-data
$ cd gaze
$ cp conf/general-example conf/general

Edit the conf/general file to have the database connection parameters, and the
location of two directories to store the Xapian and GPW data.

Set up a PostgreSQL database called gaze.

Fetch the single compressed zip that contains the entire country files dataset
from http://earth-info.nga.mil/gns/html/namefiles.htm and unzip it in the
gaze-data directory. For the US, fetch and unzip the Populated Places dataset
from http://geonames.usgs.gov/ in the same place.

Then run the following (replacing the input filenames with whatever you've just
downloaded):

$ psql gaze gaze < db/schema.sql
$ cd ../gaze-data
$ ../gaze/bin/usgs-geonames-parse < P_PLACES_20111204.txt
$ ../gaze/bin/xapian-index US
$ ../gaze/bin/geonames-split < geonames_dd_dms_date_20111212.txt
$ ../gaze/bin/load-all

This will set up all the place name related stuff. TODO: Document gpw-parse
beyond the comments in it - converting Gridded Population of the World data
into the format Gaze uses.

About

The mySociety Gazetteer web service

Resources

Releases

No releases published

Packages

No packages published
You can’t perform that action at this time.