Предварительный анонс API справочника административно-территориального деления в OpenGovData.ru

Если кто помнит я не раз обращался к теме административно-территориального деления России и писал что думаю как лучше её представить. Была попытка сделать его в OWL/RDF — http://schema.opengovdata.ru/core/regions.owl

Но не очень результативная, с OWL данными в России умеют работать немногие, да и для интеграции в веб-проекты они неудобны.

По прошествии времени, лучшее из возможных представлений что мне удалось придумать — это API возвращающее данные в формате JSON.

И вот его первый и предварительный набросок.

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

В рамках API — это интерфейсы list, oneview и query.

И соответственно как ими пользоваться.

Вот примеры доступа к получению информации о регионах

http://api.opengovdata.ru/regions/v1/region/list/ — возвращает список регионов в JSON

http://api.opengovdata.ru/regions/v1/region/key/50/ — возвращает профиль одного региона в JSON

http://api.opengovdata.ru/regions/v1/region/query/ — возвращает список регионов по запросу (пустому)

http://api.opengovdata.ru/regions/v1/region/query/?timezoneUTC=11 — список регионов во временной зоне 11

http://api.opengovdata.ru/regions/v1/region/query/?timezoneUTC=3&regType=республика — возвращает список республик по временной зоне 3

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

Для запросов query можно осуществлять навигацию по результатам используя параметры start и limit которые по умолчанию равны 0 и 50 соответственно.

Однако кроме регионов есть и другие понятия собранные там же и общий список таков.

Группы

Это все возможные группировки региона собранные вместе для унификации.

Список — http://api.opengovdata.ru/regions/v1/group/list/

Пример — http://api.opengovdata.ru/regions/v1/group/key/sfo/

Запрос — http://api.opengovdata.ru/regions/v1/group/query/

Типы групп

Группы разделены по типам их происхождения.

Список — http://api.opengovdata.ru/regions/v1/gtype/list/

Пример — http://api.opengovdata.ru/regions/v1/gtype/key/roadrelated/

Запрос — http://api.opengovdata.ru/regions/v1/gtype/query/

Отношения

Отношения определяют то как регион относится к другому региону, а также отношения между различными группами .

Запрос к отношениям между регионами — http://api.opengovdata.ru/regions/v1/regrel/query/

Включает типы отношений:

— bordering: регион-регион — граница

— memberof: регион-группа — вхождение региона в группу

Запрос к отношениям между группами — http://api.opengovdata.ru/regions/v1/grouprel/query/

Включает типы отношений

— bordering: группа-группа — граница между группами

— intersect — две группы пересекаются общими регионами

— subset — группа является подгруппой другой группы

— superset — группа включает другую группу.

Федеральные округа

Федеральные округа согласно их делению

Список — http://api.opengovdata.ru/regions/v1/feddistrict/list/

Пример — http://api.opengovdata.ru/regions/v1/feddistrict/key/Southern_Federal_District/

Запрос — http://api.opengovdata.ru/regions/v1/feddistrict/query/

Военные округа

Военные округа в новой редакции округов

Список — http://api.opengovdata.ru/regions/v1/mildistrict/list/

Пример — http://api.opengovdata.ru/regions/v1/mildistrict/key/West_Military_District/

Запрос — http://api.opengovdata.ru/regions/v1/mildistrict/query/

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

Межрегиональные организации

Организации имеющие представительства в более чем одном регионе. Например, казачьи войска.

Список — http://api.opengovdata.ru/regions/v1/org/list/

Пример — http://api.opengovdata.ru/regions/v1/org/key/turksoy/

Запрос — http://api.opengovdata.ru/regions/v1/org/query/

Трубопроводы

Нефте и газопроводы

Список — http://api.opengovdata.ru/regions/v1/pipeline/list/

Пример — http://api.opengovdata.ru/regions/v1/pipeline/key/vsto/

Запрос — http://api.opengovdata.ru/regions/v1/pipeline/query/

Арбитражные округа

Округа арбитражных судов

Список — http://api.opengovdata.ru/regions/v1/arbdistrict/list/

Пример — http://api.opengovdata.ru/regions/v1/arbdistrict/key/fasuo/

Запрос — http://api.opengovdata.ru/regions/v1/arbdistrict/query/

Железные дороги

Управления железных дорог РЖД

Список — http://api.opengovdata.ru/regions/v1/railregion/list/

Пример — http://api.opengovdata.ru/regions/v1/railregion/key/yuzd/

Запрос — http://api.opengovdata.ru/regions/v1/railregion/query/

Бассейновые управления

Бассейновые управления Росводресурсов

Список — http://api.opengovdata.ru/regions/v1/bvu/list/

Пример — http://api.opengovdata.ru/regions/v1/bvu/key/nobvu/

Запрос — http://api.opengovdata.ru/regions/v1/bvu/query/

Экономическая зона

Экономические зоны

Список — http://api.opengovdata.ru/regions/v1/ecoarea/list/

Пример — http://api.opengovdata.ru/regions/v1/ecoarea/key/West_Siberian_economic_region/

Запрос — http://api.opengovdata.ru/regions/v1/ecoarea/query/

Федеральная трасса

Описание федеральной трассы

Список — http://api.opengovdata.ru/regions/v1/fedroad/list/

Пример — http://api.opengovdata.ru/regions/v1/fedroad/key/M9/

Запрос — http://api.opengovdata.ru/regions/v1/fedroad/query/

Граница

Граница между двумя регионами или между регионом и зарубежной страной

Список — http://api.opengovdata.ru/regions/v1/border/list/

Пример — http://api.opengovdata.ru/regions/v1/border/key/borderR86R89/

Запрос — http://api.opengovdata.ru/regions/v1/border/query/

——————-

Пока всё это без документации. Физически мало времени её подготовить, но она будет обязательно. В принципе же все названия параметров в JSON подобраны таким образом чтобы они были максимально понятны. А я готов отвечать на вопросы если они появятся.

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

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

Сейчас уже практически готовы несколько таблиц из переписи-2002, данные региональных индикаторов Центробанка, данные по муниципальному и региональному долгу и ещё несколько банков данных.

Ну, а, в принципе, по плану я хочу свести в api.opengovdata.ru и другие открытые банки информации. С акцентом на их качестве, а не массовости.

Предложения, пожелания, критика всячески приветствуются.

About This Author

  • http://many Евгений

    Большое человеческое СПАСИБО!

Яндекс.Метрика