자주 묻는 질문(FAQ)
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
도움말
이전 버전에서 새 Solar API로 이전하려면 어떻게 해야 하나요?
어디에서 도움을 받을 수 있나요?
이 오류 코드는 무엇을 의미하나요?
프로젝트 구성
Cloud 프로젝트에 어떤 권한이 필요한가요?
하나 이상의 Cloud 프로젝트에서 API 키를 사용할 수 있나요?
- 아니요. 하나의 Cloud 프로젝트에만 API 키를 사용하세요. Cloud 프로젝트가 여러 개인 경우 각 프로젝트에 자체 API 키가 있어야 합니다. 단일 프로젝트 내에는 여러 API 키가 있을 수 있습니다.
비용
비용을 제한하려면 어떻게 해야 하나요?
태양 모델
데이터는 얼마나 자주 새로고침되나요?
- 새로운 데이터는 항상 추가되지만 특정 지역에 대한 구체적인 새로고침 빈도는 없습니다. 일부 지역에서는 수년 된 이미지를 사용합니다.
관련 이미지의 날짜를 확인하고 의견을 제출해 주세요.
태양광 재무 분석의 가정에 대해 자세히 알아보려면 어디를 참고해야 하나요?
태양광 패널 배치를 평가할 때 API에서 굴뚝과 채광창을 고려하나요?
- 예, 높이 지도를 사용하면 굴뚝과 채광창이 작은 직사각형으로 식별되고 태양광 패널은 모델에서 제외됩니다.
API가 건물 내부를 볼 수 있나요?
API가 건물 단지 내 특정 아파트에 대한 평가를 할 수 있나요?
- 경우에 따라 다릅니다. 이 모델은 Google 지도 데이터를 사용하므로 아파트가 Google 지도에서 전체 건물로 분류되면 해당 건물의 특정 아파트 지붕이 별도로 표시됩니다.
API가 내가 알고 있는 건물의 데이터를 반환하지 않는 경우가 있는 이유는 무엇인가요?
- 이러한 문제는 당시 매핑이 이루어질 때 존재하지 않았던 새 건물이 있는 경우에 발생할 수 있습니다.
플럭스 태양광 데이터 레이어를 사용하여 그늘을 시각화하려면 어떻게 해야 하나요?
- 북쪽을 향하는 지붕은 플럭스 (일사량)가 적으므로 그늘이 더 많이 생깁니다. 태양광 평가를 수행할 때 이 정보를 활용할 수 있습니다. 플럭스 데이터 레이어를 사용하면 플럭스를 색상으로 시각화할 수 있습니다.
- 지붕에서 특정 숫자 값의 음영을 찾으려는 경우 자체 플럭스 타일을 만들어 색상을 맞춤설정할 수도 있습니다.
- 연중 그늘의 일일 스냅샷을 다시 가져와 연중 그늘이 변하는 애니메이션 GIF 또는 동영상을 만들 수 있습니다.
- 예, 플럭스 및 DSM (각 지점의 높이 맵) 태양광 데이터 레이어를 사용하여 더 세부적으로 맞춤설정할 수 있습니다.
API가 URL을 반환하는 이유는 무엇이며, URL을 사용하여 무엇을 할 수 있나요?
- URL은 해당 데이터 레이어를 다운로드할 수 있도록 하는 단기 포인터입니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[null,null,["최종 업데이트: 2025-08-27(UTC)"],[[["\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."]]
