Вводная информация

Представленная здесь документация описывает программный интерфейс, с помощью которого можно получить доступ к открытым данным. Данные подготовлены специально для реализации web-приложений в рамка мероприятия Open Data Hackathon Centeral Asia 2015.

Все данные в CSV формате

Все представленные ниже данные в виде единного архива с файлами CSV можно скачать здесь (обновлено 11.06.2015 в 14:25)

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

/budget_expenses_function_reports

Соответственно, вам необходимо импортировать данные из файла budget_expenses_function_reports.csv

Доступ к API

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

http://api-srv.opendata-hackathon.com/school

Где http://api-srv.opendata-hackathon.com/ — адрес API сервера, school — наименование дата-сета.

Далее адреса дата-сетов будут описываться в виде /school, указывается только имя дата-сета адрес сервера опускается, для формирования полного адреса для запроса, адрес сервера вы указываете самостоятельно.

Формат данных

Отправив запрос, в ответ вы получите массив данных в формате JSON — это единственный формат, который предоставляет сервер API.

Фильтрация и упорядочевание

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

eq - сравнение
gt - больше
lt - меньше
gte - больше или равно
lte - меньше или равно 
neq - не равно
like - оператор LIKE
ilike - оператор ILIKE
is - проверка на соответствие (null, true, false)
isnot - проверка на несоответствие (null, true, false)
in - наличие в списке "?a=in.1,2,3"

Примеры:

Фильтр для школы по id:

/school?id=eq.1

Фильтр для нескольких школ по id:

/school?id=in.1,2,3

Фильтр для отчетов за 2005 год или более поздних:

/report?year=gte.2005

Упорядочевание

/people?order=age.desc,height.asc

Какие ресурсы еще можно использовать?

Сервисы картографии

  • Google Maps
  • OpenStreetMap
  • Яндекс.Карты
  • Foursquare

 

Портал ГРС “Отктые данные”

http://data.srs.kg

 

Портал открытых данных Кыргызстана

http://opendata.kg

 

Платформа для распространения геопространственных данных и карт

http://geonode.caiag.kg

 

Департамент лекарственных средств

http://pharm.kg

 

Кыргызгидромет

http://meteo.kg

 

Экономическая карта

http://map.okmot.kg

 

Портал гос. закупок

http://zakupki.okmot.kg

http://zakupki.gov.kg

 

Портал “Открытый бюджет”

http://budget.okmot.kg

 

Портал “Внешняя помощь”

http://donors.okmot.kg

 

Декларации гос. служащих

http://mkk.gov.kg/images/dekl/

 

База данных юридических лиц

http://register.minjust.gov.kg/register/SearchAction.seam

Жогорку Кенеш

Данные обновляются автоматически с сайта kenesh.kg

Депутаты

Списки депутатов содержат следующие поля:

id - уникальный идентификатор депутата
full_name - Фамилия И. О. депутата

Получить список всех депутатов:

/deputy

CSV

Результаты голосования

Данные по голосованию содержат следующие поля:

id - уникальный идетификатор записи
title - наименование законопроекта
deputy_id - уникальный идентификатор депутата
full_name - имя депутата
date - дата и время голосования
protocol_number - номер протокола
result - результат голосования (за, против, отсутствовал)

Выбрать всех проголосовавших «за» по номеру протокола:

/vote_result?protocol_number=eq.1&result=eq.за

Выбрать все результаты голосования определенного депутата:

/vote_result?deputy_id=eq.1

где 1 — уникальный идентификатор депутата

CSV

Классификации

Списки классификаций содержат в себе наименования и коды, которые используются в отчетности различных ведомств. Данные взяты с сайта minfin.kg Актуальность 26 мая 2015 г.

Ведомственная классификация

Возвращаемые поля классификации:

code - Код классификации
title - Наименование классификации

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

/departments_classification

CSV

Классификация функций органов государственного управления

Возвращаемые поля классификации:

code - Код классификации
title - Наименование классификации

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

/functions_classification

CSV

Классификация операций с активами и обязательствами

Возвращаемые поля классификации:

code - Код классификации
title - Наименование классификации

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

/actives_classification

CSV

Бюджетная классификация расходов

Возвращаемые поля классификации:

code - Код классификации
title - Наименование классификации

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

/budget_expenses_classification

CSV

Бюджетная классификация доходов

Возвращаемые поля классификации:

code - Код классификации
title - Наименование классификации

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

/budget_incoming_classification

CSV

Отчеты по исполнению бюджета

Данные взяты с сайта http://stat.kg. Актуальность 26 мая 2015 г.

Расходы гос. бюджета

отчеты имеют следующие поля:

id - уникальный идентификатор отчета
сode - код классификации см. Классификация функций органов государственного управления
value - значение
month - месяц
year - год

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

/budget_expenses_function_reports?code=eq.01

где 01 — код интересующей вас классификации.

CSV

Доходы гос. бюджета

отчеты имеют следующие поля:

id - уникальный идентификатор отчета
сode - код классификации см. Бюджетная классификация
value - значение
month - месяц
year - год

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

