Dog parks

📘 README available in Spanish

Welcome to Dog Parks! This project is a tool developed with Python and Folium that generates interactive maps of dog parks in the city of Málaga (Spain), where you can locate the best spaces to walk and enjoy with your pet.

---

🚀 Main Features

• 🐕 Interactive map of dog parks in Málaga (Location, photos and characteristics of each park)
• 📊 Updated data from the open data portal of Málaga City Council

🛠️ Technologies Used

• Language: Python 3.8+
• Maps: Folium (Python + Leaflet.js)
• Data Source: Open Data Portal of Málaga City Council

🗺️ Map Visualization with Folium

For map generation in this project, the Folium library has been used, a Python tool based on Leaflet.js that allows creating dynamic geographical visualizations.

🚀 Demo

The maps generated by this project have been integrated into a complete web application developed with Next.js and deployed on Vercel. This application uses the HTML maps generated from this repository to display dog parks in different languages with a modern and responsive interface.

Visit the website malagadogparks.vercel.app to see the live project.

The generated maps can also be viewed directly by opening the HTML files in any web browser:

• output/parqueCanino_es.html - Spanish Version
• output/parqueCanino_en.html - English Version
• output/parqueCanino_de.html - German Version
• output/parqueCanino_fr.html - French Version

📦 Installation and Usage

Prerequisites

• Python 3.8+
• pip (Python package manager)

Installation

1. Clone the repository:

git clone https://github.com/nuriadevs/dog-parks.git
cd dog-parks

2. Create a virtual environment (recommended):

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Run the map generator:

python3 main.py

📁 Project Structure

📁 dog-parks/
├── 📁 output/                 # Generated HTML maps
│   ├── parqueCanino_de.html   # German Map
│   ├── parqueCanino_en.html   # English Map
│   ├── parqueCanino_es.html   # Spanish Map
│   └── parqueCanino_fr.html   # French Map
├── 📁 src/                   
│   ├── 📁 config/             
│   │   └── config.py          # General configurations
│   └── parqueCanino.py        # Main map generation logic
├── .gitignore                 
├── main.py                    # Main execution script
├── README.md                 
└── requirements.txt          

📊 Data Source

The data used in this project has been collected from the Open Data Portal of Málaga City Council, under their open data policy and public information reuse.

🔗 Official dataset link

👉 Dog Parks - Málaga City Council

🤝 Contributing

Contributions are welcome! If you want to contribute to the project:

1. Fork the project
2. Create a branch for your new feature (git checkout -b feature/new-feature)
3. Make your changes and commit (git commit -m 'Add new feature')
4. Push to your branch (git push origin feature/new-feature)
5. Open a Pull Request for review

📬 Contact

If you have questions, suggestions, or just want to chat about the project, send me a message.

💝 About the Project

Made with ❤️ for our pets

---

⭐ Do you like the project?

Give it a star on GitHub and share it with other dog owners!