Mapwise is a web application that enables users to search for nearby places using their voice. Simply press a button, speak your query (e.g., "Find coffee shops open now"), and let the app handle the rest!
- Voice Query: Press a button and speak your request.
- Speech-to-Text: Converts your spoken query to text using OpenAI APIs.
- Intent Extraction: Uses OpenAI APIs to understand the intent of your query.
- Nearby Search: Finds relevant places nearby using the Google Maps API.
- Text-to-Speech: Speaks the result back to you for a hands-free experience.
- User Interaction: Press the button and speak your query.
- Transcription: The app uses OpenAI's transcription API to convert speech to text.
- Intent Detection: The transcribed text is sent to OpenAI for intent extraction.
- Place Search: The app queries the Google Maps API to find and present relevant nearby places.
- Result Feedback: The app uses text-to-speech to read the result back to the user.
- Node.js & npm installed (install with nvm)
- OpenAI API Key (for transcription and intent extraction)
- Google Maps API Key (for place search)
Follow these steps:
# Step 1: Clone the repository using the project's Git URL.
git clone <YOUR_GIT_URL>
# Step 2: Navigate to the project directory.
cd <YOUR_PROJECT_NAME>
# Step 3: Install the necessary dependencies.
npm i
# Step 4: Start the development server with auto-reloading and an instant preview.
npm run devConfigure your API keys as needed (see .env.example or configuration section).
- Press the microphone button and speak your query.
- Wait for the app to process and present the results.
- Listen as the app reads the results back to you.
MIT
.env.example
VITE_GOOGLE_MAPS_API_KEY=YOUR_API_KEY_HERE
Powered by OpenAI and Google Maps APIs.