Method: buildingInsights.findClosest

object (LatLng)

Wymagane. Długość i szerokość geograficzna, z których interfejs API wyszukuje najbliższy znany budynek.

enum (ImageryQuality)

Opcjonalnie: Minimalny dozwolony poziom jakości w wynikach. Nie zostanie zwrócony żaden wynik o niższej jakości. Nieokreślenie tego parametru jest równoważne z ograniczeniem tylko do wysokiej jakości.

{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}

object (LatLng)

Południowo-zachodni róg ramki.

object (LatLng)

Północno-wschodni róg pola.

{
  "maxArrayPanelsCount": integer,
  "panelCapacityWatts": number,
  "panelHeightMeters": number,
  "panelWidthMeters": number,
  "panelLifetimeYears": integer,
  "maxArrayAreaMeters2": number,
  "maxSunshineHoursPerYear": number,
  "carbonOffsetFactorKgPerMwh": number,
  "wholeRoofStats": {
    object (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}

integer

Rozmiar maksymalnej tablicy, czyli maksymalna liczba paneli, które mogą się zmieścić na dachu.

number

Moc (w watach) panelu używanego w obliczeniach.

number

Wysokość panelu używanego w obliczeniach, w metrach w orientacji pionowej.

number

Szerokość panelu używanego w obliczeniach w metrach w orientacji pionowej.

integer

Przewidywany czas eksploatacji paneli słonecznych w latach. Jest on używany w obliczeniach finansowych.

number

Rozmiar maksymalnej tablicy (w metrach kwadratowych).

number

Maksymalna liczba godzin słonecznych odbieranych w ciągu roku w dowolnym punkcie na dachu. Godziny nasłonecznienia to miara całkowitej ilości nasłonecznienia (energii) uzyskanej w ciągu roku. 1 godzina nasłoneczna = 1 kWh na kW (gdzie kW oznacza kW mocy obliczeniowej w standardowych warunkach testów).

number

Odpowiednia ilość CO2 wyprodukowanego na MWh energii elektrycznej. Jest to miara emisji dwutlenku węgla związanej z energią elektryczną wypartą energią słoneczną.

object (SizeAndSunshineStats)

Łączny rozmiar i kwantyle światła słonecznego dla części dachu, która została przypisana do jakiegoś segmentu dachu. Pomimo nazwy może to nie obejmować całego budynku. Zobacz buildingStats.

object (SizeAndSunshineStats)

Rozmiar i kwantyle światła słonecznego dla całego budynku, w tym części dachu, które nie zostały przypisane do jakiegoś segmentu dachu. Ze względu na to, że orientacje tych części nie są dobrze scharakteryzowane, oszacowanie powierzchni dachu jest zawodne, ale oszacowana powierzchnia gruntu jest wiarygodna. Być może bardziej niezawodną powierzchnię dachu całego budynku można uzyskać, skalując powierzchnię dachu z wymiarów wholeRoofStats według proporcji powierzchni dachów wynoszącej buildingStats i wholeRoofStats.

object (RoofSegmentSizeAndSunshineStats)

Rozmiar i kwantyle światła słonecznego dla każdego segmentu dachu.

object (SolarPanel)

Każda SolarPanel opisuje pojedynczy panel słoneczny. Są one wymienione w kolejności, w jakiej algorytm układu paneli je umieścił. Zazwyczaj, choć nie zawsze, powoduje to zmniejszenie rocznej produkcji energii.

object (SolarPanelConfig)

Każdy element SolarPanelConfig opisuje inny układ paneli słonecznych na dachu. Są one uporządkowane w kolejności rosnącej liczby paneli. Parametr SolarPanelConfig z parametrem panelsCount=N jest oparty na pierwszych N panelach na liście solarPanels. To pole jest wypełniane tylko wtedy, gdy na dachu mieszczą się co najmniej 4 panele.

object (FinancialAnalysis)

FinancialAnalysis to oszczędność wynikająca z używania energii słonecznej przy założeniu danego miesięcznego rachunku i założenia dostawcy energii elektrycznej. Są one uporządkowane w kolejności rosnącej kwoty miesięcznego rachunku. To pole będzie puste w przypadku budynków na obszarach, dla których interfejs Solar API nie ma wystarczającej ilości informacji do przeprowadzenia obliczeń finansowych.

{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}

number

Powierzchnia dachu lub fragmentu dachu w m^2. Jest to powierzchnia dachu (uwzględniająca przechylenie), a nie powierzchnię podłoża.

number

Kwantyle punktu słonecznego w obszarze. Jeśli występuje tu N wartości, jest to liczba kolek (N-1). Jeśli na przykład istnieje 5 wartości, będą to kwartyle (min., 25%, 50%, 75%, maks.). Wartości są podawane w kWh/kW rocznie, tak jak w polu maxSunshineHoursPerYear.

number

Powierzchnia gruntu pokryta segmentem dachu lub dachem w m^2.

{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}

object (SizeAndSunshineStats)

Łączny rozmiar i kwantyle światła słonecznego dla segmentu dachu.

object (LatLng)

Punkt w pobliżu środka odcinka dachu.

object (LatLngBox)

Ramka ograniczająca segmentu dachu.

number

Kąt odcinka dachu względem teoretycznej płaszczyzny podłoża. 0 = równoległe do ziemi, 90 = prostopadłe do ziemi.

number

Kierunek kompasu, w którym wskazuje segment dachu. 0 = północ, 90 = wschód, 180 = południe. „Mieszkanie” segment dachu (pitchDegrees bardzo blisko 0), a azymut nie jest dobrze zdefiniowany, więc dla zachowania spójności definiujemy go jako 0 (północ).

number

Wysokość płaszczyzny dachu budynku w metrach nad poziomem morza w punkcie wyznaczonym przez center. W połączeniu z nachyleniem, azymutem i położeniem środkowym określa to w pełni płaszczyznę segmentu dachu.

{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}

object (LatLng)

Środek panelu.

enum (SolarPanelOrientation)

Orientacja panelu.

number

Ilość energii słonecznej przechwyconej przez ten układ w ciągu roku (w kWh prądu stałego).

integer

Indeks w polach roofSegmentStats z RoofSegmentSizeAndSunshineStats, który odpowiada segmentowi dachu, na którym znajduje się ten panel.

{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}

integer

Łączna liczba paneli. Pamiętaj, że jest to nadmiarowe wobec (sumy) odpowiednich pól w funkcji roofSegmentSummaries.

number

Ilość energii słonecznej przechwyconej przez ten układ w ciągu roku, wyrażona w kWh (w kWh) przy założeniu, że panele zostały opisane powyżej.

object (RoofSegmentSummary)

Informacje o produkcji każdego segmentu dachu, który zawiera co najmniej 1 panel w tym układzie. Pole roofSegmentSummaries[i] opisuje i-ty segment dachu, w tym jego rozmiar, planowany sposób produkcji i orientację.

{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}

integer

Łączna liczba paneli w tym segmencie.

number

Ilość energii słonecznej przechwyconej przez tę część układu w ciągu roku, wyrażona w kWh (w kWh) przy założeniu, że panele zostały opisane powyżej.

number

Kąt odcinka dachu względem teoretycznej płaszczyzny podłoża. 0 = równoległe do ziemi, 90 = prostopadłe do ziemi.

number

Kierunek kompasu, w którym wskazuje segment dachu. 0 = północ, 90 = wschód, 180 = południe. „Mieszkanie” segment dachu (pitchDegrees bardzo blisko 0), a azymut nie jest dobrze zdefiniowany, więc dla zachowania spójności definiujemy go jako 0 (północ).

integer

Indeks w roofSegmentStats z odpowiednich RoofSegmentSizeAndSunshineStats.

{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}

object (Money)

Miesięczny rachunek za prąd zakładany w tej analizie.

boolean

Określa, czy jest to domyślny rachunek dla obszaru, w którym znajduje się ten budynek. Dokładnie 1 funkcja FinancialAnalysis w BuildingSolarPotential powinna mieć ustawioną wartość defaultBill.

number

Ile prądu zużywa dom w ciągu miesiąca na podstawie wysokości rachunku i lokalnych stawek za prąd.

object (FinancialDetails)

Informacje finansowe, które mają zastosowanie niezależnie od użytej metody finansowania.

object (LeasingSavings)

Koszt i korzyści z leasingu paneli słonecznych.

object (CashPurchaseSavings)

Koszt i korzyści z zakupu paneli słonecznych za gotówkę.

object (FinancedPurchaseSavings)

Koszt i korzyści związane z zakupem paneli słonecznych na finansowaniu zakupu.

integer

Indeks w solarPanelConfigs optymalnego układu paneli słonecznych dla tej wielkości rachunku. Wartość -1 oznacza, że nie ma układu. W takim przypadku pozostałe podwiadomości zostaną pominięte.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.

string (int64 format)

Całkowita jednostka kwoty. Jeśli na przykład currencyCode to "USD", 1 jednostka to 1 zł.

integer

Liczba jednostek nano (10^-9) ilości. Wartość musi mieścić się w zakresie od -999 999 999 do +999 999 999 włącznie. Jeśli units ma wartość dodatnią, nanos musi być liczbą dodatnią lub zero. Jeśli units ma wartość 0, nanos może być liczbą dodatnią, zerową lub ujemną. Jeśli units ma wartość ujemną, nanos musi mieć wartość ujemną lub zero. Na przykład -1,75 zł jest przedstawione jako units=-1 i nanos=-750 000 000.

{
  "initialAcKwhPerYear": number,
  "remainingLifetimeUtilityBill": {
    object (Money)
  },
  "federalIncentive": {
    object (Money)
  },
  "stateIncentive": {
    object (Money)
  },
  "utilityIncentive": {
    object (Money)
  },
  "lifetimeSrecTotal": {
    object (Money)
  },
  "costOfElectricityWithoutSolar": {
    object (Money)
  },
  "netMeteringAllowed": boolean,
  "solarPercentage": number,
  "percentageExportedToGrid": number
}

number

Według nas prognozowana liczba kWh prądu przemiennego, jaką wygenerują panele słoneczne w pierwszym roku działania.

object (Money)

Rachunek za prąd, który nie został wytworzony przez energię słoneczną, przez cały okres użytkowania paneli.

object (Money)

Kwota środków dostępnych na federalnych zachętach do działania; dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez niego).

object (Money)

Kwota środków przyznawanych z programów zachęt stanowych; dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez niego).

