Sığınak verilerine programlı olarak erişin
Schutzraum API'si tüm sığınak verilerine salt okunur erişim sağlar. Hesabınızdan talep edebileceğiniz bir API anahtarı gereklidir.
https://schutzraum.appLütfen API'yi sorumlu bir şekilde kullanın. Aşırı istekler sınırlandırılabilir.
Tüm API istekleri geçerli bir API anahtarı gerektirir. Bunu başlık veya sorgu parametresi olarak gönderin:
Başlık olarak (önerilen):
X-API-Key: dein_api_keySorgu parametresi olarak:
/api/shelters?api_key=dein_api_keyAPI anahtarları hesabınızda 'API Anahtarları' bölümünden talep edilebilir. Manuel incelemeden sonra anahtar etkinleştirilecektir (genellikle 48 saat içinde).
İsteğe bağlı filtreleme ile sayfalandırılmış bir sığınak listesi döndürür. Ayrıca lat, lng ve radius parametreleriyle coğrafi filtrelemeyi destekler — coğrafi istekler otomatik olarak mesafeye göre sıralanır ve bir mesafe alanı içerir.
| 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 |
GET /api/shelters?type=bunker&city=Berlin&limit=10
{
"data": [{ "id": "...", "name": "...", "type": "bunker", ... }],
"total": 42,
"page": 1,
"limit": 10,
"totalPages": 5
}ID'sine göre tek bir sığınak döndürür.
GET /api/shelters/24b4e1f0-7723-45a7-bd1c-537a2ff02174
Bir coğrafi noktanın belirli bir yarıçapındaki sığınakları mesafeye göre sıralı olarak 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 |
GET /api/shelters/nearby?lat=48.137&lng=11.576&radius=3000
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 |
GET /api/shelters/bbox?west=11.4&south=48.0&east=11.7&north=48.2
Harita oluşturma 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 |
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", ... }
}]
}Tür 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 |