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

API Schutzraum предоставляет доступ только для чтения ко всем данным убежищ. Требуется ключ API, который вы можете запросить в своём аккаунте.

Пожалуйста, используйте API ответственно. Чрезмерные запросы могут быть ограничены.

Аутентификация

Все запросы к API требуют действительный ключ API. Отправьте его в качестве заголовка или параметра запроса:

Ключи API можно запросить в вашем аккаунте в разделе 'Ключи API'. После ручной проверки ключ будет активирован (обычно в течение 48 часов).

Возвращает постраничный список убежищ с возможностью фильтрации. Также поддерживает географическую фильтрацию с параметрами lat, lng и radius — географические запросы автоматически сортируются по расстоянию и включают поле расстояния.

GET /api/shelters?type=bunker&city=Berlin&limit=10

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

Возвращает одно убежище по его ID.

GET /api/shelters/24b4e1f0-7723-45a7-bd1c-537a2ff02174

Возвращает убежища в заданном радиусе от географической точки, отсортированные по расстоянию.

GET /api/shelters/nearby?lat=48.137&lng=11.576&radius=3000

Возвращает все убежища в пределах географической ограничивающей рамки.

GET /api/shelters/bbox?west=11.4&south=48.0&east=11.7&north=48.2

Возвращает все убежища в формате GeoJSON FeatureCollection для отображения на карте.

GET /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", ... }
  }]
}

Типы убежищ

Параметр типа принимает следующие значения: