Method: buildingInsights.findClosest

Wskazuje 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 ż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

object (LatLng)

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

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.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość z odpowiedzią dla: Solar.FindClosestBuildingInsights. Informacje o lokalizacji, wymiarach i potencjale budynku słonecznego.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "name": string,
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "postalCode": string,
  "administrativeArea": string,
  "statisticalArea": string,
  "regionCode": string,
  "solarPotential": {
    object (SolarPotential)
  },
  "imageryQuality": enum (ImageryQuality)
}
Pola
name

string

Nazwa zasobu budynku w formacie building/<place ID>.
center

object (LatLng)

Punkt w pobliżu środka budynku.
boundingBox

object (LatLngBox)

Ramka ograniczająca budynku.
imageryDate

object (Date)

Data pozyskania danego zdjęcia. To wartość przybliżona.
imageryProcessedDate

object (Date)

Podczas przetwarzania zdjęć.
postalCode

string

Kod pocztowy (np. kodu pocztowego w USA) wewnątrz budynku.
administrativeArea

string

Obszar administracyjny 1 (np. w Stanach Zjednoczonych, stan), w którym znajduje się ten budynek. Na przykład w USA skrót może wyglądać tak: „MA”. lub „CA”.
statisticalArea

string

Obszar statystyczny (np. zgodnie ze spisem ludności Stanów Zjednoczonych), w którym znajduje się ten budynek.
regionCode

string

Kod regionu dla kraju (lub regionu), w którym znajduje się ten budynek.
solarPotential

object (SolarPotential)

Potencjał budynku fotowoltaicznego.
imageryQuality

enum (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 podana we współrzędnych geograficznych.

Zapis JSON 
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Pola
sw

object (LatLng)

Południowo-zachodni róg ramki.
ne

object (LatLng)

Północno-wschodni róg pola.

SolarPotential

Informacje o potencjale budynku związanym z energią słoneczną. Wiele pól w tym przykładzie 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 (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}
Pola
maxArrayPanelsCount

integer

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

number

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

number

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

number

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

integer

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

number

Rozmiar maksymalnej tablicy (w metrach kwadratowych).
maxSunshineHoursPerYear

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).
carbonOffsetFactorKgPerMwh

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ą.
wholeRoofStats

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.
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.
roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

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

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.
solarPanelConfigs[]

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.
financialAnalyses[]

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.

SizeAndSunshineStats

Rozmiar i kwantyle dachu lub jego części.

Zapis JSON 
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
Pola
areaMeters2

number

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

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.
groundAreaMeters2

number

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

RoofSegmentSizeAndSunshineStats

Informacje o wielkości i kwantylu słonecznym segmentu dachu.

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

object (SizeAndSunshineStats)

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

object (LatLng)

Punkt w pobliżu środka odcinka dachu.
boundingBox

object (LatLngBox)

Ramka ograniczająca segmentu dachu.
pitchDegrees

number

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

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).
planeHeightAtCenterMeters

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.

SolarPanel

SolarPanel opisuje położenie, orientację i sposób produkcji pojedynczego panelu słonecznego. Informacje o parametrach panelu znajdziesz w polach panelHeightMeters, panelWidthMeters i panelCapacityWatts w narzędziu SolarPotential.

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

object (LatLng)

Środek panelu.
orientation

enum (SolarPanelOrientation)

Orientacja panelu.
yearlyEnergyDcKwh

number

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

integer

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

SolarPanelOrientation

Orientacja panelu słonecznego. Należy ją interpretować w odniesieniu do azymutu segmentu dachu, na którym jest umieszczony panel.

Wartości w polu enum
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Orientacja panelu nie jest znana.
LANDSCAPE Długa krawędź panelu LANDSCAPE jest prostopadła do kierunku azymutu segmentu dachu, na którym jest umieszczony.
PORTRAIT Długa krawędź panelu PORTRAIT jest równoległa 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 (RoofSegmentSummary)
    }
  ]
}
Pola
panelsCount

integer

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

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.
roofSegmentSummaries[]

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ę.

RoofSegmentSummary

Informacje o odcinku dachu budynku z umieszczoną liczbą paneli.

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

integer

Łączna liczba paneli w tym segmencie.
yearlyEnergyDcKwh

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.
pitchDegrees

number

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

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).
segmentIndex

integer

Indeks w roofSegmentStats z odpowiednich RoofSegmentSizeAndSunshineStats.

FinancialAnalysis

Analiza kosztów i korzyści wynikających z optymalnego układu paneli słonecznych przy danej wielkości rachunku za prąd.

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

object (Money)

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

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.
averageKwhPerMonth

number

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

object (FinancialDetails)

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

object (LeasingSavings)

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

object (CashPurchaseSavings)

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

object (FinancedPurchaseSavings)

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

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.

Pieniądze

Reprezentuje kwotę za pomocą jej typu waluty.

Zapis JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Pola
currencyCode

string

Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.
units

string (int64 format)

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

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.

FinancialDetails

Szczegóły analizy finansowej. Niektóre z tych informacji są już przechowywane na wyższych poziomach (np. z kieszeni). Łączne kwoty środków dotyczą okresu od początku śledzenia zdefiniowany w polu panelLifetimeYears w tabeli SolarPotential. Uwaga: koszt własny zakupu paneli jest podany w polu outOfPocketCost w CashPurchaseSavings.

Zapis JSON 
{
  "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
}
Pola
initialAcKwhPerYear

number

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

object (Money)

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

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).
stateIncentive

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).
utilityIncentive

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).
lifetimeSrecTotal

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).
costOfElectricityWithoutSolar

object (Money)

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

boolean

Określa, czy dozwolony jest pomiar netto.
solarPercentage

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.
percentageExportedToGrid

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.

LeasingSavings

Koszt i korzyści z dzierżawy konkretnej konfiguracji paneli słonecznych przy konkretnym zużyciu energii elektrycznej.

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

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.
leasesSupported

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.
annualLeasingCost

object (Money)

Szacowany roczny koszt leasingu.
savings

object (SavingsOverTime)

ilość zaoszczędzonych danych w danym okresie;

SavingsOverTime

Informacje finansowe udostępniane różnym metodom finansowania.

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

object (Money)

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

object (Money)

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

object (Money)

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

object (Money)

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

object (Money)

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

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).

CashPurchaseSavings

Koszt i korzyści z bezpośredniego zakupu określonej konfiguracji paneli słonecznych przy konkretnym zużyciu energii elektrycznej.

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

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.
upfrontCost

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.
rebateValue

object (Money)

Wartość wszystkich potrąceń podatku.
savings

object (SavingsOverTime)

ilość zaoszczędzonych danych w danym okresie;
paybackYears

number

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

FinancedPurchaseSavings

Koszt i korzyści związane z skorzystaniem z pożyczki na zakup określonej konfiguracji paneli słonecznych przy konkretnym zużyciu energii elektrycznej.

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

object (Money)

Spłata pożyczki rocznej.
rebateValue

object (Money)

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

number

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

object (SavingsOverTime)

ilość zaoszczędzonych danych w danym okresie;