RU:Элементы данных

From OpenStreetMap Wiki
(Redirected from RU:Data Primitives)
Jump to navigation Jump to search

Элементы данных, "data items" — это способ структурированного документирования всех метаданных OSM, таких как ключи и теги, на всех языках этой Вики, полезный как для людей, так и для инструментов.

  • Такие инструменты, как редактор iD и Taginfo, теперь могут получать информацию о тегах путем синтаксического анализа элементов данных вместо разбора вики-разметки. В конечном итоге данные могут включать переводы, предложения по тегам, правила проверки, распространенные ошибки, предустановки и многое другое.
  • Эта вики может отображать данные в виде информационных карточек и таблиц без дублирования информации и разбора сложных шаблонов.
    • Ценой внедрения нового интерфейса с увеличением сложности кода и подводными камнями.
  • Все метаданные могут быть проанализированы с помощью запросов Sophox (см. примеры запросов).

На этой странице описано как хранят структурированные метаданные тегов в этой вики, используя элементы данных, предоставленные расширением Wikibase — то же программное обеспечение, которое запускает Викиданные (начальное обсуждение). Целью этого проекта НЕ является замена вики-страниц OSM (включая информационные боксы) или использование непрозрачных идентификаторов вместо удобочитаемых строк key=value для пометки объектов. Мы всего лишь пытаемся улучшить документацию по метаданным, сделав ее более полезной для различных инструментов.

Где их найти

Элементы данных расположены в пространстве имен Item:. Каждый элемент данных имеет заголовок страницы, состоящий из "Item:" и буквы "Q", за которой следует числовой идентификатор.

Каждая страница Key: и Tag: имеет соответствующий элемент данных. Введите заголовок страницы в Special:ItemByTitle/wiki/.

Как я могу помочь?

Ищем добровольцев...  (нажмите справа, чтобы развернуть)
Добавляйте описания и переводы.
Сообщество и контент.
  • Создайте вики-портал, например, аналогичный порталу сообщества Викиданных (но более простой), где сообщество сможет:
    • предлагайте новые свойства
    • напишите рекомендаций/документы
    • обсудите структуру данных Викибазы
  • Создайте модули Lua для генерации таблиц тегов, таких как {{Template:Bridge:movable}}, {{Map Features:highway}} или {{Template:Religions}}.
    • Примечание по реализации: Викибаза связывает теги только с соответствующим ключом, но при этом ключи не перечисляют все возможные теги. Чтобы сгенерировать таблицу, у нас где-то должен быть список элементов. Мы могли бы создать новое свойство ключа в базе, в котором перечислены все теги, и использовать бота для его поддержки, или мы могли бы перечислить все необходимые теги в качестве параметра шаблона, например, для highway, {{...|автомагистраль|магистраль|первичная|вторичная/...}}. Список в качестве параметр шаблона не обязательно должен быть локализован, и он может указывать правильный порядок элементов (недоступен в Викибазе). Код Lua будет выглядеть как mw.wikibase.getEntityIdForTitle("Key:highway=motorway") чтобы найти нужные данные.
Техническая часть.
  • Добавьте поддержку Викибазы к внешним инструментам. Простейшее использование: получить локализованное описание ключа / тега. Сложное использование: позволять пользователю добавлять отсутствующее или даже редактировать существующее описание, особенно когда пользователь создает новый ключ.
  • Перенесите простые правила проверки для использования данных Wikibase, например, на основе регулярных выражений.
  • Помогите проанализировать различные таблицы данных тегов. Даже если вы можете создавать только простые файлы с данными, user:Yurik может быстро импортировать их.

Типы элементов

Ключи тегов

Каждый ключ OSM хранится в виде отдельной страница в пространстве имен Item. Например смотрите bridge:movable (Q104), который описывает bridge:movable=*:

свойство тип пример значения описание
описание текстовая строка enThe mechanism by which a movable bridge moves to clear the way below.
ukМеханізм, що приводить в дію рухомий міст для вивільнення шляху під ним.
Это основной способ описать ключ используя точные предложения. Предложения заканчиваются точкой, первое слово пишется с заглавной буквы. Не должно содержаться HTML-кода или вики-разметки. Должно быть менее 250 символов. При переводе обычно достаточно добавить только описание к элементу. Любые key:... и tag:...=... будут автоматически показаны в виде ссылок.
название текстовая строка enbridge:movable Элементы данных ключа/тега: добавляйте метки только на английском языке. Не добавляйте названия на других языках (не используйте псевдонимы).

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

