Welcome to bestMove! This is an advanced React-based web application that helps users find their ideal home or apartment by leveraging isochrones and a variety of filters. With bestMove, you can search for properties within a specific travel time from a point of interest, apply price and area filters, and even upload your own datasets to work with. 🗺️
- Isochrones Search ⏱️: Filter properties based on travel time from any point of interest using MapBox and GeoApify APIs.
- Property Filters 🏡💰: Refine your search with price and area filters to find the perfect match.
- Custom Datasets 📊: Upload your own dataset of houses or apartments with geo-locations and filter them using the app’s powerful tools.
- Interactive Map 🌍: Visualize properties and isochrones directly on the map.
In this example, you can see houses highlighted that are within the intersection of two isochrones: one with a 15-minute travel time from a "Bank" (marked in orange 🟧) and another with a 20-minute travel time from "OPEC" (marked in purple 🟪). This makes it easier to find properties that are conveniently located between these key points of interest.
Check out a video tutorial demonstrating the usage of the app on YouTube: bestMove Tutorial.
Follow these steps to set up bestMove on your local machine:
-
Clone the repository:
git clone https://github.com/your-username/bestMove.git cd bestMove -
Install dependencies:
yarn install
-
Create a
.envfile in the root directory of the project and add your MapBox and GeoApify API keys:VITE_MAPBOX_API_KEY=your_mapbox_api_key VITE_GEOAPIFY_API_KEY=your_geoapify_api_key -
Run the development server:
yarn dev
-
Open your browser and navigate to
http://localhost:5173to start using bestMove.
- Select a Point of Interest (POI): Choose a location on the map to center your search.
- Adjust Isochrones: Define the travel time radius around your POI to filter properties.
- Apply Filters: Use the price and area sliders to refine your search results.
- Upload a Dataset: If you have your own list of properties, upload it in CSV format with geo-location data to work with your data.
- View Results: Properties matching your criteria will be displayed on the map.
For a step-by-step guide on how to use bestMove, please refer to the tutorial video.
The app comes with preloaded datasets dated July 2024. By default, the map is centered on Vienna, the beautiful city where bestMove was developed! 🏙️
We welcome contributions to bestMove! If you have any ideas, feel free to submit a pull request or open an issue.
This project is licensed under the MIT License. See the LICENSE file for more details.
We hope you find bestMove helpful in your search for the perfect home or apartment! 🏡 If you have any questions or feedback, don't hesitate to reach out. Happy house hunting! 🛋️🔑