JSPM – korea-public-village-forecast@0.1.1

Package Exports

korea-public-village-forecast

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (korea-public-village-forecast) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

개요

공공데이터포털에서 제공하는 기상청_동네예보 조회서비스를 더 용이하기 사용할 수 있도록 wrapping한 라이브러리입니다.

Feature

🕖 조회시간 파라미터 편의성 개선

현재 시간 defualt 값 적용, 발표 시간을 고려한 이전 데이터 조회

🗺️ grid 변환 로직 내장

위경도 -> 격자 테이블 데이터를 관리할 필요 없이 계산하여 자동으로 추론

📃 결과 가공 및 설명 추가

분석 및 애플리케이션에 적용을 용이하기 하기 위해 날짜별 그룹핑, 코드별 맵핑 및 description 추가
가공 전 origin 데이터 조회 on/off 기능

Example

import { VillageForecast } from "korea-public-village-forecast"

const villageForecast = new VillageForecast({
  serviceKey: VILLAGE_FORECAST_KEY,
});

// 초단기실황조회
const result = await villageForecast.getUltraSrtNcst({
  lat: 37.4871167,
  lng: 126.7274377,
  datetime: '2021-05-02 09:00'
});

{
  url: 'http://apis.data.go.kr/1360000/VilageFcstInfoService/getUltraSrtNcst?serviceKey=VILLAGE_FORECAST_KEY&pageNo=1&numOfRows=1024&base_date=20210613&base_time=0900&nx=56&ny=125&dataType=JSON',
  baseDate: '2021-05-02 09:00',
  items: [
    { category: 'PTY',
      value: '0',
      desc: '강수형태',
      valueDesc: '없음'
    },
    { category: 'REH', value: '77', desc: '습도(%)' },
    { category: 'RN1', value: '0', desc: '1시간 강수량(mm)' },
    { category: 'T1H', value: '23.8', desc: '기온(c)' },
    { category: 'UUU', value: '0.6', desc: '풍속(동서성분)' },
    {
      category: 'VEC',
      value: '196',
      desc: '풍향(deg)',
      valueDesc: 'S-SW'
    },
    { category: 'VVV', value: '2', desc: '풍속(남북성분)' },
    { category: 'WSD', value: '2.1', desc: '풍속(m/s)' }
  ],
  origin: null
}

Options

serviceKey : 부여받은 서비스 키(필수)

timeout : 기상청 통신 타임아웃 (기본값: 2000ms)

간헐적으로 기상청 측 response가 매우 느린 경우가 있어 이 부분을 핸들링 할 수 있습니다.

showOrigin : 원본 데이터 표시 여부

가공된 데이터 대신 이전 원본 데이터를 제공합니다.