介绍
# Umeå Data - Open Data från Umeå kommun
查询于默奥市关于地点、设施、人口、环境等方面的开放数据。
## API 基础 URL `https://opendata.umea.se/api/v2/`
## 可用数据类别
### 🏞️ 休闲与设施
#### **Lekplatser (Playgrounds)** - Dataset ID: `gop_lekparker` - 包含由 Gator och Park 管理的游乐场位置 - 字段: namn, omrade, coordinates (geo_point_2d), contact info - 示例: “Var är närmaste lekplats till Mariehem?”
#### **Badplatser (Swimming Spots)** - Dataset ID: `badplatser` - 于默奥的公共游泳场所 - 字段: namn, omrade, typ, coordinates, handik_anp (无障碍设施) - 示例: “Vilka badplatser finns i Umeå?”
#### **Vandringsleder (Hiking Trails)** - Dataset ID: `vandringsleder` - 包含路线和距离的徒步步道 - 字段: namn, delstracka, kommun, klass, langd (长度，单位为米), geo_shape (步道几何形状) - 示例: “Var kan jag vandra i Umeå?”
#### **Rastplatser (Rest Areas)** - Dataset ID: `rastplatser` - 休息站和野餐区 - 字段: name, location coordinates - 示例: “Var finns rastplatser?”
#### **Träd (Trees)** - Dataset ID: `trad-som-forvaltas-av-gator-och-parker` - 由 Gator och Park 管理的树木 - 字段: tree type, location, management data - 示例: “Vilka träd finns i området?”
### ⚡ 基础设施
#### **Laddplatser (EV Charging Stations)** - Dataset ID: `laddplatser` - 电动汽车充电站 - 字段: name, street, house_number, zipcode, city, owned_by, operator, number_charging_points, available_charging_points, position (经纬度) - 示例: “Finns det laddplatser nära centrum?”
#### **WiFi Hotspots** - Dataset ID: `wifi-hotspots` - 公共 WiFi 接入点 - 字段: popularnamn (名称), koordinat (坐标) - 示例: “Var finns gratis wifi i Umeå?”
### 🏗️ 建筑与规划
#### **Bygglov Beslut (Building Permit Decisions)** - Dataset ID: `bygglov-beslut` - 已批准的建筑许可证 - 字段: arendebeskrivning, arendetyp, beslut, beslutsdatum, registreringsdatum, beslutstyp - 示例: “Vilka bygglov har beviljats nyligen?”
#### **Bygglov Inkomna Ärenden (Building Permit Applications)** - Dataset ID: `bygglov-inkomna-arenden` - 新收到的建筑许可证申请 - 字段: application details, submission date, status - 示例: “Hur många bygglovsansökningar har kommit in?”
### 📊 人口与统计
#### **Befolkningsförändringar (Population Changes)** - Dataset ID: `befolkningsfoeraendringar-helar` - 人口变化统计 - 字段: year, births, deaths, migration, total change - 示例: “Hur har befolkningen förändrats i Umeå?”
#### **Bostadsbestånd (Housing Stock)** - Dataset ID: `bostadsbestand-hustyp` - 按类型分类的住房库存 - 字段: house type, count, area - 示例: “Hur ser bostadsbeståndet ut?”
### 🌍 环境
#### **Växthusgasutsläpp (Greenhouse Gas Emissions)** - Dataset ID: `vaxthusgasutslapp_umea` - 于默奥的温室气体排放数据 - 字段: year, sector, emissions (二氧化碳当量吨数) - 示例: “Vad är Umeås växthusgasutsläpp?”
#### **Brottsstatistik (Crime Statistics)** - Dataset ID: `exempel-brottsstatistik-anmaelda-brott-fran-bra-s-oeppna-data` - 来自 BRÅ 开放数据的报案记录 - 字段: crime type, count, year - 示例: “Hur ser brottsstatistiken ut?”
## 使用方法
### 查询数据集 ```bash ./scripts/query.sh <dataset_id> [limit] ```
示例: ```bash ./scripts/query.sh badplatser 10 ./scripts/query.sh laddplatser 20 ```
### 查找最近位置 ```bash ./scripts/nearby.sh <dataset_id> <lat> <lon> [limit] ```
示例: ```bash # Find nearest playground to Mariehem (approx coordinates) ./scripts/nearby.sh gop_lekparker 63.8200 20.3000 5
# Find nearest EV charging station to city center ./scripts/nearby.sh laddplatser 63.8258 20.2630 5 ```
## API 端点
### 列出所有数据集 ```bash curl "https://opendata.umea.se/api/v2/catalog/datasets" ```
### 获取数据集记录 ```bash curl "https://opendata.umea.se/api/v2/catalog/datasets/{dataset_id}/records?limit=20" ```
### 搜索数据集 ```bash curl "https://opendata.umea.se/api/v2/catalog/datasets?where=search(default,\"query\")" ```
## 数据格式
所有记录遵循此结构: ```json { "total_count": 123, "records": [ { "record": { "id": "unique-id", "timestamp": "2024-01-01T12:00:00Z", "fields": { "namn": "Location Name", "geo_point_2d": { "lat": 63.825, "lon": 20.263 }, ... } } } ] } ```
## 自然语言查询示例
AI 可以回答以下问题:
**休闲:** - “Var är närmaste lekplats till Mariehem?” - “Vilka badplatser finns i Umeå?” - “Var kan jag vandra?” - “Finns det någon rastplats nära E4?”
**基础设施:** - “Finns det laddplatser nära centrum?” - “Var finns gratis wifi?” - “Hur många laddstolpar finns det totalt?”
**规划:** - “Vilka bygglov har beviljats nyligen?” - “Vad byggs i Umeå just nu?”
**人口与环境:** - “Hur har befolkningen förändrats?” - “Vad är Umeås växthusgasutsläpp?” - “Hur många bostäder finns i Umeå?” - “Hur ser brottsstatistiken ut?”
## 注意事项
- 无需 API 密钥 - 所有数据均公开且开放 - 坐标使用 WGS84 (纬度/经度) - 部分数据集包含针对步道/路线的 geo_shape - 由于默奥市定期更新