Domande frequenti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sviluppatori dello Spazio economico europeo (SEE)
Guida
Come faccio a eseguire la migrazione alla nuova API Solar dalla versione precedente?
Dove posso ricevere assistenza?
Che cosa significano questi codici di errore?
Configurazione progetto
Quali autorizzazioni mi servono per il mio progetto cloud?
Posso utilizzare la mia chiave API con più di un progetto Cloud?
- No, utilizza la chiave API solo per un progetto Cloud. Se hai più progetti
Cloud, ognuno deve avere la propria chiave API. Tieni presente che all'interno di un singolo progetto è normale avere più chiavi API.
Costo
Come faccio a limitare i costi?
Modello solare
Con quale frequenza vengono aggiornati i dati?
- Vengono aggiunti continuamente nuovi dati, ma non abbiamo una frequenza di aggiornamento specifica
per regioni specifiche. Alcune regioni utilizzano immagini di diversi anni fa.
Controlla le date delle immagini pertinenti e non esitare a inviare
un feedback.
Dove posso trovare ulteriori informazioni sulle ipotesi per l'analisi finanziaria dell'impianto solare?
- Google utilizza informazioni sugli incentivi governativi per l'energia solare, insieme
ad altri dati e modelli finanziari, di Clean Power
Research.
La API tiene conto di camini e lucernari quando valuta il posizionamento dei pannelli solari?
- Sì, con le mappe di altezza, i comignoli e i lucernari vengono identificati come piccoli
rettangoli e i pannelli solari vengono esclusi dal modello.
L'API può vedere all'interno degli edifici?
L'API può eseguire valutazioni per un appartamento specifico all'interno di un complesso di edifici?
- Dipende. Il modello utilizza i dati di Google Maps, quindi se l'appartamento è
classificato come un intero edificio in Google Maps, il tetto di un
appartamento specifico dell'edificio viene visualizzato separatamente.
Perché a volte l'API non restituisce dati per un edificio che so che esiste?
- Ciò può accadere quando ci sono edifici più recenti che non esistevano quando
è stata realizzata la mappatura.
Come posso utilizzare il livello di dati solari di flusso per visualizzare l'ombra?
- I tetti rivolti a nord ricevono meno flusso (irraggiamento
solare), il che significa
che avranno più ombra. Puoi utilizzare queste informazioni quando
esegui valutazioni solari. Il livello di dati del flusso consente di visualizzare
il flusso a colori.
- In alternativa, puoi creare le tue tessere di flusso e personalizzarne i colori,
soprattutto se vuoi individuare valori numerici specifici di ombra su un
tetto.
Come posso utilizzare hourlyShadeUrls dal servizio dataLayers?
- Puoi recuperare un'istantanea giornaliera dell'ombra durante l'anno e produrre
una GIF animata o un video dell'ombra che cambia durante l'anno.
- Sì, puoi utilizzare i livelli di dati solari relativi al flusso e al DSM (mappa dell'altezza in ogni punto)
per una maggiore personalizzazione.
Perché l'API restituisce un URL e cosa posso farci?
- Gli URL sono puntatori di breve durata che consentono di scaricare i
livelli di dati corrispondenti.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-27 UTC.
[null,null,["Ultimo aggiornamento 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."]]
