{"id":30174068,"url":"https://github.com/web-dev-nav/route-optimizer","last_synced_at":"2025-08-12T00:15:27.442Z","repository":{"id":305078711,"uuid":"1021858398","full_name":"web-dev-nav/Route-Optimizer","owner":"web-dev-nav","description":"A web-based route optimization tool designed for service professionals, delivery personnel, and field technicians to efficiently plan their daily routes across Canada.","archived":false,"fork":false,"pushed_at":"2025-07-18T04:27:00.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-18T08:03:10.735Z","etag":null,"topics":["canadian-addresses","cost-reduction","delivery-management","delivery-route-planner","field-service","fuel-efficient","google-maps-api","gps-location","html5","logistics","parcel-delivery","productivity-tools","route-optimization","service-technician","tailwindcss","time-saving"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/web-dev-nav.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-18T04:13:19.000Z","updated_at":"2025-07-18T04:27:04.000Z","dependencies_parsed_at":"2025-07-18T08:03:17.989Z","dependency_job_id":"815f01a1-e806-49b7-887d-0d5e65464e62","html_url":"https://github.com/web-dev-nav/Route-Optimizer","commit_stats":null,"previous_names":["web-dev-nav/route-optimizer"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/web-dev-nav/Route-Optimizer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2FRoute-Optimizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2FRoute-Optimizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2FRoute-Optimizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2FRoute-Optimizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/web-dev-nav","download_url":"https://codeload.github.com/web-dev-nav/Route-Optimizer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web-dev-nav%2FRoute-Optimizer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269977248,"owners_count":24506551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-11T02:00:10.019Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["canadian-addresses","cost-reduction","delivery-management","delivery-route-planner","field-service","fuel-efficient","google-maps-api","gps-location","html5","logistics","parcel-delivery","productivity-tools","route-optimization","service-technician","tailwindcss","time-saving"],"created_at":"2025-08-12T00:15:26.251Z","updated_at":"2025-08-12T00:15:27.414Z","avatar_url":"https://github.com/web-dev-nav.png","language":"HTML","readme":"# Route Optimizer\n\nA web-based route optimization tool designed for service professionals, delivery personnel, and field technicians to efficiently plan their daily routes across Canada.\n\n\u003cimg width=\"380\" height=\"856\" alt=\"captureit_7-18-2025_at_00-15-53\" src=\"https://github.com/user-attachments/assets/d6993c02-fcd6-4d01-8e0f-25c47152aa22\" /\u003e\n\n## 🎯 Purpose\n\nThe Route Optimizer helps service professionals and delivery personnel minimize travel time and distance when visiting multiple locations across Canada. By calculating the most efficient route between stops, users can:\n\n- **Save Time**: Reduce total travel time between locations\n- **Save Fuel**: Minimize driving distance with optimized routing\n- **Increase Productivity**: Complete more deliveries or service calls per day\n- **Improve Service**: Provide more accurate arrival time estimates\n\n## 🚀 Features\n\n### 📍 Location Services\n- **Current Location Detection**: Automatically detect and use your current GPS location as starting point\n- **Canadian Address Validation**: Restricts addresses to Canadian locations only\n- **Google Places Autocomplete**: Smart address suggestions as you type\n- **Multiple Travel Modes**: Support for driving, walking, and bicycling routes\n\n### 🗺️ Route Optimization\n- **Intelligent Routing**: Uses Google's Distance Matrix API to calculate optimal visit order\n- **Visual Map Display**: Interactive Google Maps showing your optimized route\n- **Real-time Directions**: Turn-by-turn directions for each leg of your journey\n- **Distance \u0026 Duration**: Shows travel time and distance between each stop\n\n### 🎥 User Support\n- **Tutorial Video**: Built-in video tutorial explaining how to use the application\n- **Responsive Design**: Works on desktop, tablet, and mobile devices\n- **Clean Interface**: Simple, intuitive design focused on ease of use\n\n## 🛠️ Technical Specifications\n\n### Technologies Used\n- **Frontend**: HTML5, CSS3, JavaScript (ES6+)\n- **Styling**: TailwindCSS framework\n- **Maps**: Google Maps JavaScript API\n- **Services**: Google Places API, Distance Matrix API, Directions API\n- **Responsive**: Mobile-first responsive design\n\n### Browser Requirements\n- Modern web browser with JavaScript enabled\n- Internet connection for map services\n- Location services permission (optional, for current location feature)\n\n## 📋 How It Works\n\n### Step 1: Set Your Starting Location\n- Enter your starting address manually, or\n- Click \"Use Current Location\" to automatically detect your position\n- Only Canadian addresses are accepted\n\n### Step 2: Add Destination Addresses\n- Enter destination addresses using the autocomplete-enabled input fields\n- Add multiple destinations using the \"Add Customer\" button\n- Remove destinations by clicking the ✖ button next to their address\n- All addresses are validated to ensure they're in Canada\n\n### Step 3: Choose Travel Mode\n- **Driving**: For vehicle-based service calls (default)\n- **Walking**: For dense urban areas or short distances\n- **Bicycling**: For eco-friendly or traffic-heavy areas\n\n### Step 4: Optimize Your Route\n- Click \"Optimize Route\" to calculate the most efficient path\n- The system analyzes distances between all locations\n- Uses nearest-neighbor algorithm for optimal stop ordering\n\n### Step 5: Follow Your Route\n- View the optimized route on the interactive map\n- See detailed stop-by-stop directions\n- Note travel time and distance for each leg\n- Follow turn-by-turn directions to each destination\n\n## 🔧 Setup Instructions\n\n### Prerequisites\n- Web server (Apache, Nginx, or simple HTTP server)\n- Google Maps API key with the following APIs enabled:\n  - Maps JavaScript API\n  - Places API\n  - Distance Matrix API\n  - Directions API\n\n### Installation\n\n1. **Download the files**\n   ```bash\n   # Download or clone the project files\n   # Ensure index.html is in your web server directory\n   ```\n\n2. **Configure Google Maps API**\n   - Get a Google Maps API key from [Google Cloud Console](https://console.cloud.google.com/)\n   - Enable required APIs (Maps JavaScript, Places, Distance Matrix, Directions)\n   - Replace the API key in index.html:\n   ```html\n   \u003cscript src=\"https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY\u0026libraries=places\"\u003e\u003c/script\u003e\n   ```\n\n3. **Deploy to Web Server**\n   ```bash\n   # Copy files to your web server document root\n   cp index.html /var/www/html/\n   # Or serve locally for development\n   python -m http.server 8000\n   ```\n\n4. **Access the Application**\n   - Open your web browser\n   - Navigate to your server URL or `http://localhost:8000`\n   - Grant location permissions when prompted (optional)\n\n### Configuration Options\n\n**API Key Security**: For production use, implement server-side API key management and domain restrictions in Google Cloud Console.\n\n**Geographic Restrictions**: The application is pre-configured for Canada. To modify for other countries, update the `componentRestrictions` in the code:\n```javascript\ncomponentRestrictions: { country: \"ca\" } // Change \"ca\" to your country code\n```\n\n## 🎯 Target Users\n\n- **Delivery Personnel**: Package and parcel delivery drivers\n- **Service Technicians**: Computer repair, appliance repair, HVAC technicians\n- **Field Sales Representatives**: Multi-location sales visits\n- **Healthcare Workers**: Home care nurses, mobile medical services\n- **Small Business Owners**: Any business requiring multi-stop routing\n- **Independent Contractors**: Freelance service providers\n\n## 🌍 Regional Focus\n\nThis application is specifically designed for Canadian markets:\n- Address validation restricted to Canadian postal codes\n- Map centered on Canada by default\n- Optimized for Canadian geography and address formats\n- All distance calculations in metric system\n\n## 📞 Support \u0026 Contact\n\nFor suggestions, improvements, or technical support:\n- **Developer**: Navjot\n- **Email**: web.dev.nav@gmail.com\n- **Year**: 2024\n\n## 📄 License\n\n© 2024 Route Optimizer. All Rights Reserved.\n\n## 🚨 Important Notes\n\n1. **API Costs**: Google Maps API usage may incur charges based on usage volume\n2. **Internet Required**: Application requires internet connection for map services\n3. **Privacy**: Location data is processed by Google Maps services\n4. **Accuracy**: Route optimization is based on road distances, not aerial distances\n5. **Canada Only**: Currently restricted to Canadian addresses only\n\n## 🔄 Future Enhancements\n\nPotential improvements for future versions:\n- Offline map caching\n- Route export to GPS devices\n- Customer appointment scheduling integration\n- Multi-day route planning\n- Service time estimation per stop\n- Route sharing with team members\n- Integration with delivery management systems\n- Package tracking and delivery confirmation\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweb-dev-nav%2Froute-optimizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweb-dev-nav%2Froute-optimizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweb-dev-nav%2Froute-optimizer/lists"}