Back to Details

han-river-water-level

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Han River Water Level

Han River Water Level

What this skill does

技能功能

기본적으로 
https://k-skill-proxy.nomadamas.org/v1/han-river/water-level
로 요청해서 현재 수위와 유량을 요약한다.
默认向
https://k-skill-proxy.nomadamas.org/v1/han-river/water-level
发起请求，获取并汇总当前水位和流量数据。

When to use

使用场景

  • "한강대교 지금 수위 어때?"
  • "잠수교 유량 알려줘"
  • "1018683 관측소 현재 값 보여줘"
  • "汉江大桥现在水位如何？"
  • "告诉我潜水桥的流量"
  • "展示1018683观测站的当前数值"

Inputs

输入参数

  • 기본 입력: 관측소명/교량명(
    stationName
    )
  • 대체 입력: 관측소코드(
    stationCode
    )
  • 默认输入：观测站名/桥梁名(
    stationName
    )
  • 备选输入：观测站代码(
    stationCode
    )

Prerequisites

前置依赖

  • optional: 
    jq
  • 可选：
    jq

Default path

默认路径

추가 client API 레이어는 불필요하다. 그냥 프록시 서버에 HTTP 요청만 넣으면 된다.
사용자는 별도 HRFCO 
ServiceKey
를 준비할 필요가 없다. upstream key는 proxy 서버에서만 주입한다.
KSKILL_PROXY_BASE_URL
환경변수가 있으면 그 값을 사용하고, 없으면 기본 경로 
https://k-skill-proxy.nomadamas.org
를 사용한다.
不需要额外的客户端API层，只需向代理服务器发送HTTP请求即可。
用户无需单独准备HRFCO 
ServiceKey
，上游密钥仅由代理服务器注入。
如果存在
KSKILL_PROXY_BASE_URL
环境变量则使用该值，否则使用默认路径
https://k-skill-proxy.nomadamas.org
。

Example requests

请求示例

bash
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationName=한강대교'
관측소코드로 바로 조회해도 된다.
bash
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationCode=1018683'
bash
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationName=한강대교'
也可以直接通过观测站代码查询。
bash
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationCode=1018683'

Keep the answer compact

精简响应要求

응답에는 아래만 먼저 정리한다.
  • 관측소명 / 관측소코드
  • 관측 시각
  • 현재 수위(m)
  • 현재 유량(m^3/s)
  • 기준 수위(관심/주의/경보/심각) 중 값이 있는 항목
请优先整理以下内容作为响应：
  • 观测站名 / 观测站代码
  • 观测时间
  • 当前水位(m)
  • 当前流量(m^3/s)
  • 基准水位（关注/注意/警报/严重）中存在对应值的项

Ambiguous station names

站点名称模糊处理

입력이 너무 넓으면 proxy 는 
ambiguous_station
과 함께 
candidate_stations
를 돌려준다.
bash
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationName=한강'
이때는 후보 중 하나를 골라 다시 
stationName
또는 
stationCode
로 조회한다.
如果输入范围过广，代理会返回
ambiguous_station
错误以及
candidate_stations
候选站点列表。
bash
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/han-river/water-level' \
  --data-urlencode 'stationName=한강'
此时请从候选项中选择一个，再次使用
stationName
或
stationCode
进行查询。

Detailed API paths

详细API路径

구현 세부는 아래 문서만 참고한다.
  • docs/features/han-river-water-level.md
  • docs/features/k-skill-proxy.md
实现细节仅参考以下文档：
  • docs/features/han-river-water-level.md
  • docs/features/k-skill-proxy.md

Failure modes

异常场景

  • 관측소명이 너무 넓어서 여러 관측소가 동시에 잡히는 경우
  • 잘못된 관측소코드/관측소명으로 station lookup 이 실패하는 경우
  • 프록시 서버에 
    HRFCO_OPEN_API_KEY
    가 비어 있는 경우
  • 실시간 자료 갱신 지연으로 최신 10분 자료가 비어 있는 경우
  • 观测站名范围过广，同时匹配到多个观测站的情况
  • 观测站代码/观测站名错误，站点查询失败的情况
  • 代理服务器的
    HRFCO_OPEN_API_KEY
    为空的情况
  • 实时数据更新延迟，最近10分钟的数据为空的情况

Notes

注意事项

  • 기본 경로는 항상 
    k-skill-proxy.nomadamas.org
    의 water-level endpoint 다.
  • upstream 은 
    waterlevel/info.json
    으로 관측소 메타데이터를 찾고, 
    waterlevel/list/10M/{WLOBSCD}.json
    으로 최신값을 조회한다.
  • 결과는 원시자료 기반이므로 조회 시각을 함께 적는다.
  • 默认路径始终为
    k-skill-proxy.nomadamas.org
    的water-level接口。
  • 上游通过
    waterlevel/info.json
    查找观测站元数据，通过
    waterlevel/list/10M/{WLOBSCD}.json
    查询最新数值。
  • 结果基于原始数据，因此需要同时标注查询时间。