تغطية موسّعة (ميزة تجريبية)

مطوّرو المنطقة الاقتصادية الأوروبية

إذا كان عنوان الفوترة الخاص بك يقع في المنطقة الاقتصادية الأوروبية، ستسري بنود خدمة المنطقة الاقتصادية الأوروبية في "منصة خرائط Google" على استخدامك للخدمات اعتبارًا من 8 تموز (يوليو) 2025. مزيد من المعلومات بالإضافة إلى ذلك، لن يتم عرض بعض المحتوى من Solar API. مزيد من المعلومات

هذا المنتج أو الميزة تجريبي (مرحلة ما قبل الإصدار العام). قد يكون الدعم المقدّم للمنتجات والميزات في مرحلة ما قبل التوفّر للجمهور العام محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على المنتجات والميزات في مرحلة ما قبل التوفّر للجمهور العام متوافقة مع الإصدارات الأخرى من هذه المرحلة. تخضع "عروض مرحلة ما قبل التوفّر للجمهور العام" لبنود الخدمة المحدّدة في "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

نطلق ميزة تجريبية في Solar API توسّع نطاق التغطية ليشمل مناطق لم تكن متوافقة سابقًا، وذلك استنادًا إلى نماذج تعلُّم الآلة التي يتم تطبيقها على صور الأقمار الصناعية. للوصول إلى بيانات الطاقة الشمسية التجريبية، اضبط المَعلمة experiments على EXPANDED_COVERAGE والمَعلمة requiredQuality على BASE.

ملاحظة: لا تتوفّر في هذه التجربة سوى بيانات الجودة BASE. يتم خصم %100 من تكلفة طلبات البيانات من واجهة Solar API التي تتضمّن experiments=EXPANDED_COVERAGE خلال المرحلة التجريبية. للوصول إلى بيانات الجودة HIGH أو MEDIUM، أزِل المَعلمة experiments=EXPANDED_COVERAGE. سيتم تحصيل رسوم المكالمات غير التجريبية بالسعر العادي.

تتوفّر البيانات التجريبية لطلبات buildingInsights وdataLayers. توضّح الأقسام التالية أمثلة على الطلبات والردود.

لتحسين البيانات والنماذج باستمرار بهدف تلبية احتياجاتك، يطلب فريق Solar API ملاحظات حول هذا الإصدار التجريبي. لمشاركة ملاحظاتك، يمكنك إرسال ردّ في استطلاع تجربة برنامج اختبار Solar API أو الإبلاغ عن خطأ في Solar API: أداة تتبُّع المشاكل المتعلقة بالتغطية الموسّعة. للاطّلاع على آخر الإشعارات، انضم إلى مجموعة "توسيع نطاق تغطية Solar API" عن طريق إرسال رسالة إلكترونية إلى [e-mail].

إحصاءات حول المباني

تقدّم نقطة نهاية buildingInsights إحصاءات حول الموقع الجغرافي وأبعاد المبنى وإمكاناته في توليد الطاقة الشمسية. لطلب الحصول على إحصاءات حول المبنى، أرسِل طلب استرداد بيانات باستخدام GET HTTP إلى:

https://solar.googleapis.com/v1/buildingInsights:findClosest?key=YOUR_API_KEY

أدرِج مَعلمات عنوان URL للطلب التي تحدّد إحداثيات خطوط الطول والعرض للموقع الجغرافي وأدنى مستوى جودة مطلوب مسموح به في النتائج.

يطلب المثال التالي معلومات حول إحصاءات المباني للموقع الجغرافي الذي تبلغ إحداثياته خط العرض 4.655719 وخط الطول -74.128971. لطلب بيانات تجريبية، اضبط المَعلمات التالية:

• requiredQuality = BASE
• experiments = EXPANDED_COVERAGE

ملاحظة: لا تتوفّر بيانات جودة صور BASE إلا إذا تم ضبط المَعلمة experiments على EXPANDED_COVERAGE.

curl -X GET "https://solar.googleapis.com/v1/buildingInsights:findClosest?location.latitude=4.655719&location.longitude=-74.128971&requiredQuality=BASE&experiments=EXPANDED_COVERAGE&key=YOUR_API_KEY"

يؤدي هذا الطلب إلى إنشاء رد بتنسيق JSON بالشكل التالي:

