photoplaces/backend/docs/MAP_PROVIDERS.md

Провайдеры онлайн-карт для РФ

Критерии выбора

• Работоспособность в России (не заблокированы)
• Схематический стиль (не спутник)
• JavaScript API для встраивания в веб
• Бесплатный тариф для старта
• Производительность и кастомизация маркеров

---

Варианты

1. Яндекс Карты (Яндекс JS API v3)

Характеристика	Значение
Статус в РФ	✅ Работает
Схематический стиль	✅ yandex#map + кастомные стили
Бесплатный тариф	✅ 10 000 запросов/сутки, дольше 30 дней — от 300р/мес
Гео-поиск	✅ Встроенный поиск по адресам РФ
Маркеры	✅ Кастомные, кластеризация, балуны (PlaceCard)
Ограничения	❌ Работает только в РФ и СНГ
API	JS API v3, HTTP API геокодера

Вердикт: основной провайдер для РФ

• Нативная поддержка российских адресов
• Хорошая документация на русском
• Простая кастомизация балунов под PlaceCard
• Определение региона пользователя через JS API

2. MapLibre GL JS + OpenStreetMap

Характеристика	Значение
Статус в РФ	✅ Работает (через любые тайлы)
Схематический стиль	✅ Кастомный style.json (можно сделать схематичным)
Бесплатный тариф	✅ Open Source, бесплатно
Маркеры	✅ Кастомные, кластеризация
Поиск адресов	❌ Нужен отдельный сервис (Nominatim или DaData)
Тайлы	MapTiler, Geoapify, или self-hosted

Вердикт: резервный / международный провайдер

• Работает где угодно
• Требует больше настройки
• Для РФ нужен тайловый сервер с российскими тайлами (NextGIS, Geoapify)

3. 2GIS Карты

Характеристика	Значение
Статус в РФ	✅ Работает
Схематический стиль	✅
Бесплатный тариф	✅ До 50 000 запросов/мес
API	JS API (онлайн), Map API (мобильные)
Маркеры	✅ Кастомные
Детализация РФ	✅ Отличная

Вердикт: альтернатива для РФ, но API менее гибкий чем Яндекс

4. Leaflet + OpenStreetMap (через прокси)

Характеристика	Значение
Статус в РФ	✅ Работает
Схематический стиль	⚠️ Зависит от тайлов
Бесплатный тариф	✅
Маркеры	✅ Через плагины

Вердикт: слишком базовая, многое нужно делать руками

---

Итоговая стратегия

Определение страны пользователя
├── РФ / СНГ → Яндекс Карты JS API v3
└── Остальной мир → MapLibre GL JS + OSM (MapTiler)

Определение региона (Geo-detection)

1. Backend: заголовок Cloudflare CF-IPCountry или база GeoIP в Redis
2. Frontend: Intl.DateTimeFormat().resolvedOptions().timeZone как запасной вариант
3. Ответ API при загрузке страницы: { map_provider: "yandex" | "maplibre" }

План внедрения

1. MVP: только Яндекс Карты (первый запуск только в РФ)
2. V2: добавить MapLibre для международных пользователей
3. Держать оба провайдера под одним интерфейсом через абстракцию MapAdapter