Open Charge Map (OCM)

About the project

Open Charge Map is the global public registry of electric vehicle charging locations. OCM was first established in 2011 and aims to crowdsource a high quality, well maintained open data set with the greatest breadth possible. Our data set is a mixture of manually entered information and imported open data sources (such as government-run registries and charging networks with an open data license). OCM provides data to drivers (via hundreds of apps and sites), as well to researchers, EV market analysts, and government policy makers.

The code in this repository represents the backend systems (API, Web Site and server-side import processing) for the project. Server-side code is developed mostly in C#, currently building under Visual Studio 2017 Community Edition with .Net 4.5. Data is stored in SQL Server with an additional caching layer using MongoDB.

Developers can use our API to access the data set and build their own apps. The app source can be found in its own repo at https://github.com/openchargemap/ocm-app

Basic build prerequisites

• Windows 7 or higher (or Windows Server 2008 or higher)
• Visual Studio 2015 Professional or the equivalent express editions (Web, Windows) with the latest NuGet package manager installed and latest TypeScript add-in installed
• MS SQL Express 2008 R2 onwards
• NodeJS
• MongoDB

Note: it is possible to most of the /App development on non-windows machines without Visual Studio however it is not officially supported.

Deployment

• Configure MongoDB as services and initialise ocm_mirror database
• Set ASP.net State Services to Automatic Startup and Start services
• Install SQL Server 2012 CLR Data Types (Version 11.x) - required by entity framework
• Install URL Reqwrite 2.0 - required for handler mapping
• Enable read/write for app pool user for \Temp folders
• Configure web.config

Contributing

Please contribute in any way you can:

• Improve the data (anyone can do this):
  • Submit comments, checkins, and photos via the website
  • Submit new data, become an editor for your country
• Grow the user base
  • Advocacy, tell people about Open Charge Map and help them use it.
• Get involved: Discussion Forum
• Improve the system:
  • Help translate the system into other languages using the webtranslateit project
  • Help write documentation
  • Web App (HTML/CSS/JavaScript)
  • Website development (MVC)
  • Map widget for embedding
  • Sample Code for developers
  • Graphic Design
  • Testing