map_yandex/README.md

# 🎓 Карта образовательных учреждений Челябинска# 🎓 Карта колледжей и техникумов Челябинска# Карта колледжей Челябинска



Интерактивная карта университетов, институтов, колледжей, техникумов, лицеев и училищ города Челябинска с использованием 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"
}
```

## Лицензия

Этот проект создан в образовательных целях. Данные о колледжах собраны из открытых источников.