/budget_incoming_reports?code=eq.01

где 01 — код интересующей вас классификации.

CSV

Показатели здравоохранения

Данные взяты с сайта http://stat.kg. Актуальность 26 мая 2015 г.

Заболеваемость активным туберкулезом по полу, возрасту и территории

Данные по статистики содержат следующие поля:

id - уникальный идентификатор записи
region_id - идентификатор региона см. Территориальное деление
year - год 
gender - пол (1-мужчины, 0-женщины)
number - количество

Для получения данных по региону надо отправить запрос на следующий адрес с параметрами:

/tuberculosis?region_id=eq.1

где 1 — id региона.

за определенный год:

/tuberculosis?year=eq.2000

где 2000 — интересующий вас год.

по полу:

/tuberculosis?gender=eq.1

где 1 — указание на мужской пол, (0-женский).

CSV

Число ВИЧ-инфицированных, по полу и территории

Данные по статистики содержат следующие поля:

id - уникальный идентификатор записи
region_id - идентификатор региона см. Территориальное деление
year - год 
gender - пол (1-мужчины, 0-женщины)
number - количество

Для получения данных по региону надо отправить запрос на следующий адрес с параметрами:

/aids?region_id=eq.1

где 1 — id региона.

за определенный год:

/aids?year=eq.2000

где 2000 — интересующий вас год.

по полу:

/aids?gender=eq.1

где 1 — указание на мужской пол, (0-женский).

CSV

Основные классы болезней

Данные по основным классам следующие поля:

id - уникальный идентификатор записи
title - наименование болезни

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

/disease_type

CSV

Заболеваемость населения по основным классам болезней по полу и территории

Данные по статистики содержат следующие поля:

id - уникальный идентификатор записи
region_id - идентификатор региона см. Территориальное деление
year - год
disease_id - идентификатор заболевания
gender - пол (1-мужчины, 0-женщины)
number - количество

Для получения данных по региону надо отправить запрос на следующий адрес с параметрами:

/primary_disease?region_id=eq.1

где 1 — id региона.

за определенный год:

/primary_disease?year=eq.2000

где 2000 — интересующий вас год.

по полу:

/primary_disease?gender=eq.1

где 1 — указание на мужской пол, (0-женский).

CSV

Заболеваемость наркологическими расстройствами по полу и территории

Данные по статистики содержат следующие поля:

id - уникальный идентификатор записи
region_id - идентификатор региона см. Территориальное деление
year - год 
gender - пол (1-мужчины, 0-женщины)
number - количество

Для получения данных по региону надо отправить запрос на следующий адрес с параметрами:

/drug_addict?region_id=eq.1

где 1 — id региона.

за определенный год:

/drug_addict?year=eq.2000

где 2000 — интересующий вас год.

по полу:

/drug_addict?gender=eq.1

где 1 — указание на мужской пол, (0-женский).

CSV

Заболеваемость алкогольной зависимостью по полу и территории

Данные по статистики содержат следующие поля:

id - уникальный идентификатор записи
region_id - идентификатор региона см. Территориальное деление
year - год 
gender - пол (1-мужчины, 0-женщины)
number - количество

Для получения данных по региону надо отправить запрос на следующий адрес с параметрами:

/alcoholics?region_id=eq.1

где 1 — id региона.

за определенный год:

/alcoholics?year=eq.2000

где 2000 — интересующий вас год.

по полу:

/alcoholics?gender=eq.1

где 1 — указание на мужской пол, (0-женский).

CSV

Заболеваемость населения анемией по полу и территории

Данные по статистики содержат следующие поля:

id - уникальный идентификатор записи
region_id - идентификатор региона см. Территориальное деление
year - год 
gender - пол (1-мужчины, 0-женщины)
number - количество

Для получения данных по региону надо отправить запрос на следующий адрес с параметрами:

/anemia?region_id=eq.1

где 1 — id региона.

за определенный год:

/anemia?year=eq.2000

где 2000 — интересующий вас год.

по полу:

/anemia?gender=eq.1

где 1 — указание на мужской пол, (0-женский).

CSV

Прерывание беременности (аборты) в возрасте 18-49 лет

Данные по статистики содержат следующие поля:

id - уникальный идентификатор записи
region_id - идентификатор региона см. Территориальное деление
year - год 
number - количество

Для получения данных по региону надо отправить запрос на следующий адрес с параметрами:

/abort_adult?region_id=eq.1

где 1 — id региона.

за определенный год:

/abort_adult?year=eq.2000

где 2000 — интересующий вас год.

CSV

Прерывание беременности (аборты) в возрасте 15-17 лет

Данные по статистики содержат следующие поля:

id - уникальный идентификатор записи
region_id - идентификатор региона см. Территориальное деление
year - год 
number - количество

Для получения данных по региону надо отправить запрос на следующий адрес с параметрами:

/abort_teen?region_id=eq.1

где 1 — id региона.

за определенный год:

/abort_teen?year=eq.2000

