- طلب HTTP
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- أموال
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- جرِّبه الآن
لتحديد موقع أقرب مبنى إلى نقطة طلب بحث. تعرض خطأ مع الرمز NOT_FOUND
إذا لم تكن هناك مبانٍ في نطاق 50 مترًا تقريبًا من نقطة طلب البحث.
طلب HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
يستخدم عنوان URL بنية تحويل الترميز 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 ساعة مشمسة = 1 كيلوواط في الساعة لكل كيلوواط (حيث تشير "كيلوواط" إلى السعة بموجب "شروط الاختبار العادية"). |
carbonOffsetFactorKgPerMwh |
كمية ثاني أكسيد الكربون المكافئة التي يتم إنتاجها لكل ميغاواط من الساعة من كهرباء الشبكة. هذا قياس لكثافة الكربون من الشبكة الكهربائية الناتجة عن الكهرباء التي يتم توليدها من الطاقة الشمسية. |
wholeRoofStats |
القيم الإجمالية للحجم وأشعة الشمس للجزء الذي تم تعيينه لجزء من السطح. على الرغم من الاسم، قد لا يشمل ذلك المبنى بالكامل. يمكنك الاطّلاع على |
buildingStats |
أجزاء الحجم وضوء الشمس للمبنى بأكمله، بما في ذلك أجزاء السقف التي لم يتم تخصيصها لجزء من السطح. وبسبب عدم تصنيف اتّجاهات هذه الأجزاء بشكل جيد، فإنّ تقدير مساحة السقف غير موثوق، ولكن تقدير مساحة الأرض بشكل موثوق به. قد يكون السبب أنّه يمكن الحصول على مساحة أكثر موثوقية لسقف المبنى بالكامل من خلال تحجيم مساحة السطح من |
roofSegmentStats[] |
أجزاء الحجم وضوء الشمس لكل جزء من السطح. |
solarPanels[] |
تصف كل |
solarPanelConfigs[] |
تصف كل |
financialAnalyses[] |
توفّر بطاقة " |
SizeAndSunshineStats
أجزاء الحجم والتعرُّض للسقف أو جزء من السقف
تمثيل JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
الحقول | |
---|---|
areaMeters2 |
مساحة السطح أو السقف بالمتر المربّع هذه هي منطقة السطح (مع مراعاة الإمالة)، وليس منطقة البصمة الأرضية. |
sunshineQuantiles[] |
الكميات من التلوث المتوسطات في جميع أنحاء المنطقة. إذا كانت هناك قيم N هنا، فإن هذا يمثل (N-1). على سبيل المثال، إذا كانت هناك 5 قيم، فستكون هي الأرباع (الحد الأدنى، 25%، 50%، 75%، الحد الأقصى). القيم السنوية بالكيلوواط ساعة/كيلوواط مثل |
groundAreaMeters2 |
مساحة البصمة الأرضية التي يغطيها جزء السطح أو السطح بالمتر المربّع. |
RoofSegmentSizeAndSunshineStats
يشير ذلك المصطلح إلى معلومات حول حجم جزء من السطح ودرجة تمويهه.
تمثيل JSON |
---|
{ "stats": { object ( |
الحقول | |
---|---|
stats |
إجمالي الحجم وكميات ضوء الشمس لجزء من السطح. |
center |
نقطة بالقرب من وسط الجزء من السطح. |
boundingBox |
المربع المحيط بجزء من السطح. |
pitchDegrees |
زاوية جزء السطح بالنسبة إلى مستوى الأرض النظري. 0 = موازٍ للأرض، 90 = عمودي للأرض. |
azimuthDegrees |
اتجاه البوصلة الذي يشير إليه جزء السطح. 0 = الشمال، 90 = الشرق، 180 = الجنوب. بالنسبة إلى جزء السطح "المسطح" ( |
planeHeightAtCenterMeters |
ارتفاع مستوى الجزء من السطح، بالمتر فوق مستوى سطح البحر، عند النقطة التي تحدّدها |
SolarPanel
تصف اللوحة الشمسية موضع واتجاه وإنتاج لوحة شمسية واحدة. اطّلِع على الحقول panelHeightMeters
وpanelWidthMeters
وpanelCapacityWatts
في SolarPotential
للحصول على معلومات عن معلَمات اللوحة.
تمثيل JSON |
---|
{ "center": { object ( |
الحقول | |
---|---|
center |
تمثّل هذه السمة منتصف اللوحة. |
orientation |
اتجاه اللوحة. |
yearlyEnergyDcKwh |
مقدار الطاقة الناتجة عن ضوء الشمس الذي يلتقطه هذا التخطيط على مدار العام بوحدة التحكّم في الطاقة (DC) كيلو واط في الساعة. |
segmentIndex |
المؤشر في |
SolarPanelOrientation
اتجاه اللوحة الشمسية. يجب تفسير ذلك بالنسبة إلى سمت جزء السطح الذي يتم وضع اللوحة عليه.
عمليات التعداد | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
لا يُعرف اتجاه اللوحة. |
LANDSCAPE |
تتميز لوحة LANDSCAPE بحافة طويلة بشكل عمودي مع اتجاه سمت جزء السطح الذي يتم وضعها عليه. |
PORTRAIT |
تتميز لوحة PORTRAIT بحافة طويلة متوازية مع اتجاه سمت جزء السطح الذي يتم وضعها عليه. |
SolarPanelConfig
تصف تقنية Solar PanelConfig وضعًا معينًا لألواح الطاقة الشمسية على السطح.
تمثيل 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
تفاصيل التحليل المالي. وقد سبق تخزين بعض هذه التفاصيل على مستويات أعلى (على سبيل المثال، المبالغ التي يتم تحصيلها من المتجر). يتجاوز إجمالي المبالغ المالية فترة زمنية محددة في الحقل panelLifetimeYears
في SolarPotential
. ملاحظة: يتم ذكر التكلفة الفعلية لشراء اللوحات في حقل outOfPocketCost
باللغة CashPurchaseSavings
.
تمثيل JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
الحقول | |
---|---|
initialAcKwhPerYear |
كم كيلوواط ساعة من التيار المتردد (AC) التي نعتقد أن الألواح الشمسية ستنتج عن عامها الأول. |
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 |
قيمة جميع الحسومات الضريبية (بما في ذلك الائتمان الضريبي على الاستثمار الفيدرالي (ITC)). |
loanInterestRate |
معدل الفائدة على القروض المفترض في هذه المجموعة من العمليات الحسابية. |
savings |
المبلغ الذي يتم توفيره (أو لا يتم توفيره) على مدار الفترة منذ الإنشاء. |