Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Java+Play Framework tech demo that imports the CodePoint Open UK postcode dataset and offers a Geocoding REST API and a postcode map.
Java Scala
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
codepointopen
conf
lib
project
public/images
.gitignore
.travis.yml
README.markdown
screenshot.png
screenshot2.png

README.markdown

CamelCode Build Status

A tech demo built using Play Framework 2.2 (Java) that imports the CodePoint Open UK postcode dataset and offers a Geocoding RESTful API and a map. It also demonstrates how Google Guice can be integrated in a Play Framework Java application.

Follow @analytically for updates.

Requirements

Setup

Edit conf/application.conf and point it to a MongoDB installation (defaults to localhost:27017), and execute

play run

Then drop the CodePoint Open CSV (scroll halfway down, 20mb) files in the codepointopen directory.

After each file is imported, it will be moved to the codepointopen/done directory.

Then visit http://localhost:9000 and you should see the welcome screen. Check out the server metrics or the map.

REST API and JSON

GET http://localhost:9000/latlng/POSTCODE to geocode a UK postcode. Response will be JSON:

{"latitude":51.505615,"longitude":-2.6120315}

Screenshots

Welcome Page

Map

Technology

License

Licensed under the WTFPL.

This data contains Ordnance Survey data © Crown copyright and database right 2013. Code-Point Open contains Royal Mail data © Royal Mail copyright and database right 2012. Code-Point Open and ONSPD contains National Statistics data © Crown copyright and database right 2013.

OS data may be used under the terms of the OS OpenData licence.

Something went wrong with that request. Please try again.