API Dokümantasyonu

Sığınak verilerine programatik erişim

Schutzraum API'si, tüm sığınak verilerine genel, salt okunur erişim sağlar. Kimlik doğrulaması gerekmez.

Temel URLhttps://schutzraum.app

Lütfen API'yi sorumlu bir şekilde kullanın. Aşırı istekler sınırlandırılabilir.

GET/api/shelters

İsteğe bağlı filtreleme ile sayfalanmış bir sığınak listesi döndürür.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`page`	number	Hayır	1	Page number
`limit`	number	Hayır	20	Items per page (1–10000)
`type`	string	Hayır	–	Shelter type filter
`city`	string	Hayır	–	City name (partial match)
`search`	string	Hayır	–	Search name, city, address
`condition`	string	Hayır	–	gut, mittel, schlecht, unbekannt
`protection`	string	Hayır	–	hoch, mittel, niedrig, unbekannt
`wheelchair`	boolean	Hayır	–	Filter wheelchair accessible
`verified`	boolean	Hayır	–	Filter verified shelters
`minCapacity`	number	Hayır	–	Minimum capacity
`sort`	string	Hayır	name	name, city, capacity, type
`order`	string	Hayır	asc	asc or desc

Örnek

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

Yanıt

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

GET/api/shelters/:id

Bir sığınağı ID'sine göre döndürür.

Örnek

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

GET/api/shelters/nearby

Belirli bir coğrafi noktanın belirli bir yarıçapı içindeki sığınakları mesafeye göre sıralayarak döndürür.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`lat`	number	Evet	–	Latitude (–90 to 90)
`lng`	number	Evet	–	Longitude (–180 to 180)
`radius`	number	Hayır	5000	Radius in meters (100–50000)
`limit`	number	Hayır	20	Max results (1–100)
`type`	string	Hayır	–	Shelter type filter

Örnek

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

GET/api/shelters/bbox

Coğrafi bir sınırlayıcı kutu içindeki tüm sığınakları döndürür.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`west`	number	Evet	–	West longitude
`south`	number	Evet	–	South latitude
`east`	number	Evet	–	East longitude
`north`	number	Evet	–	North latitude
`type`	string	Hayır	–	Shelter type filter

Örnek

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

GET/api/shelters/geojson

Harita gösterimi için tüm sığınakları GeoJSON FeatureCollection olarak döndürür.

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
`type`	string	Hayır	–	Shelter type filter
`wheelchair`	boolean	Hayır	–	Filter accessible
`verified`	boolean	Hayır	–	Filter verified
`minCapacity`	number	Hayır	–	Minimum capacity

Örnek

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

Yanıt

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

Sığınak Türleri

type parametresi şu değerleri kabul eder:

Value	Label
`bunker`	Sığınak
`tiefgarage`	Yeraltı Otoparkı
`u_bahn_station`	Metro İstasyonu
`tunnel`	Tünel
`keller`	Bodrum
`hochbunker`	Yerüstü Sığınak
`tiefbunker`	Yeraltı Sığınağı
`sonstige`	Diğer

Parametre

Tür

Zorunlu

Varsayılan

Açıklama

page

number

Hayır

Page number

limit

number

Hayır

Items per page (1–10000)

type

string

Hayır

–

Shelter type filter

city

string

Hayır

–

City name (partial match)

search

string

Hayır

–

Search name, city, address

condition

string

Hayır

–

gut, mittel, schlecht, unbekannt

protection

string

Hayır

–

hoch, mittel, niedrig, unbekannt

wheelchair

boolean

Hayır

–

Filter wheelchair accessible

verified

boolean

Hayır

–

Filter verified shelters

minCapacity

number

Hayır

–

Minimum capacity

sort

string

Hayır

name

name, city, capacity, type

order

string

Hayır

asc

asc or desc

Parametre

Tür

Zorunlu

Varsayılan

Açıklama

lat

number

Evet

–

Latitude (–90 to 90)

lng

number

Evet

–

Longitude (–180 to 180)

radius

number

Hayır

5000

Radius in meters (100–50000)

limit

number

Hayır

Max results (1–100)

type

string

Hayır

–

Shelter type filter

Parametre

Tür

Zorunlu

Varsayılan

Açıklama

west

number

Evet

–

West longitude

south

number

Evet

–

South latitude

east

number

Evet

–

East longitude

north

number

Evet

–

North latitude

type

string

Hayır

–

Shelter type filter

Parametre

Tür

Zorunlu

Varsayılan

Açıklama

type

string

Hayır

–

Shelter type filter

wheelchair

boolean

Hayır

–

Filter accessible

verified

boolean

Hayır

–

Filter verified

minCapacity

number

Hayır

–

Minimum capacity

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

Value

Label

bunker

Sığınak

tiefgarage

Yeraltı Otoparkı

u_bahn_station

Metro İstasyonu

tunnel

Tünel

keller

Bodrum

hochbunker

Yerüstü Sığınak

tiefbunker

Yeraltı Sığınağı

sonstige

Diğer