> For the complete documentation index, see [llms.txt](https://doc.re-cast.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.re-cast.ai/encored-renewable-api-ko/readme.md). # 인코어드 신재생에너지 특화 기상 API *** ## 목차 1. [인코어드 신재생에너지 기상 API에 오신 것을 환영합니다](#welcome) 2. [인증](#authentication) 3. [요청 제한 및 할당량](#rate-limits-and-quotas) 4. [데이터 소스별 특성 비교](#data-source-comparison) 5. [시간 해상도](#temporal-resolution) 6. [데이터 조회 방식](#data-retrieval-methods) 7. [프로토콜 (NWP 예보)](#protocols) *** ## 인코어드 신재생에너지 기상 API에 오신 것을 환영합니다 인코어드 신재생에너지 API(RE:Cast)는 재생에너지 발전량 예측에 특화된 클라우드 기반 기상 데이터 서비스입니다. 전구 예보 데이터를 초기값으로 활용해 한반도 특화 고해상도 기상 예측을 생성합니다. RESTful API를 통해 하루 2\~4번 갱신되는 실시간 예보 데이터(Forecast Data)와 2020년 이후 과거 기간 예보 및 분석장 상세화 데이터(Historical Data)를 제공합니다. ※ 과거 기간 예보의 제공 기간은 지점에 따라 다를 수 있습니다. ### 왜 고해상도인가 기존 기상 예측 서비스가 제공하는 5km 이상의 공간 해상도는 발전소가 위치한 정확한 지점에 대한 기상 예측값 제공이 불가합니다. 공간 해상도를 1km 미만으로 줄이면 특정 발전소 위치에 대한 정확한 기상 예측값을 제공할 수 있으며, 발전량 예측 정확도를 높일 수 있습니다. 풍속과 같이 빠르게 변하는 요소는 시간별 예측으로는 정확한 정보 제공이 어렵습니다. 10분 간격의 기상 예보를 통해 특히 풍력 발전량 예측의 정밀도를 높일 수 있습니다. ### 기상 모델 자체 기상예보 모델을 사용하여 한반도에 대한 고해상도 기상 예측을 수행합니다. 전구 모델 대비 지역적 특성(지형, 지형 유형, 지형 해상도 등)을 더 정확하게 모델링하여 예보 정확성을 향상시킵니다. 6시간 이내 날씨를 다루는 초단기 예보부터 수시간\~수일 앞을 내다보는 단기 예보까지 강점을 가집니다. ### 워크플로우 RE:Cast는 아래 워크플로우를 통해 재생에너지 발전량 예측 시스템에 단계적으로 통합 활용할 수 있습니다. * 과거 기간 예보 및 분석장 데이터 수집 * 발전량 예측 모델 학습 * 실시간 예보 데이터 수집 및 발전량 예측값 추론 *** ## 인증 모든 API 요청에는 API key가 필요합니다. 발급은 [관리자](mailto:esolution@encoredtech.com)에게 문의하세요. ## 요청 제한 및 할당량 사용 플랜에 따라 API 요청 속도와 일정 기간 내 총 사용량이 제한될 수 있습니다. *** ## 데이터 소스별 특성 비교 | 구분 | KMA 초단기예보 (VSRF) | KMA 단기예보 (SRF) | NWP 예보 | | --------- | ---------------- | -------------- | -------------------------- | | 예보 범위 | 6시간 이내 | 72시간 (3일) | 48 \~ 168 시간 | | 갱신 주기 | 1시간 | 3시간 | 6시간 | | 커버리지 | 대한민국 | 대한민국 | 대한민국 | | 좌표계 | KMA NX/NY 격자 | KMA NX/NY 격자 | NX/NY 격자 | | 공간 해상도 | 5 km × 5 km | 5 km × 5 km | 1 km × 1 km \~ 0.1° × 0.1° | | 데이터 제공 기간 | 2025.09\~ | 2025.09\~ | 2020.01\~ | | 응답 포맷 | JSON | JSON | JSON | *** ## 시간 해상도 | 데이터 소스 | 발표 시각 형식 | 예보 시간 간격 | 예보 범위 | 갱신 주기 | | ---------- | ----------------------------------------------------- | ---------- | ----------- | ----------- | | VSRF (초단기) | HH30 (0030, 0130, ... 2330) | 1시간 | 6시간 | 1시간 | | SRF (단기) | HH00 (0200, 0500, 0800, 1100, 1400, 1700, 2000, 2300) | 1시간 | 72시간 | 3시간 | | NWP 예보 | HH00 (0300, 0900, 1500, 2100) | 10분 \~ 1시간 | 48 \~ 168시간 | 6시간 \~ 12시간 | *** ## 데이터 조회 방식 KMA 예보자료(단기/초단기)와 NWP 예보자료는 데이터 출처와 성격이 다르며, 조회 유형 체계도 별도로 구성됩니다. | 구분 | KMA 단기 / 초단기 | NWP 예보 | | ------ | ------------------------------- | ----------------------------------------------------------------------- | | 데이터 출처 | KMA 수신 후 제공 | 자체 기상 모델 생성 | | 모델 구분 | 없음 | `modelComb` 파라미터(프로토콜)로 구분 | | 조회 유형 | `default` / `recent` / `latest` | `most-recent` / `recent` / `recent-latest` / `recent-dayahead` / `past` | *** ### KMA 단기 / 초단기 단기(SRF)와 초단기(VSRF)는 엔드포인트 경로만 다르며 조회 유형 옵션은 동일합니다. **`default`** * 대상이 되는 그리드에 대해 입력된 발표 날짜 및 시간의 단기/초단기 데이터를 요청합니다. * 기준일시(`YYYYMMDD`, `HH`)를 특정해서 요청해야 합니다. **`recent`** * 요청하는 시간 기준 가장 최근의 발표 시간에 대한 데이터를 반환합니다. **`latest`** * 여러 발표시간의 예보자료를 이어붙여서 가장 최근의 basetime 데이터만 반환합니다. * 각 대상 시각 기준으로 가장 최신의 예보자료를 의미합니다. ### NWP 예보자료 자체 기상 모델로 생성한 예보 데이터입니다. `modelComb` 파라미터(프로토콜)에 따라 반환되는 기상변수 조합이 달라집니다. → [프로토콜 참고](#protocols) **`most-recent`** * 제공 가능한 가장 마지막 cycle 예보자료를 반환합니다. * 현 시점에 가장 최신의 예보자료를 의미합니다. * KMA의 `recent`와 동일한 개념입니다. NWP는 cycle 단위로 운영되므로 용어를 구분합니다. **`recent`** * 요청한 기준일시의 cycle 예보자료를 반환합니다. * 기준일시(`YYYYMMDDHH`)를 특정해서 요청해야 합니다. **`recent-latest`** * 여러 cycle 예보자료를 이어붙여서 각 대상 시각(valid time)마다 가장 마지막 예보자료를 반환합니다. * 각 대상 시각 기준으로 가장 최신의 예보자료를 의미합니다. **`recent-dayahead`** * 여러 날짜의 cycle 예보자료를 이어붙여 하루 전 예보자료를 구성하여 반환합니다. * 기준일시 중 시각(`HH`)을 특정해서 요청해야 합니다. **`past`** * 과거 예보기상 데이터로부터 해당 basetime 범위 + filters 조건을 적용한 결과를 반환합니다. ### 프로토콜 (NWP 예보) 프로토콜은 발전 유형에 따라 두 그룹으로 구분됩니다. * **PV (태양광)**: 태양광 발전량 예측에 필요한 변수를 포함합니다. * **WT (풍력)**: 풍력 발전량 예측에 필요한 변수를 포함합니다. | 프로토콜 | 유형 | 기상변수 수 (고정) | 기상변수 수 (일부 시점) | | -------------------- | -- | ----------- | -------------- | | EchoLimaWhiskeySolar | PV | 902 | 4 | | EclipseSolar | PV | 278 | 4 | | EclipseWhiskeySolar | PV | 598 | 4 | | EchoLimaWhiskeyPlus | WT | 715 | 4 | | EclipseWinds | WT | 278 | 4 | | EclipseWhiskeyWinds | WT | 411 | 4 | ※ `EchoLimaWhiskeySolar`, `EchoLimaWhiskeyPlus` 프로토콜은 2026년 3월 31일 까지만 제공됩니다. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://doc.re-cast.ai/encored-renewable-api-ko/readme.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.