Более не активный бот устанавливал английскую метку для значения ключа, точно такую же, как P16 ниже. В некоторых языках есть nativekey (локализованный ключ), который также был добавлен к меткам. Не добавляйте копию английской метки ни на какие другие языки. Обратите внимание, что так же, как и "en", локализованная метка должна быть уникальной в конкретном языке.

ссылка текстовая строка Key:bridge:movable Ссылка на страницу Key:..., даже если она не существует. Ссылка отображается в верхней боковой части страницы в качестве заголовка.
экземпляр (P2)
класс, для которого этот субъект является конкретным примером, участник (субъект обычно отдельный участник с собственным именем); отличается от P3 (подкласса)
элемент ключ (Q7) Указывает тип элемента. Q7 для ключей.
постоянный ID ключа (P16)
Строка, представляющая идентификатор ключа. После установки для ключевого элемента данных это значение никогда не должно изменяться.
текстовая строка bridge:movable Показывает точную форму ключа, используемую в OSM. Никогда не должен меняться после создания элемента. Из-за технических ограничений ключи "Key:water tap", "Key:water_tap" и "Key:water_tap_" имеют идентичные вики-страницы/ссылки — "Key:water tap". В этом случае задайте этому свойству значение в несколько строк, но отметьте одну как Preferred rank "Preferred rank".
на точках (P33)
Указывает, следует ли использовать этот ключ или тег на точках. Используйте классификатор P26, чтобы ограничиться конкретным языковым регионом. Используйте ссылку P11, чтобы ссылаться на обсуждения.

на линиях (P34)

Указывает, следует ли использовать этот ключ или тег на линиях. Используйте классификатор P26, чтобы ограничиться конкретным языковым регионом. Используйте ссылку P11, чтобы ссылаться на обсуждения.

на полигонах (P35)

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

на отношениях (P36)

Указывает, следует ли использовать этот ключ или тег в отношениях. Используйте классификатор P26, чтобы ограничиться конкретным языковым регионом. Используйте ссылку P11, чтобы ссылаться на обсуждения.
элемент применим (Q8000)
или

не применим (Q8001)

Устанавливает, разрешен ли этот ключ для точек/линий/полигонов/отношений. В будущем мы, возможно, захотим использовать другие статусы, такие как одобрено (Q15), но это пока не поддерживается. Смотрите также ограничение для каждой локали ниже.
изображение (P28)  [ подпись к изображению (P47) ]
Соответствующая иллюстрация.
[Описание для добавления к изображению на определенном языке]
текстовая строка Noexit.jpg Изображение, хранящееся либо на Викискладе (предпочтительно), либо в вики OSM, без префикса File:. Если люди в разных регионах могут распознать ключ только при использовании разных изображений, добавьте несколько изображений и обозначьте каждое изображение ограничено регионом (P48). Если изображение ключа содержит что-либо, относящееся к конкретному языку, добавьте другое значение и установите есть в языках (P26). Убедитесь, что для изображения по умолчанию установлен статус Preferred rank "Preferred rank". Используйте квалификатор подпись к изображению (P47) для указания подписи к изображению на любом языке (будет отображаться английский, если не найден, или любой другой, если EN не существует).
группа (P25)
Указывает, к какой группе относится данный тег или значение.
элемент мосты (Q4712) Группа, к которой принадлежит этот элемент. В текущей модели каждый ключ принадлежит только к одной группе. Теоретически мы могли бы использовать его для присоединения нескольких групп, изменив значение "группы" на что-то вроде "метка"/"мета-тег".
статус (P6)  [ ссылка на обсуждение (P11) ]
Статус, одобренный сообществом. Используйте ссылку на страницу обсуждения предложения (P11).
[ссылка на страницу обсуждения предлложенного ключа или тега]
элемент одобрено (Q15)
  справочная ссылка
