xaxaxax

2025-09-23 20:13:51 +05:00
commit 234525435d
21 changed files with 25832 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,418 @@
+# 🎓 Карта образовательных учреждений Челябинска# 🎓 Карта колледжей и техникумов Челябинска# Карта колледжей Челябинска
+
+
+
+Интерактивная карта университетов, институтов, колледжей, техникумов, лицеев и училищ города Челябинска с использованием Yandex Maps API.
+
+
+
+## 🎯 Что это?Интерактивная карта учебных заведений среднего профессионального образования в Челябинске с использованием Yandex Maps API.Интерактивная карта колледжей Челябинска с использованием Yandex Maps API.
+
+
+
+Этот проект создает интерактивную карту, на которой отмечены все основные образовательные учреждения Челябинска. Карта включает в себя информацию о:
+
+
+
+- Университетах и институтах  ## 📋 Описание## Описание
+
+- Колледжах и техникумах
+
+- Лицеях и училищах
+
+- Специализациях учреждений
+
+- Контактной информацииПриложение создает интерактивную карту с 27 колледжами и техникумами Челябинска, найденными через 2GIS Places API. Карта включает подробную информацию о каждом учебном заведении, их специальностях и контактах.Этот проект создает интерактивную веб-карту с метками всех основных колледжей Челябинска. Каждая метка содержит подробную информацию об учебном заведении, включая:
+
+- Адресах и координатах
+
+
+
+## 🗺️ Функциональность
+
+## 🚀 Установка и запуск- Название колледжа
+
+- **Интерактивная карта** - удобное перемещение и масштабирование
+
+- **Фильтрация по специальностям** - быстрый поиск нужного направления- Адрес
+
+- **Подробная информация** - всплывающие окна с данными об учреждениях
+
+- **Адаптивный дизайн** - работает на всех устройствах1. Убедитесь, что установлен Python 3.8+ и uv:- Описание специальностей
+
+- **Статистика** - подсчет найденных учреждений
+
+```bash- Контактную информацию (телефон, веб-сайт)
+
+## 🏛️ База данных
+
+# Проверить установку uv- Координаты на карте
+
+В проекте содержится информация о **72 образовательных учреждениях** Челябинска:
+
+uv --version
+
+### По типам:
+
+- **Университеты**: 4 учреждения```## Возможности
+
+- **Институты**: 5 учреждений  
+
+- **Академии**: 1 учреждение
+
+- **Колледжи**: 50 учреждений
+
+- **Техникумы**: 7 учреждений2. Установите зависимости:- 📍 10 колледжей с точными координатами
+
+- **Лицеи**: 3 учреждения
+
+- **Училища**: 2 учреждения```bash- 🗺️ Интерактивная карта на базе Yandex Maps API
+
+
+
+### По специализациям:uv sync- 💬 Всплывающие окна с подробной информацией
+
+- Техника и технологии
+
+- Экономика и управление  ```- 📱 Адаптивный дизайн для мобильных устройств
+
+- Медицина и здравоохранение
+
+- Педагогика и образование- 🔍 Поиск и масштабирование карты
+
+- Строительство и архитектура
+
+- Искусство и культура3. Запустите приложение:- 📋 Список всех колледжей под картой
+
+- Транспорт и логистика
+
+- Информационные технологии```bash
+
+- Право и юриспруденция
+
+- Пищевая промышленностьpython main.py## Установка и запуск
+
+- Энергетика
+
+- Сельское хозяйство```
+
+- Металлургия
+
+- Химия### Предварительные требования
+
+- Спорт и физическая культура
+
+4. Откроется браузер с интерактивной картой колледжей.
+
+## 🚀 Как использовать
+
+- Python 3.12 или выше
+
+### 1. Установка зависимостей
+
+## ✨ Функционал- Пакетный менеджер uv (или pip)
+
+Убедитесь, что у вас установлен Python 3.8+ и uv:
+
+
+
+```bash
+
+# Проверить установку uv- **Интерактивная карта** с 27 метками колледжей и техникумов### Установка зависимостей
+
+uv --version
+
+- **Фильтрация по специальностям**: строительство, машиностроение, энергетика, экономика, медицина, педагогика, питание, транспорт, IT, право
+
+# Установить зависимости
+
+uv sync- **Подробная информация** о каждом учебном заведении в всплывающих окнах```bash
+
+```
+
+- **Контактная информация**: телефоны и сайты (где доступно)# Используя uv (рекомендуется)
+
+### 2. Запуск приложения
+
+- **Адаптивный дизайн** для мобильных устройствuv sync
+
+```bash
+
+uv run python main.py- **Автоматическое масштабирование** карты под выбранные фильтры
+
+```
+
+# Или используя pip
+
+Приложение:
+
+1. Загрузит данные об образовательных учреждениях## 📁 Структура проектаpip install -r requirements.txt
+
+2. Создаст HTML-файл с интерактивной картой
+
+3. Покажет статистику по всем учреждениям```
+
+4. Предложит открыть карту в браузере
+
+```
+
+### 3. Настройка API ключа (опционально)
+
+map_yandex/### Получение API ключа Yandex Maps
+
+Для полного функционала получите бесплатный API ключ Yandex Maps:
+
+1. Перейдите на https://developer.tech.yandex.ru/├── main.py                    # Основной скрипт приложения
+
+2. Зарегистрируйтесь и получите ключ
+
+3. Введите ключ при запуске приложения├── map_template.html         # HTML шаблон карты1. Перейдите на [Yandex Developer Console](https://developer.tech.yandex.ru/)
+
+
+
+## 📁 Структура проекта├── colleges_data.json        # База данных колледжей (27 учреждений)2. Создайте новый проект или выберите существующий
+
+
+
+```├── colleges_data_backup.json # Резервная копия данных3. Подключите Maps JavaScript API 2.1
+
+map_yandex/
+
+├── main.py                         # Основное приложение├── pyproject.toml           # Конфигурация проекта и зависимости4. Скопируйте полученный API ключ
+
+├── map_template.html              # HTML шаблон карты
+
+├── colleges_data.json             # База данных учреждений├── uv.lock                  # Заблокированные версии зависимостей
+
+├── chelyabinsk_colleges_map.html  # Готовая карта (создается автоматически)
+
+├── pyproject.toml                 # Конфигурация проекта└── README.md               # Документация### Запуск
+
+└── README.md                      # Документация
+
+``````
+
+
+
+## 🎯 Основные учреждения```bash
+
+
+
+### Университеты:## 🏫 База данныхpython main.py
+
+- Южно-Уральский государственный университет (ЮУрГУ)
+
+- Челябинский государственный университет (ЧелГУ)```
+
+- Челябинский государственный педагогический университет (ЧГПУ)
+
+- Уральский государственный университет физической культурыБаза содержит **27 колледжей и техникумов**, включая:
+
+
+
+### Институты:Программа:
+
+- Челябинский филиал РАНХиГС
+
+- Челябинский институт путей сообщения**Колледжи (22):**1. Загрузит данные о колледжах
+
+- Южно-Уральский институт управления и экономики
+
+- Челябинский филиал РГСУ- Челябинский юридический колледж2. Выведет список всех колледжей в консоль
+
+- Челябинский филиал МПСУ
+
+- Южно-Уральский государственный колледж  3. Запросит API ключ Yandex Maps (можно пропустить)
+
+### Ведущие колледжи:
+
+- Челябинский государственный колледж индустрии питания и торговли- Челябинский педагогический колледж №1 и №24. Создаст HTML файл с картой
+
+- Челябинский медицинский колледж
+
+- Челябинский базовый медицинский колледж- Челябинский медицинский колледж5. Предложит открыть карту в браузере
+
+- Челябинский педагогический колледж №1
+
+- Челябинский юридический колледж- Челябинский энергетический колледж им. С. М. Кирова
+
+- Челябинский машиностроительный колледж
+
+- Челябинский металлургический колледж- Южно-Уральский государственный технический колледж## Структура проекта
+
+- Челябинский энергетический колледж
+
+- Челябинский строительный колледж- Челябинский государственный колледж индустрии питания и торговли
+
+- И многие другие...
+
+- И другие...```
+
+## 🔧 Технические детали
+
+map_yandex/
+
+- **Python 3.8+** - основной язык разработки
+
+- **Jinja2** - шаблонизация HTML**Техникумы (5):**├── main.py                    # Основной скрипт
+
+- **Yandex Maps API 2.1** - интерактивная карта
+
+- **HTML5/CSS3/JavaScript** - фронтенд- Челябинский автотранспортный техникум├── map_template.html          # HTML шаблон карты
+
+- **JSON** - хранение данных
+
+- Челябинский механико-технологический техникум├── colleges_data.json         # Данные о колледжах
+
+## 📱 Совместимость
+
+- Челябинский радиотехнический техникум├── pyproject.toml            # Конфигурация проекта
+
+Карта работает во всех современных браузерах:
+
+- Chrome/Chromium- Челябинский государственный промышленно-гуманитарный техникум им. А.В. Яковлева├── README.md                 # Документация
+
+- Firefox
+
+- Safari- Техникум-интернат инвалидов им. И.И. Шуба└── chelyabinsk_colleges_map.html  # Сгенерированная карта
+
+- Edge
+
+- Мобильные браузеры```
+
+
+
+## 🌟 Особенности## 🛠 Технологии
+
+
+
+- **Полная база данных** - 72 учреждения всех типов## Колледжи на карте
+
+- **Точные координаты** - все адреса геолокализованы
+
+- **Детальная информация** - специальности, контакты, описания- **Python 3.8+** - основной язык разработки
+
+- **Удобная фильтрация** - поиск по направлениям подготовки
+
+- **Адаптивный дизайн** - работает на всех устройствах- **Yandex Maps API 2.1** - картографический сервис1. **Челябинский государственный колледж индустрии питания и торговли**
+
+- **Оффлайн-совместимость** - сохраненная карта работает без интернета
+
+- **Jinja2** - шаблонизатор HTML   - Специализация: общественное питание, торговля, гостиничный сервис
+
+## 📊 Статистика
+
+- **HTML5/CSS3/JavaScript** - фронтенд
+
+- **72** образовательных учреждения
+
+- **6** типов учреждений (университеты, институты, академии, колледжи, техникумы, лицеи, училища)- **2GIS Places API** - источник данных о колледжах2. **Челябинский государственный промышленно-гуманитарный техникум им. А.В. Яковлева**
+
+- **15+** направлений специализации
+
+- **100%** покрытие координатами- **uv** - современный менеджер пакетов Python   - Специализация: машиностроение, металлургия, IT
+
+- **Полная** контактная информация
+
+
+
+## 🤝 Вклад в проект
+
+## 📊 Данные3. **Челябинский техникум текстильной и легкой промышленности**
+
+Если вы нашли ошибку или хотите добавить новое учреждение:
+
+1. Создайте Issue   - Специализация: текстиль, швейное производство, дизайн
+
+2. Внесите изменения в `colleges_data.json`
+
+3. Создайте Pull RequestДанные о колледжах получены через 2GIS Places API и включают:
+
+
+
+## 📄 Лицензия- Названия учебных заведений4. **Челябинский медицинский колледж**
+
+
+
+Проект распространяется под лицензией MIT. Данные об учебных заведениях собраны из открытых источников.- Координаты расположения   - Специализация: медицина, здравоохранение
+
+
+
+## 🆘 Поддержка- Специальности обучения (автоматически определяются по типу учреждения)
+
+
+
+При возникновении вопросов:- Контактную информацию (где доступно)5. **Челябинский государственный колледж физической культуры**
+
+1. Проверьте, что все зависимости установлены
+
+2. Убедитесь, что Python версии 3.8+- Описания   - Специализация: физкультура, спорт
+
+3. Проверьте доступность интернета для загрузки карт Yandex
+
+
+
+---
+
+## 🔧 Разработка6. **Челябинский техникум промышленности и городского хозяйства им. Я.П. Осадчего**
+
+**Автор**: Создано с использованием данных 2GIS и Yandex Maps API  
+
+**Версия**: 2.0 (расширенная база данных)     - Специализация: ЖКХ, строительство, энергетика
+
+**Последнее обновление**: Сентябрь 2025
+Для разработки используется современный стек Python:
+
+- `uv` для управления зависимостями7. **Челябинский автотранспортный техникум**
+
+- `pyproject.toml` для конфигурации проекта   - Специализация: автотранспорт, механика
+
+- Автоматическая генерация HTML из шаблонов
+
+8. **Челябинский педагогический колледж № 1**
+
+## 📝 Лицензия   - Специализация: педагогика, дошкольное образование
+
+
+
+Проект создан в образовательных целях.9. **Челябинский радиотехнический техникум**
+   - Специализация: радиоэлектроника, телекоммуникации
+
+10. **Челябинский колледж комтехно**
+    - Специализация: IT, экономика, коммерция
+
+## Использование без API ключа
+
+Карта будет работать и без API ключа Yandex Maps, но с ограничениями:
+- Возможны водяные знаки на карте
+- Ограничения по количеству запросов
+- Некоторые функции могут быть недоступны
+
+Для полноценной работы рекомендуется получить бесплатный API ключ.
+
+## Технические детали
+
+- **Backend**: Python 3.12, Jinja2
+- **Frontend**: HTML5, CSS3, JavaScript, Yandex Maps API 2.1
+- **Данные**: JSON файл с координатами и описаниями колледжей
+- **Иконки**: Стандартные иконки Yandex Maps (образование)
+
+## Настройка
+
+Вы можете легко добавить новые колледжи, отредактировав файл `colleges_data.json`:
+
+```json
+{
+    "name": "Название колледжа",
+    "address": "Адрес",
+    "lat": 55.1234,
+    "lon": 61.5678,
+    "description": "Описание специальностей",
+    "website": "http://example.com",
+    "phone": "+7 (351) 123-45-67"
+}
+```
+
+## Лицензия
+
+Этот проект создан в образовательных целях. Данные о колледжах собраны из открытых источников.