Files
map_yandex/README.md
2025-09-23 20:13:51 +05:00

20 KiB
Raw Blame History

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

Интерактивная карта университетов, институтов, колледжей, техникумов, лицеев и училищ города Челябинска с использованием Yandex Maps API.

🎯 Что это?Интерактивная карта учебных заведений среднего профессионального образования в Челябинске с использованием Yandex Maps API.Интерактивная карта колледжей Челябинска с использованием Yandex Maps API.

Этот проект создает интерактивную карту, на которой отмечены все основные образовательные учреждения Челябинска. Карта включает в себя информацию о:

  • Университетах и институтах ## 📋 Описание## Описание

  • Колледжах и техникумах

  • Лицеях и училищах

  • Специализациях учреждений

  • Контактной информацииПриложение создает интерактивную карту с 27 колледжами и техникумами Челябинска, найденными через 2GIS Places API. Карта включает подробную информацию о каждом учебном заведении, их специальностях и контактах.Этот проект создает интерактивную веб-карту с метками всех основных колледжей Челябинска. Каждая метка содержит подробную информацию об учебном заведении, включая:

  • Адресах и координатах

🗺️ Функциональность

🚀 Установка и запуск- Название колледжа

  • Интерактивная карта - удобное перемещение и масштабирование

  • Фильтрация по специальностям - быстрый поиск нужного направления- Адрес

  • Подробная информация - всплывающие окна с данными об учреждениях

  • Адаптивный дизайн - работает на всех устройствах1. Убедитесь, что установлен Python 3.8+ и uv:- Описание специальностей

  • Статистика - подсчет найденных учреждений


## 🏛️ База данных

# Проверить установку 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

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 из шаблонов

  1. Челябинский педагогический колледж № 1

📝 Лицензия - Специализация: педагогика, дошкольное образование

Проект создан в образовательных целях.9. Челябинский радиотехнический техникум

  • Специализация: радиоэлектроника, телекоммуникации
  1. Челябинский колледж комтехно
    • Специализация: 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:

{
    "name": "Название колледжа",
    "address": "Адрес",
    "lat": 55.1234,
    "lon": 61.5678,
    "description": "Описание специальностей",
    "website": "http://example.com",
    "phone": "+7 (351) 123-45-67"
}

Лицензия

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