wiki:Ru:Help/Action/Upload

Version 26 (modified by ak099, 12 days ago) (diff)

обновил до ревизии 57

Другие языки:

Файл > Передать данные на сервер

source:trunk/images/upload.png Сочетание клавиш: Ctrl+Shift+↑
Отправляет новые, изменённые и удалённые объекты в текущем слое данных на сервер.

Редактируемые в JOSM геоданные доступны только локально и только тому пользователю, который их редактирует, пока этот пользователь не решит сделать эти данные доступными и другим участникам сообщества. Для того, чтобы опубликовать данные, их нужно передать на сервер. Это означает, что геоданные передаются на центральный сервер, управляемый сообществом OSM, где они объединяются с геоданными других картографов в централизованной базе данных. Именно в результате передачи на сервер отредактированные локально геоданные становятся частью основной базы данных и общедоступной карты на osm.org, и могут быть использованы другими участниками сообщества OSM.

Простыми словами

  • (Как и в онлайн-редакторах типа iD или Potlatch), необходимо передать сделанные вами изменения на сервер OSM. Убедитесь, что у вас установлено соединение с сервером :-)
  • Вы можете обнаружить конфликты при отправке изменений (в большинстве случаев это означает, что вам необходимо выбрать, какие из тегов оставить на ваших объектах)
  • Чтобы уменьшить вероятность возникновения конфликта:
    • не редактируйте данные, которые в это же самое время редактируют другие пользователи
    • уменьшите время между скачиванием и отправкой данных, чтобы временная рамка вашего редактирования не перекрывалась с редактированием другого пользователя
  • (Примерная идея), как полностью избежать конфликта: не редактируйте объекты с тем же id и не меняйте их родительские связи (точка-линия, линия-отношение и отношение-отношение). Если вы (и другой редактор) правите непересекающиеся наборы данных, то конфликтов вообще не возникнет. Это означает, что следует учитывать также все родительские линии и все родительские отношения (которые, весьма вероятно, могут меняться).
  • (В отличие от онлайн-редакторов типа iD или Potlatch), вам не обязательно отправлять данные немедленно (вы можете сохранить файл вручную, но автосохранение подстрахует вас от потери данных)
  • (В отличие от любого другого редактора?) JOSM позволяет отправлять изменения в уже открытый (но не закрытый) пакет правок (см. Несколько запросов в одном пакете правок). Каждый открытый пакет правок "закрывается" автоматически сервером http://openstreetmap.org через 1 час.

Пакеты правок, запросы на загрузку, и стратегии загрузки

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

В проекте ОСМ каждая такая группа называется пакетом правок. Пакет правок это набор связанных изменений (добавлений, изменений или удалений объектов) применяемый к данным ОСМ.

Пакеты правок отличаются от запросов на загрузку. Пакет правок это логическое объединение объектов, тогда как запрос на загрузку это техническое объединение для передачи геоданных на сервер ОСМ. Терминологии JOSM объекты загружаются на сервер с помощью запросов на загрузку в пакет правок. Диалог загрузки данных JOSM позволяет настраивать параметры запросов на загрузку и пакетов правок. Некоторые из параметров обязательные (т.е пользователь должен настроить чтобы загрузить геоданные), но большинство не требуют настройки и JOSM нормально работает со значениями по умолчанию.

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

Один запрос на загрузку в один пакет правок

В наиболее простом случае пакет правок состоит из единственного запроса на загрузку:

Это стандартная конфигурация, используемая редактором JOSM. Она лучше всего подходит для

  • загрузки результатов обработки нескольких GPS треков
  • загрузки результатов пары часов трассировки спутниковых снимков
  • добавления информации о точках интереса, названий улиц и других данных, известных пользователю

Несколько запросов в одном пакете правок

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

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

Так же JOSM пока поддерживает загрузку каждого объекта отдельным запросом.

