Method: buildingInsights.findClosest

কোয়েরি পয়েন্টের সবচেয়ে কাছের ভবনটি খুঁজে বের করে। যদি কোয়েরি পয়েন্টের প্রায় ৫০ মিটারের মধ্যে কোনো ভবন না থাকে, তাহলে NOT_FOUND কোডসহ একটি ত্রুটি বার্তা দেখায়।

HTTP অনুরোধ

GET https://solar.googleapis.com/v1/buildingInsights:findClosest

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

কোয়েরি প্যারামিটার

প্যারামিটার
location

object ( LatLng )

প্রয়োজনীয়। দ্রাঘিমাংশ এবং অক্ষাংশ, যেখান থেকে এপিআই নিকটতম পরিচিত ভবনটি খুঁজে থাকে।

requiredQuality

enum ( ImageryQuality )

ঐচ্ছিক। ফলাফলে অনুমোদিত সর্বনিম্ন মানের স্তর। এর চেয়ে নিম্নমানের কোনো ফলাফল ফেরত দেওয়া হবে না। এটি উল্লেখ না করা শুধুমাত্র উচ্চ মানের মধ্যে সীমাবদ্ধ রাখার সমতুল্য।

exactQualityRequired

boolean

ঐচ্ছিক। ছবির সঠিক গুণমান প্রয়োজন হবে কিনা। যদি 'false' সেট করা হয়, তাহলে ' requiredQuality ফিল্ডটিকে সর্বনিম্ন প্রয়োজনীয় গুণমান হিসেবে গণ্য করা হবে, যার ফলে requiredQuality 'MEDIUM'-এ সেট করা হলেও 'HIGH' গুণমানের ছবি ফেরত দেওয়া হতে পারে। যদি 'true' সেট করা হয়, তাহলে requiredQuality সঠিক প্রয়োজনীয় গুণমান হিসেবে গণ্য করা হবে এবং requiredQuality MEDIUM এ সেট করা হলে শুধুমাত্র MEDIUM গুণমানের ছবিই ফেরত দেওয়া হবে।

experiments[]

enum ( Experiment )

ঐচ্ছিক। কোন প্রি-জিএ এক্সপেরিমেন্টগুলো সক্রিয় করতে হবে তা নির্দিষ্ট করে। এই ফিল্ড ব্যবহার করে করা অনুরোধগুলো Google Maps Platform Service Specific Terms-এর অধীনে একটি প্রি-জিএ অফারিং হিসেবে শ্রেণীবদ্ধ করা হয়। আরও বিস্তারিত জানতে লঞ্চ পর্যায়ের বিবরণ দেখুন।

additionalInsights[]

enum ( AdditionalInsights )

ঐচ্ছিক। উত্তরে অন্তর্ভুক্ত করার জন্য additionalInsights একটি তালিকা।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

Solar.FindClosestBuildingInsights এর প্রতিক্রিয়া বার্তা। একটি ভবনের অবস্থান, আয়তন এবং সৌর সম্ভাবনা সম্পর্কিত তথ্য।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা
{
  "name": string,
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "postalCode": string,
  "administrativeArea": string,
  "statisticalArea": string,
  "regionCode": string,
  "solarPotential": {
    object (SolarPotential)
  },
  "imageryQuality": enum (ImageryQuality),
  "detectedArrays": {
    object (DetectedArrays)
  }
}
ক্ষেত্র
name

string

বিল্ডিংটির রিসোর্স নাম, যা buildings/{place_id} ফরম্যাটের হয়ে থাকে।

center

object ( LatLng )

ভবনটির কেন্দ্রস্থলের নিকটবর্তী একটি বিন্দু।

boundingBox

object ( LatLngBox )

ভবনটির বাউন্ডিং বক্স।

imageryDate

object ( Date )

যে তারিখে মূল চিত্রাবলী সংগ্রহ করা হয়েছিল। এটি একটি আনুমানিক তারিখ।

imageryProcessedDate

object ( Date )

যখন এই চিত্রাবলীর প্রক্রিয়াকরণ সম্পন্ন হয়েছিল

postalCode

string

যে পোস্টাল কোডের (যেমন, মার্কিন জিপ কোড) আওতায় এই ভবনটি অবস্থিত।

administrativeArea

string

প্রশাসনিক এলাকা ১ (যেমন, মার্কিন যুক্তরাষ্ট্রে, রাজ্য) যার মধ্যে এই ভবনটি অবস্থিত। উদাহরণস্বরূপ, মার্কিন যুক্তরাষ্ট্রে এর সংক্ষিপ্ত রূপ হতে পারে "MA" বা "CA"।

