Guidance for Contributors
Introduction
Note: this guidance is a working draft for comment and is not final. [Last Updated: Jan 12 2015]
The aim of the Open Charge Map project is to provide a reliable and well respected Open Data set for EV charging equipment locations globally. Data in OCM comes from two types of source: User Contributions and 3rd Party Data Imports. We rely on our contributors to do their best to provide quality information when manually providing and improving information.
This guidance exists to describe both optional and mandatory practises when contributing information to us.
Guidance For All Contributors
Acceptance of Terms
All information you submit (including charging equipment information, comments, check-ins and photos) to Open Charge Map is held by us and redistributed under an Open Data license. By submitting any information to us you are agreeing to these terms.
Contributing Comments, Check-In and Photos
Adding a Check-In, Comment (which is the same as a Check-In but with your own comment) or Photo can make a huge difference to other people who find a charging location using Open Charge Map data, especially if your comment can help them plan their journey or avoid problems. Using this feature you can provide useful information to others:
- If the location is difficult to access.
- If the equipment is in good working order.
- What the parking spot looks like.
- If the spot is regularly occupied (whether by EV's or other cars).
- If their is a fault, you can report it - if we know the Operators contact details they will be emailed the fault report.
Submitting New Locations
- Ensure the location is not a duplicate of an existing listing.
- Ensure the location is not a private residence (home). OCM does not accept information related to private individuals because we cannot provide the data protection required by law in many countries. This is because our data is widely redistributed.
- Provide as much detail as possible without being verbose or opinionated - you can leave additional comments and photos etc once you have submitted the location.
-
Follow your country/regional standards for Address information e.g.:
- In the UK postcodes are uppercase and separated into two components.
- In Australia the suburb is all uppercase.
Submitting Edits
You can edit the details of any location whether you are a normal user or a country editor.>
You should aim to make each listing as complete as possible. If a listing is sourced automatically you should consider whether you can notify the source of the information about required changes so that all other consumers of that information can be notified. Where this is not possible/practical you can edit the listing on Open Charge Map however future imports will no longer be automatically updated for that location.
Removing Information
You should not remove information (equipment details, power specifications etc) if you cannot verify the accuracy of the information unless the original information does not make logical sense. Only information you know to be incorrect should be changed.
Country Editor
If you have made a significant number of good submissions we may promote your account to Country Editor for the countries you are most active in. Country Editors can make changes which don't require further approval and they can approve changes submitted by other users.
It is the responsibility of each country editor to ensure that submissions they approve are of a reasonable quality, do not introduce duplication and do not appear to be private residences (homes).
It is not the responsibility of the country editor to validate that the equipment exists, this information can instead be provided by all users in the form of comments or edits using the app or website.
It is the responsibility of all country editors to ensure they are following the latest guidance for their role (as presented and updated here). Failing to reasonably follow this guidance may result in the Country Editor role being removed from your account.
Resolving Duplicates
If you identify a duplicate listing you should resolve the duplicate as follows:
If comments or photos are present on one listing but not on the other then the listing with comments/photos is automatically the best one to keep (because it has user contributed information, unless the comment is 'this is a duplicate'). In this situation you should compare the information for the two listings and improve the listing with comments/photos as required, then delist the other location.
If both listings are virtually identical with no comment/photos or other distinguishing features then you should delist the newest entry (with the highest OCM-ID reference).
New Locations Awaiting Approval
The easiest way to review the locations awaiting approval is via the New Locations Awaiting Approval page. From there an editor can look at the details of the individual location, inspect the quality of the submission and approve it.
The Edit Queue
The Edit Queue is where changes to existing locations await approval by an editor for the relevant country. The edit queue can show both new locations and edits to existing locations but is best suited to managing edits.
3rd Party Data Imports
Many government agencies and industry groups around the world provide EV charging location information as Open Data. These data sets can contain thousands of entries and are often a great source of additional information for the OCM data set.
Where an import process has been created for OCM we periodically import from each data source, adding new locations and updating existing ones. If you wish to change one of these listings, they can do so using the normal Edit function.
When you edit a location from a 3rd Party Data Import the following process is followed:
- The old listing is archived for future reference as a superceded POI.
- We link the old POI with your new version in the OCM database.
- From then on users only see the edited OCM version of the listing.
- Subsequent data imports are ignored for that location. This means that improvements made by the 3rd Party will not be seen in the OCM listing and will need to be applied manually.