Шаблон:Mapframe маркери/документація

Опис

Цей шаблон створено за допомогою мови Lua, відповідним йому модулем є Модуль:Mapframe маркери. Цей шаблон призначено для вставки інтерактивних віконець із мапою OpenStreetMap, всередині якої відображаються маркери (позначки у формі крапель), до статей, зокрема статей-списків. Такі віконця уможливлює встановлене у рушії MediaWiki розширення «Kartographer». Для вставки віконець із інтерактивними мапами використовується тег mapframe із списком маркерів у форматі JSON всередині, а цей шаблон повертає код виду:

<mapframe width=500 height=150 zoom=12 longitude=34.97 latitude=48.48 align=center text="Станції дніпровського метрополітену">
{
 "type": "FeatureCollection", "features": 
 [
  {"type": "Feature", 
   "properties": {"title": "Покровська", "description": "", "marker-symbol": "-number-dp", "marker-color": "d00"}, 
   "geometry": {"type": "Point", "coordinates": [34.9274, 48.4799]}},

  ...

  {"type": "Feature", 
   "properties": {"title": "Вокзальна", "description": "", "marker-symbol": "-number-dp", "marker-color": "d00"}, 
   "geometry": {"type": "Point", "coordinates": [35.0154, 48.4753]}}
 ]
}
</mapframe>

Аргументи

Аргумент	Опис	Допустимі значення	Значення за замовчуванням
Загальні
ширина	Ширина віконця із мапою.	Ціле додатне число.	400
висота	Висота віконця із мапою.	Ціле додатне число.	400
широта	Географічна широта центру мапи у вигляді цілого числа або числа із десятковою крапкою. Координати у вигляді 50°27′00″ пн. ш. не допускаються.	Ціле число або число із десятковою крапкою, додатнє чи від'ємне, наприклад 30 або -45 або 12.345678.	0° (Екватор)
довгота	Географічна довгота центру мапи у вигляді цілого числа або числа із десятковою крапкою. Координати у вигляді 30°31′25″ сх. д. не допускаються.	Ціле число або число із десятковою крапкою, додатнє чи від'ємне, наприклад 30 або -45 або 12.345678.	0° (Грінвічський меридіан)
масштаб	Масштаб мапи у вигляді цілого числа від 0 до 19, де 0 це мапа усього світу, а 19 це мапа зі стороною приблизно 70 м, тобто чим більше число, тим мапа "наближеніша" і менша площа відображується на мапі, чим менше число, тим мапа "віддаленіша" і більша площа відображується. Масштаб 0 відповідає проміжку у 360 градусів, масштаб 1 у 180 градусів, масштаб 2 у 90 градусів, і так далі аж до масштабу 19 із проміжком у 2.472 секунд.	Ціле число від 0 до 19.	10
вирівнювання	По якій стороні вирівнювати мапу (вона має бути зліва, справа чи по центру).	left, right або center.	center
текст	Текстовий підпис під мапою.	Будь-який текст, в тому числі із вікірозміткою.	Текст не відображується.
Аргументи для груп маркерів (x - номер групи)
група_назваx	Назва групи (необхідна якщо маркери нумеруються).	Будь-яка послідовність маленьких латинських літер.	Продовжується нумерація попередньої групи.
група_марx	Зображення-піктограма що відображається на маркерах в групі.	Одне з перерахованих тут.	"-number" (нумерація цифрами).
група_колірx	Колір маркерів в групі у форматі RGB, тобто три або шість цифр чи літер від "a" до "f" (шістнадцяткові числа, без префіксу "#"). Кожний символ/два символи відповідають за інтенсивність червоного, зеленого та синього кольорів відповідно, де "0" або "00" - колір відсутній, а "f" або "ff" - максимальна інтенсивність кольору.	Колір у форматі RGB без символу #	"000" (чорний).
Аргументи для маркерів (x - номер групи, y - номер маркера в групі, z - номер маркера без групи)
ширx_y ширz	Географічна широта точки, на яку вказує маркер, у вигляді цілого числа або числа із десятковою крапкою. Координати у вигляді 50°27′00″ пн. ш. не допускаються.	Ціле число або число із десятковою крапкою, додатнє чи від'ємне, наприклад 30 або -45 або 12.345678.	Перехід до наступної групи. Закінчення відображення маркерів.
довx_y довz	Географічна довгота точки, на яку вказує маркер, у вигляді цілого числа або числа із десятковою крапкою. Координати у вигляді 30°31′25″ сх. д. не допускаються.	Ціле число або число із десятковою крапкою, додатнє чи від'ємне, наприклад 30 або -45 або 12.345678.	Перехід до наступної групи. Закінчення відображення маркерів.
назx_y назz	Назва маркера, тобто текст, який відобразиться якщо клікнути по маркеру.	Будь-який текст, в тому числі із вікірозміткою.	Текст не відобразиться. Якщо аргумент "опис" також не задано, при натисканні на маркер нічого не відбудеться.
описx_y описz	Текстовий опис маркера, тобто текст, який відобразиться під назвою якщо клікнути по маркеру.	Будь-який текст, в тому числі із вікірозміткою.	Текст не відобразиться. Якщо аргумент "наз" також не задано, при натисканні на маркер нічого не відбудеться.
марx_y назz	Зображення-піктограма що відображається на маркері.	Одне з перерахованих тут.	Значення для групи. "-number" (нумерація цифрами).
колірx_y колірz	Колір маркера.	Колір у форматі RGB без символу #	Значення для групи. "000" (чорний).

