- Żądanie HTTP
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Pieniądze
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Wypróbuj
Znajduje najbliższy budynek do punktu zapytania. Zwraca błąd o kodze NOT_FOUND
, jeśli w odległości około 50 m od punktu zapytania nie ma żadnych budynków.
Żą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. |
required |
Opcjonalnie: Minimalny dozwolony poziom jakości w wynikach. Nie zostaną zwrócone żadne wyniki o niższej jakości. Nie podanie tej opcji jest równoznaczne z ograniczeniem do jakości WYSOKA. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Wiadomość z odpowiedzią dotyczącą Solar.FindClosestBuildingInsights
. informacje o lokalizacji, wymiarach i potencjale słonecznym 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. |
bounding |
Ramka ograniczająca budynku. |
imagery |
Data pozyskania obrazów. Jest to wartość przybliżona. |
imagery |
Data zakończenia przetwarzania tych obrazów. |
postal |
Kod pocztowy (np. kod pocztowy (np. amerykański kod pocztowy) budynku, w którym znajduje się budynek. |
administrative |
Obszar administracyjny 1 (np. stan w Stanach Zjednoczonych), w którym znajduje się budynek. Na przykład w Stanach Zjednoczonych może to być „MA” lub „CA”. |
statistical |
Obszar statystyczny (np. (US Census Tract) budynku, w którym się znajduje. |
region |
Kod regionu kraju (lub regionu), w którym znajduje się budynek. |
solar |
Potencjał paneli słonecznych w budynku. |
imagery |
Jakość zdjęć użytych do obliczenia danych dotyczących tego budynku. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
ramka ograniczająca w szerokości i długości geograficznej,
Zapis JSON |
---|
{ "sw": { object ( |
Pola | |
---|---|
sw |
Południowo-zachodni róg pudełka. |
ne |
Północno-wschodni róg pudełka. |
SolarPotential
Informacje o potencjale budynku w zakresie wykorzystania energii słonecznej. Niektóre pola są zdefiniowane w terminach „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 | |
---|---|
max |
Rozmiar maksymalnego modułu – czyli maksymalna liczba paneli, które mieszczą się na dachu. |
panel |
Pojemność panelu w watach użyta w obliczeniach. |
panel |
Wysokość panelu używanego w obliczeniach w orientacji pionowej w metrach. |
panel |
Szerokość panelu używanego w obliczeniach w orientacji pionowej w metrach. |
panel |
Przewidywana długość życia paneli słonecznych w latach. Jest on używany w obliczeniach finansowych. |
max |
Maksymalny rozmiar tablicy w metrach kwadratowych. |
max |
Maksymalna liczba godzin nasłonecznienia w roku w dowolnym punkcie dachu. Liczba godzin nasłonecznienia to wskaźnik łącznej ilości energii słonecznej w danym roku. 1 godzina nasłonecznienia = 1 kWh na kW (gdzie kW odnosi się do mocy w standardowych warunkach testowych). |
carbon |
Równoważna ilość CO2 wytworzona na MWh energii elektrycznej z sieci. Jest to miara emisji CO2 z elektroenergetyki sieciowej zastąpionej przez energię słoneczną. |
whole |
Łączny rozmiar i kwantile nasłonecznienia dla części dachu przypisanej do danego segmentu dachu. Mimo nazwy może nie obejmować całego budynku. Zobacz |
building |
Rozmiary i wartości kwantyli nasłonecznienia dla całego budynku, w tym części dachu, które nie zostały przypisane do żadnego segmentu dachu. Ponieważ orientacja tych części nie jest dobrze określona, 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 |
roof |
Kwantyle wielkości i nasłonecznienia dla każdego segmentu dachu. |
solar |
Każdy element |
solar |
Każdy element |
financial |
|
SizeAndSunshineStats
wielkość i ilość słońca na dachu lub jego części;
Zapis JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Pola | |
---|---|
area |
Powierzchnia dachu lub jego segmentu w m2. Jest to powierzchnia dachu (uwzględniająca nachylenie), a nie powierzchnia styku z podłożem. |
sunshine |
Kwantyle nasłonecznienia w przypadku poszczególnych punktów na obszarze. Jeśli jest tu N wartości, oznacza to, że są to iły (N-1). 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. |
ground |
Powierzchnia rzutu poziomego pokryta przez dach lub jego segment w m2. |
RoofSegmentSizeAndSunshineStats
Informacje o rozmiarze i wartościach kwantyli nasłonecznienia segmentu dachu.
Zapis JSON |
---|
{ "stats": { object ( |
Pola | |
---|---|
stats |
Łączny rozmiar i kwantyle nasłonecznienia dla segmentu dachu. |
center |
Punkt w pobliżu środka segmentu dachu. |
bounding |
Ramka ograniczająca segmentu dachu. |
pitch |
Kąt nachylenia dachu względem teoretycznej płaszczyzny poziomej. 0 = równolegle do podłoża, 90 = prostopadle do podłoża. |
azimuth |
Kierunek kompasu, w którym skierowany jest dach. 0 = północ, 90 = wschód, 180 = południe. W przypadku „płaskiego” segmentu dachu ( |
plane |
Wysokość płaszczyzny segmentu dachu w metrach nad poziomem morza w punkcie oznaczonym jako |
SolarPanel
SolarPanel opisuje położenie, orientację i produkcję pojedynczego panelu słonecznego. Informacje o parametrach panelu znajdziesz w polu panelHeightMeters
, panelWidthMeters
i panelCapacityWatts
w pliku SolarPotential
.
Zapis JSON |
---|
{ "center": { object ( |
Pola | |
---|---|
center |
środek panelu, |
orientation |
Orientacja panelu. |
yearly |
Ile energii słonecznej gromadzi ta konfiguracja w ciągu roku (w DC kWh). |
segment |
Indeks w |
SolarPanelOrientation
Orientacja panelu słonecznego. Należy go interpretować w stosunku do azymutu segmentu dachu, na którym znajduje się panel.
Wartości w polu enum | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Nieznana orientacja panelu. |
LANDSCAPE |
Długa krawędź panelu LANDSCAPE jest prostopadła do kierunku azymutalnego segmentu dachu, na którym jest umieszczony. |
PORTRAIT |
Długa krawędź panelu PORTRAIT jest równoległa do kierunku azymutalnego segmentu dachu, na którym jest umieszczony. |
SolarPanelConfig
SolarPanelConfig opisuje konkretne umieszczenie paneli słonecznych na dachu.
Zapis JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Pola | |
---|---|
panels |
Łączna liczba paneli. Pamiętaj, że to pole jest zbędne, ponieważ odpowiada sumie odpowiednich pól w tabeli |
yearly |
Ile energii słonecznej gromadzi ta konfiguracja w ciągu roku (w kWh DC) przy założeniu, że panele są takie jak opisane powyżej. |
roof |
Informacje o produkcji każdego segmentu dachu, który zawiera co najmniej 1 panel w tym układzie. |
RoofSegmentSummary
Informacje o danym fragmencie dachu budynku z określoną liczbą paneli.
Zapis JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Pola | |
---|---|
panels |
Łączna liczba paneli w tym segmencie. |
yearly |
Ile energii słonecznej w kWh DC przechwytuje ta część układu w ciągu roku, przy założeniu, że panele są takie jak opisane powyżej. |
pitch |
Kąt nachylenia dachu względem teoretycznej płaszczyzny poziomej. 0 = równolegle do podłoża, 90 = prostopadle do podłoża. |
azimuth |
Kierunek kompasu, w którym skierowany jest dach. 0 = północ, 90 = wschód, 180 = południe. W przypadku „płaskiego” segmentu dachu ( |
segment |
Indeks w |
FinancialAnalysis
Analiza kosztów i korzyści z optymalnego rozmieszczenia paneli słonecznych w przypadku konkretnej wysokości rachunku za prąd.
Zapis JSON |
---|
{ "monthlyBill": { object ( |
Pola | |
---|---|
monthly |
Miesięczny rachunek za prąd, który jest brany pod uwagę w ramach tej analizy. |
default |
Określa, czy jest to rachunek wybrany jako domyślny rachunek dla obszaru, na którym znajduje się budynek. Dokładnie 1 element |
average |
Ile energii zużywa dom w przeciętnym miesiącu na podstawie wysokości rachunku i lokalnych stawek za energię elektryczną. |
financial |
Informacje finansowe, które mają zastosowanie niezależnie od używanej metody finansowania. |
leasing |
Koszt i korzyści z wynajmu paneli słonecznych. |
cash |
Koszt i korzyść z zakupu paneli słonecznych za gotówkę. |
financed |
Koszty i korzyści z zakupu paneli słonecznych z finansowaniem. |
panel |
Indeks w |
Pieniądze
Reprezentuje kwotę pieniędzy z typu waluty.
Zapis JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Pola | |
---|---|
currency |
Trzyliterowy kod waluty zdefiniowany w normie ISO 4217. |
units |
Całkowita kwota. Jeśli na przykład |
nanos |
Liczba nano (10^-9) jednostek wartości. Wartość musi się mieścić w przedziale od -999 999 999 do +999 999 999. Jeśli |
FinancialDetails
Szczegóły analizy finansowej. Niektóre z tych informacji są już przechowywane na wyższych poziomach (np. koszty własne). Łączna kwota pieniędzy jest obliczana w całym okresie użytkowania zdefiniowanym w polu panelLifetimeYears
w kampanii SolarPotential
. Uwaga: koszt zakupu paneli jest podany w polu outOfPocketCost
w dokumentie CashPurchaseSavings
.
Zapis JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Pola | |
---|---|
initial |
Ile MWh prądu zmiennego według nas wygenerują panele słoneczne w pierwszym roku. |
remaining |
Rachunek za dostawę energii elektrycznej, która nie jest produkowana przez panele słoneczne, za okres użytkowania paneli. |
federal |
Kwota środków dostępna z federalnych zachęt; dotyczy to sytuacji, gdy użytkownik kupuje panele (z pożyczką lub bez niej). |
state |
kwota środków dostępnych z dofinansowania państwowego; dotyczy to sytuacji, gdy użytkownik kupuje panele (z pożyczką lub bez niej). |
utility |
Kwota środków dostępna z zachęt do oszczędzania energii; dotyczy to sytuacji, gdy użytkownik kupuje panele (z pożyczką lub bez niej). |
lifetime |
Kwota pieniędzy, jaką użytkownik otrzyma z tytułu Odnawialnych źródeł energii słonecznej w ciągu całego okresu użytkowania panelu; dotyczy to sytuacji, gdy użytkownik kupuje panele (z pożyczką lub bez niej). |
cost |
Łączny koszt energii elektrycznej, jaki użytkownik musiałby zapłacić w całym okresie użytkowania, gdyby nie zainstalował paneli słonecznych. |
net |
Czy rozliczenie net-metering jest dozwolone. |
solar |
Odsetek (0–100) energii elektrycznej dostarczanej użytkownikowi przez panele słoneczne. Ważne w przypadku pierwszego roku, ale przybliżone w przypadku kolejnych lat. |
percentage |
Odsetek (0–100) produkcji energii słonecznej, 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
Koszty i korzyści z wynajmu określonej konfiguracji paneli słonecznych przy określonym zużyciu energii.
Zapis JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Pola | |
---|---|
leases |
Czy umowa najmu jest dozwolona w danym kraju (w niektórych stanach umowy najmu są niedozwolone). Jeśli to pole ma ustawioną wartość fałsz, wartości w tym komunikacie powinny być zignorowane. |
leases |
Określa, czy w danym kraju/regionie wynajem jest obsługiwany przez mechanizm obliczania finansowego. Jeśli to pole ma ustawioną wartość fałsz, wartości w tym komunikacie powinny być zignorowane. Nie ma to nic wspólnego z modelami finansowymi: w niektórych regionach leasing jest dozwolony, ale pod warunkami, które nie są obsługiwane przez modele finansowe. |
annual |
Szacowany roczny koszt leasingu. |
savings |
Ile oszczędza się (lub nie) w okresie życia. |
SavingsOverTime
informacje finansowe, które są udostępniane między różnymi metodami finansowania;
Zapis JSON |
---|
{ "savingsYear1": { object ( |
Pola | |
---|---|
savings |
Oszczędności w pierwszym roku po zainstalowaniu panelu. |
savings |
Oszczędności w ciągu pierwszych 20 lat od zainstalowania panelu. |
present |
Korzystając z założonej stopy dyskonta, jaka jest wartość bieżąca oszczędności kumulatywnych na przestrzeni 20 lat? |
savings |
Oszczędności w całym okresie działania panelu. |
present |
Korzystając z założonej stopy dyskonta, jaka jest bieżąca wartość skumulowanych oszczędności na całe życie? |
financially |
Wskazuje, czy ten scenariusz jest opłacalny. Wartość false w przypadku scenariuszy o słabej rentowności finansowej (np. przynoszących straty). |
CashPurchaseSavings
Koszt i korzyść z bezpośredniego zakupu określonej konfiguracji paneli słonecznych przy określonym zużyciu energii.
Zapis JSON |
---|
{ "outOfPocketCost": { object ( |
Pola | |
---|---|
out |
Początkowy koszt przed zachętami podatkowymi: kwota, którą należy zapłacić z własnych środków. W przeciwieństwie do |
upfront |
Początkowy koszt po uwzględnieniu ulg podatkowych: jest to kwota, którą należy zapłacić w pierwszym roku. Porównaj to z wartością |
rebate |
Wartość wszystkich zwrotów podatku. |
savings |
Ile oszczędza się (lub nie) w okresie życia. |
payback |
Liczba lat do zwrotu kosztów. Wartość ujemna oznacza, że zwrot nigdy nie występuje w okresie życia. |
FinancedPurchaseSavings
Koszty i korzyści z kredytu na zakup określonej konfiguracji paneli słonecznych przy określonym zużyciu energii.
Zapis JSON |
---|
{ "annualLoanPayment": { object ( |
Pola | |
---|---|
annual |
roczne spłaty kredytu, |
rebate |
wartość wszystkich ulg podatkowych (w tym federalnego kredytu inwestycyjnego). |
loan |
Oprocentowanie kredytów przyjęte w tym zestawie obliczeń. |
savings |
Ile oszczędza się (lub nie) w okresie życia. |