Шаблон:Maplink

Mapframe

MaplinkMaplink

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

[просмотр | править | история | обновить]

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

P625:географические координаты {обс•исп}

Этот шаблон содержит незавершённый перевод с английского языка.

Вы можете помочь проекту, закончив перевод, см. также рекомендации.

Этот шаблон добавляет ссылку или рамку для отображения картографических данных, источники которых:

данные, которые хранятся в формате GeoJSON на Викискладе
объекты линия / контурный объект («полигон») (line/polygon) на OpenStreetMap.
координаты, либо добавленные извне, либо привлеченные с Викиданных
исходные данные GeoJSON, в идеале включённые с другой страницы

Примечание:

В настоящее время файлы GeoJSON невозможно загрузить напрямую. Вместо этого создайте на Викискладе страницу с данными (data) в пространстве имён Data:, которая заканчивается расширением .map — см. подробнее МедиаВики: Справка: Картографические данные.
Чтобы сделать доступными объекты OpenStreetMap (OSM), добавьте ключ идентификатор с Викиданных для этого объекта (Wikidata key) к отношению на OSM (и подождите 1-2 дня) — см. Справку расширения Kartographer в отношении внешних данных mw:Help:Extension:Kartographer#External_data и mw:Help:Extension:Kartographer/OSM.

Использование править

Этот шаблон предназначен для отображения на карте таких объектов, которые представляют собой 1. незамкнутые линии или 2. образованные замкнутыми линиями контуры либо участки поверхности — по терминологии OpenStreetMap, полигоны (от англ. polygon «многоугольник»), которыми являются, среди прочих:

