Получение данных с портала data.gov.spb.ru

Получение данных с портала data.gov.spb.ru

Возможность скачивать данные с портала через API предоставляется только зарегистрированным пользователям. Регистрация очень простая и быстрая (фамилия, имя, отчество, дата рождения, email, пароль). После регистрации в личном кабинете можно посмотреть свой личный API-токен. Далее его нужно будет передавать в HTTP Header в формате “Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b”. Далее будет использоваться токен, который размещен на портале, как пример. В реальных запросах его следует заменить на Ваш личный токен, тогда все будет работать.

Все данные скачиваются в формате json.

Скачивание данных через командную строку

Запрос в командной строке -- самый быстрый способ получить данные с портала через API:

curl http://data.gov.spb.ru/api/v1/datasets/78/versions/13/data/ -H 'Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b’

Ссылка меняется в зависимости от того, какой набор данных нужно получить. Далее будет использоваться набор данных с id = 78 (Объекты недвижимого имущества и земельные участки).

Запросы к разным наборам данных

Паспорт набора данных

Запрос к ресурсу /datasets/{id}/ возвращает описание набора данных.

Запрос GET http://data.gov.spb.ru/api/v1/datasets/78/

Ответ

{
   "agency":"Комитет имущественных отношений Санкт-Петербурга",
   "description":"Перечень объектов недвижимого имущества, в т.ч. ЗУ, включенные в Реестр собственности СПб.",
   "responsible_fio":"Козак Людмила Александровна",
   "responsible_phone":"5764854",
   "responsible_email":"[email protected]",
   "category":"Земля и имущество",
   "inf_system":"ИТС КУГИ Реестр",
   "periodicity":"Ежемесячно",
   "has_geodata":true,
   "tags":["реестр"],
   "data_set_url":"http://www.commim.spb.ru/objects/realty",
   "additional_description":""
}

Формат возвращаемого объекта

agency – Название организации поставщика
responsible_fio – Фио ответственного
responsible_phone — Телефон ответственного
responsible_email – Email  ответственного
category – Название категории набора данных
periodicity – Переодичность обновления данных
has_geodata – Флаг того, что набор данных содержит геоданные
tags – Теги, которые содержит набор
data_set_url - Ссылка на данные на сайте поставщика

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

Запрос к ресурсу /datasets/{id}/versions/latest/ возвращает описание последней версии данных.

Запрос GET http://data.gov.spb.ru/api/v1/datasets/78/versions/latest/

{
   "num_id":13,
   "create_at":"01.04.2016",
   "structure":
     [{
          "data_type":"Строка",
          "title":"region",
          "name":"Район",
          "description":"наименование района",
          "dimension":30,
          "is_primary":false
      },
      {
          "data_type":"Строка",
          "title":"obj_type",
          "name":"Тип объекта",
          "description":"тип объекта",
          "dimension":60,"is_primary":false
      },
      {
          "data_type":"Строка",
          "title":"address",
          "name":"Адрес",
          "description":"адрес объекта",
          "dimension":999,"is_primary":false
      },
      {
          "data_type":"Строка",
          "title":"obj_reestr_num",
          "name":"Реестровый номер",
          "description":"реестровый номер объекта",
          "dimension":30,
          "is_primary":false
      },
      {
          "data_type":"Строка",
          "title":"right",
          "name":"Правовой режим",
          "description":"правовой режим",
          "dimension":50,"is_primary":false
      },
      {
          "data_type":"Дробное число",
          "title":"obj_sqr",
          "name":"Площадь",
          "description":"площадь объекта",
          "dimension":null,
          "is_primary":false
      },
      {
          "data_type":"Строка",
          "title":"obj_kd_nmb",
          "name":"Кадастровый номер",
          "description":"кадастровый номер объекта",
          "dimension":25,
          "is_primary":false
      },
      {
          "data_type":"Текст",
          "title":"obj_dolya_spb",
          "name":"Доля Санкт-Петербурга в праве",
          "description":"доля СПб в праве на объект",
          "dimension":30,
          "is_primary":false
      },
      {
          "data_type":"Строка",
          "title":"obj_use",
          "name":"Использование",
          "description":"использование объекта",
          "dimension":200,
          "is_primary":false
      },
      {
          "data_type":"Дробное число",
          "title":"cost",
          "name":"Остаточная стоимость",
          "description":"остаточная стоимость",
          "dimension":null, 
          "is_primary":false
      },
      {
          "data_type":"Дата",
          "title":"cost_date",
          "name":"На дату",
          "description":"Дата оценки",
          "dimension":null,
          "is_primary":false
      },
      {
          "data_type":"Дробное число",
          "title":"kad_cost",
          "name":"Кадастровая стоимость ЗУ",
          "description":"кадастровая стоимость ЗУ",
          "dimension":null,"is_primary":false
      },
      {
          "data_type":"Текст",
          "title":"right_doc",
          "name":"Основание регистрации права СПб",
          "description":"основание права СПб",
          "dimension":600,
          "is_primary":false
      },
      {
          "data_type":"Целое число",
          "title":"obj_id",
          "name":"Уникальный код",
          "description":"Уникальный код",
          "dimension":null,
          "is_primary":true
       }]
}

Формат возвращаемого объекта

"num_id" – id версии набора
"create_at" – дата создания версии набора
"structure" – Перечень атрибутов набора данных. Представлен в виде массива элементов вида:
"data_type" – тип поля данных
"title" -  имя атрибута
"name" – русское имя атрибута
"description" – описание атрибута
"dimension" – размерность атрибута (null без размерности)
"is_primary" – флаг, указывающий является ли атрибут ключом

Содержимое версии набора данных

Запрос к ресурсу /datasets/{id}/versions/latest/data/ возвращает содержимое последней версии набора. Запрос к ресурсу /datasets/{id}/versions/{num_id}/data/ возвращает набора по id версии.

Структура ответа

[
    {
        "num_id": 1,
        "row":
            {
                "id": "1",
                "name": "Элемент 1"
            }
     },
     {
                "num_id": 2,
                "row":
             {
                "id": "2",
                "name": "Элемент 2"
             }
     },
     {
                "num_id": 3,
                "row":
             {
                "id": "3",
                "name": "Элемент 3"
             }
      }
 ]

Формат возвращаемого объекта

num_id - Порядковый номер строки данных
row - Объект, содержащий значения атрибутов для данной строки

Запрос GET http://data.gov.spb.ru/api/v1/datasets/78/versions/latest/data/

Ответ

  [
     {
      "num_id":1,
      "row":
         {
             "obj_type":"здание",
             "right":"Оперативное управление",
             "obj_id":"100196373",
             "obj_dolya_spb":"1",
             "region":"Фрунзенский",
             "obj_kd_nmb":"78:13:0007430:3009",
             "kad_cost":"",
             "obj_sqr":"1972.7", 
             "cost":"7384577.41",
             "obj_use":"детский сад №41",
             "cost_date":"01.01.2015",
             "address":"192288, г.Санкт-Петербург, Бухарестская улица, д. 114, к. 3, литера А",
             "right_doc":"Пункт 2 Постановления Верховного Совета РФ №3020-1 от 27.12.1991г.",
             "obj_reestr_num":"2414В000100000"
          }
     },
     {
     "num_id":2,
     "row": 
          {
             "obj_type":"здание",
             "right":"Имущество казны",
             "obj_id":"100105361",
             "obj_dolya_spb":"1",
             "region":"Колпинский",
             "obj_kd_nmb":"78:37:0017111:1086",
             "kad_cost":"",
             "obj_sqr":"41.1",
             "cost":"51943.61",
             "obj_use":"производственный",
             "cost_date":"01.01.2013",
             "address":"196650, Санкт-Петербург, город Колпино, проспект Ленина, д. 59, к. 2, литера А",
             "right_doc":"Пункт 2 Постановления Верховного Совета РФ №3020-1 от 27.12.1991г.",
             "obj_reestr_num":"0024К207200000"
           }
       },
       {
         "num_id":3,
         "row": 
              {
                 ...
              }
        },
        ...
       }
      ]

Более подробно с разными видами запросов можно ознакомиться на сайте http://data.gov.spb.ru/developers/