- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Money
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- इसे आज़माएं!
यह उस इमारत का पता लगाता है जिसका सेंट्रॉइड, क्वेरी पॉइंट के सबसे करीब होता है. अगर क्वेरी पॉइंट के 50 मीटर के दायरे में कोई इमारत नहीं है, तो NOT_FOUND कोड वाली गड़बड़ी का मैसेज दिखाता है.
एचटीटीपी अनुरोध
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
| पैरामीटर | |
|---|---|
location |
ज़रूरी है. देशांतर और अक्षांश की वह जानकारी जिससे एपीआई, सबसे नज़दीकी इमारत का पता लगाता है. |
requiredQuality |
ज़रूरी नहीं. नतीजों में दिखने के लिए, कम से कम क्वालिटी लेवल. इस क्वालिटी से कम क्वालिटी वाला कोई नतीजा नहीं दिखाया जाएगा. इसकी वैल्यू तय न करने का मतलब है कि वीडियो को सिर्फ़ HIGH क्वालिटी में स्ट्रीम करने की अनुमति है. |
exactQualityRequired |
ज़रूरी नहीं. क्या इमेज की क्वालिटी सटीक होनी चाहिए. अगर इसे false पर सेट किया जाता है, तो |
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 घंटे की धूप = 1 kWh प्रति kW (जहां kW का मतलब, स्टैंडर्ड टेस्टिंग की शर्तों के तहत क्षमता के kW से है). |
carbonOffsetFactorKgPerMwh |
ग्रिड से मिलने वाली बिजली के हर MWh के लिए, CO2 की बराबर मात्रा में उत्पादन होता है. इससे यह पता चलता है कि सोलर एनर्जी से, ग्रिड से मिलने वाली बिजली के कार्बन उत्सर्जन में कितनी कमी आई है. |
wholeRoofStats |
छत के उस हिस्से के लिए कुल साइज़ और सूरज की रोशनी के क्वांटाइल जिसे छत के किसी सेगमेंट को असाइन किया गया था. नाम के बावजूद, ऐसा हो सकता है कि इसमें पूरी बिल्डिंग शामिल न हो. |
buildingStats |
पूरी इमारत के लिए साइज़ और सूरज की रोशनी के क्वाटाइल. इसमें छत के वे हिस्से भी शामिल हैं जिन्हें किसी छत के सेगमेंट में असाइन नहीं किया गया था. इन हिस्सों के ओरिएंटेशन के बारे में सही जानकारी न होने की वजह से, छत के इलाके का अनुमान भरोसेमंद नहीं है. हालांकि, ज़मीन के इलाके का अनुमान भरोसेमंद है. ऐसा हो सकता है कि पूरी इमारत की छत का ज़्यादा सटीक क्षेत्रफल, |
roofSegmentStats[] |
हर छत के सेगमेंट के लिए साइज़ और सूरज की रोशनी के क्वांटाइल. |
solarPanels[] |
हर |
solarPanelConfigs[] |
हर |
financialAnalyses[] |
|
SizeAndSunshineStats
छत या छत के किसी हिस्से के साइज़ और धूप के हिसाब से क्वांटाइल.
| JSON के काेड में दिखाना |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| फ़ील्ड | |
|---|---|
areaMeters2 |
छत या छत के हिस्से का क्षेत्रफल, वर्ग मीटर में. यह छत का क्षेत्रफल है, न कि ज़मीन पर मौजूद क्षेत्रफल. |
sunshineQuantiles[] |
पूरे इलाके में, हर पॉइंट पर धूप की मात्रा के क्वाटाइल. अगर यहां N वैल्यू हैं, तो यह (N-1)-iles को दिखाता है. उदाहरण के लिए, अगर पांच वैल्यू हैं, तो वे चतुर्थक (कम से कम, 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 |
इस लेआउट से, एक साल में कितनी सौर ऊर्जा मिलती है. यह डीसी kWh में होती है. |
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 |
लाइफ़टाइम की अवधि में कितना डेटा सेव किया गया है या नहीं. |