statisticalArea

string

এই ভবনটি যে পরিসংখ্যানগত এলাকায় (যেমন, মার্কিন আদমশুমারি এলাকা) অবস্থিত।

regionCode

string

এই ভবনটি যে দেশ (বা অঞ্চলে) অবস্থিত, তার অঞ্চল কোড।

solarPotential

object ( SolarPotential )

ভবনটির সৌর সম্ভাবনা।

imageryQuality

enum ( ImageryQuality )

এই ভবনটির ডেটা গণনা করতে ব্যবহৃত চিত্রাবলীর গুণমান।

detectedArrays

object ( DetectedArrays )

ভবনটিতে সোলার অ্যারে সনাক্ত করা হয়েছে। এই ফিল্ডটি কেবল তখনই পূরণ করা হয়, যদি রিকোয়েস্টের FindClosestBuildingInsightsRequest.additional_insights এ DETECTED_ARRAYS অন্তর্ভুক্ত থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/cloud-platform

অতিরিক্ত অন্তর্দৃষ্টি

বিল্ডিংইনসাইটস-এ ছাদের জ্যামিতিক গঠন এবং সোলার প্যানেল অ্যারের মতো ভবনের অতিরিক্ত তথ্য পাওয়া যেতে পারে।

এনাম
ADDITIONAL_INSIGHTS_UNSPECIFIED ডিফল্ট মান। ডিফল্ট BuildingInsights ফেরত দেওয়া হবে।
DETECTED_ARRAYS

প্রতিক্রিয়াটিতে শনাক্তকৃত অ্যারেগুলো অন্তর্ভুক্ত হবে কিনা তা নির্ধারণ করে।

নির্দিষ্ট করা থাকলে, রেসপন্সের detectedArrays ফিল্ডটি পূরণ করা হবে।

LatLngBox

অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কে একটি বাউন্ডিং বক্স।

JSON উপস্থাপনা
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
ক্ষেত্র
sw

object ( LatLng )

বাক্সটির দক্ষিণ-পশ্চিম কোণ।

ne

object ( LatLng )

বাক্সটির উত্তর-পূর্ব কোণ।

সোলারপোটেনশিয়াল

একটি ভবনের সৌর সম্ভাবনা সম্পর্কিত তথ্য। এর মধ্যে বেশ কিছু ফিল্ড 'প্যানেল'-এর পরিপ্রেক্ষিতে সংজ্ঞায়িত করা হয়েছে। panelCapacityWatts , panelHeightMeters এবং panelWidthMeters ফিল্ডগুলো এই গণনাগুলোতে ব্যবহৃত প্যানেল মডেলের প্যারামিটারগুলো বর্ণনা করে।

