כיסוי מורחב (ניסיוני)

מפתחים באזור הכלכלי האירופי (EEA)

אם כתובת החיוב שלכם נמצאת באזור הכלכלי האירופי, החל מ-8 ביולי 2025, התנאים וההגבלות של הפלטפורמה של מפות Google באזור הכלכלי האירופי יחולו על השימוש שלכם בשירותים. מידע נוסף בנוסף, לא יוחזר יותר תוכן מסוים מ-Solar API. למידע נוסף

המוצר או התכונה האלה הם ניסיוניים (בגרסת טרום-GA). יכול להיות שהתמיכה במוצרים ובתכונות בגרסת טרום-GA תהיה מוגבלת, ושינויים במוצרים ובתכונות בגרסת טרום-GA לא יהיו תואמים לגרסאות אחרות של טרום-GA. השימוש במוצרים בגרסת טרום-GA כפוף לתנאים הספציפיים לשירות של הפלטפורמה של מפות 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 Expanded Coverage. לשם כך, שולחים אימייל לכתובת [e-mail].

תובנות לגבי בנייה

נקודת הקצה buildingInsights מספקת תובנות לגבי המיקום, הממדים והפוטנציאל הסולארי של בניין. כדי לבקש תובנות לגבי בנייה, שולחים בקשת HTTP GET אל:

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), שכבת RGB מורכבת (צילומי אוויר) ושכבת מסכה שמזהה את הגבולות של הניתוח, בין היתר.

בדוגמה הבאה מוצגת כתובת ה-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 בתגובה, מוסיפים את מפתח ה-API לכתובת ה-URL:

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

חוץ משכבת ה-RGB, כל קובצי ה-TIFF יוצגו כתמונות ריקות באפליקציות לצפייה בתמונות. כדי להציג קובצי TIFF שהורדתם, צריך לייבא אותם לתוכנת מיפוי, כמו QGIS.

המפרט המלא של הבקשה והתגובה האלה מופיע במסמכי העזר.

הערה: כתובות ה-URL של התגובות פעילות רק למשך שעה אחת אחרי הבקשה הראשונית. כדי לגשת לכתובות URL שחורגות ממסגרת הזמן הזו, צריך לשלוח בקשה לdataLayersנקודת הקצה

שוב.