Skip to content
"Find My Nearest" API and management tools on GOV.UK
Ruby HTML Gherkin Other
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.bundle
app
bin
config
db
doc
features
lib
log
public
script
test
vendor/plugins
.gitignore
.rubocop.yml
.ruby-version
CONTRIBUTING.md
Gemfile
Gemfile.lock
Jenkinsfile
LICENCE
Procfile
README.md
Rakefile
config.ru
startup.sh

README.md

Imminence

Imminence manages sets of (somewhat) 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)
  • Datasets: Services can have many datasets, 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 Dataset.

Technical documentation

Imminence is a Ruby on Rails application backed by a MongoDB database.

Dependencies

Running the application

From within the app root directory:

./startup.sh

Note that you will have to have GOV.UK Mapit running locally.

In the GOV.UK DEV VM from the 'development' directory:

bowl imminence

Note that the app uses a local version of GOV.UK Mapit, therefore a valid dataset will have to be loaded for Mapit, otherwise postcode lookups will not succeed. This is part of the standard GOV.UK data replication steps.

Running the test suite

bundle exec rake

bundle exec govuk-lint-ruby app test lib

Licence

MIT License

You can’t perform that action at this time.