Дороги (Roads)
Реки (Rivers)
Линии метро или железной дороги (Subway or train lines)
Маршруты кораблей (Ship courses)
Траектории полета (Flight paths)
Маршруты путешественников (Explorers' journeys)
Ареалы обитания животных (Animal habitats)
Страны и их административно-территориальные единицы (Countries and their subdivisions) и пр.

Этот шаблон может также использоваться для отображения точечных объектов (point features) на карте, то есть координат.

Применение править

Базовое применение

Страница данных (Data page) на Викискладе (Commons) (например, находящегося под угрозой исчезновения ареала обитания нью-мексиканской горной саламандры Plethodon neomexicanus Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):
{{maplink|from=}} (укажите название страницы данных карты (.map data page) в параметре from= ("откуда, из"), не включая само слово Data, стоящее в начале названия перед двоеточием)
Исходные данные GeoJSON (Raw GeoJSON data) (например {{Википедия:Map data/Гринвич-стрит}}):
{{maplink|raw=}} (укажите исходные (raw) данные GeoJSON, предпочтительно автоматически отображаемые с подстраницы страницы данных карты (map data) Википедия:Map data)
Линия границы или линейный объект с OpenStreetMap (OSM):
{{maplink|type=line|id=}} (Числовой идентификатор Викиданных (Wikidata id) нужно указывать только если будет использоваться страница Викиданных другой статьи)
Географический объект в виде замкнутого контура (Shape), залитого тёмным цветом внутри контура, с OpenStreetMap (OSM):
{{maplink|type=shape|id=}} (Числовой идентификатор Викиданных (Wikidata id) нужно указывать только если будет использоваться страница Викиданных другой статьи)
Географический объект в виде замкнутого контура с заливкой тёмным цветом снаружи по периметру контура (Inverted shape) с OpenStreetMap (OSM):
{{maplink|type=shape-inverse|id=}} (Числовой идентификатор Викиданных (Wikidata id) нужно указывать только если будет использоваться страница Викиданных другой статьи)
Точечный географический объект (Point feature) (координаты (coordinates)):
…из Викиданных:
{{maplink|type=point|id=}} (Числовой идентификатор Викиданных (Wikidata id) нужно указывать только если будет использоваться страница Викиданных другой статьи)

…из указанных координат:
{{maplink|type=point|coord=}} (укажите координаты с помощью шаблона {{Coord}})
Для отображения в рамке (frame) добавьте параметр |frame = yes и установите его значение yes ("да").

{{maplink|frame=yes|type=line|id=Q1094308|text=пример Mapframe }}

пример Mapframe

Для настройки отображаемой карты доступны дополнительные параметры.

{{maplink|frame=yes|plain=yes|type=line|id=Q1094308|frame-width=200|frame-height=250|frame-long=19.1009|frame-lat=47.5001|zoom=8}}

Полный набор параметров — для построения карты по данным страницы данных

{{maplink
|display=
|from=
|zoom=
|text=
|icon=
}}

Полный набор параметров — для построения карты по исходныи данным (raw data)

{{maplink
|display=
|raw= <!-- предпочтительно {{Википедия:Map data/подстраница}} -->
|zoom=
|text=
|icon=
}}

Полный набор параметров — для объектов в виде линии / замкнутого контура (geoline/geoshape)

{{maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}

Полный набор параметров — для построения карт с точечными объектами / координатами (point features/coordinates)

{{maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Параметры править

Общие параметры отображения ссылок на карты и самих географических карт, созданных с помощью этого шаблона править

display

Этот параметр задаёт то, как результат использования данного шаблона выводится на странице про нанесённый на карту географический объект. Допустимые значения данного параметра:

inline — "в тексте": на странице отображает только ссылку на карту в тексте (это является значением данного параметра по умолчанию, и это значение можно не указывать).

title — "заголовок": выводит только ссылку заголовок

inline,title — "в тексте; заголовок": задаёт отображение как ссылки заголовка, так и ссылки в тексте

title,inline — аналогично предыдущему

text: видимый текст ссылки (если задано отображение только ссылки в виде текста) (или текст подписи (caption) под отображаемым изображением карты при использовании mapframe); подпись по умолчанию «Map» ("географическая карта")
icon: "значок" для отображения значка возле ссылки. Если не хотите отображения значка, задайте значение этого параметра «no» ("нетт")
zoom: масштаб карты. Допустимые значения от 1 до 19 (более крупные числа больше увеличивают изображение); значение по умолчанию определяется автоматически самой картой
(помните, что автоматически определяемый масштаб не работает в отношении карт, отображаемых с помощью шаблона mapframe, кроме режимы предварительного просмотра страницы – см. phab:T193455)

Параметры Mapframe (работают только при отображении в тексте (inline display))

frame

"рамка" (отображение карты): установите значение этого параметра в виде «yes» ("да") для отображения на нужный вам страницы самой карты вместо ссылки на карту.

plain: "простая": установите у этого параметра значение «yes» ("да") для вывода только самого изображения карты без рамки вокруг него и без подписи (caption) к карте (при таком значении этого параметра параметр text будет проигнорирован)
frame-align: "положение изображения (карты на странице)". Выравнивание по отношению к странице (положение на странице): left слева, center по центру, либо right справа; значение по умолчанию задано right справа
frame-width: ширина изображения карты; значение по умолчанию задано 300
frame-height: высота изображения карты, значение по умолчанию задано 200
frame-coordinates: (или frame-coord); координаты изображения карты. Этот параметр не является обязательным; он задаёт координаты центра карты. Для указания координат используйте шаблон {{Coord}} (например, |frame-coordinates = {{Coord|12.34|S|56.78|W}}). Если они не заданы таким образом, координаты будут извлечены из Викиданных.
frame-latitude: (или frame-lat); географическая широта карты. Этот параметр не является обязательным — он задаёт альтернативное координаты широты для первоначального размещения карты
frame-longitude: (или frame-long); географическая долгота карты. Этот параметр является необязательным; он задаёт альтернативную координаты долготы к первоначальному размещению карты

Обратите внимание: Если для границы отображаемой карты широта и долгота не заданы с помощью параметров, в таком случае они будут определены автоматически одним из следующих способов:

будут использоваться координаты из параметра |coord = для линейных и контурных объектов на карте (если они заданы именно таким образом), либо
Использованы координаты точечного географического объекта, либо
будут привлечены координаты из Викиданных (если они там доступны, так как либо объект указан с помощью параметра числового идентификатора Викиданных |id =, либо для страницы, на которую помещается данный шаблон)

overlay

наложение, врезка карты. Изображение или другая карта (обычно меньшего размера) для отображения в режиме наложения на э основную карту (на её часть). Например

|overlay = [[File:Example.svg|140x140px]] или; |overlay = {{maplink|frame=yes|plain=yes|frame-width=100|frame-height=100|type=shape|id={{get QID|French submarine Ariane (1914)}}|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}}; (см. примеры использования наложения в данном шаблоне в английской Википедии)
overlay-horizontal-alignment: выравнивание наложения по горизонтали, положения либо left слева, либо right справа; по умолчанию значение right справа
overlay-vertical-alignment: выравнивание наложения по вертикали, либо top сверху, либо bottom снизу; значение по умолчанию bottom снизу
overlay-horizontal-offset и overlay-vertical-offset: отступ наложенного изображения, врезки. Необязательный параметр: количество пикселей для создания отступа врезки от края карты, например 10 для создания отступа в 10 пикселей
overlay-border: граница наложения, врезки. Стиль CSS в отношении линии границы, например толщина линии 3 пикселя при сплошной чёрной линии указывается как 3px solid black; по умолчанию предусмотрена сплошная белая линия толщиной в 1 пиксель 1px solid white. Можно указать любой HTML-цвет линии с помощью его названия (name) или шестнадцатеричного кода (hex code).

Raw GeoJSON править

raw: Raw GeoJSON (preferably transcluded from a subpage of Wikipedia:Map data) as well as <maplink> functionality not available via the other parameters. See below for more information.

For each feature править

Multiple features can be displayed on a single map. For each additional feature, add a sequential number to the end of the parameter name. For example, the second uses parameters like |type2 =, |id2 =, etc., the third feature |type3 =, |id3 =, etc., and so on.

type

Type of data. Valid values are:

line — a geoline feature from OSM (e.g. a road)

shape — a geoshape feature from OSM (e.g. a state or province)

shape-inverse — a geomask feature from OSM (the inverse of a geoshape — allows an unobstructed view of the map beneath)

data — a geoJSON data page on Commons (parameter is optional in this case)

point — a point feature (coordinates)

id: (or ids); Wikidata id (Q-number) of the point feature, Wikidata id that the OSM line/shape feature is tagged with. Separate multiple ids with a comma. Defaults to the current page’s Wikidata id (if |from = not set).
from: The JSON (.map) file from Commons to display (excluding the Data: prefix)
title: Title of the feature (for features from OSM), displayed when the feature is clicked on; default is the page title
description: Description of the feature (for features from OSM), displayed when the feature is clicked on; optional
stroke-color: (or stroke-colour); Color code for the color used to draw the feature (for features from OSM); default is #ff0000 (red)
stroke-width: Width for the lines used to draw the feature (for features from OSM); default is 6
coord: Coordinates to display for a point feature. Use {{Coord}} template to specify coordinates. If not set, coordinates will be retrieved from Wikidata.
marker: Name of Maki marker image to display at the point feature. See mw:Maps/Icons for options. If not set, a plain marker will be shown without an image.
marker-color: (or marker-colour); Color code (Hex triplet) specifying marker background color. Default is 5E74F3 ( )

Examples and tips править

Multiple features править

Multiple features allow you to:

Use external data from both Wikimedia Commons and OpenStreetMap together
Apply different styles to different external data features from OpenStreetMap
Include multiple links to external data from Wikimedia Commons

Map

{{Maplink|frame=yes
|type=shape|id=Q3495894|title=Shape|description=Description of shape
|type2=line|id2=Q1318331|title2=Line|description2=Description of line
|type3=point|coord3={{coord|32|S|116|E}}|title3=Point|description3=Description of point
}}

{{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=Faridabad
}}

Infoboxes править

Mapframes can be included in infoboxes. Using |plain = yes to remove the outer frame is recommended.

For simple cases with a single feature, {{infobox mapframe}} can be used instead (see that template’s documentation for details). {{[[:Template:Infobox Australian road |Infobox Australian road ]]|road_name=Mitchell Freeway|type=freeway|show_links=no|loc_caption=Map of Perth's northern suburbs with Mitchell Freeway highlighted in red|location=}}

{{Infobox Australian road
| location = {{maplink |type=line |frame=yes |plain=yes |frame-align=center |frame-lat=-31.8262 |frame-long=115.7877 |zoom=9}}
  ...  (other parameters omitted)  ...
}}

The raw parameter править

The «raw» parameter allows the same inputs as the full <maplink> function. It allows you to:

Use GeoJSON data directly
Use Wikidata queries to obtain information for the map
Use templates — if a map includes direct GeoJSON or many components, placing the data in a template will avoid cluttering the article text

See mw:Help:Extension:Kartographer for instructions.

Raw GeoJSON example править

Route map

{{maplink|raw={{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=Route map}}

(Link to GeoJSON data subpage: Википедия:Map data/Гринвич-стрит)

Raw Wikidata query example править

Map

{{maplink|frame=yes|raw={
  "type": "ExternalData",
  "service": "geoshape",
  "query": "
SELECT ?id ?head
  (SAMPLE(?img) as ?img) 
  (min(?partyId) as ?party) 
  (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill)
  (concat('[[', substr(str(?link),31,500),  '{{!}}', ?headLabel, ']]') as ?title)
  (concat(?stateLabel, '\\n', '[[File:', substr(str(?img), 52, 500), '{{!}}200px]]') as ?description)
WHERE {  
  ?id wdt:P31 wd:Q35657 .
  ?id wdt:P6 ?head .
  ?head wdt:P102 ?party .
  BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId) 
  SERVICE wikibase:label {
    bd:serviceParam wikibase:language 'en' .
    ?head rdfs:label ?headLabel .
    ?id rdfs:label ?stateLabel .
  }
  OPTIONAL {
    ?head wdt:P18 ?img .
  }
  ?link schema:about ?head .
  ?link schema:isPartOf <https://en.wikipedia.org/> .
} GROUP BY ?id ?head ?headLabel ?link ?stateLabel
"}|frame-width=600|frame-height=400|frame-lat=52|frame-long=-110|zoom=3}}

Gotchas править

When retrieving lines or shapes from OSM, you can’t style the fill color or the opacity level of fills or strokes (unless you use the |raw = parameter)
The following code utilising the |raw = parameter won’t work because the curly brace to close the GeoJSON is adjacent to the curly braces to close the template:

{{Maplink|raw= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}

To fix it, put a space before the two template braces or move them to a separate line.