Шаблон:OSM Location map
Технічні проблеми
[ред. код]Нова версія тепер доступна, станом на 2 квітня 2024 (в англ. вікі — 11 березня 2024)! 18-го квітня 2023, технічна проблема призвела до того, що Вікімедія вимкнула модуль «Graph», який ці карти вимагали для роботи. Відтоді карти на сторінках не відображаються так, як редактори задумували. Схоже на те, що рішення щодо Graph/Vega не буде доступним в недалекому майбутньому. Однак, нарешті було знайде рішення, як обійти цю проблему зі значним переписанням коду, що використовує графіку CSS на відміну від попередньої реалізації. Це має певні переваги та нові можливості (і, можливо, трохи швидший час завантаження завдяки меншим витратам), а також деякі складнощі — особливо пов'язані з розміщення та розміром тексту так само як це робила стара реалізація. Шаблон наче працює стабільно, де найбільші проблеми було вирішеним, але, будь ласка, повідомте про проблеми чи інші речі, про які варто знати, на сторінці обговорення. Оновлення документації планується найближчим часом...Вона включає додаткові графічні елементи та вперше дозволяє додавати «живі» вікіпосилання на карту! Детальніше, див. Повернення до роботи. |
Повернення до роботи, 2024
[ред. код]Для повного опису, як змогли відновити роботу цього шаблону до рівня близького до повноціної роботи, а також щодо нових можливостей, що тепер доступні, див. en:Template:OSM Location map/Return to service. Документація нижче може не описувати всі нові можливості, тому її варто використовувати з огляду на інформацію, що вище.
Документація
[ред. код]Цей шаблон забезпечує:
- Карту (з OpenStreetMap) у фреймі для будь-якого місця у світі, від масштабу всієї мапи до окремого будинку.
- Додаткові мітки, текстові підписи, нумеровані точки, живі вікіпосилання та інші графічні елементи.
- Посилання (у верхнбому правому куті) до повнорозмірної інтерактивної версії, що може мати «точки та деталі» зі статті/карти.
- Карту мінілокатор, що показує контекст для основної карти.
Цей шаблон використовується для створення мапи у фреймі для будь-якого місця і масштабу. При простому використанні він показує частину карти OpenStreetMap та вказівник масшатабу для вказоного регіону світу. Додатково, місце розтвшування на карті може бути підсвічено, використавши мітки і текстові підписи або пронумеровані точки, також на карту можуть бути додані заголовки чи підписи або мінікарта щодо розташування, що покаже більше контексту для основної мапи. Фрейм також надає посилання на інтерактивну повнорозмірну версію карти, що дозволяє користувачу використувати зміну масштабу (приближення/відаллення) і переміщуватися по карті, а також можк відображати картинки на заданому місцю на карті.
Мета
[ред. код]OSM Location map дозволяє редактору, включати карту у фреймі з потрібним рівнем масштабу для теми. Вкізавник масштабу розміщено в нижньому правому куті. У кращому випадку це приблизний орієнтир відстаней на мапі, бо результати проєкції карти в масштабі змінюються залежно від широти. Для цього було зроблено допуск, але лише для великих частин під кутом 20 градусів.
<--Кілька міток, зображень та підписів (currently limited to 60, and that might exceed size limits on very large pages) можуть бути формою чи зображеням, включати текст та потенційно бути «лініями-вказівниками» й іншими графічними елементами. З іншого боку, повнорозмірна мапа буде показувати їх як вказівники-мітки, що можуть мати вспливальні вікна із та підписами,The fullscreen map on the other hand will show them as pointer marks, which can be given popup thumbnail images and captions, as well as providing links to access other maps and satellite images, and an option to show locations of other articles nearby.-->
Список прикладів карт, разом із посиланням до ще ширшого діапазону типів, що використовують if, дивіться en:Template:OSM Location map/examples.
Приклади використання
[ред. код]Сценарій 1: Версія мінімального використання
[ред. код]Чиста мапа, що відцентрована за широтою і довготою, через значення {{coord}}. Встановіть параметр zoom, щоб надати масштаб карті, який вміщує суб'єкт (0=весь світ, 18=вулиця). Якщо використано лише ці параметри, то всі інші параметри або отримують стандартні значення або лишаються не заповненими. Він також надає посилання на інтерактивну повнорозмірну версію мапу.
{{OSM Location map
| coord = {{coord|53.4146|-4.3341}} <!--кординати за широьою/довготою для центрування мапи -->
| zoom = 15 <!--масштабування 0=весь світ, 18=вулиця.-->
}}
|
Сценарій 2: Одна мітка з текстовим підписом
[ред. код]Стандартний «червоний вказівник» та супровідний підпис. Додаткові елементи (три останніх параметри) не відображаються на сторінці, але надають додадкову інформацію, коли наводиш мишку/натискаєш на точку в повнорозмірній версії.
{{OSM Location map
| coord = {{coord|53.394|-4.450}}
| zoom = 13
| width = 300
| height = 150
| caption = Стоячі камені «Трикутник Лланфечелл» розташовані на північному-заході [[Лланфечелл]].
| mark-coord = {{coord|53.3966|-4.46204}} <!--coords для червоної мітки -->
| label = [[:en:Llanfechell#Llanfechell Triangle|Llanfechell Triangle]] <!--текст, що відображається поряд із червоною міткою -->
| label-pos = right
| mark-title = [[:en:Llanfechell#Llanfechell Triangle|Llanfechell Triangle]] <!--текст, що відображається у повнорозмірній мапі, коли наводити мишку на мітку або натиснувши на неї -->
| mark-image = The Llanfechell Triangle - geograph.org.uk - 1260817.jpg <!--зображення, що відображається після натискання на мітку -->
| mark-description=Група доісторичних стоячих каменів, чиє датування за припущеннями відноситься до Бронзової доби, у [[Лланфечелл]], [[Англсі]] <!--текст, що відображається після натискання на мітку -->
}}
|
За бажанням mark-title може бути вікіфікованим і точка на карті станк живим почиланням, навіть якщо сторінки не існує. Підпис (label) також може бути вікіфікованим, але в цьому випадку буде відображено сторінку, що містить підрозділ, як живе посилання, а не зображення об'єкта як це відображається в повнорозмірній версії. Ця функція добре працює, коли є сторінка на обрану тему.
Пустий код
Пустий код для карти з одним маркером | Пустий код із коментарями |
---|---|
{{OSM Location map
| coord = {{coord| | }}
| zoom =
| width =
| height =
| caption =
| label =
| mark-coord = {{coord| | }}
| label-pos =
| mark-title =
| mark-image =
| mark-description =
}}
|
{{OSM Location map
| coord = {{coord| | }} <!-- {{coord}} has various formats for latitude and longitude -->
| zoom = <!-- (0=весь світ, 18=вулиця)-->
| width = <!-- ширина і висота карти у пікселях. Не додавати px -->
| height = <!-- стандартні параметри такі ширина=350, висота=250 -->
| caption = <!-- Текст під картою. Може мати [[вікіпосилання]] -->
<!-- Parameters for 1st mark -->
| label = <!-- текст біля мітки -->
| mark-coord = {{coord| | }} <!-- довгота і довжина місція розташування для мітки -->
| label-pos = <!-- стандартна позиція — left. Також може бути right, top, bottom. -->
| mark-title = <!-- текст, що відображається у повнорозмірній мапі, коли наводити мишку на мітку або натиснувши на неї -->
| mark-image = <!-- зображення, що відображається після натискання на мітку. Використовуйте назву файлу із Вікісховища, без Файл: -->
| mark-description = <!-- текст, що відображається після натискання на мітку у повнорозмірному режимі -->
}}
|
Кілька міток, зображень і підписів
[ред. код]На додачу до ненумерованого набору параметрів, є також 60 нумерованих. Вони в основному ідентичні джо тих, що вище, але їхня назва закінчується номером (1-60). Кожна мітка і підпис має свій набір параметрів (|mark1=
, |mark-coord1=
, |label1=
, |label-pos1=
тощо...|mark2=
, |mark-coord2=
, |label2=
, |label-pos2=
тощо). Значення можуть бути успадковані з «з головного набору параметрів mark1» або зі спеціального Стандартного набору «markD», що дозволяє перезаписати стандартні значення. Коли вони занзачені, то ці значення успадковуються іншими нумерованоми наборами, щоб не було необхідності вказувати їх кожного разу. Однак за необхідністю їх можна вказати окремо.
Сценарій 3: Нумеровані точки з підписами та автопідписами під картою
[ред. код]Код карти можна побачити натиснувши на «редагувати код». Деякі ключові моменти про приклад карти з нумерованими точками:
- Точки мають номери, якщо
shape = n-circle
(також доступні квадрат (square), трикутник (triangle) і діамант (diamond)) - Depending on use cases, and on the number and density of dots, you might choose not to set some (or any) labels, relying on captions/links/main text to explain which feature is which.
- To avoid over-writing, a label position can be adjusted in relation to its dot using ldx and ldy parameters to set + or - pixel offsets horizontally and vertically. (Down and right are +ve, up and left -ve).
- To avoid a crowded area of the map, shape4 uses
| label-pos4 = top,with-line | ldx4 = 8 | ldy4 = -37
to move the label much further away, and add a line linking the label to its shape. - Line breaks can be added to any label by adding a ^ symbol wherever needed, to split a long label.
- By setting
auto-caption=1
, numbered shapes are all listed within the caption, using the 'mark-title' values, which as with shape2 here, might include links or explanations of multiple different items. - Instead of a 1, which gives a full-width caption area, this example sets
auto-caption = 14
which requests a column width of at least 14 ems. The template then adds as many columns as that width permits. - By default, each dot will be given the same number as its 'mark-number'. If each dot is used in turn the numbers will go in sequence, and will match the numbers on the fullscreen version. Fullscreen numbers always run in sequence from 1 upwards, so if you don't use some mark-numbers, or over-ride them with 'numbered=', the fullscreen dots won't match. But they are self-documenting via their hover/click links, so that is not a problematic outcome, if that is desired.
Inherited values
[ред. код]Each mark and label can be given a unique set of attributes (size, colour, outline, angle, relative position, etc.) To minimise repetition of code, there is a sliding scale of inheritance that applies to each value in each parameter set. For example, if label-size4=16
is set, that will always take precedence. If label-size4 has not been set, it will inherit the value from the special Default setting (defined using label-sizeD=
). If no Default has been set, it will inherit the value set by the 'master parameter set', label-size1=
. If that is also undefined it will fall back to the underlying default, which in the case of label-size is 13. The same is true of all the variables relating to marks and labels, (although not to the coordinates, labels themselves, or mark-titles, which are always unique to the particular mark they relate to.)
Кілька міток
[ред. код]{{OSM Location map
| float = right
| zoom = 6
| width = 250
| height = 450
| coord = {{coord|34|10.00}}
| nolabels = 1
| mark-coord1 = {{coord|33.8477|10.0994|}}|label1= Габес| mark-title1 = | mark-description1 =| mark-image1 = Stade gabésien à la CAF.jpg |label-pos1 =bottom|mark1 =Red pog.svg|label-color1 =black
| mark-coord2 = {{coord|36.747778|10.272778}} |label2=Клуб Африкен | mark-title2 = | mark-description2 =| mark-image2 =Radès Olympic stadium.jpg|label-pos2 =right |mark2 =Red pog.svg|label-color2 =black
| caption = Туніс
}}
|
Див. також
[ред. код]Документація вище включена з Шаблон:OSM Location map/документація. (ред. | історія) Дописувачі можуть експериментувати на підсторінках пісочниці (ред. | різн.) та тести (створити) цього шаблону. Будь ласка, додавайте категорії до підсторінки /документація. Підсторінки цього шаблону. |