Шаблон: Maplink

Mapframe

Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

{{ Mapframe }}

Этот шаблон используется примерно на 15 000 страницах, и изменения могут быть широко заметны. Протестируйте изменения на подстраницах / sandbox или / testcases шаблона или на подстранице вашего собственного пользователя . Обсудите изменения на странице обсуждения, прежде чем внедрять их.

Счетчик включений обновляется автоматически ( см. Документацию ).

Этот шаблон использует Lua :

Модуль: Mapframe ( песочница )

Этот шаблон использует свойство Викиданных :

координаты местоположения (P625) (см. использование )

В этом шаблоне используется тег OpenStreetMap :

викиданные (см.обсуждение;taginfo)

Этот шаблон добавляет ссылку или фрейм, в котором будут отображаться данные карты - либо из:

данные, хранящиеся в формате 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.
Пример Mapframe

Дополнительные параметры доступны для настройки отображаемой карты, например, |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

Выше документация будет включена через от Шаблона: Maplink / дока .
Редакторы могут экспериментировать в этом шаблоне в песочнице и testcases страницы.
Добавьте категории на подстраницу / doc . Подстраницы этого шаблона .