**Интерактивная Карта Центрально-Азиатской Экспедиции семьи Рерихов (1923–1928 гг.)**
+
+
---
+
+
## О приложении
+
+
CAEMAP.ONLINE — интерактивная карта, которая позволяет проследить маршрут Центрально-Азиатской экспедиции семьи Рерихов 1923–1928 годов. Приложение объединяет картографические данные, дневниковые записи, исторические фотографии и книги участников экспедиции.
+
+
Приложение работает в браузере на компьютерах, планшетах и смартфонах. Установка не требуется.
+
+
+
---
+
+
## Начало работы
+
+
### Открыть приложение
+
+
Перейдите на сайт [caemap.online](https://caemap.online) в любом современном браузере (Chrome, Firefox, Safari, Edge).
+
+
### Выбрать язык
+
+
При первом посещении появляется экран приветствия. Выберите язык интерфейса — **Русский**. Приложение запомнит ваш выбор для следующих визитов.
+
+
+
Английская версия находится в разработке.
+
+
---
+
+
## Навигация по разделам
+
+
Голубая панель в верхней части экрана содержит основные разделы приложения.
+
+
+
Доступные разделы:
+
+
- **О ЦАЭ** — справочные материалы о Центрально-Азиатской экспедиции.
+
- **О проекте** — информация о проекте CAEMAP.ONLINE и его создателях.
+
- **Карта** — интерактивная карта маршрута экспедиции (основной экран).
+
- **Книги** — книги, созданные участниками экспедиции на маршруте.
+
- **Сообщество** — связь с сообществом проекта.
+
- **Руководство** — настоящий документ.
+
+
Активный раздел подчёркнут в панели навигации. Чтобы перейти в другой раздел, выберите соответствующий пункт.
+
+
+
---
+
+
## Интерактивная карта
+
+
Карта — центральный раздел приложения. Здесь отображён маршрут экспедиции с отмеченными точками, маркерами мест и линиями маршрута.
+
+
+
### Перемещение и масштаб
+
+
Для перемещения по карте перетаскивайте её мышью (на компьютере) или пальцем (на мобильном устройстве). Для изменения масштаба прокручивайте колёсико мыши или используйте жест «щипок» двумя пальцами на сенсорном экране.
+
+
### Маркеры на карте
+
+
Каждая точка маршрута обозначена маркером. Форма и цвет маркера отражают тип места:
+
+
| Иконка | Значение |
+
|--------|----------|
+
| Стрелка вправо | Транзитная точка (проезд без остановки) |
+
| Палатка | Стоянка менее 5 дней |
+
| Домик | Стоянка более 5 дней |
+
| Стрелка вверх | Перевал |
+
| Звёздочка | Достопримечательность |
+
+
> **📌 Изображение:** Фрагмент карты с разными типами маркеров, подписанными стрелками-сносками.
+
+
При наведении на маркер появляется всплывающая подсказка с названием места. Если для этого места есть фотографии, рядом с названием отображается значок камеры с количеством фото.
+
+
> **📌 Изображение:** Всплывающая подсказка маркера с названием места и бейджем количества фотографий.
+
+
---
+
+
## Карточка места
+
+
Выберите любой маркер на карте, чтобы открыть карточку с подробной информацией о месте.
+
+
> **📌 Изображение:** Развёрнутая карточка места с заголовком, датой, дистанцией, примечаниями и фотографиями.
+
+
### Содержимое карточки
+
+
Карточка места может содержать следующую информацию:
+
+
- **Заголовок** — название места (на языке экспедиции). Стрелки ◀ ▶ по бокам заголовка позволяют переключаться между соседними точками маршрута.
+
- **Дата** — дата посещения места экспедицией. Если дата приблизительная, рядом стоит знак (?).
- **Современное название** — актуальное географическое название (отображается, если включено в настройках).
+
- **Пройдено за день / от прошлой стоянки** — расстояние в километрах от предыдущей остановки. При наведении на число появляется подсказка с названиями начальной и конечной точек.
- **Примечания** — исторический и краеведческий комментарий. Может содержать заголовки разделов и ссылки.
+
- **Уровень точности** — индикатор точности привязки точки к маршруту (exact, high, medium, low).
+
- **Дневниковые записи** — цитаты из дневников участников, относящиеся к этому месту.
+
- **Фотографии и картины** — архивные фото экспедиции, картины Н.К. Рериха, современные фотографии.
+
+
> **📌 Изображение:** Карточка места с открытыми дневниковыми записями и разделом фотографий.
+
+
### Навигация между точками маршрута
+
+
Используйте стрелки ◀ и ▶ в заголовке карточки, чтобы перейти к предыдущей или следующей точке маршрута. Карта автоматически перемещается к выбранному месту.
+
+
### Свернуть и закрыть карточку
+
+
Чтобы свернуть карточку, не закрывая её, нажмите кнопку-язычок на левом краю карточки (▶). Карточка сдвинется за правый край экрана, освобождая обзор карты. Нажмите кнопку повторно (◀), чтобы развернуть карточку обратно.
+
+
Чтобы полностью закрыть карточку, нажмите кнопку × в правом верхнем углу.
+
+
---
+
+
## Фотографии
+
+
### Просмотр фотографий в карточке места
+
+
В нижней части карточки места отображаются фотографии, разделённые на группы:
+
+
- **Фотографии из архива ЦАЭ** — исторические снимки, сделанные участниками экспедиции.
+
- **Картины Н.К. Рериха** — произведения, созданные на маршруте.
+
- **Современные фото** — современные снимки мест маршрута.
+
+
Выберите любую фотографию, чтобы открыть её в полноэкранной галерее.
+
+
> **📌 Изображение:** Сетка фотографий в карточке места (2 колонки) с видимым разделением на группы.
+
+
### Полноэкранная галерея
+
+
Галерея позволяет листать все фотографии места. Для навигации используйте стрелки по бокам изображения, свайпы на мобильном устройстве или клавиши клавиатуры (← →). Под основным изображением отображаются миниатюры для быстрого перехода.
+
+
В нижней части галереи показаны: название фотографии, описание, автор и дата съёмки.
+
+
Чтобы закрыть галерею, нажмите × или клавишу Esc.
+
+
> **📌 Изображение:** Открытая полноэкранная галерея PhotoSwipe с фотографией, миниатюрами внизу и подписью.
+
+
### Фотографии на карте
+
+
Если в настройках включена опция «Отображать фотографии на карте», фотографии с координатами отображаются в виде миниатюрных иконок прямо на карте. Выберите иконку фотографии, чтобы открыть её в галерее.
+
+
В карточке места фотографии с координатами отмечены значком 📍 в правом нижнем углу. Нажмите на этот значок, чтобы переместить карту к точке, откуда была сделана фотография.
+
+
> **📌 Изображение:** Фрагмент карты с фото-иконками и красным маркером-координатой на миниатюре в карточке.
+
+
---
+
+
## Панель инструментов карты
+
+
Вертикальная панель с кнопками расположена справа от карты. Каждая кнопка включает или отключает определённую функцию.
+
+
> **📌 Изображение:** Панель инструментов карты (вертикальная) с подписанными стрелками-сносками к каждой кнопке.
+
+
### Выбрать карту
+
+
Наведите указатель на кнопку слоёв (первая в панели). Появится панель выбора базовой карты с двумя вкладками:
+
+
**Основные карты:**
+
+
- Topomapper 1km (выбрана по умолчанию) — советская топографическая карта масштаба 1:1 000 000
- Baidu и Gaode — китайские картографические сервисы
+
+
> **📌 Изображение:** Открытая панель выбора карт с двумя вкладками «Основную» / «Дополнительную».
+
+
**Наложение:** В нижней части панели вы можете включить слой OpenRailWayMap для отображения железных дорог.
+
+
**Прозрачность маршрутов:** Ползунок внизу панели регулирует прозрачность линий маршрута (от полупрозрачного до полностью видимого).
+
+
### Перейти на внешнюю карту
+
+
Наведите указатель на кнопку внешних карт. Появится список ссылок на сторонние картографические сервисы. Каждая ссылка открывает текущий участок карты в выбранном сервисе. Координаты передаются автоматически.
> **📌 Изображение:** Открытая панель внешних карт со списком ссылок.
+
+
### Полный экран
+
+
Нажмите кнопку полного экрана, чтобы развернуть карту на весь экран браузера. Нажмите повторно или клавишу Esc, чтобы выйти из полноэкранного режима.
+
+
### Измерить расстояние
+
+
Нажмите кнопку линейки, чтобы включить режим измерения расстояний. В этом режиме каждое нажатие на карту добавляет точку, а между точками отображается расстояние. Нажмите кнопку повторно, чтобы завершить измерение.
+
+
> **📌 Изображение:** Карта в режиме измерения расстояний с несколькими точками и подписями расстояний.
+
+
### Определить ваше местоположение
+
+
Нажмите кнопку геолокации, чтобы отобразить ваше текущее местоположение на карте. Браузер запросит разрешение на доступ к геолокации. После подтверждения карта переместится к вашей позиции и отобразит маркер с кругом точности.
+
+
> Для корректной работы геолокации необходимо, чтобы сайт был открыт по HTTPS, а доступ к геолокации был разрешён в настройках браузера и операционной системы.
+
+
### Поиск
+
+
Нажмите кнопку поиска, чтобы открыть панель поиска. Вы можете искать места маршрута по названию и по дате.
+
+
> **📌 Изображение:** Панель поиска с введённым запросом и списком результатов.
+
+
#### Поиск по названию
+
+
Введите название места (минимум 2 символа). Результаты появляются по мере ввода. Поиск находит совпадения по русскому названию, английскому названию, современному названию и альтернативным названиям. Помимо мест, в результатах также отображаются фотографии, совпавшие по названию или описанию.
+
+
Выберите результат из списка, чтобы переместить карту к этому месту и открыть его карточку.
+
+
#### Поиск по дате
+
+
Нажмите значок календаря 📅 рядом с полем поиска. Появится фильтр по дате, где вы можете указать начальную и/или конечную дату. Нажмите «Найти», чтобы отфильтровать результаты. Нажмите «Сбросить», чтобы снять фильтр по дате.
+
+
Текстовый поиск и фильтр по дате работают совместно: если вы ввели запрос и задали дату, отобразятся только результаты, совпавшие и по названию, и по дате.
+
+
> **📌 Изображение:** Панель поиска с открытым фильтром по дате (поля «С» и «По»).
+
+
### Настройки карты
+
+
Нажмите кнопку шестерёнки, чтобы открыть панель настроек. Настройки сгруппированы по категориям.
+
+
> **📌 Изображение:** Открытая панель настроек с чекбоксами и подписями.
+
+
#### Отображение участков экспедиции
+
+
Вы можете отдельно включить или отключить видимость каждого участка маршрута:
+
+
- **Прибытие в Индию** — начальный участок маршрута.
+
- **Индийская часть маршрута** — перемещения по Индии.
+
- **Основной маршрут экспедиции** — главный маршрут через Центральную Азию.
+
+
#### Общие настройки
+
+
- **Отображать маркеры** — показать или скрыть все маркеры мест на карте.
+
- **Отображать маршрут** — показать или скрыть линии маршрута.
+
- **Выделять выбранный маркер** — подсвечивать маркер выбранного места.
+
- **Отображать совр. название** — показывать современные географические названия в карточке и подписях маркеров.
+
- **Отображать все фотографии** — при включении показывает фотографии с высоким и средним уровнем видимости. При отключении — только избранные (высокий уровень).
+
- **Отображать фотографии на карте** — показать миниатюры фотографий с координатами непосредственно на карте.
+
+
### Таймлайн
+
+
Нажмите кнопку с иконкой часов, чтобы включить таймлайн — горизонтальную шкалу времени в нижней части карты.
+
+
> **📌 Изображение:** Карта с включённым таймлайном в нижней части. Красный ползунок установлен на одном из годов.
+
+
Таймлайн охватывает период 1923–1928 гг. На шкале отображены деления годов (крупные) и месяцев (мелкие).
+
+
Для навигации по времени:
+
+
1. **Перетащите красный ползунок** по шкале к нужному моменту. Карта отфильтрует маршрут и маркеры, оставив только участки, относящиеся к выбранной дате.
+
2. **Нажмите на деление года или месяца**, чтобы мгновенно переместить ползунок к этой точке.
+
+
Под шкалой отображается текущий выбранный месяц и год.
+
+
Чтобы отключить таймлайн и вернуть полный вид маршрута, нажмите кнопку часов повторно.
+
+
### Загрузить KML-трек
+
+
Нажмите кнопку маршрута, чтобы загрузить собственный KML-файл с GPS-треком. Трек отобразится поверх карты цветной линией. Вы можете загрузить несколько файлов.
+
+
> **📌 Изображение:** Карта с загруженным KML-треком и открытой панелью управления KML-треками.
+
+
Для управления загруженными треками нажмите правой кнопкой мыши на кнопку маршрута. Появится панель со списком треков, где вы можете удалить ненужные треки кнопкой ×.
+
+
Загруженные треки сохраняются в памяти браузера и доступны при повторных визитах.
+
+
---
+
+
## Книги
+
+
Раздел «Книги» содержит тексты книг, написанных участниками и исследователями экспедиции непосредственно на маршруте. Чтобы перейти в этот раздел, выберите «Книги» в верхней панели навигации.
+
+
> **📌 Изображение:** Раздел «Книги» с сеткой книжных карточек (обложки и названия).
Выберите обложку книги, чтобы открыть её. Текст книги отображается на странице с оформлением, стилизованным под бумажную книгу (шрифт Literata, выровненный текст, тёплый бежевый фон).
+
+
> **📌 Изображение:** Страница открытой книги с текстом, изображениями и тёплым фоном.
+
+
#### Оглавление (сайдбар)
+
+
Слева от текста расположена боковая панель с оглавлением книги. Используйте её для навигации по главам и разделам.
+
+
На мобильных устройствах оглавление скрыто по умолчанию. Чтобы открыть его, нажмите кнопку-язычок ▶ на левом краю экрана. Нажмите ◀, чтобы скрыть оглавление обратно.
+
+
> **📌 Изображение:** Боковая панель оглавления книги (десктоп) и кнопка-язычок для открытия оглавления (мобильный).
+
+
#### Цветовое оформление разделов
+
+
Различные разделы вики имеют уникальное цветовое оформление фона:
+
+
| Раздел | Цвет фона |
+
|--------|-----------|
+
| О ЦАЭ | Голубой (#d0eeff) |
+
| Книги | Бежевый (#f1e9d8) |
+
| О проекте | Светло-бирюзовый (#c8faff) |
+
+
### Дневниковые записи в карточке места
+
+
Находясь на карте, обратите внимание на раздел дневниковых записей в карточке места. Здесь отображаются цитаты из книг, непосредственно относящиеся к выбранному месту маршрута. Это позволяет читать описания очевидцев параллельно с изучением карты.
+
+
---
+
+
## Ссылки на конкретные места (URL)
+
+
Приложение поддерживает прямые ссылки на конкретные места и виды карты через хеш-параметры в URL. Это позволяет делиться ссылками на определённые точки маршрута.
+
+
Когда вы открываете карточку места, адресная строка браузера автоматически обновляется. Скопируйте URL из адресной строки и отправьте другому человеку — он увидит ту же точку на карте.
+
+
---
+
+
## 3D-карта
+
+
В списке внешних карт доступна ссылка на 3D-карту ЦАЭ. Она открывает трёхмерный вид местности в точке текущего маркера. Это позволяет оценить рельеф и ландшафт на маршруте экспедиции.
+
+
> **📌 Изображение:** Вид 3D-карты с горным рельефом и наложенным маршрутом.
+
+
---
+
+
## Советы по работе с приложением
+
+
- **Для детального изучения** увеличивайте масштаб карты — при приближении появляются дополнительные маркеры, скрытые на мелких масштабах.
+
- **Сравнивайте с историческими картами.** Используйте панель внешних карт, чтобы открыть карту Retromap 1916 года или другие исторические карты в этих же координатах.
+
- **Используйте KML-треки.** Если вы путешествуете по маршруту экспедиции, загрузите свой GPS-трек и сравните его с историческим маршрутом.
+
- **Переключайте участки маршрута.** Если вас интересует только основная экспедиция по Центральной Азии, отключите «Прибытие в Индию» и «Индийскую часть» в настройках.
+
- **Включите фотографии на карте.** Эта опция в настройках позволяет увидеть, откуда именно были сделаны снимки.
- Для функции геолокации — доступ по HTTPS и включённая геолокация в браузере.
+
- JavaScript должен быть включён.
+
+
---
+
+
## Обратная связь
+
+
Если вы нашли ошибку, хотите предложить улучшение или добавить информацию о месте маршрута, свяжитесь с командой проекта через раздел «Сообщество» или «О проекте».