- Żą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 budynek najbliżej punktu zapytania. Zwraca błąd z kodem NOT_FOUND
, jeśli w promieniu około 50 m od punktu zapytania nie ma budynków.
Żądanie HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
location |
To pole jest wymagane. Długość i szerokość geograficzna, od której interfejs API szuka najbliższego znanego budynku. |
requiredQuality |
Opcjonalnie. Minimalny poziom jakości dozwolony w wynikach. Nie zostaną zwrócone żadne wyniki o niższej jakości. Brak określenia tego ustawienia jest odpowiednikiem ograniczenia tylko do WYSOKIEJ jakości. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź na pytanie: Solar.FindClosestBuildingInsights
. Informacje o położeniu, 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. |
boundingBox |
Ramka ograniczająca budynku. |
imageryDate |
Data pozyskania zdjęć podstawowych. Podana wartość jest szacunkowa. |
imageryProcessedDate |
Po zakończeniu przetwarzania tego zdjęcia. |
postalCode |
Kod pocztowy (np. Kod pocztowy (USA), w którym znajduje się ten budynek. |
administrativeArea |
Obszar administracyjny 1 (np. w Stanach Zjednoczonych, stan), na którym znajduje się ten budynek. Na przykład w Stanach Zjednoczonych skrótem może być „MA” lub „CA”. |
statisticalArea |
Obszar statystyczny (np. spisu ludności Stanów Zjednoczonych), w którym znajduje się ten budynek. |
regionCode |
Kod regionu kraju (lub regionu), w którym znajduje się ten budynek. |
solarPotential |
Potencjał energetyczny 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 szerokości/długości geograficznej.
Zapis JSON |
---|
{ "sw": { object ( |
Pola | |
---|---|
sw |
Południowo-zachodni róg pola. |
ne |
Północno-wschodni róg pola. |
SolarPotential
Informacje o potencjale słonecznym budynku. Wiele takich pól jest zdefiniowanych w postaci „paneli”. Pola panelCapacityWatts
, panelHeightMeters
i panelWidthMeters
opisują parametry modelu panelu używanego 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 można zmieścić na dachu. |
panelCapacityWatts |
Pojemność panelu użytego w obliczeniach (w watach). |
panelHeightMeters |
Wysokość panelu używanego w obliczeniach (w metrach w orientacji pionowej). |
panelWidthMeters |
Szerokość panelu używanego w obliczeniach (w metrach w orientacji pionowej). |
panelLifetimeYears |
Przewidywany czas pracy paneli słonecznych w latach. Jest ona używana w obliczeniach finansowych. |
maxArrayAreaMeters2 |
Rozmiar maksymalnej tablicy w metrach kwadratowych. |
maxSunshineHoursPerYear |
Maksymalna liczba godzin słońca w roku w dowolnym punkcie na dachu. Godziny słońca to miara łącznej ilości izolacji (energii) uzyskiwanej w ciągu roku. 1 godzina słońca = 1 kWh na kW (gdzie kW oznacza kW mocy obliczeniowej w standardowych warunkach testowania). |
carbonOffsetFactorKgPerMwh |
Równoważna ilość CO2 wyprodukowanego na MWh energii elektrycznej. Jest to wskaźnik emisji dwutlenku węgla z energii elektrycznej wymieszczonej przez energię słoneczną. |
wholeRoofStats |
Łączny rozmiar i kwantyle światła słonecznego dla części dachu, która została przypisana do jakiegoś segmentu dachu. Wbrew nazwie może to nie obejmować całego budynku. Zobacz |
buildingStats |
Rozmiar i kwantyle światła słonecznego dla całego budynku, w tym jego fragmentów, które nie zostały przypisane do niektórych segmentów dachów. Ze względu na to, że orientacja tych części nie jest dobrze scharakteryzowana, oszacowanie powierzchni dachu jest nierzetelne, ale szacowanie powierzchni gruntu jest wiarygodne. Bardziej miarodajną powierzchnię dachów może uzyskać, skalując powierzchnię dachu z |
roofSegmentStats[] |
Rozmiar i kwantyle światła słonecznego dla każdego segmentu dachów. |
solarPanels[] |
Każdy element |
solarPanelConfigs[] |
Każdy element |
financialAnalyses[] |
|
SizeAndSunshineStats
Rozmiar i kwantyle słonecznego dachu lub jego części.
Zapis JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Pola | |
---|---|
areaMeters2 |
Powierzchnia segmentu dachu lub dachu w m^2. Jest to powierzchnia dachu (uwzględniająca przechylenie), a nie powierzchnia gruntu. |
sunshineQuantiles[] |
Kwantyle punktowego słońca w całym obszarze. Jeśli występują tu wartości N, oznacza to ilorazy (N-1). Jeśli np. dostępnych jest 5 wartości, będą to kwartyle (min., 25%, 50%, 75%, maksimum). Wartości są podawane w rocznych kWh/kW, np. |
groundAreaMeters2 |
Powierzchnia podstawy terenu pokryta segmentem dachu lub dachu, w m^2. |
RoofSegmentSizeAndSunshineStats
Informacje o rozmiarze i kwantylach słonecznych segmentu dachów.
Zapis JSON |
---|
{ "stats": { object ( |
Pola | |
---|---|
stats |
Łączny rozmiar i kwantyle światła słonecznego dla segmentu dachów. |
center |
Punkt w pobliżu środka segmentu dachu. |
boundingBox |
Ramka ograniczająca segmentu dachu. |
pitchDegrees |
Kąt segmentu dachu względem teoretycznej płaszczyzny podłoża. 0 = równoległe do ziemi, 90 = prostopadłe do ziemi. |
azimuthDegrees |
Kierunek kompasu, na który wskazuje segment dachu. 0 = północ, 90 = wschód, 180 = południe. W przypadku „płaskiego” segmentu dachów ( |
planeHeightAtCenterMeters |
Wysokość płaszczyzny segmentu dachu (w metrach nad poziomem morza) w punkcie wskazanym przez |
SolarPanel
Panel SolarPanel opisuje położenie, orientację i produkcję pojedynczego panelu słonecznego. Informacje o parametrach panelu znajdziesz w polach panelHeightMeters
, panelWidthMeters
i panelCapacityWatts
w narzędziu SolarPotential
.
Zapis JSON |
---|
{ "center": { object ( |
Pola | |
---|---|
center |
Środek panelu. |
orientation |
Orientacja panelu. |
yearlyEnergyDcKwh |
Ile energii słonecznej w kWh (prąd stały) przechwytuje ten układ w ciągu roku. |
segmentIndex |
Indeks w |
SolarPanelOrientation
Orientacja panelu słonecznego. Należy to interpretować względem azymutu segmentu dachu, na którym jest umieszczony panel.
Wartości w polu enum | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Orientacja panelu nie jest znana. |
LANDSCAPE |
Panel LANDSCAPE ma długą krawędź prostopadłą do kierunku azymutu segmentu dachu, na którym jest umieszczony. |
PORTRAIT |
Panel PORTRAIT ma długą krawędź równoległą do kierunku azymutu segmentu dachu, na którym jest umieszczony. |
SolarPanelConfig
Panel SolarPanelConfig opisuje konkretne umiejscowienie paneli słonecznych na dachu.
Zapis JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Pola | |
---|---|
panelsCount |
Łączna liczba paneli. Pamiętaj, że jest to zbędne w odniesieniu do (sumy) odpowiednich pól w zasadzie |
yearlyEnergyDcKwh |
Ile energii słonecznej przechwytywanej przez ten układ w ciągu roku (w kWh prądu stałego) przy założeniu, że panele opisane powyżej są opisane. |
roofSegmentSummaries[] |
Informacje o produkcji każdego segmentu dachów, który jest wyposażony w co najmniej jeden panel w tym układzie. |
RoofSegmentSummary
Informacje o segmencie dachu budynku, na którym umieszczono pewną liczbę 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 przechwytuje ten element układu w ciągu roku (w kWh prądu stałego) przy założeniu, że panele opisane powyżej są opisane powyżej. |
pitchDegrees |
Kąt segmentu dachu względem teoretycznej płaszczyzny podłoża. 0 = równoległe do ziemi, 90 = prostopadłe do ziemi. |
azimuthDegrees |
Kierunek kompasu, na który wskazuje segment dachu. 0 = północ, 90 = wschód, 180 = południe. W przypadku „płaskiego” segmentu dachów ( |
segmentIndex |
Indeksuj w |
FinancialAnalysis
Analiza kosztów i korzyści związanych z optymalnym układem fotowoltaicznym przy danym rachunku za prąd.
Zapis JSON |
---|
{ "monthlyBill": { object ( |
Pola | |
---|---|
monthlyBill |
Miesięczny rachunek za prąd zakładany przez tę analizę. |
defaultBill |
Określa, czy jest to rozmiar rachunku wybrany jako domyślny rachunek za obszar, w którym znajduje się ten budynek. Dokładnie jeden element |
averageKwhPerMonth |
Ile energii elektrycznej zużywa dom w średnim miesiącu na podstawie wysokości rachunku i lokalnych stawek za prąd. |
financialDetails |
Informacje finansowe mające zastosowanie niezależnie od użytej metody finansowania. |
leasingSavings |
Koszt i korzyści związane z dzierżawą paneli słonecznych. |
cashPurchaseSavings |
Koszt i korzyści związane z kupowaniem paneli słonecznych za gotówkę. |
financedPurchaseSavings |
Koszt i korzyści związane z zakupem paneli słonecznych w ramach finansowania zakupu. |
panelConfigIndex |
Indeks w |
Pieniądze
Reprezentuje kwotę pieniędzy z typem waluty.
Zapis JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Pola | |
---|---|
currencyCode |
Trzyliterowy kod waluty zgodny z normą ISO 4217. |
units |
Całkowite jednostki kwoty. Jeśli np. |
nanos |
Liczba nano (10^-9) jednostek danej ilości. Wartość musi mieścić się w przedziale od -999 999 999 do +999 999 999 włącznie. Jeśli |
FinancialDetails
Szczegóły analizy finansowej. Niektóre z tych informacji są już przechowywane na wyższych poziomach (np. z własnej kieszeni). Łączne kwoty są podawane w okresie zdefiniowanym w polu panelLifetimeYears
w narzędziu SolarPotential
. Uwaga: koszt zakupu paneli z własnej kieszeni jest podany w polu outOfPocketCost
w tabeli CashPurchaseSavings
.
Zapis JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Pola | |
---|---|
initialAcKwhPerYear |
Ile kWh prądu zmiennego naszym zdaniem wygenerują panele słoneczne w pierwszym roku. |
remainingLifetimeUtilityBill |
Rachunek za media za energię elektryczną niewygenerowaną przez panel słoneczny, za cały okres eksploatacji paneli. |
federalIncentive |
Kwota środków dostępnych w ramach grantów federalnych; dotyczy to sytuacji, w których użytkownik kupuje panele (z pożyczką lub bez). |
stateIncentive |
Kwota środków dostępnych w programach publicznych. Ma to zastosowanie, jeśli użytkownik kupuje panele (z pożyczką lub bez). |
utilityIncentive |
Kwota środków dostępnych w programie zachęt za korzystanie z usług komunalnych; dotyczy to sytuacji, gdy użytkownik kupuje panele (z pożyczką lub bez). |
lifetimeSrecTotal |
Kwota, jaką użytkownik otrzyma w ramach kredytów związanych z odnawialną energią słoneczną w całym cyklu życia panelu; dotyczy to sytuacji, w których użytkownik kupi panele (z kredytem lub bez). |
costOfElectricityWithoutSolar |
Całkowity koszt energii elektrycznej, który użytkownik poniósłby w całym okresie, gdyby nie zainstalował instalacji fotowoltaicznych. |
netMeteringAllowed |
Określa, czy dozwolony jest pomiar sieci. |
solarPercentage |
Procent (0–100) energii dostarczonej przez użytkownika z energii słonecznej. Ważna przez pierwszy rok, ale mniej więcej poprawna w przypadku przyszłych lat. |
percentageExportedToGrid |
Przyjęliśmy, że wartość procentowa (0–100) produkcji energii słonecznej, którą zakładaliśmy, była eksportowana do sieci na podstawie pierwszego kwartału produkcji. Ma to wpływ na obliczenia, jeśli pomiar netto jest niedozwolony. |
LeasingSavings
Koszt i korzyści związane z dzierżawą określonej konfiguracji paneli słonecznych o określonym zużyciu energii elektrycznej.
Zapis JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Pola | |
---|---|
leasesAllowed |
Czy w tym procesie dzierżawy są dozwolone (w niektórych stanach dzierżawa jest niedozwolona). Jeśli to pole ma wartość false, wartości w tym komunikacie należy prawdopodobnie zignorować. |
leasesSupported |
Czy dzierżawy są obsługiwane w tym procesie przez mechanizm obliczeń finansowych. Jeśli to pole ma wartość false, wartości w tym komunikacie należy prawdopodobnie zignorować. Ta wartość jest niezależna od |
annualLeasingCost |
Szacowany roczny koszt leasingu. |
savings |
Ile zaoszczędzisz (lub nie) w danym okresie. |
SavingsOverTime
Informacje finansowe udostępniane przez różne metody 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 bieżąca wartość skumulowanych oszczędności z ostatnich 20 lat, jeśli uwzględnimy przypuszczalną stopę rabatową? |
savingsLifetime |
Oszczędności w całym cyklu życia panelu. |
presentValueOfSavingsLifetime |
Jaka jest bieżąca wartość skumulowanych oszczędności od początku śledzenia, jeśli uwzględnimy przypuszczalną stopę rabatową? |
financiallyViable |
Wskazuje, czy ten scenariusz jest opłacalny. Wartość „fałsz” w przypadku scenariuszy o niskiej zdolności finansowej (np. utraty pieniędzy). |
CashPurchaseSavings
Koszt i korzyści związane z bezpośrednim zakupem określonej konfiguracji paneli słonecznych z określonym zużyciem energii elektrycznej.
Zapis JSON |
---|
{ "outOfPocketCost": { object ( |
Pola | |
---|---|
outOfPocketCost |
Koszt początkowy przed zachętami podatkowymi: kwota, którą trzeba zapłacić z kieszeni. W przeciwieństwie do |
upfrontCost |
Koszt początkowy po odjęciu zachęt podatkowych: jest to kwota, którą należy zapłacić w ciągu pierwszego roku. W przeciwieństwie do |
rebateValue |
Wartość wszystkich zwrotów podatku. |
savings |
Ile zaoszczędzisz (lub nie) w danym okresie. |
paybackYears |
Liczba lat do osiągnięcia zwrotu środków. Wartość ujemna oznacza, że zwrot środków nigdy nie występuje w okresie od początku śledzenia. |
FinancedPurchaseSavings
Koszt i korzyści z użycia pożyczki na zakup określonej konfiguracji paneli słonecznych o określonym zużyciu energii elektrycznej.
Zapis JSON |
---|
{ "annualLoanPayment": { object ( |
Pola | |
---|---|
annualLoanPayment |
Roczne spłaty pożyczki. |
rebateValue |
Wartość wszystkich zwrotów podatku (w tym podatku federalnego (ITC)). |
loanInterestRate |
Stopa oprocentowania kredytów obliczona w tym zestawie obliczeń. |
savings |
Ile zaoszczędzisz (lub nie) w danym okresie. |