PlacesFinder is a powerful application that allows users to search for interesting places in their vicinity. Whether you're looking for restaurants, parks, museums, or any other type of place, PlacesFinder has got you covered.
- Search: Easily search for places based on keywords, categories, or specific locations.
- Filters: Refine your search results by applying transportation filters such as bycicling, walking, public transportation, ...
- Map View: Visualize the search results on an interactive map, making it easier to locate and explore nearby places.
- Detailed Information: Get detailed information about each place, including photos, reviews, contact details, and opening hours.
- Navigation: Get directions to a place using integrated navigation services.
To get started with PlacesFinder, follow these steps:
- Clone the repository:
$ git clone https://github.com/your-username/PlacesFinder.git
- Install the required dependencies:
$ npm install
- Configure the API keys: Open the
config.js
file and replace the placeholder API keys with your own keys. - Start the application:
$ npm start
- Access the application in your browser at
http://localhost:3000
.
The Google API key is required to access the Google Maps and Places APIs, which are used by the application to display maps, search for places, and retrieve detailed information about those places.
Here are the steps to obtain a Google API key and replace it in the index.html script:
- Go to the Google Cloud Console.
- Create a new project or select an existing project.
- Enable the necessary APIs: Google Maps JavaScript API and Google Places API.
- Go to the "Credentials" section in the left sidebar.
- Click on the "Create Credentials" button and select "API key".
- Copy the generated API key.
- Open the
index.html
file in your code editor. - Look for the following line of code:
<script src="https://maps.googleapis.com/maps/api/js?key=KEY&libraries=places"></script>
- Replace the KEY placeholder with your own API key.
Once you have replaced the KEY
variable with your Google API key, the PlacesFinder application will be able to communicate with the Google Maps and Places APIs, allowing you to search for places, view maps, and access detailed information about those places.
If you'd like to contribute to PlacesFinder, please follow these guidelines:
- Fork the repository.
- Create a new branch:
$ git checkout -b feature/your-feature-name
- Make your changes and commit them:
$ git commit -am 'Add some feature'
- Push to the branch:
$ git push origin feature/your-feature-name
- Submit a pull request.
PlacesFinder is released under the MIT License. See the LICENSE file for more details.
If you have any questions or suggestions, feel free to reach out to us at Kjell.vandenbossche@student.hogent.be.
Happy exploring with PlacesFinder!