Методические рекомендации по публикации открытых данных государственными органами и органами местного самоуправления, а также технические требования к публикации открытых данных. Версия 3.0

(утв. протоколом заседания Правительственной комиссии по координации деятельности Открытого Правительства от 29.05.2014 № 4)

МЕТОДИЧЕСКИЕ РЕКОМЕНДАЦИИ ПО ПУБЛИКАЦИИ ОТКРЫТЫХ ДАННЫХ ГОСУДАРСТВЕННЫМИ ОРГАНАМИ И ОРГАНАМИ МЕСТНОГО САМОУПРАВЛЕНИЯ, А ТАКЖЕ ТЕХНИЧЕСКИЕ ТРЕБОВАНИЯ К ПУБЛИКАЦИИ ОТКРЫТЫХ ДАННЫХ

ВЕРСИЯ 3.0

1. Термины и определения

Абстрактная модель — модель, отражающая общие характеристики моделируемого явления. Данный тип модели представляет информацию о качественных характеристиках моделируемого объекта или явления.

Востребованный набор открытых данных — опубликованный набор открытых данных, пользующийся популярностью у пользователей.

Сводный реестр наборов открытых данных — реестр, ведущийся уполномоченным органом государственной власти Российской Федерации, содержащий сведения обо всех реестрах наборов открытых данных государственных органов и органов местного самоуправления Российской Федерации, а также сведения об иных востребованных реестрах и наборах открытых данных.

Интерфейс прикладного программирования (API) — набор готовых классов, функций, структур и констант, предоставляемых приложением (библиотекой, сервисом) для использования во внешних программных продуктах.

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

Метаданные (метаинформация) — структурированная информация, описывающая, разъясняющая, а также позволяющая находить или иным способом упрощать извлечение, использование или управление информационными ресурсами <1>.

<1> NISO 2004, ISBN: 1-880124-62-9, http://www.niso.org/publications/press/UnderstandingMetadata.pdf.

Набор открытых данных (набор данных) — совокупность однородных элементов машиночитаемых данных и описывающей их метаинформации.

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

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

Опубликование (публикация) — размещение информации в сети «Интернет» для обеспечения доступа к ней неопределенного круга лиц.

Открытые данные — информация, размещенная в сети «Интернет» в виде систематизированных данных, организованных в формате, обеспечивающем ее автоматическую обработку без предварительного изменения человеком, в целях неоднократного, свободного и бесплатного использования.

Открытые государственные данные — открытые данные, опубликованные государственными органами, их территориальными органами, органами местного самоуправления или организациями, подведомственными государственным органам, органам местного самоуправления.

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

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

Потребитель открытых государственных данных (конечный потребитель) — субъект российской или международной юрисдикции, имеющий намерение и полное право использовать Открытые государственные данные в соответствии с Открытой Лицензией.

Портал открытых данных Российской Федерации — комплексная государственная информационная система, которая реализует функцию предоставления неограниченному кругу лиц доступа к реестру наборов открытых данных органов государственной власти Российской Федерации, органов местного самоуправления и организаций, действующих на территории Российской Федерации, а также иные функции, обеспечивающие реализацию политики Российской Федерации в области публикации открытых данных.

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

Раздел открытых данных на официальном сайте — раздел сайта официального органа государственной власти или органа местного самоуправления по вопросам публикации открытых данных.

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

Реестр наборов открытых данных государственного органа или органа местного самоуправления — реестр наборов открытых данных, включающий сведения о наборах открытых данных соответствующего государственного органа или органа местного самоуправления.

Связанные данные (Linked Data) — метод публикации структурированных данных, предусматривающий стандартизированное именование и связывание данных в целях обеспечения автоматической идентификации, обработки и преобразования информационными системами, соответствующий принципам связывания данных <1>.

<1> http://www.w3.org/DesignIssues/LinkedData.html.

Совет по открытым данным — рабочая группа при Правительственной комиссии по координации деятельности открытого правительства, созданная по решению Правительственной комиссии по координации деятельности открытого правительства от 28 февраля 2013 г. (протокол № 1).

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

Система управления содержимым (CMS) — информационная система, используемая для обеспечения и организации совместного процесса создания, редактирования и управления содержимым сайта (например, Joomla, WordPress, Drupal).

CSV <1> — (Comma-Separated Values — значения, разделенные запятыми) — текстовый формат, предназначенный для представления табличных данных. Каждая строка файла — это одна строка таблицы. Значения отдельных колонок отделяются друг от друга установленным в системе разделительным символом (delimiter).

<1> http://www.rfc-editor.org/rfc/rfc4180.txt.

HTML+Microdata <1> — Микроданные <2> (англ. microdata) — совокупность методов семантической разметки данных с использованием элементов языка HTML. Обеспечивает возможность автоматического считывания включенной в HTML-документ атрибутивной информации при сохранении стандартной функциональности (визуального просмотра документа с использованием браузера).

<1> http://www.w3.org/TR/microdata/.

<2> http://www.w3.org/TR/microdata/.

HTML+RDFa <1> — (RDF in attributes) — запись внутри атрибутов произвольного HTML-документа. Пользователь-человек может воспринимать размеченную страницу как обычную веб-страницу (через браузер); в то же время программы-обработчики способны извлечь из такой страницы структурированную информацию, следуя определенным соглашениям.

<1> http://www.w3.org/TR/rdfa-syntax/, http://www.w3.org/TR/rdfa-in-html/.

JSON <1> — (JavaScript Object № otation) — текстовый формат обмена данными, основанный на JavaScript и обычно используемый именно с этим языком. Как и многие другие текстовые форматы, JSON легко читается людьми.

<1> http://json.org/json-ru.html.

RDF — (Resource Description Framework) <1> — модель, разработанная Консорциумом Всемирной паутины (W3C) для представления данных, в особенности — метаданных. RDF представляет сведения о ресурсах в пригодном для машинной обработки виде.

<1> http://www.w3.org/RDF/.

XML <1> — (eXtensible Markup Language — расширяемый язык разметки) — язык разметки, рекомендованный Консорциумом Всемирной паутины (W3C). Спецификация XML описывает XML-документы и частично описывает поведение XML-процессоров (программ, читающих XML-документы и обеспечивающих доступ к их содержимому).

<1> http://www.w3.org/TR/xml11/.

2. Целевая аудитория

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

Методические рекомендации накладывают обязательства перед ответственными представителями за публикацию открытых данных государственных органов или органов местного самоуправления в соответствии с требованиями Федерального закона от 27 июля 2006 г. № 149-ФЗ «Об информации, информационных технологиях и о защите информации» и Федерального закона от 9 февраля 2009 г. № 8-ФЗ «Об обеспечении доступа к информации о деятельности государственных органов и органов местного самоуправления» с учетом изменений, внесенных Федеральным законом от 7 июня 2013 г. № 112-ФЗ. Методические рекомендации основываются на принципах Хартии открытых данных «Группы восьми», принятой 18 июня 2013 года <1>.

<1> http://открытыеданные.большоеправительство.рф/upload/iblock/d89/d89ed307269b705c22da23dcbfb72c54.pdf.

В иных случаях Методические рекомендации служат руководством для всех желающих публиковать информацию в виде открытых данных на территории Российской Федерации на добровольной основе.

Методические рекомендации будут интересны тем, кому требуется общее понимание процедуры размещения открытых государственных данных на территории Российской Федерации и принципы работы при их публикации.

3. Определение наборов открытых данных и приоритетности их публикации

Опубликованию в форме открытых данных подлежат сведения, содержащие информацию о деятельности государственных органов и органов местного самоуправления, размещаемую в сети «Интернет» в соответствии с Федеральным законом от 9 февраля 2009 г. № 8-ФЗ «Об обеспечении доступа к информации о деятельности государственных органов и органов местного самоуправления», а также сведения, содержащие информацию, собираемую, хранимую, обрабатываемую или публикуемую государственными органами или органами местного самоуправления в рамках реализации своих полномочий.

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

а) востребованность соответствующих наборов открытых данных потенциальными потребителями информации, оцениваемую в соответствии с методикой мониторинга и оценки востребованности открытых данных;

б) степень готовности, характеризующуюся наличием необходимых данных в электронном виде, а также готовностью организационных, технических, технологических и иных средств, необходимых для опубликования наборов открытых данных;

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

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

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

При формировании как реестра наборов открытых данных, так и самих наборов открытых данных, следует учитывать:

а) публикации подлежат первичные данные, не подвергнутые предварительной обработке;

б) для каждого набора данных должно быть определено должностное лицо, ответсвенное по вопросам публикации открытых данных;

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

Сформированный реестр открытых данных утверждается государственным органом или органом местного самоуправления и подлежит публикации на официальном сайте органа в сети «Интернет» <1>.

<1[1]> Пример реализации реестра приведен в Приложении 4.

<1[2]> http://www.w3.org/TR/xmlschema-0/.

4. Условия использования открытых данных

4.1. Требования к условиям использования открытых данных

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

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

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

Условия использования должны предполагать безвозмездное предоставление открытых данных.

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

Рекомендуется при публикации открытых данных использовать открытую лицензию, содержащую требования, приведенные в разделе 4.3 настоящих методических рекомендаций, или требования, соответствующие международным лицензиям Creative Commons <1> или Open Data Commons <2>.

<1> http://creativecommons.org/licenses/.

<2> http://opendatacommons.org/licenses/.

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

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

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

Основные нормативные правовые акты, регламентирующие публикацию открытых данных:

Федеральный закон от 9 февраля 2009 г. № 8-ФЗ «Об обеспечении доступа к информации о деятельности государственных органов и органов местного самоуправления»;

Федеральный закон от 27 июля 2006 г. № 149-ФЗ «Об информации, информационных технологиях и о защите информации» (далее — Федеральный закон № 149-ФЗ);

постановление Правительства Российской Федерации от 10 июля 2013 г. № 583 «Об обеспечении доступа к общедоступной информации о деятельности государственных органов и органов местного самоуправления в информационно-телекоммуникационной сети „Интернет“ в форме открытых данных»;

постановление Правительства Российской Федерации от 24 ноября 2009 г. № 953 «Об обеспечении доступа к информации о деятельности Правительства Российской Федерации и федеральных органов исполнительной власти»;

приказ Минкомсвязи России от 27 июня 2013 г. № 149 «Об утверждении Требований к технологическим, программным и лингвистическим средствам, необходимым для размещения информации государственными органами и органами местного самоуправления в сети „Интернет“ в форме открытых данных, а также для обеспечения ее использования»;

распоряжение Правительства Российской Федерации от 10 июля 2013 г. № 1187-р (О Перечнях информации о деятельности государственных органов, органов местного самоуправления, размещаемой в сети «Интернет» в форме открытых данных).

4.2. Ограничения на использование государственной информации

В соответствии с частью 5 статьи 7 Федерального закона № 149-ФЗ информация в форме открытых данных, составляющая государственную тайну, не подлежит публикации и распространению.

Ограничение доступа к информации устанавливается федеральными законами в целях защиты основ конституционного строя, нравственности, здоровья, прав и законных интересов других лиц, обеспечения обороны страны и безопасности государства (часть 1 статьи 9 Федерального закона № 149-ФЗ).

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

4.3. Рекомендации по использованию открытой лицензии

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

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

Потребитель открытых данных вправе:

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

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

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

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

5. Технологическая инфраструктура

Государственная информация, подлежащая опубликованию в виде набора открытых данных или гиперссылок на соответствующие наборы данных, должна размещаться на официальных сайтах <1> государственных органов или органов местного самоуправления, являющихся обладателями информации. Вместе с тем, существует следующий перечень возможных <2> способов публикации наборов открытых государственных данных:

<1> Официальный сайт должен сохранять соответствие требованиям совместного приказа ФСБ России и ФСТЭК России от 31 августа 2010 г. № 416/489 «Об утверждении Требований о защите информации, содержащейся в информационных системах общего пользования», подготовленный во исполнение Постановления Правительства Российской Федерации от 18 мая 2009 г. № 424.

<2> Под возможными подразумеваются альтернативные способы, что не исключает обязательный характер публикации наборов открытых государственных данных в разделе официального сайта государственного органа (далее — через свой существующий сайт) или публикацию через собственный портал открытых данных.

• Обязательные способы публикации открытых данных;
• Альтернативные (дополнительные) способы публикации открытых данных.

5.1. Обязательные способы публикации

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

• через раздел открытых данных на официальном сайте государственного (муниципального) органа в сети «Интернет»;
• через портал открытых данных государственного (муниципального) органа в сети «Интернет»;
• через портал открытых данных Российской Федерации в сети «Интернет».

5.1.1. Публикация открытых данных через раздел открытых данных на официальном сайте государственного (муниципального) органа

Данный метод является одним из наиболее простых с точки зрения Публикатора — предоставление наборов открытых данных в виде файлов для загрузки с веб-страниц. Для реализации этого выдвигается следующий список рекомендаций государственным органам и органам местного самоуправления:

а) на официальном сайте должна быть создана специализированная страница для публикации открытых данных в машиночитаемых форматах (далее — страница открытых данных);

б) на главной странице официального сайта должна располагаться визуально различимая гиперссылка на страницу наборов открытых данных с надписью «Открытые данные»;

в) страница открытых данных должна содержать реестр <1> наборов открытых данных, соответствующий требованиям настоящих Методических рекомендаций;

<1> Общие требования к публикации реестра наборов открытых данных содержатся в п. 7.1.

г) для каждого опубликованного набора открытых данных на официальном сайте государственного органа или органа местного самоуправления должна быть предусмотрена прямая ссылка на набор открытых данных;

д) в целях доступности страниц открытых данных для поисковых роботов должна быть размещена ссылка на реестр наборов открытых данных — разрешение в robots.txt, указание в sitemap.xml.

5.1.2. Публикация открытых данных через портал открытых данных государственного (муниципального) органа

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

а) портал открытых данных должен содержать реестр наборов открытых данных, состоящий из ссылок на отдельные страницы наборов открытых данных;

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

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

