Skip to content

alphagov/places-manager

Folders and files

NameName
Last commit message
Last commit date
Jul 19, 2024
Sep 9, 2024
Nov 21, 2023
Oct 30, 2024
Mar 11, 2024
Apr 17, 2024
Apr 16, 2024
Apr 30, 2024
Dec 29, 2017
Oct 29, 2015
Apr 3, 2020
Sep 9, 2024
Aug 28, 2014
Jan 15, 2023
Mar 6, 2024
Mar 25, 2024
Apr 30, 2024
Nov 10, 2021
May 16, 2024
Jun 17, 2024
Dec 11, 2024
Jan 28, 2025
May 24, 2016
Oct 16, 2014
Apr 17, 2024
Apr 30, 2024
Apr 17, 2024
Mar 25, 2024

Repository files navigation

Places Manager (formerly Imminence)

Places Manager manages sets of structured data for use elsewhere on GOV.UK. It's primarily used for geographical data such as lists of registry offices, test centres, and the like.

The data is structured as a set of Services which represent a distinct type of location. A Service can then have many Data Sets which are in turn collections of Places. Only one Data Set will be "active" at any given time.

Each data set is uploaded as a CSV file. A cron job takes care of geocoding the places within it. It can then be manually inspected or exported as CSV, JSON or KML so it can be tested using a variety of other tools.

There is a simple JSON API for integrating the data with other applications.

Nomenclature

  • Services: Represent a distinct type of location (e.g. Register Offices)
  • Data sets: Services can have many data sets, which are collections of Places. Only one data set will be "active" at any given time.
  • Places: Geocoded data of individual locations which belong to a data set.

Technical documentation

This is a Ruby on Rails app, and should follow our Rails app conventions.

You can use the GOV.UK Docker environment to run the application and its tests with all the necessary dependencies. Follow the usage instructions to get started.

Use GOV.UK Docker to run any commands that follow.

Running the test suite

bundle exec rake

Licence

MIT License

Further documentation