Subscribe
to these release notes.
See the Getting Started documentation for information on how to get started using the Solar API.
April 29, 2024
Exact Quality Parameter
Users can now specify the exact quality of data layers they would like returned. dataLayers.get has a new parameter called exactQualityRequired
. When it is set to true
, the quality indicated by the requiredQuality
field will be returned if available. Otherwise, exactQualityRequired
is set to false
by default. In this case, the endpoints will behave normally and return the highest quality available data.
Utility Incentives and Utility Electricity Rates Update
United States utility incentive data and utility electricity rates have been updated using data from Clean Power Research. You can access the new utility incentive amounts for each building in the UtilityIncentive
field of the buildingInsights.findClosest response. The utility electricity rates are not surfaced in the API but are used in calculations for the following fields of the buildingInsights.findClosest response:
leasingSavings
cashPurchaseSavings
financedPurchaseSavings
costOfElectricityWithoutSolar
remainingLifetimeUtilityBill
solarPercentage
percentageExportedToGrid
Panel Dimensions and Capacity Update
Panel dimensions and capacity have been updated to match industry standards. The following changes are:
- Panel height (meters): 1.65 → 1.879
- Panel width (meters): 0.992 → 1.045
- Panel capacity (watts): 250 → 400
We recommend that you continue to get these values from the panelCapacityWatts
, panelHeightMeters
, and panelWidthMeters
fields of the buildingInsights.findClosest response.
March 21, 2024
Expanded Solar API coverage
Medium-quality data coverage (requests made with requiredQuality=MEDIUM
and corresponding responses with imagery_quality: 'MEDIUM'
) has been expanded to cover new areas in the following regions: Hawaii, Germany, France, Spain, Italy, Puerto Rico, The Bahamas, Antigua and Barbados.
For more details, see the Solar API coverage map.
January 16, 2024
Expanded Solar API coverage
Medium-quality data coverage (requests made with requiredQuality=MEDIUM
and corresponding responses with imagery_quality: 'MEDIUM'
) has been expanded to cover new areas in the following countries: Australia, Belgium, Czechia, Denmark, Greece, Finland, Ireland, Norway, Portugal, Sweden, New Zealand.
For more details, see the Solar API coverage map.
December 13, 2023
Expanded Solar API coverage
Medium-quality data coverage (requests made with requiredQuality=MEDIUM
and corresponding responses with imagery_quality: 'MEDIUM'
) has been expanded to cover new areas in the following 21 states in the US: AK, AL, CO, DE, IA, KS, ME, MN, MO, MT, ND, NE, NM, OR, RI, SD, UT, VT, WI, WA, and WY.
For more details, see the Solar API coverage map.
November 13, 2023
Expanded Solar API coverage
Medium-quality data coverage (requests made with requiredQuality=MEDIUM and corresponding responses with imagery_quality: 'MEDIUM') has been expanded to cover new areas in the following regions:
- United States: AR, AZ, CT, DC, GA, ID, IN, KY, LA, MD, MI, MS, NC, NH, NJ, NY, NV, OH, OK, PA, SC, TN, VA, WV
- Canada
- Poland
- Austria
- Switzerland
For more details, see the Solar API coverage map.
October 24, 2023
Expanded Solar API coverage
Medium-quality data coverage (requests made with requiredQuality=MEDIUM
and corresponding responses with imagery_quality: 'MEDIUM'
) now includes most of California, Texas, Massachusetts, and Illinois. For more information, see the Solar API coverage map.
August 08, 2023
Solar API
Announcing the General Availability (GA) release of the Solar API. See the Release Notes for information about this release and for all other releases.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
2023-06-29
In July of 2023, Google will release a change to the format of URLs returned in the response to a call to a Data Layers request. To prepare for this release, write your apps to support both URL formats. By preparing for the new URL format now, your apps will not be affected by this update.
For more information, see Data Layers request.
2023-05-09
- Launched a restricted preview of the new Solar API, hosted as part of
Google Maps Platform on Google Cloud. This new API will replace the
now-deprecated EarthEngineSolar API, and, to minimize disruption, we
encourage you to migrate as soon as feasible.
- Revamped project-level access
- To get access, please reach out to your contact on the Solar API team.
- Access is manually granted on a per-project basis, and is independent from access to the EarthEngineSolar API.
- Added new documentation
- Set new terms of service
- Integrated with Cloud Monitoring
and Cloud Billing
- Calls to Solar API endpoints will begin appearing on projects' Billing Dashboard (with a 100% discount during the Preview).
- Renamed endpoints and methods
earthenginesolar.googleapis.com
->solar.googleapis.com
solarInfo:get
->dataLayers:get
buildings:findClosest
->buildingInsights:findClosest
- Configured new quota limits
- Replaced per-day and per-quarter request quotas with per-minute
quotas.
- Quota limits are set at the project level and begin at 60 queries per minute for each endpoint.
- Find a project's quota at https://console.cloud.google.com/google/maps-apis/quotas
- Replaced per-day and per-quarter request quotas with per-minute
quotas.
- Revamped project-level access
- Deprecated the existing EarthEngineSolar API.
- The deprecated EarthEngineSolar API will continue to work while the new Solar API is in Preview.
- Expanded medium-quality (
imagery_quality: 'MEDIUM'
) data coverage- Expanded medium-quality data availability for Germany, the UK, France, Spain, Italy, and Florida.
- Expanded medium-quality financial data availability (via
BuildingInsights
) for a significantly larger portion of Florida.
2022-02-28
- Added different quality levels of data.
- Added quality level to returned data.
- Added ability to specify the required quality level.
2020-09-08
- Added dataset specifier for early access to non-production data.
- Added specification of panel parameters (width, height, name, place, capacity, lifetime).
- Added height of roof segments.
- Added information about building ground footprints.
- Added information about unsegmented roof size.
- Added panel-by-panel production values.
2019-06-21
- Added bounding boxes to building and roof segment structures.
- Added segment index to roof segment summaries, to unambiguously link each summary to more detailed information.
- Added documentation for new raster endpoint which will allow access to imagery and detailed solar potential information.
2018-07-20
Initial release.