• организационная структура — классификация данных по подразделениям, публикующим открытые данные на портале (департаменты, территориальные органы, подведомственные организации и другие, в зависимости от структуры государственного органа и органа местного самоуправления);
• форматы данных — классификация по способу/форматам представляемых данных (CSV, XML, JSON, API, RDF);
• предметная область:

1. по ключевым словам — классификация по перечню ключевых слов;

2. по тематическим разделам (список наборов высокой значимости (список разделов) представлен в Приложении 2).

• качество данных — классификация по определенным меткам определения шкалы качества данных (например, в соответствии с пятизвездной моделью <1> представления данных или собственной шкалой качества данных);

<1> http://5stardata.info.

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

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

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

е) портал должен содержать инструменты визуализации (пример инструментов визуализации представлен в Приложении 3) размещенных наборов открытых данных на портале:

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

ж) в целях доступности страниц открытых данных для поисковых роботов должна быть размещена ссылка на реестр наборов открытых данных — разрешение в robots.txt, указание в sitemap.xml;

з) рекомендуется предоставлять возможности API (спецификации в Приложении 10).

Рекомендуемыми инструментами реализации собственных порталов открытых данных могут быть свободно используемые платформы данных с открытым исходным кодом — CKAN <1> (Comprehensive Knowledge Archive Network) или DKAN <2> (Drupal Knowledge Archive Network).

<1> http://ckan.org/.

<2> https://drupal.org/project/dkan.

5.1.3. Публикация открытых данных через портал открытых данных Российской Федерации

Данный способ представляет собой развитие раздела открытых данных государственного органа на платформе портала открытых данных Российской Федерации с необходимостью размещения наборов открытых данных своей организации, используя инструменты публикации и визуализации наборов открытых данных указанного портала. Использование портала не предъявляет дополнительных требований по машинному представлению реестра и паспортов наборов открытых данных <1>, за исключением текущих правил машиночитаемости и файлового представления опубликованных наборов открытых данных, определенных настоящими Методическими рекомендациями.

<1> Требования по машиночитаемому представлению реестра и паспортов содержатся в техническом задании на разработку портала открытых данных Российской Федерации.

Публикация открытых данных осуществляется средствами личного кабинета портала открытых данных Российской Федерации.

5.2. Альтернативные (дополнительные) способы публикации открытых данных

5.2.1. Публикация через сайт третьей стороны

Данный метод является предпочтительным в том случае, когда одной из целей является получение обратной связи от наибольшего числа потребителей целевой аудитории. Более того, сторонний сайт может содержать средства визуализации и иные аналитические инструменты (Приложение 3).

5.2.2. Публикация через ftp-сервер

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

5.2.3. Публикация через файлообменный протокол BitTorrent

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

6. Порядок публикации наборов открытых данных

Общие правила публикации в форме открытых данных, предъявляемые к государственному органу или органу местного самоуправления:

а) государственный орган или орган местного самоуправления переводит набор данных в машиночитаемый формат, в котором этот набор открытых данных подлежит публикации;

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

в) государственный орган или орган местного самоуправления проверяет доступность опубликованного набора открытых данных для пользователей официального сайта в сети «Интернет»;

г) государственный орган или орган местного самоуправления передает в виде файла в машиночитаемом формате запись об опубликованном наборе открытых данных, выгруженную из реестра наборов данных, открытых государственным органом или органом местного самоуправления, в уполномоченный орган государственной власти;

д) уполномоченный орган государственной власти обновляет сводный реестр открытых данных, а также другую информацию об опубликованных наборах открытых государственных данных, которую они ведут на странице в сети «Интернет» для публикации сводной информации о данных, открытых государственными органами или органом местного самоуправления в машиночитаемых форматах, тем самым поддерживая сводный реестр наборов открытых данных в актуальном состоянии.

Схема взаимодействия при публикации открытых данных (Рисунок 1) отражает ролевой подход к рассматриваемому процессу, представляя собой описание функциональной и технологической компонент. Таким образом, пиктограммами обозначены функциональные роли (у одного сотрудника может быть несколько ролей).

а) отраслевое подразделение государственного органа или органа местного самоуправления осуществляет подготовку материала для предоставления в форме открытых данных. Данная подготовка осуществляется ролью «Поставщик информации» (роль, ответственная за содержательное наполнение материала);

б) после подготовки материала «Поставщик информации» передает материал «Техническому специалисту» своего подразделения для его конвертации в машиночитаемые данные. При получении материала «Технический специалист» проверяет материал на ошибки и возможность корректного представления в машиночитаемые данные;

в) после перевода данных в машиночитаемое представление «Технический специалист» передает данные «Контент-менеджеру» (роль, ответственная за публикацию наборов открытых данных одним из обязательных способов, а также альтернативными способами публикации) или использует автоматизированные инструменты для самостоятельной публикации набора открытых данных;

г) «Контент-менеджер» осуществляет проверку представленных материалов для публикации на корректность ввода и осуществляет публикацию в разделе (на портале);

д) данные опубликованы в виде набора открытых данных в разделе (на портале);

е) разработчики приложений и конечные потребители открытых данных взаимодействуют с «Контент-менеджером» по интересующим их вопросам, непосредственно влияя на качество и актуальность данных по средствам обратной связи.

7. Требования к публикации реестра наборов открытых данных

7.1. Общие требования к публикации реестра наборов открытых данных

На странице публикации наборов открытых данных <1> должен содержаться заголовок «Открытые данные» и обеспечиваться доступ пользователям в сети «Интернет» к следующим элементам:

<1> В случае размещения открытых данных через портал открытых данных Российской Федерации применяется иной порядок определения требований.

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

7.2. Требования к публикации реестра наборов открытых данных через раздел открытых данных на официальном сайте государственного (муниципального) органа в сети «Интернет»

                     ┌───────────────────────────────┐
<pre class="legal-pre">                     │    Раздел открытых данных     │
                     │       государственного        │
                     │    (муниципального) органа    │</pre>
                     └───────────────────────────────┘
┌─────────────────────────────────────/\──────────────────────────────────┐
<pre class="legal-pre">    ┌───────────────────┐  ┌────────────────────┐   ┌───────────────────┐
    │   Реестр наборов  │  │   Набор открытых   │   │  Иная информация  │
    │  открытых данных  │  │       данных       │   └───────────────────┘
    └──────────┬────────┘  └─────────────────┬──┘
        ┌──────┴───────────┐                 │
        \/                 \/              ┌─┴──────────────────┐
(────────────────)  (──────────────)       \/                   \/
│Человекочитаемое│  │Машиночитаемое│   ┌──────────────┐    ┌──────────┐
│ представление  │  │представление │   │Метаинформация├─┐  │ Открытые │
(────────────────)  (───────┬──────)   └──────────────┘ │  │  данные  │
                            │                           │  └─────────┬┘
                            │                      ┌────┘            │
             ┌──────────────┘                      │                 │
             │                                     \/                │
             │    (──────────────────)    ┌────────────────┐         │
             │    │ Человекочитаемое │<─┬─┼- Паспорт <*>   │         │
             │    │   представление  │  │ │- Структура <**>├─┐       │
             │    (──────────────────)  │ │- Статическая   │ │       │
             │                          │ │  информация    │ │       │
             │    (──────────────────)  │ │- Лицензия      │ │       │
             │    │  Машиночитаемое  │  │ │- Семантика     │ │       │
             │    │   представление  │<─┘ │  (linked data) │ │       │
             │    (─────────┬────────)    └────────────────┘ │       │
             │              └───────────┐                    │       │
             \/                         \/              ┌────┘       \/
     ───────────────────      ───────────────────       │         ─────────</pre>

    /CSV               /     /CSV               /       \/       /CSV     /
   / XML              /     / XML              /     ──────     / XML    /
  /  JSON            /     /  JSON            /     /CSV  /    /  JSON  /
 /   HTML+RDFa      /     /   HTML+RDFa      /     / XSD /    /   API  /

<pre class="legal-pre">/    HTML+Microdata/     /    HTML+Microdata/      ──────    /    RDF /
───────────────────      ───────────────────                 ─────────</pre>

1. Адрес страницы раздела «Открытые данные» на официальном сайте государственного (муниципального) органа должен формироваться по следующему шаблону: «<адрес официального сайта>/opendata». В случае кириллического адреса сайта он может быть продублирован по адресу «<адрес официального сайта>/открытые-данные» (Допускается публикация из адреса поддоменного уровня «opendata.<адрес официального сайта>»).

2. Реестр наборов открытых данных должен иметь человекочитаемое представление (с использованием средств визуализации) и машиночитаемое представление. Человекочитаемое представление реестра наборов открытых данных должно содержать следующую информацию:

• порядковый номер набора открытых данных;
• наименование набора открытых данных;
• формат представления набора открытых данных;
• ссылка на страницу набора открытых данных.

Пример реализации:

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

3. Машиночитаемое представление реестра наборов открытых данных должно быть реализовано в одном из следующих форматов:

• CSV;
• XML;
• JSON;
• HTML+RDFa;
• HTML+Microdata.

4. Машиночитаемое представление реестра наборов открытых данных должно содержать следующую информацию о каждом наборе открытых данных:

• Идентификационный номер набора открытых данных <1>;

<1> Определяется в разделе 8.1.

• Название набора открытых данных;
• Ссылка на машиночитаемое представление паспорта набора открытых данных;
• Формат набора открытых данных.

5. Адрес машиночитаемого представления реестра открытых данных должен задаваться по следующему правилу:

<адрес-официального сайта>/opendata/list.расширение формата (opendata.<адрес официального сайта>/list.расширение формата)

Например, файл реестра наборов открытых данных, размещенный в формате xml, должен быть доступен по следующему адресу:

<адрес официального сайта>/opendata/list.xml

Полные требования к машиночитаемому представлению реестра наборов открытых данных в зависимости от форматов представления описаны в Приложении 7.

7.3. Требования к публикации через портал открытых данных государственного (муниципального) органа

                     ┌───────────────────────────────┐
<pre class="legal-pre">                     │    Портал открытых данных     │
                     │       государственного        │
                     │    (муниципального) органа    │</pre>
                     └───────────────────────────────┘
┌─────────────────────────────────────/\──────────────────────────────────┐
<pre class="legal-pre">    ┌───────────────────┐  ┌────────────────────┐   ┌───────────────────┐
    │   Реестр наборов  │  │   Набор открытых   │   │  Иная информация  │
    │  открытых данных  │  │       данных       │   └───────────────────┘
    └──────────┬────────┘  └─────────────────┬──┘
        ┌──────┴───────────┐                 │
        \/                 \/                │
(────────────────) (──────────────)          │
│Человекочитаемое│ │Машиночитаемое│          │
│ представление  │ │представление │       ┌──┴───────────────────────────┐
│ (визуализация) │ │      <*>     │       │                              \/
(────────────────) (──────────────)       \/        Машиночитаемое ┌──────────┐
                                  ┌───────────────┐ представление  │ Открытые │
                                  │Метаинформация:│                │  данные  │
                                  │- Паспорт      │     ───────    └─────┬────┘
                                  │- Структура   ─┼──> /CSV   /          │
                                  │- Статическая  │   / XSD  /           │
                                  │  информация   │  / JSON /            │
                                  │- Лицензия     │  ──────              │
                                  │- Семантика    │                      │
                                  │  (linked data)│                      │
                                  │  <**>         │                      │
                                  └────────┬──────┘                      │
                                  ┌────────┴────────┐                    \/
                                  \/                \/               ─────────
                         (────────────────)  (──────────────)       /CSV     /
                         │Человекочитаемое│  │Машиночитаемое│      / XML    /
                         │ представление  │  │представление │     /  JSON  /
                         │ (визуализация) │  │      <*>     │    /   API  /
                         (────────────────)  (──────────────)   /    RDF /</pre>
                                                                ─────────

<*> Машиночитаемое представление — Выбор формата осуществляется публикатором.

<**> Требование не является обязательным.

1. Портал открытых данных должен находиться по адресу: «opendata.<адрес портала>» (допускается размещать портал по собственному адресу).

Дополнительно возможно существование второго (дублирующего) варианта ссылки «открытые-данные.<адрес портала>» в случае кириллического адреса сайта.

2. Реестр наборов открытых данных портала должен иметь машиночитаемое представление.

3. Адрес машиночитаемого представления реестра открытых данных должен задаваться по следующему правилу:

opendata.<адрес портала>/list.расширение формата (или <адрес портала>/list.расширение формата)

Например, файл реестра наборов открытых данных, размещенный в формате xml, должен быть доступен по следующему адресу:

opendata.<адрес портала>/list.xml

Полные требования к машиночитаемому представлению реестра наборов открытых данных в зависимости от форматов представления описаны в Приложении 7.

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

7.4. Требования к публикации через портал открытых данных Российской Федерации

При публикации открытых данных на портале открытых данных Российской Федерации предъявляются общие требования к публикации набора открытых данных, определенные в разделе 8.1.

8. Требования к публикации набора открытых данных

8.1. Общие требования к публикации набора открытых данных

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

Заголовок страницы набора открытых данных должен соответствовать его названию.

Страница набора открытых данных должна обеспечивать предоставление доступа пользователям сети «Интернет» к следующим элементам набора открытых данных:

1. паспорт набора открытых данных в человекочитаемом виде (визуальном интерфейсе) и в машиночитаемом виде (файла для загрузки, инструмента программного интерфейса);

2. структура набора открытых данных в машиночитаемом виде (CSV, XSD или JSON представлении в зависимости от формата файла открытых данных <1>);

<1> Соответствие форматов структур и форматов наборов открытых данных приводится далее по тексту в текущем разделе.

3. описание условий использования набора открытых данных (открытая лицензия на использование наборов открытых данных);

4. открытые данные в человекочитаемом виде (визуальном интерфейсе) и в машиночитаемом виде в одном из форматов: CSV, XML, JSON, RDF или в виде API;

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

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

8.1.1. Публикация метаинформации набора открытых данных

Метаинформация набора открытых данных включает полное описание набора открытых данных.

Метаинформация набора открытых данных состоит из следующих частей:

