🌿 Welcome to sarj.dev! This open-source project provides a back-end solution for an interactive map application focused on Electric Vehicle (EV) charging stations across Turkey. Developed using Java, the Spring Framework, and Elasticsearch, this project empowers EV owners to find, track, and plan their charging needs seamlessly.
sarj.dev aims to enhance the electric vehicle charging experience in Turkey by offering a comprehensive map application that includes real-time charging station data, search functionalities, and nearby station recommendations.
- 🗺️ Interactive Map: Visualize electric vehicle charging stations on an interactive map.
- ⚡ Real-time Data: Access up-to-date information about each charging station, including socket availability, power capacity, and pricing details.
- 🔍 Advanced Search: Utilize the search feature to find charging stations based on specific criteria.
- 📍 Nearby Stations: Get a list of charging stations near your location for convenient access.
- 🔗 Search Suggestions: Receive search suggestions for quicker station discovery.
- Java 17 or higher
- Spring Framework (e.g., Spring Boot)
- Elasticsearch
- Docker (for containerization)
- Clone the project:
git clone https://github.com/sarjdev/back-end.git - Install required dependencies using your preferred build tool (Maven).
- Configure Elasticsearch: (see
compose file) - Start the application: Run
mvn spring-boot:runin the project root.
To run the application using Docker Compose, follow these steps:
- Install Docker on your machine.
- In the project root, make sure you have a
docker-compose.ymlfile. - Run
docker-compose upto start the application and Elasticsearch.
- Once the application is up and running, access it through your browser at
http://localhost:8080or your custom domain. - Explore the map to view charging stations. Click on a station to reveal more information.
- Use the search bar to filter stations based on specific attributes.
- To view nearby charging stations, you might need to grant location permission.
- Create a new branch for your feature:
git checkout -b feature/your-feature - Make your changes and stage them using
git add. - Commit your changes with a meaningful message:
git commit -m "Add your message here". - Push your branch to your forked repository:
git push origin feature/your-feature. - Create a pull request in the original repository and await review.
This project is licensed under the GNU General Public License v3.0
We would like to express our gratitude to the contributors of this project and the open-source community for their valuable contributions and support.
For questions, suggestions, or collaborations, please contact us at hi@sarj.dev or visit our website at https://sarj.dev.
🚀 Let's contribute to a greener future together! 🌍