technical article

PV API 조달: 두 엔드포인트 모두 JSON 또는 XML 지정

2026년 11월 17일Updated: 2026년 11월 17일6 min read사실 확인됨
Cinn Song

Cinn Song

Founder & Chief Solutions Architect

PV API 조달: 두 엔드포인트 모두 JSON 또는 XML 지정

Solar Dataset Query V2와 PVWatts V8 모두에 JSON 또는 XML을 명시적으로 지정하십시오. CSV는 탐색용으로만 문서화되어 있습니다. 현장 좌표, 계산 입력값, 기상 파일 추적성 및 엔드포인트별 검수 항목을 요구하십시오. 계산 결과의 CSV 내보내기는 별도로 명세해야 하는 애플리케이션 납품 항목으로 취급하십시오.

요약

Solar Dataset Query V2와 PVWatts V8 모두에 JSON 또는 XML을 명시적으로 지정하십시오. CSV는 탐색용으로만 문서화되어 있습니다. 현장 좌표, 계산 입력값, 기상 파일 추적성 및 엔드포인트별 검수 항목을 요구하십시오. 계산 결과의 CSV 내보내기는 별도로 명세해야 하는 애플리케이션 납품 항목으로 취급하십시오.

핵심 사항

  • JSON과 XML은 두 엔드포인트 모두에 문서화되어 있으며, CSV는 Solar Dataset Query V2에만 나열되어 있습니다.
  • 두 엔드포인트 모두 응답 형식을 명시적으로 지정해야 하며, 문서에 기본 형식은 제시되어 있지 않습니다.
  • PVWatts V8은 탐색 결과의 유효한 file_id를 사용할 수 있습니다. 이 식별자를 사용할 때는 dataset을 생략하십시오.
  • 기상 데이터 출처 정보와 거리를 기록하고, 탐색 반경의 마일 단위와 반환 거리의 미터 단위를 구분하십시오.
  • 계산 입력값, 시간 간격 및 단위를 지정하십시오. 월별 에너지와 시간별 전력은 서로 다른 출력 필드입니다.
  • 검수 전에 두 엔드포인트의 파서, 기상 파일 전달, 경고 및 잘못된 입력 처리를 검증하십시오.

기후 데이터 탐색과 PV 발전량 계산 전반에 JSON 또는 XML 지정

요약: Solar Dataset Query V2와 PVWatts V8 모두에 JSON 또는 XML을 지정하십시오. 두 엔드포인트 모두 이러한 응답 형식을 문서화하고 있으며, CSV는 탐색용으로만 나열되어 있습니다. 명시적인 형식 선택, 현장 좌표, 계산 입력값 및 기상 파일 추적성을 요구하십시오. 연동을 검수하기 전에 각 엔드포인트를 개별적으로 검증하십시오.

1. 두 엔드포인트가 모두 지원하는 형식 선택

PV API 조달: 두 엔드포인트 모두 JSON 또는 XML 지정 — 상세 기능 구성

기후 데이터 탐색과 PV 발전량 계산을 포함하는 조달 명세에서는 JSON 또는 XML 중 하나를 공통 응답 형식으로 요구하십시오. Solar Dataset Query V2에는 json, xml, csv가 나열되어 있고, PVWatts V8에는 json과 xml이 나열되어 있습니다. 두 문서 모두 format을 필수로 설명하며 기본값은 제시하지 않습니다. 요청 URL에서는 선택한 형식이 엔드포인트 버전 뒤에 위치합니다. Solar Dataset Query V2; PVWatts V8

권장 계약 문구는 다음과 같습니다. “연동 시스템은 탐색과 계산 모두에 JSON을 명시적으로 요청하거나, 수신 시스템에서 요구하는 경우 두 작업 모두에 XML을 명시적으로 요청해야 한다. CSV 탐색 지원은 별도로 명세해야 한다.” 구매자의 수신 소프트웨어와 검수 요건에 따라 JSON과 XML 중에서 선택하십시오. 문서에 나열된 형식 목록만으로는 어느 쪽의 성능 우위도 입증되지 않습니다.

CSV는 문서화된 탐색 옵션입니다. 그러나 Solar Dataset Query V2에 CSV가 포함되어 있다는 사실이 PVWatts V8의 CSV 지원을 입증하지는 않습니다. 입찰자가 계산 결과를 CSV로 제공하겠다고 제안하는 경우, 애플리케이션에서 생성하는 내보내기 파일인지 확인하고 별도의 내보내기 명세를 요구하십시오. 탐색 형식 지원을 계산 인터페이스의 검증 근거로 인정하지 마십시오.

2. 탐색에서 계산으로의 전달 과정 명세

