Параметры адресной строки

Все параметры передаются в fragment-части URL-а, т.е. после символа #. Формат аналогичен параметрам query string: имена параметров отделяются от значений знаком =, параметры соединяются знаком &, значения при необходимости кодируются в percent-encoding. Большинство параметров требуют список из нескольких значений, значения разделяются знаком /, при этом в percent-encoding кодируются элементы списка, но не разделяющий их /.

Параметры состояния интерфейса

m: позиция карты

Пример:
m=13/48.52618/39.29019
Значения:
1:

уровень зума от 0 до 18

2:

широта в градусах

3:

долгота в градусах

l: включенные слои

Пример:
l=O/D/Wp
Значения:

список кодов слоёв

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

n2: панорамы

Пример:
n2=_gwm/g/54.128460/41.681023/330.0/-7.6/2.0

p: настройки печати

Пример:
p=500/300/auto/210/297/3/3/3/3/54.12945/41.68213/1/54.32774/41.43768/0/0

j: настройки экспорта в JNX

Пример:
j=53.84853/41.24817/54.40296/42.11609

q: поисковый запрос

Пример:
q=Москва

При открытии страницы с таким параметром запрос вставляется в поле поиска, но поиск не осуществляется.

r: результат поиска

Пример:
r=55.750446/37.617494/Москва

При открытии добавляет крестик с подписью. Можно использоовать для привличения внимания к точке при создании ссылки в стороннем сервисе.

min: управление сворачиванием контролов

Параметр предназначен для встраивания сайта на страницах сторонних сервисов и применятся только при загрузке сайта.

Пример:
min=1/1/1/1

Поведение каждого контрола задаётся числовым кодом, коды соединяются символом /. Порядок контролов в значении параметра:

  • список треков

  • список слоёв

  • печать

  • поиск

Значения кодов:
0:

авто (поведение такое же, как при отсутствии параметра)

1:

сворачивать

2:

не сворачивать

Вышеприведённый пример сворачивает все контролы.

autoprofile: отображение профиля высоты трека

Параметр предназначен для встраивания сайта на страницах сторонних сервисов. При его наличии совместно с параметром, из которого загружается трек (nktl, nktu и т.п.), после загрузки трека будет показан профиль высоты этого трека. Загружаться должен только один трек. Если из параметров загружается несколько треков, то поведение не определено. Параметр обрабатывается только при открытии сайта. Значение не требуестя.

Параметры для загрузки треков

Треки можно загрузить:

  • открыв сайт по ссылке

  • заменив адрес в адресной строке при уже открытом сайте

  • вставив ссылку в поле ввода над списком треков. При этом из ссылки загрузятся только треки, но не состояние интерфейса

  • вставив в поле ввода над списком треков один или несколько параметров, добавив перед ними символ #, например: #nktp=11/22

nktk: закодированный трек

Пример:
nktk=QklOZXcgdHJhY2tBQoDt6oDN_Z2BgD7Xc0FAQA
Значения:

строки, кодирующие трек и точки

Такие строки создавались в старой версии сайта, в текущей версии их создать нельзя.

nktl: идентификатор трека

Пример:
nktl=-fgDleyE-9HXaIjH_HG0wQ
Значения:

строки-идентификаторы для загрузки треков с сервера nakarte

Идентификаторы создаются в интерфейсе при клике на пункт Copy link to clipboad в контекстном меню трека и Copy all tracks to clipborad в меню списка треков. По одному идентификатору может хранится несколько треков. В параметре можно передать несколько идентификаторов, хотя в интерфейсе такие ссылки сделать нельзя.

nktu: ссылки на треки

Пример:
nktu=http%3A%2F%2Fslazav.mccme.ru%2Fgps%2F20180415wz.zip/https%3A%2F%2Fwww.strava.com%2Factivities%2F1989612737
Значения:

URL-ы треков, закодированные в percent-encoding

URL-ы могут указывать на файлы поддерживаемых форматов, включая zip, и на сервисы типа Strava, GPSies и т.д.

Параметры отображения загруженных треков:

  • цвет назначается автоматически

  • отображение включено

  • отображение отметок расстояние выключено

nktp: путевая точка

Пример:
nktp=58.87768/31.50055/Point name
Значения:
1:

широта в градусах

2:

долгота в градусах

3:

имя (может отсутствовать, по умолчанию «Point»)

При загрузке создаётся новый трек с единственной путевой точкой, имя трека такое же, как у точки.

nktj: треки и точки с настройками отображения

Пример:
nktj=W3sicCI6IFt7ImxuIjogMzQuNTYsICJsdCI6IDI0LjU2LCAibiI6ICJNeSBwb2ludCJ9XSwgInQiOiBbW1s1Ni4yNCwgNDUuNjddLCBbNTcuMjQsIDQ2LjY3XV1dLCAibiI6ICJUaGUgdHJhY2sifSwgeyJ1IjogImh0dHBzOi8vd3d3LnN0cmF2YS5jb20vYWN0aXZpdGllcy8xOTg5NjEyNzM3IiwgImMiOiAzLCAidiI6IGZhbHNlLCAibSI6IHRydWUsICJuIjogIkFub3RoZXIgdHJhY2sifV0=
Значения:

строки с закодированными треками

Параметр позволяет:

  • настроить отображение трека

  • создать несколько точек

  • задать небольшой трек прямо в значении параметра

  • создать несколько треков

Примечание

Разные браузеры имеют разные ограничения на размер URL. Рекомендуется не создавать такие значения параметра nktj, при которых общая длина URL-а превысит 2083 символа.

Треки описываются в формате JSON и кодируются в URL-safe Base64

Пример описания двух треков в JSON:

[
    {
        "n": "The track",
        "p": [
                {
                    "n": "My point",
                    "lt": 24.56,
                    "ln": 34.56
                }
        ],
        "t": [
                [
                    [
                        56.24,
                        45.67
                    ],
                    [
                        57.24,
                        46.67
                    ]
                ]
        ]
    },
    {
        "n": "Another track",
        "c": 3,
        "v": false,
        "m": true,
        "u": "https://www.strava.com/activities/1989612737"
    }
]

Каждый трек описывается словарём. Словари объединяются в список, один трек тоже помещается в список.

Словари треков

Поля

имя

тип

значение по-умолчанию

описание

n

строка

Track

имя трека

u

строка

нет

URL, по которому загрузить трек, указывает на файл или сервис

p

список словарей

нет

описания путевых точек

t

список

нет

описания линий треков

c

число

авто

цвет

v

булев

true

показ трека включен

m

булев

false

показ отметок длины включен

Данные треков загружаются либо по ссылке из поля u, либо из описаний в полях p и t. При наличии u поля p и t игнорируются.

Имя трека используется по-разному в зависимости от наличия полей u, p, t:

  • Если трек загружается по ссылке из поля u, то при наличии поля n имя трека берется из него, иначе остаётся автоматическое (обычно, имя файла). При этом, если будет загружен zip-архив, содержаший несколько треков, параметр n игнорируется.

  • Если трек создаётся из описаний в полях p и t, то при наличии поля n имя трека берется из него, иначе будет «Track»

Цвет трека задаётся числом:

Число

цвет

0

синий

1

оранжевый

2

голубой

3

красный

4

фиолетовый

5

желтый

Словари точек

Поля

имя

тип

описание

n

строка

Имя точки, поле обязательное

lt

число

широта

ln

число

долгота

Линии треков

  • описание состоит из списка сегментов

  • сегмент состоит из списка точек

  • точка описывается списком из двух элементов, широты и долготы.