Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/giovannak/geolocation-system-django
HowFar is a web app hat shows the distance between the user's current location and the desired destination
https://github.com/giovannak/geolocation-system-django
css3 django html5 javascript materializecss python sass sass-library sqlite
Last synced: 20 days ago
JSON representation
HowFar is a web app hat shows the distance between the user's current location and the desired destination
- Host: GitHub
- URL: https://github.com/giovannak/geolocation-system-django
- Owner: GiovannaK
- Created: 2020-10-06T00:00:57.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2021-04-30T06:27:02.000Z (over 3 years ago)
- Last Synced: 2024-10-09T15:21:29.274Z (about 1 month ago)
- Topics: css3, django, html5, javascript, materializecss, python, sass, sass-library, sqlite
- Language: JavaScript
- Homepage:
- Size: 30.2 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HowFar?
## See preview here: https://django-geoip.herokuapp.com/
---
### Table of Contents
Find yourself here
- [Description](#description)
- [How To Use](#how-to-use)
- [License](#license)
- [Author Info](#author-info)
- [Features](#Features)
---
## Description
HowFar is a web app hat shows the distance between the user's current location and the desired destination
## Technologies
### Database
- SQLITE
### Backend
- Python
- Django
### Frontend
- HTML5
- CSS3
- Materialize css
- SASS
---
## Features
### Show the distance
- It is possible to type a location (city, state, country) and get the distance between the current user's location and the typed location
- Users can view and interact with the map
---
## How To Use
### Run locally
#### Use at least python 3.8.3 version
### Clone the project
```html
git clone https://github.com/GiovannaK/geolocation-system-django.git
```
### Create and start a virtual environment
#### Windows
```html
python -m venv venv
venv\Scripts\activate.bat
python -m pip install --upgrade pip setuptools wheel --user
pip install -r requirements.txt
python manage.py migrate
```
#### Linux
```html
python3 -m venv venv
. venv/bin/activate
pip install -r requirements.txt
python manage.py migrate
```
#### MAC
```html
python -m venv venv
. venv/bin/activate
pip install -r requirements.txt
python manage.py migrate
```
### Generate a secret key and add to settings.py
---
### You can use this link to generate your secret key
#### https://miniwebtool.com/django-secret-key-generator/
---
### Run this command to migrate your database
```html
python manage.py migrate
```
### Run this to create an admin account
```html
python manage.py createsuperuser
```
### Start the development server in localhost:8000
```html
python manage.py runserver
```
---
## License
MIT License
Copyright (c) [2020]
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
---
## Author Info
- Linkedin - [Giovanna Cunha](https://www.linkedin.com/in/giovanna-cunha-4989b81b2/)