Пожалуйста, помните что это устаревшая возможность. До недавнего времени это был единственный режим загрузки данных в ОСМ. С технической точки зрения, он использует немного другой способ работы с ОСМ сервером. Этот вариант все еще не удален из редактора, хотя сервер ОСМ теперь способен загружать запросы объемом до 50,000 объектов. Для обычных пользователей загрузка отдельным запросом фактически бесполезна, и может потребоваться лишь в редких случаях продвинутым пользователям.

Загрузка больших объемов данных в несколько пакетов правок

JOSM умеет загружать большие объемы данных, не помещающиеся в один набор правок.

Это расширенная возможность, полезная продвинутым пользователям, которые желают загрузить пакет правок содержащий более 50,000 изменений.

Выбор стратегии загрузки - когда и как часто

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

Несколько полезных правил для выбора стратегии:

  • Загрузка требует времени: чем меньший размер запроса на загрузку вы выбрали, тем дольше будет загрузка. Время на загрузку 100 объектов при загрузке индивидуальными запросами больше чем одним, содержащим 100 объектов.
  • Конфликты с другими мапперами: если вы загружаете 30,000 объектов одним запросом, а сервер обнаруживает конфликт на 29,999 объекте, весь запрос будет отвергнут. Затем вам придется разрешить конфликт, и снова загрузить все 30,000 объектов. С другой стороны, если 30,000 объектов загружается 30 запросами по 1000 объектов каждый, то, в случае коллизии на 29,999-ом, после исправлений нужно будет загрузить только последнюю 1000 объектов. Предыдущие 29,000 уже на сервере. Если вы работаете над областью, где активны другие пользователи, лучше выбрать меньший размер запроса на загрузку.

Загрузка данных

Диалоговое окно Передать данные на сервер

  • Сочетание клавиш: Ctrl+Shift+↑
  • Пункт меню Файл->source:trunk/images/upload.png Передать данные на сервер
  • Кнопка на панели инструментов source:trunk/images/upload.png

Проверки перед отображением диалога

Перед тем, как отобразится диалог передачи данных, все измененные объекты проверяются валидатором, который покажет вам список обнаруженных ошибок и предупреждений. У вас будет выбор - вернуться в редактор для исправления ошибок, либо все равно попытаться выгрузить данные. Проверки JOSM зачастую избыточны, но не игнорируйте их не глядя, по крайней мере попытайтесь исправить ошибки.

Редактор так же проверяет ограничения данных, накладываемые сервером ОСМ:

  • имена и значения ключей должны быть короче 255 символов
  • количество точек в линии ограничено

Если объекты, которые вы загружаете имеют циклические ссылки (отношение 1 ссылается на отношение 2, отношение 2 ссылается на отношение 3, а 3 - в свою очередь, ссылается на 1), редактор откажется их загружать и предложит исправить ошибку.

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

Диалог Передать данные

Диалог передачи данных состоит из двух областей:

  • верхняя часть показывает сводку по новым, измененным и удаленным объектам которые будут загружаться на сервере
  • в нижней части находятся вкладки с настройками процесса загрузки

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

Простая загрузка данных

Описана в Отправка данных на сервер OSM.

Передача данных с дополнительными параметрами

Добавление тэгов к пакету правок

Геоданные загружаемые на сервер ОСМ всегда загружаются в пакет правок. Так же как в случае с точками, линиями и отношениями пакету правок могут быть присвоены тэги.

В диалоге передачи данных пользователь может ввести тэги пакета правок во вкладке c таким названием:

Полезные правила

  • Тэги - ваши друзья. Опишите с их помощью гео данные которые вы отправляете на сервер OSM.
  • Используйте ключ source чтобы описать источник ваших правок (например: нарисовано по снимку Bing, по данным GPS треков и поездки на велосипеде).
  • Не нужно добавлять в тэги ваше имя пользователя. На сервере ОСМ автоматически сохраняется связь между пакетами правок и создавшими их пользователями.

Заметьте, что обязательный комментарий к загружаемым данным это тоже тэг. Его можно ввести как во вкладке с тэгами (ключ comment), так во вкладке с базовыми настройками.

Выбор пакета правок для загрузки

Во вкладке Пакеты правок вы можете выбрать, в какой пакет правок будут помещены ваши данные:

По умолчанию JOSM загружает объекты в новый пакет правок. Если вы хотите загрузить объекты в уже существующий пакет правок, вы можете выбрать существующий пакет правок из раскрывающегося списка. Этот пункт разблокируется только в том случае, если у вас есть открытые пакеты правок. Нажмите на source:trunk/images/dialogs/refresh.png Обновить чтобы загрузить с сервера список доступных вам открытых пакетов. Если хотя бы один незакрытый пакет правок существует, вы сможете установить переключатель в положение Выбрать пакет правок, и задать номер пакет из списка.

Вы также можете установить галочку source:trunk/images/closechangeset.png Закрыть пакет правок после передачи на сервер чтобы закрыть пакет правок по завершению загрузки. Устанавливать ее не обязательно для успешной загрузки, вы можете оставить пакет правок открытым. По умолчанию данная функция включена.

Выбор количества и размера запросов на загрузку

JOSM передает геоданные одним или несколькими запросами на загрузку в пакет правок на сервере OSM. На вкладке Расширенные вы можете задать количество и размер запросов на загрузку, см. рис:

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

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

Такая загрузка множественными запросами как правило занимает больше времени чем загрузка единственным запросом. Чтобы загрузить каждый объект индивидуальным запросом выберите Передать на сервер по одному объекту. Вы увидите очень подробный отчет о ходе загрузки каждого изменения, но это самый медленный вариант передачи данных.

Рекомендации

  • Для пакетов до 5,000 объектов выбирайте Передать данные за один запрос
  • Для пакетов более 5,000 объектов хороший вариант использовать Передачу по частям с размером одной части в 1,000 объектов.
  • Не используйте режим Передать на сервер по одному объекту без особых на то причин. Это устаревший вариант для работы со старыми версиями сервера ОСМ.

Как загрузить очень большие данные

Набор данных считается очень большим если он превышает максимальный размер пакета правок, поддерживаемый ОСМ сервером. На данный момент этот размер составляет 50,000 объектов. Если редактор обнаружит что ваши изменения больше этого предела, вы увидите следующее сообщение:

Это означает, что загрузка не пройдет без настройки дополнительных параметров. Переключитесь во вкладку Расширенные настройки или нажмите на ссылку в сообщении. Вы увидите такие параметры:

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

Очень большой набор не войдет в один пакет правок. Выберите один из вариантов:

  • JOSM автоматически создаст необходимое количество новых пакетов правок. Вмешательство пользователя не потребуется.
  • JOSM передаст на сервер один полный пакет правок и затем отобразит диалог Передача данных. В этом варианте у вас будет полный контроль за созданием пакетов правок для загрузки.

Ошибки и предупреждения

Выгрузка в закрытый пакет правок

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

В таком случае JOSM отобразит ошибку:

Как исправить

  • Снова запустите диалог Передача данных
  • Выберите другой открытый пакет правок или создание нового пакета
  • Повторите передачу

Переполнение пакета правок в процессе передачи

Существует предел размера пакета правок. В текущий момент ОСМ сервер поддерживает объем пакета в 50,000 правок. Если вы несколько раз передаете данные в один открытый пакет правок, вы можете превысить этот предел и увидеть такое сообщение:

Как исправить

  • Кнопка Продолжить передачу на сервер создаст необходимое количество новых пакетов правок и продолжит процесс
  • Выбор Вернуться к Диалогу передачи на сервер позволит вам выбрать другой открытый пакет правок чтобы выгрузить оставшиеся объекты.
  • Прервать отменит передачу данных и вернет вас в основное окно редактора.

Удаление точек которые еще используются

Если вы в ходе редактирования удаляли точки, в процессе передачи данных сервер ОСМ проверит, не используются ли они какими-либо существующими линиями. Перед удалением точки нужно убедиться, что она изолированная (не является частью какой-либо линии или не состоит в каком-либо отношении).

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

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

После этого повторите передачу данных. Исправленный набор данных успешно выгрузится на сервер.

См. также


Назад к разделу Меню Файл
Назад на Основную страницу Справки