UK Election Map – Voting Distribution


Generate a map of the UK showing the general election voting distribution of 2005, 2010 and 2015. Existing election result maps did not really show the subtlety in voting, this is due to the first-past-the-post voting system (winner-takes-all).


2005 - 2010 - 2015 UKElectionMap_votes


Now published on Wikipedia UK_General_Election_2010#Voting_distribution_per_constituency and UK General_Election_2015#Voting_distribution_per_constituency

The Plan

  1. Gather election data (number of votes per constituency per party & turnout percentage)
  2. Produce textures
    – One per constituency
    – Number of pixels per party (pixel colour) proportional to vote count
  3. Find a programmatically usable map of the UK and its constituencies
  4. Link constituencies in the data to the constituencies on the map
  5. Alter map to apply this custom texture per constituency

Java Program

I spent a good while trying to ‘debug’ missing data for one constituency in Northern Ireland, which turned out to be a lake (Lough Neagh)

The program does the following (see below for the source);

  • Read in a map of the UK in SVG format
  • For each election year
    • Read in election data
    • Look up party colours (no vote = BLACK)
    • For each constituency
      • Calculate a voting distribution
      • Generate a ‘voting distribution’ image
    • Link the constituencies in the image map with the generated images
    • Write the updated SVG file



Year Source
2005 Electoral Commission – Electoral Data
2010 Electoral Commission – Electoral Data
2015 Electoral Commission – Electoral Data (Currently provisional data – final data to be published in July)
2015 Guardian – Election Live Results


I used these Creative Commons images from Wikipedia as a base. The image format is SVG, which is an XML formatted vector graphics image. This allows for programatic access to the image description data.

2015 UK Election Map
2005 UK Election Map – Results by Constituency
2015 UK Election Map
2015 UK Election Map – Results by Constituency

Read in and Writing to a Map of the UK in SVG

As the SVG image format is XML, we can use the standard XML tools in Java, in this case DOM + XPath.


Adding an XML Namespace

Processing Excel Spreadsheet

Add Apache POIthe Java API for Microsoft Documents – to the Maven pom.xml:

Screenshot of the election data spreadsheet format

Example using Apache POI to iterate over the first cell of each row

 2005 UK General Election

A number of constituency changes were made before 2010 – meaning that not all 2005 data could be applied to the 2015 UK constituency map. The 2005 UK constituency map did not have the required meta data to link the data to the SVG image, so I included a lookup file using the table data on the 2005 UK constituency map page.


Pixels represent the party colour and appear in frequency proportional to the votes.



Map Image source code in GIT

Main class: com.knocksfornometer.mapimage.Main

Input Files: src\main\resources

Output Files: target\map

Java 8

Convert map key and output result to separate map.

 JSON property file as String lookup map

I wanted to use some JSON as property files and looked for a Java JSON library.  Gson turned out to be a joy to work with!

Add to Maven pom.xml:

Source JSON:

Load String to String Map from a JSON file:

I also used it to parse the data from the Guardian website. You create a plain Java object (POJO) with a default constructor, that represents the data. In this case I had to specify a date format, as the source JSON used a format different from the default.

If a JSON field name starts with a number (invalid for Java fields), you can add an annotation to link the fields, like: