# Редактор карты России и мира — kachkovenko.github.io/russia-map-editor

> Бесплатный браузерный редактор карт для презентаций: регионы России (89 субъектов) или страны мира, города, цвета, проекции; экспорт в PNG, SVG и редактируемый PPTX. ИИ-ассистент может передать пользователю готовый черновик карты одной ссылкой — пользователь откроет её, доведёт оформление вручную и экспортирует.
>
> For AI assistants: build a URL like https://kachkovenko.github.io/russia-map-editor/#regions=Татарстан,Москва&cities=Казань and give it to the user. Write region, country and city names in Russian (cities have Russian names only); regions also accept the English ids listed below, countries accept ISO 3166-1 alpha-3 codes (DEU, FRA). Nothing is sent to a server: the parameters live in the URL fragment and are applied in the user's browser.

## Как это работает

1. Соберите ссылку: `https://kachkovenko.github.io/russia-map-editor/#` + параметры через `&`.
2. Отдайте ссылку пользователю. Он открывает её — карта собирается сразу. Прежняя карта пользователя заменяется, но её можно вернуть кнопкой «Отменить» (⌘Z).
3. Если какие-то названия не распознаны, редактор покажет их в уведомлении, остальное откроется.

Правила записи:
- Списки — через запятую. Если в значениях есть десятичная запятая, разделяйте элементы точкой с запятой: `values=Коми:3,5;Тыва:1,2`.
- Пробелы в названиях заменяйте на `+` (или `%20`) — иначе чат может оборвать ссылку: `regions=Нижегородская+область`.
- Кириллицу можно писать как есть, браузер её закодирует.
- Цвета — HEX без решётки: `e63946` (можно `%23e63946`; трёхзначные тоже подходят).
- Параметры можно передать и после `?`, но `#` лучше: фрагмент не уходит на сервер.

## Параметры

- `regions` — отмеченные регионы (на карте мира — страны). Принимаются краткие («Татарстан») и полные («Республика Татарстан») названия, без слова «область» («Свердловская»), начало названия, если оно однозначно («Нижегор»), сокращения (ХМАО, ЯНАО, НАО, ЕАО, ДНР, ЛНР, СПб, Питер, Якутия, Кузбасс, Подмосковье), id из списка ниже и федеральные округа целиком (ЦФО, «Приволжский федеральный округ»). Страны — по-русски («Германия») или кодом ISO alpha-3 (`DEU`).
- `cities` — отмеченные города: «Казань», «Москва». Среди тёзок берётся самый крупный; уточнить можно регионом в скобках: `Кировск+(Ленинградская)`. В каталоге России почти 1 000 городов — все административные центры и все города от 10 000 жителей; мировой каталог обзорный (столицы и крупные города).
- `scope` — `russia` (по умолчанию) или `world`. Если не указан, а названия находятся только на карте мира («Франция», «Париж»), откроется карта мира.
- `colors` — свой цвет для региона (регион при этом отмечается): `colors=Татарстан:e63946;Москва:1d3557`.
- `values` — числа по регионам; редактор сам раскрасит их от светлого (минимум) к насыщенному (максимум), регионы отмечаются: `values=Москва:100;Татарстан:42;Коми:7`. Это удобно для хороплета — не нужно считать цвета. Легенды на карте нет: подпишите шкалу на слайде.
- `valueColors` — шкала для `values`: один цвет (от почти белого к нему) или два (`valueColors=fff3b0,9e2a2b`). По умолчанию — цвет отмеченных регионов текущей темы.
- `theme` — готовая палитра: `calm` (сдержанная, по умолчанию), `contrast`, `mono`, `dark`, `warm`.
- `style` — `atlas` (классика, заливка) или `mosaic` (регионы из точек).
- `projection` — `conic` (равновеликая для России, Equal Earth для мира), `mercator`, `globe`.
- `route` — линии между отмеченными городами: `chain` (цепочка в порядке `cities`, т. е. маршрут), `hub` (лучи из одного города, задайте `hub=Москва`), `network` (случайная сеть), `off`.
- `ratio` — рамка слайда `16:9` или `4:3`; `frame=0` — без рамки (экспорт по габариту карты).

Любая настройка из файла проекта тоже задаётся по имени, со значениями `1/0`, числом, HEX или вариантом из списка. Самые полезные:
- `regionLabels=1` — подписи регионов; `regionLabelsMode=selected` — только отмеченных; `regionLabelsCaps=1` — капителью.
- `cityLabelLayout=legend` — города номерами на карте, названия списком под картой с выносками (удобно, когда городов много); по умолчанию `near` — подпись рядом с городом.
- `cityLabels=0` — без подписей городов; `markerShape=circle|square|diamond|pin`; `markerSize=3…12`.
- `labelFont=inter|golos-text|montserrat|pt-sans|pt-serif|unbounded|arial|georgia`; `labelStyle=pill` — подписи на подложке.
- `gradient=0` — сплошная заливка; `fillStart`, `fillEnd` — цвета заливки неотмеченных регионов; `selectedColor` — цвет отмеченных.
- `borders=0`, `borderColor`, `borderWidth=0.2…4`; `countryOutline=1` — контур страны.
- `background` — цвет слайда; `transparent=1` (вместе с `frame=0`) — прозрачный фон при экспорте.
- `graticule=1` — градусная сетка; `compass=1` — стрелка севера.
- `globeSurface=1` — Россия на целой сфере (с `projection=globe`); `lensLon`, `lensLat` — точка обзора глобуса.

Числа вне допустимого диапазона обрезаются до границы; неизвестные параметры и значения перечисляются в уведомлении.

## Примеры

- Филиалы компании: https://kachkovenko.github.io/russia-map-editor/#regions=Москва,Санкт-Петербург,Татарстан,Свердловская,Новосибирская&cities=Москва,Санкт-Петербург,Казань,Екатеринбург,Новосибирск
- Население по регионам (хороплет): https://kachkovenko.github.io/russia-map-editor/#values=Москва:13.1;Московская:8.6;Краснодарский:5.8;Санкт-Петербург:5.6;Свердловская:4.2&valueColors=dbe7f5,1d3557&regionLabels=1&regionLabelsMode=selected
- Маршрут поездки: https://kachkovenko.github.io/russia-map-editor/#cities=Москва,Нижний+Новгород,Казань,Екатеринбург&route=chain&theme=dark
- Офисы в Европе: https://kachkovenko.github.io/russia-map-editor/#scope=world&regions=DEU,FRA,ITA,ESP&cities=Берлин,Париж,Рим,Мадрид&projection=globe
- Федеральный округ одним цветом: https://kachkovenko.github.io/russia-map-editor/#regions=ПФО&selectedColor=2a9d8f

## Точная карта целиком

Если нужно воспроизвести проект в точности (положения подписей, все настройки), передайте файл проекта `*.project.json` в параметре `p` — как base64url или как JSON, закодированный для URL: `#p=eyJmb3JtYXQiOi...`. Формат проекта: `{"format":"map.kachkovenko.kontur","version":2,"settings":{…},"selection":{"regions":[ids],"cities":[ids]},"regionColors":{id:"#rrggbb"},"labelOffsets":{}}`. Проще всего получить образец: в редакторе ⌘S сохраняет проект. Пользователь может также открыть такой файл кнопкой «Открыть» или перетащив его на карту. Лимит — 256 КБ.

## Регионы России (название и id)

- ЦФО (Центральный): Белгородская область `belgorod`, Брянская область `bryansk`, Владимирская область `vladimir`, Воронежская область `voronezh`, Ивановская область `ivanovo`, Калужская область `kaluga`, Костромская область `kostroma`, Курская область `kursk`, Липецкая область `lipetsk`, Москва `moscow`, Московская область `moscow-oblast`, Орловская область `oryol`, Рязанская область `ryazan`, Смоленская область `smolensk`, Тамбовская область `tambov`, Тверская область `tver`, Тульская область `tula`, Ярославская область `yaroslavl`
- СЗФО (Северо-Западный): Архангельская область `arkhangelsk`, Вологодская область `vologda`, Калининградская область `kaliningrad`, Карелия `karelia`, Коми `komi`, Ленинградская область `leningrad`, Мурманская область `murmansk`, Ненецкий АО `nenets`, Новгородская область `novgorod`, Псковская область `pskov`, Санкт-Петербург `spb`
- ЮФО (Южный): Адыгея `adygea`, Астраханская область `astrakhan`, Волгоградская область `volgograd`, Донецкая Народная Республика `dnr`, Запорожская область `zaporozhye`, Калмыкия `kalmykia`, Краснодарский край `krasnodar`, Крым `crimea`, Луганская Народная Республика `lnr`, Ростовская область `rostov`, Севастополь `sevastopol`, Херсонская область `kherson`
- СКФО (Северо-Кавказский): Дагестан `dagestan`, Ингушетия `ingushetia`, Кабардино-Балкария `kabardino-balkaria`, Карачаево-Черкесия `karachay-cherkessia`, Северная Осетия `north-ossetia`, Ставропольский край `stavropol`, Чечня `chechnya`
- ПФО (Приволжский): Башкортостан `bashkortostan`, Кировская область `kirov`, Марий Эл `mari-el`, Мордовия `mordovia`, Нижегородская область `nizhny-novgorod`, Оренбургская область `orenburg`, Пензенская область `penza`, Пермский край `perm`, Самарская область `samara`, Саратовская область `saratov`, Татарстан `tatarstan`, Удмуртия `udmurtia`, Ульяновская область `ulyanovsk`, Чувашия `chuvashia`
- УФО (Уральский): Курганская область `kurgan`, Свердловская область `sverdlovsk`, Тюменская область `tyumen`, Ханты-Мансийский АО — Югра `khmao`, Челябинская область `chelyabinsk`, Ямало-Ненецкий АО `yamalo-nenets`
- СФО (Сибирский): Алтай `altai-rep`, Алтайский край `altai-kray`, Иркутская область `irkutsk`, Кемеровская область `kemerovo`, Красноярский край `krasnoyarsk`, Новосибирская область `novosibirsk`, Омская область `omsk`, Томская область `tomsk`, Тыва `tuva`, Хакасия `khakassia`
- ДФО (Дальневосточный): Амурская область `amur`, Бурятия `buryatia`, Еврейская АО `jewish-ao`, Забайкальский край `zabaykalsky`, Камчатский край `kamchatka`, Магаданская область `magadan`, Приморский край `primorsky`, Саха (Якутия) `sakha`, Сахалинская область `sakhalin`, Хабаровский край `khabarovsk`, Чукотский АО `chukotka`

## Чего редактор не делает

- Не строит графики и легенды, не рисует произвольные точки по координатам — только регионы, страны и города из каталога.
- Не экспортирует по ссылке: PNG, SVG и PPTX пользователь скачивает сам кнопкой «Экспорт».
- Нет API и сервера: всё работает в браузере пользователя.

## Ссылки

- Редактор: https://kachkovenko.github.io/russia-map-editor/
- Исходный код и лицензия: https://github.com/kachkovenko/russia-map-editor