- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- 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 | 
 ज़रूरी नहीं. खोज के नतीजों में दिखाए जाने वाले कॉन्टेंट की क्वालिटी का कम से कम लेवल. इससे कम क्वालिटी वाला कोई नतीजा नहीं दिखाया जाएगा. इसकी वैल्यू न डालने का मतलब है कि सिर्फ़ हाई क्वालिटी में वीडियो दिखाने की अनुमति दी गई है. | 
| experiments[] | 
 ज़रूरी नहीं. GA से पहले की सुविधाओं को चालू करने के बारे में बताता है. | 
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
Solar.FindClosestBuildingInsights के लिए जवाब का मैसेज. किसी इमारत की जगह, डाइमेंशन, और सौर ऊर्जा की क्षमता के बारे में जानकारी.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
| JSON के काेड में दिखाना | 
|---|
| { "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
अक्षांश/देशांतर के निर्देशांक में बाउंडिंग बॉक्स.
| JSON के काेड में दिखाना | 
|---|
| { "sw": { object ( | 
| फ़ील्ड | |
|---|---|
| sw | 
 बॉक्स का दक्षिण-पश्चिम कोना. | 
| ne | 
 बॉक्स का उत्तर-पूर्वी कोना. | 
SolarPotential
किसी इमारत में सौर ऊर्जा के उत्पादन की क्षमता के बारे में जानकारी. इसमें कई फ़ील्ड को "पैनल" के तौर पर दिखाया गया है. panelCapacityWatts, panelHeightMeters, और panelWidthMeters फ़ील्ड, इन कैलकुलेशन में इस्तेमाल किए गए पैनल मॉडल के पैरामीटर के बारे में बताते हैं.
| JSON के काेड में दिखाना | 
|---|
| { "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 किलोवॉट-घंटा (जहां किलोवॉट का मतलब, जांच की स्टैंडर्ड शर्तों के तहत किलोवॉट की क्षमता से है). | 
| carbonOffsetFactorKgPerMwh | 
 ग्रिड से मिलने वाली हर मेगावॉट-आवर बिजली से उतनी ही मात्रा में CO2 उत्सर्जन होता है. इससे पता चलता है कि सोलर एनर्जी से मिलने वाली बिजली की वजह से, ग्रिड से मिलने वाली बिजली से होने वाले कार्बन उत्सर्जन में कितनी कमी आई है. | 
| wholeRoofStats | 
 छत के उस हिस्से का कुल साइज़ और सूरज की रोशनी की मात्रा, जिसे छत के किसी सेगमेंट को असाइन किया गया था. नाम के बावजूद, हो सकता है कि इसमें पूरी इमारत शामिल न हो.  | 
| buildingStats | 
 पूरी इमारत का साइज़ और सूरज की रोशनी की मात्रा. इसमें छत के ऐसे हिस्से भी शामिल हैं जिन्हें छत के किसी सेगमेंट के लिए असाइन नहीं किया गया था. इन हिस्सों के ओरिएंटेशन की जानकारी ठीक से नहीं दी गई है. इसलिए, छत के क्षेत्र का अनुमान भरोसेमंद नहीं है. हालांकि, ज़मीन के क्षेत्र का अनुमान भरोसेमंद है. ऐसा हो सकता है कि छत के क्षेत्रफल को  | 
| roofSegmentStats[] | 
 हर छत के सेगमेंट का साइज़ और सूरज की रोशनी की मात्रा. | 
| solarPanels[] | 
 हर  | 
| solarPanelConfigs[] | 
 हर  | 
| financialAnalyses[] | 
 
 | 
SizeAndSunshineStats
छत या छत के किसी हिस्से का साइज़ और धूप के हिसाब से क्वांटाइल.
| JSON के काेड में दिखाना | 
|---|
| { "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } | 
| फ़ील्ड | |
|---|---|
| areaMeters2 | 
 छत या छत के सेगमेंट का क्षेत्रफल, वर्ग मीटर में. यह छत का क्षेत्र है (झुकाव को ध्यान में रखते हुए), न कि जमीन का फ़ुटप्रिंट क्षेत्र. | 
| sunshineQuantiles[] | 
 पूरे इलाके में, सूरज की रोशनी के पॉइंट के हिसाब से क्वांटाइल. अगर यहां N वैल्यू हैं, तो यह (N-1)-इल्स दिखाता है. उदाहरण के लिए, अगर पांच वैल्यू हैं, तो वे क्वार्टाइल (कम से कम, 25%, 50%, 75%, ज़्यादा से ज़्यादा) होंगी. वैल्यू, सालाना kWh/kW में होती हैं, जैसे कि  | 
| groundAreaMeters2 | 
 छत या छत के सेगमेंट से ढके हुए ज़मीन का क्षेत्रफल, वर्ग मीटर में. | 
RoofSegmentSizeAndSunshineStats
किसी रूफ़ सेगमेंट के साइज़ और धूप के हिसाब से क्वांटाइल के बारे में जानकारी.
| JSON के काेड में दिखाना | 
|---|
| { "stats": { object ( | 
| फ़ील्ड | |
|---|---|
| stats | 
 छत के सेगमेंट का कुल साइज़ और सूरज की रोशनी की मात्रा. | 
| center | 
 छत के सेगमेंट के बीच में मौजूद कोई बिंदु. | 
| boundingBox | 
 छत के सेगमेंट का बाउंडिंग बॉक्स. | 
| pitchDegrees | 
 छत के सेगमेंट का कोण, जो सैद्धांतिक ग्राउंड प्लेन के हिसाब से है. 0 = ज़मीन के समानांतर, 90 = ज़मीन के लंबवत. | 
| azimuthDegrees | 
 कंपास की वह दिशा जिस ओर छत का सेगमेंट है. 0 = उत्तर, 90 = पूर्व, 180 = दक्षिण. "फ़्लैट" रूफ़ सेगमेंट ( | 
| planeHeightAtCenterMeters | 
 
 | 
SolarPanel
SolarPanel एट्रिब्यूट से, किसी एक सोलर पैनल की पोज़िशन, ओरिएंटेशन, और उत्पादन के बारे में पता चलता है. पैनल के पैरामीटर के बारे में जानकारी पाने के लिए, SolarPotential में panelHeightMeters, panelWidthMeters, और panelCapacityWatts फ़ील्ड देखें.
| JSON के काेड में दिखाना | 
|---|
| { "center": { object ( | 
| फ़ील्ड | |
|---|---|
| center | 
 पैनल का बीच. | 
| orientation | 
 पैनल का ओरिएंटेशन. | 
| yearlyEnergyDcKwh | 
 डीसी केडब्ल्यूएच में, यह लेआउट एक साल में सूरज की कितनी ऊर्जा कैप्चर करता है. | 
| segmentIndex | 
 
 | 
SolarPanelOrientation
सोलर पैनल का ओरिएंटेशन. इसका मतलब, उस छत के सेगमेंट के अज़ीमुथ से होना चाहिए जिस पर पैनल लगाया गया है.
| Enums | |
|---|---|
| SOLAR_PANEL_ORIENTATION_UNSPECIFIED | पैनल के ओरिएंटेशन की जानकारी नहीं है. | 
| LANDSCAPE | LANDSCAPEपैनल का लंबा किनारा, उस रूफ सेगमेंट के अज़ीमुथ दिशा के लंबवत होता है जिस पर इसे लगाया जाता है. | 
| PORTRAIT | PORTRAITपैनल का लंबा किनारा, छत के उस सेगमेंट के अज़ीमुथ दिशा के समाना होता है जिस पर पैनल लगाया गया है. | 
SolarPanelConfig
SolarPanelConfig, छत पर सोलर पैनल के किसी खास प्लेसमेंट के बारे में बताता है.
| JSON के काेड में दिखाना | 
|---|
| {
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object ( | 
| फ़ील्ड | |
|---|---|
| panelsCount | 
 पैनल की कुल संख्या. ध्यान दें कि यह  | 
| yearlyEnergyDcKwh | 
 ऊपर बताए गए पैनल के हिसाब से, यह लेआउट एक साल में डीसी केडब्ल्यूएच में कितनी सौर ऊर्जा कैप्चर करता है. | 
| roofSegmentSummaries[] | 
 इस लेआउट में, कम से कम एक पैनल वाले हर रूफ सेगमेंट के प्रॉडक्शन की जानकारी.  | 
RoofSegmentSummary
इमारत की छत के सेगमेंट की जानकारी, जिस पर कुछ पैनल लगे हुए हैं.
| JSON के काेड में दिखाना | 
|---|
| { "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } | 
| फ़ील्ड | |
|---|---|
| panelsCount | 
 इस सेगमेंट में पैनल की कुल संख्या. | 
| yearlyEnergyDcKwh | 
 ऊपर बताए गए पैनल के हिसाब से, लेआउट के इस हिस्से में एक साल में सूरज की कितनी ऊर्जा कैप्चर होती है. यह ऊर्जा डीसी के लिए किलोवॉट में होती है. | 
| pitchDegrees | 
 छत के सेगमेंट का कोण, जो सैद्धांतिक ग्राउंड प्लेन के हिसाब से है. 0 = ज़मीन के समानांतर, 90 = ज़मीन के लंबवत. | 
| azimuthDegrees | 
 कंपास की वह दिशा जिस ओर छत का सेगमेंट है. 0 = उत्तर, 90 = पूर्व, 180 = दक्षिण. "फ़्लैट" रूफ़ सेगमेंट ( | 
| segmentIndex | 
 उस  | 
FinancialAnalysis
किसी खास बिजली के बिल के साइज़ के लिए, सोलर लेआउट की लागत और फ़ायदों का विश्लेषण.
| JSON के काेड में दिखाना | 
|---|
| { "monthlyBill": { object ( | 
| फ़ील्ड | |
|---|---|
| monthlyBill | 
 इस विश्लेषण में, बिजली का हर महीने का बिल तय किया जाता है. | 
| defaultBill | 
 क्या इस बिल का साइज़, बिल्डिंग के इलाके के लिए डिफ़ॉल्ट बिल के तौर पर चुना गया है.  | 
| averageKwhPerMonth | 
 बिजली के बिल के साइज़ और स्थानीय बिजली की दरों के आधार पर, यह पता चलता है कि घर में हर महीने औसतन कितनी बिजली खर्च होती है. | 
| financialDetails | 
 वित्तीय जानकारी, जो फ़ाइनेंसिंग के इस्तेमाल किए गए तरीके के बावजूद लागू होती है. | 
| leasingSavings | 
 सोलर पैनल को लीज़ पर लेने की कीमत और फ़ायदे. | 
| cashPurchaseSavings | 
 कैश में सोलर पैनल खरीदने की कीमत और फ़ायदे. | 
| financedPurchaseSavings | 
 क़र्ज़ लेकर सोलर पैनल खरीदने की लागत और फ़ायदे. | 
| panelConfigIndex | 
 इस बिल साइज़ के लिए, सोलर लेआउट का सबसे सही इंडेक्स  | 
पैसे
इससे किसी रकम के साथ उसकी मुद्रा का पता चलता है.
| JSON के काेड में दिखाना | 
|---|
| { "currencyCode": string, "units": string, "nanos": integer } | 
| फ़ील्ड | |
|---|---|
| currencyCode | 
 ISO 4217 में तय किया गया, तीन अक्षर वाला मुद्रा कोड. | 
| units | 
 रकम की पूरी इकाइयां. उदाहरण के लिए, अगर  | 
| nanos | 
 रकम की नैनो (10^-9) यूनिट की संख्या. वैल्यू, -999,999,999 से +999,999,999 के बीच होनी चाहिए. अगर  | 
FinancialDetails
वित्तीय विश्लेषण की जानकारी. इनमें से कुछ जानकारी पहले से ही ज़्यादा लेवल पर सेव होती है. जैसे, खुद से चुकाया जाने वाला शुल्क. कुल रकम, SolarPotential में panelLifetimeYears फ़ील्ड से तय की गई लाइफ़टाइम अवधि के दौरान की जाती है. ध्यान दें: पैनल खरीदने की कुल कीमत, CashPurchaseSavings में outOfPocketCost फ़ील्ड में दी गई है.
| JSON के काेड में दिखाना | 
|---|
| { "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( | 
| फ़ील्ड | |
|---|---|
| initialAcKwhPerYear | 
 हमारे हिसाब से, सोलर पैनल पहले साल में कितने AC kWh जनरेट करेंगे. | 
| remainingLifetimeUtilityBill | 
 सोलर पैनल के लाइफ़टाइम के दौरान, सोलर से जनरेट नहीं होने वाली बिजली के लिए यूटिलिटी बिल. | 
| federalIncentive | 
 फ़ेडरल इंसेंटिव से मिलने वाली रकम; यह तब लागू होता है, जब उपयोगकर्ता पैनल खरीदता है (क़र्ज़ लेकर या बिना क़र्ज़ लिए). | 
| stateIncentive | 
 राज्य से मिलने वाले इंसेंटिव की रकम; यह तब लागू होता है, जब उपयोगकर्ता पैनल खरीदता है (क़र्ज़ लेकर या बिना क़र्ज़ लिए). | 
| utilityIncentive | 
 उपयोगिता इंसेंटिव से मिलने वाली रकम; यह तब लागू होता है, जब उपयोगकर्ता पैनल खरीदता है (क़र्ज़ के साथ या बिना क़र्ज़ के). | 
| lifetimeSrecTotal | 
 पैनल के लाइफ़टाइम के दौरान, उपयोगकर्ता को सोलर रिन्यूएबल एनर्जी क्रेडिट से मिलने वाली रकम. यह तब लागू होता है, जब उपयोगकर्ता क़र्ज़ लेकर या बिना क़र्ज़ लिए पैनल खरीदता है. | 
| costOfElectricityWithoutSolar | 
 सोलर पैनल न लगाने पर, उपयोगकर्ता को लाइफ़टाइम में बिजली के लिए चुकानी पड़ने वाली कुल कीमत. | 
| netMeteringAllowed | 
 नेट मीटरिंग की अनुमति है या नहीं. | 
| solarPercentage | 
 सोलर से मिलने वाली बिजली का प्रतिशत (0-100). यह पहले साल के लिए मान्य है. हालांकि, आने वाले सालों के लिए यह अनुमानित तौर पर सही है. | 
| percentageExportedToGrid | 
 हमने यह अनुमान लगाया है कि सोलर से जनरेट होने वाली बिजली का यह प्रतिशत (0-100), पहली तिमाही के आधार पर ग्रिड में एक्सपोर्ट किया गया था. अगर नेट मीटरिंग की अनुमति नहीं है, तो इससे कैलकुलेशन पर असर पड़ता है. | 
LeasingSavings
बिजली के किसी खास इस्तेमाल के लिए, सोलर पैनल के किसी खास कॉन्फ़िगरेशन को लीज़ पर लेने की लागत और फ़ायदे.
| JSON के काेड में दिखाना | 
|---|
| { "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( | 
| फ़ील्ड | |
|---|---|
| leasesAllowed | 
 इस अधिकार क्षेत्र में, लीज़ देने की अनुमति है या नहीं (कुछ राज्यों में लीज़ देने की अनुमति नहीं है). अगर यह फ़ील्ड गलत है, तो इस मैसेज में दी गई वैल्यू को अनदेखा किया जाना चाहिए. | 
| leasesSupported | 
 क्या इस अधिकार क्षेत्र में, वित्तीय गणना के इंजन के हिसाब से लीज़ की सुविधा काम करती है. अगर यह फ़ील्ड गलत है, तो इस मैसेज में दी गई वैल्यू को अनदेखा किया जाना चाहिए. यह  | 
| annualLeasingCost | 
 लीज़ की सालाना अनुमानित कीमत. | 
| savings | 
 लाइफ़टाइम अवधि के दौरान कितनी बचत हुई है या नहीं. | 
SavingsOverTime
वित्तीय जानकारी, जो अलग-अलग तरीकों से फ़ाइनेंस करने के लिए शेयर की जाती है.
| JSON के काेड में दिखाना | 
|---|
| { "savingsYear1": { object ( | 
| फ़ील्ड | |
|---|---|
| savingsYear1 | 
 पैनल इंस्टॉल करने के बाद, पहले साल में होने वाली बचत. | 
| savingsYear20 | 
 पैनल इंस्टॉल करने के बाद, पहले बीस साल में होने वाली बचत. | 
| presentValueOfSavingsYear20 | 
 छूट की अनुमानित दर का इस्तेमाल करके, 20 साल की कुल बचत की मौजूदा वैल्यू क्या है? | 
| savingsLifetime | 
 पैनल के पूरे लाइफ़टाइम में होने वाली बचत. | 
| presentValueOfSavingsLifetime | 
 अनुमानित छूट की दर का इस्तेमाल करके, लाइफ़टाइम की कुल बचत की मौजूदा वैल्यू क्या है? | 
| financiallyViable | 
 इससे पता चलता है कि यह स्थिति आर्थिक रूप से सही है या नहीं. यह वैल्यू उन स्थितियों के लिए गलत होगी जिनमें वित्तीय स्थिति खराब है. जैसे, पैसे का नुकसान होना. | 
CashPurchaseSavings
बिजली के किसी खास इस्तेमाल के हिसाब से, सोलर पैनल के किसी खास कॉन्फ़िगरेशन को खरीदने की लागत और फ़ायदे.
| JSON के काेड में दिखाना | 
|---|
| { "outOfPocketCost": { object ( | 
| फ़ील्ड | |
|---|---|
| outOfPocketCost | 
 टैक्स में छूट से पहले की लागत: वह रकम जो आपको चुकानी होगी. टैक्स में छूट के बाद की कीमत  | 
| upfrontCost | 
 टैक्स में छूट के बाद की शुरुआती लागत: यह वह रकम है जो पहले साल के दौरान चुकाई जानी चाहिए. टैक्स में छूट से पहले की  | 
| rebateValue | 
 टैक्स में मिलने वाली सभी छूट की वैल्यू. | 
| savings | 
 लाइफ़टाइम अवधि के दौरान कितनी बचत हुई है या नहीं. | 
| paybackYears | 
 पेबैक होने में लगने वाले सालों की संख्या. नेगेटिव वैल्यू का मतलब है कि लाइफ़टाइम अवधि के दौरान, पेबैक कभी नहीं होता. | 
FinancedPurchaseSavings
किसी खास बिजली खर्च के हिसाब से, सोलर पैनल का कोई खास कॉन्फ़िगरेशन खरीदने के लिए क़र्ज़ लेने की लागत और फ़ायदे.
| JSON के काेड में दिखाना | 
|---|
| { "annualLoanPayment": { object ( | 
| फ़ील्ड | |
|---|---|
| annualLoanPayment | 
 क़र्ज़ के लिए सालाना पेमेंट. | 
| rebateValue | 
 सभी टैक्स छूट की वैल्यू. इसमें फ़ेडरल इन्वेस्टमेंट टैक्स क्रेडिट (आईटीसी) भी शामिल है. | 
| loanInterestRate | 
 इस कैलकुलेशन में क़र्ज़ पर लगने वाले ब्याज की दर. | 
| savings | 
 लाइफ़टाइम अवधि के दौरान कितनी बचत हुई है या नहीं. |