国家可再生能源实验室 API 服务商

PVWatts-v5 API 为用户提供了对指定地点的估计太阳能产量数据的访问。在这里，我们将介绍如何在 JavaScript 中使用此 API，以及一些示例代码。

在开始使用 PVWatts-v5 API 之前，你需要从 NREL 开发者网络 获取一个 API 密钥。然后，你将能够使用这个密钥访问 PVWatts-v5 和其他 NREL API。

要在 JavaScript 中使用 PVWatts-v5 API，你需要向 API 的端点发起一个 HTTP GET 请求，将所需的参数作为查询字符串参数传递。你可以使用 fetch() 函数来实现这一点。下面是一个如何设置的例子。

const key = "YOUR_API_KEY";
const system_capacity = 4;
const module_type = 0;
const losses = 10;
const array_type = 0;
const tilt = 40;
const azimuth = -90;
const lat = 40.73061;
const lon = -73.93524;

const url = `https://developer.nrel.gov/api/solar/pvwatts/v5.json?api_key=${key}&system_capacity=${system_capacity}&module_type=${module_type}&losses=${losses}&array_type=${array_type}&tilt=${tilt}&azimuth=${azimuth}&lat=${lat}&lon=${lon}`;

fetch(url)
  .then((response) => response.json())
  .then((data) => console.log(data));

在这个例子中，我们将 key 变量设置为你的 API 密钥，其他变量设置为 PVWatts-v5 API 所需的参数。一旦你构建了 URL，我们使用 fetch() 来发起 API 请求。当响应回来时，我们使用 console.log() 来打印它的数据。

以下是 PVWatts-v5 API 的一些示例代码。

这个例子计算给定地点的估计能量产量，使用一个 4 kW DC 太阳能电池板系统。

const key = "YOUR_API_KEY";
const system_capacity = 4;
const module_type = 0;
const losses = 10;
const array_type = 0;
const tilt = 40;
const azimuth = -90;
const lat = 40.73061;
const lon = -73.93524;

const url = `https://developer.nrel.gov/api/solar/pvwatts/v5.json?api_key=${key}&system_capacity=${system_capacity}&module_type=${module_type}&losses=${losses}&array_type=${array_type}&tilt=${tilt}&azimuth=${azimuth}&lat=${lat}&lon=${lon}`;

fetch(url)
  .then((response) => response.json())
  .then((data) => console.log(data.outputs))
  .catch((error) => console.log(error));

这个例子根据估计的最高能量产量，为给定地点寻找最佳倾斜角和方位角。

const key = "YOUR_API_KEY";
const system_capacity = 4;
const module_type = 0;
const losses = 10;
const array_type = 0;
const lat = 40.73061;
const lon = -73.93524;

let highestEnergy = 0;
let optimalTilt = 0;
let optimalAzimuth = 0;

for (tilt = 0; tilt <= 90; tilt++) {
  for (azimuth = -180; azimuth <= 180; azimuth++) {
    const url = `https://developer.nrel.gov/api/solar/pvwatts/v5.json?api_key=${key}&system_capacity=${system_capacity}&module_type=${module_type}&losses=${losses}&array_type=${array_type}&tilt=${tilt}&azimuth=${azimuth}&lat=${lat}&lon=${lon}`;

    fetch(url)
      .then((response) => response.json())
      .then((data) => {
        const energy = data.outputs.ac_annual;
        if (energy > highestEnergy) {
          highestEnergy = energy;
          optimalTilt = tilt;
          optimalAzimuth = azimuth;
        }
      })
      .catch((error) => console.log(error));
  }
}

console.log(`最佳倾斜角: ${optimalTilt}`);
console.log(`最佳方位角: ${optimalAzimuth}`);
console