• паспорт набора открытых данных;
• структура набора открытых данных;
• другая информация, описывающая набор открытых данных.

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

Метаинформация набора открытых данных не должна иметь никаких дополнительных ограничений на использование (например, ссылки на системы координат в закрытых форматах)

8.1.1.1 Публикация паспорта набора открытых данных <1>

<1> Пример заполнения паспорта открытых данных представлен в Приложении 8.

Страница набора открытых данных должна содержать паспорт набора открытых данных.

Заголовок страницы набора открытых данных должен соответствовать названию набора открытых данных.

Паспорт набора открытых данных должен иметь четко заданную структуру следующего вида:

<1> Дата, до которой набор открытых данных содержит актуальную информацию.

1. Идентификационный номер (код) набора открытых данных формируется следующим образом:

а) формат идентификационного номера: <код организации>-<наименование набора>;

б) код организации представляет собой идентификационный номер налогоплательщика (ИНН), соответствующий государственному органу, органу местного самоуправления или организации, опубликовавшей набор открытых данных;

в) наименование набора открытых данных — сокращенное англоязычное название набора открытых данных, указывается в одно слово (уникальное в пределах организации).

Пример: 7712345678-showrooms.

2. Наименование набора открытых данных выбирается следующим образом:

а) наименование набора данных должно отражать его содержание;

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

Пример: Список выставочных залов.

8.1.1.2. Публикация структуры набора открытых данных

1. структура наборов открытых данных должна представлять описание каждого информационного поля открытых данных;

2. структура открытых данных должна иметь машиночитаемое представление в формате XSD для открытых данных, представленных в формате XML или RDF;

3. структура наборов открытых данных должна иметь машиночитаемое представление в формате CSV для наборов открытых данных в формате CSV;

4. структура наборов открытых данных должна иметь машиночитаемое представление в формате JSON для наборов открытых данных в формате JSON;

5. при изменении структуры открытых данных должна обеспечиваться версионность структуры и соответствие данной версии последующим итерациям открытых данных;

6. необходимо обеспечивать хранение всех версий структуры открытых данных;

7. атрибуты каждой структуры открытых данных должны иметь англоязычное представление (в виде англоязычных имен или краткого текста транслитерации);

8. описание структуры открытых данных должно содержать описание (в том числе в виде ссылок) всех справочников, онтологий и классификаторов, используемых для формирования набора открытых данных <1>;

<1> В случае использования узкоспециализированных справочников, онтологий и классификаторов рекомендуется их публиковать в виде открытых данных и/или указывать ссылки их публикации (специфические типы данных).

9. при использовании общепринятых стандартов, систем и справочников обязательным требованием является указание данных онтологий в структуре набора открытых данных (например, для формата xsd структуры — <xs:documentation xml:lang=«ru»>Дата первой публикации набора данных в формате ISO 8601.</xs:documentation>). При использовании собственных справочников (например, ОКАТО или другой специализированный справочник) необходимо указывать ссылку на справочник или на онтологию справочника в структуре набора открытых данных. Используемые общепринятые стандарты, системы и справочники не должны иметь никаких ограничений в использовании;

10. при публикации специфических наборов (различные тематические направления, например, геоданные) необходимо использовать унифицированные онтологии (например, в проекции EPSG: 4326 для геоданных) с обязательным указанием наименования и ссылки на онтологию в структуре набора;

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

Примеры публикации структуры наборов открытых данных в различных форматах приведены в Приложении 9.

8.1.1.3. Публикация другой информации, описывающей набор открытых данных

Предъявляется требование к необходимости публикации исходных документов (информации, которая преобразуется в открытые данные) на странице набора открытых данных в качестве дополнительной информации к открытым данным <1>.

<1> В ряде случаев машиночитаемое представление открытых данных не является удобным вариантом для целей ознакомления с содержательной частью открытых данных потребителем.

8.1.2. Машиночитаемое представление открытых данных

Машиночитаемое представление открытых данных должно быть реализовано посредством представления данных через API или в одном из перечисленных форматов:

1 CSV;

2 XML;

3 JSON;

4 любой из открытых форматов, реализующих модель RDF.

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

• <адрес официального сайта>/opendata/<код организации>-<наименование набора>.расширение файла — в случае публикации через раздел открытых данных на официальном сайте;
• opendata.<адрес официального сайта>/<код организации>-<наименование набора>.расширение файла — в случае публикации через портал открытых данных государственного органа.

Общие требования к публикации машиночитаемого представления набора открытых данных

а. открытые данные должны публиковаться в форматах CSV, XML, JSON, RDF или с применением API (в случае наборов открытых данных со специфическими особенностями). В формате CSV рекомендуется публиковать данные, имеющие плоскую табличную форму, при этом в содержании записи не допускается использование символа перевода строки. Сложные иерархические данные рекомендуется публиковать в форматах XML, JSON. Для облегчения последующего процесса связывания наборов данных рекомендуется публиковать в одном из открытых форматов, реализующих модель RDF. Подробная схема представления связей между метаданными, открытыми данными и онтологиями представлена в Приложении 1;

б. в случае если размер набора имеет значительный объем данных (более 30 Мбайт), рекомендуется архивировать его с помощью алгоритма архивирования, имеющего спецификацию в виде открытого стандарта (см. п. 8.1.4);

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

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

д. атрибуты каждого набора открытых данных должны иметь краткое англоязычное представление (в виде англоязычных имен или краткого текста транслитерации);

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

Полные требования и примеры к машиночитаемому представлению открытых данных представлены в Приложениях 7 - 10.

8.1.3 Человекочитаемое представление открытых данных <1>

<1> Данные требования не являются обязательными в случае публикации наборов открытых данных через раздел открытых данных на официальном сайте государственного (муниципального) органа.

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

Для визуализации табличных данных необходимо использовать инструменты, позволяющие осуществить предварительный просмотр данных в веб-браузере в табличном виде.

8.1.4. Требования к архивированию открытых данных

В случае если размер открытых данных имеет значительный размер (определяется в соответствии с аппаратно-техническими возможностями) рекомендуется архивировать его с помощью алгоритма архивирования LZMA (LZMA2) <1>.

<1> Например, данный алгоритм поддерживается в свободном файловом архиваторе 7zip (список поддерживаемых операционных систем http://www.7-zip.org/download.html).

В случае если на сайте хранится более 10 версий открытых данных одного набора открытых данных, рекомендуется все версии старше десятой хранить в архивах.

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

8.1.5. Частота обновления набора данных

Наборы открытых данных разделяются на оперативные данные (высокая периодичность актуализации данных — чаще, чем 1 раз в неделю) и долговременные (реже, чем 1 раз в неделю)

Для каждого набора открытых данных в паспорте набора должна быть указана дата его актуальности.

Частота обновления набора может быть следующей:

Оперативные данные:

• больше одного раза в день;
• ежедневно;
• еженедельно.

Долговременные данные:

• ежемесячно;
• ежеквартально;
• каждые полгода;
• ежегодно;
• по мере изменения данных.

Глубина хранения наборов открытых данных

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

8.2. Требования к публикации набора открытых данных через раздел открытых данных на официальном сайте государственного (муниципального) органа в сети «Интернет»

Адрес страницы набора открытых данных должен формироваться по следующему шаблону: «<адрес официального сайта>/opendata/<код организации>-<наименование набора>». В случае кириллического адреса сайта он может быть продублирован по адресу «<адрес официального сайта>/открытые-данные/<код организации>-<наименование набора>» (Допускается публикация из адреса поддоменного уровня «opendata.<адрес официального сайта>»).

Пример:

<адрес официального сайта>/opendata/7712345678-showrooms

Набор открытых данных должен включать данные, перечисленные в Приложении 9.

8.3. Требования к публикации набора открытых данных через портал открытых данных государственного (муниципального) органа в сети «Интернет»

Специальных требований к адресу публикации наборов открытых данных не предъявляется, за исключением официального стандарта RFC 1738 <1>.

<1> http://www.ietf.org/rfc/rfc1738.txt.

Технические требования к наборам открытых данных представлены в Приложении 9.

8.4. Требования к публикации набора открытых данных через портал открытых данных Российской Федерации

Предъявляются требования к метаинформации в части заполнения паспорта (Раздел 8.1.1.1 - Публикация паспорта набора открытых данных) и представления структуры открытых данных (Раздел 8.1.1.2 - Публикация структуры набора открытых данных), а также к машиночитаемому представлению (Раздел 8.1.2 - Машиночитаемое представление открытых данных).

8.5. Дополнительные требования к наборам открытых данных со специфическими технологическими особенностями в части хранения, описания и представления

К наборам открытых данных со специфическими технологическими особенностями относятся многотомные наборы открытых данных, периодически пополняемые (оперативные) наборы открытых данных и иные типы открытых данных, к которым предъявляются следующие требования:

• в случае значительных объемов (более 30 Мбайт) необходимо пользоваться вышеописанными средствами архивирования (Раздел 8.1.4 - Требования к архивированию открытых данных);
• в случае значительных объемов (более 30 Мбайт), частых обновлений (чаще 1 раза в неделю) или необходимости формирования специфических выборок, открытые данные должны предоставляться через программный интерфейс, имеющий опубликованную спецификацию (Приложение 10); программный интерфейс должен обеспечивать возможность полностью автоматического (без участия человека) доступа ко всем сведениям набора открытых данных (спецификации протоколов, форматов данных, первичные параметры доступа к сервису и пр.) (Приложение 10).

9. Приложение 1. Концептуальное представление связей между метаданными, данными и онтологиями

<pre class="legal-pre">┌─────────────┐     ┌────────────┐     ┌────────────┐
│             │     │            │     │            │
│     HTML    │     │   Данные   │     │ Онтология  │
│             │     │            │     │            │
└──────┬──────┘     └────┬─┬─────┘     └──────┬─────┘
       │   ┌─────────────┘ │  ┌───────────────┘
       \/  \/              \/ \/       ┌
┌─────────────┐  ┌──┌────────────┐─┐   │
│             │     │            │     │
│     HTML    │  │  │     RDF    │ │   ┤ Метаданные
│             │     │            │     │
└──────┬──────┘  │  └─┬──────────┘ │   │
       │              │                └
       │         │ микроразметка   │
       └─────┐   └ ─ ─┬─ ─ ─ ─ ─ ─ ┘</pre>

        \/        \/

Примечание: При публикации информации в форме открытых данных необходимо пользоваться общеупотребительными международными и отечественными (в случае национальной специфики той или иной области знаний) онтологиями. Часто используемые онтологии необходимо выкладывать в виде открытых данных для предоставления возможности последующего связывания наборов между собой <1>.

<1> Например, недопустимо выкладывать данные с геометками, использующими закрытую систему координат.

10. Приложение 2. Классификация типов открытых данных

Классификация типов открытых данных представляется по следующим основным критериям:

• предметная область;
• формат данных;
• структура данных (линейная, иерархическая и т.д.);
• объем данных;
• способ публикации;
• способ хранения;
• периодичность обновления и актуальности данных.

Часть критериев классификации включено в качестве метаинформации к паспорту набора данных:

• формат данных;
• объем данных;
• способ публикации;
• способ хранения;
• периодичность обновления и актуальности данных.

Критерий предметной области выделяет специфические особенности публикации открытых данных по специализированным тематикам.

Тематики наборов предполагают использование различных справочников и стандартов для связывания наборов открытых данных между собой. Для связывания наборов открытых данных возможно использование международных общепринятых стандартов, систем и справочников, таких как: ISO 8601 (международный стандарт, описывающий формат даты и времени), EPSG: 4326 (система координат геоданных). При использовании общепринятых стандартов, систем и справочников обязательным требованием является указание данных онтологий в структуре набора открытых данных (например, для формата xsd структуры — <xs:documentation xml:lang=«ru»>Дата первой публикации набора данных в формате ISO 8601.</xs:documentation>). При использовании собственных справочников (например, ОКАТО или другой специализированный справочник) необходимо указывать ссылку на справочник или на онтологию справочника в структуре набора открытых данных. Используемые общепринятые стандарты, системы и справочники не должны иметь никаких ограничений в использовании.

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

В соответствии с перечнем наиболее важных сегментов открытых данных, выделенных в Хартии открытых данных, классификация наборов может проводиться по следующим тематикам:

11. Приложение 3. Рекомендуемые инструменты визуализации

12. Приложение 4. Требования к семантическому представлению реестра и паспорта набора открытых данных

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

Общие сведения

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

• RDF (Resource Description Framework) — разработанная консорциумом Всемирной паутины (World Wide Web Consortium — W3C) абстрактная модель для представления данных, в особенности — метаданных, пригодных для машинной обработки;
• RDFa (Resource Description Framework in attributes) — модель для представления данных в формате RDF через атрибуты программных сред HTML, XHTML и XML;
• Microdata — один из способов семантической разметки веб-страниц сведениями о разнообразных сущностях, используя стандартные элементы языка HTML (или XHTML);
• W3C Recommendation: RDFa Core 1.1 — Рекомендация от W3C по использованию RDFa;
• RFC2413 — Общепризнанный интернет-стандарт «Encoding Dublin Core Metadata in HTML»;
• ГОСТ Р 7.0.10-2010 — Российский стандарт «Набор элементов метаданных „Дублинское ядро“;»
• W3C Recommendation: XML Schema Part 2: Datatypes — Рекомендация от W3C по использованию типов данных.

Для представления наборов открытых данных используются следующие словари:

• schema.org - http://schema.org/;
• dc (Dublin Core) — «http://purl.org/dc/terms/» — для предоставления свойств объекта (используется редакция «Qualified Dublin Core», так как содержит расширенный реестр свойств);
• foaf (Friend of a Friend) — «http://xmlns.com/foaf/0.1/» — для предоставления класса объекта.

Требования

Каждая страница реестра наборов отрытых данных должна содержать объект, к которому предъявляются следующие обязательные требования:

1. объект должен быть элементом текущей страницы набора.

2. объект должен иметь класс «Collection» онтологии «dc» или «CreativeWork» онтологии schema.org.

Соблюдение этих требований однозначно сопоставляет данный объект с текущей страницей реестра открытых данных и определяет данный объект, как машиночитаемый формат реестра открытых данных.

Объект реестра открытых данных содержит следующие значения:

Свойство «Набор открытых данных» объекта реестра открытых данных повторяется ровно столько раз, сколько существует публикуемых наборов открытых данных.

Свойства «Предыдущая страница» и «Следующая страница» объекта реестра открытых данных указываются обязательно, если данные значения существуют.

Каждая страница набора открытых данных должна содержать объект, к которому предъявляются следующие обязательные требования:

1. объект должен быть субъектом текущей страницы набора.

2. объект должен иметь класс «Document» онтологии «foaf» или «CreativeWork» онтологии schema.org.

Соблюдение этих требований однозначно сопоставляет данный объект с текущей страницей набора открытых данных и определяет данный объект, как машиночитаемый формат текущего набора открытых данных.

Паспорт набора открытых данных в соответствии с текущей версией Методических рекомендаций содержит следующие значения:

Свойство «Ответственное лицо» набора открытых данных ссылается на объект ответственного лица набора данных. К объекту ответственного лица набора данных предъявляются следующие обязательные требования:

1. объект должен иметь класс «Person» онтологии «foaf» или «Person» онтологии schema.org.

Объект ответственного лица набора данных содержит следующие значения:

Свойство «Список всех версий наборов открытых данных» набора открытых данных ссылается на объект коллекции всех версий наборов данных. К объекту коллекции всех версий наборов данных предъявляются следующие обязательные требования:

1. объект должен иметь класс «Collection» онтологии «dc» или DataCatalog онтологии schema.org.

Объект коллекции всех версий наборов данных содержит следующие значения:

Свойство «Версия набора данных» объекта коллекции всех версий наборов данных повторяется ровно столько раз, сколько существует публикуемых версий текущего набора открытых данных.

Свойство «Версия набора данных» объекта коллекции всех версий наборов данных ссылается на объект набора данных. К объекту набора данных предъявляются следующие обязательные требования:

1. объект должен иметь класс «Document» онтологии «foaf» или «Dataset» онтологии schema.org.

Объект набора данных содержит следующие значения:

Свойство «Структура набора данных» объекта набора данных ссылается на объект структуры набора данных. К объекту структуры набора данных предъявляются следующие обязательные требования:

1. объект должен иметь класс «Document» онтологии «foaf» или Dataset онтологии schema.org.

Объект структуры набора данных содержит следующие значения:

13. Приложение 5. Исходный пример материала для публикации в виде открытых данных

ИСХОДНЫЕ ДАННЫЕ (ПРЕДСТАВЛЕНЫ В XLSX)

ИНФОРМАЦИЯ, НЕОБХОДИМАЯ ДЛЯ РАЗМЕЩЕНИЯ В ВИДЕ НАБОРА ОТКРЫТЫХ ДАННЫХ

14. Приложение 6. Визуальное представление паспорта набора открытых данных

<1> http://www.w3.org/TR/xml11/.

15. Приложение 7. Требование к представлению реестра наборов открытых данных

Реестр наборов открытых данных (CSV)

Требования к публикации реестра наборов открытых данных в машиночитаемом формате CSV

1. Требования к расположению:

a. Машиночитаемый формат реестра открытых данных представлен отдельным файлом в формате CSV.

b. Файл имеет название "list.csv".

c. Файл расположен непосредственно в разделе открытых данных. Например, ваш сайт расположен по адресу "http://example.com/". Тогда, учитывая требование к названию файла и возможные адреса раздела открытых данных, файл реестра открытых данных должен быть доступен по одному из двух адресов:

i. http://example.com/opendata/list.csv

ii. http://opendata.example.com/list.csv

2. Требования к формату:

a. Соответствие файла стандарту RFC - "Common Format and MIME Type for Comma-Separated Values (CSV) Files" (http://tools.ietf.org/html/rfc4180).

b. Дополнительные требования к CSV:

i. Разделителем полей является знак "," (запятая).

ii. Ограничителем строк является знак " (универсальная двойная кавычка).

iii. Разделителем целой и дробной части чисел является знак "." (точка).

c. Кодировка файла - "UTF-8".

3. Требование к структуре данных:

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

b. Наличие следующих обязательных атрибутов поля реестра наборов открытых данных:

i. Атрибут поля "Наименование поля реестра наборов открытых данных":

1. Должен быть установлен следующий обязательный заголовок атрибута: "property".

2. Значением атрибута является наименование поля реестра набора открытых данных.

ii. Атрибут поля "Заголовок поля реестра наборов открытых данных":

1. Должен быть установлен следующий обязательный заголовок атрибута: "title".

2. Значением атрибута является заголовок поля реестра наборов открытых данных.

iii. Атрибут поля "Значение поля реестра наборов открытых данных":

1. Должен быть установлен следующий обязательный заголовок атрибута: "value".

2. Значением атрибута является значение поля реестра наборов открытых данных.

iv. Атрибут поля "Формат поля реестра наборов открытых данных":

1. Должен быть установлен следующий обязательный заголовок атрибута: "format".

2. Значением атрибута является формат значения поля реестра наборов открытых данных.

c. Наличие следующих обязательных полей реестра наборов открытых данных:

i. Поле паспорта "Версия методических рекомендаций":

1. Должно быть установлено следующее обязательное наименование поля: "standardversion".

2. Должен быть установлен следующий обязательный заголовок поля: "Версия методических рекомендаций".

3. Значением поля является ссылка на версию методических рекомендаций, которой соответствует публикация этого реестра наборов открытых данных.

4. Атрибут "Формат поля реестра наборов открытых данных" неприменим для этого поля, поэтому значением формата поля является пустая строка.

ii. Поле паспорта "Набор открытых данных" (данное поле повторяется столько раз, сколько опубликовано наборов открытых данных):

1. Должно быть установлено следующее обязательное наименование поля: "". Где - это идентификационный номер паспорта набора открытых данных.

2. Должен быть установлен следующий обязательный заголовок поля: "<title>". Где <title> - это наименование набора открытых данных.

3. Значением поля является ссылка на машиночитаемый формат паспорта набора открытых данных.

4. Значением формата поля является машиночитаемый формат набора открытых данных.

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

list.csv (пример)

property,title,value,format

standardversion,Версия методических рекомендаций, http://opendata.gosmonitor.ru/standard/3.0,

7712345678-showrooms,Список выставочных залов,http://example.com/opendata/7712345678-showrooms/meta.xml,xml

7712345678-libraries,Список муниципальных библиотек,http://example.com/opendata/7712345678-libraries/meta.csv,csv

Реестр наборов открытых данных (XML)

Требования к публикации реестра наборов открытых данных в машиночитаемом формате XML

1. Требования к расположению:

a. Машиночитаемый формат реестра открытых данных представлен отдельным файлом в формате XML.

b. Файл имеет название "list.xml".

c. Файл расположен непосредственно в разделе открытых данных. Например, ваш сайт расположен по адресу "http://example.com/". Тогда, учитывая требование к названию файла и возможные адреса раздела открытых данных, файл реестра открытых данных должен быть доступен по одному из следующих адресов:

i. http://example.com/opendata/list.xml

ii. http://opendata.example.com/list.xml

2. Требования к формату:

a. Соответствие файла стандарту W3C - "Extensible Markup Language (XML) 1.1 (Second Edition)" (http://www.w3.org/TR/xml11/).

b. Кодировка файла указывается в объявлении XML, если объявление XML используется, иначе используется кодировка "UTF-8".

3. Требование к структуре данных:

a. Соответствие файлу структуры реестра наборов открытых данных - "list-schema.xsd" (Содержимое файла "list-schema.xsd" приложено ниже).

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

list.xml (пример)

http://opendata.gosmonitor.ru/standard/3.0 1 <title>Список выставочных залов</title> http://example.com/opendata/7712345678- showrooms/meta.xml xml 2 <title>Список муниципальных библиотек</title> http://example.com/opendata/7712345678- libraries/meta.csv csv

list-schema.xsd

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" attributeFormDefault="unqualified" elementFormDefault="qualified"> <xs:element type="List" name="list"/>

<xs:complexType name="List"> xs:annotation <xs:documentation xml:lang="en">Opendata list.</xs:documentation> <xs:documentation xml:lang="ru">Реестр наборов открытых данных.</xs:documentation> </xs:annotation> xs:sequence <xs:element type="xs:anyURI" name="standardversion"> xs:annotation <xs:documentation xml:lang="en">Link to opendata standard version, which corresponds to current opendata list.</xs:documentation> <xs:documentation xml:lang="ru">Ссылка на версию методических рекомендаций, которой соответствует публикация этого реестра наборов открытых данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type="Meta" name="meta"/> </xs:sequence> </xs:complexType>

<xs:complexType name="Meta"> xs:annotation <xs:documentation xml:lang="en">Opendata metadata list.</xs:documentation> <xs:documentation xml:lang="ru">Список паспортов наборов открытых данных.</xs:documentation> </xs:annotation> xs:sequence <xs:element type="MetaItem" name="item" maxOccurs="unbounded" minOccurs="0"/> </xs:sequence> </xs:complexType>

<xs:complexType name="MetaItem"> xs:annotation <xs:documentation xml:lang="en">Opendata metadata.</xs:documentation> <xs:documentation xml:lang="ru">Паспорт набора открытых данных.</xs:documentation> </xs:annotation> xs:sequence <xs:element type="xs:string" name="identifier"/> xs:annotation <xs:documentation xml:lang="en">Opendata identification number.</xs:documentation> <xs:documentation xml:lang="ru">Идентификационный номер набора данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type="xs:string" name="title"> xs:annotation <xs:documentation xml:lang="en">Opendata title.</xs:documentation> <xs:documentation xml:lang="ru">Наименование набора данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type="xs:anyURI" name="link"> xs:annotation <xs:documentation xml:lang="en">Opendata meta link.</xs:documentation> <xs:documentation xml:lang="ru">Ссылка на паспорт набора открытых данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type="xs:string" name="format"> xs:annotation <xs:documentation xml:lang="en">Opendata meta format.</xs:documentation> <xs:documentation xml:lang="ru">Формат паспорта набора открытых данных.</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType> </xs:schema>

Реестр наборов открытых данных (JSON)

Требования к публикации реестра наборов открытых данных в машиночитаемом формате JSON

1. Требования к расположению:

a. Машиночитаемый формат реестра открытых данных представлен отдельным файлом в формате JSON.

b. Файл имеет название "list.json".

c. Файл расположен непосредственно в разделе открытых данных. Например, ваш сайт расположен по адресу "http://example.com/". Тогда, учитывая требование к названию файла и возможные адреса раздела открытых данных, файл реестра открытых данных должен быть доступен по одному из следующих адресов:

i. http://example.com/opendata/list.json

ii. http://opendata.example.com/list.json

2. Требования к формату:

a. Соответствие файла стандарту JSON - (http://json.org/json-ru.html).

b. Кодировка файла - "UTF-8".

3. Требование к структуре данных:

a. Соответствие файлу структуры реестра наборов открытых данных - "list-schema.json" (Содержимое файла "list-schema.json" приложено ниже).

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

list.json (пример)

{ "standardversion": "http://opendata.gosmonitor.ru/standard/3.0", "meta": [ { "identifier": "7712345678-showrooms", "title": "Список выставочных залов", "link": "http://example.com/opendata/7712345678-showrooms/meta.xml", "format": "xml" }, { "identifier": "7712345678-libraries", "title": "Список муниципальных библиотек", "link": "http://example.com/opendata/7712345678-libraries/meta.csv", "format": "xml" } ] }

list-schema.json

{ "$schema": "http://json-schema.org/draft-04/schema#", "title": "Opendata list", "description": "Opendata list.", "type": "object", "properties": { "standardversion": { "description": "Link to opendata standard version, which corresponds to current opendata list.", "type": "string" }, "meta": { "description": "Opendata metadata list.", "type": "array", "minItems": 1, "items": { "description": "Opendata metadata.", "type": "object", "properties": { "identifier": { "description": "Opendata identification number.", "type": "string" }, "title": { "description": "Opendata title.", "type": "string" }, "link": { "description": "Opendata meta link.", "type": "string" }, "format": { "description": "Opendata meta format.", "type": "string" } }, "required": ["identifier", "title", "link", "format"] } } } }

Реестр наборов открытых данных (HTML + RDFa)

Требования к публикации реестра наборов открытых данных в машиночитаемом формате HTML + RDFA

1. Требования к публикации реестра наборов открытых данных в формате HTML+RDFa подробно описаны в приложении 4 данных методических рекомендаций.

list.html (пример)

<title>Opendata</title>

about="/opendata/7712345678-showrooms"     property="dc:title"    content="Список
выставочных         залов">Список

about="/opendata/7712345678-libraries"     property="dc:title"    content="Список
муниципальных      библиотек">Список

16. Приложение 8. Требование к представлению паспорта набора открытых данных

Паспорт набора открытых данных (CSV)

Требования к публикации паспорта набора открытых данных в машиночитаемом формате CSV

1. Требования к расположению:

a. Машиночитаемый формат паспорта набора открытых данных представлен отдельным файлом в формате CSV.

b. Файл имеет название «meta.csv».

2. Требования к формату:

a. Соответствие файла стандарту RFC — «Common Format and MIME Type for Comma-Separated Values (CSV) Files» (http://tools.ietf.org/html/rfc4180).

b. Дополнительные требования к CSV:

i. Разделителем полей является знак «,» (запятая).

ii. Ограничителем строк является знак « (универсальная двойная кавычка).»

iii. Разделителем целой и дробной части чисел является знак «.» (точка).

c. Кодировка файла — «UTF-8».

3. Требование к структуре данных:

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

b. Наличие следующих обязательных атрибутов поля паспорта набора открытых данных:

i. Атрибут поля «Наименование поля паспорта набора открытых данных»:

1. Должен быть установлен следующий обязательный заголовок атрибута: «property».

2. Значением атрибута является наименование поля паспорта набора открытых данных.

ii. Атрибут поля «Значение поля паспорта набора открытых данных»:

1. Должен быть установлен следующий обязательный заголовок атрибута: «value».

2. Значением атрибута является значение поля паспорта набора открытых данных.

c. Наличие следующих обязательных полей паспорта

i. Поле паспорта «Версия методических рекомендаций»:

1. Должно быть установлено следующее обязательное наименование поля: «standardversion».

2. Значением поля является ссылка на версию методических рекомендаций, которой соответствует публикация этого паспорта набора открытых данных.

ii. Поле паспорта «Идентификационный номер»:

1. Должно быть установлено следующее обязательное наименование поля: «identifier».

2. Значением поля является идентификационный номер набора открытых данных.

iii. Поле паспорта «Наименование набора данных»:

1. Должно быть установлено следующее обязательное наименование поля: «title».

2. Значением поля является наименование набора открытых данных.

iv. Поле паспорта «Описание набора данных»:

1. Должно быть установлено следующее обязательное наименование поля: «description».

2. Значением поля является подробное описание набора открытых данных.

v. Поле паспорта «Владелец набора данных»:

1. Должно быть установлено следующее обязательное наименование поля: «creator».

2. Значением поля является владелец набора открытых данных, юридическое или физическое лицо, которое публикует свои данные.

vi. Поле паспорта «Дата первой публикации набора данных»:

1. Должно быть установлено следующее обязательное наименование поля: «created».

2. Значением поля является дата первичной публикации набора открытых данных в формате «ISO 8601 <1>», с точностью не ниже чем «День».

<1> http://www.ietf.org/rfc/rfc1738.txt.

vii. Поле паспорта «Дата последнего внесения изменений»:

1. Должно быть установлено следующее обязательное наименование поля: «modified».

2. Значением поля является дата последнего внесения изменения в набор, структуру или паспорт открытых данных в формате «ISO 8601», с точностью не ниже чем «День» и достаточной для отделения актуальной версии набора открытых данных от предыдущей версии.

viii. Поле паспорта «Ключевые слова, соответствующие содержанию набора данных»:

1. Должно быть установлено следующее обязательное наименование поля: «subject».

2. Значением поля является список ключевых слов, соответствующих содержанию набора, разделенных между собой знаком «,» (запятая).

ix. Поле паспорта «Формат данных»:

1. Должно быть установлено следующее обязательное наименование поля: «format».

2. Значением поля является формат набора открытых данных в нижнем регистре. Например: csv, xml.

x. Поле паспорта «Содержание последних изменений»:

1. Должно быть установлено следующее обязательное наименование поля: «provenance».

2. Значением поля является описание внесенных изменений в последнюю версию набора открытых данных.

xi. Поле паспорта «Дата актуальности»:

1. Должно быть установлено следующее обязательное наименование поля: «valid».

2. Значением поля является дата, до которой будет актуальной последняя версия набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День».

xii. Поле паспорта «Ответственное лицо»:

1. Должно быть установлено следующее обязательное наименование поля: «publishername».

2. Значением поля является ФИО лица, ответственного за публикацию текущего набора открытых данных.

xiii. Поле паспорта «Телефон ответственного лица»:

1. Должно быть установлено следующее обязательное наименование поля: «publisherphone».

2. Значением поля является телефон лица ответственного за публикацию текущего набора открытых данных, в следующем формате: «+<код страны><код региона><номер телефона>». Пояснение, сначала идет знак «+», потом код страны без форматирования (то есть без скобок, дефисов и прочих знаков), затем код города (области или иного региона) без форматирования и затем номер телефона без форматирования.

xiv. Поле паспорта «Адрес электронной почты ответственного лица»:

1. Должно быть установлено следующее обязательное наименование поля: «publishermbox».

2. Значением поля является электронная почта лица, ответственного за публикацию текущего набора открытых данных.

xv. Поле паспорта «Файл набора открытых данных» (данное поле повторяется для каждой опубликованной версии файла набора открытых данных с учетом глубины хранения версий):

1. Должно быть установлено следующее обязательное наименование поля: «data--structure-». Где - версия файла набора открытых данных и  - версия соответствующего файла структуры набора открытых данных.

2. Значением поля является ссылка на файл набора открытых данных.

3. Все поля этого типа должны быть отсортированы в убывающем порядке согласно версии файла набора открытых данных.

xvi. Поле паспорта «Файл структуры набора открытых данных» (данное поле повторяется для каждой версии файла структуры набора открытых данных, для которой существует опубликованный файл набора открытых данных с учетом глубины хранения версий):

1. Должно быть установлено следующее обязательное наименование поля: «structure-». Где - версия файла структуры набора открытых данных.

2. Значением поля является ссылка на файл структуры набора открытых данных.

3. Все поля этого типа должны быть отсортированы в убывающем порядке согласно версии файла набора открытых данных.

meta.csv (пример)

property,value

standardversion,http://opendata.gosmonitor.ru/standard/3.0

identifier,7712345678-showrooms

title,Список выставочных залов

description,Список выставочных залов с указанием контактных данных по округам и районам.

creator,Министерство культуры

created,20130401

modified,20130601

subject,«Выставка,зал,выставочный зал,культура»

format,xml

provenance,«Исправлены незначительные ошибки, добавлены новые выставочные залы»

valid,20130701

publishername,Иванов Иван Иванович

publisherphone,+74951234567

publishermbox,ivanov@example.com

data-20130601T0000-structure-20130401T0000,http://example.com/opendata/7712345678-showrooms/data-20130601T0000-structure-20130401T0000.xml

data-20130501T0000-structure-20130401T0000,http://example.com/opendata/7712345678-showrooms/data-20130501T0000-structure-20130401T0000.xml

data-20130406T0000-structure-20130401T0000,http://example.com/opendata/7712345678-showrooms/data-20130406T0000-structure-20130401T0000.xml

data-20130401T0000-structure-20130401T0000,http://example.com/opendata/7712345678-showrooms/data-20130401T0000-structure-20130401T0000.xml

structure-20130401T0000,http://example.com/opendata/7712345678-showrooms/structure-20130401T0000.xsd

Паспорт набора открытых данных (XML)

Требования к публикации паспорта набора открытых данных в машиночитаемом формате XML

1. Требования к расположению:

a. Машиночитаемый формат реестра открытых данных представлен отдельным файлом в формате XML.

b. Файл имеет название «meta.xml».

2. Требования к формату:

a. Соответствие файла стандарту W3C — «Extensible Markup Language (XML) 1.1 (Second Edition)» (http://www.w3.org/TR/xml11/).

b. Кодировка файла указывается в объявлении XML если объявление XML используется, иначе используется кодировка «UTF-8».

3. Требование к структуре данных:

a. Соответствие файлу структуры паспорта набора открытых данных — «meta-schema.xsd» (Содержимое файла «meta-schema.xsd» приложено ниже).

meta.xml (пример)

http://opendata.gosmonitor.ru/standard/3.0 7712345678-showrooms <title>Список выставочных залов</title> Список выставочных залов с указанием контактных данных по округам и районам. Министерство культуры 20130401 20130601T0000 Выставка,зал,выставочный зал,культура xml http://example.com/opendata/7712345678-showrooms/data- 20130601T0000-structure-20130401T0000.xml 20130601T0000 Исправлены незначительные ошибки, добавлены новые выставочные залы 201307010 20130401T0000 http://example.com/opendata/7712345678-showrooms/data- 20130501T0000-structure-20130401T0000.xml 20130501T0000 Добавлены новые выставочные залы 20130601 20130401T0000 http://example.com/opendata/7712345678-showrooms/data- 20130406T0000-structure-20130401T0000.xml 20130406T0000 Исправление критической ошибки 20130501 20130401T0000 http://example.com/opendata/7712345678-showrooms/data- 20130401T0000-structure-20130401T0000.xml 20130401T0000 Первичная публикация 20130501 20130401T0000 http://example.com/opendata/7712345678-showrooms/structure- 20130401T0000.xsd 20130401T0000 Иванов Иван Иванович +74951234567 ivanov@example.com

meta-schema.xsd

<xs:schema xmlns:xs=«http://www.w3.org/2001/XMLSchema» attributeFormDefault=«unqualified» elementFormDefault=«qualified»> <xs:element type=«Meta» name=«meta»/>

<xs:complexType name=«Meta»> xs:annotation <xs:documentation xml:lang=«en»>Opendata metadata.</xs:documentation> <xs:documentation xml:lang=«ru»>Паспорт набора открытых данных.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«xs:anyURI» name=«standardversion»> xs:annotation <xs:documentation xml:lang=«en»>Link to opendata standard version, which corresponds to current opendata meta.</xs:documentation> <xs:documentation xml:lang=«ru»>Ссылка на версию методических рекомендаций, которой соответствует публикация этого паспорта набора открытых данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«identifier»> xs:annotation <xs:documentation xml:lang=«en»>Opendata identification number.</xs:documentation> <xs:documentation xml:lang=«ru»>Идентификационный номер набора данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«title»> xs:annotation <xs:documentation xml:lang=«en»>Opendata title.</xs:documentation> <xs:documentation xml:lang=«ru»>Наименование набора данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«description»> xs:annotation <xs:documentation xml:lang=«en»>Opendata description.</xs:documentation> <xs:documentation xml:lang=«ru»>Описание набора данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«creator»> xs:annotation <xs:documentation xml:lang=«en»>Opendata owner.</xs:documentation> <xs:documentation xml:lang=«ru»>Владелец набора данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«created»> xs:annotation <xs:documentation xml:lang=«en»>Date of first opendata publication in ISO 8601 format.</xs:documentation> <xs:documentation xml:lang=«ru»>Дата первой публикации набора данных в формате ISO 8601.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«modified»> xs:annotation <xs:documentation xml:lang=«en»>Date of last opendata changing in ISO 8601 format.</xs:documentation> <xs:documentation xml:lang=«ru»>Дата последнего внесения изменений в формате ISO 8601.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«subject»> xs:annotation <xs:documentation xml:lang=«en»>Keywords of the opendata content.</xs:documentation> <xs:documentation xml:lang=«ru»>Ключевые слова, соответствующие содержанию набора данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«format»> xs:annotation <xs:documentation xml:lang=«en»>Opendata format.</xs:documentation> <xs:documentation xml:lang=«ru»>Формат данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«Data» name=«data»/> <xs:element type=«Structure» name=«structure»/> <xs:element type=«Publisher» name=«publisher»/> </xs:sequence> </xs:complexType>

<xs:complexType name=«Data»> xs:annotation <xs:documentation xml:lang=«en»>Opendata versions.</xs:documentation> <xs:documentation xml:lang=«ru»>Версии наборов открытых данных.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«DataVersion» name=«dataversion» maxOccurs=«unbounded»/> </xs:sequence> </xs:complexType>

<xs:complexType name=«DataVersion»> xs:annotation <xs:documentation xml:lang=«en»>Opendata.</xs:documentation> <xs:documentation xml:lang=«ru»>Набор открытых данных.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«xs:anyURI» name=«source»> xs:annotation <xs:documentation xml:lang=«en»>Link to opendata file.</xs:documentation> <xs:documentation xml:lang=«ru»>Ссылка на файл набора открытых данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«created»> xs:annotation <xs:documentation xml:lang=«en»>Date of opendata creation in ISO 8601 format.</xs:documentation> <xs:documentation xml:lang=«ru»>Дата создания набора открытых данных в формате ISO 8601.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«provenance»> xs:annotation <xs:documentation xml:lang=«en»>Description of changes compared to the previous opendata version.</xs:documentation> <xs:documentation xml:lang=«ru»>Описание изменений по сравнению с предыдущей версией набора открытых данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«valid»> xs:annotation <xs:documentation xml:lang=«en»>Date on which opendata will be actual in ISO 8601 format.</xs:documentation> <xs:documentation xml:lang=«ru»>Дата, до которой будет актуальным набор открытых данных в формате ISO 8601.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«structure»> xs:annotation <xs:documentation xml:lang=«en»>Creation date of corresponding opendata structure in ISO 8601 format.</xs:documentation> <xs:documentation xml:lang=«ru»>Дата создания соответствующей структуры набора открытых данных в формате ISO 8601.</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType>

<xs:complexType name=«Structure»> xs:annotation <xs:documentation xml:lang=«en»>Opendata structure versions.</xs:documentation> <xs:documentation xml:lang=«ru»>Версии структур наборов открытых данных.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«StructureVersion» name=«structureversion» maxOccurs=«unbounded»/> </xs:sequence> </xs:complexType>

<xs:complexType name=«StructureVersion»> xs:annotation <xs:documentation xml:lang=«en»>Opendata structure.</xs:documentation> <xs:documentation xml:lang=«ru»>Структура набора открытых данных.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«xs:anyURI» name=«source»> xs:annotation <xs:documentation xml:lang=«en»>Link to opendata structure file.</xs:documentation> <xs:documentation xml:lang=«ru»>Ссылка на файл структуры набора открытых данных.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«created»> xs:annotation <xs:documentation xml:lang=«en»>Date of opendata structure creation in ISO 8601 format.</xs:documentation> <xs:documentation xml:lang=«ru»>Дата создания структуры набора открытых данных в формате ISO 8601.</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType>

<xs:complexType name=«Publisher»> xs:annotation <xs:documentation xml:lang=«en»>Opendata publisher.</xs:documentation> <xs:documentation xml:lang=«ru»>Ответственное лицо.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«xs:string» name=«name»> xs:annotation <xs:documentation xml:lang=«en»>Opendata publisher name.</xs:documentation> <xs:documentation xml:lang=«ru»>Имя ответственного лица.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«phone»> xs:annotation <xs:documentation xml:lang=«en»>Opendata publisher phone number.</xs:documentation> <xs:documentation xml:lang=«ru»>Телефон ответственного лица.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«mbox»> xs:annotation <xs:documentation xml:lang=«en»>Opendata publisher e- mail.</xs:documentation> <xs:documentation xml:lang=«ru»>Адрес электронной почты ответственного лица.</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType> </xs:schema>

Паспорт набора открытых данных (JSON)

ТРЕБОВАНИЯ К ПУБЛИКАЦИИ ПАСПОРТА НАБОРА ОТКРЫТЫХ ДАННЫХ В МАШИНОЧИТАЕМОМ ФОРМАТЕ JSON

1. Требования к расположению:

a. Машиночитаемый формат паспорта открытых данных представлен отдельным файлом в формате JSON.

b. Файл имеет название «meta.json».

2. Требования к формату:

a. Соответствие файла стандарту JSON — (http://json.org/json-ru.html).

b. Кодировка файла — «UTF-8».

3. Требование к структуре данных:

a. Соответствие файлу структуры реестра наборов открытых данных — «meta-schema.json» (Содержимое файла «meta-schema.json» приложено ниже).

meta.json (пример)

{ «standardversion»: «http://opendata.gosmonitor.ru/standard/3.0», «identifier»: «7712345678-showrooms», «title»: «Список выставочных залов», «description»: «Список выставочных залов с указанием контактных данных по округам и районам.», «creator»: «Министерство культуры», «created»: «20130401», «modified»: «20130601», «subject»: «Выставка,зал,выставочный зал,культура», «format»: «xml», «data»: [ { «source»: «http://example.com/opendata/7712345678-showrooms/data- 20130601T0000-structure-20130401T0000.xml», «created»: «20130601T0000», «provenance»: «Исправлены незначительные ошибки, добавлены новые выставочные залы.», «valid»: «201307010», «structure»: «20130401T0000» }, { «source»: «http://example.com/opendata/7712345678-showrooms/data- 20130601T0000-structure-20130401T0000.xml», «created»: «20130501T0000», «provenance»: «Добавлены новые выставочные залы.», «valid»: «20130601», «structure»: «20130401T0000» }, { «source»: «http://example.com/opendata/7712345678-showrooms/data- 20130406T0000-structure-20130401T0000.xml», «created»: «20130406T0000», «provenance»: «Исправление критической ошибки.», «valid»: «20130501», «structure»: «20130401T0000» }, { «source»: «http://example.com/opendata/7712345678-showrooms/data- 20130401T0000-structure-20130401T0000.xml», «created»: «20130401T0000», «provenance»: «Первичная публикация.», «valid»: «20130501», «structure»: «20130401T0000» } ], «structure»: [ { «source»: «http://example.com/opendata/7712345678- showrooms/structure-20130401T0000.xsd», «created»: «20130401T0000» } ], «publisher»: { «name»: «Иванов Иван Иванович», «phone»: «+74951234567», «mbox»: «ivanov@example.com» } }

meta-schema.json

{ «$schema»: «http://json-schema.org/draft-04/schema#», «title»: «Opendata metadata», «description»: «Opendata metadata.», «type»: «object», «properties»: { «standardversion»: { «description»: «Link to opendata standard version, which corresponds to current opendata meta.», «type»:«string» }, «identifier»: { «description»: «Opendata identification number.», «type»:«string» }, «title»: { «description»: «Opendata title.», «type»: «string» }, «description»: { «description»: «Opendata description.», «type»: «string» }, «creator»: { «description»: «Opendata owner.», «type»: «string» }, «created»: { «description»: «Date of first opendata publication in ISO 8601 format.», «type»: «string» }, «modified»: { «description»: «Date of last opendata changing in ISO 8601 format.», «type»: «string» }, «subject»: { «description»: «Keywords of the opendata content.», «type»: «string» }, «format»: { «description»: «Opendata format.», «type»: «string» }, «data»: { «description»: «Opendata versions.», «type»: «array», «minItems»: 1, «items»: { «description»: «Opendata.», «type»: «object», «properties»: { «source»: { «description»: «Link to opendata file.», «type»: «string» }, «created»: { «description»: «Date of opendata creation in ISO 8601 format.», «type»: «string» }, «provenance»: { «description»: «Description of changes compared to the previous opendata version.», «type»: «string» }, «valid»: { «description»: «Date on which opendata will be actual in ISO 8601 format.», «type»: «string» }, «structure»: { «description»: «Creation date of corresponding opendata structure in ISO 8601 format.», «type»: «string» } } } }, «structure»: { «description»: «Opendata structure versions.», «type»: «array», «minItems»: 1, «items»: { «description»: «Opendata structure.», «type»: «object», «properties»: { «source»: { «description»: «Link to opendata structure file.», «type»: «string» }, «created»: { «description»: «Date of opendata structure creation in ISO 8601 format.», «type»: «string» } } } }, «publisher»: { «description»: «Opendata publisher.», «type»: «object», «properties»: { «name»: { «description»: «Opendata publisher name.», «type»:«string» }, «phone»: { «description»: «Opendata publisher phone number.», «type»: «string» }, «mbox»: { «description»: «Opendata publisher e-mail.», «type»: «string» } }, «required»: [«name», «phone», «mbox»] } }, «required»: [«identifier», «title», «description», «creator», «created», «modified», «subject», «format», «data», «structure», «publisher»] }

Паспорт набора открытых данных (HTML + RDFa)

Требования к публикации реестра наборов открытых данных в машиночитаемом формате HTML+RDFa

1. Требования к публикации паспорта набора открытых данных в формате HTML+RDFa подробно описаны в приложении 4 данных методических рекомендаций.

meta.html (пример)

<title>Opendata meta</title>

17. Приложение 9. Требование к представлению открытых данных

Файл открытых данных (CSV)

Требования к публикации открытых данных в машиночитаемом формате CSV

1. Требования к расположению файла набора открытых данных:

a. Форматом файла набора открытых данных является CSV.

b. Файл имеет название «data-<Версия набора>-structure-<Версия структуры>.csv», где <Версия набора> это версия набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День», и <Версия структуры> это версия соответствующей структуры набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День». Примечание: данный пункт можно игнорировать если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata.

2. Требования к формату файла набора открытых данных:

a. Соответствие файла стандарту RFC — «Common Format and MIME Type for Comma-Separated Values (CSV) Files» (http://tools.ietf.org/html/rfc4180).

b. Кодировка файла — «UTF-8».

3. Требование к структуре файла набора открытых данных:

a. Файл набора открытых данных соответствует файлу структуры набора открытых данных.

4. Требования к расположению файла структуры набора открытых данных:

a. Файл структуры набора открытых данных представлен отдельным файлом в формате CSV.

b. Файл имеет название «structure-<Версия структуры>.csv», где <Версия структуры> это версия соответствующей структуры набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День». Примечание: данный пункт можно игнорировать если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata.

c. Файл расположен непосредственно в наборе открытых данных. Например, ваш сайт расположен по адресу «http://example.com/», публикуемый набор имеет идентификатор «7712345678-showrooms» и версия структуры набора открытых данных «20130401». Тогда учитывая требование к названию файла и возможные адреса раздела открытых данных, файл набора открытых данных должен быть доступен по одному из следующих адресов:

i. http://example.com/opendata/7712345678-showrooms/structure-20130401.csv

ii. http://opendata.example.com/7712345678-showrooms/structure-20130401.csv

iii. Произвольное расположение файла (только в случае если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata).

5. Требования к формату файла структуры набора открытых данных:

a. Соответствие файла стандарту RFC — «Common Format and MIME Type for Comma-Separated Values (CSV) Files» (http://tools.ietf.org/html/rfc4180).

b. Кодировка файла — «UTF-8».

6. Требование к структуре файла структуры набора открытых данных:

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

b. Наличие следующих обязательных атрибутов поля набора открытых данных:

i. Атрибут поля «Наименование поля набора открытых данных»:

1. Должен быть установлен следующий обязательный заголовок атрибута: «field name».

2. Значением атрибута является наименование поля набора открытых данных.

ii. Атрибут поля «Английское описание поля набора открытых данных»:

1. Должен быть установлен следующий обязательный заголовок атрибута: «english description».

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

iii. Атрибут поля «Русское описание поля набора открытых данных»:

1. Должен быть установлен следующий обязательный заголовок атрибута: «russian description».

2. Значением атрибута является подробное описание поля набора открытых данных на русском языке.

iv. Атрибут поля «Формат поля набора открытых данных»:

1. Должен быть установлен следующий обязательный заголовок атрибута: «format».

2. Значением атрибута является формат поля набора открытых данных на английском языке.

data.csv (пример)

name,district,area,address,telephone

ГБУК г. Москвы «Выставочный зал „Солянка ВПА“,Центральный административный округ,Басманный район,»улица Солянка, дом 1/2, строение 2»,(495) 621-55-72; (495) 621-59-61

ГБУК г. Москвы «Выставочный зал „Творчество“,Центральный административный округ,Таганский район,»Таганская улица, дом 31/22»,(495) 678-55-78

ГБУК г. Москвы «Московский выставочный зал „Галерея А3“,Центральный административный округ,район Арбат,»Староконюшенный переулок, дом 39», (495) 697-14-56

ГБУК г. Москвы «ГВЗ „Ковчег“,Северный административный округ,Тимирязевский район,»улица Немчинова, дом 12»,(499) 977-00-44; (499) 977-00-88

ГБУК г. Москвы «ГВЗ „Галерея на Песчаной“,Северный административный округ,район Сокол,»Новопесчаная улица, дом 23/7»,(499) 943-51-31

ГБУК г. Москвы «ГВЗ „Ростокино“,Северо-Восточный административный округ,район Ростокино,»Ростокинская улица, дом 1»,(499) 187-10-45

ГБУК г. Москвы «ГВЗ „Галерея L“,Северо-Восточный административный округ,район Марьина Роща,»Октябрьская улица, дом 26»,(495) 689-24-91

ГБУК г. Москвы «ГВЗ „Галерея „Измайлово“,Восточный административный округ,район Измайлово,»Измайловский проезд, дом 4»,(499) 166-44-96

ГБУК г. Москвы «Выставочный зал „Богородское“,Восточный административный округ,район Богородское,»Открытое шоссе, дом 5, корпус 6»,(499) 168-30-15

ГБУК г. Москвы «ГВЗ истории войны в Афганистане»,Восточный административный округ,район Перово,«1-я Владимирская улица, дом 12, корпус 1»,(495) 306-43-30

ГБУК г. Москвы «ГВЗ „АРТ-Измайлово“,Восточный административный округ,район Измайлово,»Измайловский бульвар, дом 30»,(499) 367-45-81

ГБУК г. Москвы «Выставочный зал „Арт-холл Юго-восток“,Юго-Восточный административный округ,район Выхино-Жулебино,»Ташкентская улица, дом 9»,(495) 377-21-00; (499) 356-21-10

ГБУК г. Москвы «ГВЗ „Пересветов переулок“,Южный административный округ,Даниловский район,»Пересветов переулок, дом 4, корпус 1»,(495) 675-22-28

ГБУК г. Москвы «ГВЗ-музей „Наследие“,Южный административный округ,район Бирюлево Восточное,»Лебедянская улица, дом 24, корпус 2»,(495) 329-60-39

ГБУК г. Москвы «Выставочный зал „На Каширке“,Южный административный округ,район Нагатино-Садовники,»улица Академика Миллионщикова, дом 35, корпус 5»,(499) 612-95-17; (499) 612-11-61

ГБУК г. Москвы «ГВЗ „Варшавка“,Южный административный округ,Нагорный район,»Варшавское шоссе, дом 75, корпус 1»,(499) 723-10-75

ГБУК г. Москвы «ГВЗ „Замоскворечье“,Южный административный округ,Даниловский район,»улица Серпуховской Вал, дом 24, корпус 2»,(495) 954-30-09

ГБУК г. Москвы «ГВЗ „Галерея Беляево“,Юго-Западный административный округ,район Коньково,»Профсоюзная улица, дом 100»,(495) 335-83-22

ГБУК г. Москвы «ГВЗ „Галерея Нагорная“,Юго-Западный административный округ,район Котловка,»улица Ремизова, дом 10»,(499) 127-47-02

ГБУК г. Москвы «Выставочный зал „Солнцево“,Западный административный округ,район Солнцево,»улица Богданова, дом 44»,(495) 435-66-24; (495) 439-51-80

ГБУК г. Москвы «Выставочный зал „Феникс“,Западный административный округ,Можайский район,»Сколковское шоссе, дом 32, корпус 2»,(495) 417-42-28; (495) 446-40-87; (495) 446-29-64

ГБУК г. Москвы «Выставочный зал „Галерея XXI век“,Западный административный округ,район Фили-Давыдково,»Рублевское шоссе, дом 9»,(495) 445-16-50

ГБУК г. Москвы «Выставочный зал „Тушино“,Северо-Западный административный округ,район Южное Тушино,»бульвар Яна Райниса, дом 19, корпус 1»,(495) 492-23-00

ГБУК г. Москвы «Выставочный зал „Ходынка“,Северо-Западный административный округ,район Щукино,»улица Ирины Левченко, дом 2»,(499) 943-69-41

ГБУК г. Москвы «Выставочный зал „Зеленоград“,Зеленоградский административный округ,район Крюково,»город Зеленоград, корпус 1410»,(499) 717-16-02

structure.csv (пример)

field name,english description,russian description,format

name,Name of showroom.,Название выставочного зала.,string

district,Administrative district of showroom.,Административный округ в котором расположен выставочный зал.,string

area,Municipal area of showroom.,Муниципальный район в котором расположен выставочный зал.,string

address,«Street, building, structure (if any), where showroom is located.»,«Улица, дом, строение (если существует), где расположен выставочный зал.»,string

telephone,«Contact phone numbers of showroom in format (xxx) yyy-yy-yy, separated by „“»; «»», where «xxx» is phone area code.»,«Контактные телефоны выставочного зала в формате (xxx) yyy-yy-yy, разделенные между собой знаком „“»; «»», где «xxx» — телефонный код города.»,string

Набор открытых данных (XML)

Требования к публикации набора открытых данных в машиночитаемом формате XML

1. Требования к расположению файла набора открытых данных:

a. Форматом файла набора открытых данных является XML.

b. Файл имеет название «data-<Версия набора>-structure-<Версия структуры>.xml», где <Версия набора> это версия набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День», и <Версия структуры> это версия соответствующей структуры набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День». Примечание: данный пункт можно игнорировать если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata.

2. Требования к формату файла набора открытых данных:

a. Соответствие файла стандарту W3C — «Extensible Markup Language (XML) 1.1 (Second Edition)» (http://www.w3.org/TR/xml11/).

b. Кодировка файла указывается в объявлении XML, если объявление XML используется, иначе используется кодировка «UTF-8».

3. Требование к структуре файла набора открытых данных:

a. Файл набора открытых данных соответствует файлу структуры набора открытых данных.

4. Требования к расположению файла структуры набора открытых данных:

a. Файл структуры набора открытых данных представлен отдельным файлом в формате XSD.

b. Файл имеет название «structure-<Версия структуры>.xsd», где <Версия структуры> это версия соответствующей структуры набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День». Примечание: данный пункт можно игнорировать, если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata.

c. Файл расположен непосредственно в наборе открытых данных. Например, ваш сайт расположен по адресу «http://example.com/», публикуемый набор имеет идентификатор «7712345678-showrooms» и версия структуры набора открытых данных «20130401». Тогда учитывая требование к названию файла и возможные адреса раздела открытых данных, файл набора открытых данных должен быть доступен по одному из следующих адресов:

i. http://example.com/opendata/7712345678-showrooms/structure-20130401.xsd

ii. http://opendata.example.com/7712345678-showrooms/structure-20130401.xsd

iii. Произвольное расположение файла (только в случае если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata).

5. Требования к формату файла структуры набора открытых данных:

a. Соответствие файла стандарту XML Schema — (http://www.w3.org/TR/xmlschema-0/, http://www.w3.org/TR/xmlschema-1/, http://www.w3.org/TR/xmlschema-2/).

b. Кодировка файла — «UTF-8».

data.xml (пример)

Центральный административный округ ГБУК г. Москвы «Выставочный зал „Солянка ВПА“ Басманный район улица Солянка, дом 1/2, строение 2 (495) 621-55-72; (495) 621-59-61 ГБУК г. Москвы „Выставочный зал „Творчество“ Таганский район Таганская улица, дом 31/22 (495) 678-55-78 ГБУК г. Москвы „Московский выставочный зал „Галерея А3“ район Арбат Староконюшенный переулок, дом 39 (495) 697-14-56 Северный административный округ ГБУК г. Москвы „ГВЗ „Ковчег“ Тимирязевский район улица Немчинова, дом 12 (499) 977-00-44; (499) 977-00-88 ГБУК г. Москвы „ГВЗ „Галерея на Песчаной“ район Сокол Новопесчаная улица, дом 23/7 (499) 943-51-31 Северо-Восточный административный округ ГБУК г. Москвы „ГВЗ „Ростокино“ район Ростокино Ростокинская улица, дом 1 (499) 187-10-45 ГБУК г. Москвы „ГВЗ „Галерея L“ район Марьина Роща Октябрьская улица, дом 26 (495) 689-24-91 Восточный административный округ ГБУК г. Москвы „ГВЗ „Галерея „Измайлово“ район Измайлово Измайловский проезд, дом 4 (499) 166-44-96 ГБУК г. Москвы „Выставочный зал „Богородское“ район Богородское Открытое шоссе, дом 5, корпус 6 (499) 168-30-15 ГБУК г. Москвы „ГВЗ истории войны в Афганистане“ район Перово 1-я Владимирская улица, дом 12, корпус 1 (495) 306-43-30 ГБУК г. Москвы „ГВЗ „АРТ-Измайлово“ район Измайлово Измайловский бульвар, дом 30 (499) 367-45-81 Юго-Восточный административный округ ГБУК г. Москвы „Выставочный зал „Арт-холл Юго-восток“ район Выхино-Жулебино Ташкентская улица, дом 9 (495) 377-21-00; (499) 356-21-10 Южный административный округ ГБУК г. Москвы „ГВЗ „Пересветов переулок“ Даниловский район Пересветов переулок, дом 4, корпус 1 (495) 675-22-28 ГБУК г. Москвы „ГВЗ-музей „Наследие“ район Бирюлево Восточное Лебедянская улица, дом 24, корпус 2 (495) 329-60-39 ГБУК г. Москвы „Выставочный зал „На Каширке“ район Нагатино-Садовники улица Академика Миллионщикова, дом 35, корпус 5 (499) 612-95-17; (499) 612-11-61 ГБУК г. Москвы „ГВЗ „Варшавка“ Нагорный район Варшавское шоссе, дом 75, корпус 1 (499) 723-10-75 ГБУК г. Москвы „ГВЗ „Замоскворечье“ Даниловский район улица Серпуховской Вал, дом 24, корпус 2 (495) 954-30-09 Юго-Западный административный округ ГБУК г. Москвы „ГВЗ „Галерея Беляево“ район Коньково Профсоюзная улица, дом 100 (495) 335-83-22 ГБУК г. Москвы „ГВЗ „Галерея Нагорная“ район Котловка улица Ремизова, дом 10 (499) 127-47-02 Западный административный округ ГБУК г. Москвы „Выставочный зал „Солнцево“ район Солнцево улица Богданова, дом 44 (495) 435-66-24; (495) 439-51-80 ГБУК г. Москвы „Выставочный зал „Феникс“ Можайский район Сколковское шоссе, дом 32, корпус 2 (495) 417-42-28; (495) 446-40-87; (495) 446-29- 64 ГБУК г. Москвы „Выставочный зал „Галерея XXI век“ район Фили-Давыдково Рублевское шоссе, дом 9 (495) 445-16-50 Северо-Западный административный округ ГБУК г. Москвы „Выставочный зал „Тушино“ район Южное Тушино бульвар Яна Райниса, дом 19, корпус 1 (495) 492-23-00 ГБУК г. Москвы „Выставочный зал „Ходынка“ район Щукино улица Ирины Левченко, дом 2 (499) 943-69-41 Зеленоградский административный округ ГБУК г. Москвы „Выставочный зал „Зеленоград“ район Крюково город Зеленоград, корпус 1410 (499) 717-16-02 »

structure.xsd (пример)

<xs:schema xmlns:xs=«http://www.w3.org/2001/XMLSchema» attributeFormDefault=«unqualified» elementFormDefault=«qualified»> <xs:element type=«Showrooms» name=«showrooms»/>

<xs:complexType name=«Showrooms»> xs:annotation <xs:documentation xml:lang=«en»>List of showrooms.</xs:documentation> <xs:documentation xml:lang=«ru»>Список выставочных залов.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«District» name=«district» maxOccurs=«unbounded»> <xs:unique name=«DistrictUnique»> <xs:selector xpath=».//district«/> <xs:field xpath=»code«/> </xs:unique> </xs:element> </xs:sequence> </xs:complexType>»

<xs:complexType name=«District»> xs:annotation <xs:documentation xml:lang=«en»>Administrative district.</xs:documentation> <xs:documentation xml:lang=«ru»>Административный округ.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«DistrictName» name=«name»/> <xs:element type=«Showroom» name=«showroom» maxOccurs=«unbounded»/> </xs:sequence> </xs:complexType>

<xs:complexType name=«Showroom»> xs:annotation <xs:documentation xml:lang=«en»>Showroom.</xs:documentation> <xs:documentation xml:lang=«ru»>Выставочный зал.</xs:documentation> </xs:annotation> xs:sequence <xs:element type=«xs:string» name=«name»> xs:annotation <xs:documentation xml:lang=«en»>Name of showroom.</xs:documentation> <xs:documentation xml:lang=«ru»>Название выставочного зала.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«area»> xs:annotation <xs:documentation xml:lang=«en»>Municipal area of showroom.</xs:documentation> <xs:documentation xml:lang=«ru»>Муниципальный район в котором расположен выставочный зал.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«address»> xs:annotation <xs:documentation xml:lang=«en»>Street, building, structure (if any), where showroom is located.</xs:documentation> <xs:documentation xml:lang=«ru»>Улица, дом, строение (если существует), где расположен выставочный зал.</xs:documentation> </xs:annotation> </xs:element> <xs:element type=«xs:string» name=«telephone»> xs:annotation <xs:documentation xml:lang=«en»>Contact phone numbers of showroom in format (xxx) yyy-yy-yy, separated by «;», where «xxx» is phone area code.</xs:documentation> <xs:documentation xml:lang=«ru»>Контактные телефоны выставочного зала в формате (xxx) yyy-yy-yy, разделенные между собой знаком «;», где «xxx» телефонный код города.</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType>

<xs:simpleType name=«DistrictName»> xs:annotation <xs:documentation xml:lang=«en»>Full list of administrative district.</xs:documentation> <xs:documentation xml:lang=«ru»>Полный список административных округов.</xs:documentation> </xs:annotation> <xs:restriction base=«xs:string»> <xs:enumeration value=«Центральный административный округ»/> <xs:enumeration value=«Северный административный округ»/> <xs:enumeration value=«Северо-Восточный административный округ»/> <xs:enumeration value=«Восточный административный округ»/> <xs:enumeration value=«Юго-Восточный административный округ»/> <xs:enumeration value=«Южный административный округ»/> <xs:enumeration value=«Юго-Западный административный округ»/> <xs:enumeration value=«Западный административный округ»/> <xs:enumeration value=«Северо-Западный административный округ»/> <xs:enumeration value=«Зеленоградский административный округ»/> </xs:restriction> </xs:simpleType> </xs:schema>

Набор открытых данных (JSON)

Требования к публикации набора открытых данных в машиночитаемом формате JSON

1. Требования к расположению файла набора открытых данных:

a. Форматом файла набора открытых данных является JSON.

b. Файл имеет название «data-Версия набора>-structure-<Версия структуры>.json», где <Версия набора> это версия набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День», и <Версия структуры> это версия соответствующей структуры набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День». Примечание: данный пункт можно игнорировать, если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata.

2. Требования к формату файла набора открытых данных:

a. Соответствие файла стандарту JSON — (http://json.org/json-ru.html).

b. Кодировка файла — «UTF-8».

3. Требование к структуре файла набора открытых данных:

a. Файл набора открытых данных соответствует файлу структуры набора открытых данных.

4. Требования к расположению файла структуры набора открытых данных:

a. Файл структуры набора открытых данных представлен отдельным файлом в формате JSON.

b. Файл имеет название «structure-<Версия структуры>.json», где <Версия структуры> это версия соответствующей структуры набора открытых данных в формате «ISO 8601», с точностью не ниже чем «День». Примечание: данный пункт можно игнорировать, если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata.

c. Файл расположен непосредственно в наборе открытых данных. Например, ваш сайт расположен по адресу «http://example.com/», публикуемый набор имеет идентификатор «7712345678-showrooms» и версия структуры набора открытых данных «20130401». Тогда учитывая требование к названию файла и возможные адреса раздела открытых данных, файл набора открытых данных должен быть доступен по одному из следующих адресов:

i. http://example.com/opendata/7712345678-showrooms/structure-20130401.json

ii. http://opendata.example.com/7712345678-showrooms/structure-20130401.json

iii. Произвольное расположение файла (только в случае если паспорт набора открытых данных реализован в одном из следующих форматов: XML, JSON, HTML+RDFa, HTML+Microdata).

5. Требования к формату файла структуры набора открытых данных:

a. Соответствие файла стандарту JSON Schema — (http://json-schema.org/documentation.html).

b. Кодировка файла — «UTF-8».

data.json (пример)

[ { «name»: «Центральный административный округ», «showroom»: [ { «name»: «ГБУК г. Москвы „Выставочный зал „Солянка ВПА“, „area“: „Басманный район“, „address“: „улица Солянка, дом 1/2, строение 2“, „telephone“: „(495) 621-55-72; (495) 621-59-61“ }, { „name“: „ГБУК г. Москвы „Выставочный зал „Творчество“, „area“: „Таганский район“, „address“: „Таганская улица, дом 31/22“, „telephone“: „(495) 678-55-78“ }, { „name“: „ГБУК г. Москвы „Московский выставочный зал „Галерея А3“, „area“: „район Арбат“, „address“: „Староконюшенный переулок, дом 39“, „telephone“: „(495) 697-14-56“ } ] }, { „name“: „Северный административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „ГВЗ „Ковчег“, „area“: „Тимирязевский район“, „address“: „улица Немчинова, дом 12“, „telephone“: „(499) 977-00-44; (499) 977-00-88“ }, { „name“: „ГБУК г. Москвы „ГВЗ „Галерея на Песчаной“, „area“: „район Сокол“, „address“: „Новопесчаная улица, дом 23/7“, „telephone“: „(499) 943-51-31“ } ] }, { „name“: „Северо-Восточный административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „ГВЗ „Ростокино“, „area“: „район Ростокино“, „address“: „Ростокинская улица, дом 1“, „telephone“: „(499) 187-10-45“ }, { „name“: „ГБУК г. Москвы „ГВЗ „Галерея L“, „area“: „район Марьина Роща“, „address“: „Октябрьская улица, дом 26“, „telephone“: „(495) 689-24-91“ } ] }, { „name“: „Восточный административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „ГВЗ „Галерея „Измайлово“, „area“: „район Измайлово“, „address“: „Измайловский проезд, дом 4“, „telephone“: „(499) 166-44-96“ }, { „name“: „ГБУК г. Москвы „Выставочный зал „Богородское“, „area“: „район Богородское“, „address“: „Открытое шоссе, дом 5, корпус 6“, „telephone“: „(499) 168-30-15“ }, { „name“: „ГБУК г. Москвы „ГВЗ истории войны в Афганистане“, „area“: „район Перово“, „address“: „1-я Владимирская улица, дом 12, корпус 1“, „telephone“: „(495) 306-43-30“ }, { „name“: „ГБУК г. Москвы „ГВЗ „АРТ-Измайлово“, „area“: „район Измайлово“, „address“: „Измайловский бульвар, дом 30“, „telephone“: „(499) 367-45-81“ } ] }, { „name“: „Юго-Восточный административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „Выставочный зал „Арт-холл Юго-восток“, „area“: „район Выхино-Жулебино“, „address“: „Ташкентская улица, дом 9“, „telephone“: „(495) 377-21-00; (499) 356-21-10“ } ] }, { „name“: „Южный административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „ГВЗ „Пересветов переулок“, „area“: „Даниловский район“, „address“: „Пересветов переулок, дом 4, корпус 1“, „telephone“: „(495) 675-22-28“ }, { „name“: „ГБУК г. Москвы „ГВЗ-музей „Наследие“, „area“: „район Бирюлево Восточное“, „address“: „Лебедянская улица, дом 24, корпус 2“, „telephone“: „(495) 329-60-39“ }, { „name“: „ГБУК г. Москвы „Выставочный зал „На Каширке“, „area“: „район Нагатино-Садовники“, „address“: „улица Академика Миллионщикова, дом 35, корпус 5“, „telephone“: „(499) 612-95-17; (499) 612-11-61“ }, { „name“: „ГБУК г. Москвы „ГВЗ „Варшавка“, „area“: „Нагорный район“, „address“: „Варшавское шоссе, дом 75, корпус 1“, „telephone“: „(499) 723-10-75“ }, { „name“: „ГБУК г. Москвы „ГВЗ „Замоскворечье“, „area“: „Даниловский район“, „address“: „улица Серпуховской Вал, дом 24, корпус 2“, „telephone“: „(495) 954-30-09“ } ] }, { „name“: „Юго-Западный административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „ГВЗ „Галерея Беляево“, „area“: „район Коньково“, „address“: „Профсоюзная улица, дом 100“, „telephone“: „(495) 335-83-22“ }, { „name“: „ГБУК г. Москвы „ГВЗ „Галерея Нагорная“, „area“: „район Котловка“, „address“: „улица Ремизова, дом 10“, „telephone“: „(499) 127-47-02“ } ] }, { „name“: „Западный административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „Выставочный зал „Солнцево“, „area“: „район Солнцево“, „address“: „улица Богданова, дом 44“, „telephone“: „(495) 435-66-24; (495) 439-51-80“ }, { „name“: „ГБУК г. Москвы „Выставочный зал „Феникс“, „area“: „Можайский район“, „address“: „Сколковское шоссе, дом 32, корпус 2“, „telephone“: „(495) 417-42-28; (495) 446-40-87; (495) 446-29-64“ }, { „name“: „ГБУК г. Москвы „Выставочный зал „Галерея XXI век“, „area“: „район Фили-Давыдково“, „address“: „Рублевское шоссе, дом 9“, „telephone“: „(495) 445-16-50“ } ] }, { „name“: „Северо-Западный административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „Выставочный зал „Тушино“, „area“: „район Южное Тушино“, „address“: „бульвар Яна Райниса, дом 19, корпус 1“, „telephone“: „(495) 492-23-00“ }, { „name“: „ГБУК г. Москвы „Выставочный зал „Ходынка“, „area“: „район Щукино“, „address“: „улица Ирины Левченко, дом 2“, „telephone“: „(499) 943-69-41“ } ] }, { „name“: „Зеленоградский административный округ“, „showroom“: [ { „name“: „ГБУК г. Москвы „Выставочный зал „Зеленоград“, „area“: „район Крюково“, „address“: „город Зеленоград, корпус 1410“, „telephone“: „(499) 717-16-02“ } ] } ]»