object (Money)

Kwota pieniężna dostępna w ramach programów motywacyjnych. dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez niego).

object (Money)

kwota, jaką użytkownik otrzyma z kredytów energii odnawialnej z energii słonecznej w całym cyklu życia panelu; dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez niego).

object (Money)

Całkowity koszt energii elektrycznej, który użytkownik musiałby zapłacić w całym okresie, gdyby nie zainstalował solarów.

boolean

Określa, czy dozwolony jest pomiar netto.

number

Procent (0–100) energii słonecznej dostarczanej przez użytkownika. Obowiązuje przez pierwszy rok, ale w przybliżeniu będzie prawidłowa w przypadku kolejnych lat.

number

Procent (0–100) produkcji energii elektrycznej, którą zakładaliśmy, jest eksportowany do sieci elektrycznej na podstawie pierwszego kwartału produkcji. Ma to wpływ na obliczenia, jeśli pomiar netto jest niedozwolony.

{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}

boolean

Czy dzierżawa są dozwolone w tym świetle (dzierżawa nie jest dozwolona w niektórych stanach). Jeśli to pole ma wartość false, wartości w tym komunikacie powinny zostać prawdopodobnie zignorowane.

boolean

Określa, czy dzierżawa są obsługiwane w ramach tej jurysdykcji przez mechanizm obliczeń finansowych. Jeśli to pole ma wartość false, wartości w tym komunikacie powinny zostać prawdopodobnie zignorowane. Ta wartość jest niezależna od leasesAllowed: w niektórych obszarach dzierżawa są dozwolone, ale pod warunkami, które nie są uwzględniane przez modele finansowe.

