Index
Solar
(interface)BuildingInsights
(message)CashPurchaseSavings
(message)DataLayerView
(enum)DataLayers
(message)FinancedPurchaseSavings
(message)FinancialAnalysis
(message)FinancialDetails
(message)FindClosestBuildingInsightsRequest
(message)GetDataLayersRequest
(message)GetGeoTiffRequest
(message)ImageryQuality
(enum)LatLngBox
(message)LeasingSavings
(message)RoofSegmentSizeAndSunshineStats
(message)RoofSegmentSummary
(message)SavingsOverTime
(message)SizeAndSunshineStats
(message)SolarPanel
(message)SolarPanelConfig
(message)SolarPanelOrientation
(enum)SolarPotential
(message)
Solaire
Définition de service pour l'API Solar.
FindClosestBuildingInsights |
---|
Permet de localiser le bâtiment dont le centroïde est le plus proche d'un point de requête. Renvoie une erreur avec le code
|
GetDataLayers |
---|
Récupère des informations sur l'ensoleillement pour une région entourant un emplacement. Renvoie une erreur avec le code
|
GetGeoTiff |
---|
Renvoie une image par son ID.
|
BuildingInsights
Message de réponse pour Solar.FindClosestBuildingInsights
. Informations sur l'emplacement, les dimensions et le potentiel solaire d'un bâtiment.
Champs | |
---|---|
name |
Nom de la ressource du bâtiment, au format |
center |
Un point près du centre du bâtiment. |
bounding_box |
Cadre de délimitation du bâtiment. |
imagery_date |
Date à laquelle les images sous-jacentes ont été acquises. Il s'agit d'une estimation approximative. |
imagery_processed_date |
Date à laquelle le traitement de ces images a été terminé. |
postal_code |
Code postal (par exemple, (code postal américain) dans lequel se trouve ce bâtiment. |
administrative_area |
Zone administrative 1 (par exemple, l'État aux États-Unis) qui contient cet immeuble. Par exemple, aux États-Unis, l'abréviation peut être "MA" ou "CA". |
statistical_area |
Zone statistique (par exemple, (zone de recensement aux États-Unis) dans laquelle se trouve ce bâtiment. |
region_code |
Code de région du pays (ou de la région) dans lequel se trouve ce bâtiment. |
solar_potential |
Potentiel solaire du bâtiment. |
imagery_quality |
Qualité des images utilisées pour calculer les données de ce bâtiment. |
CashPurchaseSavings
Coût et avantages d'un achat direct d'une configuration particulière de panneaux solaires pour une consommation d'électricité donnée.
Champs | |
---|---|
out_of_pocket_cost |
Coût initial avant les avantages fiscaux: montant que vous devez payer de votre poche. À comparer à |
upfront_cost |
Coût initial après réductions fiscales: montant qui doit être payé au cours de la première année. À comparer à |
rebate_value |
Valeur de toutes les remises fiscales. |
savings |
Economies réalisées (ou non) sur la durée de vie. |
payback_years |
Nombre d'années avant le retour sur investissement. Une valeur négative signifie que le retour sur investissement n'est jamais atteint au cours de la durée de vie. |
DataLayerView
Sous-ensemble des informations solaires à renvoyer.
Enums | |
---|---|
DATA_LAYER_VIEW_UNSPECIFIED |
Équivaut à "FULL". |
DSM_LAYER |
Obtenez uniquement le DSM. |
IMAGERY_LAYERS |
Obtenez le DSM, le RVB et le masque. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Obtenez le DSM, le RVB, le masque et le flux annuel. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Obtenez le DSM, le RVB, le masque, le flux annuel et le flux mensuel. |
FULL_LAYERS |
Obtenir toutes les données |
DataLayers
Informations sur le potentiel solaire d'une région. Les données réelles sont contenues dans un certain nombre de fichiers GeoTIFF couvrant la région demandée, pour lesquels ce message contient des URL: chaque chaîne du message DataLayers
contient une URL à partir de laquelle le fichier GeoTIFF correspondant peut être extrait. Ces URL sont valides pendant quelques heures après leur génération. La plupart des fichiers GeoTIFF ont une résolution de 0,1 m/pixel, mais le fichier de flux mensuel est à 0,5 m/pixel et les fichiers d'ombre horaire sont à 1 m/pixel. Si une valeur pixel_size_meters
a été spécifiée dans le GetDataLayersRequest
, la résolution minimale dans les fichiers GeoTIFF sera cette valeur.
Champs | |
---|---|
imagery_date |
Date à laquelle les images sources (à partir desquelles toutes les autres données sont dérivées) de cette région ont été prises. Il est nécessairement quelque peu approximatif, car les images peuvent avoir été prises sur plusieurs jours. |
imagery_processed_date |
Date à laquelle le traitement de ces images a été terminé. |
dsm_url |
URL d'une image du DSM (modèle numérique de surface) de la région. Les valeurs sont exprimées en mètres au-dessus du géoïde EGM96 (niveau de la mer). Les emplacements non valides (pour lesquels nous ne disposons pas de données) sont stockés sous la valeur -9999. |
rgb_url |
URL d'une image des données RVB (photo aérienne) de la région. |
mask_url |
URL de l'image du masque de bâtiment: un bit par pixel indiquant si ce pixel est considéré comme faisant partie d'un toit ou non. |
annual_flux_url |
URL de la carte du flux annuel (ensoleillement annuel sur les toits) de la région. Les valeurs sont exprimées en kWh/kW/an. Il s'agit du flux non masqué: le flux est calculé pour chaque emplacement, et pas seulement pour les toits des bâtiments. Les zones géographiques non valides sont stockées sous la valeur -9999. Les zones géographiques situées en dehors de notre zone de couverture ne sont pas valides, et certaines zones situées dans la zone de couverture pour lesquelles nous n'avons pas pu calculer le flux ne sont pas valides non plus. |
monthly_flux_url |
URL de la carte mensuelle du flux (soleil sur les toits, ventilé par mois) de la région. Les valeurs sont exprimées en kWh/kW/an. Le fichier GeoTIFF pointé par cette URL contiendra douze bandes, correspondant à janvier, février, mars, etc. |
hourly_shade_urls[] |
Douze URL pour l'ombre horaire, correspondant à janvier, février, mars, etc., dans l'ordre. Chaque GeoTIFF contient 24 bandes, correspondant aux 24 heures de la journée. Chaque pixel est un entier de 32 bits, correspondant aux 31 jours (maximum) de ce mois. Un bit 1 signifie que l'emplacement correspondant peut voir le soleil à ce jour, à cette heure et ce mois. Les emplacements non valides sont stockés sous la forme -9999 (étant donné qu'il s'agit d'une valeur négative, le bit 31 est défini, et aucune valeur valide ne peut avoir le bit 31 défini, car cela correspondrait au 32e jour du mois). Un exemple peut être utile. Si vous souhaitez savoir si un point (à l'emplacement du pixel (x, y)) a vu le soleil à 16h le 22 juin, procédez comme suit:
Plus formellement: étant donné
où |
imagery_quality |
Qualité des images du résultat. |
FinancedPurchaseSavings
Coûts et avantages d'un emprunt pour acheter une configuration particulière de panneaux solaires avec une consommation d'électricité spécifique.
Champs | |
---|---|
annual_loan_payment |
Paiements annuels du prêt. |
rebate_value |
Valeur de toutes les remises fiscales (y compris le crédit d'impôt fédéral sur l'investissement (ITC)). |
loan_interest_rate |
Taux d'intérêt des prêts supposé dans cet ensemble de calculs. |
savings |
Economies réalisées (ou non) sur la durée de vie. |
FinancialAnalysis
Analyse des coûts et des avantages de la configuration solaire optimale pour une facture d'électricité donnée.
Champs | |
---|---|
monthly_bill |
Facture d'électricité mensuelle supposée pour cette analyse. |
default_bill |
Indique si cette taille de facture est sélectionnée comme facture par défaut pour la zone dans laquelle se trouve le bâtiment. |
average_kwh_per_month |
Quantité d'électricité consommée par la maison en moyenne par mois, en fonction du montant de la facture et des tarifs d'électricité locaux. |
financial_details |
Informations financières qui s'appliquent quelle que soit la méthode de financement utilisée. |
leasing_savings |
Coût et avantages du leasing des panneaux solaires |
cash_purchase_savings |
Coût et avantages de l'achat des panneaux solaires en espèces. |
financed_purchase_savings |
Coût et avantages de l'achat de panneaux solaires en les finançant |
panel_config_index |
Indice dans |
FinancialDetails
Détails d'une analyse financière. Certaines de ces informations sont déjà stockées à des niveaux supérieurs (par exemple, les frais à la charge de l'utilisateur). Les montants totaux sont calculés sur une période de durée de vie définie par le champ panel_lifetime_years
dans SolarPotential
. Remarque: Le coût d'achat des panneaux est indiqué dans le champ out_of_pocket_cost
de CashPurchaseSavings
.
Champs | |
---|---|
initial_ac_kwh_per_year |
Nombre de kWh CA que les panneaux solaires devraient générer au cours de leur première année. |
remaining_lifetime_utility_bill |
Facture d'électricité pour l'électricité non produite par l'énergie solaire, pendant toute la durée de vie des panneaux. |
federal_incentive |
Montant des incitations fédérales disponibles. Cette information s'applique si l'utilisateur achète (avec ou sans prêt) les panneaux. |
state_incentive |
Montant des incitations d'État disponibles. Cette information s'applique si l'utilisateur achète (avec ou sans prêt) les panneaux. |
utility_incentive |
Montant de l'aide financière disponible grâce aux incitations des fournisseurs d'énergie. Cela s'applique si l'utilisateur achète (avec ou sans prêt) les panneaux. |
lifetime_srec_total |
Montant d'argent que l'utilisateur recevra des crédits d'énergie renouvelable solaire pendant la durée de vie des panneaux. Cela s'applique si l'utilisateur achète (avec ou sans prêt) les panneaux. |
cost_of_electricity_without_solar |
Coût total de l'électricité que l'utilisateur aurait payé sur toute la durée de vie s'il n'avait pas installé de panneaux solaires. |
net_metering_allowed |
Indique si la facturation nette est autorisée. |
solar_percentage |
Pourcentage (0-100) de l'énergie fournie par l'énergie solaire. Valable pour la première année, mais approximativement correct pour les années suivantes. |
percentage_exported_to_grid |
Pourcentage (0-100) de la production d'électricité solaire que nous avons supposé être exportée vers le réseau, sur la base du premier trimestre de production. Cela a une incidence sur les calculs si la facturation nette n'est pas autorisée. |
FindClosestBuildingInsightsRequest
Message de requête pour Solar.FindClosestBuildingInsights
.
Champs | |
---|---|
location |
Obligatoire. Longitude et latitude à partir desquelles l'API recherche le bâtiment connu le plus proche. |
required_quality |
Facultatif. Niveau de qualité minimal autorisé dans les résultats. Aucun résultat de qualité inférieure ne sera renvoyé. Si vous ne spécifiez pas cette valeur, vous vous limitez à la qualité ÉLEVÉE uniquement. |
GetDataLayersRequest
Message de requête pour Solar.GetDataLayers
.
Champs | |
---|---|
location |
Obligatoire. Latitude et longitude du centre de la région pour laquelle vous souhaitez obtenir des données. |
radius_meters |
Obligatoire. Rayon, en mètres, définissant la région entourant le point central pour lequel les données doivent être renvoyées. Les limites de cette valeur sont les suivantes:
|
view |
Facultatif. Sous-ensemble de données à renvoyer. |
required_quality |
Facultatif. Niveau de qualité minimal autorisé dans les résultats. Aucun résultat de qualité inférieure ne sera renvoyé. Si vous ne spécifiez pas cette valeur, vous vous limitez à la qualité ÉLEVÉE uniquement. |
pixel_size_meters |
Facultatif. Échelle minimale, en mètres par pixel, des données à renvoyer. Les valeurs 0,1 (valeur par défaut si ce champ n'est pas défini explicitement), 0,25, 0,5 et 1,0 sont acceptées. Les composants d'images dont la résolution normale est inférieure à |
exact_quality_required |
Facultatif. Indique si la qualité des images doit être exacte. Si la valeur est définie sur "false", le champ |
GetGeoTiffRequest
Message de requête pour Solar.GetGeoTiff
.
Champs | |
---|---|
id |
Obligatoire. ID de l'élément demandé. |
ImageryQuality
Qualité des images utilisées pour calculer un résultat de l'API.
Remarque: Quelle que soit la qualité des images, les sorties DSM ont toujours une résolution de 0,1 m/pixel, les sorties de flux mensuels ont toujours une résolution de 0,5 m/pixel et les sorties d'ombres horaires ont toujours une résolution de 1 m/pixel.
Enums | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
Aucune qualité n'est connue. |
HIGH |
Les données solaires sont dérivées d'images aériennes capturées à basse altitude et traitées à 0,1 m/pixel. |
MEDIUM |
Les données solaires sont dérivées d'images aériennes améliorées capturées à haute altitude et traitées à 0,25 m/pixel. |
LOW |
Les données solaires sont dérivées d'images satellite améliorées traitées à 0,25 m/pixel. |
BASE |
Les données solaires sont dérivées d'images satellite améliorées traitées à 0,25 m/pixel. |
LatLngBox
Un cadre de délimitation en coordonnées de latitude et de longitude.
LeasingSavings
Coût et avantages du leasing d'une configuration particulière de panneaux solaires pour une consommation d'électricité donnée.
Champs | |
---|---|
leases_allowed |
Indique si les baux sont autorisés dans cette juridiction (ils ne le sont pas dans certains États). Si ce champ est défini sur "false", les valeurs de ce message doivent probablement être ignorées. |
leases_supported |
Indique si le moteur de calcul financier est compatible avec les baux dans cette juridiction. Si ce champ est défini sur "false", les valeurs de ce message doivent probablement être ignorées. Cela est indépendant de |
annual_leasing_cost |
Coût annuel estimé du leasing. |
savings |
Economies réalisées (ou non) sur la durée de vie. |
RoofSegmentSizeAndSunshineStats
Informations sur la taille et les quantiles d'ensoleillement d'un segment de toiture.
Champs | |
---|---|
stats |
Taille totale et quantiles d'ensoleillement pour le segment de toit. |
center |
Point situé près du centre du segment de toit. |
bounding_box |
Cadre de délimitation du segment de toit. |
pitch_degrees |
Angle du segment de toit par rapport au plan théorique du sol. 0 = parallèle au sol, 90 = perpendiculaire au sol. |
azimuth_degrees |
Direction indiquée par la boussole dans laquelle le segment de toiture pointe. 0 = Nord, 90 = Est, 180 = Sud. Pour un segment de toit "plat" ( |
plane_height_at_center_meters |
Hauteur du plan du segment de toit, en mètres au-dessus du niveau de la mer, au point désigné par |
RoofSegmentSummary
Informations sur un segment de toiture du bâtiment, sur lequel sont disposés un certain nombre de panneaux.
Champs | |
---|---|
panels_count |
Nombre total de panneaux dans ce segment. |
yearly_energy_dc_kwh |
Quantité d'énergie solaire captée par cette partie de la disposition au cours d'une année, en kWh CC, en supposant que les panneaux décrits ci-dessus. |
pitch_degrees |
Angle du segment de toit par rapport au plan théorique du sol. 0 = parallèle au sol, 90 = perpendiculaire au sol. |
azimuth_degrees |
Direction indiquée par la boussole dans laquelle le segment de toiture pointe. 0 = Nord, 90 = Est, 180 = Sud. Pour un segment de toit "plat" ( |
segment_index |
Index dans |
SavingsOverTime
Informations financières partagées entre différentes méthodes de financement.
Champs | |
---|---|
savings_year1 |
Économies réalisées la première année après l'installation des panneaux. |
savings_year20 |
Économies réalisées au cours des vingt premières années après l'installation des panneaux. |
present_value_of_savings_year20 |
En utilisant le taux d'actualisation supposé, quelle est la valeur actuelle des économies cumulées sur 20 ans ? |
savings_lifetime |
Économies sur toute la durée de vie du panneau. |
present_value_of_savings_lifetime |
En utilisant le taux d'actualisation supposé, quelle est la valeur actuelle des économies cumulées sur toute la durée de vie ? |
financially_viable |
Indique si ce scénario est financièrement viable. Valeur "false" pour les scénarios dont la viabilité financière est faible (par exemple, qui enregistrent des pertes). |
SizeAndSunshineStats
Quantiles de taille et d'ensoleillement d'un toit ou d'une partie de toit.
Champs | |
---|---|
area_meters2 |
Surface du toit ou du segment de toit, en m². Il s'agit de la surface du toit (en tenant compte de l'inclinaison), et non de la surface au sol. |
sunshine_quantiles[] |
Quantiles de l'ensoleillement ponctuel dans la zone. Si N valeurs sont indiquées, elles représentent les (N-1) iles. Par exemple, s'il existe cinq valeurs, il s'agit des quartiles (min, 25%, 50%, 75%, max). Les valeurs sont exprimées en kWh/kW par an, comme |
ground_area_meters2 |
Superficie au sol couverte par le toit ou le segment de toit, en m². |
SolarPanel
SolarPanel décrit la position, l'orientation et la production d'un seul panneau solaire. Pour en savoir plus sur les paramètres du panneau, consultez les champs panel_height_meters
, panel_width_meters
et panel_capacity_watts
dans SolarPotential
.
Champs | |
---|---|
center |
Centre du panneau. |
orientation |
Orientation du panneau. |
yearly_energy_dc_kwh |
Quantité d'énergie solaire capturée par cette disposition au cours d'une année, en kWh CC. |
segment_index |
Index dans |
SolarPanelConfig
SolarPanelConfig décrit un emplacement particulier des panneaux solaires sur le toit.
Champs | |
---|---|
panels_count |
Nombre total de panneaux. Notez que cette valeur est redondante avec (la somme) des champs correspondants dans |
yearly_energy_dc_kwh |
Quantité d'énergie solaire capturée par cette disposition au cours d'une année, en kWh CC, en supposant que les panneaux décrits ci-dessus. |
roof_segment_summaries[] |
Informations sur la production de chaque segment de toit qui comporte au moins un panneau dans cette mise en page. |
SolarPanelOrientation
Orientation d'un panneau solaire. Cette valeur doit être interprétée par rapport à l'azimut du segment de toit sur lequel le panneau est placé.
Enums | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Aucune orientation de panneau n'est connue. |
LANDSCAPE |
Le bord long d'un panneau LANDSCAPE est perpendiculaire à l'azimut du segment de toit sur lequel il est placé. |
PORTRAIT |
Le bord long d'un panneau PORTRAIT est parallèle à l'azimut du segment de toit sur lequel il est placé. |
SolarPotential
Informations sur le potentiel solaire d'un bâtiment. Un certain nombre de champs sont définis en termes de "panneaux". Les champs panel_capacity_watts
, panel_height_meters
et panel_width_meters
décrivent les paramètres du modèle de panneau utilisé dans ces calculs.
Champs | |
---|---|
max_array_panels_count |
Taille de la matrice maximale, c'est-à-dire nombre maximal de panneaux pouvant être installés sur le toit. |
panel_capacity_watts |
Capacité, en watts, du panneau utilisée dans les calculs. |
panel_height_meters |
Hauteur, en mètres en mode portrait, du panneau utilisé dans les calculs. |
panel_width_meters |
Largeur, en mètres en mode portrait, du panneau utilisé dans les calculs. |
panel_lifetime_years |
Durée de vie prévue, en années, des panneaux solaires. Il est utilisé dans les calculs financiers. |
max_array_area_meters2 |
Taille, en mètres carrés, du tableau maximal. |
max_sunshine_hours_per_year |
Nombre maximal d'heures d'ensoleillement reçues par an, à n'importe quel point du toit. Les heures d'ensoleillement mesurent la quantité totale d'insolation (énergie) reçue par an. 1 heure d'ensoleillement = 1 kWh par kW (où le kW fait référence à la capacité en kW dans des conditions de test standard). |
carbon_offset_factor_kg_per_mwh |
Quantité équivalente de CO2 produite par MWh d'électricité du réseau. Il s'agit d'une mesure de l'intensité carbone de l'électricité du réseau remplacée par l'électricité solaire. |
whole_roof_stats |
Taille totale et quantiles d'ensoleillement pour la partie du toit attribuée à un segment de toiture. Malgré son nom, cette zone n'inclut pas nécessairement l'ensemble du bâtiment. Consultez les |
building_stats |
Taille et quantiles d'ensoleillement pour l'ensemble du bâtiment, y compris les parties du toit qui n'ont pas été attribuées à un segment de toit. Étant donné que les orientations de ces parties ne sont pas bien caractérisées, l'estimation de la surface de toit est peu fiable, mais l'estimation de la surface au sol l'est. Il est possible d'obtenir une surface de toit plus fiable pour l'ensemble du bâtiment en étalonnant la surface de toit de |
roof_segment_stats[] |
Taille et quantiles d'ensoleillement pour chaque segment de toiture |
solar_panels[] |
Chaque |
solar_panel_configs[] |
Chaque |
financial_analyses[] |
Un |