Карта друзей
🗺️ Карта друзей
Автор: Анна Муханова
Группа: АДЭУ-221
Дисциплина: Работа с API социальных сетей и облачных сервисов
Статус проекта: Выполнен
Цель работы
Разработать инструмент для сбора и визуализации геоданных из открытых источников (VK) с целью изучения принципов работы API и создания интерактивных карт.
Задачи
- Изучить документацию VK API.
- Получить токен доступа для работы с данными.
- Написать скрипт на Python для сбора ID друзей и их публичных постов с геометками.
- Сохранить полученные координаты в формате JSON.
- Создать веб-страницу с картой (Leaflet) и нанести на нее точки.
- Опубликовать результат.
Технологии
- Языки: Python, JavaScript, HTML/CSS
- Библиотеки Python: requests, vk_api
- API: VK API, OpenStreetMap (через Leaflet)
- Хостинг: GitHub Pages (для карты)
Диаграмма работы приложения «Карта друзей»
Структура проекта

Файлы проекта: config.py (токен), main.py (скрипт), friends_geo.json (результат), map.html (карта)
Ход работы над проектом
Этап 1. Создание страницы в вики и выбор темы
Создала страницу проекта на Digida MGPU через форму DigitalTool. Тема: «Карта друзей» — сбор и визуализация геолокаций из постов ВКонтакте.
Этап 2. Изучение VK API и получение токена
Изучила документацию VK API. Пыталась создать приложение, но столкнулась с трудностями. Использовала сервис vkhost.github.io для получения временного токена. Позже разобралась с созданием собственного приложения, получила стабильный токен через standalone-приложение.
Этап 3. Установка библиотеки и написание Python-скрипта
Установила библиотеку vk_api через терминал:
Написала скрипт, который:
- Авторизуется по токену
- Получает список друзей
- Для каждого друга запрашивает последние 30 постов
- Проверяет наличие поля
geoв каждом посте - Сохраняет координаты, имя друга, текст поста и ссылку в JSON-файл
Результат: собрано 18 постов с геометками у 30 обработанных друзей.
Этап 4. Создание интерактивной карты
Создала HTML-страницу с картой на базе библиотеки Leaflet (OpenStreetMap). Написала JavaScript-код, который:
- Загружает данные из JSON-файла
- Разбирает координаты (формат "широта долгота")
- Добавляет маркеры на карту
- При клике на маркер показывает всплывающее окно с именем друга, местом и ссылкой на пост

Результат: готовая интерактивная карта с точками всех найденных геометок.
Этап 5. Создание интерактивной карты
Создала файл map.html с картой на базе Leaflet (OpenStreetMap). Написала JavaScript-код, который загружает данные из JSON и добавляет маркеры на карту. При клике на маркер открывается окошко с именем друга, названием места и ссылкой на пост.



Итог проекта
Создан работающий инструмент для сбора и визуализации геоданных из ВКонтакте
23 друга обработано | 7 геометок собрано | 6 городов на карте
Проект выполнен в рамках дисциплины «Работа с API социальных сетей и облачных сервисов»
Аналитический дашборд
На основе собранных данных был разработан интерактивный дашборд, который включает:
- Интерактивную карту с маркерами всех найденных мест
- Блок статистики (количество друзей, геометок, городов, самое популярное место)
- Гистограмму распределения отметок по городам
- Круговую диаграмму топ-10 мест по популярности
- Фильтр по друзьям для детального анализа
- Список всех мест со ссылками на посты