Статус одобрения сообществом вместе со ссылкой на страницу обсуждения (не обязательно)
тип ключа (P9)
Тип сущности ключа, например, перечисляемый, внешний идентификатор. Не используйте это для групп или статусов.
элемент общеизвестные значения (Q8) Описывает тип значения этого ключа. Если существует хорошо известный список значений, используйте Q8. Другие типы — это требующие уточнения данные.
викиданные (P12)
Этот ключ или тег представляет концепцию, описанную указанным элементом Викиданных точнее, чем любой другой ключ или тег.
элемент Q787417 Ссылка на элемент Викиданных, сохраненный как внешний идентификатор (строка). Должно быть вида "Q-число".
регулярное выражение для проверки значения (P13)
Регулярное выражение для проверки правильности значения тега. Также может использоваться для имен ролей. Предполагается обертывание ^( и )$. Не используйте для перечисляемых значений, например noexit=yes должен быть тегом, а не регулярным выражением.
текстовая строка [0-9]+ Регулярное выражение, которое может быть использовано для проверки значения этого ключа. В этом случае значение должно состоять из одной или нескольких цифр. Валидаторам требуется, чтобы все выражение соответствовало строке, т.е. они добавят ^( в начале и )$ в конце.
Смотрите пример population (Q574).
Вики-страницы с документацией (P31)
Вики-страницы для этого элемента данных на разных языках. На одном языке должно быть не более одного значения. Используйте Special:SetSiteLink, чтобы установить ссылку на заголовок английской страницы элемента “ wiki ”.
многоязычная текстовая строка Key:bridge:movable (английский)

Cs:Key:bridge:movable (чешский)
...

Каждое значение — это название вики-страницы на определенном языке.

Примечание: После настройки этого свойства используйте Special:SetSiteLink, чтобы установить отсутствующую дополнительную ссылку на название страницы на английском языке на сайте wiki.

необходимый ключ или тег (P22)
один или несколько тегов или ключей, которые требуются для этого элемента
элемент
подразумевает (P45)
Любая функция с текущим ключом/тегом также подразумевает наличие этих тегов, даже если они явно не установлены.
элемент access=no (Q4822)
сочетание с (P46)
Текущий ключ/тег хорошо работает в сочетании с этими ключом/тегом (полезная комбинация).
элемент man_made=bridge (Q6694)
bridge=movable (Q5711)
смотрите также (P18)
Объект, который отличается от этого, но их часто путают. Изучите описание, чтобы понять разницу между элементами.
элемент

Значения тегов

Для ключей типа Key:highway существует список хорошо известных значений, таких как highway=residential, highway=service, highway=footway. Эти значения хранятся аналогично ключам. Смотрите bridge:movable=bascule (Q888), который описывает bridge:movable=bascule. Посмотреть на все элементы, которые ссылаются на bridge:movable.

свойство тип пример значения описание
описание текстовая строка enA type of movable bridge, a bascule bridge contains one or two spans, one end of which is free and swings upwards. A counterweight at the pivoting end of the span or spans balances the weight as the free end rises.
ruТип подвижного моста, разводной мост с одним или двумя пролетами, один конец которых свободен и может быть поднят вверх. Противовес на закрепленном конце пролета уравновешивает вес при подъеме свободного конца.
Это основной способ описать тег, используя точные описания (первое слово с заглавной буквы, заканчивается точкой). Не должно содержать никакой вики-разметки или HTML. Должно быть менее 250 символов. При переводе обычно достаточно добавить только описание к элементу. Любые key:... и tag:...=... будут автоматически показаны в виде ссылок.
название текстовая строка enbridge:movable=bascule Использование метки все еще не до конца определенно, поэтому лучше не использовать ее ни для чего. Более не активный бот устанавливал английскую метку на значение тега, точно такую же, как P19 ниже. В некоторых языках есть nativekey=nativevalue (локализованные ключ и значение), который также был добавлен к меткам. Не добавляйте копию английского названия ни в какие другие языки. Обратите внимание, что так же, как и "en", локализованная метка должна быть уникальной на этом языке.
ссылка текстовая строка Tag:bridge:movable=bascule Links to the Tag:... pages, even if the page does not exist. The sitelink is shown on top of the page on the other side as the page title. Ссылки на страницу Tag:... даже если страница не существует. Ссылка на сайт отображается в верхней части страницы рядом с заголовком страницы.
экземпляр (P2) элемент тег (Q2) Indicate the type of the item. Set to Q2 for tags. Указывает тип элемента. Установлено Q2 для тегов.
постоянный ID тега (P19) текстовая строка bridge:movable=bascule Показывает точную запись тега, используемую в OSM. Никогда не должен изменяться после создания элемента. Из-за технических ограничений теги "Tag:water tap=yes", "Tag:water_tap=yes" и "Tag:water_tap=yes_" имеют идентичные вики-страницу/дополнительную ссылку — "Tag:water tap=yes". В таком случае задайте этому свойству несколько значений, но отметьте одно как Preferred rank "Preferred rank" (маленькая стрелка вверх слева от значения).
ключ этого тега (P10) элемент bridge:movable (Q104) Каждый элемент тега ссылается на соответствующий элемент ключа, что упрощает запрос и проверку.

