https://github.com/taralas209/nearest-coffee-map-finder-dvmn

A web app that displays the five nearest coffee shops to your location on an interactive map.
https://github.com/taralas209/nearest-coffee-map-finder-dvmn

coffee-finder flask geolocation python yandex-maps-api

Last synced: about 1 month ago
JSON representation

A web app that displays the five nearest coffee shops to your location on an interactive map.

• Host: GitHub
• URL: https://github.com/taralas209/nearest-coffee-map-finder-dvmn
• Owner: Taralas209
• License: mit
• Created: 2023-07-29T14:54:18.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-07-29T15:05:05.000Z (over 1 year ago)
• Last Synced: 2024-01-27T08:33:50.290Z (11 months ago)
• Topics: coffee-finder, flask, geolocation, python, yandex-maps-api
• Language: Python
• Homepage:
• Size: 134 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Nearest Coffee Finder

This Python application uses the Yandex Maps Geocoding API to find the nearest coffee places to the user's location. It generates an interactive map with markers for the user's location and the closest coffee spots.

## Getting Started

To use this code, clone the repository to your local machine. 

```git clone https://github.com//coffee-locator.git```

```cd coffee-locator```

## Prerequisites

Before you continue, ensure you have met the following requirements:

You have installed Python 3.8 or later.

You have a Yandex Maps API token. If not, you can get it here.

You have the requests, folium, geopy and flask Python packages installed. If not, you can install them using pip:

```pip install requests folium geopy flask```

## How to Use

You should save your Yandex Maps API token to an environment variable YANDEX_MAP_TOKEN:

```export YANDEX_MAP_TOKEN=```

You can then run the script with:

```python coffee_locator.py```

The application will ask you for your current location.

After entering your location, it will create a map with the nearest coffee spots marked on it and save it as index.html.

It will then start a Flask server at http://0.0.0.0:5000, where you can see the generated map.

## License

This project is licensed under the MIT License - see the LICENSE.md file for details.

## Project Goals

The code is written for educational purposes on online-course for web-developers [dvmn.org](https://dvmn.org/).