- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- रकम
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- इसे आज़माएं!
क्वेरी पॉइंट के सबसे पास वाली बिल्डिंग का पता लगाता है. अगर क्वेरी पॉइंट से करीब 50 मीटर के अंदर कोई बिल्डिंग नहीं है, तो कोड NOT_FOUND
के साथ गड़बड़ी दिखाता है.
एचटीटीपी अनुरोध
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
location |
ज़रूरी है. वह देशांतर और अक्षांश जहां से एपीआई सबसे नज़दीकी इमारत की खोज करता है. |
requiredQuality |
ज़रूरी नहीं. परिणामों में दिखाई जाने वाली कम से कम क्वालिटी लेवल. इससे कम क्वालिटी वाला कोई नतीजा नहीं दिखाया जाएगा. इसे तय नहीं करना, सिर्फ़ हाई क्वालिटी तक सीमित रखने के बराबर है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
Solar.FindClosestBuildingInsights
के लिए जवाब मैसेज. किसी इमारत की जगह, डाइमेंशन, और सौर ऊर्जा की क्षमता के बारे में जानकारी.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "name": string, "center": { object ( |
फ़ील्ड | |
---|---|
name |
इमारत के लिए संसाधन का नाम, |
center |
बिल्डिंग के बीच में मौजूद पॉइंट. |
boundingBox |
इमारत का बाउंडिंग बॉक्स. |
imageryDate |
वह तारीख जिस दिन तस्वीरों का संग्रह हासिल किया गया. यह अनुमानित है. |
imageryProcessedDate |
इस तस्वीरों की प्रोसेसिंग पूरी हो जाने के बाद. |
postalCode |
पिन कोड (उदाहरण के लिए, यूएस पिन कोड) इस बिल्डिंग में शामिल है. |
administrativeArea |
राज्य 1 (जैसे, अमेरिका में, राज्य) जिसमें यह इमारत है. उदाहरण के लिए, अमेरिका में, छोटा नाम "MA" या "CA" हो सकता है. |
statisticalArea |
आंकड़ों के क्षेत्र (जैसे, अमेरिकी जनगणना के मुताबिक) यह इमारत इसमें है. |
regionCode |
उस देश (या इलाके) का इलाका कोड जहां यह बिल्डिंग है. |
solarPotential |
इमारत की सौर ऊर्जा की क्षमता. |
imageryQuality |
इस बिल्डिंग के डेटा की गणना करने में इस्तेमाल की गई तस्वीरों के संग्रह की गुणवत्ता. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
अक्षांश/देशांतर निर्देशांक में बाउंडिंग बॉक्स.
जेएसओएन के काेड में दिखाना |
---|
{ "sw": { object ( |
फ़ील्ड | |
---|---|
sw |
बॉक्स का दक्षिण-पश्चिम कोना. |
ne |
बॉक्स के उत्तर-पूर्वी कोने में. |
SolarPotential
किसी इमारत की सौर ऊर्जा की क्षमता के बारे में जानकारी. इसमें कई फ़ील्ड "पैनल" के रूप में परिभाषित किए गए हैं. panelCapacityWatts
, panelHeightMeters
, और panelWidthMeters
फ़ील्ड, इन कैलकुलेशन में इस्तेमाल किए गए पैनल के मॉडल के पैरामीटर के बारे में बताते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
फ़ील्ड | |
---|---|
maxArrayPanelsCount |
ज़्यादा से ज़्यादा पैनल का साइज़ - इसका मतलब है कि छत पर, ज़्यादा से ज़्यादा पैनल फ़िट हो सकते हैं. |
panelCapacityWatts |
कैलकुलेशन में इस्तेमाल किए गए पैनल की क्षमता, वॉट में. |
panelHeightMeters |
कैलकुलेशन में इस्तेमाल किए गए पैनल की ऊंचाई, पोर्ट्रेट ओरिएंटेशन में मीटर में. |
panelWidthMeters |
कैलकुलेशन में इस्तेमाल किए गए पैनल की चौड़ाई, पोर्ट्रेट ओरिएंटेशन में मीटर में. |
panelLifetimeYears |
सौर पैनलों के इतने सालों में होने का अनुमानित जीवन. इसका इस्तेमाल वित्तीय कैलकुलेशन में किया जाता है. |
maxArrayAreaMeters2 |
ज़्यादा से ज़्यादा कलेक्शन का साइज़, वर्ग मीटर में. |
maxSunshineHoursPerYear |
छत पर हर साल, किसी भी समय, सूरज की रोशनी के ज़्यादा से ज़्यादा घंटे. 'सनशाइन आवर' से यह पता चलता है कि हर साल कितनी धूप (ऊर्जा) मिली है. एक घंटे की धूप का घंटा = 1 kWh प्रति kW (जहां मानक जांच की शर्तों के तहत, kW क्षमता का मतलब होता है). |
carbonOffsetFactorKgPerMwh |
ग्रिड इलेक्ट्रिसिटी की हर मेगावॉट ऊर्जा की तुलना में CO2 के उत्सर्जन की एक जैसी मात्रा. यह सौर ऊर्जा से बिखरे हुए ग्रिड बिजली के कार्बन उत्सर्जन का पैमाना है. |
wholeRoofStats |
छत के उस हिस्से का कुल साइज़ और सूरज की रोशनी की कुल मात्रा जिसे छत के कुछ सेगमेंट को असाइन किया गया था. नाम के बावजूद, हो सकता है कि इसमें पूरी इमारत शामिल न हो. |
buildingStats |
पूरी इमारत का साइज़ और सूरज की रोशनी की मात्रा. इसमें छत के वे हिस्से भी शामिल हैं जिन्हें छत के कुछ सेगमेंट के लिए असाइन नहीं किया गया था. इन हिस्सों का ओरिएंटेशन सही तरीके से नहीं बताया गया है, इसलिए छत के एरिया का अनुमान भरोसेमंद नहीं है. हालांकि, ज़मीन के एरिया का अनुमान भरोसेमंद है. यह हो सकता है कि पूरी इमारत की छत के एरिया को |
roofSegmentStats[] |
छत के हर हिस्से के लिए, साइज़ और सूरज की रोशनी की मात्रा. |
solarPanels[] |
हर |
solarPanelConfigs[] |
हर |
financialAnalyses[] |
|
SizeAndSunshineStats
छत या छत के किसी हिस्से का साइज़ और धूप.
जेएसओएन के काेड में दिखाना |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
फ़ील्ड | |
---|---|
areaMeters2 |
छत या छत के सेगमेंट का एरिया, m^2 में. यह छत का एरिया है (झुकाव के हिसाब से, ग्राउंड फ़ुटप्रिंट का एरिया नहीं). |
sunshineQuantiles[] |
पूरे इलाके में कितनी बार धूप सेकने का समय है. अगर यहां N वैल्यू दी गई हैं, तो यह (N-1)-iles को दिखाती है. उदाहरण के लिए, अगर वैल्यू 5 हैं, तो वे क्वार्टाइल (कम से कम, 25%, 50%, 75%, सबसे ज़्यादा) होंगी. वैल्यू, सालाना kWh/kW में होती हैं, जैसे कि |
groundAreaMeters2 |
ग्राउंड फ़ुटप्रिंट का एरिया, जो छत या छत के सेगमेंट से कवर किया गया है, m^2 में. |
RoofSegmentSizeAndSunshineStats
छत के सेगमेंट के साइज़ और धूप की मात्रा के बारे में जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "stats": { object ( |
फ़ील्ड | |
---|---|
stats |
छत के सेगमेंट का कुल साइज़ और सूरज की रोशनी की मात्रा. |
center |
छत के सेगमेंट के सेंटर के पास का पॉइंट. |
boundingBox |
छत के सेगमेंट का बाउंडिंग बॉक्स. |
pitchDegrees |
सैद्धांतिक ग्राउंड प्लेन के सापेक्ष छत के सेगमेंट का ऐंगल. 0 = ज़मीन की समांतर, 90 = ज़मीन के लंबवत. |
azimuthDegrees |
कंपास की दिशा, जिसमें छत का सेगमेंट दिख रहा है. 0 = उत्तर, 90 = पूर्व, 180 = दक्षिण. छत के "फ़्लैट" सेगमेंट ( |
planeHeightAtCenterMeters |
|
SolarPanel
सोलर पैनल से सोलर पैनल की पोज़िशन, स्क्रीन की दिशा, और प्रोडक्शन के बारे में जानकारी मिलती है. पैनल के पैरामीटर की जानकारी के लिए, SolarPotential
में panelHeightMeters
, panelWidthMeters
, और panelCapacityWatts
फ़ील्ड देखें.
जेएसओएन के काेड में दिखाना |
---|
{ "center": { object ( |
फ़ील्ड | |
---|---|
center |
पैनल का बीच में. |
orientation |
पैनल का ओरिएंटेशन. |
yearlyEnergyDcKwh |
यह लेआउट DC kWh में एक साल के दौरान कितनी धूप लेता है. |
segmentIndex |
|
SolarPanelOrientation
सोलर पैनल का ओरिएंटेशन. इसकी व्याख्या, छत के उस सेगमेंट के एज़िमथ के हिसाब से की जानी चाहिए जिस पर पैनल रखा गया है.
Enums | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
कोई पैनल ओरिएंटेशन नहीं पता है. |
LANDSCAPE |
LANDSCAPE पैनल का लंबा किनारा, छत के उस सेगमेंट के एज़िमथ दिशा के लंबवत होता है जिस पर इसे रखा गया है. |
PORTRAIT |
PORTRAIT पैनल का लंबा किनारा, छत के उस सेगमेंट की दिशा के बराबर होता है जिस पर उसे रखा गया है. |
SolarPanelConfig
सोलरपैनल कॉन्फ़िगरेशन से यह पता चलता है कि छत पर सोलर पैनल किस खास जगह पर लगाए जा सकते हैं.
जेएसओएन के काेड में दिखाना |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
फ़ील्ड | |
---|---|
panelsCount |
पैनल की कुल संख्या. ध्यान दें कि यह |
yearlyEnergyDcKwh |
ऊपर बताए गए पैनल के हिसाब से, यह लेआउट DC kWh में एक साल में कितनी धूप लेता है. |
roofSegmentSummaries[] |
इस लेआउट में छत के हर उस सेगमेंट के प्रोडक्शन के बारे में जानकारी जिसमें कम से कम एक पैनल है. |
RoofSegmentSummary
इमारत पर मौजूद छत के सेगमेंट के बारे में जानकारी, जिस पर कुछ पैनल लगे हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
फ़ील्ड | |
---|---|
panelsCount |
इस सेगमेंट में पैनल की कुल संख्या. |
yearlyEnergyDcKwh |
ऊपर बताए गए पैनल के हिसाब से, DC kWh में, लेआउट का यह हिस्सा एक साल में कितनी ऊर्जा इकट्ठा करता है. |
pitchDegrees |
सैद्धांतिक ग्राउंड प्लेन के सापेक्ष छत के सेगमेंट का ऐंगल. 0 = ज़मीन की समांतर, 90 = ज़मीन के लंबवत. |
azimuthDegrees |
कंपास की दिशा, जिसमें छत का सेगमेंट दिख रहा है. 0 = उत्तर, 90 = पूर्व, 180 = दक्षिण. छत के "फ़्लैट" सेगमेंट ( |
segmentIndex |
संबंधित |
FinancialAnalysis
बिजली के बिल के किसी खास साइज़ के लिए, सबसे सही सोलर लेआउट की लागत और फ़ायदों का विश्लेषण.
जेएसओएन के काेड में दिखाना |
---|
{ "monthlyBill": { object ( |
फ़ील्ड | |
---|---|
monthlyBill |
इस विश्लेषण में यह माना जाता है कि हर महीने का बिजली का बिल. |
defaultBill |
इस बिल्डिंग में मौजूद इलाके के लिए, डिफ़ॉल्ट बिल के तौर पर इस बिल का साइज़ चुना गया है या नहीं. |
averageKwhPerMonth |
एक महीने में घर में कितनी बिजली इस्तेमाल होती है. यह बिल के साइज़ और स्थानीय बिजली की दरों के हिसाब से तय किया जाता है. |
financialDetails |
ऐसी वित्तीय जानकारी जो लागू होती है. भले ही, फ़ाइनेंस करने के लिए किसी भी तरीके का इस्तेमाल किया गया हो. |
leasingSavings |
सोलर पैनल को लीज़ पर देने की लागत और फ़ायदे. |
cashPurchaseSavings |
नकद में सोलर पैनल खरीदने की लागत और फ़ायदे. |
financedPurchaseSavings |
इसके लिए, सौर पैनल खरीदने की लागत और उससे होने वाला फ़ायदा. |
panelConfigIndex |
इस बिल के साइज़ के लिए, सबसे सही सोलर लेआउट का |
पैसे
किसी रकम को उसके मुद्रा के टाइप के साथ दिखाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
फ़ील्ड | |
---|---|
currencyCode |
ISO 4217 में बताया गया तीन अक्षर वाला मुद्रा कोड. |
units |
रकम की पूरी यूनिट. उदाहरण के लिए, अगर |
nanos |
रकम की नैनो (10^-9) यूनिट की संख्या. वैल्यू -9,99,999,999 से 9,99,999,999 के बीच होनी चाहिए. अगर |
FinancialDetails
वित्तीय विश्लेषण का ब्यौरा. इनमें से कुछ जानकारी पहले ही हाई लेवल पर सेव की जा चुकी है. उदाहरण के लिए, जेब में खर्च न होना. कुल रकम, SolarPotential
में panelLifetimeYears
फ़ील्ड की मदद से बताई गई लाइफ़टाइम अवधि की होती है. ध्यान दें: पैनल खरीदने के लिए पैसे, CashPurchaseSavings
में outOfPocketCost
फ़ील्ड में दिए जाते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
फ़ील्ड | |
---|---|
initialAcKwhPerYear |
हमारे हिसाब से, सोलर पैनल कितने AC kWh में जनरेट होंगे. |
remainingLifetimeUtilityBill |
सोलर पैनल से पैदा होने वाली बिजली के लिए बिजली, पानी जैसी सुविधाओं का बिल. |
federalIncentive |
फ़ेडरल इंसेंटिव से उपलब्ध रकम. यह तब लागू होता है, जब उपयोगकर्ता पैनल खरीदता है (क़र्ज़ के साथ या उसके बिना). |
stateIncentive |
राज्य के इंसेंटिव से उपलब्ध रकम. यह तब लागू होता है, जब उपयोगकर्ता पैनल खरीदता है (क़र्ज़ के साथ या उसके बिना). |
utilityIncentive |
यूटिलिटी इंसेंटिव से मिलने वाली रकम. यह तब लागू होता है, जब उपयोगकर्ता पैनल खरीदता है या उसके बिना क़र्ज़ लेता है. |
lifetimeSrecTotal |
पैनल के लाइफ़टाइम में सोलर रिन्यूएबल एनर्जी क्रेडिट से उपयोगकर्ता को मिलने वाली रकम. यह रकम तब लागू होती है, जब उपयोगकर्ता पैनल खरीदता है (क़र्ज़ के साथ या उसके बिना). |
costOfElectricityWithoutSolar |
सोलर पैनल इंस्टॉल न करने पर, लाइफ़टाइम में उपयोगकर्ता को चुकाई जाने वाली बिजली का कुल खर्च. |
netMeteringAllowed |
क्या नेट मीटरिंग की अनुमति है. |
solarPercentage |
सौर ऊर्जा से सप्लाई की गई बिजली का प्रतिशत (0-100). पहले साल के लिए मान्य है, लेकिन आने वाले सालों के लिए करीब-करीब सही है. |
percentageExportedToGrid |
उत्पादन की पहली तिमाही के आधार पर, हमारे अनुमान के मुताबिक सौर ऊर्जा के उत्पादन का प्रतिशत (0-100) ग्रिड में निर्यात किया गया. अगर नेट मीटरिंग की अनुमति नहीं है, तो इससे गिनती पर असर पड़ता है. |
LeasingSavings
बिजली की खास खपत के हिसाब से, सोलर पैनल के किसी कॉन्फ़िगरेशन को लीज़ पर देने की लागत और फ़ायदा.
जेएसओएन के काेड में दिखाना |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
फ़ील्ड | |
---|---|
leasesAllowed |
क्या इस अधिकार में लीज़ की अनुमति है (कुछ राज्यों में लीज़ की अनुमति नहीं है). अगर यह फ़ील्ड गलत है, तो शायद इस मैसेज में दी गई वैल्यू को अनदेखा किया जाना चाहिए. |
leasesSupported |
क्या फ़ाइनेंशियल कैलकुलेशन इंजन, इस ज़रूरत के हिसाब से लीज़ों की सुविधा देता है. अगर यह फ़ील्ड गलत है, तो शायद इस मैसेज में दी गई वैल्यू को अनदेखा किया जाना चाहिए. यह |
annualLeasingCost |
सालाना लीज़ पर देने की अनुमानित कीमत. |
savings |
लाइफ़टाइम में कितनी रकम सेव की गई या कितनी नहीं. |
SavingsOverTime
ऐसी वित्तीय जानकारी जो फ़ाइनेंस करने के अलग-अलग तरीकों के बीच शेयर की जाती है.
जेएसओएन के काेड में दिखाना |
---|
{ "savingsYear1": { object ( |
फ़ील्ड | |
---|---|
savingsYear1 |
पैनल इंस्टॉल करने के बाद, पहले साल में होने वाली बचत. |
savingsYear20 |
पैनल इंस्टॉल होने के बाद, शुरुआती 20 सालों में होने वाली बचत. |
presentValueOfSavingsYear20 |
छूट की अनुमानित दर का इस्तेमाल करके, 20 साल में हुई कुल बचत का मौजूदा मान क्या होगा? |
savingsLifetime |
पैनल के पूरे जीवनकाल में बचत. |
presentValueOfSavingsLifetime |
छूट की अनुमानित दर का इस्तेमाल करके, लाइफ़टाइम बचत की मौजूदा वैल्यू क्या है? |
financiallyViable |
इससे पता चलता है कि यह स्थिति आर्थिक रूप से सक्षम है या नहीं. खराब वित्तीय स्थिति (जैसे, पैसे का नुकसान) वाली स्थितियों के लिए, वैल्यू गलत होगी. |
CashPurchaseSavings
बिजली की खास खपत के साथ, सोलर पैनल के किसी खास कॉन्फ़िगरेशन को खरीदने की लागत और फ़ायदा.
जेएसओएन के काेड में दिखाना |
---|
{ "outOfPocketCost": { object ( |
फ़ील्ड | |
---|---|
outOfPocketCost |
टैक्स इंसेंटिव से पहले की शुरुआती कीमत: वह रकम जिसे ग्राहकों के पास जाकर चुकाया जाना चाहिए. |
upfrontCost |
टैक्स इंसेंटिव के बाद की शुरुआती कीमत: यह वह रकम है जिसका पेमेंट पहले साल करना होगा. |
rebateValue |
टैक्स में मिलने वाली सभी छूट का मान. |
savings |
लाइफ़टाइम में कितनी रकम सेव की गई या कितनी नहीं. |
paybackYears |
पेमेंट होने में सालों की संख्या. नेगेटिव वैल्यू का मतलब है कि लाइफ़टाइम में कभी भी कैशबैक नहीं दिया जाएगा. |
FinancedPurchaseSavings
बिजली की खास खपत वाले सोलर पैनल का खास कॉन्फ़िगरेशन खरीदने के लिए, क़र्ज़ की सुविधा और उसकी लागत के इस्तेमाल से जुड़ा फ़ायदा.
जेएसओएन के काेड में दिखाना |
---|
{ "annualLoanPayment": { object ( |
फ़ील्ड | |
---|---|
annualLoanPayment |
क़र्ज़ का सालाना पेमेंट. |
rebateValue |
टैक्स में मिलने वाली सभी छूट की वैल्यू (इसमें फ़ेडरल इन्वेस्टमेंट टैक्स क्रेडिट (आईटीसी) भी शामिल है). |
loanInterestRate |
ऋणों की ब्याज दर, जिसे गणनाओं के इस सेट में माना गया है. |
savings |
लाइफ़टाइम में कितनी रकम सेव की गई या कितनी नहीं. |