Теги также могут использовать на точках (P33), на линиях (P34), на полигонах (P35), на отношениях (P36), изображение (P28), группа (P25), статус (P6), регулярное выражение для проверки значения (P13), Вики-страницы с документацией (P31), подразумевает (P45). Смотрите их описание в Ключах тегов выше.

Отношения

Аналогично ключам и тегам есть пример restriction relation (Q16054), скопированный из RU:Отношения - ограничения.

свойство тип пример значения описание
описание текстовая строка ... Это основное описание отношения с использованием точных формулировок, которые заканчиваются точкой, а пишутся с заглавной буквы первого слова. Не должно содержать никакой вики-разметки или HTML. Должно быть менее 250 символов. При переводе обычно достаточно добавить только описание к элементу. Любые key:... и tag:...=... будут автоматически показаны в виде ссылок.
название текстовая строка en - restriction relation Краткое описание отношения. Не добавляйте копию английского названия ни в какие другие языки.
ссылка текстовая строка Relation:restriction Links to the corresponding Relation:... wiki page, even if the page does not exist. The sitelink is shown on top of the page on the other side as the page title. Ссылки на соответствующую вики-страницу Отношение..., даже если такая страница не существует. Ссылка на сайт отображается в верхней части страницы в строке заголовка страницы.
экземпляр (P2) элемент relation type (Q6) Указывает тип элемента. Должно быть установлено значение Q6 для отношений.
постоянный ID типа отношения (P41)
Строка, представляющая идентификатор роли, например «motorway». После установки на элемент данных отношения это значение никогда не должно изменяться.
текстовая строка restriction Показывает точную форму записи типа отношения, используемого в OSM. Никогда нельзя изменять после создания элемента. Из-за технических ограничений дополнительные ссылки "Relation:destination sign", "Relation:destination_sign", и "Relation:destination_sign_" имеют идентичную вики-ссылку — ""Relation:destination sign". В подобных случаях задайте этому свойству значения в несколько строк, но отметьте одно с помощью Preferred rank Preferred rank.
тег для этого типа отношения (P40)
Для данного элемента отношения ссылки на соответствующий элемент тега, например, type=multipolygon.
элемент type=restriction (Q16013) Каждый элемент отношения ссылается на соответствующий элемент тега type=*, что упрощает запрос и проверку.

Отношения могут также использовать изображение (P28), группа (P25), статус (P6), Вики-страницы с документацией (P31). Смотрите их описание в Ключах тегов выше.

Роли отношений

Члены отношения могут быть помечены "ролями", например, "inner" и "outer" в отношениях—мультиполигонах. Каждая роль для каждого типа отношений имеет свой собственный элемент данных. Пример для boundary=admin_centre (Q16060).

свойство тип пример значения описание
описание текстовая строка ... Это основное описание роли отношения с использованием точных формулировок, которые заканчиваются точкой и начинается с заглавной буквы первого слова. Не должно содержать никакой вики-разметки или HTML. Должно быть менее 250 символов. При переводе обычно достаточно добавить только описание к элементу. Любые key:... и tag:...=... будут автоматически показаны в виде ссылок.
название текстовая строка enboundary admin center role Краткое описание роли в отношении. Не добавляйте копию английского названия ни в какие другие языки.
ссылка текстовая строка Relation:boundary=admin centre Links to the Relation:<relation>=<role> wiki page, even if the page does not exist. If the role is empty, use Relation:relation=  form. If the role has a variable portion, e.g. route=platform:<number>, set sitelink to the fixed part -- Relation:route=platform:, and use регулярное выражение для проверки значения (P13) to validate the variable part. The sitelink is shown on top of the page on the other side as the page title.