structure.json (пример)

{ «$schema»: «http://json-schema.org/draft-04/schema#», «title»: «Showrooms», «description»: «Showrooms.», «type»: «array», «minItems»: 1, «items»: { «description»: «Administrative district.», «type»: «object», «properties»: { «name»: { «description»: «Administrative district name.», «type»:«string» }, «showroom»: { «description»: «List of showrooms.», «type»: «array», «minItems»: 1, «items»: { «description»: «Showroom.», «type»: «object», «properties»: { «name»: { «description»: «Name of showroom.», «type»:«string» }, «area»: { «description»: «Municipal area of showroom.», «type»: «string» }, «address»: { «description»: «Street, building, structure (if any), where showroom is located.», «type»: «string» }, «telephone»: { «description»: «Contact phone numbers of showroom in format (xxx) yyy-yy-yy, separated by »;», where «xxx» is phone area code.», «type»: «string» } }, «required»: [«name», «area», «address», «telephone»] } } }, «required»: [«name», «showroom»] } }

Связанные Наборы открытых данных (XML+RDFa) (linked data)

districts.xml

Центральный административный округ Северный административный округ Северо-Восточный административный округ Восточный административный округ Юго-Восточный административный округ Южный административный округ Юго-Западный административный округ Западный административный округ Северо-Западный административный округ Зеленоградский административный округ

showrooms.xml

ГБУК г. Москвы «Выставочный зал „Солянка ВПА“ Басманный район улица Солянка, дом 1/2, строение 2 (495) 621-55-72; (495) 621-59-61 ГБУК г. Москвы „Выставочный зал „Творчество“ Таганский район Таганская улица, дом 31/22 (495) 678-55-78 ГБУК г. Москвы „Московский выставочный зал „Галерея A3“ район Арбат Староконюшенный переулок, дом 39 (495) 697-14-56 ГБУК г. Москвы „ГВЗ „Ковчег“ Тимирязевский район улица Немчинова, дом 12 (499) 977-00-44; (499) 977-00-88 ГБУК г. Москвы „ГВЗ „Галерея на Песчаной“ район Сокол Новопесчаная улица, дом 23/7 (499) 943-51-31 ГБУК г. Москвы „ГВЗ „Ростокино“ район Ростокино Ростокинская улица, дом 1 (499) 187-10-45 ГБУК г. Москвы „ГВЗ „Галерея L“ район Марьина Роща Октябрьская улица, дом 26 (495) 689-24-91 ГБУК г. Москвы „ГВЗ „Галерея „Измайлово“ район Измайлово Измайловский проезд, дом 4 (499) 166-44-96 ГБУК г. Москвы „Выставочный зал „Богородское“ район Богородское Открытое шоссе, дом 5, корпус 6 (499) 168-30-15 ГБУК г. Москвы „ГВЗ истории войны в Афганистане“ район Перово 1-я Владимирская улица, дом 12, корпус 1 (495) 306-43-30 ГБУК г. Москвы „ГВЗ „АРТ-Измайлово“ район Измайлово Измайловский бульвар, дом 30 (499) 367-45-81 ГБУК г. Москвы „Выставочный зал „Арт-холл Юго-восток“ район Выхино-Жулебино Ташкентская улица, дом 9 (495) 377-21-00; (499) 356-21-10 ГБУК г. Москвы „ГВЗ „Пересветов переулок“ Даниловский район Пересветов переулок, дом 4, корпус 1 (495) 675-22-28 ГБУК г. Москвы „ГВЗ-музей „Наследие“ район Бирюлево Восточное Лебедянская улица, дом 24, корпус 2 (495) 329-60-39 ГБУК г. Москвы „Выставочный зал „На Каширке“ район Нагатино-Садовники улица Академика Миллионщикова, дом 35, корпус 5 (499) 612-95-17; (499) 612-11-61 ГБУК г. Москвы „ГВЗ „Варшавка“ Нагорный район Варшавское шоссе, дом 75, корпус 1 (499) 723-10-75 ГБУК г. Москвы „ГВЗ „Замоскворечье“ Даниловский район улица Серпуховской Вал, дом 24, корпус 2 (495) 954-30-09 ГБУК г. Москвы „ГВЗ „Галерея Беляево“ район Коньково Профсоюзная улица, дом 100 (495) 335-83-22 ГБУК г. Москвы „ГВЗ „Галерея Нагорная“ район Котловка улица Ремизова, дом 10 (499) 127-47-02 ГБУК г. Москвы „Выставочный зал „Солнцево“ район Солнцево улица Богданова, дом 44 (495) 435-66-24; (495) 439-51-80 ГБУК г. Москвы „Выставочный зал „Феникс“ Можайский район Сколковское шоссе, дом 32, корпус 2 (495) 417-42-28; (495) 446-40-87; (495) 446-29- 64 ГБУК г. Москвы „Выставочный зал „Галерея XXI век“ район Фили-Давыдково Рублевское шоссе, дом 9 (495) 445-16-50 ГБУК г. Москвы „Выставочный зал „Тушино“ район Южное Тушино бульвар Яна Райниса, дом 19, корпус 1 (495) 492-23-00 ГБУК г. Москвы „Выставочный зал „Ходынка“ район Щукино улица Ирины Левченко, дом 2 (499) 943-69-41 ГБУК г. Москвы „Выставочный зал „Зеленоград“ район Крюково город Зеленоград, корпус 1410 (499) 717-16-02 »

18. Приложение 10. Методические рекомендации по инструменту доступа к открытым данным (API)

Случаи использования API

API для доступа к открытым данным следует использовать для предоставления доступа к информации, имеющей одно или несколько свойств из следующего списка:

• большие объемы информации;
• часто меняющаяся информация;
• осуществление специфической выборки данных набора.

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

Методы API

В текущей версии Методических рекомендаций рекомендуется реализовывать только методы для просмотра и чтения данных. Добавление, обновление/изменение и удаление данных данной версией Методических рекомендаций не предусмотрено, все вызовы API реализуются HTTP-методом GET.

Адрес доступа к API

Располагайте API интерфейс на отдельном домене — api.example.com, opendataapi.example.com; или в отдельном разделе — example.com/api, example.com/opendataapi.

Адреса вызовов API

Рекомендуется использовать понятные адреса для доступа к информации:

• /showrooms — все выставочные залы Москвы;
• /showrooms/2345 — информация о конкретном выставочном зале.

В базовых адресах рекомендуется использовать существительные во множественном числе без использования глаголов. Конкретные имена лучше абстрактных, так, например: showrooms лучше, чем items.

Рекомендуется базовые адреса делать короткими и простыми, без множества параметров. Все дополнительные параметры рекомендуется указывать в параметрах запроса после знака «?».

Формат ответа API

Так как целевыми потребителями API будут в основном разработчики мобильных приложений и приложений для официальных сайтов, рекомендуемым форматом ответа является JSON. Альтернативным форматом ответа может быть XML.

Если ваш API реализует несколько форматов ответа, то необходимо предусмотреть указание формата в вызове. Лучше всего указывать его в адресе вызова:

/showrooms.json/2345

/showrooms.xml/2345

Также можно передавать формат ответа параметром в запросе:

/showrooms/2345?type=json

/showrooms/2345?type=xml

В случае если формат ответа не был задан в явном виде, API должен поддерживать ответ в формате по умолчанию.

Версионность API

Обязательно предусмотрите возможность выставления версии API при выполнении запроса.

Как реализовывать версионность API?

Номер версии рекомендуется указывать целым числом, без точек; перед номером версии рекомендуется добавлять символ «v».

Рекомендуемым подходом является явное указание версии API в адресе API запроса — api.example.com/v1/showrooms/2345

Также можно передавать номер версии параметром в запросе — api.example.com/showrooms/2345?version=v1

Постраничный ответ

API должен предусматривать постраничный ответ. По умолчанию достаточно отдавать 10 элементов с нулевым смещением.

Постраничность рекомендуется реализовывать в виде двух параметров запроса — число элементов (limit) и смещение (offset):

/showrooms?offset=50&limit=10

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

{ «status»: «200», «request»: {«limit»: «10», «offset»: «50»}, «meta»:{«total»: «2035»}, «results»: {...} }

Частичный ответ

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

/showrooms?fields=name,address

Наименование атрибутов

Атрибуты рекомендуется именовать следуя конвенции camelCase. Но можно выбрать и другую конвенцию, главное следовать ей для наименования всех атрибутов.

Поиск

Ваш API может предлагать интерфейс поиска по данным.

/search?q=search+phrase

/search.xml?q=search+phrase

/showrooms?q=search+phrase

Примеры API запросов и ответов

Запрос:

GET http://api.example.com/v1/showrooms?type=json&limit=3

Ответ:

{ «status»: «200», «request»: {«api»: «v1», «type»: «json», «limit»: «3»}, «meta»: {«total»: «2034»}, «results»: {

        {"name":   "ГБУК  г. Москвы   "Выставочный   зал   "Солянка   ВПА",
"district":   "Центральный   административный   округ",  "area": "Басманный
район",  "address":  "улица  Солянка,  дом 1/2,  строение 2",  "telephone":

«(495) 621-55-72; (495) 621-59-61»}, {«name»: «ГБУК г. Москвы „Выставочный зал „Творчество“, „district“: „Центральный административный округ“, „area“: „Таганский район“, „address“: „Таганская улица, дом 31/22“, „telephone“: „(495) 678-55-78“},»

        {"name": "ГБУК г. Москвы "Московский выставочный зал  "Галерея A3",
"district":  "Центральный  административный  округ", "area": "район Арбат",
"address":    "Староконюшенный    переулок,    дом    39",     "telephone":

«(495) 697-14-56»} } }

Запрос:

GET http://api.example.com/v2/showrooms/3

Ответ:

{ «status»: «200», «request»: {«api»: «v2», «id»: «3»}, «meta»: {}, «results»: {

        {"name": "ГБУК г. Москвы "Московский выставочный зал  "Галерея A3",
"district": "Центральный  административный  округ",  "area": "район Арбат",
"address":    "Староконюшенный    переулок,    дом    39",     "telephone":

«(495) 697-14-56»} } }

Запрос:

GET

http://api.example.com/v1/showrooms?limit=2&offset=1&fields=name,area,address

Ответ:

{ «status»: «200», «request»: {«api»: «v1», «limit»: «2», «offset»: «1», «fields»: «name,area,address»}, «meta»: {«total»: «2034»}, «results»: { {«name»: «ГБУК г. Москвы „Выставочный зал „Творчество“, „area“: „Таганский район“, „address“: „Таганская улица, дом 31/22“}, {„name“: „ГБУК г. Москвы „Московский выставочный зал „Галерея A3“, „area“: „район Арбат“, „address“: „Староконюшенный переулок, дом 39“} } }»