常见问题解答
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
帮助
如何从旧版迁移到新版 Solar API？
我可以从哪里获得帮助？
这些错误代码是什么意思？
项目配置
我需要在 Cloud 项目中拥有哪些权限？
我可以将 API 密钥用于多个 Cloud 项目吗？
- 不可以，您只能将 API 密钥用于一个 Cloud 项目。如果您有多个 Cloud 项目，则每个项目都应有自己的 API 密钥。请注意，在单个项目中，拥有多个 API 密钥是正常现象。
费用
如何限制费用？
太阳能模型
数据刷新频率如何？
- 我们会不断添加新数据，但不会针对特定地区设置特定的刷新频率。部分地区使用的图像已有数年历史。
请查看相关影像的拍摄日期，并随时提交反馈。
在哪里可以详细了解太阳能财务分析的假设？
在评估太阳能电池板放置位置时，API 是否会考虑烟囱和天窗？
- 可以。借助高度图，系统会将烟囱和天窗识别为小矩形，并排除太阳能电池板。
该 API 能否看到建筑物内部？
API 是否可以针对建筑群内的特定公寓进行评估？
- 视情况而定。该模型使用 Google 地图数据，因此如果公寓在 Google 地图中被归类为整栋建筑，则该建筑中特定公寓的屋顶会单独显示。
为什么 API 有时不会返回我知道存在的建筑物的任何数据？
- 如果当时实现地图功能时没有较新的建筑物，就可能会出现这种情况。
如何使用通量太阳能数据图层直观呈现阴影？
- 朝北的屋顶接收到的通量（太阳辐照度）较少，这意味着它们的阴影会更深。您可以在进行太阳能评估时利用此信息。借助流量数据层，您可以直观地以颜色显示流量。
- 或者，您也可以制作自己的通量图块并自定义其颜色，尤其是在您希望在屋顶上找到特定数值的阴影时。
- 您可以获取全年每天的阴影快照，并生成一年内阴影变化的动画 GIF 或视频。
- 可以，您可以使用通量和 DSM（每个点的高度地图）太阳能数据层进行更精细的自定义。
为什么 API 会返回网址？我可以使用这些网址做什么？
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-27。
[null,null,["最后更新时间 (UTC)：2025-08-27。"],[[["\u003cp\u003eThe Solar API provides tools and data for solar potential assessment, including financial analysis and shade visualization.\u003c/p\u003e\n"],["\u003cp\u003eUsers can access support resources and migration guides for transitioning from previous API versions.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Maps data is used for building identification and solar panel placement, with limitations for newer buildings and interior assessments.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers data layers like flux and DSM for visualizing shade and performing custom calculations, accessed via short-lived URLs.\u003c/p\u003e\n"],["\u003cp\u003eCost management strategies are available through Google Cloud's budgeting documentation.\u003c/p\u003e\n"]]],["To migrate, consult the migration guide. For help, see support options. Error codes are detailed in HTTP status code documentation. Each Cloud project requires its own API key. Limit costs with budgeting documentation. Data refresh rates vary by region; provide feedback on old imagery. Solar financial analysis uses Clean Power Research data. The API considers chimneys/skylights and assesses only roofs, not building interiors. Shade is visualized via flux data; use `hourlyShadeUrls` for shade animation. Customize with flux and DSM solar data layers. URLs provide temporary access to download data layers.\n"],null,["# Frequently Asked Questions\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google\n| Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. [Learn more](/maps/comms/eea/faq). In addition, certain content from the Solar API will no longer be returned. [Learn more](/maps/comms/eea/solar).\n\nHelp\n----\n\n### How do I migrate to the new Solar API from the previous version?\n\n- Review our [migration guide](/maps/documentation/solar/migration).\n\n### Where can I get help?\n\n- Check out [Support Options for Solar API](/maps/documentation/solar/support).\n\n### What do these error codes mean?\n\n- Read more about [HTTP status codes](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status).\n\nProject configuration\n---------------------\n\n### What permissions do I need on my Cloud project?\n\n- See [the documentation](https://developers.google.com/maps/roles).\n\n### Can I use my API key with more than one Cloud project?\n\n- No, only use your API key for one Cloud project. If you have more Cloud projects, each should have their own API key. Note that, within a single project, it's normal to have several API keys.\n\nCost\n----\n\n### How do I limit costs?\n\n- See the [Budgeting\n documentation](https://cloud.google.com/billing/docs/how-to/budgets) for strategies and tips.\n\nSolar model\n-----------\n\n### How often are data refreshed?\n\n- New data are added all the time, but we don't have a specific refresh rate for specific regions. Some regions use imagery that is several years old. Please check the dates of the relevant imagery, and feel free to [file\n feedback](https://issuetracker.google.com/issues/new?component=1356349&template=1817492).\n\n### Where can I learn more about the assumptions for the solar financial analysis?\n\n- Google uses information about government solar incentives, along with other financial data and models, from [Clean Power\n Research](https://www.cleanpower.com/).\n\n### Are chimneys and skylights taken into consideration by the API when making an assessment of solar panel placement?\n\n- Yes, with height maps chimneys and skylights are identified as small rectangles, and solar panels are excluded by the model.\n\n### Can the API see inside of buildings?\n\n- No, just the roofs.\n\n### Can the API make assessments for a specific apartment within a building complex?\n\n- Depends. The model uses Google Maps data, and so if the apartment is classified as a whole building in Google Maps, then the roof of a specific apartment of that building are displayed as separate.\n\n### Why does the API sometimes not return any data for a building which I know exists?\n\n- This can happen when there are newer buildings that did not exist when mapping was realized at the time.\n\n### How can I use the flux solar data layer for visualizing shade?\n\n- North-facing roofs get less flux ([solar\n irradiance](https://en.wikipedia.org/wiki/Solar_irradiance)), which means they will have higher shade. You can leverage this information when performing solar assessments. The flux data layer lets you visualize flux in colors.\n- You can alternatively make your own flux tiles and customize their colors, especially if you wish to locate specific numerical values of shade on a roof.\n\n### How can I use `hourlyShadeUrls` from the [dataLayers service](/maps/documentation/solar/reference/rest/v1/dataLayers)?\n\n- You can get back a daily snapshot of shade throughout the year, and produce an animated GIF or video of shade changing during a year.\n\n### Can I perform my own custom calculations?\n\n- Yes, can use the flux and DSM (height map at each point) solar data layers for greater customization.\n\n### Why does the API return a URL, and what can I do with them?\n\n- The URLs are short-lived pointers to enable you to download the corresponding data layers."]]