Дашборд позволяет анализировать географию постов друзей, фильтровать данные и просматривать статистику
Код дашборда (dashboard.html)
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8">
<title>Дашборд: Карта друзей</title>
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.7.1/dist/leaflet.css" />
<script src="https://unpkg.com/leaflet@1.7.1/dist/leaflet.js"></script>
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
<style>
* { margin: 0; padding: 0; box-sizing: border-box; }
body { font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; background: #f5f7fa; padding: 20px; }
.dashboard { max-width: 1400px; margin: 0 auto; }
h1 { color: #2c3e50; margin-bottom: 20px; border-bottom: 3px solid #3498db; padding-bottom: 10px; }
.row { display: flex; gap: 20px; margin-bottom: 20px; flex-wrap: wrap; }
.card { background: white; border-radius: 12px; box-shadow: 0 2px 8px rgba(0,0,0,0.1); padding: 20px; flex: 1; min-width: 250px; }
.map-container { flex: 2; min-width: 500px; }
.stats { display: flex; gap: 15px; flex-wrap: wrap; margin-bottom: 20px; }
.stat-box { background: white; border-radius: 12px; padding: 20px; text-align: center; flex: 1; min-width: 150px; box-shadow: 0 2px 8px rgba(0,0,0,0.1); }
.stat-number { font-size: 32px; font-weight: bold; color: #3498db; }
.stat-label { color: #7f8c8d; margin-top: 8px; }
#map { height: 400px; width: 100%; border-radius: 8px; }
canvas { max-height: 300px; }
.filter-select { padding: 8px 12px; border-radius: 6px; border: 1px solid #ddd; margin-bottom: 15px; width: 100%; }
hr { margin: 15px 0; border: none; border-top: 1px solid #eee; }
</style>
</head>
<body>
<div class="dashboard">
<h1> Карта друзей — аналитический дашборд</h1>
<div class="stats">
<div class="stat-box"><div class="stat-number" id="totalFriends">0</div><div class="stat-label">Друзей обработано</div></div>
<div class="stat-box"><div class="stat-number" id="totalMarkers">0</div><div class="stat-label">Геометок найдено</div></div>
<div class="stat-box"><div class="stat-number" id="totalCities">0</div><div class="stat-label">Городов</div></div>
<div class="stat-box"><div class="stat-number" id="topPlace">—</div><div class="stat-label">Самое популярное место</div></div>
</div>
<div class="row">
<div class="card map-container">
<h3>Карта с отметками</h3>
<div id="map"></div>
<hr>
<label for="friendFilter">Фильтр по другу:</label>
<select id="friendFilter" class="filter-select"><option value="all">Все друзья</option></select>
</div>
<div class="card">
<h3>Города по количеству отметок</h3>
<canvas id="cityChart"></canvas>
</div>
</div>
<div class="row">
<div class="card">
<h3>Активность по местам</h3>
<canvas id="placesChart"></canvas>
</div>
<div class="card">
<h3>Список найденных мест</h3>
<div id="placesList" style="max-height: 300px; overflow-y: auto;"></div>
</div>
</div>
</div>
<script>
const rawData = [/* данные из friends_geo.json */];
// ... полный код дашборда
</script>
</body>
</html>
Полный код дашборда доступен в репозитории проекта. Для работы необходимо заменить массив rawData на свои данные из friends_geo.json.
Выводы
В ходе работы над проектом я:
- Научилась работать с VK API — получать токен, делать запросы, обрабатывать ответы.
- Освоила парсинг JSON-данных и сохранение результатов в файл.
- Создала интерактивную карту на Leaflet и нанесла на нее реальные геоданные.
- Поняла, как устроены современные веб-сервисы, которые собирают данные из разных источников.
Проект можно развивать дальше: добавить тепловую карту, сделать анализ популярных мест, подключить Яндекс.Карты с более детальными данными.
Полный исходный код приложения
▸ Показать полный код приложения
# config.py
# Токен доступа VK API (получен через standalone-приложение)
TOKEN = "vk1.a.мой_токен_здесь"
# main.py
import vk_api
from config import TOKEN
import json
import time
# Авторизация
vk_session = vk_api.VkApi(token=TOKEN)
vk = vk_session.get_api()
def get_friends_with_geo():
"""
Получает список друзей и собирает их посты с геометками
"""
print("Получаю список друзей...")
friends = vk.friends.get(fields=['first_name', 'last_name'])
friends_data = []
total_friends = friends['count']
print(f"Найдено друзей: {total_friends}")
# Обрабатываем первых 30 друзей
for i, friend in enumerate(friends['items'][:30]):
print(f"Обрабатываю друга {i+1}/30: {friend['first_name']} {friend['last_name']}")
try:
# Получаем последние 50 постов друга
posts = vk.wall.get(owner_id=friend['id'], count=50)
for post in posts['items']:
if 'geo' in post and post['geo']:
geo_data = {
'friend_name': f"{friend['first_name']} {friend['last_name']}",
'friend_id': friend['id'],
'coordinates': post['geo']['coordinates'],
'place': post['geo'].get('place', {}).get('title', 'Без названия'),
'post_text': post.get('text', '')[:100],
'post_url': f"https://vk.com/wall{friend['id']}_{post['id']}"
}
friends_data.append(geo_data)
print(f" Найдена геометка: {geo_data['coordinates']} - {geo_data['place']}")
except Exception as e:
print(f" Ошибка при обработке: {e}")
time.sleep(0.5) # пауза, чтобы не спамить API
# Сохраняем результат
with open('friends_geo.json', 'w', encoding='utf-8') as f:
json.dump(friends_data, f, ensure_ascii=False, indent=4)
print(f"\nГотово! Найдено {len(friends_data)} постов с геометками.")
return friends_data
if __name__ == "__main__":
get_friends_with_geo()
# friends_geo.json (пример данных)
[
{
"friend_name": "Анна Смирнова",
"friend_id": 123456789,
"coordinates": "55.751244 37.618423",
"place": "Красная площадь",
"post_text": "Красота!",
"post_url": "https://vk.com/wall123456789_123"
},
{
"friend_name": "Иван Петров",
"friend_id": 987654321,
"coordinates": "55.755814 37.617635",
"place": "Парк Горького",
"post_text": "Гуляем с друзьями",
"post_url": "https://vk.com/wall987654321_456"
}
]
# map.html
<!DOCTYPE html>
<html>
<head>
<title>Карта друзей</title>
<meta charset="utf-8" />
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.7.1/dist/leaflet.css" />
<script src="https://unpkg.com/leaflet@1.7.1/dist/leaflet.js"></script>
<style>
body { margin: 0; padding: 0; }
#map { width: 100%; height: 100vh; }
</style>
</head>
<body>
<div id="map"></div>
<script>
const friendsData = [
{
"friend_name": "Анна Смирнова",
"coordinates": "55.751244 37.618423",
"place": "Красная площадь",
"post_text": "Красота!",
"post_url": "https://vk.com/wall123456789_123"
},
{
"friend_name": "Иван Петров",
"coordinates": "55.755814 37.617635",
"place": "Парк Горького",
"post_text": "Гуляем с друзьями",
"post_url": "https://vk.com/wall987654321_456"
}
];
const map = L.map('map').setView([55.76, 37.64], 10);
L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', {
attribution: '© OpenStreetMap contributors'
}).addTo(map);
friendsData.forEach(item => {
const [lat, lng] = item.coordinates.split(' ');
const marker = L.marker([parseFloat(lat), parseFloat(lng)]).addTo(map);
marker.bindPopup(`
<b>${item.friend_name}</b><br>
<i>${item.place}</i><br>
${item.post_text}<br>
<a href="${item.post_url}" target="_blank">Открыть пост</a>
`);
});
</script>
</body>
</html>
# requirements.txt
vk-api==5.107
requests==2.31.0