{
  "name": "buildings/ChIJW2GaKXecP44RaeGtGpQtk4Q",
  "center": {
    "latitude": 4.6557664,
    "longitude": -74.1289303
  },
  "imageryDate": {
    "year": 2024,
    "month": 2,
    "day": 19
  },
  "regionCode": "CO",
  "solarPotential": {
    "maxArrayPanelsCount": 351,
    "maxArrayAreaMeters2": 689.20776,
    "maxSunshineHoursPerYear": 1631.7008,
    "carbonOffsetFactorKgPerMwh": 122.99986,
    "wholeRoofStats": {
      "areaMeters2": 1078.406,
      "sunshineQuantiles": [
        562.9261,
        930.9767,
        1165.876,
        1221.8761,
        1333.0057,
        1485.7363,
        1563.2417,
        1593.266,
        1610.5652,
        1621.5986,
        1640.6102
      ],
      "groundAreaMeters2": 1050.76
    },
    "roofSegmentStats": [
      {
        "pitchDegrees": 38.58091,
        "azimuthDegrees": 41.91368,
        "stats": {
          "areaMeters2": 23.153826,
          "sunshineQuantiles": [
            582.9132,
            612.5797,
            673.3435,
            762.14233,
            899.41864,
            1031.1329,
            1103.8121,
            1135.5204,
            1150.2969,
            1158.215,
            1170.5475
          ],
          "groundAreaMeters2": 18.1
        },
        "center": {
          "latitude": 4.6554996,
          "longitude": -74.128966699999992
        },
        "boundingBox": {
          "sw": {
            "latitude": 4.655472,
            "longitude": -74.1290005
          },
          "ne": {
            "latitude": 4.6555371999999995,
            "longitude": -74.1289328
          }
        },
        "planeHeightAtCenterMeters": 2552.031
      },
      /.../
    ]
    "solarPanelConfigs": [
      {
        "panelsCount": 4,
        "yearlyEnergyDcKwh": 2609.5698,
        "roofSegmentSummaries": [
          {
            "pitchDegrees": 10.260736,
            "azimuthDegrees": 131.22626,
            "panelsCount": 1,
            "yearlyEnergyDcKwh": 652.84863,
            "segmentIndex": 6
          },
          {
            "pitchDegrees": 8.649131,
            "azimuthDegrees": 145.79407,
            "panelsCount": 1,
            "yearlyEnergyDcKwh": 652.3829,
            "segmentIndex": 11
          },
          {
            "pitchDegrees": 5.061984,
            "azimuthDegrees": 12.690001,
            "panelsCount": 2,
            "yearlyEnergyDcKwh": 1304.3383,
            "segmentIndex": 12
          }
        ]
      },
      /.../
    ]
    "panelCapacityWatts": 400,
    "panelHeightMeters": 1.879,
    "panelWidthMeters": 1.045,
    "panelLifetimeYears": 20,
    "buildingStats": {
      "areaMeters2": 1143.155,
      "sunshineQuantiles": [
        557,
        883.26263,
        1146.4794,
        1209.3063,
        1278.1102,
        1465.2921,
        1557.7494,
        1590.9565,
        1609.4994,
        1621.1909,
        1640.6102
      ],
      "groundAreaMeters2": 1089.35
    },
    "solarPanels": [
      {
        "center": {
          "latitude": 4.6560077,
          "longitude": -74.12885
        },
        "orientation": "PORTRAIT",
        "yearlyEnergyDcKwh": 653.14404,
        "segmentIndex": 12
      },
      /.../
    ]
    },
  "boundingBox": {
    "sw": {
      "latitude": 4.6554716,
      "longitude": -74.129243899999992
    },
    "ne": {
      "latitude": 4.6560513,
      "longitude": -74.128623900000008
    }
  },
  "imageryQuality": "BASE",
  "imageryProcessedDate": {
    "year": 2024,
    "month": 7,
    "day": 21
  }
}

طبقات البيانات

تقدّم نقطة نهاية dataLayers معلومات تفصيلية حول الطاقة الشمسية لمنطقة تحيط بموقع جغرافي محدّد. تعرض نقطة النهاية 17 ملف TIFF قابلاً للتنزيل، بما في ذلك نموذج تضاريس رقمي (DSM) وطبقة مركّبة من الأحمر والأخضر والأزرق (صور جوية) وطبقة قناع تحدّد حدود التحليل، وغير ذلك.