Ссылка на вики-страницу Relation:<отношение>=<роль>, даже если страница не существует. Если роль пуста, используйте форму Relation:relation= . Если роль имеет переменную часть, например route=platform:<номер>, установите ссылку на фиксированную часть — Relation:route=platform: и используйте регулярное выражение для проверки значения (P13) для проверки переменной части. Ссылка отображается в строке заголовка страницы.

экземпляр (P2) элемент relation member role (Q4667) Указывает тип элемента. Должно быть установлено значение Q4667 для ролей членов отношений.
ID роли отношения (P21)
Строка в формате «типотношеня = роль». Должны быть установлены только по отношению к ролевым элементам. После установки на элемент роли значение никогда не должно изменяться
текстовая строка boundary=admin_centre Показывает точную форму записи роли отношения, используемую в OSM, но перед которой стоит "<relationtype>=". Никогда не должна меняться после создания элемента. Из-за технических ограничений дополнительные ссылки "Relation:boundary=admin_centre", "Relation:boundary=admin centre", и "Relation:boundary=admin_centre_" имеют идентичную вики-ссылку — "Relation:boundary=admin centre". В таком случае задайте этому свойству значение в несколько строк, но отметьте одну с помощью Preferred rank Preferred rank.
относится к типу отношения (P43)
Для заданной роли отношения (например, «inner») ссылки на соответствующий тип отношения (например «multipolygon»)
элемент boundary relation (Q16019) Каждая роль члена отношения ссылается на соответствующий элемент отношения, что упрощает запрос и проверку.
регулярное выражение для проверки значения (P13)
Регулярное выражение для проверки правильности значения тега. Также может использоваться для имен ролей. Предполагается обертывание ^( и )$. Не используйте для перечисляемых значений, например noexit=yes должен быть тегом, а не регулярным выражением.
текстовая строка platform:[0-9]+ Регулярное выражение, которое можно использовать для проверки переменной части роли. В этом случае значение должно состоять из одной или нескольких цифр, например, для роли route=platform:<номер>. Валидаторы преобразуют выражение регулярного выражения в форму ^(platform:[0-9]+)$ (для данного примера).

Роли членов отношений также могут использовать на точках (P33), на линиях (P34), на полигонах (P35), на отношениях (P36), изображение (P28), группа (P25), статус (P6), Вики-страницы с документацией (P31). Смотрите их описание в Ключах тегов выше.

Сохранение географических различий

Телефонная может выглядеть очень по-разному в зависимости от географического региона, например страны. Чтобы указать, что изображение или любое другое значение элемента данных относится к определенному местоположению, используйте определитель ограничено регионом (P48) с элементом географического региона.

A geographical region item is a data item with the экземпляр (P2) = географический регион (Q19531), and it contains a географический код (P49) property set to one or more country codes. Элемент географического региона — это элемент данных с экземпляр (P2) = географический регион (Q19531), и он содержит свойство географический код (P49), заданное для одного или нескольких кодов стран.

Квалификатор ограничено регионом (P48) должен в конечном итоге заменить квалификатор есть в языках (P26).

Сохранение различий в локали

Большинство переведенных страниц Key:... и Tag:..., как правило имеют несоответствующие параметры, такие как статус, группа или типы элементов, для которых они должны использоваться. В то же время некоторые из них в таком состоянии преднамеренно, в результате тщательной оценки местным сообществом (см. noexit (Q501)), а другие случаи просто устарели и должны быть исправлены или удалены из параметров шаблона, чтобы он мог использовать базовый элемент данных.

Все различия в локали сохраняются с использованием есть в языках (P26). Значение без уточнений используется по умолчанию. У него должен быть Preferred rank "Preferred rank", но можно сохранить Normal rank "Normal rank", когда для свойства нет других значений. Все значения, зависящие от языка, должны использовать есть в языках (P26) и иметь Normal rank "Normal rank". Каждое значение должно использоваться только один раз, возможно, с несколькими значениями квалификатора (например, свойство access:lhv (Q33) может иметь только одно применим (Q8000) и одно не применим (Q8001)). Каждый языковой классификатор может быть использован только один раз для всего свойства. Язык не должен быть указан, если он совпадает с языком по умолчанию. Если нет значения без квалификаторов, это означает, что значение по умолчанию не задано (например, английская страница не имеет параметра >).

