technical article

PV APIの調達:両エンドポイントにJSONまたはXMLを指定

2026年11月17日Updated: 2026年11月17日1 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では正の半径が必要であると記載されています。リクエスト例では半径ゼロと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時間あたり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/ja/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/ja/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/ja/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations

ニュースレターに登録

最新の太陽エネルギーニュースとインサイトをあなたの受信箱にお届けします。

すべての記事を見る