Этот шаблон используется примерно на 15 000 страницах, и изменения могут быть широко заметны. Протестируйте изменения на подстраницах / sandbox или / testcases шаблона или на подстранице вашего собственного пользователя . Обсудите изменения на странице обсуждения, прежде чем внедрять их. Счетчик включений обновляется автоматически ( см. Документацию ). |
Этот шаблон использует Lua : |
Этот шаблон использует свойство Викиданных : |
В этом шаблоне используется тег OpenStreetMap :
|
Этот шаблон добавляет ссылку или фрейм, в котором будут отображаться данные карты - либо из:
- данные, хранящиеся в формате GeoJSON в Commons
- линейные / полигональные объекты в OpenStreetMap.
- координаты, предоставленные либо из Викиданных
- необработанный GeoJSON, желательно перенесенный с другой страницы
Примечание:
- Если у вас очень большая / медленная карта, вам следует использовать
mapframe
тег расширения напрямую вместо этого шаблона, как это было сделано в Special: Diff / 970846012 . Причина этого в том, что использование шаблона для вызова тега расширения приведет к тому, что рендеринг карты будет считаться временем Lua, что может привести к ошибкам превышения времени. - Файлы GeoJSON в настоящее время не могут быть загружены напрямую. Вместо этого в Commons создайте страницу, которая находится в
Data:
пространстве имен и заканчивается на.map
- см. Mw: Help: Map Data для получения дополнительной информации. - Чтобы сделать доступными функции OpenStreetMap (OSM), добавьте ключ Wikidata в отношение OSM (и подождите 1 или 2 дня) - см. Mw: Help: Extension: Kartographer # External_data и mw: Help: Extension: Kartographer / OSM для получения дополнительной информации.
Вы можете использовать для создания карты фрейма карты, подходящей для информационных ящиков, с минимальным вмешательством пользователя.{{Infobox mapframe}} |
Использует
Этот шаблон предназначен для линейных или полигональных объектов, включая (но не ограничиваясь):
- Дороги
- Реки
- Метро или поезда
- Судовые курсы
- Маршруты полета
- Путешествие исследователей
- Среда обитания животных
- Страны и их подразделения
и многое другое ... Этот шаблон также можно использовать для отображения точечных объектов на карте, то есть координат.
использование
Основное использование
- Страница с данными в Commons (например, Data: ecos.fws.gov/Endangered place of 58938 / Plethodon neomexicanus.map ) :
{{maplink|from=}}
(укажите страницу данных .map в from =, исключая префикс данных)
- Необработанные данные GeoJSON (например, {{ Wikipedia: Map data / Main Roads Western Australia / Forrest Highway }}) :
{{maplink|raw=}}
(укажите необработанный GeoJSON, предпочтительно включенный с подстраницы Википедии: данные карты )
- Линия границы или линейный объект из OSM:
{{maplink|type=line|id=}}
(Идентификатор Викиданных требуется только в том случае, если будет использоваться страница Викиданных другой статьи)
- Форма из OSM:
{{maplink|type=shape|id=}}
(Идентификатор Викиданных требуется только в том случае, если будет использоваться страница Викиданных другой статьи)
- Перевернутая форма из OSM:
{{maplink|type=shape-inverse|id=}}
(Идентификатор Викиданных требуется только в том случае, если будет использоваться страница Викиданных другой статьи)
- Точечный объект (координаты):
- ... из Викиданных:
{{maplink|type=point|id=}}
(Идентификатор Викиданных требуется только в том случае, если должна использоваться страница Викиданных другой статьи) - ... из указанных координат:
{{maplink|type=point|coord=}}
(укажите координаты с помощью шаблона {{ Coord }})
- ... из Викиданных:
- Все именованные координаты со страницы или раздела ( шаблоны, использующие параметр)
{{coord}}
|name=
- ... с текущей страницы:
{{maplink|type=named}}
или{{maplink|type=named|from=#Section}}
- ... с другой страницы:
{{maplink|type=named|from=Other page}}
или{{maplink|type=named|from=Other page#Section}}
- ... с текущей страницы:
- Круг (с центром в координатах точки):
- ... из Викиданных:
{{maplink|type=circle|radius=|id=}}
(Идентификатор Викиданных требуется только в том случае, если должна использоваться страница Викиданных другой статьи) - ... из указанных координат:
{{maplink|type=circle|radius=|coord=}}
(укажите координаты с помощью шаблона {{ Coord }})
- ... из Викиданных:
- Чтобы показать в кадре, добавьте параметр
|frame=yes
.
- Дополнительные параметры доступны для настройки отображаемой карты, например,
|plain=yes
для удаления внешней рамки.
- Наложения также могут отображаться поверх карты.
Набор параметров - страница данных
{{maplink| дисплей =| из =| zoom =| текст =| значок =}}
Набор параметров - необработанные данные
{{maplink| дисплей =| raw = <! - предпочтительно {{Wikipedia: Map data / subpage}} ->| zoom =| текст =| значок =}}
Набор параметров - geoline / geoshape
{{maplink| дисплей =| тип =| id =| название =| description =| цвет обводки =| ширина штриха =| zoom =| текст =| значок =}}
Набор параметров - точечные объекты / координаты
{{maplink| дисплей =| тип = точка| id =| название =| description =| Координаты =| маркер =| zoom =| текст =| значок =}}
Набор параметров - круги
{{maplink| дисплей =| type = круг| radius = <! - в метрах, альтернативные параметры доступны для других единиц -> | id =| название =| description =| Координаты =| маркер =| zoom =| текст =| значок =}}
Параметры
Для общего отображения
- отображать
- Как отображается шаблон. Допустимые значения:
inline
- Отображает только встроенную ссылку (вы можете отказаться от этого, так как это значение по умолчанию)title
- Отображает только заголовок ссылкиinline,title
- Отображает встроенную ссылку, а также ссылку заголовкаtitle,inline
- То же, что и выше
- текст
- Текст, отображаемый для ссылки (или заголовок при использовании фрейма карты); по умолчанию - «Карта»
- значок
- Установите значение «нет», чтобы отключить значок, который появляется рядом со ссылкой.
- зум
- Уровень масштабирования, от
1
до19
(большее число увеличивает масштаб); по умолчанию автоматически определяется картой, за исключением случаев, когда единственной функцией является отдельная точка.
Параметры Mapframe (работают только со встроенным отображением)
- Рамка
- Установите значение «да», чтобы отображать фрейм карты вместо ссылки.
- простой
- Установите значение «да», чтобы отображать только карту без окружающего фрейма и без подписи ( текстовый параметр будет проигнорирован).
- выравнивание по фрейму
- Выравнивание по отношению к странице:
left
,center
илиright
; по умолчаниюright
- ширина кадра
- Ширина рамки карты, по умолчанию
300
- высота рамы
- Высота рамки карты, по умолчанию
200
- фрейм-координаты
- (или фрейм-координата )
- Необязательно - альтернативные координаты для начального размещения карты. Используйте шаблон {{ Coord }}, чтобы указать координаты (например
|frame-coordinates={{Coord|12.34|S|56.78|W}}
) . Если не установлен, координаты будут извлечены из Викиданных. - кадр-широта
- (или кадр-лат )
- (игнорируется, если установлено
|frame-coordinates=
или|frame-coord=
) - Необязательно - альтернативная координата широты для начального размещения карты.
- долгота кадра
- (или фрейм-длинный )
- (игнорируется, если установлено
|frame-coordinates=
или|frame-coord=
) - Необязательно - альтернативная координата долготы для начального размещения карты.
- Примечание. Если широта и долгота кадра не заданы параметрами, то координаты кадра могут быть определены автоматически, либо:
- На основе объектов линии и формы (если таковые указаны) или
- От точечного объекта, указанного в (если задано), или
|coord=
- Получено из Викиданных (если доступно - либо для элемента, указанного в
|id=
параметре, либо для страницы, на которой размещен шаблон)
- наложение
- Изображение или другая карта, которая будет отображаться поверх карты. Например
|overlay=[[File:Example.svg|140x140px]]
или же|overlay={{maplink|frame=yes|plain=yes|frame-width=100|frame-height=100|type=shape|id=Q100|frame-align=center}}
или же|overlay={{Graph:Street map with marks|width=100|height=100|lat=37.8|lon=-122.4|zoom=6|{ "lat": 37.8, "lon": -122.4 }|minimap=false}}
- (см. Шаблон: Maplink / testcases / overlays для просмотра примеров)
- наложение-горизонтальное выравнивание
- Выравнивание оверлея по горизонтали либо,
left
либоright
; по умолчаниюright
- наложение-вертикальное выравнивание
- Вертикальное выравнивание оверлея либо,
top
либоbottom
; по умолчаниюbottom
- оверлей-горизонтальное-смещение и оверлей-вертикальное-смещение
- Необязательно - количество пикселей для смещения наложения от края карты, например,
10
для зазора в 10 пикселей.
Необработанный GeoJSON
- сырой
- Необработанный GeoJSON (предпочтительно включенный с подстраницы Википедии: данные карты ), а также функциональность <maplink>, недоступная через другие параметры. См. Дополнительную информацию ниже.
Для каждой функции
На одной карте могут отображаться несколько объектов. Для каждой дополнительной функции добавьте порядковый номер в конец имени параметра. Например, вторая использует такие параметры, как |type2=
, |id2=
и т. Д., Третья функция |type3=
, |id3=
и т. Д. И т. Д.
- тип
- Тип данных. Допустимые значения:
line
- геолинии из OSM (например, дорога)shape
- объект геоформы из OSM (например, штат или провинция)shape-inverse
- функция геомаски от OSM (инверсия геоформы - обеспечивает беспрепятственный обзор карты внизу)data
- страница данных geoJSON в Commons (параметр в этом случае необязательный)point
- точечный объект (координаты)named
- все названные координаты на странице или в разделе ( шаблоны с параметром){{coord}}
|name=
circle
- круг с центром в координатах точки
- я бы
- (или идентификаторы )
- Идентификатор Викиданных (Q-номер) точечного объекта, идентификатор Викиданных, которым отмечен объект линии / формы OSM. Разделяйте несколько идентификаторов запятой. По умолчанию используется идентификатор Wikidata текущей страницы (если
|from=
не задан). - из
- Источник картографических данных:
- Если тип является
data
или опущено: The (.map) файл в формате JSON из общин для отображения ( за исключениемData:
префикса) - Если тип является
named
: название страницы или название # раздел, чтобы получить координаты с именем из. Если опущено или указано как #section, будет использоваться текущая страница.
- Если тип является
- заглавие
- Название функции (для функций из OSM), отображаемое при нажатии на функцию; по умолчанию - заголовок страницы
- описание
- Описание функции (для функций из OSM), отображаемое при нажатии на функцию; необязательный
- цвет обводки
- (или цвет обводки )
- Цветовой код цвета, используемого для рисования объекта (для функций из OSM); по умолчанию
#ff0000
(красный) - ширина штриха
- Ширина линий, используемых для рисования объекта (для объектов из OSM); по умолчанию
6
- непрозрачность мазка
- Непрозрачность линий, используемых для рисования объекта (для объектов из OSM) - число между
0
(полностью прозрачным) и1
(полностью непрозрачным); по умолчанию1
- наполнять
- Цветовой код для цвета заливки элемента (для элементов формы или инверсии формы из OSM); по умолчанию
#000000
(черный). Обратите внимание, что полупрозрачная версия указанного цвета будет использоваться по умолчанию, позволяя видеть карту ниже. - непрозрачность заливки
- Непрозрачность для цвета заливки объекта (для объектов, обращенных к форме или инверсии формы из OSM) - число от
0
(полностью прозрачный) до1
(полностью непрозрачный); по умолчанию0.5
- согласовывать
- Координаты для отображения точечного объекта. Используйте шаблон {{ Coord }}, чтобы указать координаты (например
|coord={{Coord|12.34|S|56.78|W}}
) . Если не установлен, координаты будут извлечены из Викиданных. - маркер
- Название изображения маркера Маки для отображения на точечном объекте. См. Параметры в mw: Maps / Icons . Если не задан, будет отображаться простой маркер без изображения.
- маркер-цвет
- (или маркер-цвет )
- Цветовой код ( шестнадцатеричный триплет ), определяющий цвет фона маркера. По умолчанию
5E74F3
( ) - размер маркера
- Размер маркера. Может быть
small
,medium
(по умолчанию) илиlarge
. - радиус
- (или radius_m ), или альтернативные параметры radius_km , или radius_mi , или radius_ft
- Радиус круга. В метрах по умолчанию или в километрах, милях или футах, если используются альтернативные параметры.
- края
- Количество ребер, использованных для построения круга. По умолчанию
32
. Более высокие числа приведут к более плавному кругу, но потребуют больше ресурсов обработки Lua.
Переключатель нескольких карт
Вариант для Template: Switcher -style переключения нескольких фреймов карты, где указанные параметры, такие как масштабирование, координаты фрейма или идентификатор элемента фигуры, переключаются между различными значениями. При использовании убедитесь, что количество значений в каждом списке одинаковое.
Инструкции:
- Добавьте переключатель параметра, чтобы указать метки для различных опций: список, разделенный одним из них
,
, или;
если метки содержат запятые, или###
если метки содержат точки с запятой. Каждая метка будет отображаться с префиксом «Показать».- Пример:
|switch=zoomed out, zoomed mid, zoomed in
- Пример:
- Для каждого параметра, который должен быть переключен, установите его значение, SWITCH:а затем список значений для переключения, снова разделенных символами
,
или;
или###
- Пример:
|zoom=SWITCH:4,9,14
- Параметры frame , plain и text не должны переключаться
- Пример:
- Убедитесь, что в каждом списке одинаковое количество записей. Позиция значения в SWITCH:списке соответствует той же позиции в списке установленных меток
|switch=
.
{{mapframe | frame = yes | type = point | id = Q100 | text = Boston | zoom = SWITCH: 4,9,14 | switch = уменьшено, увеличено в середине, увеличено}}
Примеры и советы
Множественные особенности
Множество функций позволяют:
- Совместное использование внешних данных из Wikimedia Commons и OpenStreetMap
- Применение разных стилей к различным функциям внешних данных из OpenStreetMap
- Включите несколько ссылок на внешние данные из Wikimedia Commons
{{Maplink | frame = да| type = shape | id = Q3495894 | title = Shape | description = Описание формы| type2 = line | id2 = Q1318331 | title2 = Line | description2 = Описание строки| type3 = point | corre3 = {{corre | 32 | S | 116 | E}} | title3 = Point | description3 = Описание точки}}
{{Maplink | frame = yes | plain = yes | frame-width = 250 | frame-height = 280 | zoom = 6 | frame-lat = 29,185 | frame-long = 76,225| type = shape-inverse | id = Q1174 | title = Haryana| type2 = point | id2 = Q200663 | stroke-width = 3 | title2 = Фаридабад}}
Инфобоксы
Фреймы карты могут быть включены в информационные окна. |plain=yes
Рекомендуется использовать для снятия внешней рамки.
В простых случаях с одной функцией вместо нее можно использовать (подробности см. В документации этого шаблона).{{infobox mapframe}}
Mitchell Freeway | |
---|---|
Карта северных пригородов Перта с автострадой Митчелл, выделенной красным | |
Тип | Автострада |
{{Инфобокс австралийской дороги| location = {{maplink | type = line | frame = yes | plain = yes | frame-align = center | frame-lat = -31.8262 | frame-long = 115.7877 | zoom = 9}} ... (остальные параметры опущены) ...}}
Необработанный параметр
Параметр "raw" допускает те же входные данные, что и полная функция <maplink>. Это позволяет:
- Используйте данные GeoJSON напрямую
- Используйте запросы Викиданных для получения информации для карты
- Используйте шаблоны - если карта включает прямой GeoJSON или множество компонентов, размещение данных в шаблоне позволит избежать загромождения текста статьи.
См. Инструкции в mw: Help: Extension: Kartographer .
Пример Raw GeoJSON
Карта маршрута
{{maplink | raw = {{Википедия: Картографические данные / Основные дороги Западной Австралии / Форрест-Хайвей}} | text = Карта маршрута}}
(Ссылка на подстраницу данных GeoJSON: Википедия: Картографические данные / Основные дороги Западной Австралии / Форрест-Хайвей )
Примеры необработанных запросов к Викиданным
{{maplink | frame = yes | text = Десять стран | raw = { "тип": "Внешние данные", "сервис": "геошейп", "запрос": "ВЫБЕРИТЕ * ГДЕ { ? id wdt: P463 wd: Q1065.} LIMIT 10"}| ширина кадра = 600 | высота кадра = 400 | широта кадра = 25 | длина кадра = 10 | масштабирование = 1}}
{{maplink | frame = yes | raw = { "тип": "Внешние данные", "сервис": "геошейп", "запрос": "ВЫБЕРИТЕ? Id? Head (ОБРАЗЕЦ (? Img) как? Img_) (min (? partyId) как? party) (если (? party = '0', '# 800000', if (? party = '1', '# 000080', '# 008000')) как? заполнить) (concat ('[[', substr (str (? link), 31,500), '{{!}}',? headLabel, ']]') как? title) (concat (? stateLabel, '\\ n', '[[File:', substr (str (? img_), 52, 500), '{{!}} 200px]]') как? описание)КУДА { ? id wdt: P31 wd: Q35657. ? id wdt: P6? голова. «head wdt: P102» party. BIND (if (? Party = wd: Q29468, '0', if (? Party = wd: Q29552, '1', '2')) как? PartyId) СЕРВИСНАЯ викибаза: label { bd: serviceParam wikibase: language 'en'. ? head rdfs: label? headLabel. ? id rdfs: метка? stateLabel. } НЕОБЯЗАТЕЛЬНЫЙ { ? head wdt: P18? img. } Схема ссылок: about? head. Схема ссылки: isPartOf <https://en.wikipedia.org/>.} GROUP BY? Id? Head? HeadLabel? Link? StateLabel."} | ширина кадра = 600 | высота кадра = 400 | широта кадра = 52 | длина кадра = -110 | масштабирование = 3}}
Попался
- При извлечении линий или фигур из OSM вы не можете настроить цвет заливки или уровень непрозрачности заливок или обводок (если вы не используете
|raw=
параметр) - Следующий код, использующий
|raw=
параметр, не будет работать, потому что фигурная скобка, закрывающая GeoJSON, находится рядом с фигурными скобками, закрывающими шаблон:
{{Maplink | raw = {"type": "ExternalData", "service": "geoshape", "ids": "Q13518258"}}}
- Чтобы исправить это, поставьте пробел перед двумя скобками шаблона или переместите их в отдельную строку.
Учебники
- Википедия: Создание карт маршрутов из данных OpenStreetMap
- Википедия: Создание карт форм из данных OpenStreetMap
Перенаправления
- {{Ссылка на карту}}
- {{Mapframe}}
Смотрите также
- Википедия: Карты для Википедии , список картографических инструментов, доступных в Википедии.
- Шаблон: Mapbox - производная от этого шаблона, которая помещает ссылку в поле с выравниванием по правому краю.
- Шаблон: прикрепленный KML