Свойство Ранг Значение Квалификатор Значение
группа (P25) Preferred rank мосты (Q4712) нет квалификаторов Это значение используется для английской страницы и всех других языковых страниц, за исключением тех, которые явно перечислены ниже.
Normal rank свойства (Q4671) есть в языках (P26)
документ на итальянском (Q7798)
документ на финском (Q7791)
Это значение используется только для страниц на итальянском и финском языках.
Normal rank placement (Q4707) есть в языках (P26)
документ на чешском (Q7785)
Это значение используется только для чешских страниц.

Мета-элементы

Существует множество элементов данных, которые не являются ни ключом, ни тегом:

Концепты OSM
элемент (Q9), ключ (Q7), тег (Q2), статус (Q11), группа (Q12)
Статусы типа статус (Q11)
де-факто (Q13), в использовании (Q14), одобрено (Q15), на голосовании (Q17), предложено (Q20), устарело (Q5060), не рекомендуемый (Q5061), можно удалять (Q7550), импорт (Q21146)
Статусы типа применимость ключа/тега к конкретному типу элемента (Q8010)
применим (Q8000), не применим (Q8001)
Особые
концепт OSM (Q10), sandbox (Песочница) (Q2761)

Существует несколько элементов, которые не являются ни ключом, ни тегом. Например, для представления самих метапонятий должно быть несколько элементов, таких как точка, линия, полигон, отношение, ключ, тег и, возможно, другие. Все такие элементы являются подклассами мета-элемента концепт OSM (Q10).

Кроме того, мы можем захотеть пометить каждый ключ одним или несколькими значениями, например, классифицировать ключи как принадлежащие дорогам / зданиям / бизнесу / и т.д., и в этом случае эти метки также должны быть мета-элементами.

Процесс создания элемента

Бот создал все часто используемые ключи и теги, и продолжает создавать элементы когда они обнаруживаются в базе данных OSM (taginfo API) или в Викии. Бот используется для:

  • создания элемента любого ключа с более чем 10-ю вариантами использования, если он соответствует ^[a-z0-9]+([-:_\.][a-z0-9]+)*$ (т.е. последовательность одного или нескольких слов, разделенных одиночными тире, двоеточия, подчеркивания или точки, где слова содержат только строчные английские буквы и цифры), или для любых элементов с более чем 1000 вариантов использования независимо от ключевого синтаксиса (см. страница обсуждения);
  • установки названия элемента, такого же, как у ключа;
  • установки описание элемента из информационной карточки соответствующей вики-страницы (если доступно, на всех языках);
  • установки комбинируемых, рекомендуемых, подразумевающихся тегов и любых других легко определяемых данных из информационных карточек;
  • НЕ обновления каких-либо полей, измененных пользователем, например, если описание в FR было изменено пользователем, оно не должно быть изменено ботом.

В конце концов, было бы лучше, если бы инструменты OSM (iD, JOSM, ...) запрашивали у пользователя метаданные и использовали MW API для создания новых элементов.

Текущие методы создания новых элементов

  • Special:NewItem — пожалуйста, используйте Вики-поиск в пространстве имен "Item" (не добавляйте префикс "Key:" или "Tag:") и Special:ItemByTitle/wiki/ (используйте префикс "Key:" или "Tag:", например "Key:highway" или "Tag:highway=residential") при поиске, чтобы не добавлялись повторяющиеся элементы.
  • Плагин JOSM "osmwiki-dataitem" — щелкните правой кнопкой мыши на теге, "Создать новый элемент викиданных для <ключа или тега>" и следуйте инструкциям. Если отображается только "Открыть викиданные для <ключа или тега>", то элемент уже существует в вики-данных или ключ четко не определен (например, "note" или "name" не будут помечены как "P9=Q8" (тип ключа четко определен)). Плагин wikidata в настоящее время поддерживает только типы "Tag" и "Key".

