Indeks
Solar(interfejs)BuildingInsights(komunikat)CashPurchaseSavings(komunikat)DataLayerView(wyliczenie)DataLayers(komunikat)FinancedPurchaseSavings(komunikat)FinancialAnalysis(komunikat)FinancialDetails(komunikat)FindClosestBuildingInsightsRequest(komunikat)GetDataLayersRequest(komunikat)GetGeoTiffRequest(komunikat)ImageryQuality(wyliczenie)LatLngBox(komunikat)LeasingSavings(komunikat)RoofSegmentSizeAndSunshineStats(komunikat)RoofSegmentSummary(komunikat)SavingsOverTime(komunikat)SizeAndSunshineStats(komunikat)SolarPanel(komunikat)SolarPanelConfig(komunikat)SolarPanelOrientation(wyliczenie)SolarPotential(komunikat)
Panele słoneczne
Definicja usługi dla interfejsu Solar API.
| FindClosestBuildingInsights |
|---|
|
Znajduje budynek, którego centroid jest najbliżej punktu zapytania. Zwraca błąd o kodze
|
| GetDataLayers |
|---|
|
Pobiera informacje o energii słonecznej dla regionu otaczającego lokalizację. Zwraca błąd o kodze
|
| GetGeoTiff |
|---|
|
Zwraca obraz według jego identyfikatora.
|
BuildingInsights
Odpowiedź na pytanie „Solar.FindClosestBuildingInsights”. Informacje o lokalizacji, wymiarach i potencjale słonecznym budynku.
| Pola | |
|---|---|
name |
Nazwa zasobu budynku w formacie |
center |
Punkt w pobliżu środka budynku. |
bounding_box |
Ramka ograniczająca budynku. |
imagery_date |
Data pozyskania obrazów. Jest to wartość przybliżona. |
imagery_processed_date |
Data zakończenia przetwarzania tych obrazów. |
postal_code |
Kod pocztowy (np. kod pocztowy (np. amerykański kod pocztowy) budynku, w którym znajduje się budynek. |
administrative_area |
Obszar administracyjny 1 (np. stan w Stanach Zjednoczonych), w którym znajduje się budynek. Na przykład w Stanach Zjednoczonych skrót może brzmieć „MA” lub „CA”. |
statistical_area |
Obszar statystyczny (np. okręgu spisowym w Stanach Zjednoczonych, w którym znajduje się budynek. |
region_code |
Kod regionu kraju (lub regionu), w którym znajduje się budynek. |
solar_potential |
Potencjał paneli słonecznych w budynku. |
imagery_quality |
Jakość zdjęć użytych do obliczenia danych dotyczących tego budynku. |
CashPurchaseSavings
Koszt i korzyść z bezpośredniego zakupu konkretnej konfiguracji paneli słonecznych przy określonym zużyciu energii.
| Pola | |
|---|---|
out_of_pocket_cost |
Początkowy koszt przed zachętami podatkowymi: kwota, którą należy zapłacić z własnych środków. W przeciwieństwie do |
upfront_cost |
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_value |
Wartość wszystkich zwrotów podatku. |
savings |
Ile oszczędza się (lub nie) w okresie życia. |
payback_years |
Liczba lat do zwrotu kosztów. Wartość ujemna oznacza, że zwrot nigdy nie występuje w okresie życia. |
DataLayerView
Podzbiór informacji o słonecznej, który ma zostać zwrócony.
| Wartości w polu enum | |
|---|---|
DATA_LAYER_VIEW_UNSPECIFIED |
Odpowiednik opcji FULL. |
DSM_LAYER |
Pobierz tylko DSM. |
IMAGERY_LAYERS |
Pobierz DSM, RGB i maskę. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
DSM, RGB, maska i roczny flux. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Uzyskaj dane DSM, RGB, maski, roczny i miesięczny. |
FULL_LAYERS |
Pobierz wszystkie dane. |
DataLayers
Informacje o potencjale słonecznym regionu. Rzeczywiste dane znajdują się w licznych plikach GeoTIFF obejmujących żądany region. Wiadomość zawiera adresy URL tych plików: każdy ciąg znaków w wiadomości DataLayers zawiera adres URL, z którego można pobrać odpowiedni plik GeoTIFF. Te adresy URL są ważne przez kilka godzin po wygenerowaniu. Większość plików GeoTIFF ma rozdzielczość 0,1 m/piksel, ale plik z miesięcznym strumieniem ma rozdzielczość 0,5 m/piksel, a pliki z godzinnym strumieniem mają rozdzielczość 1 m/piksel. Jeśli w pliku GetDataLayersRequest podana jest wartość pixel_size_meters, to minimalna rozdzielczość w plikach GeoTIFF będzie równa tej wartości.
| Pola | |
|---|---|
imagery_date |
Kiedy zostały wykonane zdjęcia źródłowe (z których pochodzą wszystkie inne dane) w tym regionie. Jest to przybliżona wartość, ponieważ zdjęcia mogły zostać zrobione w ciągu kilku dni. |
imagery_processed_date |
Data zakończenia przetwarzania tych obrazów. |
dsm_url |
Adres URL obrazu DSM (cyfrowego modelu powierzchni) regionu. Wartości są podawane w metrach nad geoidem EGM96 (czyli nad poziomem morza). Nieprawidłowe lokalizacje (w których nie mamy danych) są przechowywane jako -9999. |
rgb_url |
Adres URL obrazu z danymi RGB (zdjęcie lotnicze) regionu. |
mask_url |
Adres URL obrazu maski budynku: 1 bit na piksel określający, czy dany piksel jest uważany za część dachu. |
annual_flux_url |
Adres URL mapy rocznego natężenia (roczne nasłonecznienie dachów) w danym regionie. Wartości są podawane w kWh/kW/rok. Jest to niezamaskowany strumień: strumień jest obliczany dla każdej lokalizacji, a nie tylko dla dachów budynków. Nieprawidłowe lokalizacje są przechowywane jako -9999: lokalizacje poza obszarem obsługiwanym będą nieprawidłowe, a kilka lokalizacji w obszarze obsługiwanym, w których nie udało się obliczyć natężenia, również będą nieprawidłowe. |
monthly_flux_url |
Adres URL mapy miesięcznego natężenia (światło słoneczne na dachach, pogrupowane według miesięcy) w danym regionie. Wartości są podawane w kWh/kW/rok. Plik GeoTIFF, do którego odwołuje się ten adres URL, będzie zawierał 12 pasm odpowiadających kolejno styczniowi, lutym itd. |
hourly_shade_urls[] |
12 adresów URL odpowiadających wartościom godzinowym, które odpowiadają kolejno styczniowi, lutym itd. Każdy plik GeoTIFF będzie zawierać 24 pasma odpowiadające 24 godzinom w dobowej skali. Każdy piksel to 32-bitowa liczba całkowita odpowiadająca maksymalnie 31 dniom w danym miesiącu. 1 bit oznacza, że w danym dniu i godzinie w danym miesiącu w odpowiedniej lokalizacji jest widoczne słońce. Nieprawidłowe lokalizacje są przechowywane jako -9999 (ponieważ jest to wartość ujemna, ma ustawiony bit 31, a żadna prawidłowa wartość nie może mieć ustawionego bitu 31, ponieważ odpowiadałby on 32 dniowi miesiąca). Możesz skorzystać z przykładu. Jeśli chcesz się dowiedzieć, czy punkt (w usytuowaniu piksela (x, y)) był oświetlony przez słońce 22 czerwca o 16:00, wykonaj te czynności:
Bardziej formalnie: dla gdzie |
imagery_quality |
jakość obrazów w wyniku. |
FinancedPurchaseSavings
Koszty i korzyści z kredytu na zakup określonej konfiguracji paneli słonecznych z uwzględnieniem konkretnego zużycia energii.
| Pola | |
|---|---|
annual_loan_payment |
Roczne spłaty kredytu. |
rebate_value |
wartość wszystkich ulg podatkowych (w tym federalnego kredytu inwestycyjnego). |
loan_interest_rate |
Odsetki od kredytów przyjęte w tym zestawie obliczeń. |
savings |
Ile oszczędza się (lub nie) w okresie życia. |
FinancialAnalysis
Analiza kosztów i korzyści z optymalnego rozmieszczenia paneli słonecznych w przypadku konkretnej wielkości rachunku za prąd.
| Pola | |
|---|---|
monthly_bill |
Miesięczny rachunek za prąd, który jest brany pod uwagę w ramach tej analizy. |
default_bill |
Określa, czy jest to rachunek wybrany jako domyślny rachunek dla obszaru, na którym znajduje się budynek. Dokładnie 1 element |
average_kwh_per_month |
Ile energii zużywa dom w przeciętnym miesiącu na podstawie wysokości rachunku i lokalnych stawek za energię elektryczną. |
financial_details |
Informacje finansowe, które mają zastosowanie niezależnie od używanej metody finansowania. |
leasing_savings |
Koszt i korzyści z wynajmu paneli słonecznych. |
cash_purchase_savings |
Koszt i korzyści z zakupu paneli słonecznych za gotówkę. |
financed_purchase_savings |
Koszty i korzyści z zakupu paneli słonecznych z finansowaniem. |
panel_config_index |
Indeks w |
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 panel_lifetime_years w kampanii SolarPotential. Uwaga: koszt zakupu paneli jest podany w polu out_of_pocket_cost w dokumentie CashPurchaseSavings.
| Pola | |
|---|---|
initial_ac_kwh_per_year |
Ile energii w kWh AC według nas wygenerują panele słoneczne w pierwszym roku. |
remaining_lifetime_utility_bill |
Rachunek za dostawę energii elektrycznej, która nie jest produkowana przez panele słoneczne, za okres użytkowania paneli. |
federal_incentive |
Kwota środków dostępna z federalnych zachęt; dotyczy to sytuacji, gdy użytkownik kupuje panele (z pożyczką lub bez niej). |
state_incentive |
Kwota środków dostępnych z dofinansowania państwowego; dotyczy to sytuacji, gdy użytkownik kupuje panele (z pożyczką lub bez niej). |
utility_incentive |
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_srec_total |
Kwota pieniędzy, jaką użytkownik otrzyma z tytułu Odnawialnych źródeł energii ze słońca w trakcie trwania panelu; dotyczy to sytuacji, gdy użytkownik kupuje panele (z pożyczką lub bez niej). |
cost_of_electricity_without_solar |
Łączny koszt energii elektrycznej, jaki użytkownik musiałby zapłacić w całym okresie użytkowania, gdyby nie zainstalował paneli słonecznych. |
net_metering_allowed |
Czy rozliczenie net-metering jest dozwolone. |
solar_percentage |
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_exported_to_grid |
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. |
FindClosestBuildingInsightsRequest
Żądanie wiadomości dla Solar.FindClosestBuildingInsights.
| Pola | |
|---|---|
location |
Wymagany. Długość i szerokokość geograficzna, na podstawie których interfejs API wyszukuje najbliższy znany budynek. |
required_quality |
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. |
GetDataLayersRequest
Żądanie wiadomości dla Solar.GetDataLayers.
| Pola | |
|---|---|
location |
Wymagany. Długość i szerokokość geograficzna centrum regionu, z którego mają pochodzić dane. |
radius_meters |
Wymagany. Promień (w metrach) określający obszar wokół punktu centralnego, z którego mają zostać zwrócone dane. Ograniczenia dotyczące tej wartości:
|
view |
Opcjonalnie: Wybrany podzbiór danych do zwrócenia. |
required_quality |
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. |
pixel_size_meters |
Opcjonalnie: Minimalna skala (w metrach na piksel) danych, które mają zostać zwrócone. Obsługiwane są wartości 0,1 (wartość domyślna, jeśli to pole nie zostanie określone), 0,25, 0,5 i 1,0. Komponenty z obrazem, których normalna rozdzielczość jest mniejsza niż |
exact_quality_required |
Opcjonalnie: Określa, czy wymagana jest dokładna jakość obrazów. Jeśli ustawisz wartość false, pole |
GetGeoTiffRequest
Żądanie wiadomości dla Solar.GetGeoTiff.
| Pola | |
|---|---|
id |
Wymagany. Identyfikator zasobu, którego dotyczy żądanie. |
ImageryQuality
Jakość obrazów użytych do obliczenia niektórych wyników interfejsu API.
Uwaga: niezależnie od poziomu jakości obrazów, dane DSM mają zawsze rozdzielczość 0,1 m/piksel, dane o miesięcznym natężeniu promieniowania mają zawsze rozdzielczość 0,5 m/piksel, a dane o cieni w godzinnych interwałach mają zawsze rozdzielczość 1 m/piksel.
| Wartości w polu enum | |
|---|---|
IMAGERY_QUALITY_UNSPECIFIED |
Nie wiadomo, jaka jest jakość. |
HIGH |
Dane dotyczące słońca pochodzą ze zdjęć z lotu wykonanych na niskiej wysokości i przetworzonych z rozdzielczości 0,1 m/piksel. |
MEDIUM |
Dane dotyczące energii słonecznej pochodzą ze zdjęć lotniczych o ulepszonej rozdzielczości, wykonanych na dużych wysokościach i przetworzonych z rozdzielczości 0,25 m/piksel. |
LOW |
Dane dotyczące energii słonecznej pochodzą z ulepszonych zdjęć satelitarnych przetworzonych z wysoką rozdzielczością 0,25 m/piksel. |
BASE |
Dane dotyczące energii słonecznej pochodzą z ulepszonych zdjęć satelitarnych przetworzonych z wysoką rozdzielczością 0,25 m/piksel. |
LatLngBox
ramka ograniczająca w szerokości i długości geograficznej,
LeasingSavings
Koszty i korzyści z wynajmu określonej konfiguracji paneli słonecznych przy określonym zużyciu energii.
| Pola | |
|---|---|
leases_allowed |
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ć ignorowane. |
leases_supported |
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ć ignorowane. 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_leasing_cost |
Szacowany roczny koszt leasingu. |
savings |
Ile oszczędza się (lub nie) w okresie życia. |
RoofSegmentSizeAndSunshineStats
Informacje o rozmiarze i procentach nasłonecznienia w przypadku segmentu dachu.
| Pola | |
|---|---|
stats |
Łączny rozmiar i kwantyle nasłonecznienia dla segmentu dachu. |
center |
Punkt w pobliżu środka segmentu dachu. |
bounding_box |
Ramka ograniczająca segmentu dachu. |
pitch_degrees |
Kąt nachylenia dachu względem teoretycznej płaszczyzny poziomej. 0 = równolegle do ziemi, 90 = prostopadle do ziemi. |
azimuth_degrees |
Kierunek kompasu, w którym skierowany jest dach. 0 = północ, 90 = wschód, 180 = południe. W przypadku „płaskiego” segmentu dachu ( |
plane_height_at_center_meters |
Wysokość płaszczyzny segmentu dachu w metrach nad poziomem morza w punkcie oznaczonym jako |
RoofSegmentSummary
Informacje o danym fragmencie dachu budynku z określoną liczbą paneli.
| Pola | |
|---|---|
panels_count |
Łączna liczba paneli w tym segmencie. |
yearly_energy_dc_kwh |
Ile energii słonecznej przechwytuje ta część układu w ciągu roku (w DC kWh) przy założeniu, że panele są takie, jak opisano powyżej. |
pitch_degrees |
Kąt nachylenia dachu względem teoretycznej płaszczyzny poziomej. 0 = równolegle do ziemi, 90 = prostopadle do ziemi. |
azimuth_degrees |
Kierunek kompasu, w którym skierowany jest dach. 0 = północ, 90 = wschód, 180 = południe. W przypadku „płaskiego” segmentu dachu ( |
segment_index |
Indeks w |
SavingsOverTime
informacje finansowe, które są udostępniane między różnymi metodami finansowania;
| Pola | |
|---|---|
savings_year1 |
Oszczędności w pierwszym roku po zainstalowaniu panelu. |
savings_year20 |
Oszczędności w ciągu pierwszych 20 lat od zainstalowania panelu. |
present_value_of_savings_year20 |
Korzystając z założonej stopy dyskonta, jaka jest wartość bieżąca oszczędności kumulatywnych przez 20 lat? |
savings_lifetime |
Oszczędności w całym okresie istnienia panelu. |
present_value_of_savings_lifetime |
Korzystając z założonej stopy dyskonta, jaka jest bieżąca wartość skumulowanych oszczędności na całe życie? |
financially_viable |
Wskazuje, czy ten scenariusz jest opłacalny. Wartość false w przypadku scenariuszy o słabej rentowności finansowej (np. przynoszących straty). |
SizeAndSunshineStats
wielkość i ilość słońca na dachu lub jego części;
| Pola | |
|---|---|
area_meters2 |
Powierzchnia dachu lub jego segmentu w m2. Jest to powierzchnia dachu (uwzględniająca nachylenie), a nie powierzchnia styku z podłożem. |
sunshine_quantiles[] |
Kwantyle nasłonecznienia w przypadku poszczególnych punktów na 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 (minimum, 25%, 50%, 75%, maksimum). Wartości są podawane w kWh/kW rocznie, np. |
ground_area_meters2 |
Powierzchnia rzutu poziomego pokryta przez dach lub jego segment w m2. |
SolarPanel
SolarPanel opisuje położenie, orientację i produkcję pojedynczego panelu słonecznego. Informacje o parametrach panelu znajdziesz w polach panel_height_meters, panel_width_meters i panel_capacity_watts w pliku SolarPotential.
| Pola | |
|---|---|
center |
środek panelu, |
orientation |
Orientacja panelu. |
yearly_energy_dc_kwh |
Ile energii słonecznej przechwyca ta konfiguracja w ciągu roku (w kWh DC). |
segment_index |
Indeks w |
SolarPanelConfig
SolarPanelConfig opisuje konkretne umieszczenie paneli słonecznych na dachu.
| Pola | |
|---|---|
panels_count |
Łączna liczba paneli. Pamiętaj, że to pole jest zbędne, ponieważ odpowiada sumie odpowiednich pól w tabeli |
yearly_energy_dc_kwh |
Ile energii słonecznej gromadzi to rozmieszczenie w ciągu roku (w kWh DC) przy założeniu, że panele są takie, jak opisane powyżej. |
roof_segment_summaries[] |
Informacje o produkcji każdego segmentu dachu, który zawiera co najmniej 1 panel w tym układzie. |
SolarPanelOrientation
Orientacja panelu słonecznego. Należy go interpretować w stosunku do azymutu segmentu dachu, na którym umieszczono 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. |
SolarPotential
Informacje o potencjale energetycznym budynku. Niektóre pola są zdefiniowane w terminach „paneli”. Pola panel_capacity_watts, panel_height_meters i panel_width_meters opisują parametry modelu panelu użytego w tych obliczeniach.
| Pola | |
|---|---|
max_array_panels_count |
Rozmiar maksymalnego modułu – czyli maksymalna liczba paneli, które mieszczą się na dachu. |
panel_capacity_watts |
Pojemność panelu w watach użytego w obliczeniach. |
panel_height_meters |
Wysokość w metrach w orientacji pionowej panelu użytego w obliczeniach. |
panel_width_meters |
Szerokość panelu używanego w obliczeniach w orientacji pionowej w metrach. |
panel_lifetime_years |
Przewidywana długość życia paneli słonecznych w latach. Jest on używany w obliczeniach finansowych. |
max_array_area_meters2 |
Maksymalny rozmiar tablicy w metrach kwadratowych. |
max_sunshine_hours_per_year |
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_offset_factor_kg_per_mwh |
Równoważna ilość CO2 wytworzona na MWh energii elektrycznej z sieci. Jest to wskaźnik emisyjności CO2 energii elektrycznej z sieci zastąpionej przez energię słoneczną. |
whole_roof_stats |
Łą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_stats |
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_segment_stats[] |
Kwantyle wielkości i nasłonecznienia dla każdego segmentu dachu. |
solar_panels[] |
Każdy element |
solar_panel_configs[] |
Każdy element |
financial_analyses[] |
|