/LocaleXplorer

Explore local gems effortlessly with LocaleXplorer's enriched marketplace, nearby search, and category-based searches. Real-time info, user reviews, and exclusive offers create a personalized connection to your community.

Primary LanguageMakefileMIT LicenseMIT

LocaleXplorer - Transforming Local Exploration

LocaleXplorer is an innovative mobile application designed to empower users to explore and discover local businesses, restaurants, and points of interest. Developed as part of a hackathon, #Techfest_IITB LocaleXplorer seamlessly integrates advanced technologies, including HERE Places API and SDKs, to provide users with a rich and enhanced experience and offers an enriched marketplace, nearby search functionality, and category-based searches.

Table of Contents

About

What is LocaleXplorer?

LocaleXplorer is a mobile application designed to revolutionize the way users explore and discover local businesses, restaurants, and points of interest. Developed with a focus on user convenience, it leverages advanced technologies such as the HERE Places API and SDKs to provide a seamless and enriched exploration experience.

LocaleXplorer acts as a bridge between users and local businesses, offering real-time information, user ratings, reviews, and exclusive special offers. With the new features, users can now access an enriched marketplace, perform nearby searches, and explore businesses based on specific categories.

How LocaleXplorer Benefits Users and Businesses?

  • Explore Local Businesses:
    • Users can effortlessly explore a variety of local businesses, ranging from restaurants to retail stores, and discover new places of interest in their vicinity.
  • Real-Time Information:
    • Get up-to-date information on business hours, contact details, and working days amd review's and many more.
  • User Ratings and Reviews:
    • Make informed decisions by accessing user ratings and reviews, providing valuable insights into the quality of local businesses.
  • Exclusive Special Offers:
    • Enjoy exclusive special offers from local businesses, creating a win-win situation for both users and establishments.
  • Nearby Search Functionality:
    • Find businesses and points of interest in your vicinity with the new nearby search feature, providing a convenient way to discover local gems.
  • Support Local Businesses:
    • LocaleXplorer promotes and supports local businesses by connecting them with a broader audience, boosting their visibility in the community.

Features

  • Enriched Marketplace:
    • Users can explore an enriched marketplace with detailed information about businesses, including Working hour's , days , distance and etc .
  • Nearby Search Functionality:
    • Find businesses and points of interest in your vicinity with the nearby search (setting the radius to explore) , providing a convenient way to discover local gems.
  • Category-Based Searches:
    • Explore businesses based on specific categories such as restaurants, cafes, grocery stores, and more, streamlining the search process.
  • Interactive and Responsive Design :
    • Offer's the Interactive and responsive user friendly interface across various devices
  • Detailed Information :
    • Contains the Comprehensive and detailed information about the Market place
  • Real-time :
    • LocalXplorer uses the feature rich Here api and get updated Realtime to provide the fast and accurate information
  • Category-Based Searches:
    • The nearby search functionality and category-based searches enable the user to discover the marketplace of point of interest easier
  • User Ratings and Reviews:
    • Make informed decisions by accessing user ratings and reviews and get the valuable insights into the quality of local businesses.

Technologies Used

Technology used

  • Python (Backend)
  • Flutter (Frontend)
  • Server side
    • Flask
    • Amazon AWS
  • API and SDKs
    • Here
      • browse
      • geocode
      • revgeocode
      • search
    • Rapid api (Local market place)

How LocaleXplorer Work's ?

LocalXplorer operates through a combination of cutting-edge technologies and seamless integration, offering users an immersive exploration experience. Here's a breakdown of how LocalXplorer works:

  • HERE Places API Integration:

    • LocalXplorer taps into the HERE Places API to fetch precise and reliable data about local businesses. This ensures that users receive up-to-date and accurate information.
  • Responsive Flutter Interface:

    • The frontend of LocalXplorer is built with Flutter, providing users with a responsive and interactive interface. This framework enhances the overall exploration experience.
  • Real-Time Updates:

    • Users enjoy real-time updates on business details, guaranteeing that the information presented is consistently current. This feature enhances the reliability of the data.
  • Enriched Marketplace:

    • LocalXplorer's enriched marketplace feature offers detailed insights into various businesses, providing users with a comprehensive understanding of local establishments.
  • Nearby and Category-Based Searches:

    • The app facilitates nearby searches and category-based searches, enhancing the overall search experience. By utilizing the HERE API and creating an intermediate API, LocalXplorer accurately identifies the user's geo-location, allowing for precise searches and information retrieval.
  • Secure Hosting on AWS:

    • LocalXplorer is securely hosted on Amazon Web Services (AWS), ensuring a reliable infrastructure. This robust hosting solution enhances the app's performance, providing users with a seamless and dependable experience.
  • Intermediate API for Seamless Integration:

    • LocalXplorer employs an intermediate API, bridging the gap between the user interface and the API's. This strategic use of an intermediate API streamlines data retrieval, making the integration process smoother and more efficient. for getting the user reviwes we used the rapid Api

In summary, LocalXplorer combines powerful API integration, a responsive interface, real-time updates, and enriched marketplace features to deliver a seamless and informative exploration platform for local businesses, restaurants, and points of interest. Users can access ratings, reviews, business hours, special offers, and photos in real-time

Getting Started

Prerequisites

Before using LocaleXplorer, ensure you have the following prerequisites:

  • Python installed on your computer (for backend development).
  • Flutter installed for mobile app development.
  • Access to API and SDKs.

Installation

  1. Clone the Repository:

    git clone https://github.com/Darshan-hegde04/LocaleXplorer
  2. Navigate to the Project Directory:

    cd LocaleXplorer
  3. Backend Setup:

    • Set up and activate a virtual environment.
    • Install required Python packages using pip install -r requirements.txt.
  4. Flutter Setup:

    • Navigate to the Flutter project directory.
    • Run flutter pub get to install dependencies.
  5. API Integration:

    • Obtain API keys .
    • Configure API keys in the project.

How to Use

  1. Launch LocaleXplorer:

    • Start the backend server using Python.
    • Launch the Flutter app on your mobile device or emulator.
  2. Explore Local Businesses:

    • Browse through different categories of local businesses.
    • View detailed information about each business, including images, menus, and additional services.
  3. Nearby Search:

    • Utilize the nearby search functionality to discover businesses and points of interest in your vicinity.
  4. Category-Based Searches:

    • Explore businesses based on specific categories such as restaurants, cafes, grocery stores, and more.
  5. Real-Time Information:

    • Access real-time information on business hours, contact details, and working days.
  6. Comprehensive and Detailed information :

    • Access the comprehensive and detailed information about the market place and enhance your local market discovery
  7. Exclusive Special Offers:

    • Enjoy exclusive special offers and discounts from local establishments .
  8. Support Local Businesses:

    • LocaleXplorer connects users with local businesses, supporting the growth of the community.

Prepared by

LocaleXplorer is proudly prepared by team HackZilla :

  • Darshan Hegde : - GitHub - LinkedIn

  • Akshay Kumar : - GitHub - LinkedIn

  • K S Prateek : - GitHub - LinkedIn

  • Kedar Bhagat : - GitHub - LinkedIn

Screenshots

Homepage cafe