يوضّح المثال التالي عنوان URL لطلب REST إلى طريقة dataLayers:

https://solar.googleapis.com/v1/dataLayers:get?parameters

أدرِج مَعلمات عنوان URL للطلب التي تحدّد ما يلي:

• إحداثيات خط العرض وخط الطول للموقع الجغرافي
• نطاق المنطقة المحيطة بالموقع الجغرافي (بالمتر)
• الحد الأدنى للجودة المسموح بها في النتائج

لطلب بيانات تجريبية، اضبط المَعلمات التالية:

• requiredQuality = BASE
• experiments = EXPANDED_COVERAGE

curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=4.655719&location.longitude=-74.128971&radiusMeters=100&requiredQuality=BASE&experiments=EXPANDED_COVERAGE&key=YOUR_API_KEY"

يؤدي هذا الطلب إلى إنشاء استجابة JSON بالتنسيق التالي:

{
  "imageryDate": {
    "year": 2024,
    "month": 2,
    "day": 19
  },
  "imageryProcessedDate": {
    "year": 2024,
    "month": 7,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=YTYwZDUzYTMxNjVmMjFlYWNjZmMyYzcxYTNhNWQ2OWItZTM0ZWRjZTQwNTZjZWUyYTNiNWE2ZjU5OTVkYWJjNTM6RFNNOkJBU0U",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=MWU2NmYxNmU3M2JlYmY5NDJkZmVmMjQ0NDViMjFjYTgtZWVhYjRiN2U0YWJlNzM2Nzk1MzUxZTQ4YTgxNjZiM2M6UkdCOkJBU0U",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ZGU4NzhmNDg0YjE2OGYwYTdjN2EyYmVlMDQxYTM5NDMtNDk2NGQwNzBhMzAwYzBkYTEwZDNmYjgzNTk4ODkyY2I6TUFTSzpCQVNF",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=NmRiZDQ0NDFkNWE5NDU2Nzc2ZTU1Mzg0MDY0YzFhMWMtMDg2ZDMyZjVkYTMzMDhiZmI5NzM1MzY0YmRjZmFiM2I6QU5OVUFMX0ZMVVg6QkFTRQ",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=NTAyMDJkMTVmMjJiZGYyOTNiMDFhMWEzNDJkZjAwNTctZDRjMjY3ZjU1YjQ2ZjE4ZTNkNjE1YmU5NTlmOThlZjM6TU9OVEhMWV9GTFVYOkJBU0U",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=NWNkZmM0NTcwYTE5ODQzMmI0MmQ1NDM4NzY4MTc5MzEtOWE0MTBjNDkwM2IxZjA0MmI1ZTNmNTg1NTY0MTNkZjI6SE9VUkxZX1NIQURFOkJBU0U",
    "https://solar.googleapis.com/v1/geoTiff:get?id=Y2YwNDY4MzQ1YzhkMjBlZjU5M2NiNDRmMmM0ODRiNTUtNjMwOWM2NDBjZmI5OTdkMDA3ZGQzOWY2YmI1ZTk2NWM6SE9VUkxZX1NIQURFOkJBU0U",
    /.../
  ],
  "imageryQuality": "BASE"
}

لإرسال طلب إلى عنوان URL في الردّ، أضِف مفتاح واجهة برمجة التطبيقات إلى عنوان URL:

curl -X GET "https://solar.googleapis.com/v1/geoTiff:get?id=YTYwZDUzYTMxNjVmMjFlYWNjZmMyYzcxYTNhNWQ2OWItZTM0ZWRjZTQwNTZjZWUyYTNiNWE2ZjU5OTVkYWJjNTM6RFNNOkJBU0U&key=YOUR_API_KEY"

باستثناء طبقة RGB، ستظهر جميع ملفات TIFF كصور فارغة في تطبيقات عارض الصور. للاطّلاع على ملفات TIFF التي تم تنزيلها، استورِدها إلى برنامج تطبيق خرائط، مثل QGIS.

يمكنك الاطّلاع على المواصفات الكاملة لهذا الطلب والردّ في المستندات المرجعية.

ملاحظة: لا تكون عناوين URL الخاصة بالردود نشطة إلا لمدة ساعة واحدة بعد الطلب الأوّلي. للوصول إلى عناوين URL بعد هذا الإطار الزمني، عليك إرسال طلب إلى نقطة النهاية dataLayers مرة أخرى.