Types for Google Maps Solar v1 API¶
- class google.maps.solar_v1.types.BuildingInsights(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Response message for
Solar.FindClosestBuildingInsights
. Information about the location, dimensions, and solar potential of a building.- center¶
A point near the center of the building.
- Type
google.type.latlng_pb2.LatLng
- bounding_box¶
The bounding box of the building.
- imagery_date¶
Date that the underlying imagery was acquired. This is approximate.
- Type
google.type.date_pb2.Date
- imagery_processed_date¶
When processing was completed on this imagery.
- Type
google.type.date_pb2.Date
- administrative_area¶
Administrative area 1 (e.g., in the US, the state) that contains this building. For example, in the US, the abbreviation might be “MA” or “CA.”.
- Type
- solar_potential¶
Solar potential of the building.
- imagery_quality¶
The quality of the imagery used to compute the data for this building.
- class google.maps.solar_v1.types.CashPurchaseSavings(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Cost and benefit of an outright purchase of a particular configuration of solar panels with a particular electricity usage.
- out_of_pocket_cost¶
Initial cost before tax incentives: the amount that must be paid out-of-pocket. Contrast with
upfront_cost
, which is after tax incentives.- Type
google.type.money_pb2.Money
- upfront_cost¶
Initial cost after tax incentives: it’s the amount that must be paid during first year. Contrast with
out_of_pocket_cost
, which is before tax incentives.- Type
google.type.money_pb2.Money
- rebate_value¶
The value of all tax rebates.
- Type
google.type.money_pb2.Money
- payback_years¶
Number of years until payback occurs. A negative value means payback never occurs within the lifetime period.
This field is a member of oneof
_payback_years
.- Type
- savings¶
How much is saved (or not) over the lifetime period.
- class google.maps.solar_v1.types.DataLayerView(value)[source]¶
Bases:
proto.enums.Enum
What subset of the solar information to return.
- Values:
- DATA_LAYER_VIEW_UNSPECIFIED (0):
Equivalent to FULL.
- DSM_LAYER (1):
Get the DSM only.
- IMAGERY_LAYERS (2):
Get the DSM, RGB, and mask.
- IMAGERY_AND_ANNUAL_FLUX_LAYERS (3):
Get the DSM, RGB, mask, and annual flux.
- IMAGERY_AND_ALL_FLUX_LAYERS (4):
Get the DSM, RGB, mask, annual flux, and monthly flux.
- FULL_LAYERS (5):
Get all data.
- class google.maps.solar_v1.types.DataLayers(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Information about the solar potential of a region. The actual data are contained in a number of GeoTIFF files covering the requested region, for which this message contains URLs: Each string in the
DataLayers
message contains a URL from which the corresponding GeoTIFF can be fetched. These URLs are valid for a few hours after they’ve been generated. Most of the GeoTIFF files are at a resolution of 0.1m/pixel, but the monthly flux file is at 0.5m/pixel, and the hourly shade files are at 1m/pixel. If apixel_size_meters
value was specified in theGetDataLayersRequest
, then the minimum resolution in the GeoTIFF files will be that value.- imagery_date¶
When the source imagery (from which all the other data are derived) in this region was taken. It is necessarily somewhat approximate, as the images may have been taken over more than one day.
- Type
google.type.date_pb2.Date
- imagery_processed_date¶
When processing was completed on this imagery.
- Type
google.type.date_pb2.Date
- dsm_url¶
The URL for an image of the DSM (Digital Surface Model) of the region. Values are in meters above EGM96 geoid (i.e., sea level). Invalid locations (where we don’t have data) are stored as -9999.
- Type
- mask_url¶
The URL for the building mask image: one bit per pixel saying whether that pixel is considered to be part of a rooftop or not.
- Type
- annual_flux_url¶
The URL for the annual flux map (annual sunlight on roofs) of the region. Values are kWh/kW/year. This is unmasked flux: flux is computed for every location, not just building rooftops. Invalid locations are stored as -9999: locations outside our coverage area will be invalid, and a few locations inside the coverage area, where we were unable to calculate flux, will also be invalid.
- Type
- monthly_flux_url¶
The URL for the monthly flux map (sunlight on roofs, broken down by month) of the region. Values are kWh/kW/year. The GeoTIFF pointed to by this URL will contain twelve bands, corresponding to January…December, in order.
- Type
- hourly_shade_urls¶
Twelve URLs for hourly shade, corresponding to January…December, in order. Each GeoTIFF will contain 24 bands, corresponding to the 24 hours of the day. Each pixel is a 32 bit integer, corresponding to the (up to) 31 days of that month; a 1 bit means that the corresponding location is able to see the sun at that day, of that hour, of that month. Invalid locations are stored as -9999 (since this is negative, it has bit 31 set, and no valid value could have bit 31 set as that would correspond to the 32nd day of the month).
An example may be useful. If you want to know whether a point (at pixel location (x, y)) saw sun at 4pm on the 22nd of June you would:
fetch the sixth URL in this list (corresponding to June).
look up the 17th channel (corresponding to 4pm).
read the 32-bit value at (x, y).
read bit 21 of the value (corresponding to the 22nd of the month).
if that bit is a 1, then that spot saw the sun at 4pm 22 June.
More formally: Given
month
(1-12),day
(1…month max; February has 28 days) andhour
(0-23), the shade/sun for that month/day/hour at a position(x, y)
is the bit(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))
where
(x, y)
is spatial indexing,[month - 1]
refers to fetching themonth - 1
st URL (indexing from zero),[hour]
is indexing into the channels, and a final non-zero result means “sunny”. There are no leap days, and DST doesn’t exist (all days are 24 hours long; noon is always “standard time” noon).- Type
MutableSequence[str]
- imagery_quality¶
The quality of the result’s imagery.
- class google.maps.solar_v1.types.FinancedPurchaseSavings(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Cost and benefit of using a loan to buy a particular configuration of solar panels with a particular electricity usage.
- annual_loan_payment¶
Annual loan payments.
- Type
google.type.money_pb2.Money
- rebate_value¶
The value of all tax rebates (including Federal Investment Tax Credit (ITC)).
- Type
google.type.money_pb2.Money
- savings¶
How much is saved (or not) over the lifetime period.
- class google.maps.solar_v1.types.FinancialAnalysis(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Analysis of the cost and benefits of the optimum solar layout for a particular electric bill size.
- monthly_bill¶
The monthly electric bill this analysis assumes.
- Type
google.type.money_pb2.Money
- default_bill¶
Whether this is the bill size selected to be the default bill for the area this building is in. Exactly one
FinancialAnalysis
inBuildingSolarPotential
should havedefault_bill
set.- Type
- average_kwh_per_month¶
How much electricity the house uses in an average month, based on the bill size and the local electricity rates.
- Type
- panel_config_index¶
Index in [solar_panel_configs] [google.maps.solar.v1.SolarPotential.solar_panel_configs] of the optimum solar layout for this bill size. This can be -1 indicating that there is no layout. In this case, the remaining submessages will be omitted.
This field is a member of oneof
_panel_config_index
.- Type
- financial_details¶
Financial information that applies regardless of the financing method used.
- leasing_savings¶
Cost and benefit of leasing the solar panels.
- cash_purchase_savings¶
Cost and benefit of buying the solar panels with cash.
- financed_purchase_savings¶
Cost and benefit of buying the solar panels by financing the purchase.
- class google.maps.solar_v1.types.FinancialDetails(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Details of a financial analysis. Some of these details are already stored at higher levels (e.g., out of pocket cost). Total money amounts are over a lifetime period defined by the [panel_lifetime_years] [google.maps.solar.v1.SolarPotential.panel_lifetime_years] field in [SolarPotential] [google.maps.solar.v1.SolarPotential]. Note: The out of pocket cost of purchasing the panels is given in the [out_of_pocket_cost] [google.maps.solar.v1.CashPurchaseSavings.out_of_pocket_cost] field in [CashPurchaseSavings] [google.maps.solar.v1.CashPurchaseSavings].
- initial_ac_kwh_per_year¶
How many AC kWh we think the solar panels will generate in their first year.
- Type
- remaining_lifetime_utility_bill¶
Utility bill for electricity not produced by solar, for the lifetime of the panels.
- Type
google.type.money_pb2.Money
- federal_incentive¶
Amount of money available from federal incentives; this applies if the user buys (with or without a loan) the panels.
- Type
google.type.money_pb2.Money
- state_incentive¶
Amount of money available from state incentives; this applies if the user buys (with or without a loan) the panels.
- Type
google.type.money_pb2.Money
- utility_incentive¶
Amount of money available from utility incentives; this applies if the user buys (with or without a loan) the panels.
- Type
google.type.money_pb2.Money
- lifetime_srec_total¶
Amount of money the user will receive from Solar Renewable Energy Credits over the panel lifetime; this applies if the user buys (with or without a loan) the panels.
- Type
google.type.money_pb2.Money
- cost_of_electricity_without_solar¶
Total cost of electricity the user would have paid over the lifetime period if they didn’t install solar.
- Type
google.type.money_pb2.Money
- class google.maps.solar_v1.types.FindClosestBuildingInsightsRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Request message for
Solar.FindClosestBuildingInsights
.- location¶
Required. The longitude and latitude from which the API looks for the nearest known building.
- Type
google.type.latlng_pb2.LatLng
- required_quality¶
Optional. The minimum quality level allowed in the results. No result with lower quality than this will be returned. Not specifying this is equivalent to restricting to HIGH quality only.
- exact_quality_required¶
Optional. Whether to require exact quality of the imagery. If set to false, the
required_quality
field is interpreted as the minimum required quality, such that HIGH quality imagery may be returned whenrequired_quality
is set to MEDIUM. If set to true,required_quality
is interpreted as the exact required quality and onlyMEDIUM
quality imagery is returned ifrequired_quality
is set toMEDIUM
.- Type
- class google.maps.solar_v1.types.GetDataLayersRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Request message for
Solar.GetDataLayers
.- location¶
Required. The longitude and latitude for the center of the region to get data for.
- Type
google.type.latlng_pb2.LatLng
- radius_meters¶
Required. The radius, in meters, defining the region surrounding that centre point for which data should be returned. The limitations on this value are:
Any value up to 100m can always be specified.
Values over 100m can be specified, as long as
radius_meters
<=pixel_size_meters * 1000
.However, for values over 175m, the
DataLayerView
in the request must not include monthly flux or hourly shade.
- Type
- view¶
Optional. The desired subset of the data to return.
- required_quality¶
Optional. The minimum quality level allowed in the results. No result with lower quality than this will be returned. Not specifying this is equivalent to restricting to HIGH quality only.
- pixel_size_meters¶
Optional. The minimum scale, in meters per pixel, of the data to return. Values of 0.1 (the default, if this field is not set explicitly), 0.25, 0.5, and 1.0 are supported. Imagery components whose normal resolution is less than
pixel_size_meters
will be returned at the resolution specified bypixel_size_meters
; imagery components whose normal resolution is equal to or greater thanpixel_size_meters
will be returned at that normal resolution.- Type
- exact_quality_required¶
Optional. Whether to require exact quality of the imagery. If set to false, the
required_quality
field is interpreted as the minimum required quality, such that HIGH quality imagery may be returned whenrequired_quality
is set to MEDIUM. If set to true,required_quality
is interpreted as the exact required quality and onlyMEDIUM
quality imagery is returned ifrequired_quality
is set toMEDIUM
.- Type
- class google.maps.solar_v1.types.GetGeoTiffRequest(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Request message for
Solar.GetGeoTiff
.
- class google.maps.solar_v1.types.ImageryQuality(value)[source]¶
Bases:
proto.enums.Enum
The quality of the imagery used to compute some API result.
Note: Regardless of imagery quality level, DSM outputs always have a resolution of 0.1 m/pixel, monthly flux outputs always have a resolution of 0.5 m/pixel, and hourly shade outputs always have a resolution of 1 m/pixel.
- Values:
- IMAGERY_QUALITY_UNSPECIFIED (0):
No quality is known.
- HIGH (1):
The underlying imagery and DSM data were processed at 0.1 m/pixel.
- MEDIUM (2):
The underlying imagery and DSM data were processed at 0.25 m/pixel.
- LOW (3):
The underlying imagery and DSM data were processed at 0.5 m/pixel.
- class google.maps.solar_v1.types.LatLngBox(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
A bounding box in lat/lng coordinates.
- sw¶
The southwest corner of the box.
- Type
google.type.latlng_pb2.LatLng
- ne¶
The northeast corner of the box.
- Type
google.type.latlng_pb2.LatLng
- class google.maps.solar_v1.types.LeasingSavings(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Cost and benefit of leasing a particular configuration of solar panels with a particular electricity usage.
- leases_allowed¶
Whether leases are allowed in this juristiction (leases are not allowed in some states). If this field is false, then the values in this message should probably be ignored.
- Type
- leases_supported¶
Whether leases are supported in this juristiction by the financial calculation engine. If this field is false, then the values in this message should probably be ignored. This is independent of
leases_allowed
: in some areas leases are allowed, but under conditions that aren’t handled by the financial models.- Type
- annual_leasing_cost¶
Estimated annual leasing cost.
- Type
google.type.money_pb2.Money
- savings¶
How much is saved (or not) over the lifetime period.
- class google.maps.solar_v1.types.RoofSegmentSizeAndSunshineStats(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Information about the size and sunniness quantiles of a roof segment.
- pitch_degrees¶
Angle of the roof segment relative to the theoretical ground plane. 0 = parallel to the ground, 90 = perpendicular to the ground.
This field is a member of oneof
_pitch_degrees
.- Type
- azimuth_degrees¶
Compass direction the roof segment is pointing in. 0 = North, 90 = East, 180 = South. For a “flat” roof segment (
pitch_degrees
very near 0), azimuth is not well defined, so for consistency, we define it arbitrarily to be 0 (North).This field is a member of oneof
_azimuth_degrees
.- Type
- stats¶
Total size and sunlight quantiles for the roof segment.
- center¶
A point near the center of the roof segment.
- Type
google.type.latlng_pb2.LatLng
- bounding_box¶
The bounding box of the roof segment.
- class google.maps.solar_v1.types.RoofSegmentSummary(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Information about a roof segment on the building, with some number of panels placed on it.
- pitch_degrees¶
Angle of the roof segment relative to the theoretical ground plane. 0 = parallel to the ground, 90 = perpendicular to the ground.
This field is a member of oneof
_pitch_degrees
.- Type
- azimuth_degrees¶
Compass direction the roof segment is pointing in. 0 = North, 90 = East, 180 = South. For a “flat” roof segment (
pitch_degrees
very near 0), azimuth is not well defined, so for consistency, we define it arbitrarily to be 0 (North).This field is a member of oneof
_azimuth_degrees
.- Type
- yearly_energy_dc_kwh¶
How much sunlight energy this part of the layout captures over the course of a year, in DC kWh, assuming the panels described above.
- Type
- class google.maps.solar_v1.types.SavingsOverTime(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Financial information that’s shared between different financing methods.
- savings_year1¶
Savings in the first year after panel installation.
- Type
google.type.money_pb2.Money
- savings_year20¶
Savings in the first twenty years after panel installation.
- Type
google.type.money_pb2.Money
- present_value_of_savings_year20¶
Using the assumed discount rate, what is the present value of the cumulative 20-year savings?
- Type
google.type.money_pb2.Money
- savings_lifetime¶
Savings in the entire panel lifetime.
- Type
google.type.money_pb2.Money
- present_value_of_savings_lifetime¶
Using the assumed discount rate, what is the present value of the cumulative lifetime savings?
- Type
google.type.money_pb2.Money
- class google.maps.solar_v1.types.SizeAndSunshineStats(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Size and sunniness quantiles of a roof, or part of a roof.
- area_meters2¶
The area of the roof or roof segment, in m^2. This is the roof area (accounting for tilt), not the ground footprint area.
- Type
- sunshine_quantiles¶
Quantiles of the pointwise sunniness across the area. If there are N values here, this represents the (N-1)-iles. For example, if there are 5 values, then they would be the quartiles (min, 25%, 50%, 75%, max). Values are in annual kWh/kW like [max_sunshine_hours_per_year] [google.maps.solar.v1.SolarPotential.max_sunshine_hours_per_year].
- Type
MutableSequence[float]
- class google.maps.solar_v1.types.SolarPanel(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
SolarPanel describes the position, orientation, and production of a single solar panel. See the [panel_height_meters] [google.maps.solar.v1.SolarPotential.panel_height_meters], [panel_width_meters] [google.maps.solar.v1.SolarPotential.panel_width_meters], and [panel_capacity_watts] [google.maps.solar.v1.SolarPotential.panel_capacity_watts] fields in [SolarPotential] [google.maps.solar.v1.SolarPotential] for information on the parameters of the panel.
- center¶
The centre of the panel.
- Type
google.type.latlng_pb2.LatLng
- orientation¶
The orientation of the panel.
- yearly_energy_dc_kwh¶
How much sunlight energy this layout captures over the course of a year, in DC kWh.
- Type
- class google.maps.solar_v1.types.SolarPanelConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
SolarPanelConfig describes a particular placement of solar panels on the roof.
- panels_count¶
Total number of panels. Note that this is redundant to (the sum of) the corresponding fields in [roof_segment_summaries] [google.maps.solar.v1.SolarPanelConfig.roof_segment_summaries].
- Type
- yearly_energy_dc_kwh¶
How much sunlight energy this layout captures over the course of a year, in DC kWh, assuming the panels described above.
- Type
- roof_segment_summaries¶
Information about the production of each roof segment that is carrying at least one panel in this layout.
roof_segment_summaries[i]
describes the i-th roof segment, including its size, expected production and orientation.- Type
MutableSequence[google.maps.solar_v1.types.RoofSegmentSummary]
- class google.maps.solar_v1.types.SolarPanelOrientation(value)[source]¶
Bases:
proto.enums.Enum
The orientation of a solar panel. This must be interpreted relative to the azimuth of the roof segment that the panel is placed on.
- Values:
- SOLAR_PANEL_ORIENTATION_UNSPECIFIED (0):
No panel orientation is known.
- LANDSCAPE (1):
A
LANDSCAPE
panel has its long edge perpendicular to the azimuth direction of the roof segment that it is placed on.- PORTRAIT (2):
A
PORTRAIT
panel has its long edge parallel to the azimuth direction of the roof segment that it is placed on.
- class google.maps.solar_v1.types.SolarPotential(mapping=None, *, ignore_unknown_fields=False, **kwargs)[source]¶
Bases:
proto.message.Message
Information about the solar potential of a building. A number of fields in this are defined in terms of “panels”. The fields [panel_capacity_watts] [google.maps.solar.v1.SolarPotential.panel_capacity_watts], [panel_height_meters] [google.maps.solar.v1.SolarPotential.panel_height_meters], and [panel_width_meters] [google.maps.solar.v1.SolarPotential.panel_width_meters] describe the parameters of the model of panel used in these calculations.
- max_array_panels_count¶
Size of the maximum array - that is, the maximum number of panels that can fit on the roof.
- Type
- panel_height_meters¶
Height, in meters in portrait orientation, of the panel used in the calculations.
- Type
- panel_width_meters¶
Width, in meters in portrait orientation, of the panel used in the calculations.
- Type
- panel_lifetime_years¶
The expected lifetime, in years, of the solar panels. This is used in the financial calculations.
- Type
- max_sunshine_hours_per_year¶
Maximum number of sunshine hours received per year, by any point on the roof. Sunshine hours are a measure of the total amount of insolation (energy) received per year. 1 sunshine hour = 1 kWh per kW (where kW refers to kW of capacity under Standard Testing Conditions).
- Type
- carbon_offset_factor_kg_per_mwh¶
Equivalent amount of CO2 produced per MWh of grid electricity. This is a measure of the carbon intensity of grid electricity displaced by solar electricity.
- Type
- whole_roof_stats¶
Total size and sunlight quantiles for the part of the roof that was assigned to some roof segment. Despite the name, this may not include the entire building. See [building_stats] [google.maps.solar.v1.SolarPotential.building_stats].
- building_stats¶
Size and sunlight quantiles for the entire building, including parts of the roof that were not assigned to some roof segment. Because the orientations of these parts are not well characterised, the roof area estimate is unreliable, but the ground area estimate is reliable. It may be that a more reliable whole building roof area can be obtained by scaling the roof area from [whole_roof_stats] [google.maps.solar.v1.SolarPotential.whole_roof_stats] by the ratio of the ground areas of
building_stats
andwhole_roof_stats
.
- roof_segment_stats¶
Size and sunlight quantiles for each roof segment.
- Type
MutableSequence[google.maps.solar_v1.types.RoofSegmentSizeAndSunshineStats]
- solar_panels¶
Each [SolarPanel] [google.maps.solar.v1.SolarPanel] describes a single solar panel. They are listed in the order that the panel layout algorithm placed this. This is usually, though not always, in decreasing order of annual energy production.
- Type
MutableSequence[google.maps.solar_v1.types.SolarPanel]
- solar_panel_configs¶
Each [SolarPanelConfig] [google.maps.solar.v1.SolarPanelConfig] describes a different arrangement of solar panels on the roof. They are in order of increasing number of panels. The
SolarPanelConfig
with [panels_count] [google.maps.solar.v1.SolarPanelConfig.panels_count]=N is based on the first N panels in thesolar_panels
list. This field is only populated if at least 4 panels can fit on a roof.- Type
MutableSequence[google.maps.solar_v1.types.SolarPanelConfig]
- financial_analyses¶
A [FinancialAnalysis] [google.maps.solar.v1.FinancialAnalysis] gives the savings from going solar assuming a given monthly bill and a given electricity provider. They are in order of increasing order of monthly bill amount. This field will be empty for buildings in areas for which the Solar API does not have enough information to perform financial computations.
- Type
MutableSequence[google.maps.solar_v1.types.FinancialAnalysis]