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

Целият регистър на публичните спортни площадки в България — свободен за изтегляне и за ползване през документиран API. Без такса, без одобрение и без регистрация за четене.

Данните се публикуват под ODbL 1.0. Всяко публично ползване изисква посочване на източника: „© OpenStreetMap contributors + POPS community“. Пълни условия на лиценза

API

Документиран и версиониран. Адресите под /api/opendata/v1 не се променят без нова версия — за разлика от емисиите, които обслужват собствената ни карта.

Базов адрес: https://62.238.99.124.sslip.io/api/opendata/v1

Без ключ

API-то отговаря и без ключ. Данните са публични — регистрация за четене на публични данни би била противоречие.

С ключ

Ключът вдига лимита и нищо друго. Изпраща се само в заглавната част Authorization; ключ в адреса на заявката попада във всеки лог по пътя, затова не се приема като параметър.

Вземи безплатен ключ

Меки лимити

30 заявки в минута без ключ, 300 с ключ. Всеки отговор носи RateLimit-заглавия, за да намалите темпото преди да получите отказ. Превишеният лимит връща 429 и указание към пакетите — никога забрана и никога отнет ключ.

Нощните пакети не се ограничават изобщо.

Параметри

format — един от форматите на набора; по подразбиране първият.
limit — горна граница на редовете. Без него се връща целият набор (до предпазен таван).

Пример

curl -H "Authorization: Bearer skbg_…" \
  "https://62.238.99.124.sslip.io/api/opendata/v1/facilities?format=csv"

Набори от данни

Площадки

Целият публичен регистър: по една точка на площадка, с вид спорт, настилка, осветление, режим на достъп, произход и последно съобщено състояние. Съдържа точно това, което посетителят вижда на картата — нито ред повече.

https://62.238.99.124.sslip.io/api/opendata/v1/facilities

Формати: geojson, csv

Поле	Тип	Описание
`slug`	string	Устойчив публичен идентификатор; същият, който стои в адреса на страницата на площадката.
`name`	string	Име на площадката, ако има такова.
`sports`	enum_list	Спортове, разделени с точка и запетая.
`surface`	enum	Настилка.
`lighting`	boolean	Осветление: истина, лъжа или празно, когато не се знае.
`covered`	boolean	Покрита площадка.
`access`	enum	Режим на достъп: свободен, платен, ограничен или училищен.
`status`	enum	Състояние на записа: активен или чака проверка.
`source`

Нощни пакети

Всяка нощ целият регистър се записва наново под версия — календарната дата в София. Старите версии остават на място, така че число, цитирано от определена версия, може да бъде проверено по-късно.

Пазят се последните 30 версии. Ако ви трябва версия за постоянно, запазете свое копие — контролната сума доказва, че е нашата.

Още няма публикувани пакети.

Списък на всички версии (JSON)

Поле	Тип	Описание
`total`	integer	Общо площадки.
`active`	integer	Площадки с потвърден запис.
`needs_verification`	integer	Площадки, които чакат проверка.
`free`	integer	Площадки със свободен достъп.
`paid`	integer	Площадки с платен достъп.
`restricted`	integer	Площадки с ограничен достъп.
`school`	integer	Площадки към училище.
`lit_true`	integer	Площадки с осветление.
`lit_known`	integer	Площадки, за които осветлението е известно.
`lit_unknown`	integer	Площадки, за които осветлението не се знае.
`municipalities_covered`	integer	Общини с поне една площадка.
`sports_count`	integer	Различни спортове в регистъра.
`generated_at`	timestamp	Кога са преизчислени числата.

Поле	Тип	Описание
`ekatte_code`	string	Код по ЕКАТТЕ.
`name_bg`	string	Име на общината на български.
`name_en`	string	Име на общината на английски.
`total`	integer	Общо площадки.
`active`	integer	Площадки с потвърден запис.
`needs_verification`	integer	Площадки, които чакат проверка.
`free`	integer	Площадки със свободен достъп.
`lit_true`	integer	Площадки с осветление.
`lit_known`	integer	Площадки, за които осветлението е известно.
`population`	integer	Официално население на общината; празно, когато няма такава цифра.
`per_10k`	number	Площадки на 10 000 жители; празно, когато няма демографска цифра.

Поле	Тип	Описание
`sport`	enum	Спорт.
`total`	integer	Общо площадки.