APIドキュメント

シェルターデータにプログラムからアクセス

Schutzraum APIはすべてのシェルターデータへの読み取り専用アクセスを提供します。APIキーが必要であり、アカウントでリクエストできます。

ベースURLhttps://schutzraum.app

APIは責任を持ってご利用ください。過剰なリクエストにはレート制限がかかる場合があります。

認証

すべてのAPIリクエストには有効なAPIキーが必要です。ヘッダーまたはクエリパラメータとして送信してください：

ヘッダーとして（推奨）:

X-API-Key: dein_api_key

クエリパラメータとして:

/api/shelters?api_key=dein_api_key

APIキーはアカウントの「APIキー」からリクエストできます。手動審査後にキーが有効化されます（通常48時間以内）。

GET/api/shelters

オプションのフィルタリング付きでシェルターのページネーションされたリストを返します。lat、lng、radiusパラメータによる地理フィルタリングもサポートしています — 地理リクエストは自動的に距離順でソートされ、距離フィールドが含まれます。

パラメータ	型	必須	デフォルト	説明
`page`	number	いいえ	1	Page number
`limit`	number	いいえ	20	Items per page (1–10000)
`type`	string	いいえ	–	Shelter type filter
`city`	string	いいえ	–	City name (partial match)
`search`	string	いいえ	–	Search name, city, address
`condition`	string	いいえ	–	gut, mittel, schlecht, unbekannt
`protection`	string	いいえ	–	hoch, mittel, niedrig, unbekannt
`wheelchair`	boolean	いいえ	–	Filter wheelchair accessible
`verified`	boolean	いいえ	–	Filter verified shelters
`minCapacity`	number	いいえ	–	Minimum capacity
`sort`	string	いいえ	name	name, city, capacity, type
`order`	string	いいえ	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
}

GET/api/shelters/:id

IDで単一のシェルターを返します。

例

GET /api/shelters/24b4e1f0-7723-45a7-bd1c-537a2ff02174

GET/api/shelters/nearby

地理的なポイントの指定された半径内のシェルターを距離順で返します。

パラメータ	型	必須	デフォルト	説明
`lat`	number	はい	–	Latitude (–90 to 90)
`lng`	number	はい	–	Longitude (–180 to 180)
`radius`	number	いいえ	5000	Radius in meters (100–50000)
`limit`	number	いいえ	20	Max results (1–100)
`type`	string	いいえ	–	Shelter type filter

例

GET /api/shelters/nearby?lat=48.137&lng=11.576&radius=3000

GET/api/shelters/bbox

地理的なバウンディングボックス内のすべてのシェルターを返します。

パラメータ	型	必須	デフォルト	説明
`west`	number	はい	–	West longitude
`south`	number	はい	–	South latitude
`east`	number	はい	–	East longitude
`north`	number	はい	–	North latitude
`type`	string	いいえ	–	Shelter type filter

例

GET /api/shelters/bbox?west=11.4&south=48.0&east=11.7&north=48.2

GET/api/shelters/geojson

地図レンダリング用にすべてのシェルターをGeoJSON FeatureCollectionとして返します。

パラメータ	型	必須	デフォルト	説明
`type`	string	いいえ	–	Shelter type filter
`wheelchair`	boolean	いいえ	–	Filter accessible
`verified`	boolean	いいえ	–	Filter verified
`minCapacity`	number	いいえ	–	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", ... }
  }]
}

シェルタータイプ

typeパラメータは以下の値を受け付けます：

Value	Label
`bunker`	バンカー
`tiefgarage`	地下駐車場
`u_bahn_station`	地下鉄駅
`tunnel`	トンネル
`keller`	地下室
`hochbunker`	地上バンカー
`tiefbunker`	地下バンカー
`sonstige`	その他

認証

すべてのAPIリクエストには有効なAPIキーが必要です。ヘッダーまたはクエリパラメータとして送信してください：

ヘッダーとして（推奨）:

X-API-Key: dein_api_key

クエリパラメータとして:

/api/shelters?api_key=dein_api_key

APIキーはアカウントの「APIキー」からリクエストできます。手動審査後にキーが有効化されます（通常48時間以内）。

パラメータ

型

必須

デフォルト

説明

page

number

いいえ

Page number

limit

number

いいえ

Items per page (1–10000)

type

string

いいえ

–

Shelter type filter

city

string

いいえ

–

City name (partial match)

search

string

いいえ

–

Search name, city, address

condition

string

いいえ

–

gut, mittel, schlecht, unbekannt

protection

string

いいえ

–

hoch, mittel, niedrig, unbekannt

wheelchair

boolean

いいえ

–

Filter wheelchair accessible

verified

boolean

いいえ

–

Filter verified shelters

minCapacity

number

いいえ

–

Minimum capacity

sort

string

いいえ

name

name, city, capacity, type

order

string

いいえ

asc

asc or desc

パラメータ

型

必須

デフォルト

説明

lat

number

はい

–

Latitude (–90 to 90)

lng

number

はい

–

Longitude (–180 to 180)

radius

number

いいえ

5000

Radius in meters (100–50000)

limit

number

いいえ

Max results (1–100)

type

string

いいえ

–

Shelter type filter

パラメータ

型

必須

デフォルト

説明

west

number

はい

–

West longitude

south

number

はい

–

South latitude

east

number

はい

–

East longitude

north

number

はい

–

North latitude

type

string

いいえ

–

Shelter type filter

パラメータ

型

必須

デフォルト

説明

type

string

いいえ

–

Shelter type filter

wheelchair

boolean

いいえ

–

Filter accessible

verified

boolean

いいえ

–

Filter verified

minCapacity

number

いいえ

–

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

バンカー

tiefgarage

地下駐車場

u_bahn_station

地下鉄駅

tunnel

トンネル

keller

地下室

hochbunker

地上バンカー

tiefbunker

地下バンカー

sonstige

その他