- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
- AdditionalInsights
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Argent
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- DetectedArrays
- DetectionStatus
- SolarArray
- Essayer
Localise le bâtiment dont le centroïde est le plus proche d'un point de requête. Renvoie une erreur avec le code NOT_FOUND s'il n'y a aucun bâtiment à environ 50 mètres du point de requête.
Requête HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de requête
| Paramètres | |
|---|---|
location |
Obligatoire. Longitude et latitude à partir desquelles l'API recherche le bâtiment connu le plus proche. |
requiredQuality |
Facultatif. Niveau de qualité minimal autorisé dans les résultats. Aucun résultat de qualité inférieure à celle-ci ne sera renvoyé. Si vous ne spécifiez pas cette option, la qualité est limitée à HIGH. |
exactQualityRequired |
Facultatif. Indique si la qualité exacte de l'imagerie est requise. Si ce champ est défini sur "false", le champ |
experiments[] |
Facultatif. Spécifie les tests pré-DG à activer. Les requêtes utilisant ce champ sont classées comme une offre pré-DG en vertu des Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement. |
additionalInsights[] |
Facultatif. Liste de |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Message de réponse pour Solar.FindClosestBuildingInsights. Informations sur l'emplacement, les dimensions et le potentiel solaire d'un bâtiment.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
|---|
{ "name": string, "center": { object ( |
| Champs | |
|---|---|
name |
Nom de ressource du bâtiment, au format |
center |
Un point situé près du centre du bâtiment. |
boundingBox |
Cadre de délimitation du bâtiment. |
imageryDate |
Date à laquelle l'imagerie sous-jacente a été acquise. Il s'agit d'une approximation. |
imageryProcessedDate |
Date à laquelle le traitement de ces images a été terminé. |
postalCode |
Code postal (par exemple, code postal américain) dans lequel se trouve ce bâtiment. |
administrativeArea |
Région administrative 1 (par exemple, l'État aux États-Unis) qui contient ce bâtiment. Par exemple, aux États-Unis, l'abréviation peut être "MA" ou "CA". |
statisticalArea |
Zone statistique (par exemple, zone de recensement aux États-Unis) dans laquelle se trouve ce bâtiment. |
regionCode |
Code de région du pays (ou de la région) dans lequel se trouve ce bâtiment. |
solarPotential |
Potentiel solaire du bâtiment. |
imageryQuality |
Qualité de l'imagerie utilisée pour calculer les données de ce bâtiment. |
detectedArrays |
Panneaux solaires détectés sur le bâtiment. Ce champ n'est renseigné que si DETECTED_ARRAYS est inclus dans le |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/cloud-platform
AdditionalInsights
Informations supplémentaires sur le bâtiment, telles que la géométrie du toit et les panneaux solaires, qui peuvent être renvoyées dans BuildingInsights.
| Enums | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED |
Valeur par défaut. Le BuildingInsights par défaut sera renvoyé. |
DETECTED_ARRAYS |
Détermine si la réponse inclura les tableaux détectés. S'il est spécifié, le champ |
LatLngBox
Cadre de délimitation en coordonnées de latitude/longitude.
| Représentation JSON |
|---|
{ "sw": { object ( |
| Champs | |
|---|---|
sw |
Angle sud-ouest de la zone. |
ne |
Angle nord-est de la zone. |
SolarPotential
Informations sur le potentiel solaire d'un bâtiment. Un certain nombre de champs sont définis en termes de "panneaux". Les champs panelCapacityWatts, panelHeightMeters et panelWidthMeters décrivent les paramètres du modèle de panneau utilisé dans ces calculs.
| Représentation JSON |
|---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
| Champs | |
|---|---|
maxArrayPanelsCount |
Taille maximale du panneau, c'est-à-dire le nombre maximal de panneaux pouvant être installés sur le toit. |
panelCapacityWatts |
Capacité, en watts, du panneau utilisé dans les calculs. |
panelHeightMeters |
Hauteur, en mètres, du panneau utilisé dans les calculs en orientation portrait. |
panelWidthMeters |
Largeur, en mètres en orientation portrait, du panneau utilisé dans les calculs. |
panelLifetimeYears |
Durée de vie prévue, en années, des panneaux solaires. Cette valeur est utilisée dans les calculs financiers. |
maxArrayAreaMeters2 |
Taille, en mètres carrés, du tableau maximal. |
maxSunshineHoursPerYear |
Nombre maximal d'heures d'ensoleillement reçues par an, en tout 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ù kW fait référence à la capacité en kW dans des conditions de test standard). |
carbonOffsetFactorKgPerMwh |
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. |
wholeRoofStats |
Taille totale et quantiles d'ensoleillement pour la partie du toit qui a été attribuée à un segment de toit. Malgré son nom, il se peut qu'il n'inclue pas l'intégralité du bâtiment. Consultez les |
buildingStats |
Quantiles de taille et 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. Comme l'orientation de ces parties n'est pas bien caractérisée, l'estimation de la surface de toit n'est pas 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 mettant à l'échelle la surface de toit de |
roofSegmentStats[] |
Quantiles de taille et d'ensoleillement pour chaque segment de toit. |
solarPanels[] |
Chaque |
solarPanelConfigs[] |
Chaque |
financialAnalyses[] |
Un |
SizeAndSunshineStats
Quantiles de taille et d'ensoleillement d'un toit ou d'une partie d'un toit.
| Représentation JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Champs | |
|---|---|
areaMeters2 |
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 l'empreinte au sol. |
sunshineQuantiles[] |
Quantiles de l'ensoleillement ponctuel dans la zone. S'il y a N valeurs ici, cela représente les (N-1)-iles. Par exemple, s'il y a cinq valeurs, il s'agit des quartiles (min, 25 %, 50 %, 75 %, max). Les valeurs sont exprimées en kWh/kW annuels, par exemple |
groundAreaMeters2 |
Surface au sol couverte par le toit ou le segment de toit, en m². |
RoofSegmentSizeAndSunshineStats
Informations sur la taille et les quantiles d'ensoleillement d'un segment de toit.
| Représentation JSON |
|---|
{ "stats": { object ( |
| Champs | |
|---|---|
stats |
Taille totale et quantiles d'ensoleillement pour le segment de toit. |
center |
Un point situé près du centre du segment de toit. |
boundingBox |
Cadre de délimitation du segment de toit. |
pitchDegrees |
Angle du segment de toit par rapport au plan théorique du sol. 0 = parallèle au sol, 90 = perpendiculaire au sol. |
azimuthDegrees |
Direction de la boussole vers laquelle pointe le segment de toit. 0 = Nord, 90 = Est, 180 = Sud. Pour un segment de toit "plat" ( |
planeHeightAtCenterMeters |
Hauteur du plan du segment de toit, en mètres au-dessus du niveau de la mer, au point désigné par |
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 panelHeightMeters, panelWidthMeters et panelCapacityWatts dans SolarPotential.
| Représentation JSON |
|---|
{ "center": { object ( |
| Champs | |
|---|---|
center |
Le centre du panneau. |
orientation |
Orientation du panneau. |
yearlyEnergyDcKwh |
Quantité d'énergie solaire captée par cette disposition au cours d'une année, en kWh CC. |
segmentIndex |
Index dans |
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 |
Un panneau LANDSCAPE a son bord long perpendiculaire à la direction de l'azimut du segment de toit sur lequel il est placé. |
PORTRAIT |
Le bord long d'un panneau PORTRAIT est parallèle à la direction de l'azimut du segment de toit sur lequel il est placé. |
SolarPanelConfig
SolarPanelConfig décrit un emplacement particulier de panneaux solaires sur le toit.
| Représentation JSON |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| Champs | |
|---|---|
panelsCount |
Nombre total de panneaux. Notez que cela est redondant par rapport à (la somme des) champs correspondants dans |
yearlyEnergyDcKwh |
Quantité d'énergie solaire captée par cette disposition au cours d'une année, en kWh (CC), en supposant que les panneaux décrits ci-dessus sont utilisés. |
roofSegmentSummaries[] |
Informations sur la production de chaque segment de toit comportant au moins un panneau dans cette disposition. |
RoofSegmentSummary
Informations sur un segment de toit du bâtiment, avec un certain nombre de panneaux placés dessus.
| Représentation JSON |
|---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
| Champs | |
|---|---|
panelsCount |
Nombre total de panneaux sur ce segment. |
yearlyEnergyDcKwh |
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 sont utilisés. |
pitchDegrees |
Angle du segment de toit par rapport au plan théorique du sol. 0 = parallèle au sol, 90 = perpendiculaire au sol. |
azimuthDegrees |
Direction de la boussole vers laquelle pointe le segment de toit. 0 = Nord, 90 = Est, 180 = Sud. Pour un segment de toit "plat" ( |
segmentIndex |
Index dans |
FinancialAnalysis
Analyse des coûts et des avantages de la configuration solaire optimale pour un montant de facture d'électricité donné.
| Représentation JSON |
|---|
{ "monthlyBill": { object ( |
| Champs | |
|---|---|
monthlyBill |
Facture d'électricité mensuelle sur laquelle repose cette analyse. |
defaultBill |
Indique si cette taille de facture est sélectionnée comme facture par défaut pour la zone dans laquelle se trouve ce bâtiment. Un seul |
averageKwhPerMonth |
La quantité d'électricité consommée par le foyer au cours d'un mois moyen, en fonction du montant de la facture et des tarifs d'électricité locaux. |
financialDetails |
Informations financières qui s'appliquent quel que soit le mode de financement utilisé. |
leasingSavings |
Coût et avantage de la location des panneaux solaires. |
cashPurchaseSavings |
Coût et avantage de l'achat de panneaux solaires au comptant. |
financedPurchaseSavings |
Coût et avantage de l'achat des panneaux solaires en finançant l'achat. |
panelConfigIndex |
Index dans |
Valeur monétaire
Représente un montant associé à un type de devise.
| Représentation JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Champs | |
|---|---|
currencyCode |
Code de la devise à trois lettres défini par la norme ISO 4217. |
units |
Unités entières du montant. Par exemple, si |
nanos |
Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si |
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 du patient). Les montants totaux sont calculés sur une période définie par le champ panelLifetimeYears dans SolarPotential. Remarque : Le coût d'achat des panneaux est indiqué dans le champ outOfPocketCost de CashPurchaseSavings.
| Représentation JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Champs | |
|---|---|
initialAcKwhPerYear |
Nombre de kWh (CA) que les panneaux solaires devraient générer au cours de leur première année. |
remainingLifetimeUtilityBill |
Facture d'électricité non produite par l'énergie solaire, pour la durée de vie des panneaux. |
federalIncentive |
Montant disponible grâce aux incitations fédérales. Cela s'applique si l'utilisateur achète les panneaux (avec ou sans prêt). |
stateIncentive |
Montant disponible grâce aux aides de l'État. Cela s'applique si l'utilisateur achète les panneaux (avec ou sans prêt). |
utilityIncentive |
Montant disponible grâce aux incitations des fournisseurs d'énergie. Cela s'applique si l'utilisateur achète les panneaux (avec ou sans prêt). |
lifetimeSrecTotal |
Montant 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 les panneaux (avec ou sans prêt). |
costOfElectricityWithoutSolar |
Coût total de l'électricité que l'utilisateur aurait payé sur la période de durée de vie s'il n'avait pas installé de panneaux solaires. |
netMeteringAllowed |
Indique si la facturation nette est autorisée. |
solarPercentage |
Pourcentage (0-100) de l'énergie de l'utilisateur fournie par l'énergie solaire. Valable pour la première année, mais approximativement correct pour les années suivantes. |
percentageExportedToGrid |
Pourcentage (0-100) de la production d'électricité solaire que nous avons supposé être exportée vers le réseau, d'après le premier trimestre de production. Cela affecte les calculs si la facturation nette n'est pas autorisée. |
LeasingSavings
Coût et avantage de la location d'une configuration particulière de panneaux solaires avec une consommation d'électricité spécifique.
| Représentation JSON |
|---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
| Champs | |
|---|---|
leasesAllowed |
Indique si les baux sont autorisés dans cette juridiction (les baux ne sont pas autorisés dans certains États). Si ce champ est défini sur "false", les valeurs de ce message doivent probablement être ignorées. |
leasesSupported |
Indique si les baux sont pris en charge dans cette juridiction par le moteur de calcul financier. Si ce champ est défini sur "false", les valeurs de ce message doivent probablement être ignorées. Cela est indépendant de |
annualLeasingCost |
Coût annuel estimé de la location. |
savings |
Montant économisé (ou non) sur la période de durée de vie. |
SavingsOverTime
Informations financières partagées entre différentes méthodes de financement.
| Représentation JSON |
|---|
{ "savingsYear1": { object ( |
| Champs | |
|---|---|
savingsYear1 |
Économies réalisées au cours de la première année suivant l'installation des panneaux. |
savingsYear20 |
Économies réalisées au cours des 20 premières années suivant l'installation des panneaux. |
presentValueOfSavingsYear20 |
En utilisant le taux d'actualisation supposé, quelle est la valeur actuelle des économies cumulées sur 20 ans ? |
savingsLifetime |
Économies sur toute la durée de vie du panneau. |
presentValueOfSavingsLifetime |
En utilisant le taux d'actualisation supposé, quelle est la valeur actuelle des économies cumulées sur la durée de vie ? |
financiallyViable |
Indique si ce scénario est financièrement viable. La valeur sera "false" pour les scénarios dont la viabilité financière est faible (par exemple, s'ils entraînent des pertes financières). |
CashPurchaseSavings
Coût et avantage de l'achat d'une configuration particulière de panneaux solaires avec une consommation d'électricité spécifique.
| Représentation JSON |
|---|
{ "outOfPocketCost": { object ( |
| Champs | |
|---|---|
outOfPocketCost |
Coût initial avant incitations fiscales : montant à payer de votre poche. À ne pas confondre avec |
upfrontCost |
Coût initial après incitations fiscales : montant à payer la première année. À ne pas confondre avec le |
rebateValue |
Valeur de toutes les remises fiscales. |
savings |
Montant économisé (ou non) sur la période de durée de vie. |
paybackYears |
Nombre d'années avant l'amortissement. Une valeur négative signifie que le retour sur investissement n'est jamais atteint au cours de la période de durée de vie. |
FinancedPurchaseSavings
Coût et avantage de l'utilisation d'un prêt pour acheter une configuration particulière de panneaux solaires avec une consommation d'électricité particulière.
| Représentation JSON |
|---|
{ "annualLoanPayment": { object ( |
| Champs | |
|---|---|
annualLoanPayment |
Remboursements annuels de prêts. |
rebateValue |
Valeur de toutes les remises fiscales (y compris le crédit d'impôt fédéral pour investissement). |
loanInterestRate |
Taux d'intérêt sur les prêts supposé dans cet ensemble de calculs. |
savings |
Montant économisé (ou non) sur la période de durée de vie. |
DetectedArrays
Informations sur les panneaux solaires détectés sur le bâtiment.
| Représentation JSON |
|---|
{ "detectionStatus": enum ( |
| Champs | |
|---|---|
detectionStatus |
Indique l'état de détection des panneaux solaires pour ce bâtiment. |
arrays[] |
Liste des panneaux solaires détectés sur le bâtiment. |
latestCaptureDate |
Date indiquant quand les dernières données sur les panneaux solaires ont été capturées. |
DetectionStatus
Indique l'état de détection des panneaux solaires pour ce bâtiment.
| Enums | |
|---|---|
DETECTION_STATUS_UNSPECIFIED |
État non spécifié. |
DETECTION_STATUS_DATA_UNAVAILABLE |
Les données sur les panneaux solaires détectés ne sont pas disponibles pour ce bâtiment. |
DETECTION_STATUS_ARRAYS_DETECTED |
Au moins un panneau solaire a été détecté pour ce bâtiment. |
DETECTION_STATUS_NO_ARRAYS_DETECTED |
Aucun panneau solaire détecté pour ce bâtiment. |
SolarArray
Détails d'un seul panneau solaire détecté.
| Représentation JSON |
|---|
{ "polygonGeojson": { object } } |
| Champs | |
|---|---|
polygonGeojson |
Représentation GeoJSON de la zone du bâtiment où des panneaux solaires ont été détectés. Les données GeoJSON doivent être au format RFC 7946 et représenter un polygone pour une seule zone contiguë. Le polygone sera représenté par plusieurs boucles lorsqu'il contient des trous. Exemple : { "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] } |