No description, website, or topics provided.
Python HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Land Insight Planning API demos

Remember, to use the Land Insight Planning API you will need to request an API key.

If you just want some examples of how to make calls to the API in a specific programming language, check out the Code Example Tool in the apiary docs.

Below we describe and explain how to setup the various demos in this repository.

Putting pins on Google Maps in the browser

Anyone with web-development experience should find it fairly easy to plot planning data with Google Maps. You don't even need to run a localhost server!

screenshot of demo

The full code for this demo is in googlemaps.html, below we give a slightly simplified version.

We start with the Add a Marker demo provided by Google, and then add in a little extra code for querying the Land Insight API. Before going further, you will need to follow the instructions in that demo to get yourself an API key for the Google Maps service (this is obviously unrelated to your Land Insight API key).

Right, now you have a Google API Key, ceate a blank .html file and copy in the code from the Google demo, setting your Google API key (as inidicated by the Google sample). Then open the file in your browser and check it works - including panning/zooming of the map.

Next, simply replace the initMap function with the following:

function initMap() {
  let theMap = new google.maps.Map(document.getElementById('map'), {
    zoom: 16,
    center: {lat: 51.5912874, lng: 0.1080217},
        {headers: {'X-Api-Key': 'YOUR_LAND_INSIGHT_API_KEY_HERE'}})
  .then(resp => resp.json())
  .then(json => {
      let locations = => ({
          lat: x.location.coordinates[1],
          lng: x.location.coordinates[0]
      })); => new google.maps.Marker({
        position: x,
        map: theMap

Note that the above is written using nice modern JavaScript features (ES6), so it may not work in older browsers.

That's it!

Plotting points with matplotlib in python

For this demo, you need python, with matplotlib installed.

screenshot of demo

The full code for this demo is in

We make the request as follows:

request = Request(r''
                      'Content-Type': r'application/json',
                      'X-Api-Key': r'YOUR_API_KEY_HERE'
response_body = urlopen(request).read()

Then we parse the json, and extract some data to plot:

data = json.loads(response_body)
locations = np.empty((len(data), 2))
for ii, record in enumerate(data):
    locations[ii,:] = record['location']['coordinates']

And this is how we plot it:

plt.plot(locations[:, 0], locations[:, 1], '.')

Paging by date in Python

Currently there are limits in the API on how many results you can request for a given query, even with paging. However, you can use the combination of sort=-date_received and date_received_range_to=yyyy-mm-dd to create an unlimited batching system that will let you page through as many results as you need. Be careful not to leave gaps in your date range when paging, and remember your batches may overlap slightly so you will need to de-duplicate the results (you can use _id for this).

For a basic example of how to do this, see, although you stil need to write the code to check for duplicates. Here is the main loop in that code:

results = []
earliest_date = ('2017', '2', '19')
for ii in range(3): 
    # get a batch of results that have a slightly earlier date_received than the previous batch
    print "getting 100 before date", earliest_date, "len(results)=", len(results)
    results += getRecords(API_KEY, date_to=earliest_date)
    earliest_date = results[-1]['date_received']
    earliest_date = (earliest_date[0:4], earliest_date[5:7],earliest_date[8:10])

Note that if there happen to be more than 100 results on a single day you will keep getting the same value for earliest_date and thus the same batch of results each time from that point onwards. If you can't work out how to get around this problem let us know.

Viewing data in a table using Google Drive spreadsheets

If you are comfortable working with spreadsheets, but not programming this may be of interest to you. (Although only very basic functionality is currently provided in the script below, so you may need to ask someone to flesh it out a little if you are uncomfortable programming yourself).

screenshot of demo

Create a new spreadsheet in Google Drive. In the menu, go to Tools > Script editor.... Then paste in the following code, supplying you private API key in the location indicated, and press save:

function getPlanningApplications(lat, lng) {
  var data = UrlFetchApp.fetch('' + lng + '%2C' + lat + '/',
                               {headers: {'X-Api-Key': 'YOUR_API_KEY_HERE'}}).getContentText();
  var locations = JSON.parse(data).map(function(x){
    return [x.location.coordinates[1], x.location.coordinates[0], x.num_dwellings];
  return [["lat", "lng", "num_dwellings"]].concat(locations);

Next, go back to the spreadsheet itself, and type the following in one of the cells:

=ArrayFormula(getPlanningApplications(51.5912874, -0.1080216))