Використання

Шаблон призначено для відображення мапи із маркерами. Маркери можуть бути як самі по собі, тобто мати кожен свій колір та зображення-піктограму, або ж бути згрупованими у групи зі спільним кольором та піктограмою. Географічні координати, назва та опис для кожного маркера завжди свої, і не можуть згруповуватись. Якщо маркери є самі по собі, то для кожного задаються свої параметри шляхом використання аргументів шаблону із додаванням номера маркера в кінець, наприклад аргумент колір5 задає колір п'ятого маркера поза групами. Якщо маркери розподілені по групам, то для кожної групи задаються колір та піктограма шляхом використання аргументів шаблону із додаванням тексту "група_" в початок та номера групи в кінець, наприклад аргумент група_мар3 задає піктограму для третьої групи. Параметри задані для групи застосовуються до всіх маркерів у цій групі, хоча для певного маркера можна перевизначити певний параметр, який використовуватиметься замість параметра групи. Наприклад колір4_2 перевизначить колір другого маркера четвертої групи, який буде застосовуватись до маркера замість кольору заданого в група_колір4. Координати, назва та опис задаються для кожного маркера окремо, так само за допомогою аргументів шаблону із додаванням в кінець номера групи та номера маркера в групі, розділених символом #, наприклад наз3_6 задає назву для шостого маркера в третій групі.

Варто пам'ятати, що номери всіх груп та маркерів мають йти під ряд, оскільки відсутність певного номера трактується так, що попередній номер групи або маркера був останнім. Наприклад, якщо задати групу із номером 1 та групу із номером 3, то група із номером 3 буде проігнорована, оскільки модуль, не знайшовши групи із номером 2, вважатиме групу із попередній номером 1 останньою. Кількість груп та маркерів є теоретично необмеженою (обмежена тільки тим, скільки маркерів може обробити апаратне забезпечення). Також, слід пам'ятати, що назви груп мають складатися лише із маленьких латинських літер. Будь-які інші символи в назві групи, в тому числі цифри, кирилічні літери та великі латинські літери, призведуть до помилки.

Всі допустимі значення для аргументів що визначають піктограму, призводять до відображення на маркерах власне зображення-піктограми, окрім спеціальних значень -number та -letter, які нумерують маркери по порядку числами (1, 2, 3, ...) або літерами (A, B, C, ...), відповідно. Нумерація цифрами не обмежена, а от нумерація літерами після 26-го маркера починає позначати всі подальші маркери літерою "Z", а не комбінацією двох літер, як того можна очікувати.

Приклади

Як виглядає
Код	{{Mapframe маркери |ширина=400|висота=150 |широта=48.48|довгота=34.97|масштаб=12 |текст=Станції дніпровського метрополітену |група_назва1=dp|група_мар1=number|група_колір1=d00 |шир1_1=48.4799|дов1_1=34.9274|наз1_1=[[Покровська (станція метро)|Покровська]] |шир1_2=48.4801|дов1_2=34.9428|наз1_2=[[Проспект Свободи (станція метро)|Проспект Свободи]] |шир1_3=48.4759|дов1_3=34.9616|наз1_3=[[Заводська (станція метро)|Заводська]] |шир1_4=48.4766|дов1_4=34.9793|наз1_4=[[Металургів (станція метро)|Металургів]] |шир1_5=48.4754|дов1_5=34.9954|наз1_5=[[Метробудівників (станція метро, Дніпро)|Метробудівників]] |шир1_6=48.4753|дов1_6=35.0154|наз1_6=[[Вокзальна (станція метро, Дніпро)|Вокзальна]] }}	{{Mapframe маркери|ширина=300|висота=300 |широта=50.4473|довгота=30.537|масштаб=16|вирівнювання=right |мар1=town-hall|колір1=08f|шир1=50.4473|дов1=30.537 |наз1=[[Верховна Рада України]]|опис1=законодавчий орган держави}}
JSON	<mapframe width=500 height=150 zoom=12 longitude=34.97 latitude=48.48 align=center text="Станції дніпровського метрополітену"> { "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": { "title": "[[Покровська (станція метро)|Покровська]]", "description": "", "marker-symbol": "-number-dp", "marker-color": "d00" }, "geometry": { "type": "Point", "coordinates": [34.9274, 48.4799] } }, { "type": "Feature", ... "coordinates": [35.0154, 48.4753] } } ] } </mapframe>	<mapframe width=300 height=300 zoom=16 longitude=30.537 latitude=50.4473 align=right> { "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": { "title": "[[Верховна Рада України]]", "description": "законодавчий орган держави", "marker-symbol": "town-hall", "marker-color": "08f" }, "geometry": { "type": "Point", "coordinates": [30.537, 50.4473] } }, ] } </mapframe>

Див. також

• mw:Help:Extension:Kartographer
• OpenStreetMap
• mw:Extension:Scribunto/Lua reference manual/uk
• mw:Extension:Wikibase Client/Lua
• Шаблон:Mapframe для карток
• Шаблон:Карта розташування+