fine-dust-location

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Fine Dust By Location

按位置查询细颗粒物

What this skill does

该技能的功能

기본적으로

https://k-skill-proxy.nomadamas.org/v1/fine-dust/report

로 요청해서 PM10 / PM2.5 / 통합대기등급을 요약한다.

默认向

https://k-skill-proxy.nomadamas.org/v1/fine-dust/report

发送请求，返回PM10 / PM2.5 / 综合空气质量等级的汇总结果。

When to use

适用场景

"지금 내 위치 미세먼지 어때?"
"강남 쪽 초미세먼지 수치 알려줘"
"여기 공기질 괜찮아?"

"我现在所在位置的细颗粒物情况怎么样？"
"告诉我江南一带的超细颗粒物数值"
"这里的空气质量还好吗？"

Inputs

输入参数

일반 입력: 지역명/행정구역 힌트
재조회 입력: 정확한 측정소명

常规输入：地区名/行政区划提示
重新查询输入：准确的监测站名称

Region naming convention

地区命名规范

지역명은 아래처럼 측정소명에 가까운 한국어 행정구역 이름을 우선 사용한다.

좋음:

강남구

서울 강남구

종로구

수원시

애매함:
```
강남
```
,
```
서울 남쪽
```
,
```
코엑스 근처
```

여러 토큰이 들어오면 helper / proxy 는 보통 가장 구체적인 토큰을 우선 본다. 예:

서울 강남구

→

강남구

地区名优先使用和监测站名称接近的韩语行政区划名称，规则如下：

规范示例：

강남구

서울 강남구

종로구

수원시

模糊示例：
```
강남
```
,
```
서울 남쪽
```
,
```
코엑스 근처
```

如果传入多个关键词，helper / proxy通常会优先识别最具体的关键词，例如：

서울 강남구

→ 取

강남구

。

Default path

默认路径

추가 client API 레이어는 불필요하다. 그냥 프록시 서버에 HTTP 요청만 넣으면 된다.

bash

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'regionHint=서울 강남구'

스크립트 helper 도 같은 report endpoint 를 기본 경로로 사용한다.

bash

python3 scripts/fine_dust.py report --region-hint '서울 강남구' --json

不需要额外的客户端API层，只需向代理服务器发送HTTP请求即可。

bash

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'regionHint=서울 강남구'

脚本helper同样使用该report接口作为默认路径。

bash

python3 scripts/fine_dust.py report --region-hint '서울 강남구' --json

Ambiguous locations

模糊位置处理

입력한 지역명이 단일 측정소로 바로 확정되지 않으면 proxy 는

ambiguous_location

과 함께 후보 측정소 목록을 돌려준다.

예:

bash

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'regionHint=광주 광산구'

이때 응답의

candidate_stations

중 하나를 골라 다시

stationName

으로 조회한다.

bash

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'stationName=우산동(광주)'

如果输入的地区名无法直接确定唯一监测站，proxy会返回

ambiguous_location

状态以及候选监测站列表。

示例：

bash

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'regionHint=광주 광산구'

此时需要从响应的

candidate_stations

中选择一个，再使用

stationName

参数重新查询。

bash

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'stationName=우산동(광주)'

Detailed API paths

详细API路径

원본 AirKorea와 비슷한 passthrough 경로(

/B552584/...

)나 direct fallback 상세는 아래 문서만 참고한다.

```
docs/features/fine-dust-location.md
```
```
docs/features/k-skill-proxy.md
```

和原始AirKorea相近的透传路径(

/B552584/...

)以及直接回退方案的细节请参考以下文档：

```
docs/features/fine-dust-location.md
```
```
docs/features/k-skill-proxy.md
```

Keep the answer compact

保持回答简洁

응답에는 아래만 먼저 정리한다.

측정소
조회 시각
PM10 값과 등급
PM2.5 값과 등급
통합대기등급
조회 방식(
```
fallback
```
)

响应内容优先整理以下信息：

监测站名称
查询时间
PM10数值和等级
PM2.5数值和等级
综合空气质量等级
查询方式(
```
fallback
```
)

Failure modes

异常场景

regionHint 가 너무 넓거나 단일 측정소를 확정할 수 없는 경우
프록시 서버가 내려가 있거나 upstream key가 비어 있는 경우
측정소명과 지역명이 달라 직접 fallback 이 필요한 경우

regionHint范围过大，无法确定唯一监测站
代理服务器宕机或上游key为空
监测站名称和地区名不一致，需要手动回退查询

Notes

注意事项

기본 경로는 항상
```
k-skill-proxy.nomadamas.org
```
의 report endpoint 다.
지역명 조회는 먼저 후보를 얻고, 필요하면 정확한 측정소명으로 재조회한다.
passthrough / direct AirKorea 구현 세부는 스킬 본문에 길게 반복하지 않는다.
free API 프록시는 공개 endpoint 를 기본으로 둔다.

默认路径始终为
```
k-skill-proxy.nomadamas.org
```
的report接口
地区名查询优先获取候选列表，必要时使用准确的监测站名称重新查询
透传/直接调用AirKorea的实现细节不要在技能正文中重复赘述
免费API代理默认使用公开endpoint