核心功能
kma-weather 是韩国气象厅(기상청)官方开放数据的本地化接入方案,专为需要高精度韩国天气信息的场景设计。与通用天气服务不同,本技能提供5km网格级空间分辨率,覆盖超短期(6小时)、短期(3天)及中期(3-10天)全周期预报,并独家接入官方气象特报(기상특보)系统。
显著优点
1. 官方权威数据源:直接对接韩国气象厅 공공데이터포털 三项核心API,数据时效性和准确性远超第三方聚合服务
2. 空间精度极致:采用5km网格系统(Lambert Conformal Conic投影),对首尔等大城市可实现街区级差异化预报
3. 气象特报全覆盖:独有的기상특보模块实时推送台风、暴雪、干旱、大风等官方预警信息,包含生效特报和预发特报双维度
4. 多时间尺度整合:单次调用可同时获取实况、6小时预报、3天预报,支持程序化JSON输出便于二次开发
潜在局限
- 地域严格受限:仅支持韩国境内(北纬33°-43°,东经124°-132°),境外坐标返回空数据
- 注册门槛:需在韩国공공데이터포털完成实名认证并申请三项API权限,流程约需1-3个工作日
- 发布时刻约束:各产品固定发布时间(如短期预报每日8次02:10/05:10...),非任意时刻实时生成
- 语言限制:原始数据为韩文,脚本输出保留韩文术语(SKY、PTY等编码需查表)
适合人群
- 韩国本地生活/出行规划用户(需精准到 districts 的预报)
- 农业、渔业、户外活动从业者(依赖기상특보决策)
- 韩语环境应用开发者(需要结构化官方数据)
- 对通用天气服务精度不满意的在韩用户
常规风险提示
API密钥需妥善保管,避免硬编码提交至版本控制;气象特报信息具有法律效力,自动化转发时建议保留原始发报时间戳;网格坐标转换存在<1km误差,极端精确场景建议验证。