Stay organized with collections
Save and categorize content based on your preferences.
European Economic Area (EEA) developers
The Solar API computes how much sunlight hits your roof in a year. It
takes into account:
Google's database of imagery and maps
3D modeling of a given roof
Shadows cast by nearby structures and trees
The sun's position over the course of a year
Historical cloud and temperature patterns that might affect solar energy
production
The Solar API estimates values for the percent of electricity exported to
the grid using data from the National Renewable Energy Laboratory
(NREL). The estimates are based on the
relationship between the total solar electricity production and the total amount
of electricity consumed by the household. The larger the solar installation is
relative to the household electricity consumption, the higher the estimate of
solar electricity exported to the grid.
The Solar API also calculates potential savings in utility costs as a
result of installing rooftop solar. Actual savings can vary from projected
savings for a variety of reasons:
Fast-growing trees can shade solar installations, reducing production over
time.
Utilities can change how much they charge their customers for electricity,
affecting savings from solar.
Policies that are beneficial to solar installations may change (for example,
net metering).
For states without net metering, savings may also vary by the amount of
solar electricity consumed in the household compared to the amount exported
to the grid.
Data sources
Building insights
To calculate solar energy production and projected savings, the Solar API
uses the following data sources:
Imagery, 3D modeling, and shade calculations using Google's machine learning
algorithms.
Weather data from NREL and Meteonorm. Sometimes sharp transitions between
nearby stations are reflected in the map.
Solar energy production estimates depend on many factors, such as shading,
typical weather in a given area and equipment used. Additionally,
Solar API mapping data may be from a different period in time than other
estimates, and thus may not show recent growth or removal of trees.
Data layers
GeoTIFFs returned by the dataLayers
endpoint are generated using weather data, satellite imagery, and aerial imagery
from a variety of sources. Data layers GeoTIFFs are orthorectified to remove
perspective distortions. For more information about available layers, see About
GeoTIFF files.
Solar potential estimates
Technical potential includes electricity generated by the rooftop area suitable
for solar panels, assuming supply chain disruptions and grid integration are not
constraints.
There are many definitions of technical potential; other definitions may affect
results by 25% or more. Based on the Solar API's definition of
technical potential, installations meet the following criteria:
Sunlight: Every included panel receives at least 75% of the maximum
annual sun in the county.
Installation size: Every included roof has a total potential
installation size of at least 1.6 kW.
Space and obstacles: Any segment that has at least 4 square meters of
space is considered.
The Solar API's model makes the following assumptions:
Each panel is assumed to be 400 W with an efficiency of 20.4%, a DC
to AC derate factor of 85%, and industry-standard assumptions about
other factors.
Panels are assumed to be mounted flush with the roof, including on flat
surfaces.
Arrays are between 2 kW and 1000 kW. Only arrays on buildings are
considered, not other spaces such as parking lots or fields.
Because we are continuously improving the model, estimates are subject to
change.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThe Solar API calculates the annual sunlight exposure on a rooftop using Google's imagery, 3D modeling, and historical weather patterns.\u003c/p\u003e\n"],["\u003cp\u003eIt estimates potential savings on utility costs and the percentage of electricity exported to the grid based on solar energy production and household consumption.\u003c/p\u003e\n"],["\u003cp\u003eActual savings can differ from projections due to factors like tree growth, utility rate changes, and policy adjustments.\u003c/p\u003e\n"],["\u003cp\u003eSolar energy production estimates are influenced by shading, weather conditions, and equipment specifics, relying on diverse data sources like Google, NREL, and Meteonorm.\u003c/p\u003e\n"],["\u003cp\u003eThe Solar API's technical potential calculations consider sunlight exposure, installation size, and space availability with specific criteria and assumptions for panel efficiency and placement.\u003c/p\u003e\n"]]],["The Solar API estimates yearly rooftop sunlight exposure using Google's imagery, 3D modeling, shadows, sun position, and weather patterns. It predicts electricity exported to the grid based on solar production versus household consumption, using NREL data. Potential utility cost savings are calculated, but they are subject to variables such as tree growth, utility rate changes, and policy shifts. The API uses data from diverse sources including NREL, Meteonorm, Clean Power Research, EnergySage, and government agencies. It factors in sunlight, installation size, space, and panel specifications to determine technical potential, which is subject to change.\n"],null,["# Methodology\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\nThe Solar API computes how much sunlight hits your roof in a year. It\ntakes into account:\n\n- Google's database of imagery and maps\n- 3D modeling of a given roof\n- Shadows cast by nearby structures and trees\n- The sun's position over the course of a year\n- Historical cloud and temperature patterns that might affect solar energy production\n\nThe Solar API estimates values for the percent of electricity exported to\nthe grid using data from the [National Renewable Energy Laboratory\n(NREL)](https://www.nrel.gov/solar/). The estimates are based on the\nrelationship between the total solar electricity production and the total amount\nof electricity consumed by the household. The larger the solar installation is\nrelative to the household electricity consumption, the higher the estimate of\nsolar electricity exported to the grid.\n\nThe Solar API also calculates potential savings in utility costs as a\nresult of installing rooftop solar. Actual savings can vary from projected\nsavings for a variety of reasons:\n\n- Fast-growing trees can shade solar installations, reducing production over time.\n- Utilities can change how much they charge their customers for electricity, affecting savings from solar.\n- Policies that are beneficial to solar installations may change (for example, net metering).\n- For states without net metering, savings may also vary by the amount of solar electricity consumed in the household compared to the amount exported to the grid.\n\nData sources\n------------\n\n### Building insights\n\nTo calculate solar energy production and projected savings, the Solar API\nuses the following data sources:\n\n- Imagery, 3D modeling, and shade calculations using Google's machine learning\n algorithms.\n\n | **Note:** Translating imagery into 3D models is not always precisely accurate, and the imagery can sometimes be out of date.\n- Weather data from NREL and Meteonorm. Sometimes sharp transitions between\n nearby stations are reflected in the map.\n\n- Utility electricity rates information from [Clean Power\n Research](http://www.cleanpower.com/products/powerbill/).\n\n- Aggregated and anonymized solar pricing data from EnergySage and OpenSolar.\n\n- Solar incentives data from the following:\n\n - [Clean Power Research](http://www.cleanpower.com/products/powerbill/)\n - Relevant federal, state and local authorities\n - Relevant utility data\n- Solar Renewable Energy Credit (SREC) data from [Bloomberg New Energy\n Finance](http://about.bnef.com/), [SRECTrade](http://srectrade.com/), and\n relevant state authorities.\n\nSolar energy production estimates depend on many factors, such as shading,\ntypical weather in a given area and equipment used. Additionally,\nSolar API mapping data may be from a different period in time than other\nestimates, and thus may not show recent growth or removal of trees.\n\n### Data layers\n\nGeoTIFFs returned by the [dataLayers](/maps/documentation/solar/data-layers)\nendpoint are generated using weather data, satellite imagery, and aerial imagery\nfrom a variety of sources. Data layers GeoTIFFs are orthorectified to remove\nperspective distortions. For more information about available layers, see [About\nGeoTIFF files](/maps/documentation/solar/geotiff).\n\nSolar potential estimates\n-------------------------\n\nTechnical potential includes electricity generated by the rooftop area suitable\nfor solar panels, assuming supply chain disruptions and grid integration are not\nconstraints.\n\nThere are many definitions of technical potential; other definitions may affect\nresults by 25% or more. Based on the Solar API's definition of\ntechnical potential, installations meet the following criteria:\n\n- **Sunlight:** Every included panel receives at least 75% of the maximum annual sun in the county.\n- **Installation size:** Every included roof has a total potential installation size of at least 1.6 kW.\n- **Space and obstacles:** Any segment that has at least 4 square meters of space is considered.\n\nThe Solar API's model makes the following assumptions:\n\n- Each panel is assumed to be 400 W with an efficiency of 20.4%, a DC to AC derate factor of 85%, and industry-standard assumptions about other factors.\n- Panels are assumed to be mounted flush with the roof, including on flat surfaces.\n- Arrays are between 2 kW and 1000 kW. Only arrays on buildings are considered, not other spaces such as parking lots or fields.\n\nBecause we are continuously improving the model, estimates are subject to\nchange."]]