fine-dust-location

기본적으로 로 요청해서 PM10 / PM2.5 / 통합대기등급을 요약한다. 지역명은 아래처럼 측정소명에 가까운 한국어 행정구역 이름 을 우선 사용한다. 여러 토큰이 들어오면 helper / proxy 는 보통 가장 구체적인 토큰 을 우선 본다. 예: 서울 강남구 → 강남구 . 추가 client API 레이어는 불필요하다. 그냥 프록시 서버에 HTTP 요청만 넣으면 된다. 스크립트 helper 도 같은 report endpoint 를 기본 경로로 사용한다. 입력한 지역명이 단일 측정소로 바로 확정되지 않으면 proxy 는 ambiguous_location 과 함께 후보 측정소 목록을 돌려준다. 예: 이때 응답의 candidate_stations 중 하나를 골라 다시 stationName 으로 조회한다. 원본 AirKorea와 비슷한 passthrough 경로( /B552584/... )나 direct fallback 상세는 아래 문서만 참고한다. 응답에는 아래만 먼저 정리한다. - "지금 내 위치 미세먼지 어때?" - "강남 쪽 초미세먼지 수치 알려줘" - "여기 공기질 괜찮아?" - 일반 입력: 지역명/행정구역 힌트 - 재조회 입력: 정확한 측정소명 - 좋음: 강남구 , 서울 강남구 , 종로구 , 수원시 - 애매함: 강남 , 서울 남쪽 , 코엑스 근처 - docs/features/fine-dust-location.md - docs/features/k-skill-proxy.md - 측정소 - 조회 시각 - PM10 값과 등급 - PM2.5 값과 등급 - 통합대기등급 - 조회 방식( fallback ) - regionHint 가 너무 넓거나 단일 측정소를 확정할 수 없는 경우 - 프록시 서버가 내려가 있거나 upstream key가 비어 있는 경우 - 측정소명과 지역명이 달라 직접 fallback 이 필요한 경우 - 기본 경로는 항상 k-skill-proxy.nomadamas.org 의 report endpoint 다. - 지역명 조회는 먼저 후보를 얻고, 필요하면 정확한 측정소명으로 재조회한다. - passthrough / direct AirKorea 구현 세부는 스킬 본문에 길게 반복하지 않는다. - free API 프록시는 공개 endpoint 를 기본으로 둔다.