Хотя плагин JOSM wikidata в настоящее время находится в альфа-версии, он добавляет больше информации, чем страница Special:ItemByTitle/wiki, поэтому в настоящее время может быть проще и лучше использовать плагин вместо страницы.

В случае, если используете Special:ItemByTitle/wiki, пожалуйста, добавьте еще следующую информацию:

Процесс удаления элемента

Элементы данных могут быть удалены вручную администраторами. Они могут удалить элемент данных, если:

  • нет вики-страницы (кроме обсуждений или страниц пользователей), которые описывают ключ/тег/отношение/..., и
  • нет предложения, связанного с элементом данных, и
  • элемент данных не подходит для создания в соответствии с процессом создания элемента.

Доступ к API и запросы

  • Самый простой способ внешнему инструменту получить все данные о ключе — использовать такой запрос API:
https://wiki.openstreetmap.org/w/api.php?action=wbgetentities&sites=wiki&titles=Key:bridge:movable&languages=en|fr
Используйте languages чтобы отфильтровать названия и описания на нужных языках.
Добавьте &format=json&formatversion=2 чтобы получить фактический JSON вместо HTML.
Из-за ограничений MediaWiki значение titles должно быть ("Key:" + key).replace('_', ' ').trim(). Используйте постоянный ID ключа (P16), чтобы получить фактический формат ключа. Убедитесь, что вы получили "предпочтительное" значение, на случай, если присутствует более одного значения. Существуют и другие действия, которые вы можете использовать при работе с элементами данных. Эти действия API можно найти в справке по API (Элементы данных) MediaWiki (найдите там строку, начинающуюся с wb, которая является сокращением для wikibase.

Отслеживание изменений в элементах данных

Чтобы отслеживать изменения в элементах данных, вы можете добавить элемент данных в Ваш Watchlist как и на любой другой странице вики. Вы также можете настроить свой Watchlist для автоматического включения изменений в элемент данных, связанный с любой просматриваемой вами вики-страницей, открыв выпадающий список "Filter changes (use menu or search for filter name)" и установив флажок "Data item edits". Чтобы сделать эти изменения постоянными, нажмите кнопку bookmark или установите флажок "Show data item edits in your watchlist" в настройках вашего списка наблюдения.

Изменения в элементах данных по умолчанию включаются в Special:RecentChanges, Special:RecentChangesLinked и Special:Watchlist. Чтобы отфильтровать все изменения в элементах данных, нажмите кнопку  Namespaces на панели фильтра, отметьте "Item" и нажмите "Exclude selected". Чтобы отфильтровать изменения в названиях, описаниях или псевдонимах, и включить изменения в инструкции, нажмите кнопку  Tags на панели фильтра, установите флажок "Данные условия элемента" и нажмите "Exclude selected". (Этот последний фильтр полезен для игнорирования переводов и реализован с помощью "фильтра злоупотреблений" и соответствующего тега.)

Чтобы сделать любое из этих изменений постоянным, нажмите кнопку bookmark.

Контроль качества

Существует несколько дополнительных расширений для валидации данных Wikibase и поиска элементов, которые не прошли проверку. Их установка может не быть выполнена на этапе первоначального развёртывания.

Обратите внимание, что из-за ограничений, перечисленных в разделе ниже, список наблюдения за элементами данных не работает. В результате небольшое число редакторов отслеживает элементы данных. В случае конфликта между данными элемента данных и данными на странице OSM Вики весьма вероятно, что элемент данных неверен.

Ограничения и известные проблемы

  • Свойства "Commons File" Викибазы пока не поддерживают файлы, хранящиеся в этой вики. Вместо этого мы используем обычное свойство string для хранения имени изображения и используем гаджет (см. ваши настройки) для отображения строк в виде изображений.
  • Ссылка на описание тега в правом верхнем углу не показывает, существует ли страница Tag:* или Key:*.
  • Все дополнительные ссылки должны содержать пробелы вместо подчеркивания. API поиска по ссылкам на сайт в противном случае не работает. Смотрите постоянный ID ключа (P16) и постоянный ID тега (P19) для получения правильного значения. Обратите внимание, что обычные страницы Mediawiki Key:* и Tag:* имеют ту же проблему, поэтому используйте специальный хак, чтобы изменить заголовок.
  • MediaWiki удаляет пробелы/подчеркивания из ключа, поэтому Key:_abc_ станет Key: abc. Нет никакой возможности иметь два элемента с дополнительными ссылками Key:_abc и Key:_abc_ — они обрабатываются как одно и то же, и терпят неудачу.
  • Заголовки элементов данных и заголовки страниц их обсуждения нечитаемы человеком, сравните Item:Q5007 и RU:Tag:amenity=shelter.
  • Номера элементов "Q" совпадают с номерами, используемыми на основном сайте Викиданных, например викиданные Q5007 и элемент данных Q5007). Несмотря на многочисленные попытки сообщества OSM и рабочую реализацию Yurik-ом, исправление этой проблемы было отклонено разработчиками программного обеспечения Wikibase. Они предполагают, что различие должно быть сделано с помощью префикса.
  • Программное обеспечение Wikibase и проект Wikidata иногда путают с элементами данных, которые в прошлом некоторые пользователи называли "викибазой" или "элементами данных wiki".