PV API 조달: 두 엔드포인트 모두 JSON 또는 XML 지정 — 상세 시스템 운영 및 유지보수

Solar Dataset Query V2에는 API 키, 위도, 경도 및 응답 형식이 필요합니다. 이 엔드포인트는 식별자, 좌표, 거리 및 기상 데이터 출처를 포함하여 사용 가능한 기후 파일 정보를 반환합니다. 결과가 없는 데이터셋의 경우 문서화된 응답에는 null과 경고가 포함됩니다. 애플리케이션이 이러한 경고를 탐색 결과와 함께 보존하도록 요구하는 것이 좋습니다. Solar Dataset Query V2

PVWatts V8은 현장 위도와 경도 또는 file_id를 받습니다. file_id는 Solar Dataset Query V2에서 반환한 유효한 식별자여야 합니다. 문서에서는 이 식별자를 지정할 때 dataset을 전달하지 말라고 명시합니다. 감사 가능한 전달 과정을 확보하려면 선택한 탐색 식별자를 기록하고 계산 엔드포인트에 명시적으로 제출하는 것이 좋습니다. PVWatts V8

검색 설정도 명시적으로 다뤄야 합니다. 탐색 문서에서 radius의 단위는 마일이고, 반환되는 distance의 단위는 미터입니다. 문서에는 radius=0이 거리에 관계없이 가장 가까운 관측소를 찾으며, all=1에는 양수 반경이 필요하다고 명시되어 있습니다. 예시 요청은 반경 0과 all=1을 함께 사용하지만, 조달 검수에서는 매개변수 규칙을 따르고 모든 관측소를 요청할 때 양수 반경으로 테스트해야 합니다. Solar Dataset Query V2

계산 승인 전에 입찰자에게 선택한 기상 레코드와 해당 거리를 제시하도록 요청하는 것이 좋습니다. 탐색 응답이 성공했다는 사실만으로 구매자가 해당 레코드를 프로젝트에 사용하도록 승인한 것으로 간주해서는 안 됩니다.

3. 계산 입력값과 출력의 의미 정의

공통 직렬화 형식이 계산 명세를 대체하지는 않습니다. PVWatts V8에는 위치 또는 기후 파일 선택 정보와 API 접근 매개변수뿐 아니라 정격 용량, 모듈 유형, 시스템 손실, 어레이 유형, 경사각 및 방위각이 필요합니다. 제출하는 각 값을 명시하고 의도적으로 선택한 값과 문서에 명시된 기본값을 구분하는 프로젝트 입력값 목록을 요구하는 것이 좋습니다. PVWatts V8

출력의 시간 단위도 지정하십시오. PVWatts V8의 기본값은 월별 결과이며, timeframe=hourly도 허용합니다. 월별 AC 및 DC 출력은 kWhac와 kWhdc 단위의 에너지 값이고, 시간별 AC 및 DC 출력은 Wac와 Wdc 단위의 전력 값입니다. 월별 배열은 1월부터 12월까지 순서대로 구성됩니다. 이러한 필드명, 단위 및 순서를 인터페이스 검수표에 포함하는 것이 좋습니다. PVWatts V8

기상 데이터 추적성을 위해 기상 데이터 출처와 태양광 자원 파일명을 포함한 station_info의 보존을 요청하십시오. 문서화된 응답에는 수신한 입력값, 오류, 경고, 서비스 버전 및 SSC 라이브러리 정보도 포함됩니다. 구매자가 모델링된 구성과 그 출처를 확인할 수 있도록 검토된 각 추정치와 함께 관련 계산 응답을 저장하는 것이 좋습니다. PVWatts V8

4. 엔드포인트별 점검을 통한 연동 검수

입찰자에게 선택한 형식으로 탐색과 계산을 개별 시연한 다음, 두 작업 사이의 전달 과정을 시연하도록 요구하는 것이 좋습니다. 탐색 식별자, 데이터셋 부재 경고 및 선택한 기후 레코드를 확인하십시오. 계산의 경우 제출한 입력값, 반환된 관측소 정보, 요청한 시간 간격 및 출력 단위를 확인하십시오.

두 엔드포인트가 모두 JSON 또는 XML을 사용하더라도 각 엔드포인트의 파서를 별도로 점검하도록 요구하십시오. 탐색은 사용 가능한 기후 파일을 설명하며, PVWatts는 시뮬레이션 결과와 계산 메타데이터를 반환합니다. 따라서 공통 형식은 명시적인 필드 매핑과 함께 계약에서 정해야 할 사항입니다. Solar Dataset Query V2; PVWatts V8

