https://github.com/vagnervjs/voice-navigation
🎙️ Navigate Google Maps Street View with voice commands - hands-free exploration using modern JavaScript
https://github.com/vagnervjs/voice-navigation
accessibility es6 google-maps hands-free street-view voice-control voice-navigation web-speech-api
Last synced: 6 months ago
JSON representation
🎙️ Navigate Google Maps Street View with voice commands - hands-free exploration using modern JavaScript
- Host: GitHub
- URL: https://github.com/vagnervjs/voice-navigation
- Owner: vagnervjs
- Created: 2014-06-05T01:40:50.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2025-06-07T23:12:00.000Z (7 months ago)
- Last Synced: 2025-07-03T08:43:07.806Z (6 months ago)
- Topics: accessibility, es6, google-maps, hands-free, street-view, voice-control, voice-navigation, web-speech-api
- Language: JavaScript
- Homepage: http://vagnervjs.github.io/voice-navigation/
- Size: 6.02 MB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎙️ Voice Navigation
Modern, hands-free Google Maps navigation app
> **Navigate Google Maps Street View using voice commands and keyboard controls**
A modern, feature-rich voice navigation application that combines the power of the **Web Speech API** with **Google Maps Street View** for an intuitive navigation experience. Built with modern JavaScript ES6+ modules and a clean, responsive UI.
## ✨ Features
### 🎤 **Voice Recognition**
- **Natural language commands** - "Go forward", "Turn left", "Look up"
- **Compass directions** - "North", "South", "East", "West"
- **Confidence threshold** - 60% accuracy for reliable recognition
- **Real-time feedback** - Live confidence percentages displayed
### 🗺️ **Map Controls**
- **Street View integration** - Navigate through Google Street View
- **Search functionality** - Find any location by address
- **Fast mode toggle** - 5x movement speed multiplier
- **Smooth movement** - Fluid position and view transitions
### 🎯 **User Interface**
- **Modern dark theme** - Clean, professional design
- **Responsive layout** - Optimized for all screen sizes
- **Categorized logging** - Filter by system, maps, voice, search, location, errors
- **Real-time feedback** - Live activity monitoring with icons
### ⌨️ **Keyboard Controls**
- **Voice shortcuts** - `S` to start, `E` to end recognition
- **Movement keys** - Arrow keys for navigation
- **Advanced controls** - `H/J` for left/right, `N/M` for look up/down
## 🚀 Quick Start
### Prerequisites
- **Node.js** (v16+ recommended)
- **Google Maps API Key** with Maps JavaScript API and Geocoding API enabled
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/vagnervjs/voice-navigation.git
cd voice-navigation
```
2. **Install dependencies**
```bash
npm install
```
3. **Set up environment variables**
```bash
cp .env.example .env
# Edit .env and add your Google Maps API key
```
4. **Start the development server**
```bash
npm run dev
```
5. **Open your browser**
- Navigate to `http://localhost:3000`
- Allow microphone and location access when prompted
- Start navigating with voice commands!
## 🔐 Browser Permissions
This application requires **two critical permissions** to function properly:
### 🎤 **Microphone Access**
- **Required for**: Voice recognition commands
- **When prompted**: Click "Allow" when browser asks for microphone access
- **Troubleshooting**:
- Check browser address bar for microphone icon
- Go to browser settings → Privacy & Security → Microphone
- Ensure `localhost:3000` is allowed
### 📍 **Location Access**
- **Required for**: Getting your current position as starting point
- **When prompted**: Click "Allow" when browser asks for location access
- **What it does**: Centers the map on your current location for better navigation
- **Troubleshooting**:
- Check browser address bar for location icon
- Go to browser settings → Privacy & Security → Location
- Ensure `localhost:3000` is allowed
- **Note**: App will still work without location access, but you'll need to search for a starting location
### 🔧 **Permission Management**
**Chrome/Edge:**
1. Click the lock icon in the address bar
2. Set Microphone and Location to "Allow"
3. Refresh the page
**Firefox:**
1. Click the shield icon in the address bar
2. Enable microphone and location permissions
3. Refresh the page
**Safari:**
1. Go to Safari → Settings → Websites
2. Select Camera/Microphone and Location Services
3. Set permissions for `localhost`