object (Money)

Szacowany roczny koszt leasingu.

object (SavingsOverTime)

ilość zaoszczędzonych danych w danym okresie;

{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}

object (Money)

Oszczędności w pierwszym roku po instalacji paneli.

object (Money)

Oszczędności w ciągu pierwszych 20 lat po instalacji paneli.

object (Money)

Jaka jest bieżąca wartość skumulowanych 20-letnich oszczędności, biorąc pod uwagę założoną wysokość rabatu?

object (Money)

Oszczędności przez cały okres użytkowania panelu.

object (Money)

Jaka jest obecna wartość skumulowanych oszczędności od początku śledzenia na podstawie założonej wysokości rabatu?

boolean

Wskazuje, czy ten scenariusz jest opłacalny. Wartość będzie ustawiona na wartość fałsz w przypadku scenariuszy o niskiej kondycji finansowej (np. utraty pieniędzy).

{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}

object (Money)

Koszt początkowy przed naliczeniem zachęt podatkowych: kwota, która musi zostać zapłacona z kieszeni. Inaczej jest w przypadku kategorii upfrontCost, która występuje po zachętach podatkowych.

object (Money)

Koszt początkowy po nałożeniu zachęt podatkowych: kwota, którą należy zapłacić w pierwszym roku. Inaczej jest w przypadku wartości outOfPocketCost, która obejmuje zachęty podatkowe.

object (Money)

Wartość wszystkich potrąceń podatku.

object (SavingsOverTime)

ilość zaoszczędzonych danych w danym okresie;

number

Liczba lat do zwrotu. Wartość ujemna oznacza, że zwrot nie następuje nigdy w całym okresie użytkowania.

{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}

object (Money)

Spłata pożyczki rocznej.

object (Money)

Wartość wszystkich ulg podatkowych (w tym federalnych kwot podatku inwestycyjnego (ITC)).

number

Stopa oprocentowania pożyczek przyjęta w tym zestawie obliczeń.

object (SavingsOverTime)

ilość zaoszczędzonych danych w danym okresie;