- Żądanie HTTP
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- AdditionalInsights
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Zarabianie
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- DetectedArrays
- DetectionStatus
- Wypróbuj
Wyszukuje budynek, którego środek ciężkości znajduje się najbliżej punktu zapytania. Zwraca błąd o kodzie 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. |
requiredQuality |
Opcjonalnie. Minimalny poziom jakości dozwolony w wynikach. Nie zostaną zwrócone żadne wyniki o niższej jakości. Nieokreślenie tego parametru jest równoznaczne z ograniczeniem do jakości WYSOKIEJ. |
exactQualityRequired |
Opcjonalnie. Określa, czy wymagana jest dokładna jakość zdjęć. Jeśli wartość tego pola to „false”, pole |
experiments[] |
Opcjonalnie. Określa eksperymenty przed GA, które mają zostać włączone. Żądania korzystające z tego pola są klasyfikowane jako oferta przed GA zgodnie ze szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania. |
additionalInsights[] |
Opcjonalnie. Lista |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Wiadomość z odpowiedzią dla Solar.FindClosestBuildingInsights. Informacje o lokalizacji, wymiarach i potencjale paneli słonecznych danego 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ęć bazowych. To jest wartość przybliżona. |
imageryProcessedDate |
Kiedy zakończono przetwarzanie tych zdjęć. |
postalCode |
Kod pocztowy (np. kod pocztowy w USA), w którym znajduje się ten budynek. |
administrativeArea |
Region administracyjny 1 (np. w Stanach Zjednoczonych stan), w którym znajduje się ten budynek. Na przykład w Stanach Zjednoczonych skrót może brzmieć „MA” lub „CA”. |
statisticalArea |
Obszar statystyczny (np. okręg spisowy w USA), w którym znajduje się budynek. |
regionCode |
Kod regionu kraju (lub regionu), w którym znajduje się ten budynek. |
solarPotential |
Potencjał paneli słonecznych na budynku. |
imageryQuality |
Jakość zdjęć użytych do obliczenia danych dla tego budynku. |
detectedArrays |
Moduły fotowoltaiczne wykryte na budynku. To pole jest wypełniane tylko wtedy, gdy w polu |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/cloud-platform
AdditionalInsights
Dodatkowe informacje o budynku, takie jak geometria dachu i układy paneli słonecznych, które mogą być zwracane w BuildingInsights.
| Wartości w polu enum | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED |
Wartość domyślna. Zostanie zwrócony domyślny obiekt BuildingInsights. |
DETECTED_ARRAYS |
Określa, czy odpowiedź będzie zawierać wykryte tablice. Jeśli jest określone, w odpowiedzi zostanie wypełnione pole |
LatLngBox
Ramka ograniczająca w postaci współrzędnych geograficznych.
| Zapis JSON |
|---|
{ "sw": { object ( |
| Pola | |
|---|---|
sw |
Południowo-zachodni róg pola. |
ne |
Północno-wschodni róg pola. |
SolarPotential
Informacje o potencjale paneli słonecznych w przypadku budynku. Wiele pól jest w nim zdefiniowanych w kategoriach „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 | |
|---|---|
maxArrayPanelsCount |
Rozmiar maksymalnej tablicy, czyli maksymalna liczba paneli, które zmieszczą się na dachu. |
panelCapacityWatts |
Moc panelu w watach użyta w obliczeniach. |
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 |
Oczekiwany okres użytkowania paneli słonecznych w latach. Jest on używany w obliczeniach finansowych. |
maxArrayAreaMeters2 |
Rozmiar maksymalnej tablicy w metrach kwadratowych. |
maxSunshineHoursPerYear |
Maksymalna liczba godzin nasłonecznienia w ciągu roku w dowolnym punkcie dachu. Liczba godzin słonecznych to miara łącznej ilości nasłonecznienia (energii) otrzymywanej w ciągu roku. 1 godzina nasłonecznienia = 1 kWh na 1 kW (gdzie kW oznacza moc w kW w standardowych warunkach testowych). |
carbonOffsetFactorKgPerMwh |
Równoważna ilość CO₂ wytwarzana na MWh energii elektrycznej z sieci. Jest to wskaźnik emisji dwutlenku węgla w energii elektrycznej z sieci, która została zastąpiona energią słoneczną. |
wholeRoofStats |
Łączny rozmiar i kwantyle światła słonecznego dla części dachu przypisanej do segmentu dachu. Pomimo nazwy może nie obejmować całego budynku. Zobacz |
buildingStats |
Kwantyle wielkości i nasłonecznienia dla całego budynku, w tym części dachu, które nie zostały przypisane do żadnego segmentu dachu. Orientacja tych części nie jest dobrze określona, więc 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 |
roofSegmentStats[] |
kwantyle rozmiaru i nasłonecznienia dla każdego segmentu dachu; |
solarPanels[] |
Każdy symbol |
solarPanelConfigs[] |
Każdy |
financialAnalyses[] |
|
SizeAndSunshineStats
kwantyle rozmiaru i nasłonecznienia dachu lub jego części;
| Zapis JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Pola | |
|---|---|
areaMeters2 |
Powierzchnia dachu lub jego fragmentu w m². Jest to powierzchnia dachu (z uwzględnieniem nachylenia), a nie powierzchnia zajmowana przez budynek na ziemi. |
sunshineQuantiles[] |
Kwantyle nasłonecznienia punktowego na danym 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 (min, 25%, 50%, 75%, max). Wartości są podawane w kWh/kW rocznie, np. |
groundAreaMeters2 |
Powierzchnia rzutu dachu lub jego segmentu na ziemię w m². |
RoofSegmentSizeAndSunshineStats
Informacje o kwantylach rozmiaru i nasłonecznienia segmentu dachu.
| Zapis JSON |
|---|
{ "stats": { object ( |
| Pola | |
|---|---|
stats |
Całkowity rozmiar i kwantyle nasłonecznienia segmentu dachu. |
center |
Punkt w pobliżu środka segmentu dachu. |
boundingBox |
Ramka ograniczająca segment dachu. |
pitchDegrees |
Kąt segmentu dachu względem teoretycznej płaszczyzny podłoża. 0 = równoległe do podłoża, 90 = prostopadłe do podłoża. |
azimuthDegrees |
Kierunek kompasu, w którym zwrócony jest segment dachu. 0 = północ, 90 = wschód, 180 = południe. W przypadku segmentu dachu „płaskiego” ( |
planeHeightAtCenterMeters |
Wysokość płaszczyzny segmentu dachu w metrach nad poziomem morza w punkcie oznaczonym symbolem |
SolarPanel
SolarPanel opisuje położenie, orientację i produkcję pojedynczego panelu słonecznego. Informacje o parametrach panelu znajdziesz w polach panelHeightMeters, panelWidthMeters i panelCapacityWatts w SolarPotential.
| Zapis JSON |
|---|
{ "center": { object ( |
| Pola | |
|---|---|
center |
środek panelu. |
orientation |
Orientacja panelu. |
yearlyEnergyDcKwh |
Ile energii słonecznej w kWh prądu stałego jest przechwytywane przez tę konfigurację w ciągu roku. |
segmentIndex |
Indeks w |
SolarPanelOrientation
Orientacja panelu słonecznego. Należy to interpretować w odniesieniu do azymutu segmentu dachu, na którym umieszczony jest panel.
| Wartości w polu enum | |
|---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Nieznana orientacja panelu. |
LANDSCAPE |
Dłuższy bok panelu LANDSCAPE jest prostopadły do kierunku azymutu segmentu dachu, na którym jest umieszczony. |
PORTRAIT |
Dłuższy bok panelu PORTRAIT jest równoległy 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 ( |
| Pola | |
|---|---|
panelsCount |
Łączna liczba paneli. Pamiętaj, że jest to redundantne w stosunku do (sumy) odpowiednich pól w |
yearlyEnergyDcKwh |
Ile energii słonecznej w kWh prądu stałego może zostać przechwycone w ciągu roku przy założeniu, że panele są takie jak opisane powyżej. |
roofSegmentSummaries[] |
Informacje o produkcji każdego segmentu dachu, na którym znajduje się co najmniej 1 panel w tym układzie. |
RoofSegmentSummary
Informacje o fragmencie dachu budynku, na którym znajduje się pewna liczba 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 ta część instalacji przechwytuje w ciągu roku (w kWh DC) przy założeniu, że panele są takie jak opisane powyżej. |
pitchDegrees |
Kąt segmentu dachu względem teoretycznej płaszczyzny podłoża. 0 = równoległe do podłoża, 90 = prostopadłe do podłoża. |
azimuthDegrees |
Kierunek kompasu, w którym zwrócony jest segment dachu. 0 = północ, 90 = wschód, 180 = południe. W przypadku segmentu dachu „płaskiego” ( |
segmentIndex |
Indeks w |
FinancialAnalysis
Analiza kosztów i korzyści wynikających z optymalnego rozmieszczenia paneli słonecznych w przypadku określonej wysokości rachunku za prąd.
| Zapis JSON |
|---|
{ "monthlyBill": { object ( |
| Pola | |
|---|---|
monthlyBill |
Miesięczny rachunek za prąd, który został przyjęty w tej analizie. |
defaultBill |
Czy jest to rozmiar rachunku wybrany jako domyślny dla obszaru, na którym znajduje się ten budynek. Dokładnie 1 element |
averageKwhPerMonth |
Ile energii elektrycznej zużywa dom w przeciętnym miesiącu na podstawie wysokości rachunku i lokalnych stawek za energię elektryczną. |
financialDetails |
Informacje finansowe, które mają zastosowanie niezależnie od użytej metody finansowania. |
leasingSavings |
Koszt i korzyści z dzierżawy paneli słonecznych. |
cashPurchaseSavings |
Koszt i korzyści związane z zakupem paneli słonecznych za gotówkę. |
financedPurchaseSavings |
Koszt i korzyści związane z zakupem paneli słonecznych w ramach finansowania. |
panelConfigIndex |
Indeks w |
Pieniądze
Reprezentuje kwotę pieniędzy z określeniem typu waluty.
| Zapis JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Pola | |
|---|---|
currencyCode |
Trzyliterowy kod waluty zdefiniowany w normie ISO 4217. |
units |
Całe jednostki kwoty. Jeśli na przykład |
nanos |
Liczba jednostek nano (10^-9) kwoty. Wartość musi mieścić się w przedziale od -999 999 999 do +999 999 999 (włącznie). Jeśli wartość |
FinancialDetails
szczegóły analizy finansowej; Niektóre z tych szczegółów są już przechowywane na wyższych poziomach (np. koszt z własnej kieszeni). Łączne kwoty pieniędzy dotyczą okresu zdefiniowanego przez pole panelLifetimeYears w SolarPotential. Uwaga: koszt zakupu paneli jest podany w polu outOfPocketCost w CashPurchaseSavings.
| Zapis JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Pola | |
|---|---|
initialAcKwhPerYear |
Szacowana ilość kWh prądu przemiennego, jaką panele słoneczne wygenerują w pierwszym roku. |
remainingLifetimeUtilityBill |
Rachunek za energię elektryczną, która nie została wyprodukowana przez panele słoneczne, za cały okres ich eksploatacji. |
federalIncentive |
Kwota dostępna w ramach zachęt federalnych. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez). |
stateIncentive |
Kwota dostępna w ramach zachęt państwowych. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez). |
utilityIncentive |
Kwota dostępna w ramach zachęt od dostawców energii; dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez niego). |
lifetimeSrecTotal |
Kwota pieniędzy, jaką użytkownik otrzyma z tytułu certyfikatów energii odnawialnej z instalacji fotowoltaicznej w okresie jej eksploatacji. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez). |
costOfElectricityWithoutSolar |
Całkowity koszt energii elektrycznej, jaki użytkownik zapłaciłby w okresie eksploatacji, gdyby nie zainstalował paneli słonecznych. |
netMeteringAllowed |
Czy opomiarowanie netto jest dozwolone. |
solarPercentage |
Procent (0–100) energii użytkownika pochodzącej z energii słonecznej. Obowiązuje w pierwszym roku, ale jest w przybliżeniu prawidłowa w kolejnych latach. |
percentageExportedToGrid |
Procent (0–100) produkcji energii elektrycznej z fotowoltaiki, który według naszych założeń został wyeksportowany do sieci na podstawie pierwszego kwartału produkcji. Wpływa to na obliczenia, jeśli rozliczenie net-metering nie jest dozwolone. |
LeasingSavings
Koszt i korzyści z dzierżawy paneli słonecznych w określonej konfiguracji przy określonym zużyciu energii elektrycznej.
| Zapis JSON |
|---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
| Pola | |
|---|---|
leasesAllowed |
Czy w danym regionie dopuszczalne są umowy leasingu (w niektórych stanach są one niedozwolone). Jeśli to pole ma wartość „false”, wartości w tym komunikacie należy prawdopodobnie zignorować. |
leasesSupported |
Określa, czy silnik obliczeń finansowych obsługuje leasing w danym regionie. Jeśli to pole ma wartość „false”, wartości w tym komunikacie należy prawdopodobnie zignorować. Jest to niezależne od |
annualLeasingCost |
Szacowany roczny koszt leasingu. |
savings |
Ile zostało zaoszczędzone (lub nie) w całym okresie. |
SavingsOverTime
informacje finansowe, które są udostępniane między różnymi metodami 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 zainstalowaniu paneli. |
presentValueOfSavingsYear20 |
Jaka jest obecna wartość skumulowanych oszczędności w ciągu 20 lat przy założonej stopie dyskontowej? |
savingsLifetime |
Oszczędności w całym okresie użytkowania panelu. |
presentValueOfSavingsLifetime |
Jaka jest obecna wartość skumulowanych oszczędności w ciągu całego okresu eksploatacji przy założonej stopie dyskontowej? |
financiallyViable |
Wskazuje, czy ten scenariusz jest opłacalny. W przypadku scenariuszy o niskiej rentowności (np. przynoszących straty) wartość będzie fałszywa. |
CashPurchaseSavings
Koszt i korzyści związane z zakupem konkretnej konfiguracji paneli słonecznych przy określonym zużyciu energii elektrycznej.
| Zapis JSON |
|---|
{ "outOfPocketCost": { object ( |
| Pola | |
|---|---|
outOfPocketCost |
Koszt początkowy przed uwzględnieniem ulg podatkowych: kwota, którą należy zapłacić z własnej kieszeni. W przeciwieństwie do |
upfrontCost |
Koszt początkowy po uwzględnieniu ulg podatkowych: jest to kwota, którą należy zapłacić w pierwszym roku. W przeciwieństwie do |
rebateValue |
Wartość wszystkich zwrotów podatku. |
savings |
Ile zostało zaoszczędzone (lub nie) w okresie obowiązywania ochrony. |
paybackYears |
Liczba lat do zwrotu z inwestycji. Wartość ujemna oznacza, że zwrot nigdy nie nastąpi w okresie życia produktu. |
FinancedPurchaseSavings
Koszt i korzyści związane z zaciągnięciem pożyczki na zakup określonej konfiguracji paneli słonecznych przy określonym zużyciu energii elektrycznej.
| Zapis JSON |
|---|
{ "annualLoanPayment": { object ( |
| Pola | |
|---|---|
annualLoanPayment |
roczne spłaty kredytu, |
rebateValue |
Wartość wszystkich zwrotów podatku (w tym federalnego podatku inwestycyjnego). |
loanInterestRate |
Stopa oprocentowania kredytów przyjęta w tym zestawie obliczeń. |
savings |
Ile zostało zaoszczędzone (lub nie) w całym okresie. |
DetectedArrays
Informacje o panelach słonecznych wykrytych na budynku.
| Zapis JSON |
|---|
{ "detectionStatus": enum ( |
| Pola | |
|---|---|
detectionStatus |
Wskazuje stan wykrycia paneli słonecznych na tym budynku. |
latestCaptureDate |
Data wskazująca, kiedy zostały zebrane najnowsze dane dotyczące paneli fotowoltaicznych. |
DetectionStatus
Wskazuje stan wykrycia paneli słonecznych na tym budynku.
| Wartości w polu enum | |
|---|---|
DETECTION_STATUS_UNSPECIFIED |
Stan nieokreślony. |
DETECTION_STATUS_DATA_UNAVAILABLE |
Dane wykrytej instalacji solarnej są niedostępne w przypadku tego budynku. |
DETECTION_STATUS_ARRAYS_DETECTED |
W tym budynku wykryto co najmniej 1 panel słoneczny. |
DETECTION_STATUS_NO_ARRAYS_DETECTED |
Nie wykryto paneli słonecznych na tym budynku. |