Шаблон:OSM Location map/документація

Технічні проблеми

Відстежується у Фабрикаторі
Завдання T334940

Повернення до роботи, 2024

Для повного опису, як змогли відновити роботу цього шаблону до рівня близького до повноціної роботи, а також щодо нових можливостей, що тепер доступні, див. en:Template:OSM Location map/Return to service. Документація нижче може не описувати всі нові можливості, тому її варто використовувати з огляду на інформацію, що вище.

Документація

1km
0.6miles

Old John
Tower

C

r

o

p

s

t

o

n

R

e

s

e

r

v

o

i

r

Hallgates

Парковка Old John
(Hunt's Hill)

Bradgate
House

B R A D G A T E   P A R K

Військовий меморіал

  

Old John Tower у Парк Бредгейт, Лестершир

Цей шаблон забезпечує:

• Карту (з OpenStreetMap) у фреймі для будь-якого місця у світі, від масштабу всієї мапи до окремого будинку.
• Додаткові мітки, текстові підписи, нумеровані точки, живі вікіпосилання та інші графічні елементи.
• Посилання (у верхнбому правому куті) до повнорозмірної інтерактивної версії, що може мати «точки та деталі» зі статті/карти.
• Карту мінілокатор, що показує контекст для основної карти.

Цей шаблон використовується для створення мапи у фреймі для будь-якого місця і масштабу. При простому використанні він показує частину карти OpenStreetMap та вказівник масшатабу для вказоного регіону світу. Додатково, місце розтвшування на карті може бути підсвічено, використавши мітки і текстові підписи або пронумеровані точки, також на карту можуть бути додані заголовки чи підписи або мінікарта щодо розташування, що покаже більше контексту для основної мапи. Фрейм також надає посилання на інтерактивну повнорозмірну версію карти, що дозволяє користувачу використувати зміну масштабу (приближення/відаллення) і переміщуватися по карті, а також можк відображати картинки на заданому місцю на карті.

Мета

OSM Location map дозволяє редактору, включати карту у фреймі з потрібним рівнем масштабу для теми. Вказівник масштабу розміщено в нижньому правому куті. У кращому випадку це приблизний орієнтир відстаней на мапі, бо результати проєкції карти в масштабі змінюються залежно від широти. Для цього було зроблено допуск, але лише для великих частин під кутом 20 градусів.

Список прикладів карт, разом із посиланням до ще ширшого діапазону типів, що використовують if, дивіться en:Template:OSM Location map/examples.

Приклади використання

Сценарій 1: Версія мінімального використання

Чиста мапа, що відцентрована за широтою і довготою, через значення {{coord}}. Встановіть параметр zoom, щоб надати масштаб карті, який вміщує суб'єкт (0=весь світ, 18=вулиця). Якщо використано лише ці параметри, то всі інші параметри або отримують стандартні значення або лишаються не заповненими. Він також надає посилання на інтерактивну повнорозмірну версію мапу.

200m
220yds

  

{{OSM Location map | coord = {{coord|53.4146|-4.3341}} <!--кординати за широьою/довготою для центрування мапи --> | zoom = 15 <!--масштабування 0=весь світ, 18=вулиця.--> }}

Сценарій 2: Одна мітка з текстовим підписом

Стандартний «червоний вказівник» та супровідний підпис. Додаткові елементи (три останніх параметри) не відображаються на сторінці, але надають додадкову інформацію, коли наводиш мишку/натискаєш на точку в повнорозмірній версії.

1km
0.6miles

Llanfechell Triangle

  

Стоячі камені «Трикутник Лланфечелл» розташовані на північному-заході Лланфечелл.

{{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: Нумеровані точки з підписами та автопідписами під картою

Венеція

1km
0.6miles

Тронкетто

12

Залізнична станція
Санта-Лучія

11

Санта-Кроче

10

Дорсодуро

9

Кастелло

8

Острів
Сан-Мікеле

7

Каннареджо

6

Санта-Марія-делла-Салюте

5

Міст
Зітхань

4

Гранд-канал

3

Площа
Святого Марка

2

Міст Ріальто

1

  

Деякі ключові локації:

1

Міст Ріальто

2

Площа Святого Марка
Базиліка Святого Марка
Кампаніла собору святого Марка
Квадрига Святого Марка
Палац дожів

3

Гранд-канал

4

Міст Зітхань

5

Санта-Марія-делла-Салюте

6

Каннареджо

7

Сан-Мікеле (острів)

8

Кастелло

9

Дорсодуро

10

Санта-Кроче

11

en:Venezia Santa Lucia railway station

12

en:Tronchetto

Код карти можна побачити натиснувши на «редагувати код». Деякі ключові моменти про приклад карти з нумерованими точками:

• Точки мають номери, якщо 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.)

Кілька міток

150km
100miles

Клуб Африкен

Габес

  

Туніс

{{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 = Туніс }}