Документація API

Програмний доступ до даних укриттів

API Schutzraum надає публічний доступ лише для читання до всіх даних про укриття. Автентифікація не потрібна.

Базовий URLhttps://schutzraum.app

Будь ласка, використовуйте API відповідально. Надмірні запити можуть бути обмежені.

GET/api/shelters

Повертає посторінковий список укриттів з можливістю фільтрації.

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
`page`	number	Ні	1	Page number
`limit`	number	Ні	20	Items per page (1–10000)
`type`	string	Ні	–	Shelter type filter
`city`	string	Ні	–	City name (partial match)
`search`	string	Ні	–	Search name, city, address
`condition`	string	Ні	–	gut, mittel, schlecht, unbekannt
`protection`	string	Ні	–	hoch, mittel, niedrig, unbekannt
`wheelchair`	boolean	Ні	–	Filter wheelchair accessible
`verified`	boolean	Ні	–	Filter verified shelters
`minCapacity`	number	Ні	–	Minimum capacity
`sort`	string	Ні	name	name, city, capacity, type
`order`	string	Ні	asc	asc or desc

Приклад

GET https://schutzraum.app/api/shelters?type=bunker&city=Berlin&limit=10

Відповідь

{
  "data": [{ "id": "...", "name": "...", "type": "bunker", ... }],
  "total": 42,
  "page": 1,
  "limit": 10,
  "totalPages": 5
}

GET/api/shelters/:id

Повертає окреме укриття за його ID.

Приклад

GET https://schutzraum.app/api/shelters/24b4e1f0-7723-45a7-bd1c-537a2ff02174

GET/api/shelters/nearby

Повертає укриття в заданому радіусі від географічної точки, відсортовані за відстанню.

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
`lat`	number	Так	–	Latitude (–90 to 90)
`lng`	number	Так	–	Longitude (–180 to 180)
`radius`	number	Ні	5000	Radius in meters (100–50000)
`limit`	number	Ні	20	Max results (1–100)
`type`	string	Ні	–	Shelter type filter

Приклад

GET https://schutzraum.app/api/shelters/nearby?lat=48.137&lng=11.576&radius=3000

GET/api/shelters/bbox

Повертає всі укриття в межах географічного обмежувального прямокутника.

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
`west`	number	Так	–	West longitude
`south`	number	Так	–	South latitude
`east`	number	Так	–	East longitude
`north`	number	Так	–	North latitude
`type`	string	Ні	–	Shelter type filter

Приклад

GET https://schutzraum.app/api/shelters/bbox?west=11.4&south=48.0&east=11.7&north=48.2

GET/api/shelters/geojson

Повертає всі укриття у вигляді колекції об'єктів GeoJSON для відображення на карті.

Параметр	Тип	Обов'язковий	За замовчуванням	Опис
`type`	string	Ні	–	Shelter type filter
`wheelchair`	boolean	Ні	–	Filter accessible
`verified`	boolean	Ні	–	Filter verified
`minCapacity`	number	Ні	–	Minimum capacity

Приклад

GET https://schutzraum.app/api/shelters/geojson?type=u_bahn_station&wheelchair=true

Відповідь

{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": { "type": "Point", "coordinates": [11.576, 48.137] },
    "properties": { "id": "...", "name": "...", "type": "u_bahn_station", ... }
  }]
}

Типи укриттів

Параметр type приймає такі значення:

Value	Label
`bunker`	Бункер
`tiefgarage`	Підземний паркінг
`u_bahn_station`	Станція метро
`tunnel`	Тунель
`keller`	Підвал
`hochbunker`	Наземний бункер
`tiefbunker`	Підземний бункер
`sonstige`	Інше

Параметр

Тип

Обов'язковий

За замовчуванням

Опис

page

number

Ні

Page number

limit

number

Ні

Items per page (1–10000)

type

string

Ні

–

Shelter type filter

city

string

Ні

–

City name (partial match)

search

string

Ні

–

Search name, city, address

condition

string

Ні

–

gut, mittel, schlecht, unbekannt

protection

string

Ні

–

hoch, mittel, niedrig, unbekannt

wheelchair

boolean

Ні

–

Filter wheelchair accessible

verified

boolean

Ні

–

Filter verified shelters

minCapacity

number

Ні

–

Minimum capacity

sort

string

Ні

name

name, city, capacity, type

order

string

Ні

asc

asc or desc

Параметр

Тип

Обов'язковий

За замовчуванням

Опис

lat

number

Так

–

Latitude (–90 to 90)

lng

number

Так

–

Longitude (–180 to 180)

radius

number

Ні

5000

Radius in meters (100–50000)

limit

number

Ні

Max results (1–100)

type

string

Ні

–

Shelter type filter

Параметр

Тип

Обов'язковий

За замовчуванням

Опис

west

number

Так

–

West longitude

south

number

Так

–

South latitude

east

number

Так

–

East longitude

north

number

Так

–

North latitude

type

string

Ні

–

Shelter type filter

Параметр

Тип

Обов'язковий

За замовчуванням

Опис

type

string

Ні

–

Shelter type filter

wheelchair

boolean

Ні

–

Filter accessible

verified

boolean

Ні

–

Filter verified

minCapacity

number

Ні

–

Minimum capacity

{ "type": "FeatureCollection", "features": [{ "type": "Feature", "geometry": { "type": "Point", "coordinates": [11.576, 48.137] }, "properties": { "id": "...", "name": "...", "type": "u_bahn_station", ... } }] }

Типи укриттів

Параметр type приймає такі значення:

Value	Label
`bunker`	Бункер
`tiefgarage`	Підземний паркінг
`u_bahn_station`	Станція метро
`tunnel`	Тунель
`keller`	Підвал
`hochbunker`	Наземний бункер
`tiefbunker`	Підземний бункер
`sonstige`	Інше