Pertanyaan Umum (FAQ)
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Developer Wilayah Ekonomi Eropa (EEA)
Bantuan
Bagaimana cara bermigrasi ke Solar API baru dari versi sebelumnya?
Di manakah saya dapat memperoleh bantuan?
Apa arti kode error ini?
Konfigurasi Project
Izin apa yang saya perlukan di project Cloud saya?
Dapatkah saya menggunakan kunci API dengan lebih dari satu project Cloud?
- Tidak, gunakan kunci API Anda hanya untuk satu project Cloud. Jika Anda memiliki lebih banyak project Cloud, setiap project harus memiliki kunci API-nya sendiri. Perhatikan bahwa dalam satu project, Anda dapat memiliki beberapa kunci API.
Biaya
Bagaimana cara membatasi biaya?
Model surya
Seberapa sering data diperbarui?
- Data baru ditambahkan setiap saat, tetapi kami tidak memiliki kecepatan refresh tertentu untuk wilayah tertentu. Beberapa wilayah menggunakan citra yang sudah berusia beberapa tahun.
Periksa tanggal gambar yang relevan, dan jangan ragu untuk mengirimkan
masukan.
Di mana saya dapat mempelajari lebih lanjut asumsi untuk analisis keuangan energi surya?
- Google menggunakan informasi tentang insentif panel surya pemerintah, beserta data dan model keuangan lainnya, dari Clean Power Research.
Apakah cerobong asap dan jendela atap dipertimbangkan oleh API saat membuat penilaian penempatan panel surya?
- Ya, dengan peta ketinggian, cerobong asap dan jendela atap diidentifikasi sebagai persegi panjang kecil, dan panel surya dikecualikan oleh model.
Dapatkah API melihat ke dalam bangunan?
Dapatkah API membuat penilaian untuk apartemen tertentu dalam kompleks bangunan?
- Tergantung. Model ini menggunakan data Google Maps, sehingga jika apartemen diklasifikasikan sebagai seluruh bangunan di Google Maps, maka atap apartemen tertentu di bangunan tersebut akan ditampilkan secara terpisah.
Mengapa API terkadang tidak menampilkan data apa pun untuk bangunan yang saya ketahui ada?
- Hal ini dapat terjadi jika ada bangunan baru yang tidak ada saat pemetaan dilakukan.
Bagaimana cara menggunakan lapisan data surya fluks untuk memvisualisasikan naungan?
- Atap yang menghadap utara mendapatkan lebih sedikit fluks (iradiasi matahari), yang berarti atap tersebut akan memiliki naungan yang lebih tinggi. Anda dapat memanfaatkan informasi ini saat melakukan penilaian surya. Lapisan data fluks memungkinkan Anda memvisualisasikan fluks dalam warna.
- Anda juga dapat membuat ubin fluks sendiri dan menyesuaikan warnanya, terutama jika Anda ingin menemukan nilai numerik tertentu dari warna pada atap.
Bagaimana cara menggunakan hourlyShadeUrls dari layanan dataLayers?
- Anda bisa mendapatkan kembali ringkasan harian naungan sepanjang tahun, dan membuat GIF atau video animasi perubahan naungan selama setahun.
- Ya, Anda dapat menggunakan lapisan data surya fluks dan DSM (peta ketinggian di setiap titik) untuk penyesuaian yang lebih besar.
Mengapa API menampilkan URL, dan apa yang dapat saya lakukan dengan URL tersebut?
- URL adalah pointer berumur pendek yang memungkinkan Anda mendownload
lapisan data yang sesuai.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-27 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
