咨询NSRDB/NREL API中address查询参数的正确格式

有效格式规范 #

address参数需要传递地理编码服务可识别的完整结构化地址，同时注意URL编码的正确性，以下是经过验证的有效格式：

• 手动URL编码格式（空格用%20，逗号用%2C）：

  .../?address=12345%20N%20Street%2C%20City%2C%20State%2012345
  

• 原始地址格式（推荐用请求库自动处理编码，避免手动出错）：
  以Python requests库为例：

  import requests
  
  params = {
      "address": "12345 N Street, City, State 12345",
      "api_key": "YOUR_API_KEY",
      "dataset": "psm3-2018",
      "attributes": "ghi,dhi,dni"
  }
  
  response = requests.get(
      "https://developer.nrel.gov/api/solar/nsrdb/v2/solar/psm3-download.json",
      params=params
  )
  

常见无效原因排查 #

你之前尝试的格式失效，大概率是以下原因：

1. 地址精度不足：地理编码服务无法解析不完整的地址（比如缺少州、邮编，或街道名称拼写错误）
2. 缺少必要参数：NSRDB API强制要求传递api_key，同时需搭配dataset、attributes等核心参数，仅传address会导致请求失败
3. 端点不支持：部分NSRDB端点仅支持经纬度参数，确认你调用的是支持地理编码的端点（如PSM3下载端点/v2/solar/psm3-download.json）

官方文档参考 #

根据NSRDB官方说明，address参数的作用是让API自动将地址转换为经纬度，其底层依赖的地理编码服务兼容通用地址格式——只要地址能被主流地图服务识别，即可被API解析。

内容的提问来源于stack exchange，提问作者alvrm