Accédez aux données des abris de manière programmatique
L'API Schutzraum fournit un accès en lecture seule à toutes les données des abris. Une clé API est requise, que vous pouvez demander dans votre compte.
https://schutzraum.appVeuillez utiliser l'API de manière responsable. Les requêtes excessives peuvent être limitées.
Toutes les requêtes API nécessitent une clé API valide. Envoyez-la en tant qu'en-tête ou paramètre de requête :
En tant qu'en-tête (recommandé):
X-API-Key: dein_api_keyEn tant que paramètre de requête:
/api/shelters?api_key=dein_api_keyLes clés API peuvent être demandées dans votre compte sous 'Clés API'. Après vérification manuelle, la clé sera activée (généralement sous 48 heures).
Renvoie une liste paginée d'abris avec filtrage optionnel. Prend également en charge le filtrage géographique avec les paramètres lat, lng et radius — les requêtes géographiques sont automatiquement triées par distance et incluent un champ de distance.
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
page | number | Non | 1 | Page number |
limit | number | Non | 20 | Items per page (1–10000) |
type | string | Non | – | Shelter type filter |
city | string | Non | – | City name (partial match) |
search | string | Non | – | Search name, city, address |
condition | string | Non | – | gut, mittel, schlecht, unbekannt |
protection | string | Non | – | hoch, mittel, niedrig, unbekannt |
wheelchair | boolean | Non | – | Filter wheelchair accessible |
verified | boolean | Non | – | Filter verified shelters |
minCapacity | number | Non | – | Minimum capacity |
sort | string | Non | name | name, city, capacity, type |
order | string | Non | 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
}Renvoie un abri individuel par son identifiant.
GET /api/shelters/24b4e1f0-7723-45a7-bd1c-537a2ff02174
Renvoie les abris dans un rayon donné d'un point géographique, triés par distance.
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
lat | number | Oui | – | Latitude (–90 to 90) |
lng | number | Oui | – | Longitude (–180 to 180) |
radius | number | Non | 5000 | Radius in meters (100–50000) |
limit | number | Non | 20 | Max results (1–100) |
type | string | Non | – | Shelter type filter |
GET /api/shelters/nearby?lat=48.137&lng=11.576&radius=3000
Renvoie tous les abris dans un cadre de délimitation géographique.
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
west | number | Oui | – | West longitude |
south | number | Oui | – | South latitude |
east | number | Oui | – | East longitude |
north | number | Oui | – | North latitude |
type | string | Non | – | Shelter type filter |
GET /api/shelters/bbox?west=11.4&south=48.0&east=11.7&north=48.2
Renvoie tous les abris sous forme de FeatureCollection GeoJSON pour le rendu cartographique.
| Paramètre | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
type | string | Non | – | Shelter type filter |
wheelchair | boolean | Non | – | Filter accessible |
verified | boolean | Non | – | Filter verified |
minCapacity | number | Non | – | 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", ... }
}]
}Le paramètre de type accepte ces valeurs :
| Value | Label |
|---|---|
bunker | Bunker |
tiefgarage | Parking souterrain |
u_bahn_station | Station de métro |
tunnel | Tunnel |
keller | Cave |
hochbunker | Bunker en surface |
tiefbunker | Bunker souterrain |
sonstige | Autre |