- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- 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
के लिए जवाब देने वाला मैसेज. किसी इमारत की जगह, डाइमेंशन, और सौर ऊर्जा की क्षमता के बारे में जानकारी.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
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 किलोवाट घंटा प्रति किलोवाट (जहां मानक जांच की शर्तों के तहत, किलोवाट की क्षमता का मतलब kW की क्षमता है). |
carbonOffsetFactorKgPerMwh |
हर MWh की ग्रिड बिजली से होने वाले CO2 के बराबर मात्रा. यह सौर ऊर्जा के इस्तेमाल से, ग्रिड बिजली में होने वाले कार्बन उत्सर्जन का माप है. |
wholeRoofStats |
छत के उस हिस्से का कुल साइज़ और उस पर पड़ने वाली सूरज की रोशनी की संख्या. नाम होने के बावजूद, हो सकता है कि इसमें पूरी इमारत शामिल न हो. |
buildingStats |
पूरी इमारत के लिए साइज़ और धूप की जानकारी. इसमें छत के वे हिस्से भी शामिल हैं जिन्हें छत के कुछ हिस्सों के लिए असाइन नहीं किया गया था. इन हिस्सों का ओरिएंटेशन सही नहीं है. इसलिए, छत पर यह अनुमानित इलाका भरोसेमंद नहीं है. हालांकि, ज़मीन का अनुमानित हिस्सा भरोसेमंद है. ऐसा हो सकता है कि इमारत की पूरी छत के क्षेत्रफल के लिए, |
roofSegmentStats[] |
छत के हर हिस्से के लिए, साइज़ और धूप की मात्रा. |
solarPanels[] |
हर |
solarPanelConfigs[] |
हर |
financialAnalyses[] |
बिजली की सेवा देने वाली किसी कंपनी और हर महीने के बिल के आधार पर, |
SizeAndSunshineStats
छत या किसी छत का कोई हिस्सा या उसका साइज़ और धूप से बचने के लिए इस्तेमाल होने वाली संख्या.
JSON के काेड में दिखाना |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
फ़ील्ड | |
---|---|
areaMeters2 |
छत या छत के सेगमेंट का क्षेत्रफल, m^2 में. यह छत का क्षेत्रफल है (झुकाव के लिए), न कि ज़मीन के फ़ुटप्रिंट का क्षेत्र. |
sunshineQuantiles[] |
इस इलाके में अलग-अलग जगहों पर, जिन इलाकों में धूप पड़ती है उनकी संख्या. अगर यहां N वैल्यू हैं, तो इसका मतलब है कि (N-1)-ाइल्स को दिखाया गया है. उदाहरण के लिए, अगर वैल्यू की संख्या पांच है, तो वे क्वार्टाइल (कम से कम, 25%, 50%, 75%, ज़्यादा से ज़्यादा) होंगे. वैल्यू, सालाना kWh/kW में होती है, जैसे कि |
groundAreaMeters2 |
छत या छत के सेगमेंट से कवर किया गया, ग्राउंड फ़ुटप्रिंट का क्षेत्र, m^2 में. |
RoofSegmentSizeAndSunshineStats
छत के सेगमेंट का साइज़ और धूप से जुड़े होने की संख्या के बारे में जानकारी.
JSON के काेड में दिखाना |
---|
{ "stats": { object ( |
फ़ील्ड | |
---|---|
stats |
छत के सेगमेंट के लिए, कुल साइज़ और सूरज की रोशनी के आंकड़े. |
center |
छत के सेगमेंट के बीच वाले हिस्से के पास एक पॉइंट. |
boundingBox |
छत के सेगमेंट का बाउंडिंग बॉक्स. |
pitchDegrees |
सैद्धांतिक आधार पर सतह के सापेक्ष छत के हिस्से का कोण. 0 = ज़मीन के समानांतर, 90 = ज़मीन के लंबवत. |
azimuthDegrees |
कंपास की दिशा में छत का सेगमेंट दिख रहा है. 0 = उत्तर, 90 = पूर्व, 180 = दक्षिण. "फ़्लैट" के लिए छत का सेगमेंट ( |
planeHeightAtCenterMeters |
|
SolarPanel
सोलर पैनल से किसी सोलर पैनल की पोज़िशन, स्क्रीन की दिशा, और उसके बनने की जानकारी मिलती है. पैनल के पैरामीटर की जानकारी के लिए, SolarPotential
में panelHeightMeters
, panelWidthMeters
, और panelCapacityWatts
फ़ील्ड देखें.
JSON के काेड में दिखाना |
---|
{ "center": { object ( |
फ़ील्ड | |
---|---|
center |
पैनल के बीच में. |
orientation |
पैनल का ओरिएंटेशन. |
yearlyEnergyDcKwh |
यह लेआउट DC kWh में, एक साल के दौरान कितनी ऊर्जा का इस्तेमाल करता है. |
segmentIndex |
|
SolarPanelOrientation
सोलर पैनल का ओरिएंटेशन. इस तरीके का इस्तेमाल, छत के जिस सेगमेंट पर किया गया है उसके एज़िमथ के हिसाब से किया जाना चाहिए.
Enums | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
किसी भी पैनल ओरिएंटेशन की जानकारी नहीं है. |
LANDSCAPE |
LANDSCAPE पैनल का लंबा किनारे, छत के उस हिस्से के लंबवत दिशा में होता है जिस पर इसे छत के सेगमेंट पर रखा गया है. |
PORTRAIT |
PORTRAIT पैनल का लंबा किनारे, छत के जिस सेगमेंट पर लगाया गया है उसकी दिशा के समानांतर होता है. |
SolarPanelConfig
सोलर पैनल कॉन्फ़िगरेशन की मदद से यह बताया गया है कि छत पर सोलर पैनल किस जगह लगाए जा सकते हैं.
JSON के काेड में दिखाना |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
फ़ील्ड | |
---|---|
panelsCount |
पैनल की कुल संख्या. ध्यान दें कि यह |
yearlyEnergyDcKwh |
ऊपर बताए गए पैनल के हिसाब से, यह लेआउट एक साल के दौरान DC kWh में सूरज की कितनी ऊर्जा कैप्चर करता है. |
roofSegmentSummaries[] |
इस लेआउट में कम से कम एक पैनल वाले हर छत के सेगमेंट के प्रोडक्शन की जानकारी. |
RoofSegmentSummary
इमारत की छत के एक हिस्से के बारे में जानकारी, जिस पर कुछ पैनल लगाए गए हैं.
JSON के काेड में दिखाना |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
फ़ील्ड | |
---|---|
panelsCount |
इस सेगमेंट पर पैनल की कुल संख्या. |
yearlyEnergyDcKwh |
ऊपर बताए गए पैनल के हिसाब से, लेआउट का यह हिस्सा एक साल के दौरान DC kWh में कितनी ऊर्जा का इस्तेमाल करता है. |
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) यूनिट की संख्या. वैल्यू -9,99,99,999 और +9,99,99,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 |
पैनल इंस्टॉल होने के बाद, पहले 20 साल में हुई बचत. |
presentValueOfSavingsYear20 |
छूट की अनुमानित दर का इस्तेमाल करके, 20 साल की कुल बचत का मौजूदा वैल्यू क्या है? |
savingsLifetime |
पूरे पैनल में बचत. |
presentValueOfSavingsLifetime |
छूट की अनुमानित दर का इस्तेमाल करके, कुल लाइफ़टाइम से हुई बचत की मौजूदा वैल्यू क्या है? |
financiallyViable |
इससे पता चलता है कि यह वित्तीय स्थिति है या नहीं. यह विकल्प, खराब वित्तीय स्थिति वाले मामलों में 'गलत' होगा. उदाहरण के लिए, पैसे गंवाना. |
CashPurchaseSavings
बिजली की खपत के हिसाब से तय किए गए सोलर पैनल के कॉन्फ़िगरेशन को खरीदने की लागत और फ़ायदा.
JSON के काेड में दिखाना |
---|
{ "outOfPocketCost": { object ( |
फ़ील्ड | |
---|---|
outOfPocketCost |
टैक्स इंसेंटिव से पहले की शुरुआती कीमत: वह रकम जो चुकाना ज़रूरी है. |
upfrontCost |
टैक्स इंसेंटिव के बाद शुरुआती लागत: यह वह रकम है जो पहले साल के दौरान चुकानी होगी. |
rebateValue |
टैक्स पर मिलने वाली सभी छूट की वैल्यू. |
savings |
हमेशा के लिए कितनी बचत हुई है या नहीं. |
paybackYears |
पेबैक मिलने तक साल की संख्या. नेगेटिव वैल्यू का मतलब है कि लाइफ़टाइम पीरियड में कभी भी पैसा वापस नहीं लिया जाता. |
FinancedPurchaseSavings
बिजली की खपत की खास जानकारी वाले सोलर पैनल का एक खास कॉन्फ़िगरेशन खरीदने के लिए, क़र्ज़ की लागत और उससे मिलने वाला फ़ायदा.
JSON के काेड में दिखाना |
---|
{ "annualLoanPayment": { object ( |
फ़ील्ड | |
---|---|
annualLoanPayment |
क़र्ज़ का सालाना पेमेंट. |
rebateValue |
टैक्स पर मिलने वाली सभी छूट की वैल्यू (इसमें फ़ेडरल इन्वेस्टमेंट टैक्स क्रेडिट (आईटीसी) भी शामिल है). |
loanInterestRate |
कैलकुलेशन के इस सेट में, मान लिए गए क़र्ज़ पर लगने वाली ब्याज दर. |
savings |
हमेशा के लिए कितनी बचत हुई है या नहीं. |