Отворени данни

На тази страница можете да се запознаете с данните, които използваме в своите анализи, или които са резултат от нашата работа. Публикувани са само данни, за които ОП "Софияплан" няма изрична забрана за разпространение. Данните са достъпни за изтегляне чрез бутона "връзка", както и чрез приложен програмен интерфейс (API), инструкции за използването на който можете да видите по-надолу. Отворените данни са ключов елемент от разбирането ни за прозрачност, въвличане и споделена работа в сферата на градските изследвания. Ще се радваме да ни информирате за какви цели и с какъв резултат сте използвали споделените на тази страница данни.

Освен на тази страница, можете да достъпвате автоматизирано данни (от географско естество) и на нашия ГИС портал, достъпен от менюто "Карти". Инструкции за това вижте също по-долу.

Как да използвам тази страница?

На страницата се зареждат автоматично всички набори от данни, които към настоящия момент са достъпни за изтегляне от ОП "Софияплан". За всеки от наборите можете да видите неговото описание, категория спрямо групите ресурси на Общия устройствен план, както и дата, към която наборът е актуален. Някои набори са един и същи вид данни, но към различни дати (предстои тяхното групиране). Можете също така да търсите конкретен набор или конкретна категория, ползвайки полето "Търси". Всеки набор указва и размера на файла, който можете да изтеглите.

Как да използвам API за достъп до данните (приложен програмен интерфейс)?

Можете да достъпите API за отворени данни на ОП "Софияплан" на адрес: https://api.sofiaplan.bg. По-долу следва описание на различните входни точки (endpoints) на интерфейса.

• /version -- Позволява да проверите текущата версия на API. Моля, имайте предвид, че Вашето приложение за достъп до данните може да има нужда от обновяване, когато версията на API се промени. Очакваме да въведем промени и подобрения в предлаганата информация. Резултатът е във формат JSON с едно поле с име "version" и низова стойност.
• /datasets -- Позволява да достъпите списък с всички налични набори от данни. Резултатът е във формат JSON и представлява масив от набори от данни, всеки от които е представен със следните метаданни:
  • id -- уникален идентификатор (целочислено поле)
  • name -- име на ресурса (низ)
  • description -- описание на ресурса (низ)
  • category -- категория на ресурса спрямо групите ресурси на ОУП (низ)
  • provider -- източник на данните (низ)
  • relevant_at -- дата на валидност на данните (низ в ISO формат за дати)
  • row_count -- брой обекти в ресурса (зависи от ресурса, целочислено поле)
  • size -- размер на файла, представящ ресурса (низ)
• /datasets/:id -- Позволява да бъде изтеглен ресурс по неговия идентификатор (полето id от предишната входна точка). Резултатът е файлов ресурс във формат geojson за географските данни и различни формати за останалите данни. Параметърът в пътя на входната точка :id трябва да бъде цяло число и валиден идентификатор.

Мога ли да ползвам данните свободно?

Данните могат да се ползват свободно. Ще се радваме да ни информирате за какви цели и с какъв резултат сте използвали споделените на тази страница данни.

Това всички данни, с които работи Софияплан ли са?

Имаме право да предоставим само част от данните, с които работим. Данни като кадастралната карта, регулация и др. нямаме право да споделяме. За достъп до тях е необходимо да се обърнете към източника на съответните данни.

Мога ли да видя географските данни визуализирани?

Част от данните, публикувани тук, са представени и на ГИС портала ни, достъпен от менюто "Карти". Отваряйки някоя от картите, които ГИС порталът предлага, можете да ползвате менюто за разработчици горе вдясно, за да се сдобиете с линковете към различни формати на сервиране на данните. В ГИС портала са налични и данни, които не са показани на тази страница, тъй като се отнасят за конкретна територия (изследване), докато показаните тук данни са за целия град, или община.

Какви промени планирате по API?

На този етап планираме поне още една версия на интерфейса, която да позволи обединяването на общи ресурси от различни дати. При обновена схема на данните, ще обновим и настоящата страница, както и версията на API.