JSON উপস্থাপনা
{
  "maxArrayPanelsCount": integer,
  "panelCapacityWatts": number,
  "panelHeightMeters": number,
  "panelWidthMeters": number,
  "panelLifetimeYears": integer,
  "maxArrayAreaMeters2": number,
  "maxSunshineHoursPerYear": number,
  "carbonOffsetFactorKgPerMwh": number,
  "wholeRoofStats": {
    object (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}
ক্ষেত্র
maxArrayPanelsCount

integer

সর্বোচ্চ অ্যারের আকার — অর্থাৎ, ছাদে সর্বাধিক যতগুলো প্যানেল বসানো যায়।

panelCapacityWatts

number

গণনায় ব্যবহৃত প্যানেলটির ক্ষমতা, ওয়াট এককে।

panelHeightMeters

number

গণনার জন্য ব্যবহৃত প্যানেলটির উল্লম্ব অভিমুখের উচ্চতা, মিটারে।

panelWidthMeters

number

গণনার জন্য ব্যবহৃত প্যানেলটির উল্লম্ব অবস্থানে প্রস্থ, মিটারে।

panelLifetimeYears

integer

সৌর প্যানেলগুলোর প্রত্যাশিত আয়ুষ্কাল, যা বছরে পরিমাপ করা হয়। এটি আর্থিক হিসাব-নিকাশে ব্যবহৃত হয়।

maxArrayAreaMeters2

number

সর্বোচ্চ অ্যারের আকার, বর্গমিটারে।

maxSunshineHoursPerYear

number

ছাদের যেকোনো বিন্দুতে প্রতি বছর প্রাপ্ত সর্বাধিক সূর্যালোকের ঘণ্টা। সূর্যালোকের ঘণ্টা হলো প্রতি বছর প্রাপ্ত মোট সৌর বিকিরণ (শক্তি)-এর একটি পরিমাপ। ১ সূর্যালোকের ঘণ্টা = ১ kWh প্রতি kW (যেখানে kW বলতে আদর্শ পরীক্ষার শর্তাধীনে ক্ষমতার kW বোঝায়)।

carbonOffsetFactorKgPerMwh

number

প্রতি মেগাওয়াট-ঘণ্টা গ্রিড বিদ্যুতের জন্য উৎপাদিত কার্বন ডাই অক্সাইডের সমতুল্য পরিমাণ। এটি সৌর বিদ্যুৎ দ্বারা প্রতিস্থাপিত গ্রিড বিদ্যুতের কার্বন তীব্রতার একটি পরিমাপ।

wholeRoofStats

object ( SizeAndSunshineStats )

ছাদের যে অংশটি কোনো রুফ সেগমেন্টের অন্তর্ভুক্ত করা হয়েছে, তার মোট আয়তন এবং সূর্যালোকের কোয়ান্টাইল। নাম শুনে মনে হলেও, এতে সম্পূর্ণ ভবনটি অন্তর্ভুক্ত নাও থাকতে পারে। buildingStats দেখুন।

buildingStats

object ( SizeAndSunshineStats )

সম্পূর্ণ ভবনটির আকার এবং সূর্যালোকের কোয়ান্টাইল, যার মধ্যে ছাদের সেই অংশগুলোও অন্তর্ভুক্ত যা কোনো ছাদ খণ্ডে নির্ধারিত ছিল না। যেহেতু এই অংশগুলোর অভিমুখ ভালোভাবে চিহ্নিত করা নেই, তাই ছাদের ক্ষেত্রফলের অনুমানটি নির্ভরযোগ্য নয়, কিন্তু ভূমির ক্ষেত্রফলের অনুমানটি নির্ভরযোগ্য। এমন হতে পারে যে, buildingStats এবং wholeRoofStats এর ভূমির ক্ষেত্রফলের অনুপাত দ্বারা wholeRoofStats থেকে প্রাপ্ত ছাদের ক্ষেত্রফলকে স্কেল করে সম্পূর্ণ ভবনের ছাদের ক্ষেত্রফলের একটি আরও নির্ভরযোগ্য মান পাওয়া যেতে পারে।

roofSegmentStats[]

object ( RoofSegmentSizeAndSunshineStats )

প্রতিটি ছাদের অংশের আকার এবং সূর্যালোকের কোয়ান্টাইল।

solarPanels[]

object ( SolarPanel )

প্রতিটি SolarPanel একটি একক সৌর প্যানেলকে বোঝায়। প্যানেল লেআউট অ্যালগরিদম যে ক্রমে এগুলোকে স্থাপন করেছে, সেই ক্রমেই তালিকাভুক্ত করা হয়েছে। এটি সাধারণত, যদিও সবসময় নয়, বার্ষিক শক্তি উৎপাদনের ক্রমহ্রাসমান অনুসারে সাজানো থাকে।

solarPanelConfigs[]

object ( SolarPanelConfig )

প্রতিটি SolarPanelConfig ছাদে সোলার প্যানেলের একটি ভিন্ন বিন্যাস বর্ণনা করে। এগুলি প্যানেলের সংখ্যা বৃদ্ধির ক্রমানুসারে সাজানো থাকে। panelsCount =N সহ SolarPanelConfig টি solarPanels তালিকার প্রথম N সংখ্যক প্যানেলের উপর ভিত্তি করে তৈরি। এই ফিল্ডটি কেবল তখনই পূরণ করা হয় যখন একটি ছাদে কমপক্ষে ৪টি প্যানেল বসানো যায়।

financialAnalyses[]

object ( FinancialAnalysis )

একটি FinancialAnalysis একটি নির্দিষ্ট মাসিক বিল এবং একটি নির্দিষ্ট বিদ্যুৎ সরবরাহকারী প্রতিষ্ঠানের উপর ভিত্তি করে সৌরশক্তি ব্যবহারের ফলে কী পরিমাণ সাশ্রয় হবে তা দেখায়। এগুলি মাসিক বিলের পরিমাণ অনুযায়ী ক্রমবর্ধমান ক্রমে সাজানো থাকে। যেসব এলাকার ভবনগুলির জন্য সোলার এপিআই (Solar API)-এর কাছে আর্থিক গণনা করার মতো পর্যাপ্ত তথ্য নেই, সেগুলির ক্ষেত্রে এই ক্ষেত্রটি খালি থাকবে।

সাইজঅ্যান্ডসানশাইনস্ট্যাটস

একটি ছাদ বা ছাদের কোনো অংশের আকার এবং সূর্যালোকের পরিমাণ।

JSON উপস্থাপনা
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
ক্ষেত্র
areaMeters2

number

ছাদ বা ছাদের অংশের ক্ষেত্রফল, বর্গমিটারে। এটি ছাদের ক্ষেত্রফল (ঢাল বিবেচনা করে), ভূমির উপরিতলের ক্ষেত্রফল নয়।

sunshineQuantiles[]

number

এলাকা জুড়ে বিন্দুভিত্তিক সূর্যালোকের কোয়ান্টাইল। এখানে যদি N সংখ্যক মান থাকে, তবে এটি (N-1)-টি কোয়ান্টাইলকে বোঝায়। উদাহরণস্বরূপ, যদি ৫টি মান থাকে, তবে সেগুলো হবে কোয়ার্টাইল (সর্বনিম্ন, ২৫%, ৫০%, ৭৫%, সর্বোচ্চ)। মানগুলো বার্ষিক kWh/kW এককে প্রকাশ করা হয়, যেমন maxSunshineHoursPerYear

groundAreaMeters2

number

ছাদ বা ছাদের অংশ দ্বারা আচ্ছাদিত ভূমির ক্ষেত্রফল, বর্গমিটারে (m^2)।

ছাদের অংশের আকার এবং সূর্যালোকের পরিসংখ্যান

ছাদের একটি অংশের আকার এবং সূর্যালোকের পরিমাণ সম্পর্কিত তথ্য।

JSON উপস্থাপনা
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
ক্ষেত্র
stats

object ( SizeAndSunshineStats )

ছাদের অংশের মোট আকার এবং সূর্যালোকের পরিমাণ।

center

object ( LatLng )

ছাদের অংশটির কেন্দ্রস্থলের নিকটবর্তী একটি বিন্দু।

boundingBox

object ( LatLngBox )

ছাদের অংশের বাউন্ডিং বক্স।

pitchDegrees

number

তাত্ত্বিক ভূমি তলের সাপেক্ষে ছাদের অংশের কোণ। 0 = ভূমির সমান্তরাল, 90 = ভূমির লম্ব।

azimuthDegrees

number

ছাদের অংশটি যে দিক নির্দেশ করছে। ০ = উত্তর, ৯০ = পূর্ব, ১৮০ = দক্ষিণ। একটি 'সমতল' ছাদের অংশের জন্য ( pitchDegrees ০-এর খুব কাছাকাছি), অ্যাজিমুথ ভালোভাবে সংজ্ঞায়িত হয় না, তাই সামঞ্জস্য রক্ষার জন্য, আমরা এটিকে ইচ্ছামতো ০ (উত্তর) হিসাবে সংজ্ঞায়িত করি।

planeHeightAtCenterMeters

number

center দ্বারা চিহ্নিত বিন্দুতে, সমুদ্রপৃষ্ঠ থেকে মিটারে পরিমাপকৃত ছাদের খণ্ডাংশের তলের উচ্চতা। পিচ, অ্যাজিমুথ এবং কেন্দ্রের অবস্থানের সাথে একত্রে এটি ছাদের খণ্ডাংশের তলটিকে সম্পূর্ণরূপে সংজ্ঞায়িত করে।

সোলারপ্যানেল

সোলারপ্যানেল একটি একক সৌর প্যানেলের অবস্থান, অভিমুখ এবং উৎপাদন বর্ণনা করে। প্যানেলের প্যারামিটার সম্পর্কিত তথ্যের জন্য SolarPotential -এর panelHeightMeters , panelWidthMeters এবং panelCapacityWatts ফিল্ডগুলো দেখুন।

JSON উপস্থাপনা
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
ক্ষেত্র
center

object ( LatLng )

প্যানেলের কেন্দ্র।

orientation

enum ( SolarPanelOrientation )

প্যানেলটির অভিমুখ।

yearlyEnergyDcKwh

number

এই বিন্যাসটি এক বছরে কী পরিমাণ সূর্যালোক শক্তি সংগ্রহ করে, তা ডিসি কিলোওয়াট-ঘণ্টা (dc kWh) এককে প্রকাশ করা হলো।

segmentIndex

integer

RoofSegmentSizeAndSunshineStats এর roofSegmentStats এ থাকা সূচক, যা এই প্যানেলটি যে ছাদের অংশে স্থাপন করা হয়েছে তার সাথে সঙ্গতিপূর্ণ।

সৌর প্যানেলের অভিমুখ

সৌর প্যানেলের অভিমুখ। এটিকে অবশ্যই ছাদের সেই অংশের অ্যাজিমুথের সাপেক্ষে ব্যাখ্যা করতে হবে, যার উপর প্যানেলটি স্থাপন করা হয়েছে।

এনাম
SOLAR_PANEL_ORIENTATION_UNSPECIFIED প্যানেলের অভিমুখ জানা নেই।
LANDSCAPE একটি LANDSCAPE প্যানেলের দীর্ঘ প্রান্তটি, যে ছাদের অংশের উপর এটি স্থাপন করা হয়, তার অ্যাজিমুথ দিকের সাথে লম্বভাবে থাকে।
PORTRAIT একটি PORTRAIT প্যানেলের দীর্ঘ প্রান্তটি, এটিকে যে ছাদের অংশের উপর স্থাপন করা হয় তার অ্যাজিমুথ দিকের সমান্তরাল থাকে।

সোলারপ্যানেলকনফিগ

SolarPanelConfig ছাদে সৌর প্যানেলের একটি নির্দিষ্ট অবস্থান বর্ণনা করে।

JSON উপস্থাপনা
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
ক্ষেত্র
panelsCount

integer

প্যানেলের মোট সংখ্যা। উল্লেখ্য যে, এটি roofSegmentSummaries এর সংশ্লিষ্ট ফিল্ডগুলোর (যোগফলের) জন্য অপ্রয়োজনীয়।

yearlyEnergyDcKwh

number

উপরে বর্ণিত প্যানেলগুলো ধরে নিলে, এই বিন্যাসটি এক বছরে কী পরিমাণ সূর্যালোক শক্তি সংগ্রহ করে, তা ডিসি কিলোওয়াট-ঘণ্টা (dc kWh) এককে।

roofSegmentSummaries[]

object ( RoofSegmentSummary )

এই বিন্যাসে অন্তত একটি প্যানেল বহনকারী প্রতিটি ছাদের অংশের উৎপাদন সম্পর্কিত তথ্য। roofSegmentSummaries[i] i-তম ছাদের অংশের বর্ণনা দেয়, যার মধ্যে এর আকার, প্রত্যাশিত উৎপাদন এবং অভিমুখ অন্তর্ভুক্ত রয়েছে।

ছাদের অংশের সারাংশ

ভবনটির ছাদের একটি অংশ সম্পর্কিত তথ্য, যার উপর কিছু সংখ্যক প্যানেল স্থাপন করা আছে।

JSON উপস্থাপনা
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
ক্ষেত্র
panelsCount

integer

এই অংশে প্যানেলের মোট সংখ্যা।

yearlyEnergyDcKwh

number

উপরে বর্ণিত প্যানেলগুলো ধরে নিলে, লেআউটের এই অংশটি এক বছরে কী পরিমাণ সূর্যালোক শক্তি সংগ্রহ করে, তা ডিসি কিলোওয়াট-ঘণ্টা (dc kWh) এককে প্রকাশ করুন।

pitchDegrees

number

তাত্ত্বিক ভূমি তলের সাপেক্ষে ছাদের অংশের কোণ। 0 = ভূমির সমান্তরাল, 90 = ভূমির লম্ব।

azimuthDegrees

number

ছাদের অংশটি যে দিক নির্দেশ করছে। ০ = উত্তর, ৯০ = পূর্ব, ১৮০ = দক্ষিণ। একটি 'সমতল' ছাদের অংশের জন্য ( pitchDegrees ০-এর খুব কাছাকাছি), অ্যাজিমুথ ভালোভাবে সংজ্ঞায়িত হয় না, তাই সামঞ্জস্য রক্ষার জন্য, আমরা এটিকে ইচ্ছামতো ০ (উত্তর) হিসাবে সংজ্ঞায়িত করি।

segmentIndex

integer

roofSegmentStats এ সংশ্লিষ্ট RoofSegmentSizeAndSunshineStats এর সূচক।

আর্থিক বিশ্লেষণ

একটি নির্দিষ্ট বিদ্যুৎ বিলের পরিমাণের জন্য সর্বোত্তম সৌর বিন্যাসের ব্যয় ও সুবিধার বিশ্লেষণ।

JSON উপস্থাপনা
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
ক্ষেত্র
monthlyBill

object ( Money )

এই বিশ্লেষণে মাসিক বিদ্যুৎ বিলটি ধরে নেওয়া হয়েছে।

defaultBill

boolean

এই বিল্ডিংটি যে এলাকায় অবস্থিত, সেই এলাকার জন্য ডিফল্ট বিল হিসেবে এই বিলের আকারটিই নির্বাচিত হয়েছে কিনা। BuildingSolarPotential এর মধ্যে থাকা ঠিক একটি FinancialAnalysisdefaultBill সেট করা থাকা উচিত।

averageKwhPerMonth

number

বিলের পরিমাণ এবং স্থানীয় বিদ্যুতের হারের উপর ভিত্তি করে, একটি বাড়ি মাসে গড়ে কী পরিমাণ বিদ্যুৎ ব্যবহার করে।

financialDetails

object ( FinancialDetails )

অর্থায়নের পদ্ধতি নির্বিশেষে প্রযোজ্য আর্থিক তথ্য।

leasingSavings

object ( LeasingSavings )

সৌর প্যানেল লিজ নেওয়ার খরচ ও সুবিধা।

cashPurchaseSavings

object ( CashPurchaseSavings )

নগদ টাকায় সোলার প্যানেল কেনার খরচ ও সুবিধা।

financedPurchaseSavings

object ( FinancedPurchaseSavings )

অর্থায়নের মাধ্যমে সোলার প্যানেল কেনার খরচ ও সুবিধা।

panelConfigIndex

integer

এই বিলের আকারের জন্য সর্বোত্তম সোলার লেআউটের সূচকটি solarPanelConfigs এ রয়েছে। এর মান -১ হতে পারে, যা নির্দেশ করে যে কোনো লেআউট নেই। এই ক্ষেত্রে, বাকি উপ-বার্তাগুলো বাদ দেওয়া হবে।

টাকা

মুদ্রার ধরণসহ টাকার পরিমাণকে বোঝায়।

JSON উপস্থাপনা
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
ক্ষেত্র
currencyCode

string

ISO 4217-এ সংজ্ঞায়িত তিন অক্ষরের মুদ্রা কোড।

units

string ( int64 format)

পরিমাণের পূর্ণ একক। উদাহরণস্বরূপ, যদি currencyCode "USD" হয়, তাহলে ১ একক হলো এক মার্কিন ডলার।

nanos

integer

পরিমাণের ন্যানো (10^-9) এককের সংখ্যা। মানটি অবশ্যই -999,999,999 এবং +999,999,999 এর মধ্যে হতে হবে। যদি units ধনাত্মক হয়, তবে nanos অবশ্যই ধনাত্মক বা শূন্য হতে হবে। যদি units শূন্য হয়, তবে nanos ধনাত্মক, শূন্য বা ঋণাত্মক হতে পারে। যদি units ঋণাত্মক হয়, তবে nanos অবশ্যই ঋণাত্মক বা শূন্য হতে হবে। উদাহরণস্বরূপ, -1.75 কে units = -1 এবং nanos = -750,000,000 হিসাবে প্রকাশ করা হয়।

আর্থিক বিবরণ

একটি আর্থিক বিশ্লেষণের বিবরণ। এই বিবরণগুলির কিছু অংশ ইতিমধ্যেই উচ্চতর স্তরে সংরক্ষিত আছে (যেমন, নগদ খরচ)। মোট টাকার পরিমাণ একটি জীবনকালব্যাপী সময়ের জন্য প্রযোজ্য, যা SolarPotential এর panelLifetimeYears ফিল্ড দ্বারা সংজ্ঞায়িত। দ্রষ্টব্য: প্যানেল কেনার নগদ খরচ CashPurchaseSavings এর outOfPocketCost ফিল্ডে দেওয়া আছে।

JSON উপস্থাপনা
{
  "initialAcKwhPerYear": number,
  "remainingLifetimeUtilityBill": {
    object (Money)
  },
  "federalIncentive": {
    object (Money)
  },
  "stateIncentive": {
    object (Money)
  },
  "utilityIncentive": {
    object (Money)
  },
  "lifetimeSrecTotal": {
    object (Money)
  },
  "costOfElectricityWithoutSolar": {
    object (Money)
  },
  "netMeteringAllowed": boolean,
  "solarPercentage": number,
  "percentageExportedToGrid": number
}
ক্ষেত্র
initialAcKwhPerYear

number

আমাদের মতে সোলার প্যানেলগুলো প্রথম বছরে কত এসি kWh বিদ্যুৎ উৎপাদন করবে।

remainingLifetimeUtilityBill

object ( Money )

প্যানেলগুলোর জীবনকাল জুড়ে, সৌরশক্তি দ্বারা উৎপাদিত নয় এমন বিদ্যুতের ইউটিলিটি বিল।

federalIncentive

object ( Money )

কেন্দ্রীয় প্রণোদনা থেকে প্রাপ্ত অর্থের পরিমাণ; এটি প্রযোজ্য হবে যদি ব্যবহারকারী (ঋণসহ বা ঋণ ছাড়া) প্যানেলগুলো ক্রয় করেন।

stateIncentive

object ( Money )

রাষ্ট্রীয় প্রণোদনা থেকে প্রাপ্ত অর্থের পরিমাণ; এটি প্রযোজ্য হবে যদি ব্যবহারকারী (ঋণসহ বা ঋণ ছাড়া) প্যানেলগুলো ক্রয় করেন।

utilityIncentive

object ( Money )

পরিষেবা প্রণোদনা থেকে প্রাপ্ত অর্থের পরিমাণ; এটি প্রযোজ্য হবে যদি ব্যবহারকারী (ঋণসহ বা ঋণ ছাড়া) প্যানেলগুলো ক্রয় করেন।

lifetimeSrecTotal

object ( Money )

প্যানেলের জীবনকাল জুড়ে সোলার রিনিউয়েবল এনার্জি ক্রেডিট থেকে ব্যবহারকারী যে পরিমাণ অর্থ পাবেন; এটি প্রযোজ্য হবে যদি ব্যবহারকারী (ঋণ সহ বা ঋণ ছাড়া) প্যানেলগুলো কেনেন।

costOfElectricityWithoutSolar

object ( Money )

সৌরশক্তি স্থাপন না করলে ব্যবহারকারীকে তার জীবনকাল জুড়ে মোট বিদ্যুৎ খরচ দিতে হতো।

netMeteringAllowed

boolean

নেট মিটারিং অনুমোদিত কিনা।

solarPercentage

number

ব্যবহারকারীর মোট বিদ্যুতের শতকরা হার (০-১০০), যা সৌরশক্তি থেকে সরবরাহ করা হয়। এটি প্রথম বছরের জন্য প্রযোজ্য, তবে পরবর্তী বছরগুলোর জন্য আনুমানিকভাবে সঠিক।

percentageExportedToGrid

number

প্রথম ত্রৈমাসিকের উৎপাদনের উপর ভিত্তি করে, আমরা ধরে নিয়েছি যে সৌরবিদ্যুৎ উৎপাদনের শতকরা হার (০-১০০) গ্রিডে সরবরাহ করা হয়েছে। নেট মিটারিং অনুমোদিত না হলে এটি হিসাবকে প্রভাবিত করে।

লিজিং সেভিংস

একটি নির্দিষ্ট বিদ্যুৎ ব্যবহারসহ একটি নির্দিষ্ট কনফিগারেশনের সোলার প্যানেল লিজ নেওয়ার খরচ ও সুবিধা।

JSON উপস্থাপনা
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
ক্ষেত্র
leasesAllowed

boolean

এই এখতিয়ারে ইজারা অনুমোদিত কিনা (কিছু রাজ্যে ইজারা অনুমোদিত নয়)। যদি এই ক্ষেত্রটি 'false' হয়, তাহলে এই বার্তার মানগুলি সম্ভবত উপেক্ষা করা উচিত।

leasesSupported

boolean

এই এখতিয়ারে আর্থিক গণনা ইঞ্জিন দ্বারা লিজ সমর্থিত কিনা। যদি এই ফিল্ডটি 'ফলস' হয়, তাহলে এই বার্তার মানগুলি সম্ভবত উপেক্ষা করা উচিত। এটি leasesAllowed থেকে স্বাধীন: কিছু এলাকায় লিজ অনুমোদিত, কিন্তু এমন শর্তে যা আর্থিক মডেল দ্বারা পরিচালিত হয় না।

annualLeasingCost

object ( Money )

আনুমানিক বার্ষিক লিজ খরচ।

savings

object ( SavingsOverTime )

জীবনকাল জুড়ে কতটা সঞ্চয় হয় (বা হয় না)।

সময়ের সাথে সাথে সঞ্চয়

বিভিন্ন অর্থায়ন পদ্ধতির মধ্যে আদান-প্রদান করা আর্থিক তথ্য।

JSON উপস্থাপনা
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
ক্ষেত্র
savingsYear1

object ( Money )

প্যানেল স্থাপনের পর প্রথম বছরে সাশ্রয়।

savingsYear20

object ( Money )

প্যানেল স্থাপনের পর প্রথম বিশ বছরে সাশ্রয়।

presentValueOfSavingsYear20

object ( Money )

অনুমিত বাট্টার হার ব্যবহার করে, বিগত ২০ বছরের পুঞ্জীভূত সঞ্চয়ের বর্তমান মূল্য কত?

savingsLifetime

object ( Money )

প্যানেলের সম্পূর্ণ জীবনকাল জুড়ে সাশ্রয়।

presentValueOfSavingsLifetime

object ( Money )

অনুমিত বাট্টার হার ব্যবহার করে, আজীবন সঞ্চিত অর্থের বর্তমান মূল্য কত?

financiallyViable

boolean

এই পরিস্থিতিটি আর্থিকভাবে টেকসই কিনা তা নির্দেশ করে। দুর্বল আর্থিক টেকসই পরিস্থিতিগুলোর (যেমন, লোকসানজনক) ক্ষেত্রে এটি মিথ্যা হবে।

নগদ ক্রয় সঞ্চয়

একটি নির্দিষ্ট বিদ্যুৎ ব্যবহার ক্ষমতাসম্পন্ন, বিশেষ বিন্যাসের সৌর প্যানেল সরাসরি ক্রয়ের খরচ ও সুবিধা।

JSON উপস্থাপনা
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
ক্ষেত্র
outOfPocketCost

object ( Money )

কর ছাড়ের পূর্বের প্রাথমিক খরচ: যে পরিমাণ অর্থ সরাসরি নিজের পকেট থেকে পরিশোধ করতে হয়। এর বিপরীতে রয়েছে upfrontCost , যা কর ছাড়ের পরের খরচ।

upfrontCost

object ( Money )

কর ছাড়ের পর প্রাথমিক খরচ: এটি সেই পরিমাণ অর্থ যা প্রথম বছরে অবশ্যই পরিশোধ করতে হবে। এর বিপরীতে রয়েছে outOfPocketCost , যা কর ছাড়ের আগের খরচ।

rebateValue

object ( Money )

সকল কর ছাড়ের মূল্য।

savings

object ( SavingsOverTime )

জীবনকাল জুড়ে কতটা সঞ্চয় হয় (বা হয় না)।

paybackYears

number

বিনিয়োগ ফেরত আসতে যে কয় বছর সময় লাগে। ঋণাত্মক মানের অর্থ হলো, জীবনকালের মধ্যে বিনিয়োগ কখনোই ফেরত আসে না।

অর্থায়নকৃত ক্রয় সঞ্চয়

একটি নির্দিষ্ট বিদ্যুৎ ব্যবহার ক্ষমতাসম্পন্ন বিশেষ কনফিগারেশনের সোলার প্যানেল কেনার জন্য ঋণ ব্যবহারের খরচ ও সুবিধা।

JSON উপস্থাপনা
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
ক্ষেত্র
annualLoanPayment

object ( Money )

বার্ষিক ঋণ পরিশোধ।

rebateValue

object ( Money )

সকল কর ছাড়ের মূল্য (ফেডারেল ইনভেস্টমেন্ট ট্যাক্স ক্রেডিট (আইটিসি) সহ)।

loanInterestRate

number

এই গণনার ক্ষেত্রে ঋণের উপর যে সুদের হার ধরা হয়েছে।

savings

object ( SavingsOverTime )

জীবনকাল জুড়ে কতটা সঞ্চয় হয় (বা হয় না)।

সনাক্তকৃত অ্যারে

ভবনটিতে সোলার প্যানেল শনাক্ত হওয়ার তথ্য।

JSON উপস্থাপনা
{
  "detectionStatus": enum (DetectionStatus),
  "latestCaptureDate": {
    object (Date)
  }
}
ক্ষেত্র
detectionStatus

enum ( DetectionStatus )

এই ভবনের সোলার অ্যারেগুলোর শনাক্তকরণের অবস্থা নির্দেশ করে।

latestCaptureDate

object ( Date )

সর্বশেষ সোলার অ্যারে ডেটা সংগ্রহের তারিখ।

সনাক্তকরণ স্থিতি

এই ভবনের সোলার অ্যারেগুলোর শনাক্তকরণের অবস্থা নির্দেশ করে।

এনাম
DETECTION_STATUS_UNSPECIFIED অনির্দিষ্ট অবস্থা।
DETECTION_STATUS_DATA_UNAVAILABLE এই ভবনের জন্য শনাক্তকৃত সোলার অ্যারের ডেটা অনুপলব্ধ।
DETECTION_STATUS_ARRAYS_DETECTED এই ভবনটির জন্য অন্তত একটি সৌর প্যানেল শনাক্ত করা হয়েছে।
DETECTION_STATUS_NO_ARRAYS_DETECTED এই ভবনের জন্য কোনো সৌর প্যানেল শনাক্ত করা যায়নি।