> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/getting-started/solar-estimate.md).

# 在 Duaer 里查光伏发电估算

在 Duaer 里：美国国家可再生能源实验室 PVWatts：某地屋顶光伏系统每年与每月的发电量估算。一次成功查询用 1 额度。
## 能拿到什么

Duaer 数据市场里的「光伏发电估算」：美国国家可再生能源实验室 PVWatts：某地屋顶光伏系统每年与每月的发电量估算。查到结果时用 1 额度，结果交给数字组织的下一个节点。

从节点创建器选 Duaer 数据 → 光伏发电估算，或打开 [数据市场](/zh/getting-started/data-market.md)。相关：[太阳辐射与气候（NASA POWER）](/zh/getting-started/nasa-power.md)、[充电站与替代燃料站](/zh/getting-started/ev-stations.md)。

## 适合做什么

- 估算丹佛 6 千瓦屋顶光伏的年发电量。
- 比较夏季与冬季的光伏发电。

## 在画布里检索

1. 打开节点创建器，选 Duaer 数据 → Solar power estimate。
2. 填 Latitude 与 Longitude（如 40.0 与 -105.2）；System Size (kW)、Tilt、Azimuth 可选。
3. Limit 默认 10，最大 20。执行。

查到结果才扣 1 额度；没有结果、输入有误或上游失败都不扣。

## 用 API 调用

- GET https://api.duaer.com/v1/data/solar-estimate?latitude=40.0&longitude=-105.2
- Authorization: Bearer <Duaer key>

下方是与数据市场「复制技能」相同的英文技能，含参数、示例与返回字段。

## 调用技能（英文）

与数据市场「复制技能」一致。

```
---
name: duaer-solar-estimate
description: >-
  Duaer Solar power estimate. NREL PVWatts: yearly and monthly electricity a rooftop solar system would make at a location.
  One successful search uses 1 Duaer credit.
---

# Duaer Solar power estimate

Duaer Solar power estimate runs NREL PVWatts for a location and returns the yearly total first, then one row per month. Set the system size, tilt, and facing to match a roof. Duaer holds the upstream API key; you only send your Duaer key.

## When to use

- Estimate how much a 6 kW roof system would make in Denver.
- Compare summer and winter solar output.

## When not to use

- Daily sunshine and weather history. Use https://skills.duaer.com/nasa-power.md.
- Sunrise and sunset times. Use https://skills.duaer.com/sunrise.md.

## Call

`GET https://api.duaer.com/v1/data/solar-estimate?latitude=40.0&longitude=-105.2`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `latitude` and `longitude`.

- `latitude`, `longitude` — Decimal degrees, such as 40.0 and -105.2.
- `systemKw` — Optional. DC size in kW. Default 4.
- `tilt` — Optional. Panel tilt in degrees, 0 to 90. Default 20.
- `azimuth` — Optional. Compass direction the panels face; 180 is south. Default 180.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/solar-estimate?latitude=40.0&longitude=-105.2` — a 4 kW system near Boulder.
- `GET https://api.duaer.com/v1/data/solar-estimate?latitude=33.45&longitude=-112.07&systemKw=6&tilt=30` — a 6 kW system in Phoenix.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `period` — `year` or a month name.
- `acKwh` — AC electricity in kWh.
- `sunKwhPerM2Day`, `capacityFactorPct` — sunshine on the panels and capacity factor.
- `systemKw`, `tilt`, `azimuth`, `weatherSite` — inputs used and the weather station.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/nasa-power.md — Duaer Solar and climate (NASA POWER)
- https://skills.duaer.com/ev-stations.md — Duaer EV charging and fuel stations

```
## Questions

### Duaer 的光伏发电估算检索扣多少额度？

查到结果时扣 1 额度；没有结果或出错不扣。

### Duaer 光伏发电估算只适用于美国吗？

PVWatts 覆盖美国最好，也支持部分其他地区；返回的 weatherSite 是所用的气象数据站点。

## 相关

- [在 Duaer 里查太阳辐射与气候（NASA POWER）](https://doc.duaer.com/zh/getting-started/nasa-power.md)
- [在 Duaer 里查充电站与替代燃料站](https://doc.duaer.com/zh/getting-started/ev-stations.md)