Список наблюдения

  • Добавление элемента данных в Special:Watchlist приведет к появлению дополнительных уведомлений в списке наблюдения, включая переводы на все языки. Есть способы обойти это (ЗАДАЧА: добавить инструкции по списку наблюдения).
  • Из-за этого многие опытные пользователи вики и картографы не следят за страницами элементов данных, поэтому низка вероятность того, что любые ошибки будут исправлены так же быстро, как ошибки на вики-страницах тегов и ключей.

Редактирование

Существующий опыт редактирования элементов данных следует улучшить, особенно в следующих областях:

  • Большинство элементов данных были созданы боом и ранее обновлялись ботом, если только пользователь-человек не редактировал элемент. Исходный код бота доступен, но недокументирован.
  • Редактирование элемента данных должно быть упрощено с помощью кнопки прямого редактирования со страницы ключа/тега/отношения, без перехода на саму страницу элемента данных. Экспериментальный редактор элементов данных уже может быть включен в настройках пользователя, но предстоит еще многое сделать для улучшения этой функции. (/ Исходный код)
  • В настоящее время не существует интерфейса массового редактирования, кроме написания бота. Мы должны включить инструмент Quick Statements для упрощения таких операций.
  • Существующая система размещения описания тега в двух местах (страница wiki и элементы данных) создает некоторые проблемы. Разница показана маленьким значком, и ее также можно запросить в Sophox (ЗАДАЧА: добавить ссылку на запрос здесь).
  • Пользовательский интерфейс элемента данных по-прежнему содержит некоторые ошибки, а javascript может медленно загружаться в некоторых системах, что приводит к далеко не идеальному взаимодействию. Надеюсь, эта проблема будет исправлена позже (ЗАДАЧА: ссылка на проблемы Phabricator)
  • В настоящее время невозможно скопировать содержимое элемента данных, отредактировать его вне браузера в виде текста и скопировать обратно или внести несколько изменений в элемент данных одновременно.
  • В некоторых случаях редактирование страницы статьи (например, для удаления неправильного поля из инфобокса) приведет к замене элемента данных. В результате, после того, как пользователь удалил параметр, по-прежнему отображаются те же неправильные данные. Поэтому людям, редактирующим параметры информационного поля, необходимо также редактировать элементы данных[1]
  • Редактирование элемента данных не приводит к немедленному обновлению вики-страницы, требуется ?action=purge, что сбивает с толку обычного пользователя (особенно в упомянутых выше случаях, когда страница Вики была загрязнена недопустимыми данными из элемента данных).

История

  • Использование элементов данных для создания информационных табличек (инфобоксов) приводит к запутанному представлению прежних состояний страницы, поскольку они будут отражать не состояние элемента данных на момент редактирования, а текущее состояние элемента данных.

Подавление инфобоксов

Технически возможно удалить параметры из шаблона инфобокса на страницах OSM Вики и отобразить инфобокс используя только элементы данных. Но пока нет никакой поддержки для внесения такого рода изменений (в частности Taginfo широко используется пользователями и приложениями, но умеет обрабатывать только явно указанные параметры на вики-странице, и не умеет работать с элементами данных). Такое действие может быть поддержано людьми, переводящими на данный язык.

Смотрите также

Ссылки