где 2000 — интересующий вас год.

CSV

Таможня

Списки таможенных классфикаторов, взяты с сайта www.eais.customs.kg. Данные по импорту и экспорту взяты с сайта www.customs.kg

Отчеты по импорту товаров по странам

Дата-сет содержит в себе таможеные отчеты по импорту товаров по странам. Записи имеют следующие поля:


id - уникальный идентификатор отчета
code - код страны
year - год
weight - общий вес товаров
usd_sum - сумма в долларах
som_sum - сумма в сомах

Выбрать отчеты по коду страны:

/foreign_trade_by_country_import

CSV

Отчеты по экспорту товаров по странам

Дата-сет содержит в себе таможеные отчеты по экспорту товаров по странам. Записи имеют следующие поля:


id - уникальный идентификатор отчета
code - код страны
year - год
weight - общий вес товаров
usd_sum - сумма в долларах
som_sum - сумма в сомах

Выбрать отчеты по коду страны:

/foreign_trade_by_country_export

CSV

Отчеты по экcпорту товаров

Дата-сет содержит в себе таможеные отчеты по экспорту товаров. Записи имеют следующие поля:


id - уникальный идентификатор отчета
goods_code - код товарной классификации
year - год
weight - общий вес товаров
usd_sum - сумма в долларах
som_sum - сумма в сомах

Выбрать отчеты по коду классификации товара:

/foreign_trade_export

CSV

Отчеты по импорту товаров

Дата-сет содержит в себе таможеные отчеты по импорту товаров. Записи имеют следующие поля:


id - уникальный идентификатор отчета
goods_code - код товарной классификации
year - год
weight - общий вес товаров
usd_sum - сумма в долларах
som_sum - сумма в сомах

Выбрать отчеты по коду классификации товара:

/foreign_trade_import

CSV

Классификация стран

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

code - код классификации
title - наименование страны

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

/foreign_trade_country

CSV

Классификация товаров

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

code - код классификации
title - наименование товара

Для того что бы получить список всех классификаций товаров:

/foreign_trade_goods

CSV

Территориальное деление

Группа дата-сетов состоит из двух разделов, в которых хранятся списки регионов и входящих в них областей Кыргызской республики. Данные сформированы на основе статьи. Актуальность 26 мая 2015 г.

Регионы

Регионы включают в себя семь областей и два города:

  1. г. Бишкек
  2. г. Ош
  3. Баткенская область
  4. Джалал-Абадская область
  5. Иссык-Кульская область
  6. Нарынская область
  7. Ошская область
  8. Таласская область
  9. Чуйская область

В приведенном выше списке номера соответствуют id региона.

Возвращаемые поля региона:

id - Уникальный идентификатор региона
title - Наименование региона

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

/region

Для того, что бы получить регион по id отправляем запрос на адрес:

/region?id=eq.1

где 1 — id региона

CSV

Районы

Районы включают в себя районы и города привязанные к регионам.
Возвращаемые поля района:

id - Уникальный идентификатор района
region_id - Уникальный идентификатор региона, за которым закреплен район
title - Наименование района

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

/district

Для того, что бы получить район по id отправляем запрос на адрес:

/district?id=eq.1

где 1 — id района

Для того, что бы получить список районов по id региона отправляем запрос на адрес:

/district?region_id=eq.1

где 1 — id региона

CSV

Школы и тестирование

Данные по школам предоставлены Министерством образования КР

Школы

Источник данных: Министерство образования. Данные не публиковались на сайте министерства, и были предоставлены специально для этого проекта.

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

Возвращаемые поля школы:

id - Уникальный идентификатор школы
district_id - Уникальный идентификатор района, за которым закреплена школа см. Территориальное деление
title - Наименование школы
address - Адрес школы
phone - Телефоны школы

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

/school

Для того, что бы получить школу по id отправляем запрос на адрес:

/school?id=eq.1

где 1 — id школы

Для того, что бы получить школы по id района отправляем запрос на адрес:

/school?district_id=eq.1

где 1 — id района

CSV

Результаты тестирования

В этом дата-сете хранятся результаты национального тестирования учеников 11-х классов за 2015 г. Данные взяты с сайта ntc.kg, 20 мая 2015 г.

Записи результатов содержат следующие поля:

id - уникальный идентификатор записи
full_name - имя ученика
math - количество баллов по математике
physics - количество баллов по физики
chemistry - количество баллов по химии
geometry - количество баллов по геометрии
biology - количество баллов по биологии
geography - количество баллов по географии
history - количество баллов по истории
english_lang - количество баллов по английскому языку
german_lang - количество баллов по немецкому языку
french_lang - количество баллов по францускому языку
kyrgyz_lang - количество баллов по кыргызскому языку
russian_lang - количество баллов по русскому языку
uzbek_lang - количество баллов по узбекскому языку
informatics - количество баллов по информатики
civics - количество баллов по граждановедению
notes - заметка проводящего тестирование
school_id - id школы

Выбрать всех учеников из одной школы:

/ntc_result?school_id=eq.1

CSV