Häufig gestellte Fragen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Entwickler im Europäischen Wirtschaftsraum (EWR)
Hilfe
Wie migriere ich von der vorherigen Version zur neuen Solar API?
Wo kann ich Hilfe erhalten?
Was bedeuten diese Fehlercodes?
Projektkonfiguration
Welche Berechtigungen benötige ich für mein Cloud-Projekt?
Kann ich meinen API-Schlüssel mit mehreren Cloud-Projekten verwenden?
- Nein, verwenden Sie Ihren API-Schlüssel nur für ein Cloud-Projekt. Wenn Sie mehrere Cloud-Projekte haben, sollte jedes einen eigenen API-Schlüssel haben. In einem einzelnen Projekt sind mehrere API-Schlüssel normal.
Kosten
Wie kann ich die Kosten begrenzen?
Solarmodell
Wie oft werden Daten aktualisiert?
- Es werden ständig neue Daten hinzugefügt, aber wir haben keine bestimmte Aktualisierungsrate für bestimmte Regionen. In einigen Regionen werden Bilder verwendet, die mehrere Jahre alt sind.
Bitte prüfen Sie die Daten der entsprechenden Bilder und geben Sie uns gern Feedback.
Wo finde ich weitere Informationen zu den Annahmen für die finanzielle Analyse von Solaranlagen?
- Google verwendet Informationen zu staatlichen Förderprogrammen für Solaranlagen sowie andere Finanzdaten und ‑modelle von Clean Power Research.
Werden Schornsteine und Dachfenster bei der Bewertung der Platzierung von Solarmodulen durch die API berücksichtigt?
- Ja. Auf Höhenkarten werden Schornsteine und Dachfenster als kleine Rechtecke identifiziert. Solarmodule werden vom Modell ausgeschlossen.
Kann die API in Gebäude sehen?
Kann die API Bewertungen für eine bestimmte Wohnung in einem Gebäudekomplex vornehmen?
- Das kommt darauf an. Das Modell verwendet Google Maps-Daten. Wenn die Wohnung in Google Maps als ganzes Gebäude klassifiziert ist, wird das Dach einer bestimmten Wohnung dieses Gebäudes separat angezeigt.
Warum gibt die API manchmal keine Daten für ein Gebäude zurück, das ich kenne?
- Das kann passieren, wenn es neuere Gebäude gibt, die zum Zeitpunkt der Kartierung noch nicht existierten.
Wie kann ich die Solardaten-Ebene für den Fluss verwenden, um Schatten zu visualisieren?
- Bei nach Norden ausgerichteten Dächern ist der Fluss (Solareinstrahlung) geringer, was bedeutet, dass sie stärker beschattet sind. Sie können diese Informationen für die Durchführung von Solaranalysen nutzen. Mit der Flux-Datenebene können Sie den Flux in Farben visualisieren.
- Alternativ können Sie eigene Flusskacheln erstellen und deren Farben anpassen, insbesondere wenn Sie bestimmte numerische Werte von Schatten auf einem Dach lokalisieren möchten.
Wie kann ich hourlyShadeUrls
aus dem dataLayers-Dienst verwenden?
- Sie können einen täglichen Snapshot des Schattens im Jahresverlauf abrufen und ein animiertes GIF oder Video erstellen, das zeigt, wie sich der Schatten im Laufe eines Jahres verändert.
- Ja, Sie können die Solardatenebenen für Fluss und DSM (Höhenkarte an jedem Punkt) verwenden, um die Anpassungsmöglichkeiten zu erweitern.
Warum gibt die API eine URL zurück und was kann ich damit tun?
- Die URLs sind kurzlebige Verweise, mit denen Sie die entsprechenden Datenschichten herunterladen können.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-17 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-17 (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,["**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\nHow do I migrate to the new Solar API from the previous version?\n\n- Review our [migration guide](/maps/documentation/solar/migration).\n\nWhere can I get help?\n\n- Check out [Support Options for Solar API](/maps/documentation/solar/support).\n\nWhat 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\nWhat permissions do I need on my Cloud project?\n\n- See [the documentation](https://developers.google.com/maps/roles).\n\nCan 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\nHow 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\nHow 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\nWhere 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\nAre 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\nCan the API see inside of buildings?\n\n- No, just the roofs.\n\nCan 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\nWhy 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\nHow 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\nHow 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\nCan 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\nWhy 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."]]