Τεκμηρίωση 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
}

Επιστρέφει ένα μεμονωμένο καταφύγιο βάσει του αναγνωριστικού του.

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

Τύποι καταφυγίων

Η παράμετρος type δέχεται αυτές τις τιμές: