Skip to main content

​
Quickstart Guide

This guide will help you get up and running with Poway Auto quickly. Follow these steps to access the platform, verify your location, and find your first optimized route.

​
Prerequisites

Before you begin, ensure you have:
  • A modern web browser with JavaScript enabled
  • Location services enabled (for automatic position detection)
  • A valid Poway, California address for account qualification
  • Internet connection for real-time traffic data
Poway Auto requires location verification before full access is granted. Make sure you have a valid Poway address ready.

​
Step 1: Access the Live Site

Navigate to the Poway Auto application: https://ahaanv19.github.io/QAV_Frontend/ The homepage displays:
  • Hero section with Lottie animation
  • Interactive map showing your current location
  • Navigation menu with all available features
When you first visit, your browser may ask for location permissions. Allow access for the best experience.

​
Step 2: Submit Location Verification

To qualify for a Poway Auto account, you need to verify your residency.
1

Navigate to Verification

Click on ”✅ Location Verification” from the Poway Auto Menu dropdown on the homepage, or go directly to:https://ahaanv19.github.io/QAV_Frontend/verify/
2

Complete the Form

Fill out the verification form with your information:
Name:    [Your full name]
Email:   [Your email address]
Address: [Your Poway address]
Use your actual residential address in Poway to ensure qualification approval.
3

Submit and Wait

Click the Submit button. You’ll see a confirmation message:“Entry submitted successfully!”You will be emailed within 3 business days if you qualify for an account.

​
Verification API Details

The form submits data to the backend API: 
const API_BASE = 'https://autonomous.stu.nighthawkcodingsociety.com/api';

const response = await fetch(`${API_BASE}/entries`, {
  method: 'POST',
  mode: 'cors',
  credentials: 'include',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name, email, address })
});

​
Step 3: Find Your First Route

Once familiar with the interface, try the Traffic-Aware Route Finder:
1

Open Route Finder

From the menu, select “🗺️ Find Best Route” or navigate to:https://ahaanv19.github.io/QAV_Frontend/route/
2

Enter Your Trip Details

Fill in the route form:
  • Origin: Starting location (e.g., “Poway High School”)
  • Destination: Where you want to go (e.g., “Qualcomm Stadium”)
  • Travel Mode: Select from Driving, Walking, Bicycling, or Transit
3

Get Route Recommendations

Click Find Routes to receive traffic-aware routing:The system returns:
  • Multiple route options
  • Total distance for each route
  • Traffic-adjusted duration estimates
  • Turn-by-turn directions
  • Interactive map visualization

​
Example Route Request

const response = await fetch(`${apiUrl}/api/get_routes`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    origin: 'Poway High School',
    destination: 'Qualcomm Stadium',
    mode: 'driving'
  })
});

​
Understanding Route Results

The response includes detailed routing information: 
[
  {
    "total_distance": "15.3 miles",
    "total_duration": "22 mins",
    "traffic_adjusted_duration": "28 mins",
    "geometry": "encoded_polyline_string",
    "details": [
      {
        "instruction": "Head north on Poway Rd",
        "distance": "0.5 mi",
        "duration": "2 mins"
      }
    ]
  }
]
Route estimates are dynamically adjusted using real traffic data from Poway’s dataset. The first route (blue line) is typically the fastest option.

​
Step 4: Explore Additional Features

​
Favorite Locations

Save frequently visited places for quick access: https://ahaanv19.github.io/QAV_Frontend/favoriteLocations/
  • Click New to add a location
  • Store home, work, school, or other common destinations
  • Use saved locations in route planning

​
Daily Routine Planner

Create a comprehensive schedule for your entire day: https://ahaanv19.github.io/QAV_Frontend/routine/
1

Add a Route to Your Schedule

  • Select a time slot (0:00 AM - 11:00 PM)
  • Enter start location and destination
  • Click ➕ Add Route
2

Organize with Drag and Drop

Routes can be dragged between time slots to reorganize your day. The schedule persists in browser localStorage.
3

View Current Route

Click Show Current Hour Route to display routing for your current time slot on the map.

​
Report Hazards

Help the community by reporting traffic incidents: https://ahaanv19.github.io/QAV_Frontend/hazard/ 
await fetch('https://autonomous.stu.nighthawkcodingsociety.com/api/incidents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    location: 'Poway Rd & Community Rd',
    type: 'accident',
    details: 'Minor fender bender, right lane blocked'
  })
});

​
Interactive Map Features

All Poway Auto pages use Leaflet.js for mapping:
  • Auto-location: Map centers on your current position
  • Pan and Zoom: Navigate the map freely
  • Route Visualization: Blue polylines show recommended routes
  • Markers: See start and end points clearly
  • Turn-by-Turn: Click route for detailed directions
const map = L.map('map').setView([32.7157, -117.1611], 12);

L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', {
  attribution: '© OpenStreetMap contributors'
}).addTo(map);
All features are accessible from the homepage dropdown menu: 
<details>
  <summary>📌 Poway Auto Menu</summary>
  <div>
    <a href="/QAV_Frontend/verify/">✅ Location Verification</a>
    <a href="/QAV_Frontend/route/">🗺️ Find Best Route</a>
    <a href="/QAV_Frontend/favoriteLocations/">⭐ Favorite Locations</a>
    <a href="/QAV_Frontend/routine/">📅 Daily Routine</a>
    <a href="/QAV_Frontend/hazard/">⚠️ Report a Hazard</a>
  </div>
</details>

​
Tips for Best Results

  • Use complete addresses or well-known landmarks
  • Include city names for destinations outside Poway
  • Check multiple route options during peak traffic hours
  • Select appropriate travel mode for your journey
Poway Auto works best with:
  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+
Ensure JavaScript and cookies are enabled.
  • Location data is used only for routing
  • Daily routines are stored locally in your browser
  • API requests include credentials for authenticated features
  • No tracking beyond necessary functionality

​
Next Steps

Now that you’re up and running:
  1. Explore All Features: Try each menu option to discover capabilities
  2. Build Your Routine: Set up your daily schedule for automated routing
  3. Save Favorites: Add common locations for faster trip planning
  4. Stay Updated: Check reported incidents before your commute
For development and deployment information, see the Deployment Guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us