Accede a los datos de refugios de forma programática
La API de Schutzraum proporciona acceso de solo lectura a todos los datos de refugios. Se requiere una clave API, que puedes solicitar en tu cuenta.
https://schutzraum.appPor favor, utiliza la API de forma responsable. Las solicitudes excesivas pueden ser limitadas.
Todas las solicitudes a la API requieren una clave API válida. Envíala como encabezado o parámetro de consulta:
Como encabezado (recomendado):
X-API-Key: dein_api_keyComo parámetro de consulta:
/api/shelters?api_key=dein_api_keyLas claves API se pueden solicitar en tu cuenta en 'Claves API'. Después de una revisión manual, la clave será activada (normalmente en un plazo de 48 horas).
Devuelve una lista paginada de refugios con filtrado opcional. También admite filtrado geográfico con los parámetros lat, lng y radius — las solicitudes geográficas se ordenan automáticamente por distancia e incluyen un campo de distancia.
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
page | number | No | 1 | Page number |
limit | number | No | 20 | Items per page (1–10000) |
type | string | No | – | Shelter type filter |
city | string | No | – | City name (partial match) |
search | string | No | – | Search name, city, address |
condition | string | No | – | gut, mittel, schlecht, unbekannt |
protection | string | No | – | hoch, mittel, niedrig, unbekannt |
wheelchair | boolean | No | – | Filter wheelchair accessible |
verified | boolean | No | – | Filter verified shelters |
minCapacity | number | No | – | Minimum capacity |
sort | string | No | name | name, city, capacity, type |
order | string | No | 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
}Devuelve un refugio individual por su ID.
GET /api/shelters/24b4e1f0-7723-45a7-bd1c-537a2ff02174
Devuelve refugios dentro de un radio dado de un punto geográfico, ordenados por distancia.
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
lat | number | Sí | – | Latitude (–90 to 90) |
lng | number | Sí | – | Longitude (–180 to 180) |
radius | number | No | 5000 | Radius in meters (100–50000) |
limit | number | No | 20 | Max results (1–100) |
type | string | No | – | Shelter type filter |
GET /api/shelters/nearby?lat=48.137&lng=11.576&radius=3000
Devuelve todos los refugios dentro de un cuadro delimitador geográfico.
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
west | number | Sí | – | West longitude |
south | number | Sí | – | South latitude |
east | number | Sí | – | East longitude |
north | number | Sí | – | North latitude |
type | string | No | – | Shelter type filter |
GET /api/shelters/bbox?west=11.4&south=48.0&east=11.7&north=48.2
Devuelve todos los refugios como una FeatureCollection GeoJSON para renderizado en mapa.
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
type | string | No | – | Shelter type filter |
wheelchair | boolean | No | – | Filter accessible |
verified | boolean | No | – | Filter verified |
minCapacity | number | No | – | 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", ... }
}]
}El parámetro de tipo acepta estos valores:
| Value | Label |
|---|---|
bunker | Búnker |
tiefgarage | Aparcamiento subterráneo |
u_bahn_station | Estación de metro |
tunnel | Túnel |
keller | Sótano |
hochbunker | Búnker de superficie |
tiefbunker | Búnker subterráneo |
sonstige | Otros |