New filters added to public retrieve API

by · April 1, 2016

cogs-process

The NCR offers a public API which enables end users to automate retrieval of the registry. API request can be filtered according to data types to allow retrieval of sub-sets of the NCR database.

Until now, API filters included the following parameters: network (using relevant network id), country (based on country code), postcode (full or partial), lat-long (geocode), distance (from centre of postcode or lat-long coordinate), limit (number of devices returned), and units (miles or km).

Examples of filters API calls include the following:

The 10 closest devices to your postcode: http://chargepoints.dft.gov.uk/api/retrieve/registry/postcode/EC3A+7BR/limit/10/

All the devices within a 10 mile radius of your position: http://chargepoints.dft.gov.uk/api/retrieve/registry/lat/51.545581/long/-0.077301/dist/10/

All the connector types in CSV format:
http://chargepoints.dft.gov.uk/api/retrieve/type/format/csv/

The NCR has now extended the rage of API filters available which now also include: post-town/city (by name), device id (using full encrypted id), connector type (using connector id), and device power rating (kW).

Below are examples of these API calls in action:

Records based on post town using the post-town parameter: http://chargepoints.dft.gov.uk/api/retrieve/registry/format/json/post-town/bristol

Record based on its unique device id using the device-id parameter: http://chargepoints.dft.gov.uk/api/retrieve/registry/format/json/device-id/a999c0cab150490ffefb7ce9ec889830

Return records based on the connector type using the connector-type-id parameter: http://chargepoints.dft.gov.uk/api/retrieve/registry/format/connector-type-id/4

Return records based on the rated output in kWs using the rated-output-kw parameter: http://chargepoints.dft.gov.uk/api/retrieve/registry/format/json/rated-output-kw/3.7

Fo connector type calls, the following connector type ids are available:

Id - Connector Type
3 - 3-pin Type G (BS1363)
4 - JEVS G105 (CHAdeMO) DC
5 - Type 1 SAEJ1772 (IEC 62196)
6 - Type 2 Mennekes (IEC62196)
7 - Type 3 Scame (IEC62196)
15 - Type 2 Combo (IEC62196) DC
16 - Type 2 Tesla (IEC62196) DC
17 - Commando 2P+E (IEC60309)
18 - Commando 3P+N+E (IEC60309)

Detailed information about the existing and new API filters will shortly be added to existing API documentation found at: http://chargepoints.dft.gov.uk/api/help

For more information about the issues raised at the workshop, contact the NCR by phone on 0300 777 0001 or email [email protected].

About the NCR

The National Chargepoint Registry (NCR) was established by the UK Government in 2011 to provide a public database of publicly-funded chargepoints across the UK in support of the Government’s objective to promote the use and sales of Ultra Low Emission vehicles (ULEVs). Operators or owners of any publicly accessible chargepoint may register their data.

The NCR is a registry of UK chargepoints, rather than a mapping service. However, one of the objectives of the NCR is to provide data to third parties, some of whom will present the database in a map format.

This web front-end is operated for OLEV by Cenex.

Third party applications

Mapping tools/apps based on NCR data include:
HERE Technologies to build EV services & products; ecarNI which shows points in N. Ireland; Greener Scotland which shows Scottish EV chargers; PlugSurfing, an app which allows covers the EU; Open Charge Map, which shows charge points in the UK & globally; mevCharge.com a route planner for EVs; Mitsubishi Motors which allows UK users to find Mitsubishi compatible points; The New Motion, that provides apps with search, filters & status notifications; MyRouteMonkey with battery aware route planning; & Zap-Map which displays chargepoint locations with user search functionality.

Access the data

The NCR database containing key information regarding the UK’s public chargepoint network is freely available to end users in XML, CSV, and JSON formats. An API is also available for developers to automatically download from NCR & import the dataset for their third party applications.

To download the latest version of the NCR database users are directed to the official Government data portal at: data.gov.uk/dataset/national-charge-point-registry. The database is regularly updated. The links to the NCR database on the Government data portal were setup in 2012, which is why that date is referenced. Data is provided free under the Open Government Licence. No registration is required for this service.

Download NCR from data.gov.uk

Uploading to the NCR

Network owners and operators are able to upload chargepoint information to the NCR either via a web portal, or using CSV files, on a periodic basis.

Organisations wanting to upload data should first register with the National Chargepoint Registry.

For more info, email [email protected] or call the NCR Helpline on 0300 7778800.

NCR upload portal at dft.gov.uk