Uk:Changeset
Набір змін — це група змін в базі даних зроблених одним користувачем за короткий проміжок часу (дивіться також: редагування).
Наприклад, якщо ви хочете додати кілька нових будинків на мапу, ви можете використати один набір змін щоб:
- Додати нову лінію (напр. нову вулицю)
- Вилучити полігон (напр. ліс було вирубано, щоб очистити ділянку для будинків)
- Змінити теґи у присутніх елементів (напр. вказати нове обмеження швидкості на наявній дорозі)
Географічний розмір наборів змін
Загальна рекомендація: набори змін повинні бути локальними.
Тисячі волонтерів переглядають сотні внесків на день (наприклад, за допомогою osmcha.org), щоб підтримувати якість мапінгу у своїй місцевості та надавати рекомендації новим маперам. Деякі архаїчні або примітивні інструменти перегляду мають обмежені можливості фільтрації, хоча вони дозволяють фільтрувати набори змін, які перекривають певні області. Розмір Bounding Box кожного набору змін визначається двома найвіддаленішими один від одного зміненими обʼєктами. При внесенні змін, які охоплюють велику географічну область, це призводить до того, що ці набори змін потрапляють до фільтрів перегляду багатьох маперів, що заважає їм зосередитися на наборах змін, які дійсно впливають на обʼєкти в межах їхньої локальної області інтересів. Як наслідок, деякі рецензенти позначають (в усьому іншому хороші) набори змін як погані лише через їхній розмір.
У спільноті немає єдиної думки щодо оптимального розміру набору змін. Деякі мапери стверджують, що набір змін не повинен охоплювати більше, ніж один континент, тоді як інші віддають перевагу наборам змін розміром не більше, ніж одне місто.
Задля уникнення конфліктних ситуацій та з почуття ввічливості до рецензентів, рекомендується:
- Обʼєднувати зміни в невеликій географічній зоні в межах (міста, району або області)
- Зберігати зміни в межах однієї й тієї ж території (країни)
- Завантажувати/зберігати зміни перед тим, як переходити до мапи в іншій області.
NB: Редактор JOSM дозволяє розбивати зміни, зроблені у великій області, при збереженнні на менші частини, щоб відповідати наведеним вище настановам і рекомендаціям.
Приклади:
- Якщо ви додаєте/змінюєте 10 обʼєктів у 2 віддалених містах — зробіть 2 набори змін, по одному на кожне місто.
- Якщо ви додаєте/змінюєте 5 обʼєктів у 5 країнах — зробіть 5 наборів змін, по 1 на країну.
Гуртуйте подібні зміни
Якщо ви вносите однотипні зміни за один сеанс редагування, в локальній місцевості краще згрупувати їх в один набір змін, а не в декілька наборів змін. Так іншим маперам буде легше переглядати зміни та консолідувати відгуки в межах одного набору змін.
Теґи наборів змін
Набори змін також мають теґи — name=value
. Переважна більшість наборів змін матимуть ці два теґи:
- comment=* — опис дій мапера, чому він зробив цю групу змін або що було змінено. В більшості програмного забезпечення (на прик. www.osm.org) цей теґ показується не як теґ, а як підсумок/заголовок (дивись знімок екрана).
Опис не є обов’язковим, але ми наполегливо радимо маперам додавати зрозумілі розширені коментарі до змін, замість автоматично створених повідомлень, через те, що вони будуть показуватись всюди де показуються набори змін і інші мапери намагатимуться дізнатись з них про вміст набору змін, про те що було зроблено. Дивіться також про Створення гарних описів наборів змін. - created_by=* — містить назву редактора або скрипту, за допомогою якого були зроблені зміни
Серед інших теґів використовуються:
- imagery_used=* — показує, які фонові шари застосовувались для мапінгу
- source=* — містить джерело походження даних, які містяться в наборі змін
- bot=yes — для автоматизованих правок, що виконуються програмами (скриптами чи ботами)
- locale=* – містить інформацію про мову, що використовувалась в редакторі (JOSM, наприклад, матиме наступне created_by=JOSM/1.5 (13367 en), де останні літери вказують на англійську мову).
- review_requested=yes – дозволяє учасникам позначати набори змін, для перевірки іншими маперами. iD та JOSM мають відповідний прапорець для додавання цього теґу, який розпізнається OSMCha (та іншими інструментами) та дозволяє швидко знаходити такі набори змін іншим маперам для їх перевірки. Дивіться також блог-пост про це.
Після версії iD 2.4.0 ці теґи додаються до наборів змін учасників:
- hashtags=* – Значення розділяються крапкою з комою, напр. “#MissingMaps;#Tanzania”
- host=* – Інтернет-адреса за якою знаходиться програма вебредактор.
- changesets_count=* – Кількість наборів змін, які мапер надіслав на сервер, “0” для тих, хто робить свою першу спробу
- ideditor:walkthrough_started=yes – якщо мапер пройшов Покрокове керівництво по роботі з вебредактором
- ideditor:walkthrough_progress=* – поступ в Покроковому керівництві
Після версії iD 2.16.0 теґи повʼязані з кількістю виправлених помилок додаються до відповідних наборів змін:
Після версії iD 2.15.0 до наборів змін додано теги, пов'язані з валідацією: ignored warning counts to the changeset tags e.g.
Дивіться також iD issue-changeset-tags Формат: {warnings|resolved}:{type}:{subtype}={count}
Після версії iD 2.13.0 ці теґи додаються до відповідних наборів змін:
- closed:note=* —id закритої нотатки/нотаток [1]
Історія змін теґів не зберігається у самих наборах змін: про це можна дізнатися з історії в цілому.
До набору змін можна також додати власні теґи. Редактори JOSM, Potlatch 2 та iD дозволяють користувачам додавати власні теґи для опису наборів змін (також придумувати власні, за потреби, так само як і для звичайних елементів даних).
Перегляд наборів змін
Розділ Історія на www.osm.org показує набори змін для області, яку ви зараз переглядаєте. Географічні межі набору змін показано помаранчевим прямокутником, який оточує всі внесені зміни. Для «ботів», які вносять багато дрібних змін на великій території, ця територія може бути досить великою (ось чому для певної області показано багато наборів змін, навіть якщо ці набори змін здаються нерелевантними[2]).
Кращі інструменти ніж просто помаранчевий прямокутик також доступні. Багато більш функціональних переглядачів наборів змін (такі як OSMCha, Achavi, Changeset by Comparison Visualization, FacilMap) доступні у вигляді через розширення у вебоглядачах, таке як OSM Smart Menu, що дозволяє відкривати набори змін в іншому іструменті з перегляду наборів змін на www.osm.org. Станом на Грудень 2023 року, OSMCha та Achavi доволі часто не могли завантажити наобри змін, що охоплюють країну середнього розміру (десь 350 000км²) і нскоріш за все навіть менші набори змін, в той час Changeset by Comparison Visualization не мав проблем з відкриванням та переглядом наборів змін, які охоплюють весь світ. Оскільки ці інструменти можуть мати різні функціональні можливості та варіанти використання, зменшення розміру наборів змін дозволяє використовувати більше різноманітних інструментів.
Сам набір змін можна отримати за його прямим посиланням: https://www.openstreetmap.org/changeset/<номер набору змін>
. Інший варіант — скористатись функцією «Отримати об’єкти», яка покаже докладну інформацію про об’єкт разом із посиланням на останній набір змін, яким властивості об’єкта було змінено.
День та час набору змін
Кожен набір змін має власну позначку часу. У вебінтерфейсі на openstreetmap.org показується скорочений запис (напр., "понад рік"). Цей напис показується підкресленим пунктиром, якщо навести вказівник миші на нього та трохи почекати буде показано точний час, коли зміни були впроваджені. Ви також можете побачити час у файлах XML: посилання на них знаходиться внизу сторінки набору змін.
Обговорення наборів змін
Обговорення наборів змін відбувається безпосередньо на сторінці з інформацією про них. В обговоренні можна привітати новачків, дати їм поради щодо їх внеску в наповнення бази даними, або ж обговорити зміни, які здаються проблематичними, з учасником який їх зробив, публічно, так що й інші члени спільноти можуть їх побачити та долучитись до обговорення. Більш докладно про можливість обговорення наборів змін дивіться допис в блозі OSM.
Трохи статистики про обговорення наборів змін:
- в розрізі країн/територій – https://resultmaps.neis-one.org/osm-discussions
- в розрізі учасників:
- набори змін з доданими коментарями – https://resultmaps.neis-one.org/osm-discussion-comments?user=USERNAME
- набори змін з відповідями – https://resultmaps.neis-one.org/osm-discussion-comments?user=USERNAME&commented
Що робити, якщо хтось залишив коментар до мого набору змін?
Інші мапери можуть звернутися до вас за розʼясненнями щодо ваших редагувань, попросити вас вказати джерело для них або вказати на помилки, яких ви припустилися.
Ви маєте майже завжди відповідати, навіть якщо ця відповідь може бути «я не знаю», або якщо ви самі виправили помилки. Публічна комунікація між маперами має вирішальне значення для побудови довіри. Редагування людей, які ніколи не відповідають, можуть сприйматися як такі, що не заслуговують на довіру.
Щоб відповісти, вам потрібно увійти в систему. Для навігації по openstreetmap.org найзручніше використовувати вебоглядач на стаціонарному компʼютері, інтерфейс може бути трохи складним для роботи на смартфоні.
Будь ласка, майте на увазі, що вас не забанять лише за те, що ви робите помилки! Ми розуміємо, що потрібен час, щоб зрозуміти, як працює OpenStreetMap. Крім того, ми можемо допомогти вам виправити будь-яку плутанину, яку ви могли спричинити своїми редагуваннями. Однак, безвідповідальні користувачі, які продовжують сумнівні редагування, незважаючи на неодноразові звернення, спочатку отримують попередження (так званий 0-денне блокування), а потім поступово довші блокування їхнього облікового запису.
Я залишив коментар до чужого набору змін, але його було проігноровано, що робити?
Якщо коментар до набору змін проігноровано, і він стосувався якості внесених змін, наприклад:
- прохання зупинити поганий мапінг(в ідеалі з поясненням, в чому проблема, та посиланням на відповідне обговорення/документацію у Вікі OSM або деінде)
- прохання пояснити, чому щось було відредаговано
- прохання виправити деякі проблемні правки, зроблені цим користувачем
і, якщо таке прохання буде проігнороване, що ж можна спробувати зробити це ще раз.
- Напишіть листа до мапера йому в Особисті повідомлення, попросіть його чи її відповісти на запити в конкретному наборі змін
- Напишіть в DWG — вони можуть надіслати повідомлення таким чином, що ви не зможете продовжувати вносити зміни допоки ви не переглянете повідомлення (0-годинне блокування, яке знімається, як тільки користувач побачив повідомлення про блокування).
Якщо ви пишете до DWG, зазвичай достатньо короткого повідомлення. Дивіться приклад нижче.
To: Data Working Group <data@openstreetmap.org> Subject: User [username] is ignoring changeset comments I commented on changeset [changeset id] made by user [username], to raise concerns about [brief explanation of why you commented on their changeset]. The user ignored me and continued to make further changes, for example: [another changeset id].
Мова в наборах змін
Якщо мапери редагують зони, більші за територію своєї країни, які охоплюють країни з різними національними мовами, будь ласка, використовуйте англійську мову. Наприклад, незвичайне редагування, яке створить рамку набору змін від Франції до Індії, зʼявиться в десятках країн між ними, тому буде доречно зробити заключні коментарі до редагування англійською мовою. Більшість тих, хто побачить редагування у своєму вікні з локальною історією змін, зрозуміє, що було додано/змінено/видалено, не вдаючись до послуг онлайн-перекладача. Якщо розглянута рамка перетинає Італію, що лежить між ними, не всі знають французьку чи гінді. Те саме стосується маперів, які зазвичай складають мапу лише у своїй країні, але в даному випадку вносять правки в іншій країні з іншою мовою. Зробіть коментар мовою іншої країни або зробіть його англійською. Насправді ніхто в Іспанії не шукає редагування з коментарем німецькою мовою.
Відкриття та закриття наборів змін
Набір змін 'відкривається' на початку сесії редагування та 'закривається' вкінці. До набору змін можуть додаватись нові правки до тих пір, доки він є відкритим. Набір змін може бути або закритий явно (дивіться в документації до вашого редактора) або закритий автоматично, якщо до нього не додаються нові правки впродовж певного часу (зараз — 1 година). Один мапер може мати кілька відкритих наборів змін одночасно. Набір змін має обмеження по об’єму (може містити до 10,000 елементів) та максимальному періоду існування (зараз — 24 години) та час очікування (нині – 1 година).
Технічна сторона
За технічними деталями звертайтесь до Документації API 0.6, де містяться всі технічні підробиці. Виклик API Get Capabilities повертає поточні обмеження, що застосовуються до наборів змін.
Набори змін були представлені в API v0.6 у квітні 2009. Для правок зроблених до цього часу набори змін були «ситезовані» під час переходу до нової версії API. (Див код міграції)
Деякі теґи раніше застосовувались тільки до елементів даних, для зазначення метаданих, що використовувались програмами-редакторами чи інструментами перевірки якості (такі, як стан завершеності, речі які треба зробити, припущення, посилання на джерела та сирці, й таке інше). Із запровадженням API версії 0.6, програми-редактори та інструменти перевірки якості мають додавати такі відомості до наборів змін, які вони створюють (а не до елементів) замість теґування кожного доданого чи зміненого елемента даних. Такі застарілі теґи на елементах даних позначено у вікі як "discardable", що означає, що вони мають автоматично прибиратись з елементів даних самими програмами-редакторами під час їх оновлення (вони все ще використовуються, але тільки для теґування самих наборів змін; їх видно в історії елементів даних, але новостворені чи оновлені елементи не повинні їх мати окрім як теґи, якими позначено набір змін).
Дамп набору змін
Ви можете знайти великий XML-файл, який містить інформацію про всі набори змін на planet.osm.org
.
Ви можете завантажити останній дамп через BitTorrent такою командою: aria2c --seed-time 0 https://planet.openstreetmap.org/planet/changesets-latest.osm.bz2.torrent
Ось ще кілька інструментів для розбору файлів наборів змін:
- Його можна імпортувати до бази даних postgresql з допомогою ChangesetMD
- … або osmchanges-postgres.
- Дамп наборів змін можна конвертувати в формат CSV за допомогою
osmchangesets2csv
Пропозиції
Тут містяться пропозиції для визначення загальних теґів для наборів змін, що можуть використовуватись для їх опису: Proposal:Changeset tags (разом з попередніми)
Дивіться також
- Документація JOSM, де пояснюється як відбувається обробка наборів змін.
- Про відкат змін з використанням втулка reverter в JOSM
- Differencing a survey from armchair mapping (Draft)
- OSM Changeset viewer tools
{{Changeset}}
— шаблон Вікі (додає номер набору змін та посилання на перегляд вказаного набору змін); Наприклад: 158665155 (achavi, OSMLab, FacilMap)
Примітки
|