- Żądanie HTTP
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Zarabianie
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Wypróbuj
Wyszukuje budynek, którego środek ciężkości znajduje się najbliżej punktu zapytania. Jeśli w odległości około 50 m od punktu zapytania nie ma budynków, zwraca błąd o kodzie NOT_FOUND.
Żądanie HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry | |
|---|---|
location |
Wymagane. Długość i szerokość geograficzna, na podstawie których interfejs API wyszukuje najbliższy znany budynek. |
requiredQuality |
Opcjonalnie: Minimalny poziom jakości dozwolony w wynikach. Nie zostaną zwrócone żadne wyniki o niższej jakości. Nieokreślenie tego parametru jest równoznaczne z ograniczeniem do jakości WYSOKIEJ. |
exactQualityRequired |
Opcjonalnie: Określa, czy wymagana jest dokładna jakość zdjęć. Jeśli wartość tego pola to „false”, pole |
experiments[] |
Opcjonalnie: Określa funkcje przed GA, które mają zostać włączone. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Wiadomość z odpowiedzią dla Solar.FindClosestBuildingInsights. Informacje o lokalizacji, wymiarach i potencjale związanym z energią słoneczną danego budynku.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
|---|
{ "name": string, "center": { object ( |
| Pola | |
|---|---|
name |
Nazwa zasobu budynku w formacie |
center |
Punkt w pobliżu środka budynku. |
boundingBox |
Ramka ograniczająca budynku. |
imageryDate |
Data pozyskania zdjęć bazowych. To jest wartość przybliżona. |
imageryProcessedDate |
Kiedy zakończono przetwarzanie tych zdjęć. |
postalCode |
Kod pocztowy (np. kod pocztowy w USA), w którym znajduje się ten budynek. |
administrativeArea |
Obszar administracyjny 1 (np. w Stanach Zjednoczonych stan), w którym znajduje się ten budynek. Na przykład w Stanach Zjednoczonych skrót może brzmieć „MA” lub „CA”. |
statisticalArea |
Obszar statystyczny (np. okręgu spisowego w USA, w którym znajduje się ten budynek. |
regionCode |
Kod regionu kraju (lub regionu), w którym znajduje się ten budynek. |
solarPotential |
potencjał paneli słonecznych w budynku; |
imageryQuality |
Jakość zdjęć użytych do obliczenia danych dla tego budynku. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Ramka ograniczająca we współrzędnych geograficznych.
| Zapis JSON |
|---|
{ "sw": { object ( |
| Pola | |
|---|---|
sw |
Południowo-zachodni róg pola. |
ne |
Północno-wschodni róg ramki. |
SolarPotential
Informacje o potencjale związanym z energią słoneczną w przypadku budynku. Wiele pól jest w nim zdefiniowanych w kategoriach „paneli”. Pola panelCapacityWatts, panelHeightMeters i panelWidthMeters opisują parametry modelu panelu użytego w tych obliczeniach.
| Zapis JSON |
|---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
| Pola | |
|---|---|
maxArrayPanelsCount |
Rozmiar maksymalnej tablicy, czyli maksymalna liczba paneli, które zmieszczą się na dachu. |
panelCapacityWatts |
Moc panelu użytego w obliczeniach (w watach). |
panelHeightMeters |
Wysokość panelu w metrach w orientacji pionowej używanego w obliczeniach. |
panelWidthMeters |
Szerokość panelu używanego w obliczeniach w metrach w orientacji pionowej. |
panelLifetimeYears |
Oczekiwana żywotność paneli słonecznych w latach. Jest on używany w obliczeniach finansowych. |
maxArrayAreaMeters2 |
Rozmiar maksymalnej tablicy w metrach kwadratowych. |
maxSunshineHoursPerYear |
Maksymalna liczba godzin nasłonecznienia w ciągu roku w dowolnym punkcie dachu. Liczba godzin słonecznych to miara łącznej ilości nasłonecznienia (energii) otrzymywanej w ciągu roku. 1 godzina nasłonecznienia = 1 kWh na 1 kW (gdzie kW oznacza moc w kW w standardowych warunkach testowych). |
carbonOffsetFactorKgPerMwh |
Równoważna ilość CO₂ wytwarzana na MWh energii elektrycznej z sieci. Jest to miara emisyjności CO2 energii elektrycznej z sieci, która została zastąpiona energią słoneczną. |
wholeRoofStats |
Łączny rozmiar i kwantyle światła słonecznego dla części dachu przypisanej do segmentu dachu. Pomimo nazwy może nie obejmować całego budynku. Zobacz |
buildingStats |
Kwantyle wielkości i nasłonecznienia dla całego budynku, w tym części dachu, które nie zostały przypisane do żadnego segmentu dachu. Orientacja tych części nie jest dobrze określona, więc szacunkowa powierzchnia dachu jest niewiarygodna, ale szacunkowa powierzchnia gruntu jest wiarygodna. Bardziej wiarygodną powierzchnię dachu całego budynku można uzyskać, skalując powierzchnię dachu z |
roofSegmentStats[] |
kwantyle rozmiaru i nasłonecznienia dla każdego segmentu dachu; |
solarPanels[] |
Każdy symbol |
solarPanelConfigs[] |
Każdy |
financialAnalyses[] |
|
SizeAndSunshineStats
kwantyle rozmiaru i nasłonecznienia dachu lub jego części;
| Zapis JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Pola | |
|---|---|
areaMeters2 |
Powierzchnia dachu lub jego fragmentu w m². Jest to powierzchnia dachu (z uwzględnieniem nachylenia), a nie powierzchnia zajmowana przez budynek na ziemi. |
sunshineQuantiles[] |
Kwantyle nasłonecznienia punktowego na danym obszarze. Jeśli jest tu N wartości, reprezentują one (N-1)-ile. Jeśli na przykład jest 5 wartości, będą to kwartyle (min, 25%, 50%, 75%, max). Wartości są podawane w kWh/kW rocznie, np. |
groundAreaMeters2 |
Powierzchnia gruntu pokryta dachem lub jego segmentem w m². |
RoofSegmentSizeAndSunshineStats
Informacje o kwantylach rozmiaru i nasłonecznienia segmentu dachu.
| Zapis JSON |
|---|
{ "stats": { object ( |
| Pola | |
|---|---|
stats |
Całkowity rozmiar i kwantyle nasłonecznienia segmentu dachu. |
center |
Punkt w pobliżu środka segmentu dachu. |
boundingBox |
Ramka ograniczająca segment dachu. |
pitchDegrees |
Kąt segmentu dachu względem teoretycznej płaszczyzny gruntu. 0 = równolegle do podłoża, 90 = prostopadle do podłoża. |
azimuthDegrees |
Kierunek, w którym zwrócony jest segment dachu. 0 = północ, 90 = wschód, 180 = południe. W przypadku segmentu dachu „płaskiego” ( |
planeHeightAtCenterMeters |
Wysokość płaszczyzny segmentu dachu w metrach nad poziomem morza w punkcie oznaczonym symbolem |
SolarPanel
SolarPanel opisuje położenie, orientację i produkcję pojedynczego panelu słonecznego. Informacje o parametrach panelu znajdziesz w polach panelHeightMeters, panelWidthMeters i panelCapacityWatts w SolarPotential.
| Zapis JSON |
|---|
{ "center": { object ( |
| Pola | |
|---|---|
center |
środek panelu. |
orientation |
Orientacja panelu. |
yearlyEnergyDcKwh |
Ile energii słonecznej w kWh prądu stałego przechwytuje ten układ w ciągu roku. |
segmentIndex |
Indeks w |
SolarPanelOrientation
Orientacja panelu słonecznego. Należy to interpretować w odniesieniu do azymutu segmentu dachu, na którym umieszczony jest panel.
| Wartości w polu enum | |
|---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Nieznana orientacja panelu. |
LANDSCAPE |
Dłuższy bok panelu LANDSCAPE jest prostopadły do kierunku azymutu segmentu dachu, na którym jest umieszczony. |
PORTRAIT |
PORTRAIT Panel jest ustawiony dłuższą krawędzią równolegle do kierunku azymutu segmentu dachu, na którym jest umieszczony. |
SolarPanelConfig
SolarPanelConfig opisuje konkretne rozmieszczenie paneli słonecznych na dachu.
| Zapis JSON |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| Pola | |
|---|---|
panelsCount |
Łączna liczba paneli. Pamiętaj, że jest to redundantne w stosunku do (sumy) odpowiednich pól w |
yearlyEnergyDcKwh |
Ile energii słonecznej w kWh prądu stałego (DC) może zostać pozyskane w ciągu roku przy założeniu, że panele są takie jak opisane powyżej. |
roofSegmentSummaries[] |
Informacje o produkcji każdego segmentu dachu, który zawiera co najmniej 1 panel w tym układzie. |
RoofSegmentSummary
Informacje o fragmencie dachu budynku, na którym znajduje się pewna liczba paneli.
| Zapis JSON |
|---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
| Pola | |
|---|---|
panelsCount |
Łączna liczba paneli w tym segmencie. |
yearlyEnergyDcKwh |
Ile energii słonecznej ta część układu przechwytuje w ciągu roku (w kWh prądu stałego) przy założeniu, że są to opisane powyżej panele. |
pitchDegrees |
Kąt segmentu dachu względem teoretycznej płaszczyzny gruntu. 0 = równoległa do podłoża, 90 = prostopadła do podłoża. |
azimuthDegrees |
Kierunek, w którym zwrócony jest segment dachu. 0 = północ, 90 = wschód, 180 = południe. W przypadku segmentu dachu „płaskiego” ( |
segmentIndex |
Indeks w |
FinancialAnalysis
Analiza kosztów i korzyści wynikających z optymalnego rozmieszczenia paneli słonecznych w przypadku określonej wysokości rachunku za prąd.
| Zapis JSON |
|---|
{ "monthlyBill": { object ( |
| Pola | |
|---|---|
monthlyBill |
Miesięczny rachunek za prąd, który został przyjęty w tej analizie. |
defaultBill |
Czy jest to rozmiar rachunku wybrany jako domyślny dla obszaru, na którym znajduje się ten budynek. Dokładnie 1 element |
averageKwhPerMonth |
Ile energii elektrycznej zużywa dom w przeciętnym miesiącu na podstawie wysokości rachunku i lokalnych stawek za energię elektryczną. |
financialDetails |
Informacje finansowe, które mają zastosowanie niezależnie od użytej metody finansowania. |
leasingSavings |
Koszt i korzyści z dzierżawy paneli słonecznych. |
cashPurchaseSavings |
Koszt i korzyści związane z zakupem paneli słonecznych za gotówkę. |
financedPurchaseSavings |
Koszt i korzyści związane z zakupem paneli słonecznych w ramach finansowania. |
panelConfigIndex |
Indeks w |
Pieniądze
Reprezentuje kwotę pieniędzy z określeniem typu waluty.
| Zapis JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Pola | |
|---|---|
currencyCode |
Trzyliterowy kod waluty zdefiniowany w normie ISO 4217. |
units |
Całe jednostki kwoty. Jeśli na przykład |
nanos |
Liczba nanounitów (10^-9) kwoty. Wartość musi mieścić się w przedziale od -999 999 999 do +999 999 999 (włącznie). Jeśli wartość |
FinancialDetails
szczegóły analizy finansowej; Niektóre z tych szczegółów są już przechowywane na wyższych poziomach (np. koszt z własnej kieszeni). Łączne kwoty pieniędzy dotyczą okresu zdefiniowanego przez pole panelLifetimeYears w SolarPotential. Uwaga: koszt zakupu paneli podany jest w polu outOfPocketCost w CashPurchaseSavings.
| Zapis JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Pola | |
|---|---|
initialAcKwhPerYear |
Szacowana ilość kWh prądu przemiennego, jaką panele słoneczne wygenerują w pierwszym roku. |
remainingLifetimeUtilityBill |
Rachunek za energię elektryczną, która nie jest wytwarzana przez panele słoneczne, przez cały okres ich eksploatacji. |
federalIncentive |
Kwota dostępna w ramach zachęt federalnych. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez). |
stateIncentive |
Kwota dostępna w ramach zachęt państwowych. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez). |
utilityIncentive |
Kwota dostępna w ramach zachęt od dostawców energii; dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez niego). |
lifetimeSrecTotal |
Kwota pieniędzy, jaką użytkownik otrzyma z tytułu kredytów na energię odnawialną z instalacji fotowoltaicznej w okresie jej eksploatacji. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez). |
costOfElectricityWithoutSolar |
Całkowity koszt energii elektrycznej, jaki użytkownik zapłaciłby w okresie eksploatacji, gdyby nie zainstalował paneli słonecznych. |
netMeteringAllowed |
Czy opomiarowanie netto jest dozwolone. |
solarPercentage |
Procent (0–100) energii użytkownika pochodzącej z energii słonecznej. Obowiązuje w pierwszym roku, ale jest w przybliżeniu prawidłowa w kolejnych latach. |
percentageExportedToGrid |
Procent (0–100) produkcji energii elektrycznej z fotowoltaiki, który według naszych założeń został wyeksportowany do sieci na podstawie danych z pierwszego kwartału produkcji. Wpływa to na obliczenia, jeśli rozliczenie net-metering nie jest dozwolone. |
LeasingSavings
Koszt i korzyści z dzierżawy paneli słonecznych w określonej konfiguracji przy określonym zużyciu energii elektrycznej.
| Zapis JSON |
|---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
| Pola | |
|---|---|
leasesAllowed |
Czy w danym regionie dopuszczalne są umowy leasingu (w niektórych stanach są one niedozwolone). Jeśli to pole ma wartość „false”, wartości w tym komunikacie należy prawdopodobnie zignorować. |
leasesSupported |
Informacja, czy silnik obliczeń finansowych obsługuje leasing w danym regionie. Jeśli to pole ma wartość „false”, wartości w tym komunikacie należy prawdopodobnie zignorować. Jest to niezależne od |
annualLeasingCost |
Szacowany roczny koszt leasingu. |
savings |
Ile zostało zaoszczędzone (lub nie) w całym okresie. |
SavingsOverTime
informacje finansowe, które są udostępniane między różnymi metodami finansowania;
| Zapis JSON |
|---|
{ "savingsYear1": { object ( |
| Pola | |
|---|---|
savingsYear1 |
Oszczędności w pierwszym roku po instalacji paneli. |
savingsYear20 |
Oszczędności w pierwszych 20 latach po instalacji paneli. |
presentValueOfSavingsYear20 |
Jaka jest obecna wartość skumulowanych oszczędności w ciągu 20 lat przy założonej stopie dyskontowej? |
savingsLifetime |
Oszczędności w całym okresie użytkowania panelu. |
presentValueOfSavingsLifetime |
Jaka jest obecna wartość skumulowanych oszczędności w całym okresie użytkowania przy założonej stopie dyskontowej? |
financiallyViable |
Wskazuje, czy ten scenariusz jest opłacalny. W przypadku scenariuszy o niskiej rentowności (np. przynoszących straty) wartość będzie fałszywa. |
CashPurchaseSavings
Koszt i korzyści związane z zakupem konkretnej konfiguracji paneli słonecznych przy określonym zużyciu energii elektrycznej.
| Zapis JSON |
|---|
{ "outOfPocketCost": { object ( |
| Pola | |
|---|---|
outOfPocketCost |
Koszt początkowy przed uwzględnieniem ulg podatkowych: kwota, którą należy zapłacić z własnej kieszeni. W przeciwieństwie do |
upfrontCost |
Koszt początkowy po uwzględnieniu ulg podatkowych: jest to kwota, którą należy zapłacić w pierwszym roku. W przeciwieństwie do |
rebateValue |
Wartość wszystkich zwrotów podatku. |
savings |
Ile zostało zaoszczędzone (lub nie) w całym okresie. |
paybackYears |
Liczba lat do zwrotu z inwestycji. Wartość ujemna oznacza, że zwrot nigdy nie nastąpi w okresie życia produktu. |
FinancedPurchaseSavings
Koszt i korzyści związane z zaciągnięciem pożyczki na zakup określonej konfiguracji paneli słonecznych przy określonym zużyciu energii elektrycznej.
| Zapis JSON |
|---|
{ "annualLoanPayment": { object ( |
| Pola | |
|---|---|
annualLoanPayment |
roczne spłaty kredytu, |
rebateValue |
Wartość wszystkich zwrotów podatku (w tym federalnego podatku inwestycyjnego). |
loanInterestRate |
Stopa oprocentowania kredytów przyjęta w tym zestawie obliczeń. |
savings |
Ile zostało zaoszczędzone (lub nie) w całym okresie. |