두 문서 모두 매개변수가 누락되거나 유효하지 않을 때 HTTP 422를 반환한다고 설명하며, 응답의 오류 항목을 확인하도록 안내합니다. 검수 테스트에 잘못된 입력 사례를 포함하고, 애플리케이션이 이를 발전량 추정치로 제시하지 않고 오류로 보고하는지 검증하는 것이 좋습니다. 두 문서 모두 시간당 1,000회 요청 제한도 명시합니다. 제안한 요청 일정이 이 제한을 어떻게 준수하는지 입찰자에게 설명하도록 요청하십시오. Solar Dataset Query V2; PVWatts V8

검수 범위는 정상 작동하는 탐색 및 시뮬레이션 인터페이스입니다. PVWatts V8은 예측 발전량 출력을 문서화하고 있습니다. 프로젝트 발전량 보증이 수반되는 조달 결정을 내릴 때는 해당 보증을 뒷받침하는 별도의 프로젝트별 증빙과 계약 조건을 요청하십시오.

자주 묻는 질문

계약에서 JSON과 XML 중 어느 것을 요구해야 합니까?

수신 소프트웨어에 적합한 형식을 선택하여 둘 중 하나를 공통 형식으로 요구하십시오. 두 엔드포인트 모두 JSON과 XML을 문서화하고 있습니다.

두 API 모두에 CSV를 지정할 수 있습니까?

CSV는 Solar Dataset Query V2에 문서화되어 있지만 PVWatts V8 응답 형식에는 나열되어 있지 않습니다. 애플리케이션에서 생성하는 계산 결과 CSV 내보내기는 별도로 명세하십시오.

연동 시 형식 선택을 생략할 수 있습니까?

두 문서 모두 형식을 필수로 표시하며 기본값을 나열하지 않습니다. 각 요청에서 명시적으로 선택하도록 요구하십시오.

탐색한 기후 파일을 계산에 사용하도록 선택하려면 어떻게 해야 합니까?

탐색 결과의 유효한 식별자를 PVWatts V8의 file_id로 전달하십시오. 문서에서는 file_id와 함께 dataset을 전달하지 말라고 명시합니다.

radius=0은 탐색 범위를 프로젝트 위치로 제한합니까?

아닙니다. 거리에 관계없이 가장 가까운 관측소를 선택합니다. 기상 레코드를 승인하기 전에 반환된 거리를 확인하십시오.

탐색 시 특정 데이터셋에 대한 데이터를 찾지 못하면 어떻게 됩니까?

Solar Dataset Query V2 문서에는 해당 데이터셋에 대해 null 출력과 경고가 반환된다고 명시되어 있습니다. 애플리케이션이 이를 보존하고 보고하도록 요구하십시오.

시간별 AC 값은 에너지로 보고됩니까?

PVWatts V8 문서에서 시간별 ac의 단위는 Wac입니다. 월별 ac_monthly와 연간 ac_annual의 단위는 kWhac로 명시되어 있습니다.

잘못된 입력에 대한 검수 테스트에서는 무엇을 확인해야 합니까?

두 문서 모두 매개변수가 유효하지 않거나 누락된 경우 HTTP 422를 반환한다고 설명합니다. 애플리케이션이 오류 항목을 읽고 실패를 보고하는지 검증하십시오.

품질 점수:96/100

저자 소개

Cinn Song

Cinn Song

Founder & Chief Solutions Architect

Cinn Song founded SOLARTODO LIMITED and leads its smart-city infrastructure engineering — from solar, storage and integrated smart poles to the company's push into physical-AI city edge nodes: pole-mounted edge computing, vertical LLMs for smart cities, drone-based O&M with autonomous battery swapping, robotic maintenance, and high-speed counter-UAS interception. Since 2010, he has directed turnkey EPC + BOT delivery across 50+ countries, including telecom monopole supply for national grid operators, off-grid solar street-lighting for African municipalities, and integrated smart-pole programs for Gulf smart cities.

모든 게시물 보기

이 기사 인용

APA

Cinn Song. (2026). PV API 조달: 두 엔드포인트 모두 JSON 또는 XML 지정. SOLARTODO. Retrieved from https://solartodo.com/ko/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations

BibTeX
@article{solartodo_should_the_pv_software_integration_specify_json_or_xml_for_both_climate_data_discovery_and_production_calculations,
  title = {PV API 조달: 두 엔드포인트 모두 JSON 또는 XML 지정},
  author = {Cinn Song},
  journal = {SOLARTODO Knowledge Base},
  year = {2026},
  url = {https://solartodo.com/ko/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations},
  note = {Accessed: 2026-11-17}
}

Published: November 17, 2026 | Available at: https://solartodo.com/ko/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations

뉴스레터 구독하기

최신 태양광 에너지 뉴스 및 통찰력을 귀하의 이메일로 받아보세요.

모든 기사 보기