- طلب 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 |
مساحة السقف أو جزء السطح بالمتر 2. تشير هذه القيمة إلى مساحة السطح (مع مراعاة الإمالة)، وليست مساحة البصمة الأرضية. |
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
تصف Solar Panel موقع لوح شمسي واحد واتجاهه وإنتاجه. راجِع الحقول panelHeightMeters
وpanelWidthMeters
وpanelCapacityWatts
في SolarPotential
للحصول على معلومات عن مَعلمات اللوحة.
تمثيل JSON |
---|
{ "center": { object ( |
الحقول | |
---|---|
center |
منتصف اللوحة. |
orientation |
اتجاه اللوحة. |
yearlyEnergyDcKwh |
مقدار طاقة ضوء الشمس التي يلتقطها هذا التخطيط على مدار عام، بوحدة الكيلوواط في الساعة من التيار (DC). |
segmentIndex |
المؤشر في |
SolarPanelOrientation
اتجاه اللوحة الشمسية. يجب تفسير ذلك بالنسبة إلى سمت جزء السطح الذي يتم وضع اللوحة عليه.
عمليات التعداد | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
لا يعرف أي اتجاه للوحة. |
LANDSCAPE |
تكون حافة اللوحة LANDSCAPE عموديًا على اتجاه السمت لجزء السطح الذي يتم وضعها عليه. |
PORTRAIT |
تكون حافتها الطويلة موازية للوحة PORTRAIT مع اتجاه السمت لجزء السطح الذي يتم وضعها عليها. |
SolarPanelConfig
تصف SolarPartnerConfig موضعًا معينًا للألواح الشمسية على السطح.
تمثيل 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 |
كم عدد الكيلوواط في الساعة التي نعتقد أنّها ستنتج عن الألواح الشمسية في عامها الأول. |
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 |
مقدار ما يتم توفيره (أو لا يتم توفيره) على مدار الفترة منذ الإنشاء. |