GeoQuest: A Google Maps Scavenger Hunt

Welcome to GeoQuest, the Google Maps Scavenger Hunt project designed for a thrilling adventure at the University of Virginia! This repository contains all of the resources and code necessary to create an exciting and interactive scavenger hunt using the power of the Google Maps API. Whether you're planning an engaging activity for students, a team-building experience for colleagues, or just a fun adventure with friends, GeoQuest offers a flexible framework to get you started.

Features

• Customizable Scavenger Hunts: Easily create your scavenger hunt by defining locations, clues, and challenges using the Google Maps API.

• Leaderboard System: Rank participants based upon various criteria.

• Interactive Map: Display an engaging map to guide participants and showcase important hunt-related information.

• User-friendly Interface: A straightforward web interface for participants to interact with during the scavenger hunt.

Getting Started

Setting up a Virtual Environment:

1. Install the Virtual Environment Package: If the venv module isn't imported for your current environment enter python -m pip install --user virtualenv into the terminal

2. Creating the Virtual Environment: To create the environment enter python -m venv env into the console where env will be the name of the virtual environment.

3. Activate the Environment: Add the environment's executable to the shell path by typing .\env\Scripts\activate for Windows or source env/bin/activate for macOS/Linux

4. Install Required Packages: If the environment doesn't currently have all the modules that this project uses imported, they can be added with python -m pip install -r requirements.txt

5. Verify Django Installation: Check that Django has been installed into the virtual environment with python -m django --version

6. Deactivating the environment: When you want to exit the virtual environment simply type deactivate

To set up and run your scavenger hunt using GeoQuest, follow these simple steps:

1. Clone the Repository: Clone this repository to your local machine by entering git clone https://github.com/uva-cs3240-f23/project-b-12.git into a terminal

2. Configuration: Configure your Google Maps API credentials and other settings in the project files.

3. Customize Your Hunt: Define the University of Virginia locations, clues, and challenges for your scavenger hunt.

4. Run the Application: From the root directory, enter python manage.py runserver into the terminal to start the application. Then use the webapp to invite participants to embark on their GeoQuest adventure at UVA!

NOTE: Anytime a command starting with python is run in the above steps, it's assumed to be on a Windows machine. If using Linux or macOS, replace the python command with python3 (e.g. python3 -m pip install Django).

The Team

Name	Computing Id	Role
Gabe Silverstein	jgb9fz	Scrum Master
Janice Guo	vdq8tp	DevOps Manager
Gabriel Gladstone	zwy7ce	Testing Manager
Brian Xiao	qhu2fg	Requirements Manager
Shruthi Kalathur	wxs2qx	UX Designer

Current superusers include geoQuest-admin (password: admin-password123) and cs3240.super@gmail.com (password: geoQuest_admin). Current users include cs3240.student@gmail.com (password: geoQuest_student).
Use the Account->Login page instead of logging in with google.

Prepare for an unforgettable adventure at the University of Virginia with GeoQuest! 🏛️🌍🔍
We encourage users new to the site to check out the UVA Trivia Quest!